@opengsd/get-shit-done-redux 1.0.0

package/sdk/dist/query/config-query.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Config-get and resolve-model query handlers.
+ *
+ * Ported from get-shit-done/bin/lib/config.cjs and commands.cjs.
+ * Provides raw config.json traversal and model profile resolution.
+ *
+ * @example
+ * ```typescript
+ * import { configGet, resolveModel } from './config-query.js';
+ *
+ * const result = await configGet(['workflow.auto_advance'], '/project');
+ * // { data: true }
+ *
+ * const model = await resolveModel(['gsd-planner'], '/project');
+ * // { data: { model: 'opus', profile: 'balanced' } }
+ * ```
+ */
+import type { QueryHandler } from './utils.js';
+export { MODEL_PROFILES, VALID_PROFILES, getAgentToModelMapForProfile } from '../model-catalog.js';
+/**
+ * Query handler for config-get command.
+ *
+ * Reads raw .planning/config.json and traverses dot-notation key paths.
+ * Does NOT merge with defaults (matches gsd-tools.cjs behavior).
+ *
+ * @param args - args[0] is the dot-notation key path (e.g., 'workflow.auto_advance')
+ * @param projectDir - Project root directory
+ * @returns QueryResult with the config value at the given path
+ * @throws GSDError with Validation classification if key missing or not found
+ */
+export declare const configGet: QueryHandler;
+/**
+ * Query handler for config-path — resolved `.planning/config.json` path (workstream-aware via cwd).
+ *
+ * Port of `cmdConfigPath` from `config.cjs`. The JSON query API returns `{ path }`; the CJS CLI
+ * emits the path as plain text for shell substitution.
+ *
+ * @param _args - Unused
+ * @param projectDir - Project root directory
+ * @returns QueryResult with `{ path: string }` absolute or project-relative resolution via planningPaths
+ */
+export declare const configPath: QueryHandler;
+/**
+ * Query handler for resolve-model command.
+ *
+ * Resolves the model alias for a given agent type based on the current profile.
+ * Uses loadConfig (with defaults) and MODEL_PROFILES for lookup.
+ *
+ * @param args - args[0] is the agent type (e.g., 'gsd-planner')
+ * @param projectDir - Project root directory
+ * @param workstream - Optional workstream name; forwarded to loadConfig so per-workstream
+ *   model_profile settings are respected (mirrors configGet/configPath behavior)
+ * @returns QueryResult with { model, profile } or { model, profile, unknown_agent: true }
+ * @throws GSDError with Validation classification if agent type not provided
+ */
+export declare const resolveModel: QueryHandler;
+//# sourceMappingURL=config-query.d.ts.map

package/sdk/dist/query/config-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-query.d.ts","sourceRoot":"","sources":["../../src/query/config-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AAqCnG;;;;;;;;;;GAUG;AACH,eAAO,MAAM,SAAS,EAAE,YAiFvB,CAAC;AAIF;;;;;;;;;GASG;AACH,eAAO,MAAM,UAAU,EAAE,YAGxB,CAAC;AA0CF;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,YAAY,EAAE,YAuF1B,CAAC"}

package/sdk/dist/query/config-query.js

