Repository navigation
v4.24.0
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 innomos_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.tmpsegment skipping inwalkExplicitRelativeFiles, identifier-quoted DDL exemption indetectCWE89SQLSink, four-plusisinstance/typeofearly-return sprawl detection (TC-TS-24), static heredoc source-write airlock precision, and the 6-strike headless containerStoprefactoring 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 cognitiveelif/elsechild-nesting parity, short sibling clones (>=5LOC intra-file,>=8LOC cross-file), cross-language control-flow/idiom checks,.tmp/tests/hygiene steering, and polyglot test-breadth (>=8cases) / 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): ScopeMaxPolyglotCyclomaticComplexityandMaxFunctionCognitiveComplexity(10) to Python/Ruby indent languages while preserving15on Go and brace languages (.ts/.svelte), count inline Python ternaries and comprehension filters, and codify>=3/>=5isinstancesprawl,1-caller middleman wrappers, non-worktree brownfieldverifyparity,os.path.realpathtrace matching, and--container-sandboxfixture 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-sandboxSessionStart.tmp/tests/guidance acrossnomos_intent_traceability_spec.mdandnomos_hermetic_worktree_spec.md. - Codify
.tmp/tests/discovery, behavioralStopgating, and universal AST invariants (INT-2109): Document per-function polyglot Cognitive Complexity bounds (15), Python(val, err)tuple-return, emptyExceptionsprawl, andSIM103boolean-return checks (TC-TS-22),HookSessionTrace.DirtyBehavioralEditsandSessionStart.tmp/tests/guidance (TC-BG-09), plus scratch regression suite discovery withrequirements.txtmanifest 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-packagesexclusions,Bashcontent-digest tracking with 4-strike--container-sandboxStopretries and inlineFastFileRadar,SessionStarthull injection, andNormativeSurfaceDeltaextraction rules (TC-TS-19..21,TC-CMT-009,TC-BG-08).
Verification & AST Gates (nomos verify)
- Pass bound
INTtwin key in in-flightSUBspec digest collection (SUB-3241): Thread the bound Intent twin key throughcollectInFlightSubSpecDigestsso sibling obligation verification resolves active twin specs cleanly. - Defer sibling removed fields/TCs and filter disjoint specs (
SUB-3239, Twin:INT-2126): Tightensibling_deltaandintent_obligationsso removed fields and verification vectors on disjoint deferred specs do not block parallel sibling deliveries. - Exclude
.venvsymlinks in worktree walk, refine quoted-DDLCWE-89, and catchisinstance/typeofreturn sprawl (SUB-3233, Twin:INT-2121): Skip default intermediate segments (.venv,venv,node_modules,.tmp) inwalkExplicitRelativeFilesso virtualenv symlinks never failZeroFilesystemAliasGate; exempt identifier-quoted SQLite migration DDL fromCWE-89while keeping value interpolation and unquoted table names fail-closed; flag modules repeating four-plusisinstanceortypeofearly-return guards while exempting pre-existing brownfield files; raise headless configured containerStopretries to6with explicit autonomous refactoring pre-authorization. - Gate container test hygiene on
nomos.yaml, normalize brownfield count drift, and probe compound boundary operators (SUB-3229): SilenceevaluateTestPlacementHygieneAdvisoryin workspaces lackingnomos.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 to6boundary-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/<=3multi-caller caps, keeping Go exempt), align indent cognitiveelif/elsenesting depth with AST trees, catch>=5-LOC intra-file sibling clones and>=8-LOC cross-file polyglot clones, add helper-call guard,2-branch jumpif, 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 = 10default to Python/Ruby while preserving15on Go/TS/Svelte (SUB-3218, Twin:INT-2112): KeepMaxPolyglotCyclomaticComplexityandMaxFunctionCognitiveComplexity(10) focused on.py/.rb/.rakeindent files while retaining15on 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): WireEffectiveMaxComplexity(10non-Go,15Go) and Python inline ternary/filter cognitive scoring, close non-worktree brownfield/strictnomos verifygaps for design slop, clones, cognitive complexity, and arity, flag>=3/>=5inlineisinstance-raisesprawl,>=2single-use helpers, and1-caller middlemen, normalize Pythontracepaths viaos.path.realpath, skip sample fixture dirs inSessionStarthulls, and omitgit commitin--container-sandboxNext Actions. - Diff-scope Python trace coverage and emit Turn-0 container
.tmp/tests/guidance (SUB-3214, Twin:INT-2110): Pass modified/added non-test.pyfiles viaNOMOS_PY_TRACE_FILESwhen Git scope contains changes so untouched trunk sample fixtures never diluteCoverageGate; put.tmp/tests/test_*.pyfirst inTDDGateremedies and wire--container-sandboxonnomos hook session-startto emit.tmp/tests/regression-suite guidance even on empty Turn-0 repos. - Enforce
.tmp/tests/regression discovery,DirtyBehavioralEditsStopgating, and universal cognitive/idiom AST sensors (SUB-3213, Twin:INT-2109): Discover untracked.tmp/tests/suites inTDDGate,GoToolchainGate,CoverageGate(>=80%Python trace coverage), andResolvePairedTestStatuswhile includingrequirements.txtin manifest checks; enforceMaxFunctionCognitiveComplexity(15) and universal Python anti-slop checks ((val, err)tuple returns,>=3emptyExceptionsubclasses,SIM103boolean returns) while permitting multi-caller 1-line helpers; gate post-edit behavioral execution inHookSessionTraceand emitRegression Suite.tmp/tests/guidance inSessionStart. - Exclude
venv/site-packages, tighten 3-branch chains and 0-caller class methods, and harden containerStop(SUB-3207, Twin:INT-2106): Excludevenv,.venv, andsite-packagesacrossworkspace.Walkandvscopegit-status polyglot scoping; flag >=3 consecutive same-variableif ==/if isinstancechains withoutelif, 0-caller 1-line class methods, and comprehension/ternary return helpers; seed shell mutations inloadOrSyncStopTraceeven whenObservedDigestsstarts empty after failingBashwrites, scopeStopstrictly toDirtyUnverifiedEdits, and allow up to 4--container-sandboxStopretries with inlineFastFileRadardiagnostics. - Harden
NormativeSurfaceDeltaGo AST extraction and v4.24.0 AST edge cases (SUB-3203, Twin:INT-2104): ExtendParseGoSurfaceFingerprintForPathto track exported Go functions/types, exported structjsontags,@intentbindings, andverify/hookcmddiagnostic/banner literals with balanced intra-package split cancellation; collapse multi-line Pythonexcept (...)tuples, raise design-slop workspace corpus scanning to512files with fail-open skip when exceeded, detect compatibility/legacy/deprecated/checkpoint public pass-through shims with 0 callers, and bindTC-TS-19..21,TC-CMT-009, andTC-BG-08@verifiestest vectors. - Enforce 2nd-gen exception gaming, coverage exclusion, and design-slop AST sensors (
SUB-3200): Detect >=3-type bug-maskingexcepttuples 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-statementexcept ImportErrorfallbacks when libraries are declared in manifests or stdlib, catch 0-caller private pass-through wrappers, flag >=3 single-use 1-line wrapper fragmentation, detect inlineisinstanceguard ladders and same-variableif ==chains, and enforce polyglot control-flow nesting depth acrossverifyandFastFileRadar.
CLI, Distribution & Hooks (nomos hook)
- Support compound
catheredocs and allow.tmp/tests/scratch suites (SUB-3235): ParsesplitUnquotedShellSegmentsper command segment in containerPreToolUseso chained setup plus static heredoc source writes containingDROP TABLEpass cleanly, and allow.tmp/tests/scratch suites generated perSessionStartguidance 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 viaBashacrossPostToolUseandStophooks (including--container-sandboxBranch Guard repos), enablePostToolUseAST radar on active Branch Guard feature branches, and surface declared dependencies (Manifest Deps) and workspace symbols (Workspace Modules) duringSessionStart.