@opengsd/get-shit-done-redux 1.0.0

package/sdk/dist/query/phase-uat-passed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-uat-passed.d.ts","sourceRoot":"","sources":["../../src/query/phase-uat-passed.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,OAAO,EAAE,QAAQ,EAAuB,MAAM,cAAc,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,WAAW;;;;;;;;;EASb,CAAC;AAEZ,MAAM,MAAM,UAAU,GAAG,OAAO,WAAW,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC;AAEtE,eAAO,MAAM,UAAU;;;EAGZ,CAAC;AACZ,MAAM,MAAM,SAAS,GAAG,OAAO,UAAU,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC;AAEnE,qBAAa,mBAAoB,SAAQ,QAAQ;aACF,IAAI,EAAE,SAAS;gBAAhD,OAAO,EAAE,MAAM,EAAkB,IAAI,EAAE,SAAS;CAG7D;AAED,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAyGF,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC;IACT,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC;CAClC,CAAC,CAyHD;AAED;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,YAU5B,CAAC"}

package/sdk/dist/query/phase-uat-passed.js

@@ -0,0 +1,238 @@
+/**
+ * isPhaseUatPassed — SDK predicate answering "is phase N's UAT contract satisfied?"
+ * Implements the isPhaseUatPassed predicate per #3184.
+ */
+import { readFile, readdir, stat } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { resolvePhaseDir } from './phase-list-queries.js';
+import { extractFrontmatter } from './frontmatter.js';
+import { parseVerificationFrontmatterItems } from './uat.js';
+import { GSDError, ErrorClassification } from '../errors.js';
+export const REASON_CODE = Object.freeze({
+    NON_PASS_RESULT: 'non_pass_result',
+    CASE_MISMATCH: 'case_mismatch',
+    HUMAN_VERIFICATION_NEEDED: 'human_verification_needed',
+    ORPHAN_ITEM_MISSING_RESULT: 'orphan_item_missing_result',
+    BRACKETED_PLACEHOLDER: 'bracketed_placeholder',
+    NO_ITEMS_EXTRACTED: 'no_items_extracted',
+    NO_PHASE_DIR: 'no_phase_dir',
+    NO_UAT_FILES: 'no_uat_files',
+});
+export const ERROR_CODE = Object.freeze({
+    PROJECT_DIR_MISSING: 'project_dir_missing',
+    INVALID_PHASE_NUM: 'invalid_phase_num',
+});
+export class PhaseUatPassedError extends GSDError {
+    code;
+    constructor(message, code) {
+        super(message, ErrorClassification.Validation);
+        this.code = code;
+    }
+}
+/** Regex to parse all UAT items regardless of result value.
+ *  Accepts optional bold markers (**key:**) around expected/result keys. */
+const UAT_ITEM_PATTERN = /###\s*(\d+)\.\s*([^\n]+)\n(?:\*\*)?expected:(?:\*\*)?\s*([^\n]+)\n(?:\*\*)?result:(?:\*\*)?\s*(\w+)/g;
+/**
+ * Strip regions from file content that could contain markdown-shaped text
+ * but should not be treated as UAT items (frontmatter, code fences, etc.).
+ * Passes are applied in order; each returns a sanitised string.
+ */
+function stripMarkdownInjection(content) {
+    // Pass 1: strip YAML frontmatter region (---\n...\n---). No /m flag — ^ must
+    // anchor to position 0 only, preventing mid-body --- separators from triggering.
+    let s = content.replace(/^---\r?\n[\s\S]*?\r?\n---/, '');
+    // Pass 2: strip fenced code blocks (``` ... ```)
+    s = s.replace(/```[\s\S]*?```/g, '');
+    // Pass 3: strip HTML comment regions (<!-- ... -->)
+    s = s.replace(/<!--[\s\S]*?-->/g, '');
+    // Pass 4: strip blockquote-prefixed lines (any line starting with optional whitespace + >)
+    s = s.replace(/^\s*>.*$/gm, '');
+    return s;
+}
+/**
+ * Parse all UAT items from already-stripped content.
+ * Callers must pass pre-stripped (sanitised) content — no internal strip is performed.
+ */
+function parseAllUatItems(sanitised) {
+    const items = [];
+    UAT_ITEM_PATTERN.lastIndex = 0;
+    let m;
+    while ((m = UAT_ITEM_PATTERN.exec(sanitised)) !== null) {
+        const [, num, name, expected, result] = m;
+        items.push({
+            test: parseInt(num, 10),
+            name: name.trim(),
+            expected: expected.trim(),
+            result,
+        });
+    }
+    UAT_ITEM_PATTERN.lastIndex = 0;
+    return items;
+}
+/** Build a human-readable string for a single UatReason. */
+function humanizeReason(r) {
+    switch (r.code) {
+        case REASON_CODE.CASE_MISMATCH:
+            return `"${r.itemName ?? 'item'}" has a case-mismatched result ("${r.capturedValue ?? ''}" — expected "pass")`;
+        case REASON_CODE.NON_PASS_RESULT:
+            return `"${r.itemName ?? 'item'}" has result "${r.capturedValue ?? 'unknown'}" (expected "pass")`;
+        case REASON_CODE.NO_ITEMS_EXTRACTED:
+            return `${r.file ?? 'file'} contained no UAT items`;
+        case REASON_CODE.NO_PHASE_DIR:
+            return 'Phase directory not found';
+        case REASON_CODE.NO_UAT_FILES:
+            return 'No *-HUMAN-UAT.md files found in the phase directory';
+        case REASON_CODE.HUMAN_VERIFICATION_NEEDED:
+            return `"${r.itemName ?? 'item'}" requires manual human verification`;
+        case REASON_CODE.BRACKETED_PLACEHOLDER:
+            return `"${r.itemName ?? 'item'}" has an unfilled placeholder result: ${r.capturedValue ?? ''}`;
+        case REASON_CODE.ORPHAN_ITEM_MISSING_RESULT:
+            return `"${r.itemName ?? 'item'}" is missing a result field`;
+        default:
+            return `${r.code}: ${JSON.stringify(r)}`;
+    }
+}
+const HEADING_PATTERN = /###\s*(\d+)\.\s*([^\n]+)/g;
+/**
+ * Scan stripped body for `### N. Name` headings whose number is NOT represented
+ * in the set of captured item numbers. Returns orphan entries.
+ * Headings that have a bracketed result line are excluded here — they will be
+ * handled by bracketed-placeholder detection (cycle 13).
+ */
+function findOrphanHeadings(strippedBody, capturedNumbers, brackPlaceholderNumbers) {
+    const orphans = [];
+    HEADING_PATTERN.lastIndex = 0;
+    let m;
+    while ((m = HEADING_PATTERN.exec(strippedBody)) !== null) {
+        const num = parseInt(m[1], 10);
+        const name = m[2].trim();
+        if (!capturedNumbers.has(num) && !brackPlaceholderNumbers.has(num)) {
+            orphans.push({ num, name });
+        }
+    }
+    HEADING_PATTERN.lastIndex = 0;
+    return orphans;
+}
+export async function isPhaseUatPassed(projectDir, phase, workstream) {
+    try {
+        await stat(projectDir);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT') {
+            throw new PhaseUatPassedError(`projectDir does not exist: ${projectDir}`, ERROR_CODE.PROJECT_DIR_MISSING);
+        }
+        throw err;
+    }
+    const dir = await resolvePhaseDir(phase, projectDir, workstream);
+    if (!dir) {
+        const reasons = [{ code: REASON_CODE.NO_PHASE_DIR }];
+        return {
+            passed: false,
+            reasons,
+            reasonsHuman: reasons.map(humanizeReason),
+            items: [],
+        };
+    }
+    const files = await readdir(dir);
+    const uatFiles = files.filter((f) => f.endsWith('-HUMAN-UAT.md'));
+    if (uatFiles.length === 0) {
+        const reasons = [{ code: REASON_CODE.NO_UAT_FILES }];
+        return {
+            passed: false,
+            reasons,
+            reasonsHuman: reasons.map(humanizeReason),
+            items: [],
+        };
+    }
+    const items = [];
+    const reasons = [];
+    for (const file of uatFiles) {
+        const filePath = join(dir, file);
+        const relFile = relative(projectDir, filePath);
+        const content = await readFile(filePath, 'utf-8');
+        const strippedBody = stripMarkdownInjection(content);
+        const itemsBeforeFile = items.length;
+        const reasonsBeforeFile = reasons.length;
+        const parsed = parseAllUatItems(strippedBody);
+        for (const item of parsed) {
+            items.push(item);
+            if (item.result !== 'pass') {
+                const code = item.result.toLowerCase() === 'pass'
+                    ? REASON_CODE.CASE_MISMATCH
+                    : REASON_CODE.NON_PASS_RESULT;
+                reasons.push({
+                    code,
+                    file: relFile,
+                    itemName: item.name,
+                    capturedValue: item.result,
+                });
+            }
+        }
+        // Detect bracketed placeholders (cycle 13): headings with result: [value]
+        const brackPlaceholderNumbers = new Set();
+        const BRACK_RESULT_PATTERN = /result:\s*\[(\w+)\]/g;
+        let bm;
+        BRACK_RESULT_PATTERN.lastIndex = 0;
+        while ((bm = BRACK_RESULT_PATTERN.exec(strippedBody)) !== null) {
+            // find nearest preceding heading
+            const before = strippedBody.slice(0, bm.index);
+            const headingMatch = before.match(/###\s*(\d+)\.\s*([^\n]+)\s*$/m);
+            if (headingMatch) {
+                const num = parseInt(headingMatch[1], 10);
+                const name = headingMatch[2].trim();
+                brackPlaceholderNumbers.add(num);
+                reasons.push({
+                    code: REASON_CODE.BRACKETED_PLACEHOLDER,
+                    file: relFile,
+                    itemName: name,
+                    capturedValue: `[${bm[1]}]`,
+                });
+            }
+        }
+        // Detect orphan headings: headings with no captured item and no bracketed result.
+        const capturedNumbers = new Set(parsed.map((i) => i.test));
+        const orphans = findOrphanHeadings(strippedBody, capturedNumbers, brackPlaceholderNumbers);
+        for (const orphan of orphans) {
+            reasons.push({
+                code: REASON_CODE.ORPHAN_ITEM_MISSING_RESULT,
+                file: relFile,
+                itemName: orphan.name,
+            });
+        }
+        // Merge frontmatter human_verification items into the roster.
+        const fm = extractFrontmatter(content);
+        const fmItems = parseVerificationFrontmatterItems(fm);
+        for (const fmItem of fmItems) {
+            const name = String(fmItem.name ?? '');
+            // Add a synthetic UatItem so items.length is accurate.
+            items.push({ test: -1, name, expected: String(fmItem.expected ?? ''), result: 'human_needed' });
+            reasons.push({
+                code: REASON_CODE.HUMAN_VERIFICATION_NEEDED,
+                file: relFile,
+                itemName: name,
+                capturedValue: 'human_needed',
+            });
+        }
+        // If this file contributed no items and no diagnostic reasons, flag it.
+        if (items.length === itemsBeforeFile && reasons.length === reasonsBeforeFile) {
+            reasons.push({ code: REASON_CODE.NO_ITEMS_EXTRACTED, file: relFile });
+        }
+    }
+    const passed = items.length > 0 && reasons.length === 0;
+    return { passed, reasons, reasonsHuman: reasons.map(humanizeReason), items };
+}
+/**
+ * QueryHandler adapter for `phase.uat-passed` registry entry.
+ *
+ * args[0] — phase token (required, e.g. '5' or '05-walking-skeleton').
+ * Matches the args convention used by phase.list-plans / phase.list-artifacts.
+ */
+export const phaseUatPassed = async (args, projectDir, workstream) => {
+    const phase = args[0];
+    if (typeof phase !== 'string' || phase.trim() === '') {
+        throw new PhaseUatPassedError('phase argument is required', ERROR_CODE.INVALID_PHASE_NUM);
+    }
+    const result = await isPhaseUatPassed(projectDir, phase, workstream);
+    return { data: result };
+};
+//# sourceMappingURL=phase-uat-passed.js.map

