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

package/sdk/dist/query/query-runtime-context.d.ts

@@ -0,0 +1,19 @@
+export interface QueryRuntimeContextInput {
+    projectDir: string;
+    ws?: string;
+}
+export interface QueryRuntimeContext {
+    projectDir: string;
+    ws?: string;
+}
+/**
+ * Resolve the runtime context for a query invocation.
+ *
+ * Workstream resolution priority:
+ *   1. `--ws <name>` flag (input.ws)
+ *   2. `GTD_WORKSTREAM` environment variable
+ *   3. `.planning/active-workstream` file
+ *   4. Root `.planning/` (no workstream)
+ */
+export declare function resolveQueryRuntimeContext(input: QueryRuntimeContextInput): QueryRuntimeContext;
+//# sourceMappingURL=query-runtime-context.d.ts.map

package/sdk/dist/query/query-runtime-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-runtime-context.d.ts","sourceRoot":"","sources":["../../src/query/query-runtime-context.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,wBAAwB,GAAG,mBAAmB,CAoB/F"}

package/sdk/dist/query/query-runtime-context.js

@@ -0,0 +1,31 @@
+import { findProjectRoot } from './helpers.js';
+import { validateWorkstreamName } from '../workstream-utils.js';
+import { readActiveWorkstream } from './active-workstream-store.js';
+/**
+ * Resolve the runtime context for a query invocation.
+ *
+ * Workstream resolution priority:
+ *   1. `--ws <name>` flag (input.ws)
+ *   2. `GTD_WORKSTREAM` environment variable
+ *   3. `.planning/active-workstream` file
+ *   4. Root `.planning/` (no workstream)
+ */
+export function resolveQueryRuntimeContext(input) {
+    const projectDir = findProjectRoot(input.projectDir);
+    if (input.ws !== undefined) {
+        return {
+            projectDir,
+            ws: validateWorkstreamName(input.ws) ? input.ws : undefined,
+        };
+    }
+    const envWs = process.env.GTD_WORKSTREAM;
+    if (envWs && validateWorkstreamName(envWs)) {
+        return { projectDir, ws: envWs };
+    }
+    const fileWs = readActiveWorkstream(projectDir);
+    return {
+        projectDir,
+        ws: fileWs ?? undefined,
+    };
+}
+//# sourceMappingURL=query-runtime-context.js.map

package/sdk/dist/query/query-runtime-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-runtime-context.js","sourceRoot":"","sources":["../../src/query/query-runtime-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAYpE;;;;;;;;GAQG;AACH,MAAM,UAAU,0BAA0B,CAAC,KAA+B;IACxE,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAErD,IAAI,KAAK,CAAC,EAAE,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO;YACL,UAAU;YACV,EAAE,EAAE,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS;SAC5D,CAAC;IACJ,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IACzC,IAAI,KAAK,IAAI,sBAAsB,CAAC,KAAK,CAAC,EAAE,CAAC;QAC3C,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;IACnC,CAAC;IAED,MAAM,MAAM,GAAG,oBAAoB,CAAC,UAAU,CAAC,CAAC;IAChD,OAAO;QACL,UAAU;QACV,EAAE,EAAE,MAAM,IAAI,SAAS;KACxB,CAAC;AACJ,CAAC"}

package/sdk/dist/query/query-unknown-command-hints.d.ts

@@ -0,0 +1,2 @@
+export declare const UNKNOWN_COMMAND_HINTS: readonly string[];
+//# sourceMappingURL=query-unknown-command-hints.d.ts.map

package/sdk/dist/query/query-unknown-command-hints.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-unknown-command-hints.d.ts","sourceRoot":"","sources":["../../src/query/query-unknown-command-hints.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAIzC,CAAC"}

package/sdk/dist/query/query-unknown-command-hints.js

@@ -0,0 +1,6 @@
+export const UNKNOWN_COMMAND_HINTS = [
+    'Use a registered `gtd-sdk query` subcommand (see sdk/src/query/QUERY-HANDLERS.md).',
+    'Invoke `node …/gtd-tools.cjs` for CJS-only operations.',
+    'Unset GTD_QUERY_FALLBACK or set it to a non-restricted value to enable fallback.',
+];
+//# sourceMappingURL=query-unknown-command-hints.js.map

package/sdk/dist/query/query-unknown-command-hints.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-unknown-command-hints.js","sourceRoot":"","sources":["../../src/query/query-unknown-command-hints.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACtD,oFAAoF;IACpF,wDAAwD;IACxD,kFAAkF;CAC1E,CAAC"}

