Skip to content

v4.24.0

Choose a tag to compare

@github-actions github-actions released this 18 Nov 05:49
· 88 commits to main since this release

Add polyglot design-slop, coverage-exclusion, manifest ImportError fallback, and wrapper-fragmentation AST sensors; Track Bash file mutations natively across PostToolUse and Stop hooks, surface manifest/module hull in SessionStart, harden NormativeSurfaceDelta Go AST extraction, and codify v4.24.0 specs (Apache 2.0)

Changelog

Intent & Specifications

  • c3c0d46 [INT-2104] docs(specs): codify v4.24.0 design-slop sensors, shell hook...
  • c839d4b [INT-2106] docs(specs): refine v4.24.0 container stop retries, venv...
  • cd3a5d4 [INT-2109] docs(specs): codify .tmp/tests discovery, DirtyBehavioralEdits...
  • cc15fab [INT-2110] docs(specs): codify diff-scoped Python trace coverage and Turn-0...
  • eb578ec [INT-2111] refactor(specs): tighten polyglot complexity, trace...
  • 7e0de11 [INT-2112] docs(specs): scope polyglot CC/Cog 10 default to indent...
  • 262682d [INT-2114] docs(specs): specify Polyglot Wrapper, AST Idiom, Clone, and...
  • 10558af [INT-2121] docs(specs): specify r5 worktree symlink exclusion, heredoc SQL...
  • 5055d19 [INT-2126] docs(specs): specify sibling removed field/TC deferral and...

CLI, Distribution & Hooks

  • 4a4f2b7 [SUB-3201] fix(hookcmd): track shell file mutations in PostToolUse/Stop and...
  • 088d565 [SUB-3235] fix(cli): fix compound heredoc header parsing and allow...

Verification & Quality Gates

  • 514a9ea [SUB-3200] refactor(verify): enforce 2nd-gen exception, coverage,...
  • cf72beb [SUB-3203] feat(verify): harden normative surface delta and design-slop AST...
  • 66b7faa [SUB-3207] feat(verify): exclude venv trees and tighten container Stop and...
  • 6406fbf [SUB-3213] feat(verify,hooks): add .tmp/tests discovery,...
  • f21fac3 [SUB-3214] fix(verify,hooks): diff-scope Python trace coverage and emit...
  • 77e8317 [SUB-3217] refactor(verify): enforce polyglot CC/Cog 10, realpath trace,...
  • 15d8966 [SUB-3218] feat(verify): scope CC/Cog 10 default to Python/Ruby while...
  • 7abcbdb [SUB-3223] feat(verify): implement Polyglot Wrapper, AST Idiom, Clone, and...
  • e666c7a [SUB-3229] refactor(verify): tighten uninitialized-container test hygiene...
  • e6a9bbe [SUB-3233] fix(verify): fix worktree .venv symlink exclusion, heredoc DROP...
  • 2d43882 [SUB-3239] fix(verify): defer sibling removed fields/TCs and filter...
  • 9293f3c [SUB-3241] fix(verify): pass bound INT twin key in collectInFlightSubSpecDigests

Release & Packaging

  • 24e3d47 [SUB-3191] chore(release): sync PKGBUILD Linux SHA-256 digests for v4.23.0
  • f93b42b [SUB-3202] chore(release): prepare v4.24.0 Open-Core milestone release and...

Full Changelog: v4.23.0...v4.24.0

Release Notes & Architecture Details

