@opengsd/get-shit-done-redux 1.0.0

package/sdk/dist/query/uat.js

@@ -0,0 +1,339 @@
+/**
+ * UAT query handlers — checkpoint rendering and audit scanning.
+ *
+ * Ported from get-shit-done/bin/lib/uat.cjs.
+ * Provides UAT checkpoint rendering for verify-work workflows and
+ * audit scanning for UAT/VERIFICATION files across phases.
+ *
+ * @example
+ * ```typescript
+ * import { uatRenderCheckpoint, auditUat } from './uat.js';
+ *
+ * await uatRenderCheckpoint(['--file', 'path/to/UAT.md'], '/project');
+ * // { data: { test_number: 1, test_name: 'Login', checkpoint: '...' } }
+ *
+ * await auditUat([], '/project');
+ * // { data: { results: [...], summary: { total_files: 2, total_items: 5 } } }
+ * ```
+ */
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { GSDError, ErrorClassification } from '../errors.js';
+import { extractFrontmatter } from './frontmatter.js';
+import { planningPaths, resolvePathUnderProject, sanitizeForDisplay, toPosixPath } from './helpers.js';
+import { getMilestonePhaseFilter } from './state.js';
+/** Same string as `buildCheckpoint` in `get-shit-done/bin/lib/uat.cjs`. */
+function buildUatCheckpoint(currentTest) {
+    return [
+        '╔══════════════════════════════════════════════════════════════╗',
+        '║  CHECKPOINT: Verification Required                           ║',
+        '╚══════════════════════════════════════════════════════════════╝',
+        '',
+        `**Test ${currentTest.number}: ${currentTest.name}**`,
+        '',
+        currentTest.expected,
+        '',
+        '──────────────────────────────────────────────────────────────',
+        'Type `pass` or describe what\'s wrong.',
+        '──────────────────────────────────────────────────────────────',
+    ].join('\n');
+}
+// ─── uatRenderCheckpoint ─────────────────────────────────────────────────
+/**
+ * Render the current UAT checkpoint — reads a UAT file, parses the
+ * "Current Test" section, and returns a formatted checkpoint prompt.
+ *
+ * Port of `cmdRenderCheckpoint` from `uat.cjs` (paths via `requireSafePath`,
+ * checkpoint via `buildCheckpoint`, name/expected via `sanitizeForDisplay`).
+ *
+ * Args: --file <path>
+ */
+export const uatRenderCheckpoint = async (args, projectDir) => {
+    const fileIdx = args.indexOf('--file');
+    const filePath = fileIdx !== -1 ? args[fileIdx + 1] : null;
+    if (!filePath) {
+        return { data: { error: 'UAT file required: use uat render-checkpoint --file <path>' } };
+    }
+    let resolvedPath;
+    try {
+        resolvedPath = await resolvePathUnderProject(projectDir, filePath);
+    }
+    catch {
+        return { data: { error: `UAT file not found: ${filePath}` } };
+    }
+    if (!existsSync(resolvedPath)) {
+        return { data: { error: `UAT file not found: ${filePath}` } };
+    }
+    const content = readFileSync(resolvedPath, 'utf-8');
+    const currentTestMatch = content.match(/##\s*Current Test\s*(?:\n<!--[\s\S]*?-->)?\n([\s\S]*?)(?=\n##\s|$)/i);
+    if (!currentTestMatch) {
+        return { data: { error: 'UAT file is missing a Current Test section' } };
+    }
+    const section = currentTestMatch[1].trimEnd();
+    if (!section.trim()) {
+        return { data: { error: 'Current Test section is empty' } };
+    }
+    if (/\[testing complete\]/i.test(section)) {
+        return { data: { error: 'UAT session is already complete; no pending checkpoint to render' } };
+    }
+    const numberMatch = section.match(/^number:\s*(\d+)\s*$/m);
+    const nameMatch = section.match(/^name:\s*(.+)\s*$/m);
+    const expectedBlockMatch = section.match(/^expected:\s*\|\n([\s\S]*?)(?=^\w[\w-]*:\s)/m)
+        || section.match(/^expected:\s*\|\n([\s\S]+)/m);
+    const expectedInlineMatch = section.match(/^expected:\s*(.+)\s*$/m);
+    if (!numberMatch || !nameMatch || (!expectedBlockMatch && !expectedInlineMatch)) {
+        return { data: { error: 'Current Test section is malformed' } };
+    }
+    let expectedRaw;
+    if (expectedBlockMatch) {
+        expectedRaw = expectedBlockMatch[1]
+            .split('\n')
+            .map(line => line.replace(/^ {2}/, ''))
+            .join('\n')
+            .trim();
+    }
+    else {
+        expectedRaw = expectedInlineMatch[1].trim();
+    }
+    const currentTest = {
+        complete: false,
+        number: parseInt(numberMatch[1], 10),
+        name: sanitizeForDisplay(nameMatch[1].trim()),
+        expected: sanitizeForDisplay(expectedRaw),
+    };
+    const checkpoint = buildUatCheckpoint(currentTest);
+    return {
+        data: {
+            file_path: toPosixPath(relative(projectDir, resolvedPath)),
+            test_number: currentTest.number,
+            test_name: currentTest.name,
+            checkpoint,
+        },
+    };
+};
+// ─── auditUat (cmdAuditUat) ────────────────────────────────────────────────
+/** Port of `categorizeItem` from `uat.cjs`. */
+function categorizeItem(result, reason, blockedBy) {
+    if (result === 'blocked' || blockedBy) {
+        if (blockedBy) {
+            if (/server/i.test(blockedBy))
+                return 'server_blocked';
+            if (/device|physical/i.test(blockedBy))
+                return 'device_needed';
+            if (/build|release|preview/i.test(blockedBy))
+                return 'build_needed';
+            if (/third.party|twilio|stripe/i.test(blockedBy))
+                return 'third_party';
+        }
+        return 'blocked';
+    }
+    if (result === 'skipped') {
+        if (reason) {
+            if (/server|not running|not available/i.test(reason))
+                return 'server_blocked';
+            if (/simulator|physical|device/i.test(reason))
+                return 'device_needed';
+            if (/build|release|preview/i.test(reason))
+                return 'build_needed';
+        }
+        return 'skipped_unresolved';
+    }
+    if (result === 'pending')
+        return 'pending';
+    if (result === 'human_needed')
+        return 'human_uat';
+    return 'unknown';
+}
+/** Port of `parseUatItems` from `uat.cjs`. */
+function parseUatItems(content) {
+    const items = [];
+    const testPattern = /###\s*(\d+)\.\s*([^\n]+)\nexpected:\s*([^\n]+)\nresult:\s*(\w+)(?:\n(?:reported|reason|blocked_by):\s*[^\n]*)?/g;
+    let match;
+    while ((match = testPattern.exec(content)) !== null) {
+        const [, num, name, expected, result] = match;
+        if (result === 'pending' || result === 'skipped' || result === 'blocked') {
+            const afterMatch = content.slice(match.index);
+            const nextHeading = afterMatch.indexOf('\n###', 1);
+            const blockText = nextHeading > 0 ? afterMatch.slice(0, nextHeading) : afterMatch;
+            const reasonMatch = blockText.match(/reason:\s*(.+)/);
+            const blockedByMatch = blockText.match(/blocked_by:\s*(.+)/);
+            const item = {
+                test: parseInt(num, 10),
+                name: name.trim(),
+                expected: expected.trim(),
+                result,
+                category: categorizeItem(result, reasonMatch?.[1], blockedByMatch?.[1]),
+            };
+            if (reasonMatch)
+                item.reason = reasonMatch[1].trim();
+            if (blockedByMatch)
+                item.blocked_by = blockedByMatch[1].trim();
+            items.push(item);
+        }
+    }
+    return items;
+}
+/**
+ * Parse frontmatter human_verification: YAML array entries into audit items.
+ *
+ * Fixes #2788: when gsd-verifier encodes human items in YAML frontmatter
+ * rather than the body, parseVerificationItems was returning [] because it
+ * only searched the body for a "## Human Verification" heading.
+ */
+export function parseVerificationFrontmatterItems(fm) {
+    const items = [];
+    const hvArray = fm.human_verification;
+    if (!Array.isArray(hvArray))
+        return items;
+    let i = 0;
+    for (const entry of hvArray) {
+        i++;
+        if (typeof entry === 'string') {
+            const name = entry.trim();
+            if (name.length > 0) {
+                items.push({ test: i, name, result: 'human_needed', category: 'human_uat' });
+            }
+        }
+        else if (typeof entry === 'object' && entry !== null) {
+            const obj = entry;
+            // Accept any string property as the item name; prefer 'test' key.
+            const name = obj.test || obj.name || '';
+            if (name) {
+                const item = {
+                    test: i,
+                    name: String(name).trim(),
+                    result: 'human_needed',
+                    category: 'human_uat',
+                };
+                if (obj.expected)
+                    item.expected = String(obj.expected).trim();
+                if (obj.why_human)
+                    item.why_human = String(obj.why_human).trim();
+                items.push(item);
+            }
+        }
+    }
+    return items;
+}
+/** Port of `parseVerificationItems` from `uat.cjs`. */
+function parseVerificationItems(content, status, fm) {
+    const items = [];
+    if (status === 'human_needed') {
+        // Check frontmatter human_verification: array first (#2788).
+        // gsd-verifier writes items here; body-section fallback is secondary.
+        if (fm) {
+            const fmItems = parseVerificationFrontmatterItems(fm);
+            if (fmItems.length > 0)
+                return fmItems;
+        }
+        // Body fallback: match ## human_verification or ## Human Verification
+        // (case-insensitive, underscore or space, with optional parenthetical).
+        const hvSection = content.match(/##\s*human[_\s-]verification[^\n]*\n([\s\S]*?)(?=\n##\s|\n---\s|$)/i);
+        if (hvSection) {
+            const lines = hvSection[1].split('\n');
+            for (const line of lines) {
+                const tableMatch = line.match(/\|\s*(\d+)\s*\|\s*([^|]+)/);
+                const bulletMatch = line.match(/^[-*]\s+(.+)/);
+                const numberedMatch = line.match(/^(\d+)\.\s+(.+)/);
+                if (tableMatch) {
+                    items.push({
+                        test: parseInt(tableMatch[1], 10),
+                        name: tableMatch[2].trim(),
+                        result: 'human_needed',
+                        category: 'human_uat',
+                    });
+                }
+                else if (numberedMatch) {
+                    items.push({
+                        test: parseInt(numberedMatch[1], 10),
+                        name: numberedMatch[2].trim(),
+                        result: 'human_needed',
+                        category: 'human_uat',
+                    });
+                }
+                else if (bulletMatch && bulletMatch[1].length > 10) {
+                    items.push({
+                        name: bulletMatch[1].trim(),
+                        result: 'human_needed',
+                        category: 'human_uat',
+                    });
+                }
+            }
+        }
+    }
+    return items;
+}
+/**
+ * Cross-phase UAT / VERIFICATION audit — port of `cmdAuditUat` (`uat.cjs`).
+ */
+export const auditUat = async (_args, projectDir, workstream) => {
+    const paths = planningPaths(projectDir, workstream);
+    if (!existsSync(paths.phases)) {
+        throw new GSDError('No phases directory found in planning directory', ErrorClassification.Blocked);
+    }
+    const isDirInMilestone = await getMilestonePhaseFilter(projectDir, workstream);
+    const results = [];
+    const dirs = readdirSync(paths.phases, { withFileTypes: true })
+        .filter(e => e.isDirectory())
+        .map(e => e.name)
+        .filter(isDirInMilestone)
+        .sort();
+    for (const dir of dirs) {
+        const phaseMatch = dir.match(/^(\d+[A-Z]?(?:\.\d+)*)/i);
+        const phaseNum = phaseMatch ? phaseMatch[1] : dir;
+        const phaseDir = join(paths.phases, dir);
+        const files = readdirSync(phaseDir);
+        for (const file of files.filter(f => f.includes('-UAT') && f.endsWith('.md'))) {
+            const content = readFileSync(join(phaseDir, file), 'utf-8');
+            const items = parseUatItems(content);
+            if (items.length > 0) {
+                const fm = extractFrontmatter(content);
+                results.push({
+                    phase: phaseNum,
+                    phase_dir: dir,
+                    file,
+                    file_path: toPosixPath(relative(projectDir, join(phaseDir, file))),
+                    type: 'uat',
+                    status: (fm.status || 'unknown'),
+                    items,
+                });
+            }
+        }
+        for (const file of files.filter(f => f.includes('-VERIFICATION') && f.endsWith('.md'))) {
+            const content = readFileSync(join(phaseDir, file), 'utf-8');
+            const fm = extractFrontmatter(content);
+            const status = (fm.status || 'unknown');
+            if (status === 'human_needed' || status === 'gaps_found') {
+                const items = parseVerificationItems(content, status, fm);
+                if (items.length > 0) {
+                    results.push({
+                        phase: phaseNum,
+                        phase_dir: dir,
+                        file,
+                        file_path: toPosixPath(relative(projectDir, join(phaseDir, file))),
+                        type: 'verification',
+                        status,
+                        items,
+                    });
+                }
+            }
+        }
+    }
+    const summary = {
+        total_files: results.length,
+        total_items: results.reduce((sum, r) => sum + r.items.length, 0),
+        by_category: {},
+        by_phase: {},
+    };
+    for (const r of results) {
+        if (!summary.by_phase[r.phase])
+            summary.by_phase[r.phase] = 0;
+        for (const item of r.items) {
+            summary.by_phase[r.phase]++;
+            const cat = item.category || 'unknown';
+            summary.by_category[cat] = (summary.by_category[cat] || 0) + 1;
+        }
+    }
+    return { data: { results, summary } };
+};
+//# sourceMappingURL=uat.js.map

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

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

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

@@ -0,0 +1,59 @@
+/**
+ * Utility query handlers — pure SDK implementations of simple commands.
+ *
+ * These handlers are direct TypeScript ports of gsd-tools.cjs functions:
+ * - `generateSlug` ← `cmdGenerateSlug` (commands.cjs lines 38-48)
+ * - `currentTimestamp` ← `cmdCurrentTimestamp` (commands.cjs lines 50-71)
+ *
+ * @example
+ * ```typescript
+ * import { generateSlug, currentTimestamp } from './utils.js';
+ *
+ * const slug = await generateSlug(['My Phase Name'], '/path/to/project');
+ * // { data: { slug: 'my-phase-name' } }
+ *
+ * const ts = await currentTimestamp(['date'], '/path/to/project');
+ * // { data: { timestamp: '2026-04-08' } }
+ * ```
+ */
+/** Structured result returned by all query handlers. */
+export interface QueryResult<T = unknown> {
+    data: T;
+    /**
+     * Output format hint for the CLI dispatcher.
+     * `'text'` — write `data` as-is to stdout (no JSON-stringify).
+     * `'json'` (default) — JSON-stringify as usual.
+     *
+     * Only meaningful when `data` is a string and the consumer is the CLI.
+     * Used by `agent-skills` so workflows embedding `$(gsd-sdk query …)` receive
+     * a raw `<agent_skills>` XML block rather than a JSON-quoted string.
+     */
+    format?: 'json' | 'text';
+}
+/** Signature for a query handler function. */
+export type QueryHandler<T = unknown> = (args: string[], projectDir: string, workstream?: string) => Promise<QueryResult<T>>;
+/**
+ * Converts text into a URL-safe kebab-case slug.
+ *
+ * Port of `cmdGenerateSlug` from `get-shit-done/bin/lib/commands.cjs`.
+ * Algorithm: lowercase, replace non-alphanumeric with hyphens,
+ * strip leading/trailing hyphens, truncate to 60 characters.
+ *
+ * @param args - `args[0]` is the text to slugify
+ * @param _projectDir - Unused (pure function)
+ * @returns Query result with `{ slug: string }`
+ * @throws GSDError with Validation classification if text is missing or empty
+ */
+export declare const generateSlug: QueryHandler;
+/**
+ * Returns the current timestamp in the requested format.
+ *
+ * Port of `cmdCurrentTimestamp` from `get-shit-done/bin/lib/commands.cjs`.
+ * Formats: `'full'` (ISO 8601), `'date'` (YYYY-MM-DD), `'filename'` (colons replaced).
+ *
+ * @param args - `args[0]` is the format (`'full'` | `'date'` | `'filename'`), defaults to `'full'`
+ * @param _projectDir - Unused (pure function)
+ * @returns Query result with `{ timestamp: string }`
+ */
+export declare const currentTimestamp: QueryHandler;
+//# sourceMappingURL=utils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/query/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAMH,wDAAwD;AACxD,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,OAAO;IACtC,IAAI,EAAE,CAAC,CAAC;IACR;;;;;;;;OAQG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CAC1B;AAED,8CAA8C;AAC9C,MAAM,MAAM,YAAY,CAAC,CAAC,GAAG,OAAO,IAAI,CACtC,IAAI,EAAE,MAAM,EAAE,EACd,UAAU,EAAE,MAAM,EAClB,UAAU,CAAC,EAAE,MAAM,KAChB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;AAI7B;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,EAAE,YAa1B,CAAC;AAIF;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,EAAE,YAmB9B,CAAC"}

package/sdk/dist/query/utils.js

@@ -0,0 +1,74 @@
+/**
+ * Utility query handlers — pure SDK implementations of simple commands.
+ *
+ * These handlers are direct TypeScript ports of gsd-tools.cjs functions:
+ * - `generateSlug` ← `cmdGenerateSlug` (commands.cjs lines 38-48)
+ * - `currentTimestamp` ← `cmdCurrentTimestamp` (commands.cjs lines 50-71)
+ *
+ * @example
+ * ```typescript
+ * import { generateSlug, currentTimestamp } from './utils.js';
+ *
+ * const slug = await generateSlug(['My Phase Name'], '/path/to/project');
+ * // { data: { slug: 'my-phase-name' } }
+ *
+ * const ts = await currentTimestamp(['date'], '/path/to/project');
+ * // { data: { timestamp: '2026-04-08' } }
+ * ```
+ */
+import { GSDError, ErrorClassification } from '../errors.js';
+// ─── generateSlug ───────────────────────────────────────────────────────────
+/**
+ * Converts text into a URL-safe kebab-case slug.
+ *
+ * Port of `cmdGenerateSlug` from `get-shit-done/bin/lib/commands.cjs`.
+ * Algorithm: lowercase, replace non-alphanumeric with hyphens,
+ * strip leading/trailing hyphens, truncate to 60 characters.
+ *
+ * @param args - `args[0]` is the text to slugify
+ * @param _projectDir - Unused (pure function)
+ * @returns Query result with `{ slug: string }`
+ * @throws GSDError with Validation classification if text is missing or empty
+ */
+export const generateSlug = async (args, _projectDir) => {
+    const text = args[0];
+    if (!text) {
+        throw new GSDError('text required for slug generation', ErrorClassification.Validation);
+    }
+    const slug = text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .substring(0, 60);
+    return { data: { slug } };
+};
+// ─── currentTimestamp ───────────────────────────────────────────────────────
+/**
+ * Returns the current timestamp in the requested format.
+ *
+ * Port of `cmdCurrentTimestamp` from `get-shit-done/bin/lib/commands.cjs`.
+ * Formats: `'full'` (ISO 8601), `'date'` (YYYY-MM-DD), `'filename'` (colons replaced).
+ *
+ * @param args - `args[0]` is the format (`'full'` | `'date'` | `'filename'`), defaults to `'full'`
+ * @param _projectDir - Unused (pure function)
+ * @returns Query result with `{ timestamp: string }`
+ */
+export const currentTimestamp = async (args, _projectDir) => {
+    const format = args[0] || 'full';
+    const now = new Date();
+    let result;
+    switch (format) {
+        case 'date':
+            result = now.toISOString().split('T')[0];
+            break;
+        case 'filename':
+            result = now.toISOString().replace(/:/g, '-').replace(/\..+/, '');
+            break;
+        case 'full':
+        default:
+            result = now.toISOString();
+            break;
+    }
+    return { data: { timestamp: result } };
+};
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/query/utils.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AA0B7D,+EAA+E;AAE/E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAiB,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE;IACpE,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACrB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,QAAQ,CAAC,mCAAmC,EAAE,mBAAmB,CAAC,UAAU,CAAC,CAAC;IAC1F,CAAC;IAED,MAAM,IAAI,GAAG,IAAI;SACd,WAAW,EAAE;SACb,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC;SAC3B,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEpB,OAAO,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,CAAC;AAC5B,CAAC,CAAC;AAEF,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAiB,KAAK,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE;IACxE,MAAM,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IACjC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,IAAI,MAAc,CAAC;IAEnB,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,MAAM;YACT,MAAM,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;YACzC,MAAM;QACR,KAAK,UAAU;YACb,MAAM,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAClE,MAAM;QACR,KAAK,MAAM,CAAC;QACZ;YACE,MAAM,GAAG,GAAG,CAAC,WAAW,EAAE,CAAC;YAC3B,MAAM;IACV,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;AACzC,CAAC,CAAC"}

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

@@ -0,0 +1,67 @@
+/**
+ * Validation query handlers — key-link verification and consistency checking.
+ *
+ * Ported from get-shit-done/bin/lib/verify.cjs.
+ * Provides key-link integration point verification and cross-file consistency
+ * detection as native TypeScript query handlers registered in the SDK query registry.
+ *
+ * @example
+ * ```typescript
+ * import { verifyKeyLinks, validateConsistency } from './validate.js';
+ *
+ * const result = await verifyKeyLinks(['path/to/plan.md'], '/project');
+ * // { data: { all_verified: true, verified: 1, total: 1, links: [...] } }
+ * ```
+ */
+import type { QueryHandler } from './utils.js';
+/**
+ * Build a RegExp for must_haves key_links pattern matching.
+ * Long or nested-quantifier patterns fall back to a literal match via escapeRegex.
+ */
+export declare function regexForKeyLinkPattern(pattern: string): RegExp;
+/**
+ * Verify key-link integration points from must_haves.key_links.
+ *
+ * Port of `cmdVerifyKeyLinks` from `verify.cjs` lines 338-396.
+ * Reads must_haves.key_links from plan frontmatter, checks source/target
+ * files for pattern matching or target reference presence.
+ *
+ * @param args - args[0]: plan file path (required)
+ * @param projectDir - Project root directory
+ * @returns QueryResult with { all_verified, verified, total, links }
+ * @throws GSDError with Validation classification if file path missing
+ */
+export declare const verifyKeyLinks: QueryHandler;
+/**
+ * Validate consistency between ROADMAP.md, disk phases, and plan frontmatter.
+ *
+ * Port of `cmdValidateConsistency` from `verify.cjs` lines 398-519.
+ * Checks ROADMAP/disk phase sync, sequential numbering, plan numbering gaps,
+ * summary/plan orphans, and frontmatter completeness.
+ *
+ * @param _args - No required args (operates on projectDir)
+ * @param projectDir - Project root directory
+ * @returns QueryResult with { passed, errors, warnings, warning_count }
+ */
+export declare const validateConsistency: QueryHandler;
+/**
+ * Health check with optional repair mode.
+ *
+ * Port of `cmdValidateHealth` from `verify.cjs` lines 522-921.
+ * Performs 10+ checks on .planning/ directory structure, config, state,
+ * and cross-file consistency. With `--repair` flag, can fix missing
+ * config.json, STATE.md, and nyquist key.
+ *
+ * @param args - Optional: '--repair' to perform repairs
+ * @param projectDir - Project root directory
+ * @returns QueryResult with { status, errors, warnings, info, repairable_count, repairs_performed? }
+ */
+export declare const validateHealth: QueryHandler;
+/**
+ * Validate GSD agent file installation under the managed agents directory.
+ *
+ * Port of `cmdValidateAgents` from `verify.cjs` lines 997–1009 (uses `checkAgentsInstalled` from core).
+ */
+export declare const validateAgents: QueryHandler;
+export declare const validateContext: QueryHandler;
+//# sourceMappingURL=validate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/query/validate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAWH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAmG/C;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgB9D;AAID;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,EAAE,YA0G5B,CAAC;AAIF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAkKjC,CAAC;AAIF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,EAAE,YAie5B,CAAC;AAcF;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,YAsC5B,CAAC;AA+BF,eAAO,MAAM,eAAe,EAAE,YAyB7B,CAAC"}