@@ -0,0 +1,277 @@
+/**
+ * Config-get and resolve-model query handlers.
+ *
+ * Ported from get-shit-done/bin/lib/config.cjs and commands.cjs.
+ * Provides raw config.json traversal and model profile resolution.
+ *
+ * @example
+ * ```typescript
+ * import { configGet, resolveModel } from './config-query.js';
+ *
+ * const result = await configGet(['workflow.auto_advance'], '/project');
+ * // { data: true }
+ *
+ * const model = await resolveModel(['gsd-planner'], '/project');
+ * // { data: { model: 'opus', profile: 'balanced' } }
+ * ```
+ */
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { GSDError, ErrorClassification } from '../errors.js';
+import { loadConfig } from '../config.js';
+import { planningPaths } from './helpers.js';
+import { maskIfSecret } from './secrets.js';
+export { MODEL_PROFILES, VALID_PROFILES, getAgentToModelMapForProfile } from '../model-catalog.js';
+import { AGENT_TO_PHASE_TYPE, MODEL_PROFILES, resolveRuntimeTierDefault, runtimesWithReasoningEffort, } from '../model-catalog.js';
+const RUNTIMES_WITH_REASONING_EFFORT = runtimesWithReasoningEffort();
+/**
+ * Schema-level defaults for well-known config keys.
+ *
+ * Mirrors the CJS table at get-shit-done/bin/lib/config.cjs:505-510 byte-for-
+ * byte.  When `config-get` lookups fall off the dot path and no `--default`
+ * was supplied, the handler consults this map before throwing
+ * `Key not found`.  Without parity here, the SDK path emits
+ * CONFIG_KEY_NOT_FOUND for keys the CJS path returns transparently — every
+ * skill that reads `context_window`, `git.create_tag`, or executor stall
+ * thresholds breaks under SDK dispatch.
+ *
+ * Bugs #2943, #3086, executor-stall-defaults tests — RED→GREEN via this
+ * map. Keep this in lockstep with config.cjs:SCHEMA_DEFAULTS. Drift is
+ * detected by the bug-2943 and #3086 behavioral suites: when the table
+ * grows, both sides must grow together or those tests fail.
+ */
+const SCHEMA_DEFAULTS = Object.freeze({
+    context_window: 200000,
+    'executor.stall_detect_interval_minutes': 5,
+    'executor.stall_threshold_minutes': 10,
+    'git.create_tag': true,
+});
+// ─── configGet ──────────────────────────────────────────────────────────────
+/**
+ * Query handler for config-get command.
+ *
+ * Reads raw .planning/config.json and traverses dot-notation key paths.
+ * Does NOT merge with defaults (matches gsd-tools.cjs behavior).
+ *
+ * @param args - args[0] is the dot-notation key path (e.g., 'workflow.auto_advance')
+ * @param projectDir - Project root directory
+ * @returns QueryResult with the config value at the given path
+ * @throws GSDError with Validation classification if key missing or not found
+ */
+export const configGet = async (args, projectDir, workstream) => {
+    // Support --default <value> flag (#2803): return this value (exit 0) when the
+    // key is absent, mirroring gsd-tools.cjs config-get behavior from #1893.
+    const defaultIdx = args.indexOf('--default');
+    let defaultValue;
+    let filteredArgs = args;
+    if (defaultIdx !== -1) {
+        if (defaultIdx + 1 >= args.length) {
+            throw new GSDError('Usage: config-get <key.path> [--default <value>]', ErrorClassification.Validation);
+        }
+        defaultValue = String(args[defaultIdx + 1]);
+        filteredArgs = [...args.slice(0, defaultIdx), ...args.slice(defaultIdx + 2)];
+    }
+    const keyPath = filteredArgs[0];
+    if (!keyPath) {
+        throw new GSDError('Usage: config-get <key.path> [--default <value>]', ErrorClassification.Validation);
+    }
+    const paths = planningPaths(projectDir, workstream);
+    let raw;
+    try {
+        raw = await readFile(paths.config, 'utf-8');
+    }
+    catch {
+        // config.json missing — CJS parity (config.cjs:524-533):
+        //   1. --default beats everything
+        //   2. else SCHEMA_DEFAULTS supply a documented value (#2943)
+        //   3. else CONFIG_NO_FILE error
+        if (defaultValue !== undefined)
+            return { data: defaultValue };
+        if (Object.prototype.hasOwnProperty.call(SCHEMA_DEFAULTS, keyPath)) {
+            return { data: SCHEMA_DEFAULTS[keyPath] };
+        }
+        const err = new GSDError(`No config.json found at ${paths.config}`, ErrorClassification.Validation);
+        err.reason = 'config_no_file';
+        throw err;
+    }
+    let config;
+    try {
+        config = JSON.parse(raw);
+    }
+    catch {
+        // Lead the message with "Failed to read config.json" — matches the CJS
+        // `cmdConfigGet` / `setConfigValue` error vocabulary so tests written
+        // against the legacy contract keep matching.
+        const err = new GSDError(`Failed to read config.json: malformed JSON at ${paths.config}`, ErrorClassification.Validation);
+        err.reason = 'config_parse_failed';
+        throw err;
+    }
+    const keys = keyPath.split('.');
+    let current = config;
+    for (const key of keys) {
+        if (current === undefined || current === null || typeof current !== 'object') {
+            // UNIX convention (cf. `git config --get`): missing key exits 1, not 10.
+            // See issue #2544 — callers use `if ! gsd-sdk query config-get k; then` patterns.
+            // CJS parity ordering (config.cjs:543-551): --default first, then
+            // SCHEMA_DEFAULTS, then CONFIG_KEY_NOT_FOUND.
+            if (defaultValue !== undefined)
+                return { data: defaultValue };
+            if (Object.prototype.hasOwnProperty.call(SCHEMA_DEFAULTS, keyPath)) {
+                return { data: SCHEMA_DEFAULTS[keyPath] };
+            }
+            const err = new GSDError(`Key not found: ${keyPath}`, ErrorClassification.Execution);
+            err.reason = 'config_key_not_found';
+            throw err;
+        }
+        current = current[key];
+    }
+    if (current === undefined) {
+        if (defaultValue !== undefined)
+            return { data: defaultValue };
+        if (Object.prototype.hasOwnProperty.call(SCHEMA_DEFAULTS, keyPath)) {
+            return { data: SCHEMA_DEFAULTS[keyPath] };
+        }
+        const err = new GSDError(`Key not found: ${keyPath}`, ErrorClassification.Execution);
+        err.reason = 'config_key_not_found';
+        throw err;
+    }
+    // Mask plaintext for keys in SECRET_CONFIG_KEYS to match CJS behavior at
+    // config.cjs:440-441 — without this, `gsd-sdk query config-get brave_search`
+    // would echo the plaintext credential into machine-readable output. (#2997)
+    return { data: maskIfSecret(keyPath, current) };
+};
+// ─── configPath ─────────────────────────────────────────────────────────────
+/**
+ * Query handler for config-path — resolved `.planning/config.json` path (workstream-aware via cwd).
+ *
+ * Port of `cmdConfigPath` from `config.cjs`. The JSON query API returns `{ path }`; the CJS CLI
+ * emits the path as plain text for shell substitution.
+ *
+ * @param _args - Unused
+ * @param projectDir - Project root directory
+ * @returns QueryResult with `{ path: string }` absolute or project-relative resolution via planningPaths
+ */
+export const configPath = async (_args, projectDir, workstream) => {
+    const paths = planningPaths(projectDir, workstream);
+    return { data: { path: paths.config } };
+};
+function isRuntimeTierName(value) {
+    return value === 'opus' || value === 'sonnet' || value === 'haiku';
+}
+function normalizeRuntimeTierEntry(entry) {
+    if (typeof entry === 'string')
+        return { model: entry };
+    if (entry && typeof entry === 'object' && !Array.isArray(entry)) {
+        return entry;
+    }
+    return null;
+}
+function resolveRuntimeTier(config, tier) {
+    if (!isRuntimeTierName(tier))
+        return null;
+    const runtime = typeof config.runtime === 'string' ? config.runtime : '';
+    if (!runtime || runtime === 'claude')
+        return null;
+    const builtin = resolveRuntimeTierDefault(runtime, tier);
+    const profileOverrides = config.model_profile_overrides;
+    const runtimeOverrides = profileOverrides?.[runtime];
+    const userEntry = normalizeRuntimeTierEntry(runtimeOverrides?.[tier]);
+    if (!builtin && !userEntry)
+        return null;
+    const merged = { ...(builtin ?? {}), ...(userEntry ?? {}) };
+    if (!RUNTIMES_WITH_REASONING_EFFORT.has(runtime)) {
+        delete merged.reasoning_effort;
+    }
+    return merged;
+}
+/**
+ * Query handler for resolve-model command.
+ *
+ * Resolves the model alias for a given agent type based on the current profile.
+ * Uses loadConfig (with defaults) and MODEL_PROFILES for lookup.
+ *
+ * @param args - args[0] is the agent type (e.g., 'gsd-planner')
+ * @param projectDir - Project root directory
+ * @param workstream - Optional workstream name; forwarded to loadConfig so per-workstream
+ *   model_profile settings are respected (mirrors configGet/configPath behavior)
+ * @returns QueryResult with { model, profile } or { model, profile, unknown_agent: true }
+ * @throws GSDError with Validation classification if agent type not provided
+ */
+export const resolveModel = async (args, projectDir, workstream) => {
+    const agentType = args[0];
+    if (!agentType) {
+        throw new GSDError('agent-type required', ErrorClassification.Validation);
+    }
+    const configFilePath = planningPaths(projectDir, workstream).config;
+    const configExists = existsSync(configFilePath);
+    const config = await loadConfig(projectDir, workstream);
+    const profile = String(config.model_profile || 'balanced').toLowerCase();
+    // Check per-agent override first
+    const overrides = config.model_overrides;
+    const override = overrides?.[agentType];
+    if (override) {
+        const agentModels = MODEL_PROFILES[agentType];
+        const result = agentModels
+            ? { model: override, profile }
+            : { model: override, profile, unknown_agent: true };
+        return { data: result };
+    }
+    const agentModels = MODEL_PROFILES[agentType];
+    // No project config -> return empty model id (CJS parity)
+    const resolveModelIds = config.resolve_model_ids;
+    if (!configExists) {
+        const result = agentModels
+            ? { model: '', profile }
+            : { model: '', profile, unknown_agent: true };
+        return { data: result };
+    }
+    // Fall back to profile lookup
+    if (!agentModels) {
+        const semanticFallback = profile === 'quality' ? 'opus'
+            : profile === 'budget' ? 'haiku'
+                : profile === 'inherit' ? 'inherit'
+                    : 'sonnet';
+        return { data: { model: semanticFallback, profile, unknown_agent: true } };
+    }
+    if (profile === 'inherit') {
+        return { data: { model: 'inherit', profile } };
+    }
+    const alias = agentModels[profile] || agentModels['balanced'] || 'sonnet';
+    const phaseType = AGENT_TO_PHASE_TYPE[agentType];
+    const phaseTier = phaseType && typeof config.models === 'object'
+        ? config.models[phaseType]
+        : undefined;
+    const tier = typeof phaseTier === 'string' ? phaseTier : alias;
+    const runtimeTier = resolveRuntimeTier(config, tier);
+    if (runtimeTier?.model) {
+        const result = { model: runtimeTier.model, profile };
+        if (runtimeTier.reasoning_effort) {
+            result.reasoning_effort = runtimeTier.reasoning_effort;
+        }
+        return { data: result };
+    }
+    if (resolveModelIds === 'omit') {
+        return { data: { model: '', profile } };
+    }
+    // #3643: runtime:claude bails out of resolveRuntimeTier (line 149) because
+    // Claude is the implicit/default runtime, but consumers that asked for
+    // resolved model IDs still need the full ID (e.g. "claude-sonnet-4-6"), not
+    // the tier alias. Mirror the CJS branch at get-shit-done/bin/lib/core.cjs
+    // (`if (config.resolve_model_ids) return MODEL_ALIAS_MAP[alias] || alias;`)
+    // by consulting the catalog's claude runtime defaults for the resolved tier.
+    const runtime = typeof config.runtime === 'string'
+        ? config.runtime
+        : '';
+    // Empty/missing runtime is implicit Claude (per the resolveRuntimeTier bail-out
+    // at line ~149); without this branch the resolved-IDs path silently fell
+    // through to the alias return for projects that never set `runtime` explicitly.
+    const isClaudeRuntime = runtime === '' || runtime === 'claude';
+    if (resolveModelIds === true && isClaudeRuntime && isRuntimeTierName(tier)) {
+        const claudeDefault = resolveRuntimeTierDefault('claude', tier);
+        if (claudeDefault?.model) {
+            return { data: { model: claudeDefault.model, profile } };
+        }
+    }
+    return { data: { model: alias, profile } };
+};
+//# sourceMappingURL=config-query.js.map