Intent & Specifications (intent/architecture/specs/)

  • Defer sibling removed spec fields and TCs across disjoint in-flight commits (INT-2126): Specify deferral for removed spec fields and verification vectors alongside disjoint spec filtering in nomos_intent_traceability_spec.md.
  • Specify intermediate worktree exclusions, heredoc SQL airlock, quoted-DDL CWE-89, and defensive return sprawl (INT-2121): Codify .venv, venv, node_modules, and .tmp segment skipping in walkExplicitRelativeFiles, identifier-quoted DDL exemption in detectCWE89SQLSink, four-plus isinstance/typeof early-return sprawl detection (TC-TS-24), static heredoc source-write airlock precision, and the 6-strike headless container Stop refactoring mandate (TC-BG-11).
  • Specify polyglot wrapper, idiom, clone, and test-rigor gates (INT-2114): Codify the polyglot two-tier one-line return wrapper rule, indent cognitive elif/else child-nesting parity, short sibling clones (>=5 LOC intra-file, >=8 LOC cross-file), cross-language control-flow/idiom checks, .tmp/tests/ hygiene steering, and polyglot test-breadth (>=8 cases) / isolated boundary-mutant spot-checks (TC-TS-23, TC-COV-006, TC-BG-10).
  • Tighten polyglot complexity bounds, trace realpath normalization, and guard contracts (INT-2111, INT-2112): Scope MaxPolyglotCyclomaticComplexity and MaxFunctionCognitiveComplexity (10) to Python/Ruby indent languages while preserving 15 on Go and brace languages (.ts/.svelte), count inline Python ternaries and comprehension filters, and codify >=3/>=5 isinstance sprawl, 1-caller middleman wrappers, non-worktree brownfield verify parity, os.path.realpath trace matching, and --container-sandbox fixture hull exclusions.
  • Codify diff-scoped Python trace coverage and Turn-0 container guidance (INT-2110): Document Git-diff-scoped Python trace coverage (CoverageGate) and Turn-0 --container-sandbox SessionStart .tmp/tests/ guidance across nomos_intent_traceability_spec.md and nomos_hermetic_worktree_spec.md.
  • Codify .tmp/tests/ discovery, behavioral Stop gating, and universal AST invariants (INT-2109): Document per-function polyglot Cognitive Complexity bounds (15), Python (val, err) tuple-return, empty Exception sprawl, and SIM103 boolean-return checks (TC-TS-22), HookSessionTrace.DirtyBehavioralEdits and SessionStart .tmp/tests/ guidance (TC-BG-09), plus scratch regression suite discovery with requirements.txt manifest detection (TC-COV-005).
  • Codify v4.24.0 polyglot design-slop sensors, shell hook tracking, and surface delta invariants (INT-2104, INT-2106): Document 2nd-gen exception gaming, comment-aware coverage exclusions, manifest ImportError fallbacks, wrapper fragmentation, 3-branch chains, venv/site-packages exclusions, Bash content-digest tracking with 4-strike --container-sandbox Stop retries and inline FastFileRadar, SessionStart hull injection, and NormativeSurfaceDelta extraction rules (TC-TS-19..21, TC-CMT-009, TC-BG-08).

