Skip to content

chore(release): v1.3.0 — catalog seed, vocab fail-soft, layer5 prototype - #88

Merged
Joncik91 merged 1 commit into
mainfrom
v1.3-release
May 15, 2026
Merged

chore(release): v1.3.0 — catalog seed, vocab fail-soft, layer5 prototype#88
Joncik91 merged 1 commit into
mainfrom
v1.3-release

Conversation

@Joncik91

Copy link
Copy Markdown
Owner

Summary

v1.3.0 minor release. Three coverage and prototype items composed from PRs #85, #86, #87 (all merged to main), plus a small walker plumbing fixup surfaced by the Wave 3 Opus aggregate review.

Released because the v1.2 evaluator surface had three open gaps Vidence kept hitting: input-shape/output-shape views with zero exemplars (forcing operators into the v1.2.1 no-compatible-exemplar deferral path), a per-view vocabulary partition that raised opaque errors on misplaced tokens, and no machine-parseable reasoning trace for the agent choice points v2.0's Layer 5 will require. In order to keep operator friction low while preserving the partition's semantic guarantee, the vocab fix is fail-soft UX (block-severity finding) rather than fail-loud (raise). So that the v1.3 prototype work doesn't become a v2.0 commitment, the Layer 5 schema is deliberately minimal (six fields) — full VUE+5W2H per choice was rejected in planning as overfit for a prototype.

The architectural choice why this lands as a minor rather than a patch: item 8 ships new catalog content (six exemplars + three axes files + view-to-catalog-type mappings) that operator-facing tooling now recommends; item 9 changes a public contract (_validate_view_trust_profile returns a tuple rather than raising); item 10 adds new public surface (bin/_layer5.py, sidecar layer5_trace key, walker state field). A patch bump would understate the surface change.

What lands

  • Item 8 — Catalog seed (feat(catalog): v1.3 — seed exemplars for input-shape, output-shape, ipc-rpc #86): six new exemplars under docs/exemplars/{input-shape,output-shape,ipc-rpc}/, three new axes.yml files, _VIEW_TO_CATALOG_TYPES rerouted from placeholder help-text to the real view types. Every convention traces to its cited source-url (POSIX, GNU Coding Standards, OpenAPI 3.1, json-rpc.org 2.0, AF_UNIX). Test fixtures updated to reflect the new compatible-exemplar landscape for §9 and §12.
  • Item 9 — Vocab fail-soft (feat(substrate): v1.3 — fail-soft vocab partition with block firewall #85): _validate_view_trust_profile now returns (profile, findings); misplaced tokens are dropped from the returned profile (semantic firewall) AND emit a block-severity trust-token-misplaced finding. The lock still cannot complete while it exists — partition's semantic guarantee held, ergonomics improved.
  • Item 10 — Layer 5 prototype (feat(layer5): v1.3 — reasoning-trace prototype at three choice points #87): new bin/_layer5.py with build_trace_record and project_substitution_trace helpers; walker emits trace records at concern-resolution and exemplar-binding commit sites; sidecar carries layer5_trace: list[dict]. Six-field schema. SPECTRE_LAYER5=off env var disables emission.
  • Walker fixup (this PR): bin/walker.py::_VIEW_TO_CATALOG_VIEW_TYPE aligned so product-input → input-shape and product-output → output-shape. The walker's exemplar-suggestion path now queries the same catalog view-type the cross-view gate uses for validation. Pre-fixup, the walker still recommended help-text exemplars for input-shape views.

Test plan

Surface bumps

  • .claude-plugin/marketplace.json 1.2.1 → 1.3.0 (both metadata.version and plugins[0].version)
  • README test-count badge: 1967 → 2003
  • README version badge: 1.2.1 → 1.3.0
  • findings.Finding::KNOWN_KINDS gains trust-token-misplaced
  • substrate_wizard._validate_view_trust_profile returns (list[str], list[Finding]) instead of raising
  • eval_metadata.write_sidecar gains optional layer5_trace: list[dict] | None kwarg
  • walker.WalkState gains layer5_trace: list[dict] field

Components

  • Plugin: 1.3.0
  • EVALUATOR_VERSION: 1.0.0 (unchanged — spec contract stable since v1.0)
  • WALKER_VERSION: 1.0.0 (unchanged — walker concern API stable since v1.0)

Generated with Claude Code

Minor release composing three Wave 2 PRs (#85, #86, #87) plus a small
walker-side plumbing fixup surfaced by the Wave 3 Opus aggregate review.

- Plugin marketplace bump 1.2.1 → 1.3.0 (both metadata.version and
  plugins[0].version)
- README badges: test count 1967 → 2003, version 1.2.1 → 1.3.0
- README components line: v1.2 → v1.3
- CHANGELOG entry summarizing item 8 (catalog seed), item 9 (vocab
  fail-soft with block firewall), item 10 (layer5 prototype), and the
  walker fixup
- bin/walker.py: _VIEW_TO_CATALOG_VIEW_TYPE realigned so product-input
  routes to input-shape and product-output routes to output-shape, the
  exemplar-options call site queries input-shape instead of help-text,
  and the input-exemplar-pi concern prompt references the input-shape
  view type instead of the v1.1 placeholder language. The walker's
  binding-suggestion path and the cross_view_gate's validation path now
  query the same catalog view types.

No spec contract changes — v1.0/v1.1/v1.1.1/v1.2.0/v1.2.1 locked specs
continue to validate.

2003 tests passing (1967 v1.2.1 baseline + 36 across the three v1.3
PRs). Zero regressions.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@Joncik91
Joncik91 merged commit daf08e0 into main May 15, 2026
2 checks passed
@Joncik91
Joncik91 deleted the v1.3-release branch May 15, 2026 22:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant