Repository navigation
[0.2.0] - 2026-11-11
End-to-end architectural upgrade uniting Shared Task Wiring Contracts (flow_blueprint ⇄ flow_verify), 3-Tier Evidence Separation (L1_STRUCTURAL / L2_DATA_FLOW / L3_BEHAVIORAL), Typed & Evidenced Graph Edges (8 Polyglot Bridge Channels), Graph-Diff Incremental Verification (G_base ➔ G_curr), and Tri-State Verdicts (SATISFIED / VIOLATED / INCONCLUSIVE) — verified across 142 automated assertions (69 adversarial torture + 73 real-task incomplete-wiring & legal counterexample assertions, achieving 100% defect recall (8/8) and 0% false violations (0/6)).
Added
- Shared Task Wiring Plan (
flow_blueprint⇄flow_verify,src/wiring-contract.mjs,src/flow-tools.mjs,src/flow-verifier.mjs):flow_blueprintbuilds and persists a structuredwiringPlan(obligationswith target location, reason, expected relation, reference basis, verification method, andambiguitiesToConfirm), acceptingtargetSymbol,targetField,consumerTarget, andrequirePersistence.flow_verifyevaluates both persisted blueprint obligations and auto-inferred delta obligations (A1–A9), closing the loop between planning and verification.
- 3-Tier Evidence Separation (
L1_STRUCTURAL➔L2_DATA_FLOW➔L3_BEHAVIORAL) & Context-AwareexportSemantics (src/graph-builder.mjs,src/file-parser.mjs,src/wiring-contract.mjs):inferWorkspaceProfiledistinguishesapplication,library, andhybridworkspaces with two-tier reachability (reachableFromRuntimeSourcevsreachableFromSource): library exports remain valid external entry points, whereas newly exported symbols in anapplicationwithout runtime entry evidence are flagged as unwired (unwiredExports).- Field-level
L2_DATA_FLOWverification checks that newly added config/protocol fields reach their downstreamconsumerTarget(detecting cases where a setting is saved to config while calculation logic still reads a hardcodedUPPER_CASEconstant, or where frontend/backend IPC/HTTP payload keys drift) and verifies field-levelSave ⇄ Loadpersistence symmetry (fieldLifecycleAsymmetries). - Optional
runTestsCommandparameter executes behavioral test/probe commands forL3_BEHAVIORALevidence while marking static-only behavioral checksINCONCLUSIVE.
- Typed & Evidenced Graph Relations + 8-Channel Polyglot Bridges (
src/file-parser.mjs,src/bridge-linker.mjs,src/graph-builder.mjs,src/flow-tools.mjs):- Classifies graph relations into
CONTAINS,SEQ_CALL,BRANCH_DISPATCH,REGISTRATION,STATE_RW,IMPLEMENTS, andPROTOCOL_BRIDGE, recordingfile:line,passedArgs,returnFlow,resolution.mode, andconfidence(HIGH | MEDIUM | AMBIGUOUSwith fullcandidatespreserved on ambiguous matches). - Separates
siblingBranchesToCheck(conditional dispatch peers) fromsequentialStepsInCaller(authenticate -> validate -> save) inflow_trace. - Adds
WEBVIEW2_IPC(window.chrome.webview⇄ C++/C#WebMessageReceived/PostWebMessageAsJson) andSHARED_MEMORY_IPC(Win32CreateFileMapping/ POSIXshm_open⇄ Pythonmmap/shared_memory), RPC client-prefix disambiguation, and IPC/HTTP payload field extraction.
- Classifies graph relations into
- Graph-Diff Incremental Verification (
G_base ➔ G_curr,src/graph-diff.mjs,src/hook-runner.mjs,src/server.mjs):- Supports both
SessionStartbaseline snapshots and arbitrary Git references (baseRef/--base <git-ref>, reconstructed in-memory viagit diff --name-status+git showwithout touching the working tree). - Expands verification scope along dependency edges (
impactedUntouchedFiles) to catch untouched-file regressions (newlyWriteOnlyStates,newlyWriterlessStateReads,newlyOrphanedSymbols,newlyBrokenPaths) while isolatingpreExistingBrokenBridgesfromnewlyBrokenBridges.
- Supports both
- Tri-State Verdicts (
SATISFIED/VIOLATED/INCONCLUSIVE), Dead-Code Evidence Grading & SmartStopHook (src/flow-verifier.mjs,src/hook-runner.mjs):- Reports explicit obligation breakdowns (
headlineSummary) and separatesCONFIRMED_SAFE_TO_DELETEprivate dead pipes fromNO_STATIC_CALLER_EVIDENCEunwired exports, plus write-only telemetry/audit sink exemptions. Stophook blocks strictly on newly introducedVIOLATEDcontracts/breaks (never blocking onINCONCLUSIVEor historical broken bridges) and supportsFLOWGUARD_MODE=advisory.
- Reports explicit obligation breakdowns (
- 14-Scenario Real-Task Incomplete-Wiring Benchmark Suite (
test/task-benchmark-suite.mjs):- Adds 73 end-to-end assertions across 8 realistic incomplete-wiring tasks (
100%recall) and 6 legal counterexamples (0%false violations), bringing total automated assertions to142(69torture +73task benchmark).
- Adds 73 end-to-end assertions across 8 realistic incomplete-wiring tasks (
Changed & Fixed
- Honest Similarity & Capability Labeling (
src/flow-tools.mjs,src/fingerprint.mjs,README.md): Replaced overstated "AST fingerprint" wording with explicitLEXICAL_SHINGLE_JACCARDlabeling and documented static vs. runtime verification boundaries. - Case-Aware Symmetric Lifecycle Pairs (
src/fingerprint.mjs): ExtendedSYMMETRIC_PAIRSto recognize camelCase and snake_case (saveConfig/loadConfig,toJSON/fromJSON,persist/restore,save_preferences/load_preferences) in addition to PascalCase. - Parser Edge-Case Fixes (
src/file-parser.mjs,src/lang-presets.mjs): Fixed C++ file-localstaticfunctionisPublicApiclassification, bottom-of-fileexport { fn }false self-reference, shorthand object payload extraction ({ a, b }), ternary? "str"false EventBus emitter matching, and Windows backslash normalization inSHARED_MEMORY_IPC.
Full Changelog: v0.1.1...v0.2.0