Skip to main content

Crate nbspec

Crate nbspec 

Source
Expand description

Core library for nbspec: notebook-first OpenSpec orchestration.

Exposes change operations behind a library boundary so that the CLI binary and the planned MCP surface are both thin wrappers over the same core functions.

Modulesยง

archives
Deterministic merge-time change archives.
changes
Change namespace conventions and the meta note control plane.
cli
Command-line interface definitions.
configuration
Layered nbspec configuration.
git_env
Environment hygiene for spawning git-aware subprocesses.
grammar
OpenSpec grammar parsing: requirement, scenario, and delta structures.
mcp
Model Context Protocol server wrapping the nbspec operations library.
merging
Durable artifact merge with provenance and drift protection.
operations
Core change operations shared by the CLI and future MCP surface.
provenance
Provenance headers for merge-written documents.
rendering
Deterministic scratch-workspace rendering.
reviews
Review verdicts: content-bound, immutable, per-verdict notes.
schemata
Workflow schema model: artifact sets, dependency graphs, merge targets.
validation
Native change validation over the OpenSpec grammar.
worknotes
Grammar for the work todo note.