@bhargavvc/sdd-cc 1.35.0 → 1.42.4

package/sdk/dist/query/query-command-resolution-strategy.d.ts

@@ -0,0 +1,29 @@
+export interface QueryCommandRegistryLike {
+    has(command: string): boolean;
+}
+export type QueryMatchMode = 'dotted' | 'spaced';
+export type QueryResolutionSource = 'normalized' | 'expanded';
+export interface QueryCommandResolution {
+    cmd: string;
+    args: string[];
+    matchedBy: QueryMatchMode;
+    expanded: boolean;
+    source: QueryResolutionSource;
+}
+export interface QueryCommandNoMatch {
+    normalized: {
+        command: string;
+        args: string[];
+        tokens: string[];
+    };
+    attempted: {
+        dotted: string[];
+        spaced: string[];
+        expandedTokens: string[] | null;
+    };
+}
+export declare function normalizeQueryCommand(command: string, args: string[]): [string, string[]];
+export declare function resolveQueryTokens(tokens: string[], registry: QueryCommandRegistryLike): QueryCommandResolution | null;
+export declare function resolveQueryCommand(command: string, args: string[], registry: QueryCommandRegistryLike): QueryCommandResolution | null;
+export declare function explainQueryCommandNoMatch(command: string, args: string[], registry: QueryCommandRegistryLike): QueryCommandNoMatch;
+//# sourceMappingURL=query-command-resolution-strategy.d.ts.map

package/sdk/dist/query/query-command-resolution-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-command-resolution-strategy.d.ts","sourceRoot":"","sources":["../../src/query/query-command-resolution-strategy.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,wBAAwB;IACvC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;CAC/B;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,QAAQ,CAAC;AACjD,MAAM,MAAM,qBAAqB,GAAG,YAAY,GAAG,UAAU,CAAC;AAE9D,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,cAAc,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,qBAAqB,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAClE,SAAS,EAAE;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,cAAc,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;KAAE,CAAC;CACpF;AAOD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAoCzF;AAsBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,wBAAwB,GAAG,sBAAsB,GAAG,IAAI,CAStH;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,wBAAwB,GAAG,sBAAsB,GAAG,IAAI,CAGtI;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,wBAAwB,GAAG,mBAAmB,CAWnI"}

package/sdk/dist/query/query-command-resolution-strategy.js