package/sdk/dist/query/registry-assembly-descriptor.d.ts

@@ -0,0 +1,12 @@
+import type { CommandFamily } from './command-manifest.types.js';
+import type { RegistryAssemblyAliasGroup, RegistryAssemblyStaticGroup } from './registry-assembly-invariants.js';
+export interface RegistryAssemblyStep {
+    kind: 'static' | 'alias';
+    key: string;
+}
+export declare const STATIC_CATALOG_GROUPS: readonly RegistryAssemblyStaticGroup[];
+export declare const ALIAS_GROUPS: readonly RegistryAssemblyAliasGroup[];
+export declare const STATIC_GROUP_BY_NAME: Readonly<Record<string, RegistryAssemblyStaticGroup>>;
+export declare const ALIAS_GROUP_BY_FAMILY: Readonly<Record<CommandFamily, RegistryAssemblyAliasGroup>>;
+export declare const REGISTRY_ASSEMBLY_PLAN: readonly RegistryAssemblyStep[];
+//# sourceMappingURL=registry-assembly-descriptor.d.ts.map

package/sdk/dist/query/registry-assembly-descriptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-assembly-descriptor.d.ts","sourceRoot":"","sources":["../../src/query/registry-assembly-descriptor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAYjE,OAAO,KAAK,EAAE,0BAA0B,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAEjH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;CACb;AA2BD,eAAO,MAAM,qBAAqB,EAAE,SAAS,2BAA2B,EAO9D,CAAC;AAEX,eAAO,MAAM,YAAY,EAAE,SAAS,0BAA0B,EAQpD,CAAC;AAEX,eAAO,MAAM,oBAAoB,EAE5B,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC,CAAC;AAE3D,eAAO,MAAM,qBAAqB,EAE7B,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,0BAA0B,CAAC,CAAC,CAAC;AAEjE,eAAO,MAAM,sBAAsB,EAAE,SAAS,oBAAoB,EAcxD,CAAC"}

package/sdk/dist/query/registry-assembly-descriptor.js

@@ -0,0 +1,61 @@
+import { FOUNDATION_STATIC_CATALOG, STATE_SUPPORT_STATIC_CATALOG, MUTATION_SURFACES_STATIC_CATALOG, VERIFY_DECISION_STATIC_CATALOG, DECISION_ROUTING_STATIC_CATALOG, } from './command-static-catalog-foundation.js';
+import { DOMAIN_STATIC_CATALOG } from './command-static-catalog-domain.js';
+import { COMMAND_DEFINITIONS_BY_FAMILY } from './command-definition.js';
+import { FAMILY_HANDLERS } from './command-family-handlers.js';
+function toAliasCatalogEntry(entry) {
+    return {
+        canonical: entry.canonical,
+        aliases: entry.aliases,
+    };
+}
+function buildAliasGroup(family) {
+    const definitions = COMMAND_DEFINITIONS_BY_FAMILY[family];
+    const familyHandlers = FAMILY_HANDLERS[family];
+    const handlers = {};
+    for (const entry of definitions) {
+        const handler = familyHandlers[entry.handler_key];
+        if (!handler)
+            continue;
+        handlers[entry.canonical] = handler;
+    }
+    return {
+        family,
+        aliases: definitions.map(toAliasCatalogEntry),
+        handlers,
+    };
+}
+export const STATIC_CATALOG_GROUPS = [
+    { name: 'FOUNDATION_STATIC_CATALOG', entries: FOUNDATION_STATIC_CATALOG },
+    { name: 'STATE_SUPPORT_STATIC_CATALOG', entries: STATE_SUPPORT_STATIC_CATALOG },
+    { name: 'MUTATION_SURFACES_STATIC_CATALOG', entries: MUTATION_SURFACES_STATIC_CATALOG },
+    { name: 'VERIFY_DECISION_STATIC_CATALOG', entries: VERIFY_DECISION_STATIC_CATALOG },
+    { name: 'DECISION_ROUTING_STATIC_CATALOG', entries: DECISION_ROUTING_STATIC_CATALOG },
+    { name: 'DOMAIN_STATIC_CATALOG', entries: DOMAIN_STATIC_CATALOG },
+];
+export const ALIAS_GROUPS = [
+    buildAliasGroup('state'),
+    buildAliasGroup('roadmap'),
+    buildAliasGroup('verify'),
+    buildAliasGroup('validate'),
+    buildAliasGroup('phase'),
+    buildAliasGroup('phases'),
+    buildAliasGroup('init'),
+];
+export const STATIC_GROUP_BY_NAME = Object.fromEntries(STATIC_CATALOG_GROUPS.map((group) => [group.name, group]));
+export const ALIAS_GROUP_BY_FAMILY = Object.fromEntries(ALIAS_GROUPS.map((group) => [group.family, group]));
+export const REGISTRY_ASSEMBLY_PLAN = [
+    { kind: 'static', key: 'FOUNDATION_STATIC_CATALOG' },
+    { kind: 'alias', key: 'state' },
+    { kind: 'static', key: 'STATE_SUPPORT_STATIC_CATALOG' },
+    { kind: 'alias', key: 'roadmap' },
+    { kind: 'static', key: 'MUTATION_SURFACES_STATIC_CATALOG' },
+    { kind: 'alias', key: 'verify' },
+    { kind: 'static', key: 'VERIFY_DECISION_STATIC_CATALOG' },
+    { kind: 'alias', key: 'validate' },
+    { kind: 'static', key: 'DECISION_ROUTING_STATIC_CATALOG' },
+    { kind: 'alias', key: 'phase' },
+    { kind: 'alias', key: 'phases' },
+    { kind: 'alias', key: 'init' },
+    { kind: 'static', key: 'DOMAIN_STATIC_CATALOG' },
+];
+//# sourceMappingURL=registry-assembly-descriptor.js.map

