Introduce `runtime-slash.cjs` as the single source of truth for emitting GSD slash-command references in user-facing runtime output and persisted artifacts. `formatGsdSlash(commandName, runtime)` produces `/gsd-<cmd>` for skills-based runtimes (Claude/Cursor/OpenCode/Kilo/etc.) and `$gsd-<cmd>` for Codex. The deprecated `/gsd:<cmd>` colon form is never emitted — pasting a recommended-action command into Claude Code now routes correctly instead of failing with `Unknown command`. Wired into the high-impact emitters identified in #3584: - `init.cjs` `cmdInitManager` recommended_actions[].command (the original failure path in the bug report) plus the no-ROADMAP / no-STATE error hints. - `phase.cjs` `cmdPhaseAdd`, `cmdPhaseAddBatch`, `cmdPhaseInsert` — ROADMAP.md `Plans:` references now persist the routable form instead of the legacy colon form. - `verify.cjs` `cmdValidateHealth` — every fix-hint addIssue() call (E001/E002/E003/E004/E005, W002/W003/W008/W009/W011/W016/W018) and the persisted STATE.md regenerate / MILESTONES.md backfill notes. - `milestone.cjs` `cmdMilestoneComplete` — Operator Next Steps tail rewrite. - `validate-command-router.cjs` — `validate context` recommendation strings for WARNING/CRITICAL utilization bands. - `workstream.cjs` — missing .planning hint. - `profile-output.cjs` — `generate-claude-md` workflow enforcement block, project/skills fallbacks, profile placeholder, and the dev-preferences refresh hints. - `drift.cjs`, `gsd2-import.cjs`, `commands.cjs scaffold context` — remaining one-off persisted references. Runtime detection: `resolveRuntime(projectDir)` reads `process.env.GSD_RUNTIME` first, then a side-effect-free direct read of `.planning/config.json` (NOT `loadConfig`, which would normalize legacy keys and re-write the file just to read the runtime name). Tests: - `tests/bug-3584-runtime-slash-formatter.test.cjs` — 22 unit tests covering the pure formatter and resolver (hyphen vs codex, prefix normalization, defensive returns, env/config/default chain). - `tests/bug-3584-runtime-slash-emitters.test.cjs` — 6 integration tests exercising `init manager`, `phase add` (via the structured `roadmap get-phase` payload to avoid raw-text matching on the on-disk artifact), `validate health`, `validate context`, and the codex variant. - Existing tests updated to assert the new contract: validate-context recommendations, claude-md workflow block, milestone complete Operator Next Steps. Copilot-install engine-conversion test now asserts against a synthetic input since bin/lib/*.cjs no longer contains literal `/gsd:` references for the install-time converter to rewrite. INVENTORY.md and INVENTORY-MANIFEST.json updated for the new module (64 CLI modules shipped, +1). Fixes #3584 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
58 lines
2.4 KiB
JavaScript
58 lines
2.4 KiB
JavaScript
'use strict';
|
|
|
|
const { VALIDATE_SUBCOMMANDS } = require('./command-aliases.generated.cjs');
|
|
const { formatGsdSlash, resolveRuntime } = require('./runtime-slash.cjs');
|
|
|
|
function routeValidateCommand({ verify, args, cwd, raw, parseNamedArgs, output, error }) {
|
|
const subcommand = args[1];
|
|
|
|
if (subcommand === 'consistency') {
|
|
verify.cmdValidateConsistency(cwd, raw);
|
|
} else if (subcommand === 'health') {
|
|
const repairFlag = args.includes('--repair');
|
|
const backfillFlag = args.includes('--backfill');
|
|
verify.cmdValidateHealth(cwd, { repair: repairFlag, backfill: backfillFlag }, raw);
|
|
} else if (subcommand === 'agents') {
|
|
verify.cmdValidateAgents(cwd, raw);
|
|
} else if (subcommand === 'context') {
|
|
const opts = parseNamedArgs(args, ['tokens-used', 'context-window']);
|
|
if (opts['tokens-used'] === null) {
|
|
error('--tokens-used <integer> is required for `validate context`');
|
|
return;
|
|
}
|
|
if (opts['context-window'] === null) {
|
|
error('--context-window <integer> is required for `validate context`');
|
|
return;
|
|
}
|
|
const { classifyContextUtilization, STATES } = require('./context-utilization.cjs');
|
|
const threadCmd = formatGsdSlash('thread', resolveRuntime(cwd));
|
|
const RECOMMENDATIONS = {
|
|
[STATES.HEALTHY]: null,
|
|
[STATES.WARNING]: `Context is approaching the fracture zone — consider ${threadCmd} to continue in a fresh window.`,
|
|
[STATES.CRITICAL]: `Reasoning quality may degrade past 70% utilization (fracture point). Run ${threadCmd} now to preserve output quality.`,
|
|
};
|
|
let classified;
|
|
try {
|
|
classified = classifyContextUtilization(Number(opts['tokens-used']), Number(opts['context-window']));
|
|
} catch (e) {
|
|
const flag = /tokensUsed/.test(e.message) ? '--tokens-used' : '--context-window';
|
|
error(`${flag} must be a non-negative integer (window > 0), got the values supplied`);
|
|
return;
|
|
}
|
|
const result = { ...classified, recommendation: RECOMMENDATIONS[classified.state] };
|
|
if (args.includes('--json')) {
|
|
output(result, raw);
|
|
} else {
|
|
const lines = [`Context utilization: ${result.percent}% (${result.state})`];
|
|
if (result.recommendation) lines.push(result.recommendation);
|
|
output(result, true, lines.join('\n'));
|
|
}
|
|
} else {
|
|
error(`Unknown validate subcommand. Available: ${VALIDATE_SUBCOMMANDS.join(', ')}`);
|
|
}
|
|
}
|
|
|
|
module.exports = {
|
|
routeValidateCommand,
|
|
};
|