@@ -0,0 +1,103 @@
+import { STATE_SUBCOMMANDS, VERIFY_SUBCOMMANDS, INIT_SUBCOMMANDS, PHASE_SUBCOMMANDS, PHASES_SUBCOMMANDS, VALIDATE_SUBCOMMANDS, ROADMAP_SUBCOMMANDS, } from './command-aliases.generated.js';
+const MERGE_FIRST_WITH_SUBCOMMAND = new Set([
+    'state', 'template', 'frontmatter', 'verify', 'phase', 'requirements', 'init',
+    'workstream', 'intel', 'learnings', 'uat', 'todo', 'milestone', 'check', 'detect', 'route',
+]);
+export function normalizeQueryCommand(command, args) {
+    if (command === 'scaffold')
+        return ['phase.scaffold', args];
+    if (command === 'state' && args.length === 0)
+        return ['state.load', []];
+    if (command === 'state' && args.length > 0) {
+        if (STATE_SUBCOMMANDS.has(args[0]))
+            return [`state.${args[0]}`, args.slice(1)];
+        return [command, args];
+    }
+    if (command === 'verify' && args.length > 0) {
+        if (VERIFY_SUBCOMMANDS.has(args[0]))
+            return [`verify.${args[0]}`, args.slice(1)];
+        return [command, args];
+    }
+    if (command === 'init' && args.length > 0) {
+        if (INIT_SUBCOMMANDS.has(args[0]))
+            return [`init.${args[0]}`, args.slice(1)];
+        return [command, args];
+    }
+    if (command === 'phase' && args.length > 0) {
+        if (PHASE_SUBCOMMANDS.has(args[0]))
+            return [`phase.${args[0]}`, args.slice(1)];
+        return [command, args];
+    }
+    if (command === 'phases' && args.length > 0) {
+        if (PHASES_SUBCOMMANDS.has(args[0]))
+            return [`phases.${args[0]}`, args.slice(1)];
+        return [command, args];
+    }
+    if (command === 'validate' && args.length > 0) {
+        if (VALIDATE_SUBCOMMANDS.has(args[0]))
+            return [`validate.${args[0]}`, args.slice(1)];
+        return [command, args];
+    }
+    if (command === 'roadmap' && args.length > 0) {
+        if (ROADMAP_SUBCOMMANDS.has(args[0]))
+            return [`roadmap.${args[0]}`, args.slice(1)];
+        return [command, args];
+    }
+    if (MERGE_FIRST_WITH_SUBCOMMAND.has(command) && args.length > 0 && !args[0].startsWith('-'))
+        return [`${command}.${args[0]}`, args.slice(1)];
+    if ((command === 'progress' || command === 'stats') && args.length > 0 && !args[0].startsWith('-'))
+        return [`${command}.${args[0]}`, args.slice(1)];
+    return [command, args];
+}
+function expandFirstDottedToken(tokens) {
+    if (tokens.length === 0)
+        return tokens;
+    const first = tokens[0];
+    if (first.startsWith('--') || !first.includes('.'))
+        return tokens;
+    return [...first.split('.'), ...tokens.slice(1)];
+}
+function matchRegisteredPrefix(tokens, registry, track) {
+    for (let i = tokens.length; i >= 1; i--) {
+        const head = tokens.slice(0, i);
+        const dotted = head.join('.');
+        const spaced = head.join(' ');
+        track?.dotted.push(dotted);
+        track?.spaced.push(spaced);
+        if (registry.has(dotted))
+            return { cmd: dotted, args: tokens.slice(i), matchedBy: 'dotted' };
+        if (registry.has(spaced))
+            return { cmd: spaced, args: tokens.slice(i), matchedBy: 'spaced' };
+    }
+    return null;
+}
+export function resolveQueryTokens(tokens, registry) {
+    const direct = matchRegisteredPrefix(tokens, registry);
+    if (direct)
+        return { ...direct, expanded: false, source: 'normalized' };
+    const expanded = expandFirstDottedToken(tokens);
+    if (expanded !== tokens) {
+        const afterExpand = matchRegisteredPrefix(expanded, registry);
+        if (afterExpand)
+            return { ...afterExpand, expanded: true, source: 'expanded' };
+    }
+    return null;
+}
+export function resolveQueryCommand(command, args, registry) {
+    const [normCmd, normArgs] = normalizeQueryCommand(command, args);
+    return resolveQueryTokens([normCmd, ...normArgs], registry);
+}
+export function explainQueryCommandNoMatch(command, args, registry) {
+    const [normalizedCommand, normalizedArgs] = normalizeQueryCommand(command, args);
+    const normalizedTokens = [normalizedCommand, ...normalizedArgs];
+    const attempted = { dotted: [], spaced: [] };
+    matchRegisteredPrefix(normalizedTokens, registry, attempted);
+    const expandedTokens = expandFirstDottedToken(normalizedTokens);
+    if (expandedTokens !== normalizedTokens)
+        matchRegisteredPrefix(expandedTokens, registry, attempted);
+    return {
+        normalized: { command: normalizedCommand, args: normalizedArgs, tokens: normalizedTokens },
+        attempted: { dotted: attempted.dotted, spaced: attempted.spaced, expandedTokens: expandedTokens !== normalizedTokens ? expandedTokens : null },
+    };
+}
+//# sourceMappingURL=query-command-resolution-strategy.js.map

package/sdk/dist/query/query-command-resolution-strategy.js.map

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

package/sdk/dist/query/query-command-semantics.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @deprecated Legacy compatibility seam.
+ * Prefer importing policy and indexed views from `query-policy-capability` or `command-definition`.
+ */
+export { QUERY_MUTATION_COMMAND_LIST, TRANSPORT_RAW_COMMANDS, isQueryMutationCommand, } from './query-policy-capability.js';
+export { normalizeQueryCommand, resolveQueryTokens, resolveQueryCommand, explainQueryCommandNoMatch, type QueryCommandRegistryLike, type QueryCommandResolution, type QueryMatchMode, type QueryResolutionSource, type QueryCommandNoMatch, } from './query-command-resolution-strategy.js';
+//# sourceMappingURL=query-command-semantics.d.ts.map

package/sdk/dist/query/query-command-semantics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-command-semantics.d.ts","sourceRoot":"","sources":["../../src/query/query-command-semantics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,0BAA0B,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,sBAAsB,EAC3B,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,GACzB,MAAM,wCAAwC,CAAC"}

package/sdk/dist/query/query-command-semantics.js

@@ -0,0 +1,7 @@
+/**
+ * @deprecated Legacy compatibility seam.
+ * Prefer importing policy and indexed views from `query-policy-capability` or `command-definition`.
+ */
+export { QUERY_MUTATION_COMMAND_LIST, TRANSPORT_RAW_COMMANDS, isQueryMutationCommand, } from './query-policy-capability.js';
+export { normalizeQueryCommand, resolveQueryTokens, resolveQueryCommand, explainQueryCommandNoMatch, } from './query-command-resolution-strategy.js';
+//# sourceMappingURL=query-command-semantics.js.map

package/sdk/dist/query/query-command-semantics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-command-semantics.js","sourceRoot":"","sources":["../../src/query/query-command-semantics.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,2BAA2B,EAC3B,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,0BAA0B,GAM3B,MAAM,wCAAwC,CAAC"}

package/sdk/dist/query/query-dispatch-contract.d.ts

@@ -0,0 +1,21 @@
+export type QueryDispatchErrorKind = 'unknown_command' | 'native_failure' | 'native_timeout' | 'fallback_failure' | 'validation_error' | 'internal_error';
+export interface QueryDispatchError {
+    kind: QueryDispatchErrorKind;
+    code: number;
+    message: string;
+    details?: Record<string, unknown>;
+}
+export interface QueryDispatchSuccessResult {
+    ok: true;
+    stdout: string;
+    stderr: string[];
+    exit_code: 0;
+}
+export interface QueryDispatchFailureResult {
+    ok: false;
+    error: QueryDispatchError;
+    stderr: string[];
+    exit_code: number;
+}
+export type QueryDispatchResult = QueryDispatchSuccessResult | QueryDispatchFailureResult;
+//# sourceMappingURL=query-dispatch-contract.d.ts.map

package/sdk/dist/query/query-dispatch-contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dispatch-contract.d.ts","sourceRoot":"","sources":["../../src/query/query-dispatch-contract.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,sBAAsB,GAC9B,iBAAiB,GACjB,gBAAgB,GAChB,gBAAgB,GAChB,kBAAkB,GAClB,kBAAkB,GAClB,gBAAgB,CAAC;AAErB,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,sBAAsB,CAAC;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,IAAI,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,CAAC,CAAC;CACd;AAED,MAAM,WAAW,0BAA0B;IACzC,EAAE,EAAE,KAAK,CAAC;IACV,KAAK,EAAE,kBAAkB,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,MAAM,mBAAmB,GAAG,0BAA0B,GAAG,0BAA0B,CAAC"}

package/sdk/dist/query/query-dispatch-contract.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=query-dispatch-contract.js.map

package/sdk/dist/query/query-dispatch-contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dispatch-contract.js","sourceRoot":"","sources":["../../src/query/query-dispatch-contract.ts"],"names":[],"mappings":""}

package/sdk/dist/query/query-dispatch-error-mapper.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @deprecated Compatibility seam after Query Dispatch Module deepening.
+ * Remove-after: all imports migrate to `query-dispatch.ts`.
+ */
+export { toDispatchFailure, mapNativeDispatchError, mapFallbackDispatchError } from './query-dispatch.js';
+//# sourceMappingURL=query-dispatch-error-mapper.d.ts.map

package/sdk/dist/query/query-dispatch-error-mapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dispatch-error-mapper.d.ts","sourceRoot":"","sources":["../../src/query/query-dispatch-error-mapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC"}

package/sdk/dist/query/query-dispatch-error-mapper.js

@@ -0,0 +1,6 @@
+/**
+ * @deprecated Compatibility seam after Query Dispatch Module deepening.
+ * Remove-after: all imports migrate to `query-dispatch.ts`.
+ */
+export { toDispatchFailure, mapNativeDispatchError, mapFallbackDispatchError } from './query-dispatch.js';
+//# sourceMappingURL=query-dispatch-error-mapper.js.map

package/sdk/dist/query/query-dispatch-error-mapper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dispatch-error-mapper.js","sourceRoot":"","sources":["../../src/query/query-dispatch-error-mapper.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,wBAAwB,EAAE,MAAM,qBAAqB,CAAC"}

package/sdk/dist/query/query-dispatch-formatting.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @deprecated Compatibility seam after Query Dispatch Module deepening.
+ * Remove-after: all imports migrate to `query-dispatch.ts`.
+ */
+export { formatPick, formatSuccess, type DispatchSuccessFormat } from './query-dispatch.js';
+//# sourceMappingURL=query-dispatch-formatting.d.ts.map

