How kazucocoa/renma works
Renma is a Git-native governance CLI for statically analyzing agent-facing repository assets; it reports evidence rather than loading or executing assets. The documented workflow starts with renma scan, then uses focused commands and CI reports to review inventories, relationships, readiness, security, and changes. The graph preserves those documented capability branches and sampled discovery/configuration internals. Some command and analysis implementations were not excerpted, so their links are based on the README rather than inferred source calls.
Main entry points: repository-evidence.ts Repository evidence · cli.ts Renma CLI · scan.ts Scan command · graph.ts Graph reports
Components 20
CLI entry and configuration
- Renma CLI
src/cli.ts - Scan command
src/commands/scan.ts - Scan configuration
src/config.ts
Repository analysis
- Asset discovery
src/discovery.ts - Repository boundary
src/repository-boundary.ts - Repository evidence
src/repository-evidence.ts
Governance and relationships
- Asset catalog
src/catalog.ts - Context lenses
src/context-lens.ts - Security policy inventory
src/security-policy-inventory.ts - Executable surfaces
src/executable-surface-inventory.ts - Relationships and trust
src/trust-graph.ts - Authoring quality
src/quality-profile.ts
Review evidence
- Scan findings
src/report.ts - Graph reports
src/commands/graph.ts - Readiness review
src/commands/readiness.ts - Change comparison
src/commands/diff.ts - CI report
src/commands/ci-report.ts
Other components
- Git repository
- Engineer / CI
- Human reviewer
Connections 24
- Engineer / CI → Renma CLI: runs commands
README.md - Git repository → Scan command: provides assets
README.md - Renma CLI → Scan command: starts scan
README.md - Scan command → Scan configuration: loads policy
- Scan command → Repository evidence: analyzes repository
- Repository evidence → Scan configuration: loads configuration
src/repository-evidence.ts - Repository evidence → Asset discovery: discovers assets
src/repository-evidence.ts - Asset discovery → Repository boundary: walks safely
src/discovery.ts - Repository evidence → Asset catalog: builds catalog
src/repository-evidence.ts - Repository evidence → Security policy inventory: collects policy evidence
src/repository-evidence.ts - Repository evidence → Executable surfaces: collects surface evidence
src/repository-evidence.ts - Repository evidence → Scan findings: produces findings
README.md - Renma CLI → Graph reports: offers graph
README.md - Renma CLI → Readiness review: offers readiness
README.md - Renma CLI → Change comparison: offers change evidence
README.md - Renma CLI → CI report: offers CI reports
README.md - Graph reports → Relationships and trust: reports relationships
README.md - Graph reports → Context lenses: reports lens graph
- Readiness review → Asset catalog: reviews assets
- Readiness review → Authoring quality: reviews authoring
- Change comparison → Git repository: compares repository state
README.md - CI report → Human reviewer: presents CI evidence
README.md - Scan findings → Human reviewer: supports review
README.md - Human reviewer → Git repository: approves changes
README.md