@opengsd/get-shit-done-redux 1.0.0

package/sdk/dist/query/mutation-event-mapper.js

@@ -0,0 +1,70 @@
+import { GSDEventType, } from '../types.js';
+const FAMILY_RULES = [
+    { family: 'template', matches: (cmd) => cmd.startsWith('template.') || cmd.startsWith('template ') },
+    { family: 'git', matches: (cmd) => cmd === 'commit' || cmd === 'check-commit' || cmd === 'commit-to-subrepo' },
+    { family: 'frontmatter', matches: (cmd) => cmd.startsWith('frontmatter.') || cmd.startsWith('frontmatter ') },
+    { family: 'config', matches: (cmd) => cmd.startsWith('config-') },
+    { family: 'validate', matches: (cmd) => cmd.startsWith('validate.') || cmd.startsWith('validate ') },
+    { family: 'phase', matches: (cmd) => cmd.startsWith('phase.') || cmd.startsWith('phase ') || cmd.startsWith('phases.') || cmd.startsWith('phases ') },
+    { family: 'state', matches: (cmd) => cmd.startsWith('state.') || cmd.startsWith('state ') },
+];
+function resolveFamily(cmd) {
+    return FAMILY_RULES.find((rule) => rule.matches(cmd))?.family ?? 'default';
+}
+export function buildMutationEvent(correlationSessionId, cmd, args, result) {
+    const base = {
+        timestamp: new Date().toISOString(),
+        sessionId: correlationSessionId,
+    };
+    switch (resolveFamily(cmd)) {
+        case 'template': {
+            const data = result.data;
+            return {
+                ...base,
+                type: GSDEventType.TemplateFill,
+                templateType: data?.template ?? args[0] ?? '',
+                path: data?.path ?? args[1] ?? '',
+                created: data?.created ?? false,
+            };
+        }
+        case 'git': {
+            const data = result.data;
+            return {
+                ...base,
+                type: GSDEventType.GitCommit,
+                hash: data?.hash ?? null,
+                committed: data?.committed ?? false,
+                reason: data?.reason ?? '',
+            };
+        }
+        case 'frontmatter':
+            return {
+                ...base,
+                type: GSDEventType.FrontmatterMutation,
+                command: cmd,
+                file: args[0] ?? '',
+                fields: args.slice(1),
+                success: true,
+            };
+        case 'config':
+        case 'validate':
+            return {
+                ...base,
+                type: GSDEventType.ConfigMutation,
+                command: cmd,
+                key: args[0] ?? '',
+                success: true,
+            };
+        case 'phase':
+        case 'state':
+        case 'default':
+            return {
+                ...base,
+                type: GSDEventType.StateMutation,
+                command: cmd,
+                fields: args.slice(0, 2),
+                success: true,
+            };
+    }
+}
+//# sourceMappingURL=mutation-event-mapper.js.map

package/sdk/dist/query/mutation-event-mapper.js.map

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

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