package/sdk/dist/query/query-dispatch-formatting.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dispatch-formatting.d.ts","sourceRoot":"","sources":["../../src/query/query-dispatch-formatting.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}

package/sdk/dist/query/query-dispatch-formatting.js

@@ -0,0 +1,6 @@
+/**
+ * @deprecated Compatibility seam after Query Dispatch Module deepening.
+ * Remove-after: all imports migrate to `query-dispatch.ts`.
+ */
+export { formatPick, formatSuccess } from './query-dispatch.js';
+//# sourceMappingURL=query-dispatch-formatting.js.map

package/sdk/dist/query/query-dispatch-formatting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dispatch-formatting.js","sourceRoot":"","sources":["../../src/query/query-dispatch-formatting.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,aAAa,EAA8B,MAAM,qBAAqB,CAAC"}

package/sdk/dist/query/query-dispatch-input-validation.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @deprecated Compatibility seam after Query Dispatch Module deepening.
+ * Remove-after: all imports migrate to `query-dispatch.ts`.
+ */
+export { validateQueryDispatchInput, type DispatchInputValidationResult } from './query-dispatch.js';
+//# sourceMappingURL=query-dispatch-input-validation.d.ts.map

package/sdk/dist/query/query-dispatch-input-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dispatch-input-validation.d.ts","sourceRoot":"","sources":["../../src/query/query-dispatch-input-validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,0BAA0B,EAAE,KAAK,6BAA6B,EAAE,MAAM,qBAAqB,CAAC"}

package/sdk/dist/query/query-dispatch-input-validation.js

@@ -0,0 +1,6 @@
+/**
+ * @deprecated Compatibility seam after Query Dispatch Module deepening.
+ * Remove-after: all imports migrate to `query-dispatch.ts`.
+ */
+export { validateQueryDispatchInput } from './query-dispatch.js';
+//# sourceMappingURL=query-dispatch-input-validation.js.map

package/sdk/dist/query/query-dispatch-input-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dispatch-input-validation.js","sourceRoot":"","sources":["../../src/query/query-dispatch-input-validation.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,0BAA0B,EAAsC,MAAM,qBAAqB,CAAC"}

package/sdk/dist/query/query-dispatch-observability.d.ts

@@ -0,0 +1,2 @@
+export declare function fallbackBridgeNotices(command: string): string[];
+//# sourceMappingURL=query-dispatch-observability.d.ts.map

package/sdk/dist/query/query-dispatch-observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dispatch-observability.d.ts","sourceRoot":"","sources":["../../src/query/query-dispatch-observability.ts"],"names":[],"mappings":"AAAA,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAK/D"}

package/sdk/dist/query/query-dispatch-observability.js

@@ -0,0 +1,7 @@
+export function fallbackBridgeNotices(command) {
+    return [
+        `[sdd-sdk] '${command}' not in native registry; falling back to sdd-tools.cjs.`,
+        '[sdd-sdk] Transparent bridge — prefer adding a native handler when parity matters.',
+    ];
+}
+//# sourceMappingURL=query-dispatch-observability.js.map

package/sdk/dist/query/query-dispatch-observability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dispatch-observability.js","sourceRoot":"","sources":["../../src/query/query-dispatch-observability.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,qBAAqB,CAAC,OAAe;IACnD,OAAO;QACL,cAAc,OAAO,0DAA0D;QAC/E,oFAAoF;KACrF,CAAC;AACJ,CAAC"}

package/sdk/dist/query/query-dispatch-plan.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @deprecated Compatibility seam after Query Dispatch Module deepening.
+ * Remove-after: all imports migrate to `query-dispatch.ts`.
+ */
+export { planQueryDispatch, type DispatchMode, type DispatchPlan } from './query-dispatch.js';
+//# sourceMappingURL=query-dispatch-plan.d.ts.map

package/sdk/dist/query/query-dispatch-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dispatch-plan.d.ts","sourceRoot":"","sources":["../../src/query/query-dispatch-plan.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAE,KAAK,YAAY,EAAE,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC"}

package/sdk/dist/query/query-dispatch-plan.js