Verification & AST Gates (nomos verify)

  • Pass bound INT twin key in in-flight SUB spec digest collection (SUB-3241): Thread the bound Intent twin key through collectInFlightSubSpecDigests so sibling obligation verification resolves active twin specs cleanly.
  • Defer sibling removed fields/TCs and filter disjoint specs (SUB-3239, Twin: INT-2126): Tighten sibling_delta and intent_obligations so removed fields and verification vectors on disjoint deferred specs do not block parallel sibling deliveries.
  • Exclude .venv symlinks in worktree walk, refine quoted-DDL CWE-89, and catch isinstance/typeof return sprawl (SUB-3233, Twin: INT-2121): Skip default intermediate segments (.venv, venv, node_modules, .tmp) in walkExplicitRelativeFiles so virtualenv symlinks never fail ZeroFilesystemAliasGate; exempt identifier-quoted SQLite migration DDL from CWE-89 while keeping value interpolation and unquoted table names fail-closed; flag modules repeating four-plus isinstance or typeof early-return guards while exempting pre-existing brownfield files; raise headless configured container Stop retries to 6 with explicit autonomous refactoring pre-authorization.
  • Gate container test hygiene on nomos.yaml, normalize brownfield count drift, and probe compound boundary operators (SUB-3229): Silence evaluateTestPlacementHygieneAdvisory in workspaces lacking nomos.yaml, normalize embedded numeric counts during brownfield design-slop ratcheting across polyglot extensions, and scan all relational operators across chained expressions, comprehensions, and ternaries up to 6 boundary-mutant probes per checkpoint.
  • Implement polyglot wrapper, idiom, clone, and boundary test-rigor gates (SUB-3223, Twin: INT-2114): Enforce polyglot two-tier single-return micro-wrapper limits across Python, Ruby, TypeScript/JS, Rust, Java, and C# (0/1-caller bans + <=2/<=3 multi-caller caps, keeping Go exempt), align indent cognitive elif/else nesting depth with AST trees, catch >=5-LOC intra-file sibling clones and >=8-LOC cross-file polyglot clones, add helper-call guard, 2-branch jump if, generalized bool-return, (ok, val)/[ok, val] Go-tuple, and collection/nullish idiom scans, emit non-blocking .tmp/tests/ hygiene steering in zero-baseline containers, and enforce >=8-case test breadth plus fast isolated </<= boundary-mutant spot-checks.
  • Scope CC/Cog = 10 default to Python/Ruby while preserving 15 on Go/TS/Svelte (SUB-3218, Twin: INT-2112): Keep MaxPolyglotCyclomaticComplexity and MaxFunctionCognitiveComplexity (10) focused on .py/.rb/.rake indent files while retaining 15 on Go, TypeScript, Svelte, and other brace languages.
  • Enforce polyglot CC/Cog 10, realpath .tmp/tests/ trace, and non-worktree verify parity (SUB-3217, Twin: INT-2111): Wire EffectiveMaxComplexity (10 non-Go, 15 Go) and Python inline ternary/filter cognitive scoring, close non-worktree brownfield/strict nomos verify gaps for design slop, clones, cognitive complexity, and arity, flag >=3/>=5 inline isinstance-raise sprawl, >=2 single-use helpers, and 1-caller middlemen, normalize Python trace paths via os.path.realpath, skip sample fixture dirs in SessionStart hulls, and omit git commit in --container-sandbox Next Actions.
  • Diff-scope Python trace coverage and emit Turn-0 container .tmp/tests/ guidance (SUB-3214, Twin: INT-2110): Pass modified/added non-test .py files via NOMOS_PY_TRACE_FILES when Git scope contains changes so untouched trunk sample fixtures never dilute CoverageGate; put .tmp/tests/test_*.py first in TDDGate remedies and wire --container-sandbox on nomos hook session-start to emit .tmp/tests/ regression-suite guidance even on empty Turn-0 repos.
  • Enforce .tmp/tests/ regression discovery, DirtyBehavioralEdits Stop gating, and universal cognitive/idiom AST sensors (SUB-3213, Twin: INT-2109): Discover untracked .tmp/tests/ suites in TDDGate, GoToolchainGate, CoverageGate (>=80% Python trace coverage), and ResolvePairedTestStatus while including requirements.txt in manifest checks; enforce MaxFunctionCognitiveComplexity (15) and universal Python anti-slop checks ((val, err) tuple returns, >=3 empty Exception subclasses, SIM103 boolean returns) while permitting multi-caller 1-line helpers; gate post-edit behavioral execution in HookSessionTrace and emit Regression Suite .tmp/tests/ guidance in SessionStart.
  • Exclude venv/site-packages, tighten 3-branch chains and 0-caller class methods, and harden container Stop (SUB-3207, Twin: INT-2106): Exclude venv, .venv, and site-packages across workspace.Walk and vscope git-status polyglot scoping; flag >=3 consecutive same-variable if == / if isinstance chains without elif, 0-caller 1-line class methods, and comprehension/ternary return helpers; seed shell mutations in loadOrSyncStopTrace even when ObservedDigests starts empty after failing Bash writes, scope Stop strictly to DirtyUnverifiedEdits, and allow up to 4 --container-sandbox Stop retries with inline FastFileRadar diagnostics.
  • Harden NormativeSurfaceDelta Go AST extraction and v4.24.0 AST edge cases (SUB-3203, Twin: INT-2104): Extend ParseGoSurfaceFingerprintForPath to track exported Go functions/types, exported struct json tags, @intent bindings, and verify/hookcmd diagnostic/banner literals with balanced intra-package split cancellation; collapse multi-line Python except (...) tuples, raise design-slop workspace corpus scanning to 512 files with fail-open skip when exceeded, detect compatibility/legacy/deprecated/checkpoint public pass-through shims with 0 callers, and bind TC-TS-19..21, TC-CMT-009, and TC-BG-08 @verifies test vectors.
  • Enforce 2nd-gen exception gaming, coverage exclusion, and design-slop AST sensors (SUB-3200): Detect >=3-type bug-masking except tuples and silent fallback returns across broad/boundary catches, reject comment-level coverage exclusion directives (pragma: no cover, istanbul/v8/c8 ignore, #[coverage(off)]), reject multi-statement except ImportError fallbacks when libraries are declared in manifests or stdlib, catch 0-caller private pass-through wrappers, flag >=3 single-use 1-line wrapper fragmentation, detect inline isinstance guard ladders and same-variable if == chains, and enforce polyglot control-flow nesting depth across verify and FastFileRadar.

CLI, Distribution & Hooks (nomos hook)

  • Support compound cat heredocs and allow .tmp/tests/ scratch suites (SUB-3235): Parse splitUnquotedShellSegments per command segment in container PreToolUse so chained setup plus static heredoc source writes containing DROP TABLE pass cleanly, and allow .tmp/tests/ scratch suites generated per SessionStart guidance while continuing to block arbitrary hidden dot-dir scripts.
  • Track shell file mutations and surface manifest hull (SUB-3201): Record content digests to detect files created or edited via Bash across PostToolUse and Stop hooks (including --container-sandbox Branch Guard repos), enable PostToolUse AST radar on active Branch Guard feature branches, and surface declared dependencies (Manifest Deps) and workspace symbols (Workspace Modules) during SessionStart.