empirical-sdd 0.25.0 → 0.26.0

package/CHANGELOG.md

@@ -8,6 +8,32 @@ under the alpha rules in [docs/versioning.md](docs/versioning.md).
 
 ## [Unreleased]
 
+## [0.26.0] - 2026-08-20
+
+### Added
+
+- Added selectable `concise` or `detailed` interaction questions across project
+  configuration, CLI, MCP, action packets, status rendering, and generated
+  agent guidance. New recommended setup is concise; existing missing fields
+  remain detailed.
+- Added strict optional Tracker Policy v2 ticket-rule matrices, including the
+  `features+large-fixes` preset and resolved change-type/requirement status.
+- Added a packaged provider-independent no-ticket feature demo that proves one
+  guarded create, one durable binding, and zero live-network calls.
+
+### Changed
+
+- Optional ticket work with no explicit reference now remains local before
+  authentication or provider access and no longer causes a redundant ticket
+  question; required work retains attach, marker reconciliation, and
+  exactly-once guarded creation.
+
+### Migration
+
+- Existing Schema 5 and Tracker Policy v1/v2 repositories require no state
+  migration. Repositories without an explicit question mode retain detailed
+  questions until configured otherwise; new setup recommends concise mode.
+
 ## [0.25.0] - 2026-08-19
 
 ### Added
@@ -157,7 +183,8 @@ Published through GitHub Actions trusted publishing with npm provenance.
 
 - Prepared and released package version `0.20.2`.
 
-[Unreleased]: https://github.com/goempirical/empirical-sdd/compare/v0.25.0...HEAD
+[Unreleased]: https://github.com/goempirical/empirical-sdd/compare/v0.26.0...HEAD
+[0.26.0]: https://github.com/goempirical/empirical-sdd/compare/v0.25.0...v0.26.0
 [0.25.0]: https://github.com/goempirical/empirical-sdd/compare/v0.24.1...v0.25.0
 [0.24.1]: https://github.com/goempirical/empirical-sdd/compare/v0.24.0...v0.24.1
 [0.24.0]: https://github.com/goempirical/empirical-sdd/compare/v0.23.0...v0.24.0

package/README.md

@@ -4,7 +4,7 @@ Agent-neutral, resumable spec-driven development for coding agents. Empirical
 turns an ordinary change request into a deterministic workflow with durable
 state, reviewable evidence, and safe Git integration.
 
-> Empirical 0.25 is alpha software. It requires Node.js 22 or newer.
+> Empirical 0.26 is alpha software. It requires Node.js 22 or newer.
 
 ## Install
 
@@ -35,6 +35,7 @@ artifacts; unmanaged or unsafe conflicts are preserved and remain visible.
 - Isolated parallel work through linked Git worktrees.
 - Guided Linear, GitHub Issues + Projects, or Jira ticket mirrors with automatic
   binding, milestone comments, and safe evidence projection.
+- Selectable concise or detailed agent questions and runtime summaries.
 - Explicit, guarded delivery and npm publication boundaries.
 
 Completion is reported only at the highest proven level: implemented,
@@ -42,10 +43,17 @@ verified, integrated, delivered, or published.
 
 ## Tracker setup
 
-`empirical-init` always shows a Tracker section. When no prior choice exists,
-it recommends **Track all work** and requires choosing that or **No tracking**
-before setup can be saved. Track all selects Linear, GitHub Projects, or Jira;
-No tracking persists a provider-free choice and makes no provider requests.
+`empirical-init` always shows Interaction and Tracker sections. New recommended
+setup selects **concise** questions: agents ask only when an answer changes
+scope, architecture, authorization, or a safety gate. **Detailed** preserves
+the expanded guidance used by existing Schema-5 repositories. Automation can
+set the same value with `--questions concise|detailed` or the MCP `questions`
+field.
+
+When no tracker choice exists, Init recommends **Track work by type** and
+requires choosing that or **No tracking** before setup can be saved. Track work
+selects Linear, GitHub Projects, or Jira; No tracking persists a provider-free
+choice and makes no provider requests.
 
 Authentication starts with OAuth when a trusted host supplies a connection.
 MCP clients may open that connection only through explicitly negotiated
@@ -85,6 +93,21 @@ or linked only after repository containment, media, size, and digest checks.
 Existing Tracker Policy v1 files remain valid with manual binding and legacy
 projection until deliberately upgraded.
 
+An optional strict `ticketRules` matrix refines `ensure` by change type and
+workflow size. The recommended `features+large-fixes` preset is:
+
+| Work | Fast | Quick | Complex |
+| --- | --- | --- | --- |
+| Feature | required | required | required |
+| Fix | optional | required | required |
+| Chore | optional | optional | optional |
+
+Optional work with no referenced ticket stays local without OAuth, provider
+access, ticket creation, or a redundant question. One explicit reference is
+attached; multiple references fail closed. See the [demo](docs/demo.md) for a
+provider-independent new-feature run and [MCP documentation](docs/mcp.md) for
+the complete custom JSON form.
+
 ## CLI
 
 | Command | Purpose |