@opengsd/get-shit-done-redux 1.0.0

package/sdk/dist/prompt-builder.js.map

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

package/sdk/dist/prompt-sanitizer.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Prompt sanitizer — resolves @-file references and strips interactive CLI
+ * patterns from GSD-1 prompts so they're safe for headless SDK use.
+ *
+ * @-file references (e.g., @~/.claude/get-shit-done/references/foo.md) are
+ * resolved by reading the file and inlining the content. This preserves the
+ * critical instructions that the real agent prompts depend on.
+ *
+ * Patterns removed (interactive-only, not useful headless):
+ * - /gsd-... skill commands (can't invoke skills in Agent SDK)
+ * - AskUserQuestion(...) calls
+ * - STOP directives in interactive contexts
+ * - SlashCommand() calls
+ * - 'wait for user' / 'ask the user' instructions
+ */
+/**
+ * Resolve @-file references by reading the file and inlining the content.
+ * References that can't be resolved (file not found) are removed silently.
+ *
+ * @param input - Prompt text with @-references
+ * @param projectDir - Project directory for resolving relative paths
+ * @returns Prompt with @-references replaced by file contents
+ */
+export declare function resolveAtReferences(input: string, projectDir?: string): string;
+/**
+ * Sanitize a prompt for headless SDK use:
+ * 1. Resolve @-file references (inline the content)
+ * 2. Strip interactive-only patterns
+ *
+ * @param input - Raw prompt string from agent/workflow files
+ * @param projectDir - Project directory for resolving relative @-references
+ * @returns Cleaned prompt ready for Agent SDK use
+ */
+export declare function sanitizePrompt(input: string, projectDir?: string): string;
+//# sourceMappingURL=prompt-sanitizer.d.ts.map

package/sdk/dist/prompt-sanitizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-sanitizer.d.ts","sourceRoot":"","sources":["../src/prompt-sanitizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAkBH;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAkB9E;AAgCD;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,CAgBzE"}

package/sdk/dist/prompt-sanitizer.js

@@ -0,0 +1,101 @@
+/**
+ * Prompt sanitizer — resolves @-file references and strips interactive CLI
+ * patterns from GSD-1 prompts so they're safe for headless SDK use.
+ *
+ * @-file references (e.g., @~/.claude/get-shit-done/references/foo.md) are
+ * resolved by reading the file and inlining the content. This preserves the
+ * critical instructions that the real agent prompts depend on.
+ *
+ * Patterns removed (interactive-only, not useful headless):
+ * - /gsd-... skill commands (can't invoke skills in Agent SDK)
+ * - AskUserQuestion(...) calls
+ * - STOP directives in interactive contexts
+ * - SlashCommand() calls
+ * - 'wait for user' / 'ask the user' instructions
+ */
+import { readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+// ─── @-reference resolution ──────────────────────────────────────────────────
+/**
+ * Matches @-file references in prompt text. Handles:
+ * - @~/.claude/get-shit-done/references/foo.md
+ * - @~/.claude/get-shit-done/workflows/bar.md
+ * - @.planning/PROJECT.md (project-relative)
+ *
+ * Only resolves references that start a line or follow whitespace,
+ * not email addresses or @ mentions in prose.
+ */
+const AT_REFERENCE_PATTERN = /^(\s*)@(~\/[^\s]+|\.planning\/[^\s]+)/gm;
+/**
+ * Resolve @-file references by reading the file and inlining the content.
+ * References that can't be resolved (file not found) are removed silently.
+ *
+ * @param input - Prompt text with @-references
+ * @param projectDir - Project directory for resolving relative paths
+ * @returns Prompt with @-references replaced by file contents
+ */
+export function resolveAtReferences(input, projectDir) {
+    if (!input)
+        return input;
+    return input.replace(AT_REFERENCE_PATTERN, (_match, indent, refPath) => {
+        const resolvedPath = refPath.startsWith('~/')
+            ? refPath.replace('~/', `${homedir()}/`)
+            : projectDir
+                ? `${projectDir}/${refPath}`
+                : refPath;
+        try {
+            const content = readFileSync(resolvedPath, 'utf-8').trim();
+            return `${indent}${content}`;
+        }
+        catch {
+            // File not found — remove the reference silently
+            return '';
+        }
+    });
+}
+// ─── Interactive pattern stripping ───────────────────────────────────────────
+/**
+ * Patterns that are interactive-only and should be stripped for headless use.
+ * Note: @~/... file references are NOT stripped — they're resolved above.
+ */
+const LINE_PATTERNS = [
+    // @file:path/to/something references (explicit @file: directive, not @~/...)
+    /^.*@file:\S+.*$/gm,
+    // /gsd-command references — entire line containing a skill command
+    /^.*\/gsd[:-]\S+.*$/gm,
+    // AskUserQuestion(...) calls — entire line
+    /^.*AskUserQuestion\s*\(.*$/gm,
+    // SlashCommand() calls — entire line
+    /^.*SlashCommand\s*\(.*$/gm,
+    // STOP directives — lines that are primarily "STOP" instructions
+    /^.*\bSTOP\b(?:\s+(?:and\s+)?(?:wait|ask|here|now)).*$/gm,
+    /^\s*STOP\s*[.!]?\s*$/gm,
+    // 'wait for user' / 'ask the user' instruction lines
+    /^.*\bwait\s+for\s+(?:the\s+)?user\b.*$/gim,
+    /^.*\bask\s+the\s+user\b.*$/gim,
+];
+// ─── Public API ──────────────────────────────────────────────────────────────
+/**
+ * Sanitize a prompt for headless SDK use:
+ * 1. Resolve @-file references (inline the content)
+ * 2. Strip interactive-only patterns
+ *
+ * @param input - Raw prompt string from agent/workflow files
+ * @param projectDir - Project directory for resolving relative @-references
+ * @returns Cleaned prompt ready for Agent SDK use
+ */
+export function sanitizePrompt(input, projectDir) {
+    if (!input)
+        return input;
+    // Step 1: Resolve @-file references to inline content
+    let result = resolveAtReferences(input, projectDir);
+    // Step 2: Strip interactive-only patterns
+    for (const pattern of LINE_PATTERNS) {
+        pattern.lastIndex = 0;
+        result = result.replace(pattern, '');
+    }
+    // Collapse runs of 3+ blank lines down to 2 (preserve paragraph breaks)
+    result = result.replace(/\n{3,}/g, '\n\n');
+    return result.trim();
+}
+//# sourceMappingURL=prompt-sanitizer.js.map

package/sdk/dist/prompt-sanitizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt-sanitizer.js","sourceRoot":"","sources":["../src/prompt-sanitizer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAElC,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,oBAAoB,GAAG,yCAAyC,CAAC;AAEvE;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,UAAmB;IACpE,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzB,OAAO,KAAK,CAAC,OAAO,CAAC,oBAAoB,EAAE,CAAC,MAAM,EAAE,MAAc,EAAE,OAAe,EAAE,EAAE;QACrF,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;YAC3C,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,OAAO,EAAE,GAAG,CAAC;YACxC,CAAC,CAAC,UAAU;gBACV,CAAC,CAAC,GAAG,UAAU,IAAI,OAAO,EAAE;gBAC5B,CAAC,CAAC,OAAO,CAAC;QAEd,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YAC3D,OAAO,GAAG,MAAM,GAAG,OAAO,EAAE,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,iDAAiD;YACjD,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC;AAED,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,aAAa,GAAa;IAC9B,6EAA6E;IAC7E,mBAAmB;IAEnB,mEAAmE;IACnE,sBAAsB;IAEtB,2CAA2C;IAC3C,8BAA8B;IAE9B,qCAAqC;IACrC,2BAA2B;IAE3B,iEAAiE;IACjE,yDAAyD;IACzD,wBAAwB;IAExB,qDAAqD;IACrD,2CAA2C;IAC3C,+BAA+B;CAChC,CAAC;AAEF,gFAAgF;AAEhF;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,KAAa,EAAE,UAAmB;IAC/D,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IAEzB,sDAAsD;IACtD,IAAI,MAAM,GAAG,mBAAmB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAEpD,0CAA0C;IAC1C,KAAK,MAAM,OAAO,IAAI,aAAa,EAAE,CAAC;QACpC,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC;QACtB,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,wEAAwE;IACxE,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAE3C,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;AACvB,CAAC"}

package/sdk/dist/query/active-workstream-store.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Read active workstream pointer from `.planning/active-workstream`.
+ * Invalid or stale pointers are self-healed by clearing the file.
+ */
+export declare function readActiveWorkstream(projectDir: string): string | null;
+export declare function writeActiveWorkstream(projectDir: string, name: string | null): void;
+//# sourceMappingURL=active-workstream-store.d.ts.map

package/sdk/dist/query/active-workstream-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-workstream-store.d.ts","sourceRoot":"","sources":["../../src/query/active-workstream-store.ts"],"names":[],"mappings":"AAYA;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgBtE;AAED,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAcnF"}

package/sdk/dist/query/active-workstream-store.js

@@ -0,0 +1,56 @@
+import { readFileSync, writeFileSync, unlinkSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { validateWorkstreamName } from '../workstream-utils.js';
+function pointerPath(projectDir) {
+    return join(projectDir, '.planning', 'active-workstream');
+}
+function workstreamDir(projectDir, name) {
+    return join(projectDir, '.planning', 'workstreams', name);
+}
+/**
+ * Read active workstream pointer from `.planning/active-workstream`.
+ * Invalid or stale pointers are self-healed by clearing the file.
+ */
+export function readActiveWorkstream(projectDir) {
+    const filePath = pointerPath(projectDir);
+    try {
+        const name = readFileSync(filePath, 'utf-8').trim();
+        if (!name || !validateWorkstreamName(name)) {
+            try {
+                unlinkSync(filePath);
+            }
+            catch { /* already gone */ }
+            return null;
+        }
+        if (!existsSync(workstreamDir(projectDir, name))) {
+            try {
+                unlinkSync(filePath);
+            }
+            catch { /* already gone */ }
+            return null;
+        }
+        return name;
+    }
+    catch {
+        return null;
+    }
+}
+export function writeActiveWorkstream(projectDir, name) {
+    const filePath = pointerPath(projectDir);
+    if (!name) {
+        try {
+            unlinkSync(filePath);
+        }
+        catch { /* already gone */ }
+        return;
+    }
+    if (!validateWorkstreamName(name)) {
+        throw new Error('Invalid workstream name: must be alphanumeric, hyphens, underscores, or dots');
+    }
+    const wsDir = workstreamDir(projectDir, name);
+    if (!existsSync(wsDir)) {
+        throw new Error(`Workstream directory does not exist: ${name}`);
+    }
+    writeFileSync(filePath, name + '\n', 'utf-8');
+}
+//# sourceMappingURL=active-workstream-store.js.map

package/sdk/dist/query/active-workstream-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"active-workstream-store.js","sourceRoot":"","sources":["../../src/query/active-workstream-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAC9E,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,SAAS,WAAW,CAAC,UAAkB;IACrC,OAAO,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,mBAAmB,CAAC,CAAC;AAC5D,CAAC;AAED,SAAS,aAAa,CAAC,UAAkB,EAAE,IAAY;IACrD,OAAO,IAAI,CAAC,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,UAAkB;IACrD,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACpD,IAAI,CAAC,IAAI,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC;gBAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;YACjD,IAAI,CAAC;gBAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,UAAkB,EAAE,IAAmB;IAC3E,MAAM,QAAQ,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,IAAI,CAAC;YAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAC1D,OAAO;IACT,CAAC;IACD,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,KAAK,CAAC,8EAA8E,CAAC,CAAC;IAClG,CAAC;IACD,MAAM,KAAK,GAAG,aAAa,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAC9C,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,aAAa,CAAC,QAAQ,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;AAChD,CAAC"}

package/sdk/dist/query/agent-failure-classifier.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Classify the free-text return body from a dispatched executor subagent into
+ * an actionable failure class for the orchestrator's recovery router.
+ *
+ * Context (#3095): the orchestrator currently treats every non-success agent
+ * return as a generic "real failure" except for the Claude Code
+ * `classifyHandoffIfNeeded is not defined` runtime bug. Quota / rate-limit
+ * terminations look identical to a crashed agent — but the right user
+ * response is "wait for reset and resume", not "retry now or abort".
+ *
+ * Sentinel coverage spans the runtimes GSD supports as executor targets:
+ *   - Anthropic / Claude Code  — "usage limit", "rate limit", "quota", "429", "retry-after"
+ *   - GitHub Copilot CLI       — "rate limit", "rate_limited", "user_weekly_rate_limited"
+ *   - OpenAI Codex CLI         — "429", "usage_limit_reached", "too many requests"
+ *   - Google Gemini CLI        — "RESOURCE_EXHAUSTED", "exceeded your", "quota"
+ *
+ * See docs/research/provider-rate-limit-signals.md for the proactive (header
+ * / SDK event) signals the orchestrator could use once the host runtime
+ * (Claude Code, Copilot, Codex) exposes them to hooks.
+ */
+export type AgentFailureClass = 'quota-exceeded' | 'classify-handoff-bug' | 'unknown-failure';
+export interface AgentFailureClassification {
+    class: AgentFailureClass;
+    /** Lower-cased substring that matched, if any. Useful for log lines. */
+    sentinel?: string;
+    /** Seconds the runtime asked us to wait, parsed from "retry-after: N". */
+    retryAfterSeconds?: number;
+}
+/**
+ * Query-handler wrapper for `agent.classify-failure`. Reads the body to
+ * classify from the joined positional args (typed via `--`) so workflow
+ * shell snippets can pass it as `gsd-sdk query agent.classify-failure -- "$BODY"`.
+ */
+export declare function agentClassifyFailure(args: string[]): Promise<{
+    data: AgentFailureClassification;
+}>;
+export declare function classifyAgentFailure(body: string): AgentFailureClassification;
+//# sourceMappingURL=agent-failure-classifier.d.ts.map

package/sdk/dist/query/agent-failure-classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-failure-classifier.d.ts","sourceRoot":"","sources":["../../src/query/agent-failure-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,MAAM,iBAAiB,GACzB,gBAAgB,GAChB,sBAAsB,GACtB,iBAAiB,CAAC;AAEtB,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,iBAAiB,CAAC;IACzB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAiCD;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,0BAA0B,CAAA;CAAE,CAAC,CAG/C;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,0BAA0B,CA2B7E"}

package/sdk/dist/query/agent-failure-classifier.js

@@ -0,0 +1,83 @@
+/**
+ * Classify the free-text return body from a dispatched executor subagent into
+ * an actionable failure class for the orchestrator's recovery router.
+ *
+ * Context (#3095): the orchestrator currently treats every non-success agent
+ * return as a generic "real failure" except for the Claude Code
+ * `classifyHandoffIfNeeded is not defined` runtime bug. Quota / rate-limit
+ * terminations look identical to a crashed agent — but the right user
+ * response is "wait for reset and resume", not "retry now or abort".
+ *
+ * Sentinel coverage spans the runtimes GSD supports as executor targets:
+ *   - Anthropic / Claude Code  — "usage limit", "rate limit", "quota", "429", "retry-after"
+ *   - GitHub Copilot CLI       — "rate limit", "rate_limited", "user_weekly_rate_limited"
+ *   - OpenAI Codex CLI         — "429", "usage_limit_reached", "too many requests"
+ *   - Google Gemini CLI        — "RESOURCE_EXHAUSTED", "exceeded your", "quota"
+ *
+ * See docs/research/provider-rate-limit-signals.md for the proactive (header
+ * / SDK event) signals the orchestrator could use once the host runtime
+ * (Claude Code, Copilot, Codex) exposes them to hooks.
+ */
+// Order matters: the first match wins, so list the most specific / most
+// actionable sentinels first. "429" beats "too many requests"; "quota" beats
+// "RESOURCE_EXHAUSTED" because "quota" is the universal token. All matches
+// are case-insensitive (sentinel value below is the lower-cased form).
+const QUOTA_SENTINELS = [
+    '429',
+    'usage_limit_reached',
+    'usage limit',
+    'rate limit',
+    'rate-limited',
+    // `rate_limit` (stem) covers `rate_limited`, `rate_limit_error`,
+    // `rate_limit_exceeded`, and Copilot's `user_weekly_rate_limited`.
+    'rate_limit',
+    'resource_exhausted',
+    'quota',
+    'too many requests',
+    'exceeded your',
+];
+const CLASSIFY_HANDOFF_SENTINEL = 'classifyhandoffifneeded is not defined';
+function parseRetryAfter(body) {
+    // Match "retry-after: N" or "Retry-After: N" with optional surrounding
+    // punctuation. Captures integer seconds only — HTTP-date form is rare in
+    // agent return bodies and not worth the surface area.
+    const match = body.match(/\bretry[-_ ]after[:\s]+(\d+)\b/i);
+    if (!match)
+        return undefined;
+    const seconds = Number.parseInt(match[1], 10);
+    return Number.isFinite(seconds) ? seconds : undefined;
+}
+/**
+ * Query-handler wrapper for `agent.classify-failure`. Reads the body to
+ * classify from the joined positional args (typed via `--`) so workflow
+ * shell snippets can pass it as `gsd-sdk query agent.classify-failure -- "$BODY"`.
+ */
+export async function agentClassifyFailure(args) {
+    const body = args.join(' ');
+    return { data: classifyAgentFailure(body) };
+}
+export function classifyAgentFailure(body) {
+    const normalized = body.toLowerCase();
+    if (normalized.trim() === '') {
+        return { class: 'unknown-failure' };
+    }
+    // Quota sentinels take precedence over the classifyHandoff runtime bug:
+    // a quota-kill that *also* crashed the completion handler is still a quota
+    // event, and the recovery path differs (wait vs. spot-check-and-treat-as-OK).
+    for (const sentinel of QUOTA_SENTINELS) {
+        if (normalized.includes(sentinel)) {
+            const retryAfterSeconds = parseRetryAfter(body);
+            return retryAfterSeconds === undefined
+                ? { class: 'quota-exceeded', sentinel }
+                : { class: 'quota-exceeded', sentinel, retryAfterSeconds };
+        }
+    }
+    if (normalized.includes(CLASSIFY_HANDOFF_SENTINEL)) {
+        return {
+            class: 'classify-handoff-bug',
+            sentinel: CLASSIFY_HANDOFF_SENTINEL,
+        };
+    }
+    return { class: 'unknown-failure' };
+}
+//# sourceMappingURL=agent-failure-classifier.js.map

package/sdk/dist/query/agent-failure-classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-failure-classifier.js","sourceRoot":"","sources":["../../src/query/agent-failure-classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAeH,wEAAwE;AACxE,6EAA6E;AAC7E,2EAA2E;AAC3E,uEAAuE;AACvE,MAAM,eAAe,GAA0B;IAC7C,KAAK;IACL,qBAAqB;IACrB,aAAa;IACb,YAAY;IACZ,cAAc;IACd,iEAAiE;IACjE,mEAAmE;IACnE,YAAY;IACZ,oBAAoB;IACpB,OAAO;IACP,mBAAmB;IACnB,eAAe;CAChB,CAAC;AAEF,MAAM,yBAAyB,GAAG,wCAAwC,CAAC;AAE3E,SAAS,eAAe,CAAC,IAAY;IACnC,uEAAuE;IACvE,yEAAyE;IACzE,sDAAsD;IACtD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,iCAAiC,CAAC,CAAC;IAC5D,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;IAC/C,OAAO,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAc;IAEd,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,EAAE,IAAI,EAAE,oBAAoB,CAAC,IAAI,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAEtC,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QAC7B,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;IACtC,CAAC;IAED,wEAAwE;IACxE,2EAA2E;IAC3E,8EAA8E;IAC9E,KAAK,MAAM,QAAQ,IAAI,eAAe,EAAE,CAAC;QACvC,IAAI,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAClC,MAAM,iBAAiB,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;YAChD,OAAO,iBAAiB,KAAK,SAAS;gBACpC,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE;gBACvC,CAAC,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,QAAQ,EAAE,iBAAiB,EAAE,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,IAAI,UAAU,CAAC,QAAQ,CAAC,yBAAyB,CAAC,EAAE,CAAC;QACnD,OAAO;YACL,KAAK,EAAE,sBAAsB;YAC7B,QAAQ,EAAE,yBAAyB;SACpC,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,iBAAiB,EAAE,CAAC;AACtC,CAAC"}

package/sdk/dist/query/audit-open.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Open Artifact Audit — full TypeScript port of `get-shit-done/bin/lib/audit.cjs`.
+ *
+ * Scans `.planning/` artifact categories for unresolved items (same JSON as gsd-tools `audit-open`).
+ */
+import type { QueryHandler } from './utils.js';
+export interface AuditOpenResult {
+    scanned_at: string;
+    /** True when at least one category reported scan_error / unreadable rows (audit may be incomplete). */
+    has_scan_errors: boolean;
+    has_open_items: boolean;
+    counts: {
+        debug_sessions: number;
+        quick_tasks: number;
+        threads: number;
+        todos: number;
+        seeds: number;
+        uat_gaps: number;
+        verification_gaps: number;
+        context_questions: number;
+        total: number;
+    };
+    items: {
+        debug_sessions: Array<Record<string, unknown>>;
+        quick_tasks: Array<Record<string, unknown>>;
+        threads: Array<Record<string, unknown>>;
+        todos: Array<Record<string, unknown>>;
+        seeds: Array<Record<string, unknown>>;
+        uat_gaps: Array<Record<string, unknown>>;
+        verification_gaps: Array<Record<string, unknown>>;
+        context_questions: Array<Record<string, unknown>>;
+    };
+}
+/**
+ * Same structured result as `gsd-tools.cjs audit-open` (JSON).
+ */
+export declare function auditOpenArtifacts(projectDir: string, workstream?: string): AuditOpenResult;
+/**
+ * Human-readable report (same text as gsd-tools without `--json`).
+ */
+export declare function formatAuditReport(auditResult: AuditOpenResult): string;
+/**
+ * `audit-open` / `audit.open` — optional `--json` for structured JSON only (default adds formatted report string).
+ */
+export declare const auditOpen: QueryHandler;
+//# sourceMappingURL=audit-open.d.ts.map

package/sdk/dist/query/audit-open.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-open.d.ts","sourceRoot":"","sources":["../../src/query/audit-open.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAmc/C,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,uGAAuG;IACvG,eAAe,EAAE,OAAO,CAAC;IACzB,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE;QACN,cAAc,EAAE,MAAM,CAAC;QACvB,WAAW,EAAE,MAAM,CAAC;QACpB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,QAAQ,EAAE,MAAM,CAAC;QACjB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,iBAAiB,EAAE,MAAM,CAAC;QAC1B,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;IACF,KAAK,EAAE;QACL,cAAc,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAC/C,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAC5C,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACxC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACtC,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACtC,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QACzC,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAClD,iBAAiB,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;KACnD,CAAC;CACH;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,eAAe,CAyF3F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,eAAe,GAAG,MAAM,CAqHtE;AAED;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,YAYvB,CAAC"}