How zomarit/stamity works
stamity is a TypeScript CLI that turns one canonical agent-setup corpus into client-specific coding environments. The principal workflow is: run init to inspect a repository and create setup state, then sync to plan and write generated artifacts; check and validate provide verification. Separate capabilities manage packs, plugins, workspaces, worktrees, and agent handoffs. The README documents these product-level relationships; source excerpts and the index additionally support selected internal links. Several subsystem implementations were not sampled, so their internal calls are not inferred.
Main entry points: program.ts CLI program · sync.ts Sync setup · planner.ts Emission planner · manifest.ts Setup manifest
Components 25
CLI workflow
- CLI program
src/cli/kit/program.ts - Initialize setup
src/cli/commands/init.ts - Sync setup
src/cli/commands/sync.ts - Check setup
src/cli/commands/check.ts - Validate inputs
src/cli/commands/validate.ts
Setup generation
- Repository analysis
src/detect/repoAnalyzer.ts - Canonical corpus
src/content/catalog.ts - Artifact parsing
src/content/frontmatter.ts - Emission planner
src/emit/planner.ts - Client adapters
src/adapters - Managed file writes
src/merge/managedBlocks.ts
Setup state
- Setup manifest
src/manifest/manifest.ts - File ownership ledger
src/manifest/ledger.ts - Workspace management
src/workspace/sync.ts - Git worktrees
src/worktree/setup.ts
Extensions and integrations
- Pack installation
src/pack/install.ts - Pack trust and signing
src/pack/trust.ts - Plugin support
src/plugins/capabilityFile.ts - MCP wiring
src/mcp/emit.ts - Content safety scans
src/denyscan/denyScan.ts
Agent operations
- Hooks and commands
src/hooks/scripts.ts - Learnings
src/learnings/store.ts - Handoffs
src/handoffs/store.ts - Run ledger
src/runs/ledgerStore.ts
Other components
- Repository operator
Connections 29
- Repository operator → CLI program: invokes
README.md - CLI program → Initialize setup: dispatches
src/cli/kit/program.ts - CLI program → Sync setup: dispatches
src/cli/kit/program.ts - CLI program → Check setup: dispatches
src/cli/kit/program.ts - CLI program → Validate inputs: dispatches
src/cli/kit/program.ts - Initialize setup → Repository analysis: inspects repository
- Initialize setup → Setup manifest: creates setup state
README.md - Sync setup → Setup manifest: reads setup state
README.md - Sync setup → Emission planner: plans output
- Canonical corpus → Artifact parsing: parses artifacts
src/content/catalog.ts - Emission planner → Canonical corpus: selects content
src/emit/planner.ts - Emission planner → Client adapters: projects setup
src/emit/planner.ts - Client adapters → Managed file writes: emits managed blocks
src/adapters/claude.ts - Emission planner → MCP wiring: plans MCP output
src/emit/planner.ts - MCP wiring → Setup manifest: reads MCP selection
src/mcp/emit.ts - Sync setup → File ownership ledger: records ownership
- Sync setup → Managed file writes: writes generated files
- Check setup → Setup manifest: checks setup
README.md - Validate inputs → Canonical corpus: validates content
- Repository operator → Pack installation: adds packs
README.md - Pack installation → Pack trust and signing: verifies signed packs
- Repository operator → Plugin support: manages plugins
README.md - Repository operator → Workspace management: manages workspace
README.md - Repository operator → Git worktrees: sets up worktrees
README.md - Hooks and commands → Handoffs: validates handoffs
- Hooks and commands → Learnings: validates learnings
- Hooks and commands → Run ledger: uses run records
- Handoffs → Content safety scans: scans submissions
- Learnings → Content safety scans: scans submissions