From 728788fdb3ac6a1538a6f91b676c775931373af2 Mon Sep 17 00:00:00 2001 From: Tom Boucher Date: Thu, 11 Jun 2026 11:55:55 -0400 Subject: [PATCH] fix(#1034): correct stale intel.cts comments to canonical INTEL_FILES names (#1036) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Three maintainer-facing comments in src/intel.cts referenced the retired short/markdown intel filenames (files.json, deps.json, arch.md) and described arch as searched "text lines", though the implementation iterates the exported INTEL_FILES map and parses every entry — arch included — as JSON. Update the comments to cite the canonical names (file-roles.json, dependency-graph.json, arch-decisions.json) and the JSON-for-arch behavior. Comment-only; no code or behavior change. Deferred from the #1000 fix. Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> Co-authored-by: Claude Opus 4.8 --- src/intel.cts | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/src/intel.cts b/src/intel.cts index f9ccb5a5c..8b1925da1 100644 --- a/src/intel.cts +++ b/src/intel.cts @@ -185,7 +185,7 @@ interface IntelQueryResult { /** * Query intel files for a search term. - * Searches across all JSON intel files (keys and values) and arch.md (text lines). + * Searches across all JSON intel files in INTEL_FILES (keys and values), including arch-decisions.json (parsed as JSON, not as text). */ function intelQuery(term: string, planningDir: string): IntelQueryResult | DisabledResponse { if (!isIntelEnabled(planningDir)) return disabledResponse(); @@ -417,7 +417,7 @@ function intelValidate(planningDir: string): IntelValidateResult | DisabledRespo // Validate entries are objects with expected fields if (data.entries && typeof data.entries === 'object') { - // files.json: check exports are actual symbol names (no spaces) + // file-roles.json (INTEL_FILES key 'files'): check exports are actual symbol names (no spaces) if (key === 'files') { for (const [entryPath, entry] of Object.entries(data.entries)) { const entryObj = entry as Record; @@ -438,7 +438,7 @@ function intelValidate(planningDir: string): IntelValidateResult | DisabledRespo } } - // deps.json: check entries have version, type, used_by + // dependency-graph.json (INTEL_FILES key 'deps'): check entries have version, type, used_by if (key === 'deps') { for (const [depName, entry] of Object.entries(data.entries)) { const entryObj = entry as Record;