@ai-is-gonna/get-tasks-done 0.2.0

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

@@ -0,0 +1,205 @@
+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';
+import { ErrorClassification, GTDError } from '../errors.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) {
+    if (error instanceof GTDError && error.classification === ErrorClassification.Validation) {
+        return validationError({
+            message: error.message,
+            details: { 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: "gtd-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: "gtd-sdk query" requires a command',
+                details: { reason: 'missing_command' },
+            })),
+        };
+    }
+    return { queryArgs };
+}
+function deprecatedTaskWorkflowCommand(command) {
+    const normalized = String(command || '').trim();
+    if (normalized === 'execute-phase') {
+        return 'execute-phase has been removed. Use export-phase-issues, work-task-issue, and orchestrate-tasks for task issue work; use work-task-issue --complete-phase <phase> --execute for phase finalization.';
+    }
+    if (normalized === 'check-ship-ready' || normalized === 'ship') {
+        return `${normalized} has been removed. Use export-phase-issues, work-task-issue, orchestrate-tasks, and work-task-issue --complete-phase <phase> --execute under the task issue workflow.`;
+    }
+    return null;
+}
+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 deprecatedGuidance = deprecatedTaskWorkflowCommand(queryArgs[0]);
+    if (deprecatedGuidance) {
+        return fail(unknownCommandError({
+            message: `Error: Unknown command: "${queryArgs[0]}". ${deprecatedGuidance}`,
+            normalized: queryArgs.join(' '),
+            attempted: [queryArgs[0]],
+            hints: [
+                'Use export-phase-issues to create GitHub task issues.',
+                'Use work-task-issue for single-task work and phase finalization.',
+                'Use orchestrate-tasks for exact child issue batches.',
+            ],
+        }));
+    }
+    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: "gtd-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 gtdPath = deps.resolveGtdToolsPath(deps.projectDir);
+                return await runCjsFallbackDispatch({
+                    projectDir: deps.projectDir,
+                    gtdToolsPath: gtdPath,
+                    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: gtd-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":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAKtE,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,+BAA+B,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AACjJ,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,oCAAoC,CAAC;AACrE,OAAO,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAmC7D,MAAM,UAAU,eAAe,CAAC,KAAyB,EAAE,SAAmB,EAAE;IAC9E,OAAO;QACL,EAAE,EAAE,KAAK;QACT,KAAK;QACL,MAAM;QACN,SAAS,EAAE,KAAK,CAAC,IAAI;KACtB,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,MAAc,EAAE,SAAmB,EAAE;IACnE,OAAO;QACL,EAAE,EAAE,IAAI;QACR,MAAM;QACN,MAAM;QACN,SAAS,EAAE,CAAC;KACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAyB,EAAE,SAAmB,EAAE;IAChF,OAAO,eAAe,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAAc,EAAE,OAAe,EAAE,IAAc;IACpF,IAAI,KAAK,YAAY,QAAQ,IAAI,KAAK,CAAC,cAAc,KAAK,mBAAmB,CAAC,UAAU,EAAE,CAAC;QACzF,OAAO,eAAe,CAAC;YACrB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,OAAO,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE;SAC3B,CAAC,CAAC;IACL,CAAC;IACD,OAAO,6BAA6B,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAc,EAAE,OAAe,EAAE,IAAc;IACtF,OAAO,+BAA+B,CAAC,eAAe,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAa,EAAE,SAAkB;IAC1D,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAC5B,OAAO,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,IAAa,EAAE,MAA6B,EAAE,SAAkB;IAC5F,IAAI,MAAM,KAAK,MAAM,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAClD,IAAI,SAAS,EAAE,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;QAC7D,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC;IAClD,CAAC;IACD,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC3C,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,SAAmB;IAC5D,MAAM,SAAS,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC;IACjC,MAAM,OAAO,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC5C,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;QACnB,IAAI,OAAO,GAAG,CAAC,IAAI,SAAS,CAAC,MAAM,EAAE,CAAC;YACpC,OAAO;gBACL,SAAS;gBACT,KAAK,EAAE,eAAe,CAAC,eAAe,CAAC;oBACrC,OAAO,EAAE,qCAAqC;oBAC9C,OAAO,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,eAAe,EAAE;iBACtD,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC;QACD,MAAM,SAAS,GAAG,SAAS,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;QACzC,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAC7B,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YAC5C,OAAO;gBACL,SAAS;gBACT,KAAK,EAAE,eAAe,CAAC,eAAe,CAAC;oBACrC,OAAO,EAAE,2CAA2C;oBACpD,OAAO,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE;iBACvC,CAAC,CAAC;aACJ,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,CAAC;IAClC,CAAC;IAED,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,OAAO;YACL,SAAS;YACT,KAAK,EAAE,eAAe,CAAC,eAAe,CAAC;gBACrC,OAAO,EAAE,2CAA2C;gBACpD,OAAO,EAAE,EAAE,MAAM,EAAE,iBAAiB,EAAE;aACvC,CAAC,CAAC;SACJ,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,SAAS,EAAE,CAAC;AACvB,CAAC;AAED,SAAS,6BAA6B,CAAC,OAAe;IACpD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAChD,IAAI,UAAU,KAAK,eAAe,EAAE,CAAC;QACnC,OAAO,qMAAqM,CAAC;IAC/M,CAAC;IACD,IAAI,UAAU,KAAK,kBAAkB,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QAC/D,OAAO,GAAG,UAAU,uKAAuK,CAAC;IAC9L,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,iBAAiB,CAC/B,SAAmB,EACnB,QAAyB,EACzB,kBAA2B;IAE3B,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAClC,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC7F,CAAC;IAED,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,qBAAqB,CAAC,YAAY,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACpF,MAAM,gBAAgB,GAAG,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,kBAAkB,CAAC,CAAC;IAElE,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC9B,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC;IAC3H,CAAC;IAED,IAAI,kBAAkB,EAAE,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACpH,CAAC;IAED,OAAO;QACL,IAAI,EAAE,OAAO;QACb,UAAU,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,gBAAgB,EAAE;QAC1E,OAAO,EAAE,IAAI;QACb,cAAc,EAAE,QAAQ,CAAC,OAAO;QAChC,iBAAiB,EAAE,QAAQ,CAAC,UAAU;QACtC,gBAAgB,EAAE,QAAQ,CAAC,SAAS;QACpC,YAAY,EAAE,QAAQ,CAAC,KAAK;KAC7B,CAAC;AACJ,CAAC;AAED,SAAS,IAAI,CAAC,KAAkF,EAAE,SAAmB,EAAE;IACrH,OAAO,iBAAiB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAuB,EAAE,SAAmB;IACjF,MAAM,SAAS,GAAG,0BAA0B,CAAC,SAAS,CAAC,CAAC;IACxD,IAAI,SAAS,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC,KAAK,CAAC;IAE5C,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;IAE3C,MAAM,kBAAkB,GAAG,6BAA6B,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC;IACvE,IAAI,kBAAkB,EAAE,CAAC;QACvB,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,OAAO,EAAE,4BAA4B,SAAS,CAAC,CAAC,CAAC,MAAM,kBAAkB,EAAE;YAC3E,UAAU,EAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC;YAC/B,SAAS,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;YACzB,KAAK,EAAE;gBACL,uDAAuD;gBACvD,kEAAkE;gBAClE,sDAAsD;aACvD;SACF,CAAC,CAAC,CAAC;IACN,CAAC;IAED,MAAM,IAAI,GAAG,iBAAiB,CAAC,SAAS,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC;IAClF,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;IAEtC,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC,eAAe,CAAC,EAAE,OAAO,EAAE,2CAA2C,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,0BAA0B,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1I,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC,mBAAmB,CAAC;YAC9B,OAAO,EAAE,IAAI,CAAC,cAAc,IAAI,4BAA4B,SAAS,CAAC,CAAC,CAAC,IAAI,OAAO,GAAG;YACtF,UAAU,EAAE,IAAI,CAAC,iBAAiB,IAAI,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE;YAC7E,SAAS,EAAE,IAAI,CAAC,gBAAgB,IAAI,EAAE;YACtC,KAAK,EAAE,IAAI,CAAC,YAAY,IAAI,EAAE;SAC/B,CAAC,CAAC,CAAC;IACN,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACxB,IAAI,iBAAiB,CAAC,EAAE,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE,CAAC,EAAE,CAAC;YACvE,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC1D,OAAO,MAAM,sBAAsB,CAAC;oBAClC,UAAU,EAAE,IAAI,CAAC,UAAU;oBAC3B,YAAY,EAAE,OAAO;oBACrB,OAAO;oBACP,QAAQ;oBACR,EAAE,EAAE,IAAI,CAAC,EAAE;oBACX,SAAS;iBACV,CAAC,CAAC;YACL,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,OAAO,iBAAiB,CAAC,wBAAwB,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;YAC3E,CAAC;QACH,CAAC;QACD,OAAO,iBAAiB,CAAC,wBAAwB,CAAC,IAAI,KAAK,CAAC,+BAA+B,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IACpH,CAAC;IAED,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,iBAAiB,CAAC,wBAAwB,CAAC,IAAI,KAAK,CAAC,kCAAkC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IACvH,CAAC;IAED,wEAAwE;IACxE,0EAA0E;IAC1E,6EAA6E;IAC7E,2EAA2E;IAC3E,4CAA4C;IAC5C,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;IAC/E,IAAI,eAAe,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;QACxC,OAAO,eAAe,CACpB,aAAa,CACX,EAAE,IAAI,EAAE,wBAAwB,OAAO,CAAC,SAAS,YAAY,EAAE,EAC/D,SAAS,CACV,CACF,CAAC;IACJ,CAAC;IAED,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa;QACvC,CAAC,CAAC,CAAC,GAAW,EAAE,IAAc,EAAE,EAAE,CAAC,IAAI,CAAC,aAAc,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC;QAC1E,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;IAExB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,cAAc;YAC3B,CAAC,CAAC,MAAM,cAAc,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC;YACvD,CAAC,CAAC,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QAClE,OAAO,eAAe,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC;IAC/E,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,iBAAiB,CAAC,sBAAsB,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACvF,CAAC;AACH,CAAC"}

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"}

package/sdk/dist/query/query-error-details-schema.js

@@ -0,0 +1,10 @@
+export function unknownCommandDetails(input) {
+    return input;
+}
+export function nativeErrorDetails(input) {
+    return input;
+}
+export function fallbackErrorDetails(input) {
+    return input;
+}
+//# sourceMappingURL=query-error-details-schema.js.map

package/sdk/dist/query/query-error-details-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-error-details-schema.js","sourceRoot":"","sources":["../../src/query/query-error-details-schema.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,qBAAqB,CAAC,KAA4B;IAChE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAyB;IAC1D,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAA2B;IAC9D,OAAO,KAAK,CAAC;AACf,CAAC"}

package/sdk/dist/query/query-error-taxonomy.d.ts

@@ -0,0 +1,38 @@
+import type { QueryDispatchError } from './query-dispatch-contract.js';
+import type { QueryFailureSignal } from '../query-failure-classification.js';
+export declare function unknownCommandError(input: {
+    message: string;
+    normalized: string;
+    attempted: string[];
+    hints: string[];
+}): QueryDispatchError;
+export declare function nativeFailureError(input: {
+    message: string;
+    command: string;
+    args: string[];
+}): QueryDispatchError;
+export declare function nativeTimeoutError(input: {
+    message: string;
+    command: string;
+    args: string[];
+    timeoutMs?: number;
+}): QueryDispatchError;
+export declare function fallbackFailureError(input: {
+    message: string;
+    command: string;
+    args: string[];
+    backend?: 'cjs';
+}): QueryDispatchError;
+export declare function validationError(input: {
+    message: string;
+    code?: number;
+    details?: Record<string, unknown>;
+}): QueryDispatchError;
+export declare function internalError(input: {
+    message: string;
+    code?: number;
+    details?: Record<string, unknown>;
+}): QueryDispatchError;
+export declare function nativeDispatchErrorFromSignal(signal: QueryFailureSignal, command: string, args: string[]): QueryDispatchError;
+export declare function fallbackDispatchErrorFromSignal(signal: QueryFailureSignal, command: string, args: string[]): QueryDispatchError;
+//# sourceMappingURL=query-error-taxonomy.d.ts.map

package/sdk/dist/query/query-error-taxonomy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-error-taxonomy.d.ts","sourceRoot":"","sources":["../../src/query/query-error-taxonomy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oCAAoC,CAAC;AAE7E,wBAAgB,mBAAmB,CAAC,KAAK,EAAE;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB,GAAG,kBAAkB,CAWrB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB,GAAG,kBAAkB,CAUrB;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,kBAAkB,CAWrB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,CAAC,EAAE,KAAK,CAAC;CACjB,GAAG,kBAAkB,CAWrB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GAAG,kBAAkB,CAOrB;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,GAAG,kBAAkB,CAOrB;AAED,wBAAgB,6BAA6B,CAC3C,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,GACb,kBAAkB,CAKpB;AAED,wBAAgB,+BAA+B,CAC7C,MAAM,EAAE,kBAAkB,EAC1B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,GACb,kBAAkB,CAEpB"}

package/sdk/dist/query/query-error-taxonomy.js

@@ -0,0 +1,74 @@
+import { fallbackErrorDetails, nativeErrorDetails, unknownCommandDetails } from './query-error-details-schema.js';
+export function unknownCommandError(input) {
+    return {
+        kind: 'unknown_command',
+        code: 10,
+        message: input.message,
+        details: unknownCommandDetails({
+            normalized: input.normalized,
+            attempted: input.attempted,
+            hints: input.hints,
+        }),
+    };
+}
+export function nativeFailureError(input) {
+    return {
+        kind: 'native_failure',
+        code: 1,
+        message: `Error: ${input.message}`,
+        details: nativeErrorDetails({
+            command: input.command,
+            args: input.args,
+        }),
+    };
+}
+export function nativeTimeoutError(input) {
+    return {
+        kind: 'native_timeout',
+        code: 1,
+        message: `Error: ${input.message}`,
+        details: nativeErrorDetails({
+            command: input.command,
+            args: input.args,
+            ...(input.timeoutMs !== undefined ? { timeout_ms: input.timeoutMs } : {}),
+        }),
+    };
+}
+export function fallbackFailureError(input) {
+    return {
+        kind: 'fallback_failure',
+        code: 1,
+        message: `Error: gtd-tools.cjs fallback failed: ${input.message}`,
+        details: fallbackErrorDetails({
+            command: input.command,
+            args: input.args,
+            backend: input.backend ?? 'cjs',
+        }),
+    };
+}
+export function validationError(input) {
+    return {
+        kind: 'validation_error',
+        code: input.code ?? 10,
+        message: input.message,
+        details: input.details,
+    };
+}
+export function internalError(input) {
+    return {
+        kind: 'internal_error',
+        code: input.code ?? 1,
+        message: input.message,
+        details: input.details,
+    };
+}
+export function nativeDispatchErrorFromSignal(signal, command, args) {
+    if (signal.kind === 'timeout') {
+        return nativeTimeoutError({ message: signal.message, command, args, timeoutMs: signal.timeoutMs });
+    }
+    return nativeFailureError({ message: signal.message, command, args });
+}
+export function fallbackDispatchErrorFromSignal(signal, command, args) {
+    return fallbackFailureError({ message: signal.message, command, args, backend: 'cjs' });
+}
+//# sourceMappingURL=query-error-taxonomy.js.map

package/sdk/dist/query/query-error-taxonomy.js.map

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

package/sdk/dist/query/query-fallback-bridge-adapter.d.ts

@@ -0,0 +1,14 @@
+export interface FallbackBridgeRunInput {
+    projectDir: string;
+    gtdToolsPath: string;
+    normCmd: string;
+    normArgs: string[];
+    ws?: string;
+}
+export interface FallbackBridgeOutput {
+    mode: 'json' | 'text';
+    output: unknown;
+    stderr: string;
+}
+export declare function runFallbackBridge(input: FallbackBridgeRunInput): Promise<FallbackBridgeOutput>;
+//# sourceMappingURL=query-fallback-bridge-adapter.d.ts.map

package/sdk/dist/query/query-fallback-bridge-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-fallback-bridge-adapter.d.ts","sourceRoot":"","sources":["../../src/query/query-fallback-bridge-adapter.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,sBAAsB;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;CAChB;AAkCD,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAIpG"}

package/sdk/dist/query/query-fallback-bridge-adapter.js

@@ -0,0 +1,33 @@
+import { execFile } from 'node:child_process';
+import { classifyFallbackOutput } from './query-fallback-output-classifier.js';
+function dottedCommandToCjsArgv(normCmd, normArgs) {
+    if (normCmd.includes('.'))
+        return [...normCmd.split('.'), ...normArgs];
+    return [normCmd, ...normArgs];
+}
+function execBridge(input) {
+    const cjsArgv = dottedCommandToCjsArgv(input.normCmd, input.normArgs);
+    const wsSuffix = input.ws ? ['--ws', input.ws] : [];
+    const fullArgv = [input.gtdToolsPath, ...cjsArgv, ...wsSuffix];
+    return new Promise((resolve, reject) => {
+        execFile(process.execPath, fullArgv, { cwd: input.projectDir, maxBuffer: 10 * 1024 * 1024, timeout: 30_000, killSignal: 'SIGKILL', env: { ...process.env } }, (err, stdout, stderr) => {
+            const stdoutText = stdout?.toString() ?? '';
+            const stderrText = stderr?.toString() ?? '';
+            if (err) {
+                if (stderrText.trim()) {
+                    reject(new Error(`${err.message}\n${stderrText.trimEnd()}`));
+                    return;
+                }
+                reject(err);
+                return;
+            }
+            resolve({ stdout: stdoutText, stderr: stderrText });
+        });
+    });
+}
+export async function runFallbackBridge(input) {
+    const { stdout, stderr } = await execBridge(input);
+    const classified = await classifyFallbackOutput(stdout, input.projectDir);
+    return { ...classified, stderr };
+}
+//# sourceMappingURL=query-fallback-bridge-adapter.js.map

package/sdk/dist/query/query-fallback-bridge-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-fallback-bridge-adapter.js","sourceRoot":"","sources":["../../src/query/query-fallback-bridge-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAgB/E,SAAS,sBAAsB,CAAC,OAAe,EAAE,QAAkB;IACjE,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC;IACvE,OAAO,CAAC,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,SAAS,UAAU,CAAC,KAA6B;IAC/C,MAAM,OAAO,GAAG,sBAAsB,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACpD,MAAM,QAAQ,GAAG,CAAC,KAAK,CAAC,YAAY,EAAE,GAAG,OAAO,EAAE,GAAG,QAAQ,CAAC,CAAC;IAE/D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,QAAQ,CACN,OAAO,CAAC,QAAQ,EAChB,QAAQ,EACR,EAAE,GAAG,EAAE,KAAK,CAAC,UAAU,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,EACvH,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YACtB,MAAM,UAAU,GAAG,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC5C,MAAM,UAAU,GAAG,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;YAC5C,IAAI,GAAG,EAAE,CAAC;gBACR,IAAI,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;oBACtB,MAAM,CAAC,IAAI,KAAK,CAAC,GAAG,GAAG,CAAC,OAAO,KAAK,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;oBAC7D,OAAO;gBACT,CAAC;gBACD,MAAM,CAAC,GAAG,CAAC,CAAC;gBACZ,OAAO;YACT,CAAC;YACD,OAAO,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;QACtD,CAAC,CACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,KAA6B;IACnE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,CAAC;IACnD,MAAM,UAAU,GAAG,MAAM,sBAAsB,CAAC,MAAM,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAC1E,OAAO,EAAE,GAAG,UAAU,EAAE,MAAM,EAAE,CAAC;AACnC,CAAC"}

package/sdk/dist/query/query-fallback-executor.d.ts

@@ -0,0 +1,11 @@
+import type { QueryDispatchResult } from './query-dispatch-contract.js';
+export interface RunCjsFallbackDispatchInput {
+    projectDir: string;
+    gtdToolsPath: string;
+    normCmd: string;
+    normArgs: string[];
+    ws?: string;
+    pickField?: string;
+}
+export declare function runCjsFallbackDispatch(input: RunCjsFallbackDispatchInput): Promise<QueryDispatchResult>;
+//# sourceMappingURL=query-fallback-executor.d.ts.map

package/sdk/dist/query/query-fallback-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-fallback-executor.d.ts","sourceRoot":"","sources":["../../src/query/query-fallback-executor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAKxE,MAAM,WAAW,2BAA2B;IAC1C,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAWD,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,2BAA2B,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAmB7G"}

package/sdk/dist/query/query-fallback-executor.js

@@ -0,0 +1,31 @@
+import { formatSuccess } from './query-dispatch-formatting.js';
+import { mapFallbackDispatchError, toDispatchFailure } from './query-dispatch-error-mapper.js';
+import { runFallbackBridge } from './query-fallback-bridge-adapter.js';
+import { fallbackBridgeNotices } from './query-dispatch-observability.js';
+function formatFallbackOutput(data, mode, pickField) {
+    if (mode === 'text') {
+        const text = String(data ?? '');
+        if (!text.trim())
+            return undefined;
+    }
+    return formatSuccess(data, mode, pickField);
+}
+export async function runCjsFallbackDispatch(input) {
+    const { projectDir, gtdToolsPath, normCmd, normArgs, ws, pickField } = input;
+    const stderr = fallbackBridgeNotices(normCmd);
+    try {
+        const fallback = await runFallbackBridge({ projectDir, gtdToolsPath, normCmd, normArgs, ws });
+        if (fallback.stderr.trim())
+            stderr.push(fallback.stderr.trimEnd());
+        return {
+            ok: true,
+            stderr,
+            stdout: formatFallbackOutput(fallback.output, fallback.mode, pickField) ?? '',
+            exit_code: 0,
+        };
+    }
+    catch (err) {
+        return toDispatchFailure(mapFallbackDispatchError(err, normCmd, normArgs), stderr);
+    }
+}
+//# sourceMappingURL=query-fallback-executor.js.map

package/sdk/dist/query/query-fallback-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-fallback-executor.js","sourceRoot":"","sources":["../../src/query/query-fallback-executor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAE/D,OAAO,EAAE,wBAAwB,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC/F,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAC;AAY1E,SAAS,oBAAoB,CAAC,IAAa,EAAE,IAAqB,EAAE,SAAkB;IACpF,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAChC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,OAAO,SAAS,CAAC;IACrC,CAAC;IACD,OAAO,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,KAAkC;IAC7E,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC;IAC7E,MAAM,MAAM,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAE9C,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9F,IAAI,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE;YAAE,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE,OAAO;YACL,EAAE,EAAE,IAAI;YACR,MAAM;YACN,MAAM,EAAE,oBAAoB,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE;YAC7E,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,iBAAiB,CACtB,wBAAwB,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,CAAC,EAChD,MAAM,CACP,CAAC;IACJ,CAAC;AACH,CAAC"}

package/sdk/dist/query/query-fallback-output-classifier.d.ts

@@ -0,0 +1,6 @@
+export interface FallbackOutputClassification {
+    mode: 'json' | 'text';
+    output: unknown;
+}
+export declare function classifyFallbackOutput(raw: string, projectDir: string): Promise<FallbackOutputClassification>;
+//# sourceMappingURL=query-fallback-output-classifier.d.ts.map

package/sdk/dist/query/query-fallback-output-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-fallback-output-classifier.d.ts","sourceRoot":"","sources":["../../src/query/query-fallback-output-classifier.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;CACjB;AAeD,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAUnH"}

package/sdk/dist/query/query-fallback-output-classifier.js

@@ -0,0 +1,27 @@
+import { readFile } from 'node:fs/promises';
+async function parseCliQueryJsonOutput(raw, projectDir) {
+    const trimmed = raw.trim();
+    if (trimmed === '')
+        return null;
+    let jsonStr = trimmed;
+    if (jsonStr.startsWith('@file:')) {
+        const rel = jsonStr.slice(6).trim();
+        const { resolvePathUnderProject } = await import('./helpers.js');
+        const filePath = await resolvePathUnderProject(projectDir, rel);
+        jsonStr = await readFile(filePath, 'utf-8');
+    }
+    return JSON.parse(jsonStr);
+}
+export async function classifyFallbackOutput(raw, projectDir) {
+    if (raw.trim() === '') {
+        return { mode: 'text', output: raw };
+    }
+    try {
+        const output = await parseCliQueryJsonOutput(raw, projectDir);
+        return { mode: 'json', output };
+    }
+    catch {
+        return { mode: 'text', output: raw };
+    }
+}
+//# sourceMappingURL=query-fallback-output-classifier.js.map

package/sdk/dist/query/query-fallback-output-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-fallback-output-classifier.js","sourceRoot":"","sources":["../../src/query/query-fallback-output-classifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAO5C,KAAK,UAAU,uBAAuB,CAAC,GAAW,EAAE,UAAkB;IACpE,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAChC,IAAI,OAAO,GAAG,OAAO,CAAC;IACtB,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,EAAE,uBAAuB,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QACjE,MAAM,QAAQ,GAAG,MAAM,uBAAuB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;QAChE,OAAO,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,GAAW,EAAE,UAAkB;IAC1E,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IACvC,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAC9D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IACvC,CAAC;AACH,CAAC"}

package/sdk/dist/query/query-fallback-policy.d.ts

@@ -0,0 +1,6 @@
+export interface FallbackPolicyState {
+    cjsFallbackEnabled: boolean;
+}
+export declare function describeFallbackDisabledPolicy(): string;
+export declare function canUseCjsFallback(policy: FallbackPolicyState): boolean;
+//# sourceMappingURL=query-fallback-policy.d.ts.map

package/sdk/dist/query/query-fallback-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-fallback-policy.d.ts","sourceRoot":"","sources":["../../src/query/query-fallback-policy.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AAED,wBAAgB,8BAA8B,IAAI,MAAM,CAEvD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,GAAG,OAAO,CAEtE"}

package/sdk/dist/query/query-fallback-policy.js

@@ -0,0 +1,7 @@
+export function describeFallbackDisabledPolicy() {
+    return 'CJS fallback is disabled (GTD_QUERY_FALLBACK=registered).';
+}
+export function canUseCjsFallback(policy) {
+    return policy.cjsFallbackEnabled;
+}
+//# sourceMappingURL=query-fallback-policy.js.map

package/sdk/dist/query/query-fallback-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-fallback-policy.js","sourceRoot":"","sources":["../../src/query/query-fallback-policy.ts"],"names":[],"mappings":"AAIA,MAAM,UAAU,8BAA8B;IAC5C,OAAO,2DAA2D,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,MAA2B;IAC3D,OAAO,MAAM,CAAC,kBAAkB,CAAC;AACnC,CAAC"}

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

@@ -0,0 +1,7 @@
+import type { QueryRegistry } from './registry.js';
+import type { QueryResult } from './utils.js';
+export interface QueryNativeDispatchAdapter {
+    dispatch(command: string, args: string[]): Promise<QueryResult>;
+}
+export declare function createQueryNativeDispatchAdapter(registry: QueryRegistry, projectDir: string, ws?: string): QueryNativeDispatchAdapter;
+//# sourceMappingURL=query-native-dispatch-adapter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-native-dispatch-adapter.d.ts","sourceRoot":"","sources":["../../src/query/query-native-dispatch-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACjE;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,aAAa,EACvB,UAAU,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,MAAM,GACV,0BAA0B,CAI5B"}

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

@@ -0,0 +1,6 @@
+export function createQueryNativeDispatchAdapter(registry, projectDir, ws) {
+    return {
+        dispatch: (command, args) => registry.dispatch(command, args, projectDir, ws),
+    };
+}
+//# sourceMappingURL=query-native-dispatch-adapter.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query-native-dispatch-adapter.js","sourceRoot":"","sources":["../../src/query/query-native-dispatch-adapter.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,gCAAgC,CAC9C,QAAuB,EACvB,UAAkB,EAClB,EAAW;IAEX,OAAO;QACL,QAAQ,EAAE,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,CAAC;KAC9E,CAAC;AACJ,CAAC"}

package/sdk/dist/query/query-policy-capability.d.ts

@@ -0,0 +1,10 @@
+export declare const QUERY_MUTATION_COMMAND_LIST: readonly string[];
+export declare const TRANSPORT_RAW_COMMANDS: readonly string[];
+export declare const QUERY_POLICY_SNAPSHOT: {
+    readonly mutation_commands: readonly string[];
+    readonly raw_output_commands: readonly string[];
+};
+export declare function supportsMutationCommand(command: string): boolean;
+export declare function supportsRawOutputCommand(command: string): boolean;
+export declare function isQueryMutationCommand(command: string): boolean;
+//# sourceMappingURL=query-policy-capability.d.ts.map

package/sdk/dist/query/query-policy-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-policy-capability.d.ts","sourceRoot":"","sources":["../../src/query/query-policy-capability.ts"],"names":[],"mappings":"AAOA,eAAO,MAAM,2BAA2B,EAAE,SAAS,MAAM,EAA6C,CAAC;AACvG,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAA4C,CAAC;AAEjG,eAAO,MAAM,qBAAqB;;;CAGxB,CAAC;AAEX,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEhE;AAED,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAE/D"}

package/sdk/dist/query/query-policy-capability.js

@@ -0,0 +1,17 @@
+import { QUERY_MUTATION_COMMANDS_FROM_DEFINITIONS, TRANSPORT_RAW_COMMANDS_FROM_DEFINITIONS, COMMAND_MUTATION_SET, COMMAND_RAW_OUTPUT_SET, } from './command-definition.js';
+export const QUERY_MUTATION_COMMAND_LIST = QUERY_MUTATION_COMMANDS_FROM_DEFINITIONS;
+export const TRANSPORT_RAW_COMMANDS = TRANSPORT_RAW_COMMANDS_FROM_DEFINITIONS;
+export const QUERY_POLICY_SNAPSHOT = {
+    mutation_commands: QUERY_MUTATION_COMMAND_LIST,
+    raw_output_commands: TRANSPORT_RAW_COMMANDS,
+};
+export function supportsMutationCommand(command) {
+    return COMMAND_MUTATION_SET.has(command);
+}
+export function supportsRawOutputCommand(command) {
+    return COMMAND_RAW_OUTPUT_SET.has(command);
+}
+export function isQueryMutationCommand(command) {
+    return COMMAND_MUTATION_SET.has(command);
+}
+//# sourceMappingURL=query-policy-capability.js.map

package/sdk/dist/query/query-policy-capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-policy-capability.js","sourceRoot":"","sources":["../../src/query/query-policy-capability.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,wCAAwC,EACxC,uCAAuC,EACvC,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,CAAC,MAAM,2BAA2B,GAAsB,wCAAwC,CAAC;AACvG,MAAM,CAAC,MAAM,sBAAsB,GAAsB,uCAAuC,CAAC;AAEjG,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,iBAAiB,EAAE,2BAA2B;IAC9C,mBAAmB,EAAE,sBAAsB;CACnC,CAAC;AAEX,MAAM,UAAU,uBAAuB,CAAC,OAAe;IACrD,OAAO,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,OAAe;IACtD,OAAO,sBAAsB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,OAAe;IACpD,OAAO,oBAAoB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC3C,CAAC"}