@opengsd/get-shit-done-redux 1.0.0

package/sdk/dist/query/secrets.js

@@ -0,0 +1,42 @@
+/**
+ * Secrets handling — TypeScript mirror of `get-shit-done/bin/lib/secrets.cjs`.
+ *
+ * Keys considered sensitive (`SECRET_CONFIG_KEYS`) are masked in any
+ * machine-readable response from `config-set` / `config-get` so plaintext
+ * credentials don't end up in workflow output, session transcripts, or
+ * shell histories. The on-disk value is unchanged; only the response is masked.
+ *
+ * Behavior must match `secrets.cjs` exactly. A parity test asserts the
+ * two modules expose the same set of secret keys and produce identical
+ * masked output for representative inputs.
+ *
+ * Tracked in #2997 (security: SDK port lost masking behavior).
+ */
+export const SECRET_CONFIG_KEYS = new Set([
+    'brave_search',
+    'firecrawl',
+    'exa_search',
+]);
+export function isSecretKey(keyPath) {
+    return SECRET_CONFIG_KEYS.has(keyPath);
+}
+/**
+ * Convention: ≥8 chars → `****<last-4>`; <8 chars → `****`; null/empty/undefined → `(unset)`.
+ * Identical to `secrets.cjs` `maskSecret`.
+ */
+export function maskSecret(value) {
+    if (value === null || value === undefined || value === '')
+        return '(unset)';
+    const s = String(value);
+    if (s.length < 8)
+        return '****';
+    return '****' + s.slice(-4);
+}
+/**
+ * Helper: returns the value masked if `keyPath` is a secret, else the value
+ * unchanged. Use at response-construction boundaries in query handlers.
+ */
+export function maskIfSecret(keyPath, value) {
+    return isSecretKey(keyPath) ? maskSecret(value) : value;
+}
+//# sourceMappingURL=secrets.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"secrets.js","sourceRoot":"","sources":["../../src/query/secrets.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,CAAC,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC;IAC7D,cAAc;IACd,WAAW;IACX,YAAY;CACb,CAAC,CAAC;AAEH,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,KAAc;IACvC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAC5E,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IACxB,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,MAAM,CAAC;IAChC,OAAO,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAC9B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAI,OAAe,EAAE,KAAQ;IACvD,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAC1D,CAAC"}