package/sdk/dist/query/registry-assembly-descriptor.js.map

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

package/sdk/dist/query/registry-assembly-invariants.d.ts

@@ -0,0 +1,30 @@
+import type { QueryRegistry } from './registry.js';
+import type { QueryHandler } from './utils.js';
+import type { AliasCatalogEntry } from './command-catalog.js';
+export interface RegistryAssemblyAliasGroup {
+    family: string;
+    aliases: readonly AliasCatalogEntry[];
+    handlers: Readonly<Record<string, QueryHandler>>;
+}
+export interface RegistryAssemblyStaticGroup {
+    name: string;
+    entries: ReadonlyArray<readonly [command: string, handler: QueryHandler]>;
+}
+export interface RegistryAssemblyInputs {
+    staticGroups: readonly RegistryAssemblyStaticGroup[];
+    aliasGroups: readonly RegistryAssemblyAliasGroup[];
+    mutationCommands: ReadonlySet<string>;
+    rawOutputPolicyCommands: readonly string[];
+}
+export interface RegistryAssemblyInvariantReport {
+    duplicateCommandKeys: string[];
+    aliasCanonicalsMissingHandlers: string[];
+    missingMutationCommands: string[];
+    missingRawOutputPolicyCommands: string[];
+}
+export declare function collectRegistryAssemblyInvariantReport(inputs: RegistryAssemblyInputs, registry?: QueryRegistry): RegistryAssemblyInvariantReport;
+export declare function assertNoDuplicateRegisteredCommands(inputs: RegistryAssemblyInputs): void;
+export declare function assertAliasCanonicalsHaveHandlers(inputs: RegistryAssemblyInputs): void;
+export declare function assertMutationCommandsRegistered(registry: QueryRegistry, mutationCommands: ReadonlySet<string>): void;
+export declare function assertRawOutputPolicyCommandsRegistered(registry: QueryRegistry, rawOutputPolicyCommands: readonly string[]): void;
+//# sourceMappingURL=registry-assembly-invariants.d.ts.map

package/sdk/dist/query/registry-assembly-invariants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-assembly-invariants.d.ts","sourceRoot":"","sources":["../../src/query/registry-assembly-invariants.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,MAAM,WAAW,0BAA0B;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IACtC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,2BAA2B;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,aAAa,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC;CAC3E;AAED,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,SAAS,2BAA2B,EAAE,CAAC;IACrD,WAAW,EAAE,SAAS,0BAA0B,EAAE,CAAC;IACnD,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACtC,uBAAuB,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,+BAA+B;IAC9C,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,8BAA8B,EAAE,MAAM,EAAE,CAAC;IACzC,uBAAuB,EAAE,MAAM,EAAE,CAAC;IAClC,8BAA8B,EAAE,MAAM,EAAE,CAAC;CAC1C;AAED,wBAAgB,sCAAsC,CACpD,MAAM,EAAE,sBAAsB,EAC9B,QAAQ,CAAC,EAAE,aAAa,GACvB,+BAA+B,CA8CjC;AAMD,wBAAgB,mCAAmC,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAKxF;AAED,wBAAgB,iCAAiC,CAAC,MAAM,EAAE,sBAAsB,GAAG,IAAI,CAKtF;AAED,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,aAAa,EACvB,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,GACpC,IAAI,CAUN;AAED,wBAAgB,uCAAuC,CACrD,QAAQ,EAAE,aAAa,EACvB,uBAAuB,EAAE,SAAS,MAAM,EAAE,GACzC,IAAI,CAUN"}