@@ -0,0 +1,6 @@
+/**
+ * @deprecated Compatibility seam after Query Dispatch Module deepening.
+ * Remove-after: all imports migrate to `query-dispatch.ts`.
+ */
+export { planQueryDispatch } from './query-dispatch.js';
+//# sourceMappingURL=query-dispatch-plan.js.map

package/sdk/dist/query/query-dispatch-plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dispatch-plan.js","sourceRoot":"","sources":["../../src/query/query-dispatch-plan.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,iBAAiB,EAAwC,MAAM,qBAAqB,CAAC"}

package/sdk/dist/query/query-dispatch-result-builder.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @deprecated Compatibility seam after Query Dispatch Module deepening.
+ * Remove-after: all imports migrate to `query-dispatch.ts`.
+ */
+export { dispatchFailure, dispatchSuccess } from './query-dispatch.js';
+//# sourceMappingURL=query-dispatch-result-builder.d.ts.map

package/sdk/dist/query/query-dispatch-result-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dispatch-result-builder.d.ts","sourceRoot":"","sources":["../../src/query/query-dispatch-result-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

package/sdk/dist/query/query-dispatch-result-builder.js

@@ -0,0 +1,6 @@
+/**
+ * @deprecated Compatibility seam after Query Dispatch Module deepening.
+ * Remove-after: all imports migrate to `query-dispatch.ts`.
+ */
+export { dispatchFailure, dispatchSuccess } from './query-dispatch.js';
+//# sourceMappingURL=query-dispatch-result-builder.js.map

package/sdk/dist/query/query-dispatch-result-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-dispatch-result-builder.js","sourceRoot":"","sources":["../../src/query/query-dispatch-result-builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC"}

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

@@ -0,0 +1,48 @@
+import type { QueryRegistry } from './registry.js';
+import type { QueryDispatchError, QueryDispatchResult } from './query-dispatch-contract.js';
+import type { QueryResult } from './utils.js';
+import type { QueryNativeDispatchAdapter } from './query-native-dispatch-adapter.js';
+import type { CommandTopology, CommandTopologyMatch } from './command-topology.js';
+export interface QueryDispatchDeps {
+    registry: QueryRegistry;
+    projectDir: string;
+    ws?: string;
+    cjsFallbackEnabled: boolean;
+    resolveSddToolsPath: (projectDir: string) => string;
+    /** @deprecated use topology */
+    dispatchNative?: (cmd: string, args: string[]) => Promise<QueryResult>;
+    /** @deprecated use topology */
+    nativeAdapter?: QueryNativeDispatchAdapter;
+    topology: CommandTopology;
+}
+export type DispatchMode = 'native' | 'cjs' | 'error';
+export interface DispatchPlan {
+    mode: DispatchMode;
+    normalized: {
+        command: string;
+        args: string[];
+        tokens: string[];
+    };
+    matched: CommandTopologyMatch | null;
+    noMatchMessage?: string;
+    noMatchNormalized?: string;
+    noMatchAttempted?: string[];
+    noMatchHints?: string[];
+}
+export type DispatchSuccessFormat = 'json' | 'text' | undefined;
+export interface DispatchInputValidationResult {
+    queryArgs: string[];
+    pickField?: string;
+    error?: QueryDispatchResult;
+}
+export declare function dispatchFailure(error: QueryDispatchError, stderr?: string[]): QueryDispatchResult;
+export declare function dispatchSuccess(stdout: string, stderr?: string[]): QueryDispatchResult;
+export declare function toDispatchFailure(error: QueryDispatchError, stderr?: string[]): QueryDispatchResult;
+export declare function mapNativeDispatchError(error: unknown, command: string, args: string[]): QueryDispatchError;
+export declare function mapFallbackDispatchError(error: unknown, command: string, args: string[]): QueryDispatchError;
+export declare function formatPick(data: unknown, pickField?: string): unknown;
+export declare function formatSuccess(data: unknown, format: DispatchSuccessFormat, pickField?: string): string;
+export declare function validateQueryDispatchInput(queryArgv: string[]): DispatchInputValidationResult;
+export declare function planQueryDispatch(queryArgv: string[], topology: CommandTopology, cjsFallbackEnabled: boolean): DispatchPlan;
+export declare function runQueryDispatch(deps: QueryDispatchDeps, queryArgv: string[]): Promise<QueryDispatchResult>;
+//# sourceMappingURL=query-dispatch.d.ts.map

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

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

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