@@ -0,0 +1,113 @@
+/**
+ * MVP-mode query handlers — three centralized seams for the MVP umbrella feature (#2826).
+ *
+ * Replaces three architectural duplications surfaced by the v1.50.0-canary.2 review:
+ *
+ * 1. **`phase.mvp-mode`** — resolves the precedence chain
+ *    `--mvp` CLI flag → ROADMAP `**Mode:** mvp` → `workflow.mvp_mode` config → false.
+ *    Replaces near-identical bash blocks in `plan-phase.md`, `execute-phase.md`,
+ *    `verify-work.md`, `progress.md`. Single canonical resolution; workflows just
+ *    call the verb and read the boolean.
+ *
+ * 2. **`task.is-behavior-adding`** — applies the three-check predicate
+ *    (tdd=true frontmatter AND `<behavior>` block AND non-test source files in `<files>`)
+ *    that was previously prose-only in `references/execute-mvp-tdd.md`. The gsd-executor
+ *    agent now invokes the verb instead of inlining the checks.
+ *
+ * 3. **`user-story.validate`** — applies the canonical user-story regex
+ *    `/^As a .+, I want to .+, so that .+\.$/` previously hardcoded in `verify-work.md`
+ *    prose. Consumed by the verifier (phase-goal guard) and by `/gsd-mvp-phase`
+ *    (interactive-prompt validation).
+ *
+ * Domain terms: see CONTEXT.md → MVP Mode, User Story, Behavior-Adding Task.
+ * Concept index: get-shit-done/references/mvp-concepts.md.
+ */
+import type { QueryHandler } from './utils.js';
+export type MvpModeSource = 'cli_flag' | 'roadmap' | 'config' | 'none';
+interface MvpModeResult {
+    /** True when MVP mode applies to the phase. */
+    active: boolean;
+    /** Which signal in the precedence chain decided the result. */
+    source: MvpModeSource;
+    /** The literal value seen in ROADMAP.md `**Mode:**` (lowercased), or null when the field is absent. */
+    roadmap_mode: string | null;
+    /** The `workflow.mvp_mode` config value seen at resolution time. */
+    config_mvp_mode: boolean;
+    /** True when the caller indicated the `--mvp` CLI flag was present. */
+    cli_flag_present: boolean;
+}
+/**
+ * Resolve MVP mode for a phase. Precedence (first hit wins):
+ *   1. `--cli-flag` arg on this verb (caller asserts the user passed `--mvp`)
+ *   2. ROADMAP.md `**Mode:** mvp` for the phase
+ *   3. `workflow.mvp_mode` config (project-wide default)
+ *   4. false
+ *
+ * @example
+ *   gsd-sdk query phase.mvp-mode 1                    # roadmap + config check
+ *   gsd-sdk query phase.mvp-mode 1 --cli-flag         # caller saw --mvp on CLI
+ */
+export declare const phaseMvpMode: QueryHandler<MvpModeResult>;
+interface BehaviorAddingResult {
+    /** True when ALL three predicate checks pass. */
+    is_behavior_adding: boolean;
+    /** Per-check breakdown — useful for halt-and-report messages. */
+    checks: {
+        tdd_true: boolean;
+        has_behavior_block: boolean;
+        has_source_files: boolean;
+    };
+    /** Human-readable reason when `is_behavior_adding` is false. */
+    reason: string | null;
+}
+/**
+ * Predicate: does this PLAN.md task add user-visible behavior under MVP+TDD?
+ *
+ * Three checks, all required:
+ *   (1) `tdd="true"` frontmatter
+ *   (2) `<behavior>` block names a user-visible outcome (block exists and is non-empty)
+ *   (3) `<files>` includes at least one non-test source file
+ *       (excludes `*.md`, `*.json`, `*.test.*`, `*.spec.*`)
+ *
+ * Pure doc-only / config-only / test-only tasks return `is_behavior_adding=false`
+ * and are exempt from the MVP+TDD Gate.
+ *
+ * Canonical specification: get-shit-done/references/execute-mvp-tdd.md.
+ *
+ * @example
+ *   gsd-sdk query task.is-behavior-adding ./plans/01-PLAN-auth.md
+ *   gsd-sdk query task.is-behavior-adding --task-content "<task>...</task>"
+ */
+export declare const taskIsBehaviorAdding: QueryHandler<BehaviorAddingResult>;
+interface UserStoryValidateResult {
+    /** True when the input matches the canonical user-story regex. */
+    valid: boolean;
+    /** The literal input string echoed back. */
+    input: string;
+    /** Per-slot extraction when `valid` is true; null when invalid. */
+    slots: {
+        role: string;
+        capability: string;
+        outcome: string;
+    } | null;
+    /** Specific guidance when `valid` is false. */
+    errors: string[];
+}
+/**
+ * The canonical User Story regex — exported so unit tests can assert it directly
+ * and other modules can import it without re-defining.
+ *
+ * Pattern: `As a [role], I want to [capability], so that [outcome].`
+ */
+export declare const USER_STORY_REGEX: RegExp;
+/**
+ * Validate that a string matches the User Story format used by MVP-mode phases.
+ * Used by `gsd-verifier` (phase-goal guard) and `/gsd-mvp-phase` (interactive prompting).
+ *
+ * @example
+ *   gsd-sdk query user-story.validate "As a user, I want to log in, so that I can see my data."
+ *   gsd-sdk query user-story.validate --story "<text>"
+ */
+export declare const userStoryValidate: QueryHandler<UserStoryValidateResult>;
+export {};
+//# sourceMappingURL=mvp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mvp.d.ts","sourceRoot":"","sources":["../../src/query/mvp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AASH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI/C,MAAM,MAAM,aAAa,GAAG,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEvE,UAAU,aAAa;IACrB,+CAA+C;IAC/C,MAAM,EAAE,OAAO,CAAC;IAChB,+DAA+D;IAC/D,MAAM,EAAE,aAAa,CAAC;IACtB,uGAAuG;IACvG,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oEAAoE;IACpE,eAAe,EAAE,OAAO,CAAC;IACzB,uEAAuE;IACvE,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,YAAY,EAAE,YAAY,CAAC,aAAa,CA4CpD,CAAC;AAIF,UAAU,oBAAoB;IAC5B,iDAAiD;IACjD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iEAAiE;IACjE,MAAM,EAAE;QACN,QAAQ,EAAE,OAAO,CAAC;QAClB,kBAAkB,EAAE,OAAO,CAAC;QAC5B,gBAAgB,EAAE,OAAO,CAAC;KAC3B,CAAC;IACF,gEAAgE;IAChE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,oBAAoB,EAAE,YAAY,CAAC,oBAAoB,CA+EnE,CAAC;AAIF,UAAU,uBAAuB;IAC/B,kEAAkE;IAClE,KAAK,EAAE,OAAO,CAAC;IACf,4CAA4C;IAC5C,KAAK,EAAE,MAAM,CAAC;IACd,mEAAmE;IACnE,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACpE,+CAA+C;IAC/C,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,QAAiF,CAAC;AAE/G;;;;;;;GAOG;AACH,eAAO,MAAM,iBAAiB,EAAE,YAAY,CAAC,uBAAuB,CAwCnE,CAAC"}