package/sdk/dist/query/registry-assembly-invariants.js

@@ -0,0 +1,77 @@
+export function collectRegistryAssemblyInvariantReport(inputs, registry) {
+    const counts = new Map();
+    for (const group of inputs.staticGroups) {
+        for (const [command] of group.entries) {
+            counts.set(command, (counts.get(command) ?? 0) + 1);
+        }
+    }
+    for (const group of inputs.aliasGroups) {
+        for (const entry of group.aliases) {
+            counts.set(entry.canonical, (counts.get(entry.canonical) ?? 0) + 1);
+            for (const alias of entry.aliases) {
+                counts.set(alias, (counts.get(alias) ?? 0) + 1);
+            }
+        }
+    }
+    const duplicateCommandKeys = toSortedList(Array.from(counts.entries())
+        .filter(([, count]) => count > 1)
+        .map(([command]) => command));
+    const aliasCanonicalsMissingHandlers = [];
+    for (const group of inputs.aliasGroups) {
+        for (const entry of group.aliases) {
+            if (!group.handlers[entry.canonical]) {
+                aliasCanonicalsMissingHandlers.push(`${group.family}:${entry.canonical}`);
+            }
+        }
+    }
+    const missingMutationCommands = registry
+        ? toSortedList(Array.from(inputs.mutationCommands).filter((command) => !registry.has(command)))
+        : [];
+    const missingRawOutputPolicyCommands = registry
+        ? toSortedList(inputs.rawOutputPolicyCommands.filter((command) => !registry.has(command)))
+        : [];
+    return {
+        duplicateCommandKeys,
+        aliasCanonicalsMissingHandlers: toSortedList(aliasCanonicalsMissingHandlers),
+        missingMutationCommands,
+        missingRawOutputPolicyCommands,
+    };
+}
+function toSortedList(values) {
+    return Array.from(values).sort((a, b) => a.localeCompare(b));
+}
+export function assertNoDuplicateRegisteredCommands(inputs) {
+    const report = collectRegistryAssemblyInvariantReport(inputs);
+    if (report.duplicateCommandKeys.length > 0) {
+        throw new Error(`registry assembly invariant failed: duplicate command keys: ${report.duplicateCommandKeys.join(', ')}`);
+    }
+}
+export function assertAliasCanonicalsHaveHandlers(inputs) {
+    const report = collectRegistryAssemblyInvariantReport(inputs);
+    if (report.aliasCanonicalsMissingHandlers.length > 0) {
+        throw new Error(`registry assembly invariant failed: alias canonical missing handler: ${report.aliasCanonicalsMissingHandlers.join(', ')}`);
+    }
+}
+export function assertMutationCommandsRegistered(registry, mutationCommands) {
+    const report = collectRegistryAssemblyInvariantReport({
+        staticGroups: [],
+        aliasGroups: [],
+        mutationCommands,
+        rawOutputPolicyCommands: [],
+    }, registry);
+    if (report.missingMutationCommands.length > 0) {
+        throw new Error(`registry assembly invariant failed: mutation command missing from registry: ${report.missingMutationCommands.join(', ')}`);
+    }
+}
+export function assertRawOutputPolicyCommandsRegistered(registry, rawOutputPolicyCommands) {
+    const report = collectRegistryAssemblyInvariantReport({
+        staticGroups: [],
+        aliasGroups: [],
+        mutationCommands: new Set(),
+        rawOutputPolicyCommands,
+    }, registry);
+    if (report.missingRawOutputPolicyCommands.length > 0) {
+        throw new Error(`registry assembly invariant failed: raw-output policy command missing from registry: ${report.missingRawOutputPolicyCommands.join(', ')}`);
+    }
+}
+//# sourceMappingURL=registry-assembly-invariants.js.map

package/sdk/dist/query/registry-assembly-invariants.js.map

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