package/sdk/dist/query/skill-manifest.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Skill manifest — multi-root skill discovery scan.
+ *
+ * Full port of `buildSkillManifest` / `cmdSkillManifest` from
+ * `get-shit-done/bin/lib/init.cjs` (lines 1640–1847).
+ * Uses {@link extractFrontmatterLeading} — same as CJS `frontmatter.cjs` `extractFrontmatter`
+ * (first `---` block only; skills with later `---` rules must not use TS `extractFrontmatter`'s last-block rule).
+ */
+import type { QueryHandler } from './utils.js';
+export interface SkillManifestSkill {
+    name: string;
+    description: string;
+    triggers: string[];
+    path: string;
+    file_path: string;
+    root: string;
+    scope: string;
+    installed: boolean;
+    deprecated: boolean;
+}
+export interface SkillManifestRoot {
+    root: string;
+    path: string;
+    scope: string;
+    present: boolean;
+    deprecated?: boolean;
+    skill_count?: number;
+    command_count?: number;
+}
+export interface SkillManifestJson {
+    skills: SkillManifestSkill[];
+    roots: SkillManifestRoot[];
+    installation: {
+        gsd_skills_installed: boolean;
+        legacy_claude_commands_installed: boolean;
+    };
+    counts: {
+        skills: number;
+        roots: number;
+    };
+}
+/**
+ * Scan canonical skill roots and build manifest JSON (same shape as gsd-tools.cjs).
+ */
+export declare function buildSkillManifest(cwd: string, skillsDir?: string | null): SkillManifestJson;
+/**
+ * `skill-manifest` — same flags as gsd-tools: `--skills-dir`, `--write`.
+ */
+export declare const skillManifest: QueryHandler;
+//# sourceMappingURL=skill-manifest.d.ts.map

package/sdk/dist/query/skill-manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-manifest.d.ts","sourceRoot":"","sources":["../../src/query/skill-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,kBAAkB,EAAE,CAAC;IAC7B,KAAK,EAAE,iBAAiB,EAAE,CAAC;IAC3B,YAAY,EAAE;QACZ,oBAAoB,EAAE,OAAO,CAAC;QAC9B,gCAAgC,EAAE,OAAO,CAAC;KAC3C,CAAC;IACF,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,GAAE,MAAM,GAAG,IAAW,GAAG,iBAAiB,CA+IlG;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,YAc3B,CAAC"}

package/sdk/dist/query/skill-manifest.js

@@ -0,0 +1,171 @@
+/**
+ * Skill manifest — multi-root skill discovery scan.
+ *
+ * Full port of `buildSkillManifest` / `cmdSkillManifest` from
+ * `get-shit-done/bin/lib/init.cjs` (lines 1640–1847).
+ * Uses {@link extractFrontmatterLeading} — same as CJS `frontmatter.cjs` `extractFrontmatter`
+ * (first `---` block only; skills with later `---` rules must not use TS `extractFrontmatter`'s last-block rule).
+ */
+import { existsSync, readdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { extractFrontmatterLeading } from './frontmatter.js';
+import { resolveGlobalSkillsBase, renderGlobalSkillsBaseDisplayPath } from './helpers.js';
+import { resolveLegacySkillsDir } from '../sdk-package-compatibility.js';
+/**
+ * Scan canonical skill roots and build manifest JSON (same shape as gsd-tools.cjs).
+ */
+export function buildSkillManifest(cwd, skillsDir = null) {
+    const canonicalRoots = skillsDir
+        ? [{
+                root: resolve(skillsDir),
+                path: resolve(skillsDir),
+                scope: 'custom',
+                present: existsSync(skillsDir),
+                kind: 'skills',
+            }]
+        : [
+            { root: '.claude/skills', path: join(cwd, '.claude', 'skills'), scope: 'project', kind: 'skills' },
+            { root: '.agents/skills', path: join(cwd, '.agents', 'skills'), scope: 'project', kind: 'skills' },
+            { root: '.cursor/skills', path: join(cwd, '.cursor', 'skills'), scope: 'project', kind: 'skills' },
+            { root: '.github/skills', path: join(cwd, '.github', 'skills'), scope: 'project', kind: 'skills' },
+            { root: '.codex/skills', path: join(cwd, '.codex', 'skills'), scope: 'project', kind: 'skills' },
+            { root: renderGlobalSkillsBaseDisplayPath('claude'), path: resolveGlobalSkillsBase('claude'), scope: 'global', kind: 'skills' },
+            { root: renderGlobalSkillsBaseDisplayPath('codex'), path: resolveGlobalSkillsBase('codex'), scope: 'global', kind: 'skills' },
+            {
+                root: '.claude/get-shit-done/skills',
+                path: resolveLegacySkillsDir(),
+                scope: 'import-only',
+                kind: 'skills',
+                deprecated: true,
+            },
+            {
+                root: '.claude/commands/gsd',
+                path: join(homedir(), '.claude', 'commands', 'gsd'),
+                scope: 'legacy-commands',
+                kind: 'commands',
+                deprecated: true,
+            },
+        ];
+    const skills = [];
+    const roots = [];
+    let legacyClaudeCommandsInstalled = false;
+    for (const rootInfo of canonicalRoots) {
+        const rootPath = rootInfo.path;
+        const rootSummary = {
+            root: rootInfo.root,
+            path: rootPath,
+            scope: rootInfo.scope,
+            present: existsSync(rootPath),
+            deprecated: 'deprecated' in rootInfo ? !!rootInfo.deprecated : false,
+        };
+        if (!rootSummary.present) {
+            roots.push(rootSummary);
+            continue;
+        }
+        if (rootInfo.kind === 'commands') {
+            let entries;
+            try {
+                entries = readdirSync(rootPath, { withFileTypes: true });
+            }
+            catch {
+                roots.push(rootSummary);
+                continue;
+            }
+            const commandFiles = entries.filter(e => e.isFile() && e.name.endsWith('.md'));
+            rootSummary.command_count = commandFiles.length;
+            if (rootSummary.command_count > 0)
+                legacyClaudeCommandsInstalled = true;
+            roots.push(rootSummary);
+            continue;
+        }
+        let entries;
+        try {
+            entries = readdirSync(rootPath, { withFileTypes: true });
+        }
+        catch {
+            roots.push(rootSummary);
+            continue;
+        }
+        let skillCount = 0;
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const entryName = entry.name.toString();
+            const skillMdPath = join(rootPath, entryName, 'SKILL.md');
+            if (!existsSync(skillMdPath))
+                continue;
+            let content;
+            try {
+                content = readFileSync(skillMdPath, 'utf-8');
+            }
+            catch {
+                continue;
+            }
+            const frontmatter = extractFrontmatterLeading(content);
+            const name = frontmatter.name || entryName;
+            const description = frontmatter.description || '';
+            const triggers = [];
+            const bodyMatch = content.match(/^---[\s\S]*?---\s*\n([\s\S]*)$/);
+            if (bodyMatch) {
+                const body = bodyMatch[1];
+                const triggerLines = body.match(/^TRIGGER\s+when:\s*(.+)$/gim);
+                if (triggerLines) {
+                    for (const line of triggerLines) {
+                        const m = line.match(/^TRIGGER\s+when:\s*(.+)$/i);
+                        if (m)
+                            triggers.push(m[1].trim());
+                    }
+                }
+            }
+            skills.push({
+                name,
+                description,
+                triggers,
+                path: entryName,
+                file_path: `${entryName}/SKILL.md`,
+                root: rootInfo.root,
+                scope: rootInfo.scope,
+                installed: rootInfo.scope !== 'import-only',
+                deprecated: !!('deprecated' in rootInfo && rootInfo.deprecated),
+            });
+            skillCount++;
+        }
+        rootSummary.skill_count = skillCount;
+        roots.push(rootSummary);
+    }
+    skills.sort((a, b) => {
+        const rootCmp = a.root.localeCompare(b.root);
+        return rootCmp !== 0 ? rootCmp : a.name.localeCompare(b.name);
+    });
+    const gsdSkillsInstalled = skills.some(skill => skill.name.startsWith('gsd-'));
+    return {
+        skills,
+        roots,
+        installation: {
+            gsd_skills_installed: gsdSkillsInstalled,
+            legacy_claude_commands_installed: legacyClaudeCommandsInstalled,
+        },
+        counts: {
+            skills: skills.length,
+            roots: roots.length,
+        },
+    };
+}
+/**
+ * `skill-manifest` — same flags as gsd-tools: `--skills-dir`, `--write`.
+ */
+export const skillManifest = async (args, projectDir) => {
+    const skillsDirIdx = args.indexOf('--skills-dir');
+    const skillsDir = skillsDirIdx >= 0 && args[skillsDirIdx + 1] ? args[skillsDirIdx + 1] : null;
+    const manifest = buildSkillManifest(projectDir, skillsDir);
+    if (args.includes('--write')) {
+        const planningDir = join(projectDir, '.planning');
+        if (existsSync(planningDir)) {
+            const manifestPath = join(planningDir, 'skill-manifest.json');
+            writeFileSync(manifestPath, JSON.stringify(manifest, null, 2), 'utf-8');
+        }
+    }
+    return { data: manifest };
+};
+//# sourceMappingURL=skill-manifest.js.map

package/sdk/dist/query/skill-manifest.js.map

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

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

@@ -0,0 +1,27 @@
+/**
+ * Agent skills query handler — read configured skills from `.planning/config.json`
+ * and emit the `<agent_skills>` XML block workflows interpolate into Task() prompts.
+ *
+ * Ports `buildAgentSkillsBlock` semantics from
+ * `get-shit-done/bin/lib/init.cjs` so the SDK path honors
+ * `config.agent_skills[agentType]` the same way the legacy
+ * `gsd-tools.cjs agent-skills <type>` path does. Project-relative skills stay
+ * project-root validated; `global:<name>` now resolves through runtime-aware
+ * global skills dir policy rather than a Claude-only hardcoded path. Fixes #2555.
+ *
+ * @example
+ * ```typescript
+ * import { agentSkills } from './skills.js';
+ *
+ * // With config.agent_skills = { "gsd-planner": [".claude/skills/demo-skill"] }
+ * await agentSkills(['gsd-planner'], '/project');
+ * // { data: '<agent_skills>\nRead these user-configured skills:\n- @.claude/skills/demo-skill/SKILL.md\n</agent_skills>' }
+ *
+ * // No agent type → empty string (matches gsd-tools cmdAgentSkills).
+ * await agentSkills([], '/project');
+ * // { data: '' }
+ * ```
+ */
+import type { QueryHandler } from './utils.js';
+export declare const agentSkills: QueryHandler;
+//# sourceMappingURL=skills.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/query/skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAyB/C,eAAO,MAAM,WAAW,EAAE,YAyFzB,CAAC"}

package/sdk/dist/query/skills.js

@@ -0,0 +1,137 @@
+/**
+ * Agent skills query handler — read configured skills from `.planning/config.json`
+ * and emit the `<agent_skills>` XML block workflows interpolate into Task() prompts.
+ *
+ * Ports `buildAgentSkillsBlock` semantics from
+ * `get-shit-done/bin/lib/init.cjs` so the SDK path honors
+ * `config.agent_skills[agentType]` the same way the legacy
+ * `gsd-tools.cjs agent-skills <type>` path does. Project-relative skills stay
+ * project-root validated; `global:<name>` now resolves through runtime-aware
+ * global skills dir policy rather than a Claude-only hardcoded path. Fixes #2555.
+ *
+ * @example
+ * ```typescript
+ * import { agentSkills } from './skills.js';
+ *
+ * // With config.agent_skills = { "gsd-planner": [".claude/skills/demo-skill"] }
+ * await agentSkills(['gsd-planner'], '/project');
+ * // { data: '<agent_skills>\nRead these user-configured skills:\n- @.claude/skills/demo-skill/SKILL.md\n</agent_skills>' }
+ *
+ * // No agent type → empty string (matches gsd-tools cmdAgentSkills).
+ * await agentSkills([], '/project');
+ * // { data: '' }
+ * ```
+ */
+import { existsSync, realpathSync } from 'node:fs';
+import { join, resolve, sep } from 'node:path';
+import { detectRuntime, renderGlobalSkillDisplayPath, resolveGlobalSkillDir, resolveGlobalSkillsBase } from './helpers.js';
+import { loadConfig } from '../config.js';
+const GLOBAL_SKILL_NAME_RE = /^[a-zA-Z0-9_-]+$/;
+/**
+ * Resolve `target` and ensure it stays inside `baseDir` after symlink resolution.
+ * Mirrors the symlink-escape guard in `bin/lib/security.cjs#validatePath`.
+ */
+function resolveWithinBase(target, baseDir) {
+    try {
+        const resolvedBase = existsSync(baseDir) ? realpathSync(baseDir) : resolve(baseDir);
+        const absTarget = resolve(baseDir, target);
+        const resolvedTarget = existsSync(absTarget) ? realpathSync(absTarget) : absTarget;
+        const baseWithSep = resolvedBase.endsWith(sep) ? resolvedBase : resolvedBase + sep;
+        if (resolvedTarget !== resolvedBase && !resolvedTarget.startsWith(baseWithSep)) {
+            return null;
+        }
+        return resolvedTarget;
+    }
+    catch {
+        return null;
+    }
+}
+export const agentSkills = async (args, projectDir) => {
+    const agentType = (args[0] || '').trim();
+    // Match gsd-tools `cmdAgentSkills`: no agent type → empty string (JSON `""`), not a structured object.
+    if (!agentType) {
+        return { data: '' };
+    }
+    let config;
+    try {
+        config = await loadConfig(projectDir);
+    }
+    catch {
+        return { data: '' };
+    }
+    const raw = config.agent_skills?.[agentType];
+    if (!raw)
+        return { data: '' };
+    let skillPaths;
+    if (typeof raw === 'string') {
+        skillPaths = [raw];
+    }
+    else if (Array.isArray(raw)) {
+        skillPaths = raw;
+    }
+    else {
+        return { data: '' };
+    }
+    if (skillPaths.length === 0)
+        return { data: '' };
+    const runtime = detectRuntime(config);
+    const globalSkillsBase = resolveGlobalSkillsBase(runtime);
+    const validEntries = [];
+    for (const entry of skillPaths) {
+        if (typeof entry !== 'string')
+            continue;
+        // `global:<name>` — skill installed under the runtime-global skills dir (#1992, #3126).
+        if (entry.startsWith('global:')) {
+            const skillName = entry.slice(7);
+            if (!skillName) {
+                process.stderr.write('[agent-skills] WARNING: "global:" prefix with empty skill name — skipping\n');
+                continue;
+            }
+            if (!GLOBAL_SKILL_NAME_RE.test(skillName)) {
+                process.stderr.write(`[agent-skills] WARNING: Invalid global skill name "${skillName}" — skipping\n`);
+                continue;
+            }
+            if (globalSkillsBase === null) {
+                process.stderr.write(`[agent-skills] WARNING: Runtime "${runtime}" does not use a skills directory — "global:${skillName}" is not supported on this runtime\n`);
+                continue;
+            }
+            const skillDir = resolveGlobalSkillDir(runtime, skillName);
+            const displayPath = renderGlobalSkillDisplayPath(runtime, skillName);
+            if (!skillDir) {
+                process.stderr.write(`[agent-skills] WARNING: Could not resolve global skill directory for "${skillName}" on runtime "${runtime}" — skipping\n`);
+                continue;
+            }
+            const skillMd = join(skillDir, 'SKILL.md');
+            if (!existsSync(skillMd)) {
+                process.stderr.write(`[agent-skills] WARNING: Global skill not found at "${displayPath}/SKILL.md" — skipping\n`);
+                continue;
+            }
+            if (resolveWithinBase(skillMd, globalSkillsBase) === null) {
+                process.stderr.write(`[agent-skills] WARNING: Global skill "${skillName}" failed path check (symlink escape?) — skipping\n`);
+                continue;
+            }
+            validEntries.push({ ref: skillMd });
+            continue;
+        }
+        // Project-relative path — must resolve within projectDir.
+        if (resolveWithinBase(entry, projectDir) === null) {
+            process.stderr.write(`[agent-skills] WARNING: Skipping unsafe path "${entry}"\n`);
+            continue;
+        }
+        const skillMd = join(projectDir, entry, 'SKILL.md');
+        if (!existsSync(skillMd)) {
+            process.stderr.write(`[agent-skills] WARNING: Skill not found at "${entry}/SKILL.md" — skipping\n`);
+            continue;
+        }
+        validEntries.push({ ref: `${entry}/SKILL.md` });
+    }
+    if (validEntries.length === 0)
+        return { data: '' };
+    const lines = validEntries.map((e) => `- @${e.ref}`).join('\n');
+    const block = `<agent_skills>\nRead these user-configured skills:\n${lines}\n</agent_skills>`;
+    // Signal the CLI dispatcher to write raw text — workflows embed the result
+    // with `$(gsd-sdk query agent-skills …)` and need the XML block verbatim, not
+    // a JSON-quoted string (see cli.ts QueryResult.format handling).
+    return { data: block, format: 'text' };
+};
+//# sourceMappingURL=skills.js.map

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

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

package/sdk/dist/query/state-document.d.ts

@@ -0,0 +1,14 @@
+/**
+ * STATE.md Document Module.
+ *
+ * Pure transforms for STATE.md text. This module does not read the filesystem
+ * and does not own persistence or locking.
+ */
+export declare function stateExtractField(content: string, fieldName: string): string | null;
+export declare function stateReplaceField(content: string, fieldName: string, newValue: string): string | null;
+export declare function stateReplaceFieldWithFallback(content: string, primary: string, fallback: string | null, value: string): string;
+export declare function normalizeStateStatus(status: string | null | undefined, pausedAt?: string | null): string;
+export declare function computeProgressPercent(completedPlans: number | null, totalPlans: number | null, completedPhases: number | null, totalPhases: number | null): number | null;
+export declare function shouldPreserveExistingProgress(existingProgress: unknown, derivedProgress: unknown): existingProgress is Record<string, unknown>;
+export declare function normalizeProgressNumbers(progress: unknown): unknown;
+//# sourceMappingURL=state-document.d.ts.map

package/sdk/dist/query/state-document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-document.d.ts","sourceRoot":"","sources":["../../src/query/state-document.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAQnF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWrG;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GAAG,IAAI,EACvB,KAAK,EAAE,MAAM,GACZ,MAAM,CAQR;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAmBxG;AAED,wBAAgB,sBAAsB,CACpC,cAAc,EAAE,MAAM,GAAG,IAAI,EAC7B,UAAU,EAAE,MAAM,GAAG,IAAI,EACzB,eAAe,EAAE,MAAM,GAAG,IAAI,EAC9B,WAAW,EAAE,MAAM,GAAG,IAAI,GACzB,MAAM,GAAG,IAAI,CAUf;AAiBD,wBAAgB,8BAA8B,CAC5C,gBAAgB,EAAE,OAAO,EACzB,eAAe,EAAE,OAAO,GACvB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAY7C;AAED,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,GAAG,OAAO,CASnE"}

package/sdk/dist/query/state-document.js

@@ -0,0 +1,110 @@
+/**
+ * STATE.md Document Module.
+ *
+ * Pure transforms for STATE.md text. This module does not read the filesystem
+ * and does not own persistence or locking.
+ */
+function escapeRegex(str) {
+    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+export function stateExtractField(content, fieldName) {
+    const escaped = escapeRegex(fieldName);
+    const boldPattern = new RegExp(`\\*\\*${escaped}:\\*\\*[ \\t]*(.+)`, 'i');
+    const boldMatch = content.match(boldPattern);
+    if (boldMatch)
+        return boldMatch[1].trim();
+    const plainPattern = new RegExp(`^${escaped}:[ \\t]*(.+)`, 'im');
+    const plainMatch = content.match(plainPattern);
+    return plainMatch ? plainMatch[1].trim() : null;
+}
+export function stateReplaceField(content, fieldName, newValue) {
+    const escaped = escapeRegex(fieldName);
+    const boldPattern = new RegExp(`(\\*\\*${escaped}:\\*\\*\\s*)(.*)`, 'i');
+    if (boldPattern.test(content)) {
+        return content.replace(boldPattern, (_match, prefix) => `${prefix}${newValue}`);
+    }
+    const plainPattern = new RegExp(`(^${escaped}:\\s*)(.*)`, 'im');
+    if (plainPattern.test(content)) {
+        return content.replace(plainPattern, (_match, prefix) => `${prefix}${newValue}`);
+    }
+    return null;
+}
+export function stateReplaceFieldWithFallback(content, primary, fallback, value) {
+    let result = stateReplaceField(content, primary, value);
+    if (result)
+        return result;
+    if (fallback) {
+        result = stateReplaceField(content, fallback, value);
+        if (result)
+            return result;
+    }
+    return content;
+}
+export function normalizeStateStatus(status, pausedAt) {
+    let normalizedStatus = status || 'unknown';
+    const statusLower = (status || '').toLowerCase();
+    if (statusLower.includes('paused') || statusLower.includes('stopped') || pausedAt) {
+        normalizedStatus = 'paused';
+    }
+    else if (statusLower.includes('executing') || statusLower.includes('in progress')) {
+        normalizedStatus = 'executing';
+    }
+    else if (statusLower.includes('planning') || statusLower.includes('ready to plan')) {
+        normalizedStatus = 'planning';
+    }
+    else if (statusLower.includes('discussing')) {
+        normalizedStatus = 'discussing';
+    }
+    else if (statusLower.includes('verif')) {
+        normalizedStatus = 'verifying';
+    }
+    else if (statusLower.includes('complete') || statusLower.includes('done')) {
+        normalizedStatus = 'completed';
+    }
+    else if (statusLower.includes('ready to execute')) {
+        normalizedStatus = 'executing';
+    }
+    return normalizedStatus;
+}
+export function computeProgressPercent(completedPlans, totalPlans, completedPhases, totalPhases) {
+    const hasPlanData = totalPlans !== null && totalPlans > 0 && completedPlans !== null;
+    const hasPhaseData = totalPhases !== null && totalPhases > 0 && completedPhases !== null;
+    if (!hasPlanData && !hasPhaseData)
+        return null;
+    const planFraction = hasPlanData ? completedPlans / totalPlans : 1;
+    const phaseFraction = hasPhaseData ? completedPhases / totalPhases : 1;
+    return Math.min(100, Math.round(Math.min(planFraction, phaseFraction) * 100));
+}
+function toFiniteNumber(value) {
+    const number = Number(value);
+    return Number.isFinite(number) ? number : null;
+}
+function existingProgressExceedsDerived(existingProgress, derivedProgress, key) {
+    const existing = toFiniteNumber(existingProgress[key]);
+    const derived = toFiniteNumber(derivedProgress[key]);
+    return existing !== null && derived !== null && existing > derived;
+}
+export function shouldPreserveExistingProgress(existingProgress, derivedProgress) {
+    if (!existingProgress || typeof existingProgress !== 'object')
+        return false;
+    if (!derivedProgress || typeof derivedProgress !== 'object')
+        return false;
+    const existing = existingProgress;
+    const derived = derivedProgress;
+    return (existingProgressExceedsDerived(existing, derived, 'total_phases') ||
+        existingProgressExceedsDerived(existing, derived, 'completed_phases') ||
+        existingProgressExceedsDerived(existing, derived, 'total_plans') ||
+        existingProgressExceedsDerived(existing, derived, 'completed_plans'));
+}
+export function normalizeProgressNumbers(progress) {
+    if (!progress || typeof progress !== 'object')
+        return progress;
+    const normalized = { ...progress };
+    for (const key of ['total_phases', 'completed_phases', 'total_plans', 'completed_plans', 'percent']) {
+        const number = toFiniteNumber(normalized[key]);
+        if (number !== null)
+            normalized[key] = number;
+    }
+    return normalized;
+}
+//# sourceMappingURL=state-document.js.map

package/sdk/dist/query/state-document.js.map

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