package/sdk/dist/query/mvp.js

@@ -0,0 +1,225 @@
+/**
+ * MVP-mode query handlers — three centralized seams for the MVP umbrella feature (#2826).
+ *
+ * Replaces three architectural duplications surfaced by the v1.50.0-canary.2 review:
+ *
+ * 1. **`phase.mvp-mode`** — resolves the precedence chain
+ *    `--mvp` CLI flag → ROADMAP `**Mode:** mvp` → `workflow.mvp_mode` config → false.
+ *    Replaces near-identical bash blocks in `plan-phase.md`, `execute-phase.md`,
+ *    `verify-work.md`, `progress.md`. Single canonical resolution; workflows just
+ *    call the verb and read the boolean.
+ *
+ * 2. **`task.is-behavior-adding`** — applies the three-check predicate
+ *    (tdd=true frontmatter AND `<behavior>` block AND non-test source files in `<files>`)
+ *    that was previously prose-only in `references/execute-mvp-tdd.md`. The gsd-executor
+ *    agent now invokes the verb instead of inlining the checks.
+ *
+ * 3. **`user-story.validate`** — applies the canonical user-story regex
+ *    `/^As a .+, I want to .+, so that .+\.$/` previously hardcoded in `verify-work.md`
+ *    prose. Consumed by the verifier (phase-goal guard) and by `/gsd-mvp-phase`
+ *    (interactive-prompt validation).
+ *
+ * Domain terms: see CONTEXT.md → MVP Mode, User Story, Behavior-Adding Task.
+ * Concept index: get-shit-done/references/mvp-concepts.md.
+ */
+import { readFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { relative, resolve, sep } from 'node:path';
+import { GSDError, ErrorClassification } from '../errors.js';
+import { loadConfig } from '../config.js';
+import { roadmapGetPhase } from './roadmap.js';
+/**
+ * Resolve MVP mode for a phase. Precedence (first hit wins):
+ *   1. `--cli-flag` arg on this verb (caller asserts the user passed `--mvp`)
+ *   2. ROADMAP.md `**Mode:** mvp` for the phase
+ *   3. `workflow.mvp_mode` config (project-wide default)
+ *   4. false
+ *
+ * @example
+ *   gsd-sdk query phase.mvp-mode 1                    # roadmap + config check
+ *   gsd-sdk query phase.mvp-mode 1 --cli-flag         # caller saw --mvp on CLI
+ */
+export const phaseMvpMode = async (args, projectDir, workstream) => {
+    const phaseNum = args[0];
+    if (!phaseNum) {
+        throw new GSDError('Usage: phase.mvp-mode <phase-number> [--cli-flag]', ErrorClassification.Validation);
+    }
+    const cliFlagPresent = args.includes('--cli-flag');
+    // Precedence #2: ROADMAP.md
+    const phaseResult = await roadmapGetPhase([phaseNum], projectDir, workstream);
+    const phaseData = phaseResult.data;
+    const roadmapMode = phaseData.found && typeof phaseData.mode === 'string'
+        ? phaseData.mode.trim().toLowerCase()
+        : null;
+    // Precedence #3: config
+    const config = await loadConfig(projectDir, workstream);
+    const wf = (config.workflow ?? {});
+    const configMvpMode = Boolean(wf.mvp_mode ?? false);
+    let active = false;
+    let source = 'none';
+    if (cliFlagPresent) {
+        active = true;
+        source = 'cli_flag';
+    }
+    else if (roadmapMode === 'mvp') {
+        active = true;
+        source = 'roadmap';
+    }
+    else if (configMvpMode) {
+        active = true;
+        source = 'config';
+    }
+    return {
+        data: {
+            active,
+            source,
+            roadmap_mode: roadmapMode,
+            config_mvp_mode: configMvpMode,
+            cli_flag_present: cliFlagPresent,
+        },
+    };
+};
+/**
+ * Predicate: does this PLAN.md task add user-visible behavior under MVP+TDD?
+ *
+ * Three checks, all required:
+ *   (1) `tdd="true"` frontmatter
+ *   (2) `<behavior>` block names a user-visible outcome (block exists and is non-empty)
+ *   (3) `<files>` includes at least one non-test source file
+ *       (excludes `*.md`, `*.json`, `*.test.*`, `*.spec.*`)
+ *
+ * Pure doc-only / config-only / test-only tasks return `is_behavior_adding=false`
+ * and are exempt from the MVP+TDD Gate.
+ *
+ * Canonical specification: get-shit-done/references/execute-mvp-tdd.md.
+ *
+ * @example
+ *   gsd-sdk query task.is-behavior-adding ./plans/01-PLAN-auth.md
+ *   gsd-sdk query task.is-behavior-adding --task-content "<task>...</task>"
+ */
+export const taskIsBehaviorAdding = async (args, projectDir) => {
+    let content = null;
+    if (args[0] === '--task-content') {
+        content = args[1] ?? null;
+    }
+    else if (args[0]) {
+        const requestedPath = args[0];
+        const projectRoot = resolve(projectDir ?? process.cwd());
+        const resolvedTaskPath = resolve(projectRoot, requestedPath);
+        const rel = relative(projectRoot, resolvedTaskPath);
+        if (rel === '..' || rel.startsWith(`..${sep}`)) {
+            throw new GSDError(`Task file is outside project scope: ${requestedPath}`, ErrorClassification.Validation);
+        }
+        if (!existsSync(resolvedTaskPath)) {
+            throw new GSDError(`Task file not found: ${requestedPath}`, ErrorClassification.Validation);
+        }
+        content = await readFile(resolvedTaskPath, 'utf-8');
+    }
+    if (!content) {
+        throw new GSDError('Usage: task.is-behavior-adding <plan-file-path> | --task-content "<xml>"', ErrorClassification.Validation);
+    }
+    // Check 1: tdd="true" — accept either single or double quotes, case-insensitive.
+    const tddTrue = /\btdd\s*=\s*["']true["']/i.test(content);
+    // Check 2: <behavior>...</behavior> block exists and is non-empty after trim.
+    const behaviorMatch = content.match(/<behavior>([\s\S]*?)<\/behavior>/i);
+    const hasBehaviorBlock = Boolean(behaviorMatch && behaviorMatch[1].trim().length > 0);
+    // Check 3: <files>...</files> includes at least one source file
+    // (anything that is NOT *.md, *.json, *.test.*, *.spec.*).
+    const filesMatch = content.match(/<files>([\s\S]*?)<\/files>/i);
+    let hasSourceFiles = false;
+    if (filesMatch) {
+        const filesBody = filesMatch[1];
+        const fileLines = filesBody
+            .split(/[\n,]/)
+            .map(l => l.trim().replace(/^[-*]\s*/, ''))
+            .filter(Boolean);
+        hasSourceFiles = fileLines.some(f => !/\.md$/i.test(f) &&
+            !/\.json$/i.test(f) &&
+            !/\.test\.[^.]+$/i.test(f) &&
+            !/\.spec\.[^.]+$/i.test(f) &&
+            !/(^|[\\/])tests?[\\/]/i.test(f) &&
+            !/\.(yml|yaml|toml|ini|cfg|conf|properties)$/i.test(f) &&
+            !/(^|[\\/])\.env(\..+)?$/i.test(f));
+    }
+    const isBehaviorAdding = tddTrue && hasBehaviorBlock && hasSourceFiles;
+    let reason = null;
+    if (!isBehaviorAdding) {
+        const missing = [];
+        if (!tddTrue)
+            missing.push('tdd="true" frontmatter absent');
+        if (!hasBehaviorBlock)
+            missing.push('<behavior> block missing or empty');
+        if (!hasSourceFiles)
+            missing.push('<files> has no non-test source file');
+        reason = `Not behavior-adding: ${missing.join('; ')}`;
+    }
+    return {
+        data: {
+            is_behavior_adding: isBehaviorAdding,
+            checks: {
+                tdd_true: tddTrue,
+                has_behavior_block: hasBehaviorBlock,
+                has_source_files: hasSourceFiles,
+            },
+            reason,
+        },
+    };
+};
+/**
+ * The canonical User Story regex — exported so unit tests can assert it directly
+ * and other modules can import it without re-defining.
+ *
+ * Pattern: `As a [role], I want to [capability], so that [outcome].`
+ */
+export const USER_STORY_REGEX = /^As a (?<role>.+?), I want to (?<capability>.+?), so that (?<outcome>.+?)\.$/;
+/**
+ * Validate that a string matches the User Story format used by MVP-mode phases.
+ * Used by `gsd-verifier` (phase-goal guard) and `/gsd-mvp-phase` (interactive prompting).
+ *
+ * @example
+ *   gsd-sdk query user-story.validate "As a user, I want to log in, so that I can see my data."
+ *   gsd-sdk query user-story.validate --story "<text>"
+ */
+export const userStoryValidate = async (args, _projectDir) => {
+    let input = null;
+    if (args[0] === '--story') {
+        input = args[1] ?? null;
+    }
+    else if (args[0]) {
+        input = args.join(' ');
+    }
+    if (input === null || input === '') {
+        throw new GSDError('Usage: user-story.validate "<story text>" | --story "<text>"', ErrorClassification.Validation);
+    }
+    const match = input.match(USER_STORY_REGEX);
+    const errors = [];
+    let slots = null;
+    if (match && match.groups) {
+        slots = {
+            role: match.groups.role.trim(),
+            capability: match.groups.capability.trim(),
+            outcome: match.groups.outcome.trim(),
+        };
+    }
+    else {
+        if (!/^As a /i.test(input))
+            errors.push('Must begin with "As a ".');
+        if (!/, I want to /i.test(input))
+            errors.push('Must contain ", I want to ".');
+        if (!/, so that /i.test(input))
+            errors.push('Must contain ", so that ".');
+        if (!/\.$/.test(input))
+            errors.push('Must end with a period.');
+        if (errors.length === 0)
+            errors.push('Does not match canonical User Story shape.');
+    }
+    return {
+        data: {
+            valid: match !== null,
+            input,
+            slots,
+            errors,
+        },
+    };
+};
+//# sourceMappingURL=mvp.js.map

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

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

package/sdk/dist/query/phase-filesystem-adapter.d.ts

@@ -0,0 +1,4 @@
+export declare function listDirectories(dirPath: string): Promise<string[]>;
+export declare function ensureDirectoryWithGitkeep(dirPath: string): Promise<void>;
+export declare function archiveDirectories(sourceDir: string, archiveDir: string, shouldArchive: (dirName: string) => boolean): Promise<number>;
+//# sourceMappingURL=phase-filesystem-adapter.d.ts.map

package/sdk/dist/query/phase-filesystem-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-filesystem-adapter.d.ts","sourceRoot":"","sources":["../../src/query/phase-filesystem-adapter.ts"],"names":[],"mappings":"AAIA,wBAAsB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CASxE;AAED,wBAAsB,0BAA0B,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAG/E;AAED,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,GAC1C,OAAO,CAAC,MAAM,CAAC,CAUjB"}

package/sdk/dist/query/phase-filesystem-adapter.js

@@ -0,0 +1,33 @@
+import { existsSync } from 'node:fs';
+import { mkdir, readdir, rename, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+export async function listDirectories(dirPath) {
+    if (!existsSync(dirPath))
+        return [];
+    try {
+        const entries = await readdir(dirPath, { withFileTypes: true });
+        return entries.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+    }
+    catch (err) {
+        if (err.code === 'ENOENT')
+            return [];
+        throw err;
+    }
+}
+export async function ensureDirectoryWithGitkeep(dirPath) {
+    await mkdir(dirPath, { recursive: true });
+    await writeFile(join(dirPath, '.gitkeep'), '', 'utf-8');
+}
+export async function archiveDirectories(sourceDir, archiveDir, shouldArchive) {
+    await mkdir(archiveDir, { recursive: true });
+    const sourceDirs = await listDirectories(sourceDir);
+    let archivedCount = 0;
+    for (const dirName of sourceDirs) {
+        if (!shouldArchive(dirName))
+            continue;
+        await rename(join(sourceDir, dirName), join(archiveDir, dirName));
+        archivedCount++;
+    }
+    return archivedCount;
+}
+//# sourceMappingURL=phase-filesystem-adapter.js.map

package/sdk/dist/query/phase-filesystem-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-filesystem-adapter.js","sourceRoot":"","sources":["../../src/query/phase-filesystem-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACrE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,OAAe;IACnD,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IACpC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnF,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QAChE,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,OAAe;IAC9D,MAAM,KAAK,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,SAAiB,EACjB,UAAkB,EAClB,aAA2C;IAE3C,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,UAAU,GAAG,MAAM,eAAe,CAAC,SAAS,CAAC,CAAC;IACpD,IAAI,aAAa,GAAG,CAAC,CAAC;IACtB,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;QACjC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;YAAE,SAAS;QACtC,MAAM,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;QAClE,aAAa,EAAE,CAAC;IAClB,CAAC;IACD,OAAO,aAAa,CAAC;AACvB,CAAC"}

package/sdk/dist/query/phase-lifecycle-policy.d.ts

@@ -0,0 +1,34 @@
+export interface PhaseDirectoryComputation {
+    phaseId: number | string;
+    dirName: string;
+}
+export interface NextDecimalPhaseResult {
+    next: string;
+    existing: string[];
+}
+/** Reject strings containing null bytes (path traversal defense). */
+export declare function assertNoNullBytes(value: string, label: string): void;
+/** Reject `..` or path separators in phase directory names. */
+export declare function assertSafePhaseDirName(dirName: string, label?: string): void;
+export declare function assertSafeProjectCode(code: string): void;
+/** Generate kebab-case slug from description. */
+export declare function generatePhaseSlug(text: string): string;
+export declare function parseMultiwordArg(args: string[], flag: string): string | null;
+export declare function extractOneLinerFromBody(content: string): string | null;
+/**
+ * Scan highest sequential phase number in milestone content.
+ * Skips exactly the backlog sentinel (`999`); phases 1000+ are valid canonical IDs.
+ */
+export declare function scanSequentialMaxPhaseFromMilestone(milestoneContent: string): number;
+/**
+ * Scan highest sequential phase number from phase directory names.
+ * Supports optional project-code prefix and optional decimal suffixes.
+ */
+export declare function scanSequentialMaxPhaseFromDirs(dirNames: string[]): number;
+export declare function computeNextSequentialPhaseId(milestoneContent: string, dirNames: string[]): number;
+export declare function computePhaseDirectory(namingMode: unknown, descriptionSlug: string, prefix: string, nextSequentialPhaseId: number, customId?: string | null): PhaseDirectoryComputation;
+export declare function buildPhaseRoadmapEntry(phaseId: number | string, description: string, namingMode: unknown): string;
+export declare function collectDecimalSuffixesFromDirNames(basePhase: string, dirNames: string[]): Set<number>;
+export declare function collectDecimalSuffixesFromRoadmap(basePhase: string, roadmapContent: string): Set<number>;
+export declare function computeNextDecimalPhase(basePhase: string, decimalSet: Set<number>): NextDecimalPhaseResult;
+//# sourceMappingURL=phase-lifecycle-policy.d.ts.map

package/sdk/dist/query/phase-lifecycle-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phase-lifecycle-policy.d.ts","sourceRoot":"","sources":["../../src/query/phase-lifecycle-policy.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,qEAAqE;AACrE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIpE;AAED,+DAA+D;AAC/D,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,SAAoB,GAAG,IAAI,CAIvF;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAIxD;AAED,iDAAiD;AACjD,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMtD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS7E;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAKtE;AAED;;;GAGG;AACH,wBAAgB,mCAAmC,CAAC,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAUpF;AAED;;;GAGG;AACH,wBAAgB,8BAA8B,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAWzE;AAED,wBAAgB,4BAA4B,CAAC,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAKjG;AAED,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,OAAO,EACnB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,EACd,qBAAqB,EAAE,MAAM,EAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GACvB,yBAAyB,CAiB3B;AAED,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,MAAM,GAAG,MAAM,EACxB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,OAAO,GAClB,MAAM,CAMR;AAED,wBAAgB,kCAAkC,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAQrG;AAED,wBAAgB,iCAAiC,CAAC,SAAS,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAWxG;AAED,wBAAgB,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,sBAAsB,CAU1G"}

package/sdk/dist/query/phase-lifecycle-policy.js

@@ -0,0 +1,138 @@
+import { GSDError, ErrorClassification } from '../errors.js';
+import { escapeRegex } from './helpers.js';
+/** Reject strings containing null bytes (path traversal defense). */
+export function assertNoNullBytes(value, label) {
+    if (value.includes('\0')) {
+        throw new GSDError(`${label} contains null byte`, ErrorClassification.Validation);
+    }
+}
+/** Reject `..` or path separators in phase directory names. */
+export function assertSafePhaseDirName(dirName, label = 'phase directory') {
+    if (/[/\\]|\.\./.test(dirName)) {
+        throw new GSDError(`${label} contains invalid path segments`, ErrorClassification.Validation);
+    }
+}
+export function assertSafeProjectCode(code) {
+    if (code && /[/\\]|\.\./.test(code)) {
+        throw new GSDError('project_code contains invalid characters', ErrorClassification.Validation);
+    }
+}
+/** Generate kebab-case slug from description. */
+export function generatePhaseSlug(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-+|-+$/g, '')
+        .substring(0, 60);
+}
+export function parseMultiwordArg(args, flag) {
+    const idx = args.indexOf(`--${flag}`);
+    if (idx === -1)
+        return null;
+    const tokens = [];
+    for (let i = idx + 1; i < args.length; i++) {
+        if (args[i].startsWith('--'))
+            break;
+        tokens.push(args[i]);
+    }
+    return tokens.length > 0 ? tokens.join(' ') : null;
+}
+export function extractOneLinerFromBody(content) {
+    if (!content)
+        return null;
+    const body = content.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n*/, '');
+    const match = body.match(/^#[^\n]*\n+\*\*([^*]+)\*\*/m);
+    return match ? match[1].trim() : null;
+}
+/**
+ * Scan highest sequential phase number in milestone content.
+ * Skips exactly the backlog sentinel (`999`); phases 1000+ are valid canonical IDs.
+ */
+export function scanSequentialMaxPhaseFromMilestone(milestoneContent) {
+    const phasePattern = /(?:^|\n)\s*(?:[-*]\s*(?:\[[x ]\]\s*)?|#{2,4}\s*|\*{1,2}\s*)Phase\s+(\d+)[A-Z]?(?:\.\d+)*:/gi;
+    let maxPhase = 0;
+    let m;
+    while ((m = phasePattern.exec(milestoneContent)) !== null) {
+        const num = parseInt(m[1], 10);
+        if (num === 999)
+            continue;
+        if (num > maxPhase)
+            maxPhase = num;
+    }
+    return maxPhase;
+}
+/**
+ * Scan highest sequential phase number from phase directory names.
+ * Supports optional project-code prefix and optional decimal suffixes.
+ */
+export function scanSequentialMaxPhaseFromDirs(dirNames) {
+    let maxPhase = 0;
+    const dirNumPattern = /^(?:[A-Z][A-Z0-9]*-)?(\d+)[A-Z]?(?:\.\d+)*-/i;
+    for (const dirName of dirNames) {
+        const match = dirNumPattern.exec(dirName);
+        if (!match)
+            continue;
+        const num = parseInt(match[1], 10);
+        if (num === 999)
+            continue;
+        if (num > maxPhase)
+            maxPhase = num;
+    }
+    return maxPhase;
+}
+export function computeNextSequentialPhaseId(milestoneContent, dirNames) {
+    return Math.max(scanSequentialMaxPhaseFromMilestone(milestoneContent), scanSequentialMaxPhaseFromDirs(dirNames)) + 1;
+}
+export function computePhaseDirectory(namingMode, descriptionSlug, prefix, nextSequentialPhaseId, customId) {
+    if (customId || namingMode === 'custom') {
+        const phaseId = customId || descriptionSlug.toUpperCase().replace(/-/g, '_');
+        if (!phaseId) {
+            throw new GSDError('--id required when phase_naming is "custom"', ErrorClassification.Validation);
+        }
+        assertSafePhaseDirName(String(phaseId), 'custom phase id');
+        const dirName = `${prefix}${phaseId}-${descriptionSlug}`;
+        assertSafePhaseDirName(dirName);
+        return { phaseId, dirName };
+    }
+    const phaseId = nextSequentialPhaseId;
+    const paddedNum = String(phaseId).padStart(2, '0');
+    const dirName = `${prefix}${paddedNum}-${descriptionSlug}`;
+    assertSafePhaseDirName(dirName);
+    return { phaseId, dirName };
+}
+export function buildPhaseRoadmapEntry(phaseId, description, namingMode) {
+    const prevPhase = typeof phaseId === 'number' ? phaseId - 1 : null;
+    const dependsOn = namingMode === 'custom' || prevPhase === null || prevPhase < 1
+        ? ''
+        : `\n**Depends on:** Phase ${prevPhase}`;
+    return `\n### Phase ${phaseId}: ${description}\n\n**Goal:** [To be planned]\n**Requirements**: TBD${dependsOn}\n**Plans:** 0 plans\n\nPlans:\n- [ ] TBD (run /gsd-plan-phase ${phaseId} to break down)\n`;
+}
+export function collectDecimalSuffixesFromDirNames(basePhase, dirNames) {
+    const decimalSet = new Set();
+    const decimalPattern = new RegExp(`^(?:[A-Z][A-Z0-9]*-)?${escapeRegex(basePhase)}\\.(\\d+)`, 'i');
+    for (const dir of dirNames) {
+        const match = dir.match(decimalPattern);
+        if (match)
+            decimalSet.add(parseInt(match[1], 10));
+    }
+    return decimalSet;
+}
+export function collectDecimalSuffixesFromRoadmap(basePhase, roadmapContent) {
+    const decimalSet = new Set();
+    const phasePattern = new RegExp(`#{2,4}\\s*Phase\\s+0*${escapeRegex(basePhase)}\\.(\\d+)\\s*:`, 'gi');
+    let match;
+    while ((match = phasePattern.exec(roadmapContent)) !== null) {
+        decimalSet.add(parseInt(match[1], 10));
+    }
+    return decimalSet;
+}
+export function computeNextDecimalPhase(basePhase, decimalSet) {
+    const existing = Array.from(decimalSet)
+        .sort((a, b) => a - b)
+        .map((n) => `${basePhase}.${n}`);
+    const next = decimalSet.size === 0
+        ? `${basePhase}.1`
+        : `${basePhase}.${Math.max(...decimalSet) + 1}`;
+    return { next, existing };
+}
+//# sourceMappingURL=phase-lifecycle-policy.js.map