package/sdk/dist/query/registry-assembly.d.ts

@@ -0,0 +1,10 @@
+import { QueryRegistry } from './registry.js';
+import { GTDEventStream } from '../event-stream.js';
+/**
+ * Command names that perform durable writes (disk, git, or global profile store).
+ */
+export declare const QUERY_MUTATION_COMMANDS: Set<string>;
+export declare function buildRegistry(): QueryRegistry;
+export declare function decorateRegistryMutations(registry: QueryRegistry, eventStream?: GTDEventStream, correlationSessionId?: string): void;
+export declare function createRegistry(eventStream?: GTDEventStream, correlationSessionId?: string): QueryRegistry;
+//# sourceMappingURL=registry-assembly.d.ts.map

package/sdk/dist/query/registry-assembly.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-assembly.d.ts","sourceRoot":"","sources":["../../src/query/registry-assembly.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAkBpD;;GAEG;AACH,eAAO,MAAM,uBAAuB,aAA+C,CAAC;AAGpF,wBAAgB,aAAa,IAAI,aAAa,CAiC7C;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,aAAa,EACvB,WAAW,CAAC,EAAE,cAAc,EAC5B,oBAAoB,CAAC,EAAE,MAAM,GAC5B,IAAI,CAIN;AAED,wBAAgB,cAAc,CAC5B,WAAW,CAAC,EAAE,cAAc,EAC5B,oBAAoB,CAAC,EAAE,MAAM,GAC5B,aAAa,CAIf"}

package/sdk/dist/query/registry-assembly.js

@@ -0,0 +1,53 @@
+import { QueryRegistry } from './registry.js';
+import { registerAliasCatalog, registerStaticCatalog } from './command-catalog.js';
+import { QUERY_MUTATION_COMMAND_LIST, TRANSPORT_RAW_COMMANDS } from './query-policy-capability.js';
+import { decorateMutationsWithEvents } from './mutation-event-decorator.js';
+import { STATIC_CATALOG_GROUPS, ALIAS_GROUPS, STATIC_GROUP_BY_NAME, ALIAS_GROUP_BY_FAMILY, REGISTRY_ASSEMBLY_PLAN, } from './registry-assembly-descriptor.js';
+import { assertAliasCanonicalsHaveHandlers, assertMutationCommandsRegistered, assertNoDuplicateRegisteredCommands, assertRawOutputPolicyCommandsRegistered, } from './registry-assembly-invariants.js';
+/**
+ * Command names that perform durable writes (disk, git, or global profile store).
+ */
+export const QUERY_MUTATION_COMMANDS = new Set(QUERY_MUTATION_COMMAND_LIST);
+export function buildRegistry() {
+    assertAliasCanonicalsHaveHandlers({
+        staticGroups: STATIC_CATALOG_GROUPS,
+        aliasGroups: ALIAS_GROUPS,
+        mutationCommands: QUERY_MUTATION_COMMANDS,
+        rawOutputPolicyCommands: TRANSPORT_RAW_COMMANDS,
+    });
+    assertNoDuplicateRegisteredCommands({
+        staticGroups: STATIC_CATALOG_GROUPS,
+        aliasGroups: ALIAS_GROUPS,
+        mutationCommands: QUERY_MUTATION_COMMANDS,
+        rawOutputPolicyCommands: TRANSPORT_RAW_COMMANDS,
+    });
+    const registry = new QueryRegistry();
+    for (const step of REGISTRY_ASSEMBLY_PLAN) {
+        if (step.kind === 'static') {
+            const group = STATIC_GROUP_BY_NAME[step.key];
+            if (!group)
+                throw new Error(`registry assembly invariant failed: unknown static group: ${step.key}`);
+            registerStaticCatalog(registry, group.entries);
+            continue;
+        }
+        const group = ALIAS_GROUP_BY_FAMILY[step.key];
+        if (!group)
+            throw new Error(`registry assembly invariant failed: unknown alias group: ${step.key}`);
+        registerAliasCatalog(registry, group.aliases, group.handlers);
+    }
+    assertMutationCommandsRegistered(registry, QUERY_MUTATION_COMMANDS);
+    assertRawOutputPolicyCommandsRegistered(registry, TRANSPORT_RAW_COMMANDS);
+    return registry;
+}
+export function decorateRegistryMutations(registry, eventStream, correlationSessionId) {
+    if (!eventStream)
+        return;
+    const mutationSessionId = correlationSessionId ?? '';
+    decorateMutationsWithEvents(registry, QUERY_MUTATION_COMMANDS, eventStream, mutationSessionId);
+}
+export function createRegistry(eventStream, correlationSessionId) {
+    const registry = buildRegistry();
+    decorateRegistryMutations(registry, eventStream, correlationSessionId);
+    return registry;
+}
+//# sourceMappingURL=registry-assembly.js.map