package/sdk/dist/query/config-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-query.js","sourceRoot":"","sources":["../../src/query/config-query.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,4BAA4B,EAAE,MAAM,qBAAqB,CAAC;AACnG,OAAO,EACL,mBAAmB,EACnB,cAAc,EAGd,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,qBAAqB,CAAC;AAE7B,MAAM,8BAA8B,GAAG,2BAA2B,EAAE,CAAC;AAErE;;;;;;;;;;;;;;;GAeG;AACH,MAAM,eAAe,GAAwD,MAAM,CAAC,MAAM,CAAC;IACzF,cAAc,EAAE,MAAM;IACtB,wCAAwC,EAAE,CAAC;IAC3C,kCAAkC,EAAE,EAAE;IACtC,gBAAgB,EAAE,IAAI;CACvB,CAAC,CAAC;AAEH,+EAA+E;AAE/E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,SAAS,GAAiB,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE;IAC5E,8EAA8E;IAC9E,yEAAyE;IACzE,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IAC7C,IAAI,YAAgC,CAAC;IACrC,IAAI,YAAY,GAAG,IAAI,CAAC;IACxB,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;QACtB,IAAI,UAAU,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAClC,MAAM,IAAI,QAAQ,CAAC,kDAAkD,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;QACzG,CAAC;QACD,YAAY,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC;QAC5C,YAAY,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC;IAC/E,CAAC;IAED,MAAM,OAAO,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,QAAQ,CAAC,kDAAkD,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;IACzG,CAAC;IAED,MAAM,KAAK,GAAG,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACpD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,KAAK,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IAAC,MAAM,CAAC;QACP,yDAAyD;QACzD,kCAAkC;QAClC,8DAA8D;QAC9D,iCAAiC;QACjC,IAAI,YAAY,KAAK,SAAS;YAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;QAC9D,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE,CAAC;YACnE,OAAO,EAAE,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5C,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,2BAA2B,KAAK,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;QACnG,GAAsC,CAAC,MAAM,GAAG,gBAAgB,CAAC;QAClE,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,IAAI,MAA+B,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA4B,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,uEAAuE;QACvE,sEAAsE;QACtE,6CAA6C;QAC7C,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,iDAAiD,KAAK,CAAC,MAAM,EAAE,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;QACzH,GAAsC,CAAC,MAAM,GAAG,qBAAqB,CAAC;QACvE,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,OAAO,GAAY,MAAM,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,OAAO,KAAK,SAAS,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;YAC7E,yEAAyE;YACzE,kFAAkF;YAClF,kEAAkE;YAClE,8CAA8C;YAC9C,IAAI,YAAY,KAAK,SAAS;gBAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;YAC9D,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE,CAAC;gBACnE,OAAO,EAAE,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5C,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,kBAAkB,OAAO,EAAE,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;YACpF,GAAsC,CAAC,MAAM,GAAG,sBAAsB,CAAC;YACxE,MAAM,GAAG,CAAC;QACZ,CAAC;QACD,OAAO,GAAI,OAAmC,CAAC,GAAG,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,IAAI,YAAY,KAAK,SAAS;YAAE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC;QAC9D,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE,CAAC;YACnE,OAAO,EAAE,IAAI,EAAE,eAAe,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5C,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,QAAQ,CAAC,kBAAkB,OAAO,EAAE,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;QACpF,GAAsC,CAAC,MAAM,GAAG,sBAAsB,CAAC;QACxE,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,yEAAyE;IACzE,6EAA6E;IAC7E,4EAA4E;IAC5E,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC;AAClD,CAAC,CAAC;AAEF,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,UAAU,GAAiB,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE;IAC9E,MAAM,KAAK,GAAG,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACpD,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC;AAC1C,CAAC,CAAC;AAWF,SAAS,iBAAiB,CAAC,KAAa;IACtC,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,OAAO,CAAC;AACrE,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAc;IAC/C,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACvD,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,KAAyB,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,kBAAkB,CAAC,MAA+B,EAAE,IAAY;IACvE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1C,MAAM,OAAO,GAAG,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IACzE,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAElD,MAAM,OAAO,GAAG,yBAAyB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACzD,MAAM,gBAAgB,GAAG,MAAM,CAAC,uBAA8D,CAAC;IAC/F,MAAM,gBAAgB,GAAG,gBAAgB,EAAE,CAAC,OAAO,CAAwC,CAAC;IAC5F,MAAM,SAAS,GAAG,yBAAyB,CAAC,gBAAgB,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;IAEtE,IAAI,CAAC,OAAO,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,EAAE,CAAC;IAC5D,IAAI,CAAC,8BAA8B,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,OAAO,MAAM,CAAC,gBAAgB,CAAC;IACjC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,YAAY,GAAiB,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,UAAU,EAAE,EAAE;IAC/E,MAAM,SAAS,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1B,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,QAAQ,CAAC,qBAAqB,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC5E,CAAC;IAED,MAAM,cAAc,GAAG,aAAa,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC,MAAM,CAAC;IACpE,MAAM,YAAY,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC;IAChD,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,IAAI,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;IAEzE,iCAAiC;IACjC,MAAM,SAAS,GAAI,MAAkC,CAAC,eAAqD,CAAC;IAC5G,MAAM,QAAQ,GAAG,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC;IACxC,IAAI,QAAQ,EAAE,CAAC;QACb,MAAM,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,WAAW;YACxB,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE;YAC9B,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;QACtD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAE9C,0DAA0D;IAC1D,MAAM,eAAe,GAAI,MAAkC,CAAC,iBAAiB,CAAC;IAC9E,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,MAAM,MAAM,GAAG,WAAW;YACxB,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE;YACxB,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;QAChD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,8BAA8B;IAC9B,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,MAAM,gBAAgB,GACpB,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM;YAC9B,CAAC,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO;gBAChC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS;oBACnC,CAAC,CAAC,QAAQ,CAAC;QACb,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,CAAC;IAC7E,CAAC;IAED,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,CAAC;IACjD,CAAC;IAED,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,WAAW,CAAC,UAAU,CAAC,IAAI,QAAQ,CAAC;IAC1E,MAAM,SAAS,GAAG,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,SAAS,IAAI,OAAQ,MAAkC,CAAC,MAAM,KAAK,QAAQ;QAC3F,CAAC,CAAG,MAAkC,CAAC,MAAkC,CAAC,SAAS,CAAC;QACpF,CAAC,CAAC,SAAS,CAAC;IACd,MAAM,IAAI,GAAG,OAAO,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC;IAC/D,MAAM,WAAW,GAAG,kBAAkB,CAAC,MAAiC,EAAE,IAAI,CAAC,CAAC;IAChF,IAAI,WAAW,EAAE,KAAK,EAAE,CAAC;QACvB,MAAM,MAAM,GAA4B,EAAE,KAAK,EAAE,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,CAAC;QAC9E,IAAI,WAAW,CAAC,gBAAgB,EAAE,CAAC;YACjC,MAAM,CAAC,gBAAgB,GAAG,WAAW,CAAC,gBAAgB,CAAC;QACzD,CAAC;QACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI,eAAe,KAAK,MAAM,EAAE,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC;IAC1C,CAAC;IAED,2EAA2E;IAC3E,uEAAuE;IACvE,4EAA4E;IAC5E,0EAA0E;IAC1E,4EAA4E;IAC5E,6EAA6E;IAC7E,MAAM,OAAO,GAAG,OAAQ,MAAkC,CAAC,OAAO,KAAK,QAAQ;QAC7E,CAAC,CAAG,MAAkC,CAAC,OAAkB;QACzD,CAAC,CAAC,EAAE,CAAC;IACP,gFAAgF;IAChF,yEAAyE;IACzE,gFAAgF;IAChF,MAAM,eAAe,GAAG,OAAO,KAAK,EAAE,IAAI,OAAO,KAAK,QAAQ,CAAC;IAC/D,IAAI,eAAe,KAAK,IAAI,IAAI,eAAe,IAAI,iBAAiB,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3E,MAAM,aAAa,GAAG,yBAAyB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAChE,IAAI,aAAa,EAAE,KAAK,EAAE,CAAC;YACzB,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;QAC3D,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,CAAC;AAC7C,CAAC,CAAC"}

