@bhargavvc/sdd-cc 1.30.1 → 1.42.3

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

@@ -0,0 +1,208 @@
+/**
+ * Config-get and resolve-model query handlers.
+ *
+ * Ported from sdd/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(['sdd-planner'], '/project');
+ * // { data: { model: 'opus', profile: 'balanced' } }
+ * ```
+ */
+import { existsSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import { SDDError, 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();
+// ─── configGet ──────────────────────────────────────────────────────────────
+/**
+ * Query handler for config-get command.
+ *
+ * Reads raw .planning/config.json and traverses dot-notation key paths.
+ * Does NOT merge with defaults (matches sdd-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 SDDError 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 sdd-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 SDDError('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 SDDError('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 {
+        throw new SDDError(`No config.json found at ${paths.config}`, ErrorClassification.Validation);
+    }
+    let config;
+    try {
+        config = JSON.parse(raw);
+    }
+    catch {
+        throw new SDDError(`Malformed config.json at ${paths.config}`, ErrorClassification.Validation);
+    }
+    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 ! sdd-sdk query config-get k; then` patterns.
+            if (defaultValue !== undefined)
+                return { data: defaultValue };
+            throw new SDDError(`Key not found: ${keyPath}`, ErrorClassification.Execution);
+        }
+        current = current[key];
+    }
+    if (current === undefined) {
+        if (defaultValue !== undefined)
+            return { data: defaultValue };
+        throw new SDDError(`Key not found: ${keyPath}`, ErrorClassification.Execution);
+    }
+    // Mask plaintext for keys in SECRET_CONFIG_KEYS to match CJS behavior at
+    // config.cjs:440-441 — without this, `sdd-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., 'sdd-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 SDDError with Validation classification if agent type not provided
+ */
+export const resolveModel = async (args, projectDir, workstream) => {
+    const agentType = args[0];
+    if (!agentType) {
+        throw new SDDError('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 } };
+    }
+    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":"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"}

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

@@ -0,0 +1,36 @@
+/**
+ * SDK-side mirror of sdd/bin/lib/config-schema.cjs.
+ *
+ * Single source of truth for valid config key paths accepted by
+ * `config-set`. MUST stay in sync with the CJS schema — enforced
+ * by tests/config-schema-sdk-parity.test.cjs (CI drift guard).
+ *
+ * If you add/remove a key here, make the identical change in
+ * sdd/bin/lib/config-schema.cjs (and vice versa). The
+ * parity test asserts the two allowlists are set-equal and that
+ * DYNAMIC_KEY_PATTERN_SOURCES produce identical regex source strings.
+ *
+ * See #2653 — CJS/SDK drift caused config-set to reject documented
+ * keys. #2479 added CJS↔docs parity; #2653 adds CJS↔SDK parity.
+ */
+/** Exact-match config key paths accepted by config-set. */
+export declare const VALID_CONFIG_KEYS: ReadonlySet<string>;
+/**
+ * Internal runtime-state keys accepted by config-set workflows but not exposed
+ * as user-facing config options.
+ */
+export declare const RUNTIME_STATE_KEYS: ReadonlySet<string>;
+/**
+ * Dynamic-pattern validators — keys matching these regexes are also accepted.
+ * Each entry's `source` MUST equal the corresponding CJS regex `.source`
+ * (the parity test enforces this).
+ */
+export interface DynamicKeyPattern {
+    readonly test: (k: string) => boolean;
+    readonly description: string;
+    readonly source: string;
+}
+export declare const DYNAMIC_KEY_PATTERNS: readonly DynamicKeyPattern[];
+/** 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;AAEH,2DAA2D;AAC3D,eAAO,MAAM,iBAAiB,EAAE,WAAW,CAAC,MAAM,CAoEhD,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,WAAW,CAAC,MAAM,CAEjD,CAAC;AAEH;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,oBAAoB,EAAE,SAAS,iBAAiB,EA6C5D,CAAC;AAEF,gGAAgG;AAChG,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAI7D"}

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

@@ -0,0 +1,147 @@
+/**
+ * SDK-side mirror of sdd/bin/lib/config-schema.cjs.
+ *
+ * Single source of truth for valid config key paths accepted by
+ * `config-set`. MUST stay in sync with the CJS schema — enforced
+ * by tests/config-schema-sdk-parity.test.cjs (CI drift guard).
+ *
+ * If you add/remove a key here, make the identical change in
+ * sdd/bin/lib/config-schema.cjs (and vice versa). The
+ * parity test asserts the two allowlists are set-equal and that
+ * DYNAMIC_KEY_PATTERN_SOURCES produce identical regex source strings.
+ *
+ * See #2653 — CJS/SDK drift caused config-set to reject documented
+ * keys. #2479 added CJS↔docs parity; #2653 adds CJS↔SDK parity.
+ */
+/** Exact-match config key paths accepted by config-set. */
+export const VALID_CONFIG_KEYS = new Set([
+    'mode', 'granularity', 'parallelization', 'commit_docs', 'model_profile',
+    'search_gitignored', 'brave_search', 'firecrawl', 'exa_search',
+    'workflow.research', 'workflow.plan_check', 'workflow.verifier',
+    'workflow.nyquist_validation', 'workflow.ai_integration_phase', 'workflow.ui_phase', 'workflow.ui_safety_gate',
+    'workflow.auto_advance', 'workflow.node_repair', 'workflow.node_repair_budget',
+    'workflow.tdd_mode',
+    'workflow.human_verify_mode',
+    'workflow.text_mode',
+    'workflow.research_before_questions',
+    'workflow.discuss_mode',
+    'workflow.skip_discuss',
+    'workflow.auto_prune_state',
+    'workflow.use_worktrees',
+    'workflow.worktree_skip_hooks',
+    'workflow.code_review',
+    'workflow.code_review_depth',
+    'workflow.code_review_command',
+    'workflow.pattern_mapper',
+    'workflow.plan_bounce',
+    'workflow.plan_bounce_script',
+    'workflow.plan_bounce_passes',
+    'workflow.plan_chunked',
+    'workflow.plan_review_convergence',
+    'workflow.post_planning_gaps',
+    'workflow.security_enforcement',
+    'workflow.security_asvs_level',
+    'workflow.security_block_on',
+    'workflow.drift_threshold',
+    'workflow.drift_action',
+    'code_quality.fallow.enabled',
+    'code_quality.fallow.scope',
+    'code_quality.fallow.profile',
+    'code_quality.fallow.mcp',
+    'ship.pr_body_sections',
+    'git.branching_strategy', 'git.base_branch', 'git.create_tag', 'git.phase_branch_template', 'git.milestone_branch_template', 'git.quick_branch_template',
+    'planning.commit_docs', 'planning.search_gitignored', 'planning.sub_repos',
+    'review.default_reviewers',
+    'review.ollama_host', 'review.lm_studio_host', 'review.llama_cpp_host',
+    'workflow.cross_ai_execution', 'workflow.cross_ai_command', 'workflow.cross_ai_timeout',
+    'workflow.subagent_timeout',
+    'executor.stall_detect_interval_minutes',
+    'executor.stall_threshold_minutes',
+    'workflow.inline_plan_threshold',
+    'hooks.context_warnings',
+    'hooks.workflow_guard',
+    'workflow.context_coverage_gate',
+    'statusline.show_last_command',
+    'statusline.context_position',
+    'workflow.ui_review',
+    'workflow.max_discuss_passes',
+    'features.thinking_partner',
+    'context',
+    'features.global_learnings',
+    'learnings.max_inject',
+    'project_code', 'phase_naming',
+    'manager.flags.discuss', 'manager.flags.plan', 'manager.flags.execute',
+    'response_language',
+    'context_window',
+    'intel.enabled',
+    'graphify.enabled',
+    'graphify.build_timeout',
+    'claude_md_path',
+    'claude_md_assembly.mode',
+    // #2517 — runtime-aware model profiles
+    'runtime',
+    // #3162 — documented top-level key: controls model ID resolution for non-Claude runtimes
+    'resolve_model_ids',
+]);
+/**
+ * Internal runtime-state keys accepted by config-set workflows but not exposed
+ * as user-facing config options.
+ */
+export const RUNTIME_STATE_KEYS = new Set([
+    'workflow._auto_chain_active',
+]);
+export const DYNAMIC_KEY_PATTERNS = [
+    {
+        source: '^agent_skills\\.[a-zA-Z0-9_-]+$',
+        description: 'agent_skills.<agent-type>',
+        test: (k) => /^agent_skills\.[a-zA-Z0-9_-]+$/.test(k),
+    },
+    {
+        source: '^review\\.models\\.[a-zA-Z0-9_-]+$',
+        description: 'review.models.<cli-name>',
+        test: (k) => /^review\.models\.[a-zA-Z0-9_-]+$/.test(k),
+    },
+    {
+        source: '^features\\.[a-zA-Z0-9_]+$',
+        description: 'features.<feature_name>',
+        test: (k) => /^features\.[a-zA-Z0-9_]+$/.test(k),
+    },
+    {
+        source: '^claude_md_assembly\\.blocks\\.[a-zA-Z0-9_]+$',
+        description: 'claude_md_assembly.blocks.<section>',
+        test: (k) => /^claude_md_assembly\.blocks\.[a-zA-Z0-9_]+$/.test(k),
+    },
+    // #2517 — runtime-aware model profile overrides: model_profile_overrides.<runtime>.<tier>
+    {
+        source: '^model_profile_overrides\\.[a-zA-Z0-9_-]+\\.(opus|sonnet|haiku)$',
+        description: 'model_profile_overrides.<runtime>.<opus|sonnet|haiku>',
+        test: (k) => /^model_profile_overrides\.[a-zA-Z0-9_-]+\.(opus|sonnet|haiku)$/.test(k),
+    },
+    // #3023 — per-phase-type model map: models.<phase_type> = <tier>
+    {
+        source: '^models\\.(planning|discuss|research|execution|verification|completion)$',
+        description: 'models.<planning|discuss|research|execution|verification|completion>',
+        test: (k) => /^models\.(planning|discuss|research|execution|verification|completion)$/.test(k),
+    },
+    // #3024 — dynamic routing with failure-tier escalation
+    {
+        source: '^dynamic_routing\\.(enabled|escalate_on_failure|max_escalations|tier_models\\.(light|standard|heavy))$',
+        description: 'dynamic_routing.<enabled|escalate_on_failure|max_escalations|tier_models.<light|standard|heavy>>',
+        test: (k) => /^dynamic_routing\.(enabled|escalate_on_failure|max_escalations|tier_models\.(light|standard|heavy))$/.test(k),
+    },
+    // #3227 — per-agent model overrides: model_overrides.<agent-id>
+    {
+        source: '^model_overrides\\.[a-zA-Z0-9_-]+$',
+        description: 'model_overrides.<agent-id>',
+        test: (k) => /^model_overrides\.[a-zA-Z0-9_-]+$/.test(k),
+    },
+];
+/** 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":"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"}

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-7`, `D-42`. */
+    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,wCAAwC;IACxC,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,CA0EhE;AAID;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,YAsB5B,CAAC"}

package/sdk/dist/query/decisions.js

@@ -0,0 +1,161 @@
+/**
+ * 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`
+    const bulletRe = /^\s*-\s+\*\*D-(\d+)(?:\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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAmB7C,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC;IAClC,qBAAqB;IACrB,oBAAoB;IACpB,mBAAmB;CACpB,CAAC,CAAC;AAEH,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,CAAC,eAAe,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC,CAAC;AAE5E;;;GAGG;AACH,SAAS,eAAe,CAAC,OAAe;IACtC,OAAO,OAAO,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,iBAAiB,EAAE,GAAG,CAAC,CAAC;AACjF,CAAC;AAED;;;;;;;GAOG;AACH,SAAS,qBAAqB,CAAC,OAAe;IAC5C,MAAM,OAAO,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,CAAC,GAAG,OAAO,CAAC,QAAQ,CAAC,qCAAqC,CAAC,CAAC,CAAC;IAC7E,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACvD,MAAM,KAAK,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAC7C,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IAE9B,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,GAAG,GAAqB,EAAE,CAAC;IACjC,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,YAAY,GAAG,KAAK,CAAC;IAEzB,2CAA2C;IAC3C,MAAM,QAAQ,GAAG,yDAAyD,CAAC;IAE3E,IAAI,OAAO,GAA0B,IAAI,CAAC;IAE1C,MAAM,KAAK,GAAG,GAAG,EAAE;QACjB,IAAI,OAAO,EAAE,CAAC;YACZ,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACnC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAClB,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;IACH,CAAC,CAAC;IAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAE5B,0CAA0C;QAC1C,MAAM,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACvD,IAAI,YAAY,EAAE,CAAC;YACjB,KAAK,EAAE,CAAC;YACR,QAAQ,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC;YAC3B,oEAAoE;YACpE,uEAAuE;YACvE,sEAAsE;YACtE,gBAAgB;YAChB,MAAM,UAAU,GAAG,QAAQ;iBACxB,WAAW,EAAE;iBACb,OAAO,CAAC,wDAAwD,EAAE,EAAE,CAAC;iBACrE,IAAI,EAAE,CAAC;YACV,YAAY,GAAG,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YACnD,SAAS;QACX,CAAC;QAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACzC,IAAI,WAAW,EAAE,CAAC;YAChB,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,GAAG,KAAK,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC;gBACzB,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;qBACX,KAAK,CAAC,GAAG,CAAC;qBACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;qBAClC,MAAM,CAAC,OAAO,CAAC;gBACpB,CAAC,CAAC,EAAE,CAAC;YACP,MAAM,SAAS,GACb,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YAChE,OAAO,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;YAClE,SAAS;QACX,CAAC;QAED,sEAAsE;QACtE,uEAAuE;QACvE,IAAI,OAAO,IAAI,OAAO,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACjF,OAAO,CAAC,IAAI,IAAI,GAAG,GAAG,OAAO,CAAC;YAC9B,SAAS;QACX,CAAC;QAED,kEAAkE;QAClE,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YACnB,KAAK,EAAE,CAAC;QACV,CAAC;IACH,CAAC;IACD,KAAK,EAAE,CAAC;IAER,OAAO,GAAG,CAAC;AACb,CAAC;AAED,6EAA6E;AAE7E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAAiB,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE;IACrE,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;IAC5E,CAAC;IACD,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IAC9E,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;IAC5E,CAAC;IACD,MAAM,SAAS,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACvD,OAAO;QACL,IAAI,EAAE;YACJ,SAAS;YACT,SAAS,EAAE,SAAS,CAAC,MAAM;YAC3B,KAAK,EAAE,SAAS,CAAC,MAAM;YACvB,OAAO,EAAE,KAAK;SACf;KACF,CAAC;AACJ,CAAC,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * Detect user-added files under SDD-managed install dirs not listed in the manifest.
+ *
+ * Port of `detect-custom-files` from `sdd/bin/sdd-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