-
Narratio v3.0.0
Stablereleased this
2026-09-28 03:21:06 +00:00 | 3 commits to main since this releaseNarratio v3.0.0
This major release moves Narratio pipeline selection to ConfigKit overlays and
updates its Audita and Notarius integration contracts. Existing deployments
must migrate configuration before running affected sessions.Compatibility and upgrade
- Replace Narratio's
--profile <name>with--overlay <name>and move selected
profiles/<name>.ymlfiles tooverlays/<name>.ymlbeside the pipeline root.
The old flag and selected directory are no longer supported; explicit imports
from a directory namedprofilesremain valid. Updateconfig diffpositional
selections accordingly. See configuration
and the CLI reference. - Before opening a session manifest containing
effective_config.selected_profile, back it up and follow the
manifest migration procedure.
Strict decoding rejects the retired field. Preserve the manifest's stage and
checkpoint state; this informational rename does not itself require rerunning
every stage. Immutable remote snapshots are not edited in place. - Deploy an Audita v2 executable and migrate its configuration before running
polish. Narratio no longer generates an Audita config or accepts the old
endpoint, model, concurrency, singular API-key, report, and retention fields.
Audita now owns backends, PromptKit profiles, reporting, and debug settings;
Narratio accepts optional downstream selectors and forwards only names listed
inpipeline.audita.credentials. Follow the
Audita migration table
and integration contract. - Replace
pipeline.notarius.llm_api_keywith the
pipeline.notarius.credentialslist. Rename
pipeline.notarius.config_profiletoconfig_overlayand move selected
downstream Notarius files to itsoverlays/directory. The old fields have
no compatibility aliases. A named downstream overlay requires a compatible
Notarius executable; v0.8.1 is the tested baseline, while deployments that
omit the selector gain no new version requirement. See the
Notarius configuration reference
and integration contract.
Changes
- Narratio and downstream overlay names are independent. Operators can select
separate Audita and Notarius overlays from one Narratio overlay without
implicit name forwarding. ConfigKit is updated to v0.4.2. - Audita's corrected transcript remains the canonical polish output. Available
errors.yml,recoveries.yml, andreport.mdfiles are retained as bounded
diagnostics; missing reports are allowed, and an exit-zero valid transcript
succeeds even when reports describe recoverable errors or no corrections. - Audita and Notarius credential lists resolve at pipeline load and forward
captured values under their exact names, with captured subprocess output and
failure diagnostics redacted. Narratio does not discover backend credentials
from downstream configuration; operators must list the names those tools need. - Repository policy, license/attribution notices, release validation, and the
asynchronous artifact-delivery procedure are aligned with the current
release runbook. Completed implementation roadmaps have been
retired from the candidate source.
Downloads
- Replace Narratio's