package/sdk/dist/query/config-schema.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Thin re-export adapter — sources schema data from the Configuration Module
+ * (sdk/src/configuration/index.ts), which reads from the manifest at
+ * sdk/shared/config-schema.manifest.json.
+ *
+ * All inline literals have been removed. The manifest is the single source
+ * of truth for both the SDK and CJS sides (Phase 2 Cycle 5, #3536).
+ *
+ * Consumers of this module see an identical public API to the previous version:
+ *   VALID_CONFIG_KEYS    — ReadonlySet<string>
+ *   RUNTIME_STATE_KEYS   — ReadonlySet<string>
+ *   DYNAMIC_KEY_PATTERNS — readonly DynamicKeyPattern[]
+ *   DynamicKeyPattern    — interface (re-exported type)
+ *   isValidConfigKeyPath — (keyPath: string) => boolean
+ */
+export { VALID_CONFIG_KEYS, RUNTIME_STATE_KEYS, DYNAMIC_KEY_PATTERNS, type DynamicKeyPattern, } from '../configuration/index.js';
+/** Returns true if keyPath is a valid config key (exact, runtime-state, or dynamic pattern). */
+export declare function isValidConfigKeyPath(keyPath: string): boolean;
+//# sourceMappingURL=config-schema.d.ts.map

package/sdk/dist/query/config-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.d.ts","sourceRoot":"","sources":["../../src/query/config-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAQH,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,KAAK,iBAAiB,GACvB,MAAM,2BAA2B,CAAC;AAEnC,gGAAgG;AAChG,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAI7D"}

package/sdk/dist/query/config-schema.js

@@ -0,0 +1,26 @@
+/**
+ * Thin re-export adapter — sources schema data from the Configuration Module
+ * (sdk/src/configuration/index.ts), which reads from the manifest at
+ * sdk/shared/config-schema.manifest.json.
+ *
+ * All inline literals have been removed. The manifest is the single source
+ * of truth for both the SDK and CJS sides (Phase 2 Cycle 5, #3536).
+ *
+ * Consumers of this module see an identical public API to the previous version:
+ *   VALID_CONFIG_KEYS    — ReadonlySet<string>
+ *   RUNTIME_STATE_KEYS   — ReadonlySet<string>
+ *   DYNAMIC_KEY_PATTERNS — readonly DynamicKeyPattern[]
+ *   DynamicKeyPattern    — interface (re-exported type)
+ *   isValidConfigKeyPath — (keyPath: string) => boolean
+ */
+import { VALID_CONFIG_KEYS, RUNTIME_STATE_KEYS, DYNAMIC_KEY_PATTERNS, } from '../configuration/index.js';
+export { VALID_CONFIG_KEYS, RUNTIME_STATE_KEYS, DYNAMIC_KEY_PATTERNS, } from '../configuration/index.js';
+/** Returns true if keyPath is a valid config key (exact, runtime-state, or dynamic pattern). */
+export function isValidConfigKeyPath(keyPath) {
+    if (VALID_CONFIG_KEYS.has(keyPath))
+        return true;
+    if (RUNTIME_STATE_KEYS.has(keyPath))
+        return true;
+    return DYNAMIC_KEY_PATTERNS.some((p) => p.test(keyPath));
+}
+//# sourceMappingURL=config-schema.js.map

package/sdk/dist/query/config-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-schema.js","sourceRoot":"","sources":["../../src/query/config-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GAErB,MAAM,2BAA2B,CAAC;AAEnC,gGAAgG;AAChG,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,IAAI,iBAAiB,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,IAAI,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACjD,OAAO,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/sdk/dist/query/decisions.d.ts

@@ -0,0 +1,58 @@
+/**
+ * CONTEXT.md `<decisions>` parser — shared helper for issue #2492 (decision
+ * coverage gates) and #2493 (post-planning gap checker).
+ *
+ * Decision format (produced by `discuss-phase.md`):
+ *
+ *   <decisions>
+ *   ## Implementation Decisions
+ *
+ *   ### Category Heading
+ *   - **D-01:** Decision text
+ *   - **D-02 [tag1, tag2]:** Tagged decision
+ *
+ *   ### Claude's Discretion
+ *   - free-form, never tracked
+ *   </decisions>
+ *
+ * A decision is "trackable" when:
+ *   - it has a valid D-NN id
+ *   - it is NOT under the "Claude's Discretion" category
+ *   - it is NOT tagged `informational` or `folded`
+ *
+ * Trackable decisions are the ones the plan-phase translation gate and the
+ * verify-phase validation gate enforce.
+ */
+import type { QueryHandler } from './utils.js';
+export interface ParsedDecision {
+    /** Stable id: `D-01`, `D-42`, `D-INFRA-01`, `D-FOO_BAR`. Numeric or alphanumeric. */
+    id: string;
+    /** Body text (everything after `**D-NN[ tags]:**` up to next bullet/blank). */
+    text: string;
+    /** Most recent `### ` heading inside the decisions block. */
+    category: string;
+    /** Bracketed tags from `**D-NN [tag1, tag2]:**`. Lower-cased. */
+    tags: string[];
+    /**
+     * False when under "Claude's Discretion" or tagged `informational` /
+     * `folded`. Trackable decisions are subject to the coverage gates.
+     */
+    trackable: boolean;
+}
+/**
+ * Parse trackable decisions from CONTEXT.md content.
+ *
+ * Returns ALL D-NN decisions found inside `<decisions>` (including
+ * non-trackable ones, with `trackable: false`). Callers that only want the
+ * gate-enforced decisions should filter `.filter(d => d.trackable)`.
+ */
+export declare function parseDecisions(content: string): ParsedDecision[];
+/**
+ * `decisions.parse <path>` — parse CONTEXT.md and return decisions array.
+ *
+ * Used by workflow shell snippets that need to enumerate decisions without
+ * spawning a full Node process. Accepts either an absolute path or a path
+ * relative to `projectDir` — symmetric with the gate handlers (review F14).
+ */
+export declare const decisionsParse: QueryHandler;
+//# sourceMappingURL=decisions.d.ts.map

package/sdk/dist/query/decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../../src/query/decisions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,WAAW,cAAc;IAC7B,qFAAqF;IACrF,EAAE,EAAE,MAAM,CAAC;IACX,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,iEAAiE;IACjE,IAAI,EAAE,MAAM,EAAE,CAAC;IACf;;;OAGG;IACH,SAAS,EAAE,OAAO,CAAC;CACpB;AAiCD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,cAAc,EAAE,CA8EhE;AAID;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,YAsB5B,CAAC"}

package/sdk/dist/query/decisions.js

@@ -0,0 +1,165 @@
+/**
+ * CONTEXT.md `<decisions>` parser — shared helper for issue #2492 (decision
+ * coverage gates) and #2493 (post-planning gap checker).
+ *
+ * Decision format (produced by `discuss-phase.md`):
+ *
+ *   <decisions>
+ *   ## Implementation Decisions
+ *
+ *   ### Category Heading
+ *   - **D-01:** Decision text
+ *   - **D-02 [tag1, tag2]:** Tagged decision
+ *
+ *   ### Claude's Discretion
+ *   - free-form, never tracked
+ *   </decisions>
+ *
+ * A decision is "trackable" when:
+ *   - it has a valid D-NN id
+ *   - it is NOT under the "Claude's Discretion" category
+ *   - it is NOT tagged `informational` or `folded`
+ *
+ * Trackable decisions are the ones the plan-phase translation gate and the
+ * verify-phase validation gate enforce.
+ */
+import { readFile } from 'node:fs/promises';
+import { isAbsolute, join } from 'node:path';
+const DISCRETION_HEADINGS = new Set([
+    "claude's discretion",
+    'claudes discretion',
+    'claude discretion',
+]);
+const NON_TRACKABLE_TAGS = new Set(['informational', 'folded', 'deferred']);
+/**
+ * Strip fenced code blocks from `content` so example `<decisions>` snippets
+ * inside ```` ``` ```` do not pollute the parser (review F11).
+ */
+function stripFencedCode(content) {
+    return content.replace(/```[\s\S]*?```/g, ' ').replace(/~~~[\s\S]*?~~~/g, ' ');
+}
+/**
+ * Extract the inner text of EVERY `<decisions>...</decisions>` block in
+ * order, concatenated by `\n\n`. Returns null when no block is present.
+ *
+ * CONTEXT.md may legitimately contain more than one block (for example, a
+ * "current decisions" block plus a "carry-over from prior phase" block);
+ * dropping all-but-the-first silently lost the second batch (review F13).
+ */
+function extractDecisionsBlock(content) {
+    const cleaned = stripFencedCode(content);
+    const matches = [...cleaned.matchAll(/<decisions>([\s\S]*?)<\/decisions>/g)];
+    if (matches.length === 0)
+        return null;
+    return matches.map((m) => m[1]).join('\n\n');
+}
+/**
+ * Parse trackable decisions from CONTEXT.md content.
+ *
+ * Returns ALL D-NN decisions found inside `<decisions>` (including
+ * non-trackable ones, with `trackable: false`). Callers that only want the
+ * gate-enforced decisions should filter `.filter(d => d.trackable)`.
+ */
+export function parseDecisions(content) {
+    if (!content || typeof content !== 'string')
+        return [];
+    const block = extractDecisionsBlock(content);
+    if (block === null)
+        return [];
+    const lines = block.split(/\r?\n/);
+    const out = [];
+    let category = '';
+    let inDiscretion = false;
+    // Bullet line: `- **D-NN[ [tags]]:** text`
+    // Phase 6 (#3575): aligned to CJS regex — accepts alphanumeric IDs (D-01, D-INFRA-01, D-FOO_BAR)
+    // in addition to numeric-only IDs (D-42). The first character after `D-` must
+    // be alphanumeric, so malformed shapes like `D--foo` or `D-_bar` are rejected.
+    // CJS callers consume {id, text} and ignore the optional extras.
+    const bulletRe = /^\s*-\s+\*\*D-([A-Za-z0-9][A-Za-z0-9_-]*)(?:\s*\[([^\]]+)\])?\s*:\*\*\s*(.*)$/;
+    let current = null;
+    const flush = () => {
+        if (current) {
+            current.text = current.text.trim();
+            out.push(current);
+            current = null;
+        }
+    };
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Track category headings (`### Heading`)
+        const headingMatch = trimmed.match(/^###\s+(.+?)\s*$/);
+        if (headingMatch) {
+            flush();
+            category = headingMatch[1];
+            // Strip the full unicode-quote family so any rendering of "Claude's
+            // Discretion" (ASCII apostrophe, curly U+2019, U+2018, U+201A, U+201B,
+            // double-quote variants U+201C/D/E/F, etc.) collapses to the same key
+            // (review F20).
+            const normalized = category
+                .toLowerCase()
+                .replace(/[\u2018\u2019\u201A\u201B\u201C\u201D\u201E\u201F'"`]/g, '')
+                .trim();
+            inDiscretion = DISCRETION_HEADINGS.has(normalized);
+            continue;
+        }
+        const bulletMatch = line.match(bulletRe);
+        if (bulletMatch) {
+            flush();
+            const id = `D-${bulletMatch[1]}`;
+            const tags = bulletMatch[2]
+                ? bulletMatch[2]
+                    .split(',')
+                    .map((t) => t.trim().toLowerCase())
+                    .filter(Boolean)
+                : [];
+            const trackable = !inDiscretion && !tags.some((t) => NON_TRACKABLE_TAGS.has(t));
+            current = { id, text: bulletMatch[3], category, tags, trackable };
+            continue;
+        }
+        // Continuation line for current decision (indented with space OR tab,
+        // non-bullet, non-empty) — tab indentation must work too (review F12).
+        if (current && trimmed !== '' && !trimmed.startsWith('-') && /^[ \t]/.test(line)) {
+            current.text += ' ' + trimmed;
+            continue;
+        }
+        // Blank line or unrelated content terminates the current decision
+        if (trimmed === '') {
+            flush();
+        }
+    }
+    flush();
+    return out;
+}
+// ─── Query handler ────────────────────────────────────────────────────────
+/**
+ * `decisions.parse <path>` — parse CONTEXT.md and return decisions array.
+ *
+ * Used by workflow shell snippets that need to enumerate decisions without
+ * spawning a full Node process. Accepts either an absolute path or a path
+ * relative to `projectDir` — symmetric with the gate handlers (review F14).
+ */
+export const decisionsParse = async (args, projectDir) => {
+    const filePath = args[0];
+    if (!filePath) {
+        return { data: { decisions: [], trackable: 0, total: 0, missing: true } };
+    }
+    const resolved = isAbsolute(filePath) ? filePath : join(projectDir, filePath);
+    let raw = '';
+    try {
+        raw = await readFile(resolved, 'utf-8');
+    }
+    catch {
+        return { data: { decisions: [], trackable: 0, total: 0, missing: true } };
+    }
+    const decisions = parseDecisions(raw);
+    const trackable = decisions.filter((d) => d.trackable);
+    return {
+        data: {
+            decisions,
+            trackable: trackable.length,
+            total: decisions.length,
+            missing: false,
+        },
+    };
+};
+//# sourceMappingURL=decisions.js.map

package/sdk/dist/query/decisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.js","sourceRoot":"","sources":["../../src/query/decisions.ts"],"names":[],"mappings":"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"}

package/sdk/dist/query/detect-custom-files.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Detect user-added files under GSD-managed install dirs not listed in the manifest.
+ *
+ * Port of `detect-custom-files` from `get-shit-done/bin/gsd-tools.cjs` (lines 1161–1239).
+ */
+import type { QueryHandler } from './utils.js';
+/**
+ * Args: `--config-dir <path>` (required) — runtime config directory to scan.
+ */
+export declare const detectCustomFiles: QueryHandler;
+//# sourceMappingURL=detect-custom-files.d.ts.map