package/sdk/dist/query/phase-uat-passed.js.map

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

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

@@ -0,0 +1,104 @@
+/**
+ * Phase finding and plan index query handlers.
+ *
+ * Ported from get-shit-done/bin/lib/phase.cjs and core.cjs.
+ * Provides find-phase (directory lookup with archived fallback)
+ * and phase-plan-index (plan metadata with wave grouping).
+ *
+ * @example
+ * ```typescript
+ * import { findPhase, phasePlanIndex } from './phase.js';
+ *
+ * const found = await findPhase(['9'], '/project');
+ * // { data: { found: true, directory: '.planning/phases/09-foundation', ... } }
+ *
+ * const index = await phasePlanIndex(['9'], '/project');
+ * // { data: { phase: '09', plans: [...], waves: { '1': [...] }, ... } }
+ * ```
+ */
+import type { QueryHandler } from './utils.js';
+interface PhaseInfo {
+    found: boolean;
+    directory: string | null;
+    phase_number: string | null;
+    phase_name: string | null;
+    phase_slug: string | null;
+    plans: string[];
+    summaries: string[];
+    incomplete_plans: string[];
+    has_research: boolean;
+    has_context: boolean;
+    has_verification: boolean;
+    has_reviews: boolean;
+    archived?: string;
+    /**
+     * #2893 — non-canonical plan filename warning (singular). Present only when
+     * a plan-shaped file in this phase dir is not the canonical
+     * `{padded_phase}-{NN}-PLAN.md` shape; the executor surfaces this so users
+     * see a loud signal instead of plan_count: 0 with no clue why.
+     */
+    warning?: string;
+}
+/**
+ * #2893 — canonical plan filename predicate and the diagnostic "looks like a
+ * plan but isn't canonical" net. Centralised so every read site (find-phase,
+ * phase-plan-index, phases list --type plans) emits the same warning message.
+ *
+ * Mirrors get-shit-done/bin/lib/phase.cjs lines 17–52.
+ */
+export declare const isCanonicalPlanFile: (f: string) => boolean;
+/**
+ * Build the canonical "non-canonical plan files" warning string used by every
+ * SDK read site. Returns null when there are no offenders.
+ *
+ * Format mirrors describeNonCanonicalPlans in phase.cjs so consumers see the
+ * same message regardless of which entry point they call.
+ */
+export declare function describeNonCanonicalPlans(dirFiles: string[], matchedFiles: string[]): string | null;
+/**
+ * Locate a phase by number without the QueryHandler wrapper.
+ *
+ * Returns the PhaseInfo (including phase_number, phase_slug) for the given
+ * phase identifier, or null when the phase cannot be found.  Searches current
+ * phases first, then archived milestone phase directories (newest-first) —
+ * identical logic to the `findPhase` QueryHandler and the CJS
+ * `findPhaseInternal` from core.cjs lines 838-874.
+ *
+ * Exported so that `commit.ts` can call it without going through the full
+ * QueryHandler dispatch stack (which would require a registered query context).
+ *
+ * @param projectDir - Project root directory
+ * @param phase      - Phase identifier string (e.g. "1", "02", "2.1")
+ * @param workstream - Optional workstream scope
+ */
+export declare function findPhaseByNumber(projectDir: string, phase: string, workstream?: string): Promise<PhaseInfo | null>;
+/**
+ * Query handler for find-phase.
+ *
+ * Locates a phase directory by number/identifier, searching current phases
+ * first, then archived milestone phases.
+ *
+ * Port of cmdFindPhase from phase.cjs lines 152-196, combined with
+ * findPhaseInternal from core.cjs lines 1002-1038.
+ *
+ * @param args - args[0] is the phase identifier (required)
+ * @param projectDir - Project root directory
+ * @returns QueryResult with PhaseInfo
+ * @throws GSDError with Validation classification if phase identifier missing
+ */
+export declare const findPhase: QueryHandler;
+/**
+ * Query handler for phase-plan-index.
+ *
+ * Returns plan metadata with wave grouping for a specific phase.
+ *
+ * Port of cmdPhasePlanIndex from phase.cjs lines 203-310.
+ *
+ * @param args - args[0] is the phase identifier (required)
+ * @param projectDir - Project root directory
+ * @returns QueryResult with { phase, plans[], waves{}, incomplete[], has_checkpoints }
+ * @throws GSDError with Validation classification if phase identifier missing
+ */
+export declare const phasePlanIndex: QueryHandler;
+export {};
+//# sourceMappingURL=phase.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"phase.d.ts","sourceRoot":"","sources":["../../src/query/phase.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAeH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAqE/C,UAAU,SAAS;IACjB,KAAK,EAAE,OAAO,CAAC;IACf,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,GAAG,MAAM,KAAG,OAAoD,CAAC;AAUrG;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CAWnG;AAmHD;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,MAAM,GAClB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAkC3B;AAID;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,SAAS,EAAE,YA4DvB,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,cAAc,EAAE,YA8T5B,CAAC"}