2 Commits

Author	SHA1	Message	Date
Tom Boucher	5fa4dcd78c	fix: recover silently-excluded test dirs + test-architecture audit hardening (#1195) ... * fix: recurse test discovery so subdir test suites actually run scripts/run-tests.cjs discovered tests with a flat readdirSync(testDir), silently excluding tests/observability/ (4 files), tests/dispatch/ (1) and tests/installer-migrations/ (1) — 94 passing tests — from `npm test` and all CI lanes. Walk the tree recursively (relative subpaths preserved), classify suites by basename, and add a fail-on-zero-executed guard for suite/default runs (escape hatch GSD_ALLOW_EMPTY_SUITE=1) while preserving the empty --files/--files-from path the CI inert lane relies on. Unit suite 735 -> 741 files; surfaces ADR-227's observability/dispatch seam. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * test: retire 5 verified-worthless tests Adversarial verification confirmed these 5 prove nothing — their coverage is provided more strictly elsewhere: - enh-2790 'has a name: field' spot-checks (command-contract enforces /^gsd[:-]/) - command-routing-hub duplicate construct + duplicate ERROR_KINDS assertions - no-cjs-sdk-handsync-tooling (guarded files that never existed on main; bug-190 covers the real retired SDK artifacts) - runtime-artifact-layout cline edge case (subsumed by the explicit-global test and bug-782-cline-skills-emission) Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * test: add ADR-218 release version-validation coverage ADR-218 (reject leading-zero versions like 1.01.0; npm duplicate pre-check) had zero tests — the logic lived only in release.yml bash. Add a test that extracts the actual rejection regexes from the workflow and exercises them against a boundary table (leading-zero/malformed rejected, valid accepted) plus structural wiring assertions. Goes red if the regex is reverted to [0-9]+. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * test: redesign weak tests into behavioral, deterministic assertions Per the ADR test audit, rewrite 27 weak test files (test-only, no source changes) so each can go red for the defect it guards: - kill pass-always assert.ok(true) placeholders (research-cli, worktree-baseref, bug-260 security guard, eslint-rules x24, clusters '|| true') - replace source-text grep with behavioral calls (install Kilo, sh-hook-paths, plan-review-convergence) and add a repo-layout governance test - de-flake real-clock/Math.random coupling (phase last_updated, bug-3707 mtime, context-utilization property, feat-3594) - fix independence/shared-state violations (bug-492 singleton, issue-844 tmpRoot, core reapStaleTempFiles, active-workstream TTY, feat-488 GSD_HOME) - strengthen property/shape-only tests (research-provider/store classification + collision) and unconditional plugin.json schema validation (issue-766) Verified: all 28 files run together 1220 pass / 0 fail / 1 skip. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * chore: add no-tautological-assert lint rule, error in test suite New custom ESLint rule (eslint-rules/no-tautological-assert.cjs) bans asserts that can never fail: assert(true)/assert.ok(<always-truthy literal>), 'cond || true' inside an assert, and equality asserts comparing two identical literals. Wired as error on tests/**; full sweep confirmed zero existing violations so the suite stays green. Prevents the placeholder-assert regressions the audit redesigns just removed. RuleTester coverage added (6 valid, 8 invalid). Note: no-only-tests was already enforced via eslint-plugin-no-only-tests, so no duplicate rule was added. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * chore: gate new allow-test-rule exemptions to require an issue ref ADR-456 requires any allow-test-rule exemption added after the ADR to carry a tracking issue number, but nothing enforced it. New ratchet gate (scripts/lint-allow-test-rule-refs.cjs, wired into lint:ci) fails when a NEW allow-test-rule comment lacks a #NNN/URL reference; the 323 existing untracked exemptions are grandfathered in an allowlist that ratchets down as they gain refs. Red-green verified (novel untracked offender fails; compliant passes). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * docs: add ADR test-audit evidence report (#1192) Full risk-first qa-test-architect audit of the ADR portfolio (37 ADRs + 4 platform lenses, adversarial verification of retire verdicts) that drove the P0 discovery fix, ADR-218 coverage, 5 retires, 27 redesigns, and the two new lint gates. Filed as point-in-time evidence under docs/issueevidence/, named for tracking issue #1192. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * test: replace pre-existing raw NUL byte with escape in feat-3594 fixture feat-3594's null-byte parser fixture contained a literal NUL byte (pre-existing on next at b10e5681 — confirmed: base blob has 1 NUL, this fix has 0), which made git treat the file as binary and would break grep/editors. Switch to the \x00 escape; the runtime string value (a real NUL in the parser input) is unchanged. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * test: address adversarial-review findings Codex adversarial pass over the branch: - capability-registry drift test no longer mutates the committed generated capability-registry.cjs in place (concurrency hazard) — uses in-memory checkPipeline comparison instead. - allow-test-rule ratchet now detects exemptions in ALL comment forms (block /* */ too, matching no-source-grep) so a block comment can't bypass it; one newly-surfaced pre-existing offender grandfathered (323->324). - install.test Kilo case asserts on what install(false,'kilo') actually writes rather than manually calling configureKiloPermissions (masked the call site). - issue-766 drops the undeclared transitive ajv dep for explicit structural assertions from the schema fixture. - adr-218 test notes the hotfix leading-zero gap is tracked in #1186. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * fix: address code-review findings (subdir discovery, rule + test gaps) xhigh code review surfaced 15 confirmed issues, all fixed: - run-tests.cjs --files now resolves subdir tests by bare basename + handles Windows backslash paths (ambiguous basenames error clearly). - affected-tests-lib.cjs listTestFiles made recursive — the targeted CI lane was silently dropping changed subdir tests (same false-green class the audit fixed). - no-tautological-assert now catches 'true || cond' and empty []/{} equality. - verify-test-quality: restore provenance-classification coverage, tighten the writeFile circular-detection check, guard the module-level file read. - sh-hook-paths: cover the global-install .sh delegation branch (#2045 guard). - active-workstream null-guard runs deterministically (no longer skipped on TTY). - adr-218 structural guards tightened (major/minor leading-zero; needs: membership). - repo-layout AGENTS.md guard no longer false-alarms on equivalent refactors. - cross-ai ordering guard fails red when the step is missing. - issue-766 parses required fields from the schema fixture (auto-enforced). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * test: stub USERPROFILE alongside HOME in feat-488 (Windows parity) The feat-488 redesign stubbed process.env.HOME but not USERPROFILE; os.homedir() resolves from USERPROFILE on Windows, so the home stub was not hermetic there — caught by windows-test-parity-guard (stubsHomeNoUserProfile). Save/set/restore USERPROFILE symmetrically with HOME (delete-if-originally-undefined). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * chore: reconcile allow-test-rule allowlist after rebase onto next Rebasing onto current next pulled in merged PR #1170, which added inventory-headings-countfree.test.cjs (a baseline allow-test-rule exemption) and deleted inventory-counts.test.cjs. Grandfather the former and prune the latter so the ratchet matches the merged tree. No new debt from this PR. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>	2026-06-13 23:35:08 -04:00
Tom Boucher	11afca2968	feat(#656): Research module — content-addressed cache + provider seam + registry-API legitimacy (#664) ... * feat(#656): add Research Store module (content-addressed cache, TTL staleness) Content-addressed research cache behind a clock seam: researchKey (sha256, deterministic), putResearch/getResearch ({hit,stale}, never throws), ttlForSource (curated HIGH 30d / MED 7d / web LOW 1d), two-tier resolveStorePath (curated -> ~/.gsd/research-cache, web/synthesis -> project .planning/research/.cache). 28 behavioral + property tests; boundary coverage at ttl-1/ttl/ttl+1. Issue #656. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * feat(#656): add Research Provider module (waterfall + confidence + plan) Single source of truth for the Balanced provider waterfall (docs Context7->Ref->Jina, web Exa+Tavily, fallback Perplexity/Brave, Firecrawl scrape-only). classifyConfidence stamps HIGH|MEDIUM|LOW by provider (never throws). providerAvailability maps config flags to usable providers. planResearch checks the Research Store (injected seam) and returns cache-hits + a per-question fetch plan, falling through the waterfall to the always-available websearch terminal. 22 behavioral + property tests. Issue #656. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * feat(#656): add Package Legitimacy module (registry-API verdicts, slopcheck optional) Replaces the pip-install-or-degrade slopcheck prose gate with code: classifyPackage (pure, never throws) computes OK|SUS|SLOP from tunable thresholds (minAgeDays 30, minWeeklyDownloads 1000, requireRepo). checkPackages queries injectable npm/PyPI/crates registry adapters (real https with 5s timeout, degraded-not-thrown on failure); slopcheck is one optional adapter that can only escalate severity, never degrade to [ASSUMED]. 34 behavioral + property tests; boundary coverage on age and downloads (limit-1/limit/limit+1). Known follow-up: real npm adapter must add api.npmjs.org last-week downloads fetch (currently null -> unknown-downloads). Issue #656. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * feat(#656): detect Tavily/Ref/Perplexity/Jina provider keys; complete npm downloads adapter config: add tavily_search/ref_search/perplexity/jina availability flags (env var or ~/.gsd/<x>_api_key), mirroring brave_search/exa_search/firecrawl, so the Research Provider waterfall can gate them. package-legitimacy: real npm adapter now fetches api.npmjs.org last-week downloads (bounded, degraded-not-thrown) so weeklyDownloads is populated. +12 config tests; 34 legitimacy tests unchanged. Issue #656. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * feat(#656): expose Research seam via gsd-tools query (research-plan, research-store, package-legitimacy) Routes the L2-hybrid surface so agents reach it as CLI: 'query research-store get/put' (cache, HOME-sandboxable), 'query research-plan --input' (cache-hits + fetch plan from planResearch), 'query package-legitimacy check --ecosystem' (async registry verdicts). Commands skip .planning root resolution and appear in top-level usage. 5 behavioral runGsdTools tests; command-contract unchanged (335). Issue #656. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * docs(#656): document Research module (CONTEXT predicates, ADR-0656, architecture, changeset) Adds GSD-RESEARCH.* + DEFECT.RESEARCH-PROVIDER-PROSE-DRIFT predicates to CONTEXT.md, ADR-0656 recording the L2-hybrid seam decision, a docs/ARCHITECTURE.md Research Module subsection, and an Added changeset fragment (pr:0, backfill on PR). Notes the #657 deferrals (agent collapse + install.js MCP mapping). Issue #656. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * chore(#656): sync inventory for research modules Regenerate INVENTORY-MANIFEST.json and bump docs/INVENTORY.md CLI Modules count 82->85 with rows for research-store/research-provider/package-legitimacy (DEFECT.INVENTORY-DRIFT). Issue #656. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * chore(#656): eslint-ignore generated research .cjs artifacts (ADR-457) research-store/research-provider/package-legitimacy .cjs are tsc-generated from src/*.cts, so they belong in the ESLint ignore block (lint the .cts source, not the emitted .cjs). Fixes tests/551-eslint-bin-lib-coverage. Issue #656. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * chore(#656): backfill changeset pr number to #664 Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * chore(#656): satisfy eslint lint-tests gate Fix 20 eslint errors in the new research files: use helpers.cleanup() instead of raw fs.rmSync() in tests (local/no-raw-rmsync-in-tests, Windows-EBUSY retry budget); drop redundant '| string' union members and unnecessary type assertions; deterministic object normalization in researchKey (no-base-to-string). Logic unchanged; 6180 tests still green. Issue #656. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(#656): harden package legitimacy per review (W1/W2/I3/I4) W1: httpsGet now reads statusCode; npm/PyPI/crates map 404 -> exists:false -> SLOP (registry-existence is the #1 slopsquatting defense; previously only npm caught it). Transport made injectable (_setHttpGet) for hermetic 404 tests. W2: suspicious-postinstall is now terminal SLOP independent of the optional slopcheck adapter, and the regex drops the bare https?:// arm (over-fired on esbuild/sharp/node-gyp) for shell-exec/download-exec signatures only. I3: checkPackages now threads version to registry.lookup and adapters verify that specific version exists. I4: moreServerVerdict -> moreSevereVerdict. +11 regression tests (all RED-first); 45 total green. Addresses review by @davesienkowski on #664. Issue #656. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(#656): research-store tier coherence + freshness + version TTL (W4/I1/I2/I4) I1: tier now derives from source (curated -> user ~/.gsd, else -> project .planning), not kind, so put-tier and get-tier can't diverge; kind is a key component only. W4: getResearch searches both tiers and returns the freshest (non-stale preferred), never letting a stale curated entry shadow a fresh web one; blank version caps TTL at 1 day (no 30d on version-blind keys). I2: atomic platformWriteSync instead of raw fs.writeFileSync on the shared global path. I4: dropped the dead ttlForSource arm. CLI get now searches both tiers. +5 RED-first regression tests; 38 green. Addresses review by @davesienkowski on #664. Issue #656. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(#656): expose classifyConfidence as a CLI route, killing dead code (W3) Adds 'gsd-tools query classify-confidence --provider X [--verified]' so research agents get the confidence tier FROM CODE (provider waterfall + verification lever) instead of asserting it in prose. classifyConfidence previously had no runtime caller. HIGH means 'trusted provider'; --verified raises web results to MEDIUM (verification semantics documented in ADR-0656). +4 behavioral tests. Addresses review by @davesienkowski on #664 (W3). Issue #656. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(#656): close Codex adversarial-review findings (path-traversal, version-age, malformed-cache) HIGH: research key must be 64-hex sha256 (isValidResearchKey) + resolved-path containment check in put/get + CLI validation -> blocks '../../x' arbitrary-file-write. HIGH: package legitimacy now derives publishedAt from the REQUESTED version (npm time[version], PyPI releases[version] upload_time, crates versions[].created_at) so a new malicious version of an old package can't inherit old age and evade 'too-new'. MEDIUM: getResearch validates entry shape (finite fetched_at + positive ttl + required fields) -> malformed cache entry is a miss, not fresh-forever. +regression tests (RED-first); 111 green. Codex adversarial review (required pre-PR gate). Issue #656. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(#656): close code-review correctness findings (1) package-legitimacy CLI now rejects unknown --flags instead of silently consuming the following package as a flag value; only --ecosystem takes a value. (2) crates recent_downloads (90-day) normalized to a weekly figure before the minWeeklyDownloads threshold (was ~13x too lenient). (3) research-plan --input validates parsed JSON is an object with an Array questions before destructuring -> clean usage error instead of an uncaught TypeError on null/bad input. (4) research-store put rejects a flag value that is itself a --flag (no more storing '--source' as content). (5) planResearch skips questions whose text is not a non-empty string instead of emitting question:undefined. +13 RED-first regression tests; 143 green. Code-review gate. Issue #656. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * refactor(#657): extract researcher documentation_lookup to shared @-reference 6 researcher agents carried a near-duplicate <documentation_lookup> block; consolidate into gsd-core/references/research-documentation-lookup.md (@-included). Unifies the ctx7 CLI fallback to the safer 'command -v ctx7' guard (drops silent 'npx --yes ctx7@latest' execution in 5 agents). Behavior-preserving dedup; inventory 63->64 references. Phase A of the agent collapse. Issue #657. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * refactor(#657): extract researcher philosophy + verification-protocol to shared @-references philosophy and the pitfalls+pre-submission-checklist common-core were near-duplicated in project/phase researchers; consolidate into gsd-core/references/research-{philosophy,verification-protocol}.md (@-included). phase-researcher keeps its 3 extra checklist items inline. Pre-submission domains checklist made agent-agnostic so project-researcher doesn't lose features/architecture coverage. Write-contract intentionally left inline (bug-214 tests assert it verbatim). Inventory 64->66 refs. Behavior-preserving. Phase A. Issue #657. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * feat(#657): wire gsd-phase-researcher to the Research seam (Phase B / S1) The phase researcher now CALLS the code seam instead of carrying inline mechanics: provider waterfall -> 'gsd-tools query research-plan' (+ research-store put to cache digests); confidence-tier prose -> 'gsd-tools query classify-confidence'; slopcheck pip-install protocol -> 'gsd-tools query package-legitimacy check'. This makes the Research module a real runtime consumer (validates the seam end-to-end, addresses reviewer S1) and removes the duplicated waterfall/confidence/slopcheck prose. RESEARCH.md output contract, commit step, structured returns, and Phase-A @-includes unchanged. package-legitimacy-gate.test.cjs rewritten prose-grep -> behavioral (asserts the seam invocation). Issue #657. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * feat(#657): wire gsd-project-researcher to the seam + add tavily/ref/jina MCP tools (Phase C.1) project-researcher now calls gsd-tools query research-plan / classify-confidence (+ research-store put) instead of the inline provider waterfall + confidence-tier prose (mirrors the phase-researcher rewire; no package-legitimacy — phase-only). Output contract (STACK/FEATURES/ARCHITECTURE/PITFALLS/SUMMARY.md + sections, no-commit, structured returns, Phase-A @-includes) unchanged. Adds mcp__tavily/ref/jina__* to the project/phase/ui researcher tools frontmatter (Balanced provider set) so install.js MCP mapping (C.2) has a consumer. Issue #657. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * test(#657): cover tavily/ref/jina MCP install handling + frontmatter parity guard (Phase C.2) Investigation: exa/firecrawl have no explicit per-runtime tool-mapping — every mcp__<server>__* except context7 rides the generic passthrough (Copilot lowercases; OpenCode/Cursor/Windsurf/Augment keep as-is; Gemini auto-discovers). tavily/ref/jina are handled identically, no install path broken. Added 12 copilot-install passthrough tests + a mcp-tool-inheritance parity guard (tavily co-declared with exa, jina with firecrawl, ref present across the 3 web researchers) so the MCP set can't drift. No io.github registry ids invented (none sourceable in-repo); documented as a follow-up. 488 tests green. Issue #657. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * feat(#657): profiles as source of truth for researcher agents + drift-guard (Phase C.3) scripts/research-profiles.cjs declares each of the 7 researcher agents' identity + contract (name, description, color, tools, required @-includes, required gsd-tools seam calls, output-contract markers). scripts/gen-research-agents.cjs --check validates every committed agent against its profile; --write regenerates ONLY the frontmatter from profiles (body untouched) and is a verified no-op against the current agents (zero diff = fidelity). tests/research-agent-profiles.test.cjs is the DEFECT.GENERATIVE-FIX drift guard. Design note: profiles govern the generatable/contract surface rather than destructively regenerating the disparate operational prose bodies (those were deduped via @-includes in Phase A). scripts/ is not inventoried (no inventory change). Issue #657. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(#657): complete agent provider-dispatch + parity guard; align legitimacy field; validate profiles Adversarial-review findings: (HIGH) the seam-wired agents' Step-C dispatch only mapped 6 providers, so a planResearch result of jina/ref/perplexity/brave (reachable via the waterfall fallbacks) had no handling -> agent stall; completed both agents' dispatch to all 9 PROVIDER_WATERFALL ids + a catch-all, and added a parity test asserting agent dispatch stays in sync with research-provider PROVIDER_WATERFALL (DEFECT.GENERATIVE-FIX). (MEDIUM) phase-researcher package-legitimacy JSON example used 'package' but the module returns 'name' -> aligned. (LOW) gen-research-agents checkAgent now returns a clear failure for a malformed profile instead of throwing. +parity/validation tests (RED-first). Issue #657. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> * fix(#656): make classifyConfidence verification-evidence-driven (W3) Confidence conflated provider authority with claim verification — context7/ref stamped HIGH purely by provider identity, and the only verification lever was a self-set --verified flag. Split into two axes: provider authority (static) + verification evidence (code-computed). HIGH now requires ground-truth corroboration (legitimacyVerdict OK), independent of provider; authority alone caps at MEDIUM; SLOP caps at LOW; the self-reported --verified is demoted to a MEDIUM-only web lever. HIGH = corroborated-against-authoritative-source, not a correctness guarantee. Adds --legitimacy-verdict to the classify-confidence CLI; updates CONTEXT.md predicate + ADR-0656 (tier set unchanged, ADR-consistent). Addresses davesienkowski's W3 review on #664. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> * fix(#656): bind classify-confidence verdict to code, closing CLI self-grading Adversarial review found the new --legitimacy-verdict flag was caller-supplied, so an agent could self-assert OK->HIGH without any real legitimacy check — reintroducing the exact self-grading hole W3 closes. Remove the free flag; the CLI now computes the verdict via checkPackages only when --package/--ecosystem is given (code-computed, not agent-asserted). Update the stale CLI test (context7 alone -> MEDIUM) and extend the property test to vary legitimacyVerdict. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> --------- Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>	2026-06-05 17:58:48 -04:00