Spaces:
Runtime error
Runtime error
File size: 5,508 Bytes
a6b96c2 | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 | 'use strict';
/**
* Intel command router — CLI subcommand dispatcher for `gsd-tools intel`.
*
* ADR-959 (phase 4d-impl-4): intel command family cutover — last first-party
* command cutover in the initial capability rollout.
* Extracted from the hardcoded `case 'intel':` arm in gsd-tools.cjs.
* Behaviour is preserved byte-for-behaviour from the prior inline case;
* the dispatch path now flows: default → dispatchCapabilityCommand →
* require(intel-command-router.cjs) → routeIntelCommand.
*
* Router signature: { args, cwd, raw, error } — identical to the existing
* host routers. No new handler/arg convention; the capability registry
* discovers this router by name.
*
* Arg indexing (preserved exactly from the original case):
* args[0] = 'intel' (family — matched by dispatchCapabilityCommand)
* args[1] = subcommand (query | status | diff | snapshot | patch-meta |
* validate | extract-exports | update | api-surface)
* args[2] = term (query) | filePath (patch-meta | extract-exports)
*
* Notable: the `status` subcommand applies a `timeAgo` transform on
* `status.files[*].updated_at` in non-raw mode — preserved exactly.
*
* Test seams: pass `_intel` to inject a mock intel module; pass `_core` to
* inject a mock core module (captures `output` calls and provides a
* deterministic `timeAgo` without writing to real stdout). The `_`-prefix
* follows the repo's established seam convention (see audit-command-router.cts
* for the `_core` seam pattern). Production callers omit both.
*
* Note on `error(); return` pairs: in production `error()` calls
* `process.exit(1)` so the `return` is an equivalent no-op halt. The pairs
* are kept for lint/control-flow clarity; they do NOT change behaviour.
*
* Lazy require: intel.cjs is required INSIDE the route function so it is
* only loaded when an intel command is actually dispatched (preserves
* equivalence with the old inline case arm which required it at the top of
* the case block).
*/
// eslint-disable-next-line @typescript-eslint/no-require-imports
const io = require("./io.cjs");
// eslint-disable-next-line @typescript-eslint/no-require-imports
const coreUtils = require("./core-utils.cjs");
// eslint-disable-next-line @typescript-eslint/no-require-imports
const path = require("path");
const { ERROR_REASON } = io;
// Default CoreModule implementation assembled from leaf modules.
// _core seam overrides this entirely for test injection.
const _defaultCore = { output: io.output, timeAgo: coreUtils.timeAgo };
// ─── Implementation ───────────────────────────────────────────────────────────
function routeIntelCommand({ args, cwd, raw, error, _intel, _core }) {
// eslint-disable-next-line @typescript-eslint/no-require-imports, @typescript-eslint/no-unsafe-assignment
const intel = _intel ?? require('./intel.cjs');
const c = _core ?? _defaultCore;
const subcommand = args[1];
if (subcommand === 'query') {
const term = args[2];
if (!term) {
error('Usage: gsd-tools intel query <term>', ERROR_REASON.USAGE);
return;
}
const planningDir = path.join(cwd, '.planning');
c.output(intel.intelQuery(term, planningDir), raw);
}
else if (subcommand === 'status') {
const planningDir = path.join(cwd, '.planning');
const status = intel.intelStatus(planningDir);
if (!raw && status.files) {
for (const file of Object.values(status.files)) {
if (file.updated_at) {
file.updated_at = c.timeAgo(new Date(file.updated_at));
}
}
}
c.output(status, raw);
}
else if (subcommand === 'diff') {
const planningDir = path.join(cwd, '.planning');
c.output(intel.intelDiff(planningDir), raw);
}
else if (subcommand === 'snapshot') {
const planningDir = path.join(cwd, '.planning');
c.output(intel.intelSnapshot(planningDir), raw);
}
else if (subcommand === 'patch-meta') {
const filePath = args[2];
if (!filePath) {
error('Usage: gsd-tools intel patch-meta <file-path>', ERROR_REASON.USAGE);
return;
}
c.output(intel.intelPatchMeta(path.resolve(cwd, filePath)), raw);
}
else if (subcommand === 'validate') {
const planningDir = path.join(cwd, '.planning');
c.output(intel.intelValidate(planningDir), raw);
}
else if (subcommand === 'extract-exports') {
const filePath = args[2];
if (!filePath) {
error('Usage: gsd-tools intel extract-exports <file-path>', ERROR_REASON.USAGE);
return;
}
c.output(intel.intelExtractExports(path.resolve(cwd, filePath)), raw);
}
else if (subcommand === 'update') {
const planningDir = path.join(cwd, '.planning');
c.output(intel.intelUpdate(planningDir), raw);
}
else if (subcommand === 'api-surface') {
const planningDir = path.join(cwd, '.planning');
c.output(intel.intelApiSurface(planningDir), raw);
}
else {
error('Unknown intel subcommand. Available: query, status, update, diff, snapshot, patch-meta, validate, extract-exports, api-surface', ERROR_REASON.SDK_UNKNOWN_COMMAND);
}
}
module.exports = {
routeIntelCommand,
};
|