fix(#1034): correct stale intel.cts comments to canonical INTEL_FILES names (#1036)

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 <noreply@anthropic.com>
This commit is contained in:
Tom Boucher
2026-06-11 11:55:55 -04:00
committed by GitHub
parent 1fab2e10ba
commit 728788fdb3

View File

@@ -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<string, unknown>;
@@ -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<string, unknown>;