@@ -0,0 +1,175 @@
+import { extractField } from './registry.js';
+import { normalizeQueryCommand } from './query-command-resolution-strategy.js';
+import { runCjsFallbackDispatch } from './query-fallback-executor.js';
+import { unknownCommandError, validationError, fallbackDispatchErrorFromSignal, nativeDispatchErrorFromSignal } from './query-error-taxonomy.js';
+import { canUseCjsFallback } from './query-fallback-policy.js';
+import { toFailureSignal } from '../query-failure-classification.js';
+export function dispatchFailure(error, stderr = []) {
+    return {
+        ok: false,
+        error,
+        stderr,
+        exit_code: error.code,
+    };
+}
+export function dispatchSuccess(stdout, stderr = []) {
+    return {
+        ok: true,
+        stdout,
+        stderr,
+        exit_code: 0,
+    };
+}
+export function toDispatchFailure(error, stderr = []) {
+    return dispatchFailure(error, stderr);
+}
+export function mapNativeDispatchError(error, command, args) {
+    return nativeDispatchErrorFromSignal(toFailureSignal(error), command, args);
+}
+export function mapFallbackDispatchError(error, command, args) {
+    return fallbackDispatchErrorFromSignal(toFailureSignal(error), command, args);
+}
+export function formatPick(data, pickField) {
+    if (!pickField)
+        return data;
+    return extractField(data, pickField);
+}
+export function formatSuccess(data, format, pickField) {
+    if (format === 'text' && typeof data === 'string') {
+        if (pickField) {
+            throw new Error('--pick is not supported for text output');
+        }
+        return data.endsWith('\n') ? data : `${data}\n`;
+    }
+    const output = formatPick(data, pickField);
+    return `${JSON.stringify(output === undefined ? null : output, null, 2)}\n`;
+}
+export function validateQueryDispatchInput(queryArgv) {
+    const queryArgs = [...queryArgv];
+    const pickIdx = queryArgs.indexOf('--pick');
+    if (pickIdx !== -1) {
+        if (pickIdx + 1 >= queryArgs.length) {
+            return {
+                queryArgs,
+                error: dispatchFailure(validationError({
+                    message: 'Error: --pick requires a field name',
+                    details: { field: '--pick', reason: 'missing_value' },
+                })),
+            };
+        }
+        const pickField = queryArgs[pickIdx + 1];
+        queryArgs.splice(pickIdx, 2);
+        if (queryArgs.length === 0 || !queryArgs[0]) {
+            return {
+                queryArgs,
+                error: dispatchFailure(validationError({
+                    message: 'Error: "sdd-sdk query" requires a command',
+                    details: { reason: 'missing_command' },
+                })),
+            };
+        }
+        return { queryArgs, pickField };
+    }
+    if (queryArgs.length === 0 || !queryArgs[0]) {
+        return {
+            queryArgs,
+            error: dispatchFailure(validationError({
+                message: 'Error: "sdd-sdk query" requires a command',
+                details: { reason: 'missing_command' },
+            })),
+        };
+    }
+    return { queryArgs };
+}
+export function planQueryDispatch(queryArgv, topology, cjsFallbackEnabled) {
+    const queryCommand = queryArgv[0];
+    if (!queryCommand) {
+        return { mode: 'error', normalized: { command: '', args: [], tokens: [] }, matched: null };
+    }
+    const [normCmd, normArgs] = normalizeQueryCommand(queryCommand, queryArgv.slice(1));
+    const normalizedTokens = [normCmd, ...normArgs];
+    const resolved = topology.resolve(queryArgv, !cjsFallbackEnabled);
+    if (resolved.kind === 'match') {
+        return { mode: 'native', normalized: { command: normCmd, args: normArgs, tokens: normalizedTokens }, matched: resolved };
+    }
+    if (cjsFallbackEnabled) {
+        return { mode: 'cjs', normalized: { command: normCmd, args: normArgs, tokens: normalizedTokens }, matched: null };
+    }
+    return {
+        mode: 'error',
+        normalized: { command: normCmd, args: normArgs, tokens: normalizedTokens },
+        matched: null,
+        noMatchMessage: resolved.message,
+        noMatchNormalized: resolved.normalized,
+        noMatchAttempted: resolved.attempted,
+        noMatchHints: resolved.hints,
+    };
+}
+function fail(error, stderr = []) {
+    return toDispatchFailure(error, stderr);
+}
+export async function runQueryDispatch(deps, queryArgv) {
+    const validated = validateQueryDispatchInput(queryArgv);
+    if (validated.error)
+        return validated.error;
+    const { queryArgs, pickField } = validated;
+    const plan = planQueryDispatch(queryArgs, deps.topology, deps.cjsFallbackEnabled);
+    const normCmd = plan.normalized.command;
+    const normArgs = plan.normalized.args;
+    if (!normCmd || !String(normCmd).trim()) {
+        return fail(validationError({ message: 'Error: "sdd-sdk query" requires a command', details: { reason: 'empty_normalized_command' } }));
+    }
+    if (plan.mode === 'error') {
+        return fail(unknownCommandError({
+            message: plan.noMatchMessage ?? `Error: Unknown command: "${queryArgs[0] ?? normCmd}"`,
+            normalized: plan.noMatchNormalized ?? [normCmd, ...normArgs].join(' ').trim(),
+            attempted: plan.noMatchAttempted ?? [],
+            hints: plan.noMatchHints ?? [],
+        }));
+    }
+    if (plan.mode === 'cjs') {
+        if (canUseCjsFallback({ cjsFallbackEnabled: deps.cjsFallbackEnabled })) {
+            try {
+                const sddPath = deps.resolveSddToolsPath(deps.projectDir);
+                return await runCjsFallbackDispatch({
+                    projectDir: deps.projectDir,
+                    sddToolsPath: sddPath,
+                    normCmd,
+                    normArgs,
+                    ws: deps.ws,
+                    pickField,
+                });
+            }
+            catch (e) {
+                return toDispatchFailure(mapFallbackDispatchError(e, normCmd, normArgs));
+            }
+        }
+        return toDispatchFailure(mapFallbackDispatchError(new Error('CJS fallback denied by policy'), normCmd, normArgs));
+    }
+    const matched = plan.matched;
+    if (!matched) {
+        return toDispatchFailure(mapFallbackDispatchError(new Error('No native match in dispatch plan'), normCmd, normArgs));
+    }
+    // #3259: guard — if the invocation contains --help / -h AND the matched
+    // handler is a mutating command (mutation: true in the command manifest),
+    // short-circuit to a non-mutating stub. Mutating handlers are not help-aware
+    // by default (fail-closed). This prevents e.g. `milestone.complete --help`
+    // from writing milestone artifacts to disk.
+    const helpFlagPresent = matched.args.some((a) => a === '--help' || a === '-h');
+    if (helpFlagPresent && matched.mutation) {
+        return dispatchSuccess(formatSuccess({ help: `Usage: sdd-sdk query ${matched.canonical} [args...]` }, undefined));
+    }
+    const dispatchNative = deps.nativeAdapter
+        ? (cmd, args) => deps.nativeAdapter.dispatch(cmd, args)
+        : deps.dispatchNative;
+    try {
+        const result = dispatchNative
+            ? await dispatchNative(matched.canonical, matched.args)
+            : await matched.adapter(matched.args, deps.projectDir, deps.ws);
+        return dispatchSuccess(formatSuccess(result.data, result.format, pickField));
+    }
+    catch (e) {
+        return toDispatchFailure(mapNativeDispatchError(e, matched.canonical, matched.args));
+    }
+}
+//# sourceMappingURL=query-dispatch.js.map

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

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

package/sdk/dist/query/query-error-details-schema.d.ts

@@ -0,0 +1,19 @@
+export interface UnknownCommandDetails {
+    normalized: string;
+    attempted: string[];
+    hints: string[];
+}
+export interface NativeErrorDetails {
+    command: string;
+    args: string[];
+    timeout_ms?: number;
+}
+export interface FallbackErrorDetails {
+    command: string;
+    args: string[];
+    backend: 'cjs';
+}
+export declare function unknownCommandDetails(input: UnknownCommandDetails): UnknownCommandDetails;
+export declare function nativeErrorDetails(input: NativeErrorDetails): NativeErrorDetails;
+export declare function fallbackErrorDetails(input: FallbackErrorDetails): FallbackErrorDetails;
+//# sourceMappingURL=query-error-details-schema.d.ts.map

package/sdk/dist/query/query-error-details-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-error-details-schema.d.ts","sourceRoot":"","sources":["../../src/query/query-error-details-schema.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,KAAK,CAAC;CAChB;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,qBAAqB,GAAG,qBAAqB,CAEzF;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,kBAAkB,GAAG,kBAAkB,CAEhF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,oBAAoB,GAAG,oBAAoB,CAEtF"}