package/sdk/dist/query/registry-assembly.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-assembly.js","sourceRoot":"","sources":["../../src/query/registry-assembly.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AACnF,OAAO,EAAE,2BAA2B,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACnG,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EACL,qBAAqB,EACrB,YAAY,EACZ,oBAAoB,EACpB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,iCAAiC,EACjC,gCAAgC,EAChC,mCAAmC,EACnC,uCAAuC,GACxC,MAAM,mCAAmC,CAAC;AAE3C;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAS,2BAA2B,CAAC,CAAC;AAGpF,MAAM,UAAU,aAAa;IAC3B,iCAAiC,CAAC;QAChC,YAAY,EAAE,qBAAqB;QACnC,WAAW,EAAE,YAAY;QACzB,gBAAgB,EAAE,uBAAuB;QACzC,uBAAuB,EAAE,sBAAsB;KAChD,CAAC,CAAC;IACH,mCAAmC,CAAC;QAClC,YAAY,EAAE,qBAAqB;QACnC,WAAW,EAAE,YAAY;QACzB,gBAAgB,EAAE,uBAAuB;QACzC,uBAAuB,EAAE,sBAAsB;KAChD,CAAC,CAAC;IAEH,MAAM,QAAQ,GAAG,IAAI,aAAa,EAAE,CAAC;IAErC,KAAK,MAAM,IAAI,IAAI,sBAAsB,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC3B,MAAM,KAAK,GAAG,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC7C,IAAI,CAAC,KAAK;gBAAE,MAAM,IAAI,KAAK,CAAC,6DAA6D,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;YACrG,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;YAC/C,SAAS;QACX,CAAC;QAED,MAAM,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,GAAyC,CAAC,CAAC;QACpF,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,4DAA4D,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACpG,oBAAoB,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChE,CAAC;IAED,gCAAgC,CAAC,QAAQ,EAAE,uBAAuB,CAAC,CAAC;IACpE,uCAAuC,CAAC,QAAQ,EAAE,sBAAsB,CAAC,CAAC;IAE1E,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,QAAuB,EACvB,WAA4B,EAC5B,oBAA6B;IAE7B,IAAI,CAAC,WAAW;QAAE,OAAO;IACzB,MAAM,iBAAiB,GAAG,oBAAoB,IAAI,EAAE,CAAC;IACrD,2BAA2B,CAAC,QAAQ,EAAE,uBAAuB,EAAE,WAAW,EAAE,iBAAiB,CAAC,CAAC;AACjG,CAAC;AAED,MAAM,UAAU,cAAc,CAC5B,WAA4B,EAC5B,oBAA6B;IAE7B,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,yBAAyB,CAAC,QAAQ,EAAE,WAAW,EAAE,oBAAoB,CAAC,CAAC;IACvE,OAAO,QAAQ,CAAC;AAClB,CAAC"}

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

