How dczerwinskipl/nevo-specflow works
Nevo SpecFlow is a spec-driven development framework: people use its CLI and served UI to work with specifications, documents, Git workspaces and managed agent Sessions. The Runtime exposes local authenticated workflows backed by the offline Engine; docs discovery/search and agent adapters are additional capabilities. The deterministic Specifications/Tasks workflow kernel exists in the Engine but is explicitly not wired to the Runtime, CLI or UI. Edges reflect README statements and the supplied source references; unsampled details are not inferred.
Main entry points: application.ts Engine boundary · app.ts Runtime server · program.ts SpecFlow CLI · search.ts Docs commands
Components 19
User entry points
- SpecFlow CLI
packages/specflow/src/program.ts - SpecFlow UI
packages/specflow-ui/src/features/specs/routes.tsx
Local Runtime
- Runtime server
packages/specflow-runtime/src/server/app.ts - Auth and sessions
packages/specflow-runtime/src/features/sessions/http/routes.ts - Specification overview
packages/specflow-runtime/src/features/specs/overview/repository/engine-repository.ts - Specification workspace
packages/specflow-runtime/src/features/specs/workspace/engine-repository.ts - Document reads
packages/specflow-runtime/src/features/documents/content/engine-source.ts - Document writes
packages/specflow-runtime/src/features/documents/write/engine-write-source.ts
Offline Engine
- Engine access
packages/specflow/src/engine-at.ts - Engine boundary
packages/specflow-engine/src/application.ts - Project Home
packages/specflow-engine/src/project/home/home.ts - Workspace registry
packages/specflow-engine/src/project/workspace/registry/registry.ts - Git workspaces
packages/specflow-engine/src/project/git-instance.ts - Specs and Tasks
packages/specflow-engine/src/workflow/tasks/tasks.ts
Documentation discovery
- Docs commands
packages/specflow-docs/src/search/search.ts - Repository corpus
packages/specflow-docs/src/corpus/repository.ts - Semantic embeddings
packages/specflow-docs/src/embeddings/embedding-providers.ts
Agent workflow
- Agent adapters
packages/specflow/src/program.ts
Other components
- Repository owner
Connections 24
- Repository owner → SpecFlow CLI: runs commands
README.md - Repository owner → SpecFlow UI: uses
README.md - SpecFlow CLI → Engine access: opens engine
packages/specflow/src/engine-at.ts - SpecFlow CLI → Runtime server: starts runtime
packages/specflow/src/program.ts - SpecFlow CLI → Docs commands: registers commands
packages/specflow/src/program.ts - SpecFlow UI → Runtime server: uses served UI
README.md - Runtime server → Auth and sessions: serves sessions
- Runtime server → Specification overview: serves specifications
- Runtime server → Specification workspace: serves workspace
- Runtime server → Document reads: serves reads
- Runtime server → Document writes: serves writes
- Engine boundary → Project Home: resolves home
packages/specflow-engine/src/application.ts - Engine boundary → Workspace registry: verifies registration
packages/specflow-engine/src/application.ts - Workspace registry → Project Home: reads home
packages/specflow-engine/src/project/workspace/registry/registry.ts - Engine boundary → Git workspaces: manages worktrees
- Specification overview → Engine boundary: reads canonical specs
packages/specflow-runtime/src/features/specs/overview/repository/engine-repository.ts - Specification workspace → Engine boundary: reads canonical specs
packages/specflow-runtime/src/features/specs/workspace/engine-repository.ts - Document reads → Engine boundary: reads documents
packages/specflow-runtime/src/features/documents/content/engine-source.ts - Document writes → Engine boundary: applies changes
packages/specflow-runtime/src/features/documents/write/engine-write-source.ts - Auth and sessions → Engine boundary: tracks execution
- Engine boundary → Specs and Tasks: owns workflow
- Docs commands → Repository corpus: discovers content
- Docs commands → Semantic embeddings: supports semantic search
- Agent adapters → SpecFlow CLI: exposes adapters
packages/specflow/src/program.ts