@ginkoai/cli 2.5.0 → 2.5.2

package/dist/lib/sprint-state.js

@@ -0,0 +1,338 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-03-15
+ * @tags: [sprint-state, cache, materialization, epic-025]
+ * @related: [task-parser.ts, sprint-loader.ts, ../commands/task/status.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [fs-extra, path]
+ */
+/**
+ * Sprint State Materialization (EPIC-025 Sprint 2)
+ *
+ * Materializes graph state as `.ginko/sprint-state.json` — a read-only
+ * local cache the AI partner can access with zero friction.
+ *
+ * Write path: AI partner → `ginko task complete` → CLI → graph → local cache
+ * Read path: AI partner → `Read .ginko/sprint-state.json` (one tool call)
+ *
+ * The AI partner never writes to the cache directly. The CLI is the only writer.
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { execSync } from 'child_process';
+// =============================================================================
+// Helpers
+// =============================================================================
+function getProjectRoot() {
+    try {
+        return execSync('git rev-parse --show-toplevel', { encoding: 'utf-8' }).trim();
+    }
+    catch {
+        return process.cwd();
+    }
+}
+function getCachePath(projectRoot) {
+    const root = projectRoot || getProjectRoot();
+    return path.join(root, '.ginko', 'sprint-state.json');
+}
+// =============================================================================
+// Materialization
+// =============================================================================
+/**
+ * Materialize sprint state from graph to local cache.
+ *
+ * Uses getActiveSprint API to fetch current sprint data,
+ * then writes structured JSON to .ginko/sprint-state.json.
+ *
+ * @param projectRoot - Optional project root override
+ * @returns The materialized SprintState, or null if no active sprint
+ */
+export async function materializeSprintState(projectRoot) {
+    const root = projectRoot || getProjectRoot();
+    const cachePath = getCachePath(root);
+    try {
+        // Dynamic import to avoid circular dependencies
+        const { GraphApiClient } = await import('../commands/graph/api-client.js');
+        const { getGraphId } = await import('../commands/graph/config.js');
+        const graphId = process.env.GINKO_GRAPH_ID || await getGraphId();
+        if (!graphId)
+            return null;
+        const client = new GraphApiClient();
+        const activeSprint = await client.getActiveSprint(graphId);
+        if (!activeSprint?.sprint?.id)
+            return null;
+        // Build task map
+        const tasks = {};
+        const allKnownIssues = [];
+        const allBlockers = [];
+        let completedCount = 0;
+        for (const task of activeSprint.tasks || []) {
+            const taskEntry = {
+                title: task.title || 'Untitled',
+                status: task.status || 'not_started',
+            };
+            // Try to get extended properties (knownIssues, blockers) from graph node
+            try {
+                const nodeResponse = await client.request('GET', `/api/v1/graph/nodes/${encodeURIComponent(task.id)}?graphId=${encodeURIComponent(graphId)}`);
+                const props = nodeResponse.node?.properties;
+                if (props) {
+                    if (props.knownIssues) {
+                        const issues = Array.isArray(props.knownIssues)
+                            ? props.knownIssues
+                            : typeof props.knownIssues === 'string'
+                                ? JSON.parse(props.knownIssues)
+                                : [];
+                        taskEntry.knownIssues = issues;
+                        allKnownIssues.push(...issues);
+                    }
+                    if (props.blockers) {
+                        const blockers = Array.isArray(props.blockers)
+                            ? props.blockers
+                            : typeof props.blockers === 'string'
+                                ? JSON.parse(props.blockers)
+                                : [];
+                        taskEntry.blockers = blockers;
+                        allBlockers.push(...blockers);
+                    }
+                    if (props.modifiedFiles) {
+                        taskEntry.modifiedFiles = Array.isArray(props.modifiedFiles)
+                            ? props.modifiedFiles
+                            : typeof props.modifiedFiles === 'string'
+                                ? JSON.parse(props.modifiedFiles)
+                                : [];
+                    }
+                }
+            }
+            catch {
+                // Individual task property fetch failures are non-fatal
+            }
+            if (task.status === 'complete')
+                completedCount++;
+            tasks[task.id] = taskEntry;
+        }
+        const totalTasks = activeSprint.tasks?.length || 0;
+        const state = {
+            sprint: activeSprint.sprint.id,
+            epicId: activeSprint.sprint.id.split('_')[0] || 'unknown',
+            epicTitle: '',
+            sprintTitle: activeSprint.sprint.name || activeSprint.sprint.id,
+            progress: {
+                complete: completedCount,
+                total: totalTasks,
+                percentage: totalTasks > 0 ? Math.round((completedCount / totalTasks) * 100) : 0,
+            },
+            tasks,
+            knownIssues: [...new Set(allKnownIssues)],
+            blockers: [...new Set(allBlockers)],
+            lastDeployed: null,
+            lastUpdated: new Date().toISOString(),
+            lastUpdatedBy: null,
+            stale: false,
+        };
+        // Write cache
+        await fs.ensureDir(path.dirname(cachePath));
+        await fs.writeJson(cachePath, state, { spaces: 2 });
+        return state;
+    }
+    catch {
+        // Graph unavailable — try to keep existing cache, mark as stale
+        return markCacheStale(cachePath);
+    }
+}
+/**
+ * Mark existing cache as stale (graph was unavailable).
+ * Never deletes the cache — stale data is better than no data.
+ */
+async function markCacheStale(cachePath) {
+    try {
+        if (await fs.pathExists(cachePath)) {
+            const existing = await fs.readJson(cachePath);
+            existing.stale = true;
+            await fs.writeJson(cachePath, existing, { spaces: 2 });
+            return existing;
+        }
+    }
+    catch {
+        // Can't even read the cache — nothing to do
+    }
+    return null;
+}
+// =============================================================================
+// Cache Reading
+// =============================================================================
+/**
+ * Read sprint state from local cache.
+ *
+ * @param projectRoot - Optional project root override
+ * @returns SprintState or null if cache doesn't exist
+ */
+export async function readSprintState(projectRoot) {
+    const cachePath = getCachePath(projectRoot);
+    try {
+        if (!await fs.pathExists(cachePath))
+            return null;
+        return await fs.readJson(cachePath);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if cache is stale (>1 hour old).
+ */
+export function isCacheStale(state, thresholdMs = 3600000) {
+    if (state.stale)
+        return true;
+    const age = Date.now() - new Date(state.lastUpdated).getTime();
+    return age > thresholdMs;
+}
+// =============================================================================
+// Checkpoint Updates
+// =============================================================================
+/**
+ * Push checkpoint data to a task node in the graph.
+ *
+ * @param taskId - Task ID
+ * @param checkpoint - Checkpoint data (knownIssues, blockers, modifiedFiles)
+ */
+export async function pushCheckpointToGraph(taskId, checkpoint) {
+    try {
+        const { GraphApiClient } = await import('../commands/graph/api-client.js');
+        const { getGraphId } = await import('../commands/graph/config.js');
+        const graphId = process.env.GINKO_GRAPH_ID || await getGraphId();
+        if (!graphId)
+            return;
+        const client = new GraphApiClient();
+        // Update task node with checkpoint properties
+        const props = {};
+        if (checkpoint.knownIssues?.length) {
+            props.knownIssues = JSON.stringify(checkpoint.knownIssues);
+        }
+        if (checkpoint.blockers?.length) {
+            props.blockers = JSON.stringify(checkpoint.blockers);
+        }
+        if (checkpoint.modifiedFiles?.length) {
+            props.modifiedFiles = JSON.stringify(checkpoint.modifiedFiles);
+        }
+        if (checkpoint.lastDeployed) {
+            props.lastDeployed = checkpoint.lastDeployed;
+        }
+        if (Object.keys(props).length > 0) {
+            await client.request('PATCH', `/api/v1/graph/nodes/${encodeURIComponent(taskId)}?graphId=${encodeURIComponent(graphId)}`, props);
+        }
+    }
+    catch {
+        // Checkpoint push failure is non-fatal — log but don't block
+    }
+}
+/**
+ * Get modified files from git since last task complete.
+ */
+export function getModifiedFiles() {
+    try {
+        const diff = execSync('git diff --name-only HEAD', { encoding: 'utf-8' }).trim();
+        const untracked = execSync('git ls-files --others --exclude-standard', { encoding: 'utf-8' }).trim();
+        const files = new Set();
+        if (diff)
+            diff.split('\n').forEach(f => files.add(f));
+        if (untracked)
+            untracked.split('\n').forEach(f => files.add(f));
+        return Array.from(files).filter(f => f.length > 0).sort();
+    }
+    catch {
+        return [];
+    }
+}
+// =============================================================================
+// Formatting
+// =============================================================================
+/**
+ * Format sprint state for CLI display.
+ */
+export function formatSprintState(state) {
+    const lines = [];
+    lines.push(`Sprint: ${state.sprint} — ${state.sprintTitle}`);
+    lines.push(`Progress: ${state.progress.percentage}% (${state.progress.complete}/${state.progress.total} tasks complete)`);
+    lines.push('');
+    // Tasks
+    lines.push('Tasks:');
+    for (const [id, task] of Object.entries(state.tasks)) {
+        const shortId = id.split('_').pop() || id;
+        let icon;
+        switch (task.status) {
+            case 'complete':
+                icon = '✅';
+                break;
+            case 'in_progress':
+                icon = '🔄';
+                break;
+            case 'blocked':
+                icon = '⛔';
+                break;
+            default:
+                icon = '⬜';
+                break;
+        }
+        lines.push(`  ${icon} ${shortId}: ${task.title}`);
+    }
+    // Known Issues
+    if (state.knownIssues.length > 0) {
+        lines.push('');
+        lines.push('Known Issues:');
+        for (const issue of state.knownIssues) {
+            lines.push(`  - ${issue}`);
+        }
+    }
+    // Blockers
+    if (state.blockers.length > 0) {
+        lines.push('');
+        lines.push('Blockers:');
+        for (const blocker of state.blockers) {
+            lines.push(`  - ${blocker}`);
+        }
+    }
+    else {
+        lines.push('');
+        lines.push('Blockers: none');
+    }
+    if (state.lastDeployed) {
+        lines.push(`Last deployed: ${state.lastDeployed}`);
+    }
+    lines.push(`Last updated: ${state.lastUpdated}${state.lastUpdatedBy ? ` (after ${state.lastUpdatedBy})` : ''}`);
+    if (state.stale) {
+        lines.push('⚠ Cache may be stale — run `ginko pull` to refresh');
+    }
+    return lines.join('\n');
+}
+/**
+ * Format a compact sprint checkpoint for ginko start readiness message.
+ */
+export function formatCheckpointSummary(state) {
+    const lines = [];
+    lines.push(`Sprint: ${state.sprint} — ${state.sprintTitle} (${state.progress.percentage}%)`);
+    // Find last completed and next task
+    let lastCompleted = null;
+    let nextTask = null;
+    const taskEntries = Object.entries(state.tasks);
+    for (const [id, task] of taskEntries) {
+        if (task.status === 'complete')
+            lastCompleted = `${id.split('_').pop()}: ${task.title}`;
+        if (!nextTask && (task.status === 'not_started' || task.status === 'in_progress')) {
+            const verb = task.status === 'in_progress' ? 'continue' : 'start';
+            nextTask = `${id.split('_').pop()}: ${task.title} (${verb})`;
+        }
+    }
+    if (lastCompleted)
+        lines.push(`  Last: ${lastCompleted}`);
+    if (state.knownIssues.length > 0) {
+        lines.push(`  Issues: ${state.knownIssues.join('; ')}`);
+    }
+    if (nextTask)
+        lines.push(`  Next: ${nextTask}`);
+    if (state.stale)
+        lines.push('  ⚠ State may be stale — `ginko pull` to refresh');
+    return lines.join('\n');
+}
+//# sourceMappingURL=sprint-state.js.map

package/dist/lib/sprint-state.js.map

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

package/dist/lib/structural-safeguards.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-03-09
+ * @tags: [protection, safeguards, startup, lightweight]
+ * @related: [protected-manifest.ts, protection-hook.ts, ../commands/start/start-reflection.ts]
+ * @priority: high
+ * @complexity: low
+ */
+interface SafeguardResult {
+    installed: string[];
+    warnings: string[];
+}
+/**
+ * Check for and auto-install missing structural safeguards.
+ * Designed to be fast and safe to run on every `ginko start`.
+ * Returns messages to display (empty if everything is in place).
+ */
+export declare function ensureStructuralSafeguards(): Promise<SafeguardResult>;
+/**
+ * Format safeguard results for display.
+ * Returns null if nothing to show.
+ */
+export declare function formatSafeguardMessage(result: SafeguardResult): string | null;
+export {};
+//# sourceMappingURL=structural-safeguards.d.ts.map

package/dist/lib/structural-safeguards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-safeguards.d.ts","sourceRoot":"","sources":["../../src/lib/structural-safeguards.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,UAAU,eAAe;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,eAAe,CAAC,CA4C3E;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,MAAM,GAAG,IAAI,CAqB7E"}

package/dist/lib/structural-safeguards.js

@@ -0,0 +1,91 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2026-03-09
+ * @tags: [protection, safeguards, startup, lightweight]
+ * @related: [protected-manifest.ts, protection-hook.ts, ../commands/start/start-reflection.ts]
+ * @priority: high
+ * @complexity: low
+ */
+/**
+ * Structural Safeguards — lightweight check for missing infrastructure.
+ *
+ * Runs on `ginko start` to detect and auto-install safeguards added in
+ * newer CLI versions. Unlike `ginko init --upgrade` (which regenerates
+ * CLAUDE.md, skills, and commands), this only touches structural pieces
+ * that are safe to create idempotently.
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+import { findGinkoRoot } from '../utils/ginko-root.js';
+/**
+ * Check for and auto-install missing structural safeguards.
+ * Designed to be fast and safe to run on every `ginko start`.
+ * Returns messages to display (empty if everything is in place).
+ */
+export async function ensureStructuralSafeguards() {
+    const installed = [];
+    const warnings = [];
+    try {
+        const projectRoot = await findGinkoRoot();
+        if (!projectRoot)
+            return { installed, warnings };
+        const ginkoDir = path.join(projectRoot, '.ginko');
+        if (!(await fs.pathExists(ginkoDir)))
+            return { installed, warnings };
+        // 1. Check PROTECTED manifest
+        const protectedPath = path.join(ginkoDir, 'PROTECTED');
+        if (!(await fs.pathExists(protectedPath))) {
+            try {
+                const { generateManifest } = await import('./protected-manifest.js');
+                await fs.writeFile(protectedPath, generateManifest());
+                installed.push('.ginko/PROTECTED manifest');
+            }
+            catch {
+                warnings.push('Could not create .ginko/PROTECTED manifest');
+            }
+        }
+        // 2. Check pre-commit protection hook
+        try {
+            const { isHookInstalled, installPreCommitHook } = await import('./protection-hook.js');
+            if (!(await isHookInstalled(projectRoot))) {
+                const result = await installPreCommitHook(projectRoot);
+                if (result.installed) {
+                    installed.push('pre-commit protection hook');
+                }
+                else {
+                    warnings.push(result.message);
+                }
+            }
+        }
+        catch {
+            // Not a git repo or hook install failed — skip silently
+        }
+    }
+    catch {
+        // Non-critical — don't break start
+    }
+    return { installed, warnings };
+}
+/**
+ * Format safeguard results for display.
+ * Returns null if nothing to show.
+ */
+export function formatSafeguardMessage(result) {
+    if (result.installed.length === 0 && result.warnings.length === 0) {
+        return null;
+    }
+    const lines = [];
+    if (result.installed.length > 0) {
+        lines.push(chalk.green('  Safeguards installed: ') +
+            chalk.dim(result.installed.join(', ')));
+    }
+    if (result.warnings.length > 0) {
+        for (const w of result.warnings) {
+            lines.push(chalk.yellow(`  Safeguard warning: ${w}`));
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=structural-safeguards.js.map

package/dist/lib/structural-safeguards.js.map

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

package/dist/lib/sync/scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAoBH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,eAAe,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,aAAa,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,aAAa,CAAC;QAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAyC/E;AA4BD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKvE"}
+{"version":3,"file":"scanner.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/scanner.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAiBH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,KAAK,GAAG,KAAK,GAAG,eAAe,CAAC;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC9B,aAAa,EAAE,KAAK,CAAC;QACnB,IAAI,EAAE,YAAY,GAAG,YAAY,GAAG,aAAa,CAAC;QAClD,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAyC/E;AA4BD;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKvE"}

package/dist/lib/sync/scanner.js

@@ -18,11 +18,9 @@
  *
  * Returns structured LocalNode objects with metadata and relationships
  */
-import glob from 'glob';
+import { glob } from 'glob';
 import path from 'path';
-import { promisify } from 'util';
 import { parseMarkdownFile } from './parser.js';
-const globAsync = promisify(glob);
 /**
  * Scan local filesystem for knowledge files
  */
@@ -31,7 +29,7 @@ export async function scanLocalKnowledge(basePath) {
     try {
         // Scan ADRs
         const adrPattern = path.join(basePath, 'docs/adr/ADR-*.md');
-        const adrFiles = await globAsync(adrPattern);
+        const adrFiles = await glob(adrPattern);
         for (const filePath of adrFiles) {
             try {
                 const parsed = await parseMarkdownFile(filePath);
@@ -44,7 +42,7 @@ export async function scanLocalKnowledge(basePath) {
         }
         // Scan PRDs
         const prdPattern = path.join(basePath, 'docs/PRD/PRD-*.md');
-        const prdFiles = await globAsync(prdPattern);
+        const prdFiles = await glob(prdPattern);
         for (const filePath of prdFiles) {
             try {
                 const parsed = await parseMarkdownFile(filePath);

package/dist/lib/sync/scanner.js.map

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

package/dist/lib/task-parser.d.ts

@@ -63,6 +63,8 @@ export interface ParsedTask {
     confidence: number | null;
     /** Assessed content quality */
     content_quality: TaskContentQuality;
+    /** Verification steps (EPIC-025) */
+    verification_steps: string[];
 }
 /**
  * Sprint metadata extracted alongside tasks

package/dist/lib/task-parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-parser.d.ts","sourceRoot":"","sources":["../../src/lib/task-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmBH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE3F;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,CAAC;AAE9D;;;;;;;;;GASG;AACH,MAAM,WAAW,UAAU;IACzB,kEAAkE;IAClE,EAAE,EAAE,MAAM,CAAC;IACX,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,iDAAiD;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,qBAAqB;IACrB,QAAQ,EAAE,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACjD,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,yDAAyD;IACzD,cAAc,EAAE,UAAU,CAAC;IAG3B,qDAAqD;IACrD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,yCAAyC;IACzC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAErB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEpB,oDAAoD;IACpD,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,uBAAuB;IACvB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,6BAA6B;IAC7B,YAAY,EAAE,MAAM,EAAE,CAAC;IAGvB,wDAAwD;IACxD,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,+BAA+B;IAC/B,eAAe,EAAE,kBAAkB,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,uBAAuB;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CA8BhG;AAkJD;;;;;;;GAOG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,UAAU,GAAG,kBAAkB,CAa7E;AAwED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,MAAM,EACjB,aAAa,CAAC,EAAE;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrD,UAAU,GAAG,IAAI,CAgInB;AA4GD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,iBAAiB,CAwBrF;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAazF;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAyBtF"}
+{"version":3,"file":"task-parser.d.ts","sourceRoot":"","sources":["../../src/lib/task-parser.ts"],"names":[],"mappings":"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"}

package/dist/lib/task-parser.js

@@ -223,6 +223,32 @@ function extractAcceptanceCriteria(blockText) {
     }
     return criteria;
 }
+/**
+ * Extract verification steps from task block (EPIC-025)
+ *
+ * Parses the **Verification:** section — concrete check steps
+ * distinct from acceptance criteria.
+ */
+function extractVerificationSteps(blockText) {
+    const steps = [];
+    // Find verification section — must not match "Verification Gate" or similar
+    const sectionMatch = blockText.match(/\*\*Verification(?:\s*\([^)]*\))?:\*\*\s*([\s\S]*?)(?=\n\*\*(?!Verification)|\n###|\n---|\n##|$)/i);
+    if (!sectionMatch)
+        return steps;
+    // Extract checkbox items: - [ ] or - [x]
+    const checkboxMatches = sectionMatch[1].matchAll(/^-\s+\[.\]\s+(.+?)$/gm);
+    for (const match of checkboxMatches) {
+        steps.push(match[1].trim());
+    }
+    // Also extract plain bullets if no checkboxes found
+    if (steps.length === 0) {
+        const bulletMatches = sectionMatch[1].matchAll(/^-\s+(.+?)$/gm);
+        for (const match of bulletMatches) {
+            steps.push(match[1].trim());
+        }
+    }
+    return steps;
+}
 /**
  * Extract file paths from task block
  */
@@ -341,6 +367,8 @@ export function parseTaskBlock(blockText, sprintContext) {
     const confidence = extractConfidence(blockText);
     // Extract acceptance criteria
     const acceptanceCriteria = extractAcceptanceCriteria(blockText);
+    // Extract verification steps (EPIC-025)
+    const verificationSteps = extractVerificationSteps(blockText);
     // Extract files
     const files = extractFiles(blockText);
     // Extract related ADRs
@@ -369,6 +397,8 @@ export function parseTaskBlock(blockText, sprintContext) {
         // Quality metadata
         confidence,
         content_quality: 'thin', // Will be assessed below
+        // Verification (EPIC-025)
+        verification_steps: verificationSteps,
     };
     // Assess content quality
     parsedTask.content_quality = assessTaskContentQuality(parsedTask);