@@ -0,0 +1,90 @@
+/**
+ * Query command registry — routes commands to native SDK handlers.
+ *
+ * The registry is a flat `Map<string, QueryHandler>` that maps command names
+ * to handler functions. Unknown keys passed to `dispatch()` throw `GTDError`.
+ * The `gtd-sdk query` CLI resolves argv with `resolveQueryArgv()` before dispatch;
+ * there is no automatic delegation to `gtd-tools.cjs`.
+ *
+ * Also exports `extractField` — a TypeScript port of the `--pick` field
+ * extraction logic from gtd-tools.cjs (lines 365-382).
+ *
+ * @example
+ * ```typescript
+ * import { QueryRegistry, extractField } from './registry.js';
+ *
+ * const registry = new QueryRegistry();
+ * registry.register('generate-slug', generateSlug);
+ * const result = await registry.dispatch('generate-slug', ['My Phase'], '/project');
+ * const slug = extractField(result.data, 'slug'); // 'my-phase'
+ * ```
+ */
+import type { QueryResult, QueryHandler } from './utils.js';
+/**
+ * Extract a nested field from an object using dot-notation and bracket syntax.
+ *
+ * Direct port of `extractField()` from gtd-tools.cjs (lines 365-382).
+ * Supports `a.b.c` dot paths, `items[0]` array indexing, and `items[-1]`
+ * negative indexing.
+ *
+ * @param obj - The object to extract from
+ * @param fieldPath - Dot-separated path with optional bracket notation
+ * @returns The extracted value, or undefined if the path doesn't resolve
+ */
+export declare function extractField(obj: unknown, fieldPath: string): unknown;
+/**
+ * Flat command registry that routes query commands to native handlers.
+ *
+ * `dispatch()` throws `GTDError` for unknown command keys. The `gtd-sdk query`
+ * CLI uses `resolveQueryArgv()` first; when no handler matches, it may shell out
+ * to `gtd-tools.cjs` (see `cli.ts` and `QUERY-HANDLERS.md` fallback policy).
+ */
+export declare class QueryRegistry {
+    private handlers;
+    /**
+     * Register a native handler for a command name.
+     *
+     * @param command - The command name (e.g., 'generate-slug', 'state.load')
+     * @param handler - The handler function to invoke
+     */
+    register(command: string, handler: QueryHandler): void;
+    /**
+     * Check if a command has a registered native handler.
+     *
+     * @param command - The command name to check
+     * @returns True if the command has a native handler
+     */
+    has(command: string): boolean;
+    /**
+     * List all registered command names (for tooling, pipelines, and tests).
+     */
+    commands(): string[];
+    /**
+     * Get the handler for a command without dispatching.
+     *
+     * @param command - The command name to look up
+     * @returns The handler function, or undefined if not registered
+     */
+    getHandler(command: string): QueryHandler | undefined;
+    /**
+     * Dispatch a command to its registered native handler.
+     *
+     * @param command - The command name to dispatch
+     * @param args - Arguments to pass to the handler
+     * @param projectDir - The project directory for context
+     * @param workstream - Optional workstream name to scope .planning paths
+     * @returns The query result from the handler
+     * @throws GTDError if no handler is registered for the command
+     */
+    dispatch(command: string, args: string[], projectDir: string, workstream?: string): Promise<QueryResult>;
+}
+/**
+ * Map argv after `gtd-sdk query` to a registered handler key and remaining args.
+ * Longest-prefix match on dotted (`a.b.c`) and spaced (`a b c`) keys; if no match,
+ * expands a single dotted token (`state.validate` → `state`, `validate`) and retries.
+ */
+export declare function resolveQueryArgv(tokens: string[], registry: QueryRegistry): {
+    cmd: string;
+    args: string[];
+} | null;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/query/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM5D;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAiBrE;AAID;;;;;;GAMG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAmC;IAEnD;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;IAItD;;;;;OAKG;IACH,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAI7B;;OAEG;IACH,QAAQ,IAAI,MAAM,EAAE;IAIpB;;;;;OAKG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS;IAIrD;;;;;;;;;OASG;IACG,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;CAU/G;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EAAE,EAChB,QAAQ,EAAE,aAAa,GACtB;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,IAAI,CAIxC"}

package/sdk/dist/query/registry.js

