Spectra 3.1.3

Persistent, governed project intelligence for coding agents. 3.1.3 adds Project Intelligence queries and scoped verification evidence, and separates the machine lifecycle from the project lifecycle.

No breaking changes. No project migration is required. schemaVersion stays 3, apiVersion stays spectra/v2, and no command or flag is removed.

Upgrade notes

Native 3.1.2 users: 3.1.2 predates the managed-install ownership record and cannot be replaced in place by its old spectra update path. Install 3.1.3 into a fresh managed location with the current installer (it prints the exact commands). Your project files are not modified and no project migration is required.

• Global npm: npm install -g spectra-pack@latest
• npx: npx spectra-pack@latest ...
• Existing projects: refresh generated files and agent guidance with spectra doctor --fix, then spectra adapters --agents <csv>. Handwritten AGENTS.md and CLAUDE.md files are protected unless you pass --force.
• From 3.1.3 on, a managed native install records ownership, so spectra update can update it.

Highlights

Project Intelligence

• spectra inspect <id> explains what governs a rule, requirement, scenario, invariant, module or test target, and whether it is verified.
• spectra inspect --changed, --base <ref> and --file <path> report the impact of changed files at module and canonical-source level. This is not a code graph.

Verification and gates

• spectra verify --test-target <id> records scoped, local verification evidence. Subjects report verified, failed, stale or unverified.
• spectra verify --explain <id> says why. spectra verify --gate review|release reports whether the evidence lets a stage proceed.
• Evidence is scoped: a passing test target supports the subjects that declare it. It does not prove a requirement everywhere.

Context and retrieval

• spectra context --route-task selects exact knowledge objects within the role budget, now also matches architectural invariants, and folds plural and -ing/-ed variants.
• Retrieval stays deterministic, lexical and budget-aware. There is no semantic or vector search.

Lifecycle

• spectra update changes the machine application only. It never reads or writes a project.
• spectra migrate is the explicit per-project step. spectra uninstall removes the native application and leaves every project unchanged.
• Derived caches rebuild on their own and never need a migration.

Agent guidance

• Generated adapters cover route-first context, business memory, Project Intelligence commands and the verification gates.
• Agent-facing JSON carries contractVersion 1 and structured errors. context and route JSON no longer include absolute paths.

Fixes

• Adapters generated in new projects no longer omit the route-first and business-memory guidance.
• spectra verify --test-target finds locally installed tools in the package's node_modules/.bin.
• spectra knowledge promote|supersede|deprecate no longer matches a rule whose ID only starts with the requested ID.
• spectra verify --gate refuses an unresolvable --base/--head ref.

Documentation

README, CLI reference and website describe all 24 commands and the three lifecycles. The website diagrams are cleaner.

Full details: CHANGELOG.