How 3xo13/archpulse works
ArchPulse is a Bob IDE add-on and local CLI for finding dependency-rule violations, turning them into repair cases, and checking proposed fixes. The main workflow is scan → capture a baseline → generate and inspect a case → repair in Bob → verify with configured checks and a rescan; architecture-only comparison is also available. CLI and MCP are separate entry points into these capabilities. A React viewer presents example or imported results. The README documents these product areas; sampled source confirms entry-point wiring and selected viewer and demo behavior, while some core internals are unsampled.
Main entry points: index.ts CLI commands · cases.ts Case generation · verify.ts Repair verification · scan.ts Repository scan
Components 23
User entry points
- CLI commands
src/cli/index.ts - MCP tools
src/mcp/server.ts
Scan and cases
- Repository scan
src/cli/scan.ts - Dependency scanner
- Case generation
src/core/cases.ts - Case packet
src/core/casePacket.ts - Violation grouping
src/core/grouping.ts
Verification
- Architecture comparison
src/core/compare.ts - Repair verification
src/core/verify.ts - Test and typecheck runner
src/core/process.ts
Artifacts and storage
- Baseline snapshot
src/core/snapshot.ts - Artifact publisher
src/core/artifacts.ts - Workspace storage
src/core/storage.ts - Workspace validation
src/core/workspace.ts
Results viewer
- Results viewer
src/viewer/App.tsx - Report import
src/viewer/components/ImportReport.tsx - Before/after graph
src/viewer/components/GraphView.tsx - Violation diff
src/viewer/components/ViolationDiff.tsx
Other components
- Developer
- Bob IDE
- Demo order service
demo/packages/ui/src/orderService.ts - Demo order domain
demo/packages/domain/src/order.ts - Demo shared types
demo/packages/shared/src/types.ts
Connections 30
- Developer → CLI commands: runs commands
- Bob IDE → MCP tools: invokes tools
- CLI commands → Repository scan: runs scan
- MCP tools → Repository scan: runs scan
- Repository scan → Dependency scanner: scans dependencies
- Dependency scanner → Baseline snapshot: returns findings
- Repository scan → Baseline snapshot: captures snapshot
- CLI commands → Case generation: generates cases
- MCP tools → Case generation: generates cases
- Case generation → Baseline snapshot: reads snapshot
- Case generation → Violation grouping: groups violations
- Case generation → Case packet: builds packet
- Case generation → Workspace storage: publishes cases
- CLI commands → Architecture comparison: compares snapshots
- CLI commands → Repair verification: verifies repair
- MCP tools → Repair verification: verifies repair
- Repair verification → Test and typecheck runner: runs checks
- Repair verification → Repository scan: rescans repository
- Repair verification → Architecture comparison: compares results
- Repair verification → Artifact publisher: writes report
- Artifact publisher → Workspace storage: publishes files
- Repository scan → Workspace storage: stores baseline
- MCP tools → Workspace validation: validates workspace
- CLI commands → Workspace validation: resolves workspace
- Developer → Results viewer: opens results
- Results viewer → Report import: accepts artifacts
- Results viewer → Before/after graph: renders graph
- Results viewer → Violation diff: renders changes
- Demo order service → Demo order domain: calls order operations
- Demo order domain → Demo shared types: uses shared types