@@ -0,0 +1,129 @@
+/**
+ * Query command registry — routes commands to native SDK handlers.
+ *
+ * The registry is a flat `Map<string, QueryHandler>` that maps command names
+ * to handler functions. Unknown keys passed to `dispatch()` throw `GTDError`.
+ * The `gtd-sdk query` CLI resolves argv with `resolveQueryArgv()` before dispatch;
+ * there is no automatic delegation to `gtd-tools.cjs`.
+ *
+ * Also exports `extractField` — a TypeScript port of the `--pick` field
+ * extraction logic from gtd-tools.cjs (lines 365-382).
+ *
+ * @example
+ * ```typescript
+ * import { QueryRegistry, extractField } from './registry.js';
+ *
+ * const registry = new QueryRegistry();
+ * registry.register('generate-slug', generateSlug);
+ * const result = await registry.dispatch('generate-slug', ['My Phase'], '/project');
+ * const slug = extractField(result.data, 'slug'); // 'my-phase'
+ * ```
+ */
+import { GTDError, ErrorClassification } from '../errors.js';
+import { resolveQueryTokens } from './query-command-resolution-strategy.js';
+// ─── extractField ──────────────────────────────────────────────────────────
+/**
+ * Extract a nested field from an object using dot-notation and bracket syntax.
+ *
+ * Direct port of `extractField()` from gtd-tools.cjs (lines 365-382).
+ * Supports `a.b.c` dot paths, `items[0]` array indexing, and `items[-1]`
+ * negative indexing.
+ *
+ * @param obj - The object to extract from
+ * @param fieldPath - Dot-separated path with optional bracket notation
+ * @returns The extracted value, or undefined if the path doesn't resolve
+ */
+export function extractField(obj, fieldPath) {
+    const parts = fieldPath.split('.');
+    let current = obj;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return undefined;
+        const bracketMatch = part.match(/^(.+?)\[(-?\d+)]$/);
+        if (bracketMatch) {
+            const key = bracketMatch[1];
+            const index = parseInt(bracketMatch[2], 10);
+            current = current[key];
+            if (!Array.isArray(current))
+                return undefined;
+            current = index < 0 ? current[current.length + index] : current[index];
+        }
+        else {
+            current = current[part];
+        }
+    }
+    return current;
+}
+// ─── QueryRegistry ─────────────────────────────────────────────────────────
+/**
+ * Flat command registry that routes query commands to native handlers.
+ *
+ * `dispatch()` throws `GTDError` for unknown command keys. The `gtd-sdk query`
+ * CLI uses `resolveQueryArgv()` first; when no handler matches, it may shell out
+ * to `gtd-tools.cjs` (see `cli.ts` and `QUERY-HANDLERS.md` fallback policy).
+ */
+export class QueryRegistry {
+    handlers = new Map();
+    /**
+     * Register a native handler for a command name.
+     *
+     * @param command - The command name (e.g., 'generate-slug', 'state.load')
+     * @param handler - The handler function to invoke
+     */
+    register(command, handler) {
+        this.handlers.set(command, handler);
+    }
+    /**
+     * Check if a command has a registered native handler.
+     *
+     * @param command - The command name to check
+     * @returns True if the command has a native handler
+     */
+    has(command) {
+        return this.handlers.has(command);
+    }
+    /**
+     * List all registered command names (for tooling, pipelines, and tests).
+     */
+    commands() {
+        return Array.from(this.handlers.keys());
+    }
+    /**
+     * Get the handler for a command without dispatching.
+     *
+     * @param command - The command name to look up
+     * @returns The handler function, or undefined if not registered
+     */
+    getHandler(command) {
+        return this.handlers.get(command);
+    }
+    /**
+     * Dispatch a command to its registered native handler.
+     *
+     * @param command - The command name to dispatch
+     * @param args - Arguments to pass to the handler
+     * @param projectDir - The project directory for context
+     * @param workstream - Optional workstream name to scope .planning paths
+     * @returns The query result from the handler
+     * @throws GTDError if no handler is registered for the command
+     */
+    async dispatch(command, args, projectDir, workstream) {
+        const handler = this.handlers.get(command);
+        if (!handler) {
+            throw new GTDError(`Unknown command: "${command}". No native handler registered.`, ErrorClassification.Validation);
+        }
+        return handler(args, projectDir, workstream);
+    }
+}
+/**
+ * Map argv after `gtd-sdk query` to a registered handler key and remaining args.
+ * Longest-prefix match on dotted (`a.b.c`) and spaced (`a b c`) keys; if no match,
+ * expands a single dotted token (`state.validate` → `state`, `validate`) and retries.
+ */
+export function resolveQueryArgv(tokens, registry) {
+    const resolved = resolveQueryTokens(tokens, registry);
+    if (!resolved)
+        return null;
+    return { cmd: resolved.cmd, args: resolved.args };
+}
+//# sourceMappingURL=registry.js.map

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

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

package/sdk/dist/query/requirements-extract-from-plans.d.ts

@@ -0,0 +1,9 @@
+/**
+ * requirements.extract-from-plans — aggregate `requirements` frontmatter across all plans in a phase.
+ */
+import type { QueryHandler } from './utils.js';
+/**
+ * Args: `<phase>`
+ */
+export declare const requirementsExtractFromPlans: QueryHandler;
+//# sourceMappingURL=requirements-extract-from-plans.d.ts.map

package/sdk/dist/query/requirements-extract-from-plans.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirements-extract-from-plans.d.ts","sourceRoot":"","sources":["../../src/query/requirements-extract-from-plans.ts"],"names":[],"mappings":"AAAA;;GAEG;AAYH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAyB/C;;GAEG;AACH,eAAO,MAAM,4BAA4B,EAAE,YA2C1C,CAAC"}