@planu/cli 0.88.1 → 0.90.1

package/dist/tools/update-status/file-sync.js

@@ -0,0 +1,112 @@
+import { calculateAccuracy } from '../../engine/estimator.js';
+import { metricsStore } from '../../storage/index.js';
+import { addLesson, getLessons } from '../../storage/lessons-store.js';
+import { dispatchFeedbackEvent } from '../learn.js';
+import { generateProgressUpdate, generateProgressContent } from '../../engine/progress-writer.js';
+import { autoReconcileOnDone } from '../update-status-reconcile.js';
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { dirname } from 'node:path';
+export async function recordDoneMetrics(projectId, specId, spec, actuals, projectPath) {
+    const accuracyScore = calculateAccuracy(spec.estimation, actuals.devHours + actuals.reviewHours);
+    const metricEntry = {
+        specId,
+        difficulty: spec.difficulty,
+        estimated: spec.estimation,
+        actual: actuals,
+        accuracyScore,
+    };
+    await metricsStore.addMetricEntry(projectId, metricEntry);
+    if (accuracyScore < 0.7 || accuracyScore > 1.3) {
+        try {
+            void dispatchFeedbackEvent(projectId, {
+                type: 'validate',
+                specId,
+                input: { specType: spec.type, scope: spec.scope, difficulty: spec.difficulty },
+                outcome: {
+                    estimationAccuracy: accuracyScore,
+                    estimatedHours: spec.estimation.devHours + spec.estimation.reviewHours,
+                    actualHours: actuals.devHours + actuals.reviewHours,
+                },
+                delta: { accuracyDrift: Math.abs(1 - accuracyScore) },
+                timestamp: new Date().toISOString(),
+            });
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+    if (accuracyScore < 0.7 && projectPath) {
+        void autoCaptureLessonEstimation(spec, actuals, accuracyScore, projectId, projectPath);
+    }
+}
+async function autoCaptureLessonEstimation(spec, actuals, accuracy, projectId, projectPath) {
+    try {
+        const existing = await getLessons(projectPath, {
+            specId: spec.id,
+            category: 'estimation',
+            tags: ['auto-captured'],
+        });
+        if (existing.length > 0) {
+            return;
+        }
+        const estimatedHours = spec.estimation.devHours + spec.estimation.reviewHours;
+        const actualHours = actuals.devHours + actuals.reviewHours;
+        const severity = accuracy < 0.6 ? 'high' : 'medium';
+        await addLesson(projectPath, {
+            projectId,
+            specId: spec.id,
+            category: 'estimation',
+            severity,
+            title: `Estimation miss on ${spec.title}`,
+            description: `Spec took ${String(actualHours)}h actual vs ${String(estimatedHours)}h estimated (${String(Math.round(accuracy * 100))}% accuracy)`,
+            prevention: 'Review complexity and scope assumptions before estimating similar specs',
+            tags: [...spec.tags, 'auto-captured', 'estimation'],
+        });
+    }
+    catch {
+        /* best-effort — never throw */
+    }
+}
+export async function syncSpecFiles(updatedSpec, currentStatus, newStatus) {
+    if (updatedSpec.specPath) {
+        try {
+            const specContent = await readFile(updatedSpec.specPath, 'utf-8');
+            const { updateFrontmatterField } = await import('../../engine/frontmatter-parser.js');
+            const updatedContent = updateFrontmatterField(specContent, 'status', newStatus);
+            await writeFile(updatedSpec.specPath, updatedContent, 'utf-8');
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            console.warn(`[Planu] update_status: failed to sync spec.md for ${updatedSpec.id} at ${updatedSpec.specPath}: ${msg}`);
+        }
+    }
+    else {
+        console.warn(`[Planu] update_status: specPath not set for ${updatedSpec.id} — spec.md not updated on disk. ` +
+            'Run reconcile_spec to re-link this spec to its file.');
+    }
+    if (updatedSpec.progressPath) {
+        try {
+            const existing = await readFile(updatedSpec.progressPath, 'utf-8');
+            const updatedProgress = generateProgressUpdate(updatedSpec, currentStatus, existing);
+            await writeFile(updatedSpec.progressPath, updatedProgress, 'utf-8');
+        }
+        catch {
+            try {
+                const progressContent = generateProgressContent(updatedSpec);
+                await mkdir(dirname(updatedSpec.progressPath), { recursive: true });
+                await writeFile(updatedSpec.progressPath, progressContent, 'utf-8');
+            }
+            catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.warn(`[Planu] update_status: failed to write progress.md for ${updatedSpec.id}: ${msg}`);
+            }
+        }
+    }
+}
+export async function tryReconcile(newStatus, specId, projectId) {
+    if (newStatus !== 'done') {
+        return null;
+    }
+    return autoReconcileOnDone(specId, projectId).catch(() => null);
+}
+//# sourceMappingURL=file-sync.js.map

package/dist/tools/update-status/file-sync.js.map

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

package/dist/tools/update-status/index.d.ts

@@ -0,0 +1,3 @@
+import type { UpdateStatusInput, ToolResult } from '../../types/index.js';
+export declare function handleUpdateStatus(params: UpdateStatusInput): Promise<ToolResult>;
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/update-status/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/update-status/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAgB1E,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CA2MvF"}

package/dist/tools/update-status/index.js

@@ -0,0 +1,181 @@
+import { ti } from '../../i18n/index.js';
+import { specStore, knowledgeStore } from '../../storage/index.js';
+import { calculateAccuracy } from '../../engine/estimator.js';
+import { cascadeCheck } from '../../engine/spec-versioner.js';
+import { runComplianceGates } from '../update-status-convention-gate.js';
+import { runImplementingActions, runDoneActions } from '../update-status-actions.js';
+import { compactObj } from '../../engine/compact-obj.js';
+import { dirname } from 'node:path';
+import { appendChangelogEntry } from '../../engine/spec-changelog/index.js';
+import { checkTransition, checkDorGate } from './transition-guard.js';
+import { runValidateGate, checkDodGate } from './dod-gates.js';
+import { buildStatusResponse } from './response-builder.js';
+import { recordDoneMetrics, syncSpecFiles, tryReconcile } from './file-sync.js';
+import { fireAndForgetSideEffects } from './side-effects.js';
+export async function handleUpdateStatus(params) {
+    const { specId, projectId, status: newStatus, actuals, reviewNotes } = params;
+    try {
+        // Get the current spec
+        const spec = await specStore.getSpec(projectId, specId);
+        if (!spec) {
+            return {
+                content: [{ type: 'text', text: ti('spec.notFound', { id: specId }) }],
+                isError: true,
+            };
+        }
+        const currentStatus = spec.status;
+        // Validate state transition
+        const transitionError = checkTransition(currentStatus, newStatus);
+        if (transitionError) {
+            return transitionError;
+        }
+        // Gate: DoR must pass before transitioning to 'implementing'
+        const dorError = checkDorGate(spec, specId, projectId, newStatus);
+        if (dorError) {
+            return dorError;
+        }
+        // Load knowledge for project path (needed for DoD gates, validate trigger and HTML regen)
+        const knowledge = await knowledgeStore.getKnowledge(projectId);
+        // Gate: DoD must pass before transitioning to 'done' (unless force=true)
+        if (newStatus === 'done' && !params.force) {
+            const dodError = await checkDodGate(spec, specId, projectId, knowledge?.projectPath, false);
+            if (dodError) {
+                return dodError;
+            }
+        }
+        // SPEC-222 Trigger 1: Auto-validate before marking done
+        let validateScore = null;
+        if (newStatus === 'done') {
+            const validateGate = await runValidateGate(spec, knowledge?.projectPath ?? '', params.forceStatus);
+            if (validateGate.blocked) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Blocked: validate score ${String(validateGate.score)}/100 — below 70. Fix issues or use forceStatus:true.`,
+                        },
+                    ],
+                };
+            }
+            validateScore = validateGate.score;
+        }
+        // SPEC-190: Run all compliance gates in parallel (convention + constitution + compile + lint + test, non-blocking)
+        const { conventionWarnings, constitutionWarnings, compileWarnings, lintWarnings, testWarnings, } = await runComplianceGates(projectId, spec.title, spec.tags, newStatus);
+        // If transitioning to 'done', actuals are required (validate before side effects)
+        if (newStatus === 'done' && !actuals) {
+            return {
+                content: [{ type: 'text', text: ti('spec.actualsRequired', {}) }],
+                isError: true,
+                structuredContent: {
+                    error: 'actuals_required',
+                    code: 400,
+                    context: { specId, newStatus },
+                    fixHint: 'Provide the actuals field with implementation notes before marking as done.',
+                },
+            };
+        }
+        // Run transition-specific actions
+        const implActions = newStatus === 'implementing' ? await runImplementingActions(projectId, specId) : null;
+        const doneActions = newStatus === 'done' ? await runDoneActions(projectId, specId, spec.gitBranch) : null;
+        // Build the update
+        const updates = {
+            status: newStatus,
+        };
+        // Store review notes when sending back (review->draft or approved->review)
+        if (reviewNotes) {
+            const existing = spec.reviewNotes ?? [];
+            updates.reviewNotes = [
+                ...existing,
+                `[${new Date().toISOString()}] ${currentStatus}→${newStatus}: ${reviewNotes}`,
+            ];
+        }
+        // If actuals are provided, save them
+        if (actuals) {
+            updates.actuals = actuals;
+        }
+        // Update the spec
+        const updatedSpec = await specStore.updateSpec(projectId, specId, updates);
+        // Sync spec.md frontmatter and progress.md (best-effort)
+        await syncSpecFiles(updatedSpec, currentStatus, newStatus);
+        // If spec is done and has actuals, record metrics
+        if (newStatus === 'done' && actuals) {
+            await recordDoneMetrics(projectId, specId, spec, actuals, knowledge?.projectPath);
+        }
+        // Generate changelog entry for status change (AC-03, AC-08)
+        let changelogUpdated = false;
+        if (updatedSpec.specPath) {
+            const specDir = dirname(updatedSpec.specPath);
+            changelogUpdated = await appendChangelogEntry({
+                specDir,
+                specId,
+                entry: {
+                    timestamp: new Date().toISOString(),
+                    type: 'status_changed',
+                    description: `Estado cambio de \`${currentStatus}\` a \`${newStatus}\`.`,
+                    triggeredBy: 'update_status',
+                    before: { criteriaCount: 0, completedCount: 0, status: currentStatus },
+                    after: { criteriaCount: 0, completedCount: 0, status: newStatus },
+                },
+            });
+        }
+        // Cascade check: notify downstream specs of the status change
+        const allSpecs = await specStore.listSpecs(projectId);
+        const cascadeResult = cascadeCheck(specId, allSpecs, newStatus);
+        const result = compactObj({
+            specId,
+            projectId,
+            previousStatus: currentStatus,
+            newStatus,
+            actuals: actuals ?? null,
+            autoBranch: implActions?.autoBranch ?? null,
+            protectedBranchWarning: implActions?.protectedBranchWarning ?? null,
+            mergeWarning: doneActions?.mergeWarning ?? null,
+            validationWarning: doneActions?.validationWarning ?? null,
+            uncommittedWarning: doneActions?.uncommittedWarning ?? null,
+            prSuggestion: doneActions?.prSuggestion ?? null,
+            changelogUpdated,
+            implementingSuggestions: implActions?.suggestions ?? null,
+            validateScore,
+            constitutionWarnings: constitutionWarnings.length > 0 ? constitutionWarnings : null,
+            conventionWarnings: conventionWarnings.length > 0 ? conventionWarnings : null,
+            compileWarnings: compileWarnings.length > 0 ? compileWarnings : null,
+            lintWarnings: lintWarnings.length > 0 ? lintWarnings : null,
+            testWarnings: testWarnings.length > 0 ? testWarnings : null,
+            cascade: cascadeResult,
+            metrics: newStatus === 'done' && actuals
+                ? {
+                    accuracyScore: calculateAccuracy(spec.estimation, actuals.devHours + actuals.reviewHours),
+                    estimatedHours: spec.estimation.devHours + spec.estimation.reviewHours,
+                    actualHours: actuals.devHours + actuals.reviewHours,
+                    estimatedCost: spec.estimation.totalCostUsd,
+                    actualCost: actuals.totalCostUsd,
+                }
+                : null,
+            updatedAt: updatedSpec.updatedAt,
+            message: ti('tools.update_status.success', { specId, status: newStatus }),
+        });
+        // Fire-and-forget side effects (non-blocking)
+        fireAndForgetSideEffects({
+            knowledge,
+            allSpecs,
+            specId,
+            newStatus,
+            validateScore,
+            projectId,
+            spec,
+            currentStatus,
+        });
+        // Auto-reconcile token costs when spec reaches done (best-effort, non-blocking)
+        const reconciliationMarkdown = await tryReconcile(newStatus, specId, projectId);
+        return buildStatusResponse(result, specId, currentStatus, newStatus, reconciliationMarkdown);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: ti('errors.internalError', { message }) }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/tools/update-status/index.js.map

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

package/dist/tools/update-status/response-builder.d.ts

@@ -0,0 +1,4 @@
+import type { SpecStatus, ToolResult } from '../../types/index.js';
+export declare const STATUS_EMOJIS: Record<SpecStatus, string>;
+export declare function buildStatusResponse(result: Record<string, unknown>, specId: string, currentStatus: SpecStatus, newStatus: SpecStatus, reconciliationMarkdown?: string | null): ToolResult;
+//# sourceMappingURL=response-builder.d.ts.map

package/dist/tools/update-status/response-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-builder.d.ts","sourceRoot":"","sources":["../../../src/tools/update-status/response-builder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAInE,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAOpD,CAAC;AAEF,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,UAAU,EACzB,SAAS,EAAE,UAAU,EACrB,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,GACrC,UAAU,CAmFZ"}

package/dist/tools/update-status/response-builder.js

@@ -0,0 +1,69 @@
+import { t } from '../../i18n/index.js';
+import { formatSuccess, addNextSteps } from '../response-helpers.js';
+export const STATUS_EMOJIS = {
+    draft: '📝',
+    review: '🔍',
+    approved: '✅',
+    implementing: '⚙️',
+    done: '🎉',
+    discarded: '🗑️',
+};
+export function buildStatusResponse(result, specId, currentStatus, newStatus, reconciliationMarkdown) {
+    const fromEmoji = STATUS_EMOJIS[currentStatus];
+    const toEmoji = STATUS_EMOJIS[newStatus];
+    const r = result;
+    const lines = [
+        `**SPEC-${specId}** moved: ${fromEmoji} \`${currentStatus}\` → ${toEmoji} \`${newStatus}\``,
+    ];
+    if (r.autoBranch) {
+        lines.push(`\n🌿 Branch created: \`${r.autoBranch}\``);
+    }
+    if (r.protectedBranchWarning) {
+        lines.push(`\n⚠️ ${r.protectedBranchWarning}`);
+    }
+    if (r.mergeWarning) {
+        lines.push(`\n⚠️ ${r.mergeWarning}`);
+    }
+    if (r.validationWarning) {
+        lines.push(`\n⚠️ ${r.validationWarning}`);
+    }
+    if (r.prSuggestion) {
+        lines.push(`\n🔗 ${r.prSuggestion.title}`);
+    }
+    if (r.metrics) {
+        lines.push(`\n📊 Accuracy: ${Math.round(r.metrics.accuracyScore * 100)}% | ` +
+            `Estimated: ${String(r.metrics.estimatedHours)}h → Actual: ${String(r.metrics.actualHours)}h`);
+    }
+    if (r.validateScore !== null && r.validateScore !== undefined) {
+        lines.push(`\n✅ Validate score: ${String(r.validateScore)}/100`);
+    }
+    if (r.cascade.affectedSpecs.length > 0) {
+        lines.push(`\n🔗 Downstream specs affected: ${r.cascade.affectedSpecs.map((s) => `SPEC-${s}`).join(', ')}`);
+    }
+    if (r.constitutionWarnings && r.constitutionWarnings.length > 0) {
+        lines.push(`\n⚠️ **Constitution Warnings**\n${r.constitutionWarnings.map((w) => `- ${w.description}`).join('\n')}`);
+    }
+    if (r.conventionWarnings && r.conventionWarnings.length > 0) {
+        lines.push(`\n⚠️ **Convention Violations**\n${r.conventionWarnings.map((w) => `- ${w}`).join('\n')}`);
+    }
+    if (r.compileWarnings && r.compileWarnings.length > 0) {
+        lines.push(`\n⚠️ **Compile Warnings**\n${r.compileWarnings.map((w) => `- ${w}`).join('\n')}`);
+    }
+    if (r.lintWarnings && r.lintWarnings.length > 0) {
+        lines.push(`\n⚠️ **Lint Warnings**\n${r.lintWarnings.map((w) => `- ${w}`).join('\n')}`);
+    }
+    if (r.testWarnings && r.testWarnings.length > 0) {
+        lines.push(`\n⚠️ **Test Warnings**\n${r.testWarnings.map((w) => `- ${w}`).join('\n')}`);
+    }
+    const allNextSteps = [...(r.implementingSuggestions ?? [])];
+    const baseText = formatSuccess(t('tools.response.statusTitle'), lines.join(''));
+    const withNextSteps = allNextSteps.length > 0 ? addNextSteps(baseText, allNextSteps) : baseText;
+    const markdownText = reconciliationMarkdown
+        ? `${withNextSteps}\n\n${reconciliationMarkdown}`
+        : withNextSteps;
+    return {
+        content: [{ type: 'text', text: markdownText }],
+        structuredContent: result,
+    };
+}
+//# sourceMappingURL=response-builder.js.map

package/dist/tools/update-status/response-builder.js.map

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

package/dist/tools/update-status/side-effects.d.ts

@@ -0,0 +1,15 @@
+import type { SpecStatus } from '../../types/index.js';
+import type { knowledgeStore } from '../../storage/index.js';
+import type { Spec } from '../../types/spec/core.js';
+/** Fire-and-forget side effects after a successful status transition. */
+export declare function fireAndForgetSideEffects(params: {
+    knowledge: Awaited<ReturnType<typeof knowledgeStore.getKnowledge>>;
+    allSpecs: Spec[];
+    specId: string;
+    newStatus: SpecStatus;
+    validateScore: number | null;
+    projectId: string;
+    spec: Spec;
+    currentStatus: SpecStatus;
+}): void;
+//# sourceMappingURL=side-effects.d.ts.map

package/dist/tools/update-status/side-effects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"side-effects.d.ts","sourceRoot":"","sources":["../../../src/tools/update-status/side-effects.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAM7D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD,yEAAyE;AACzE,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C,SAAS,EAAE,OAAO,CAAC,UAAU,CAAC,OAAO,cAAc,CAAC,YAAY,CAAC,CAAC,CAAC;IACnE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,UAAU,CAAC;IACtB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,IAAI,CAAC;IACX,aAAa,EAAE,UAAU,CAAC;CAC3B,GAAG,IAAI,CAwCP"}

package/dist/tools/update-status/side-effects.js

@@ -0,0 +1,64 @@
+import { addLesson, getLessons } from '../../storage/lessons-store.js';
+import { regenerateSpecSummaryHtml } from '../../engine/spec-summary-html.js';
+import { notifyStoreChange } from '../../engine/doc-generator/portal/regen-hook.js';
+import { dispatchHookEvent } from '../manage-hooks.js';
+import { buildStatusChangePayload } from '../../engine/hooks/triggers.js';
+/** Fire-and-forget side effects after a successful status transition. */
+export function fireAndForgetSideEffects(params) {
+    const { knowledge, allSpecs, specId, newStatus, validateScore, projectId, spec, currentStatus } = params;
+    // Auto-regenerate planu/index.html (fire-and-forget, never blocks result)
+    if (knowledge?.projectPath) {
+        void regenerateSpecSummaryHtml(knowledge.projectPath, allSpecs, [specId]);
+        const changedStores = ['specs'];
+        if (newStatus === 'done') {
+            changedStores.push('metrics');
+        }
+        notifyStoreChange(knowledge.projectPath, ...changedStores);
+    }
+    // SPEC-222 Trigger 3: Auto-stage planu/ when done and validate OK (fire-and-forget)
+    if (newStatus === 'done' && validateScore !== null && knowledge?.projectPath) {
+        void import('node:child_process').then(({ execSync }) => {
+            try {
+                execSync('git add planu/', { cwd: knowledge.projectPath, stdio: 'pipe' });
+            }
+            catch {
+                /* best-effort — non-blocking */
+            }
+        });
+    }
+    // Dispatch on_spec_status_change hook event (fire-and-forget)
+    void dispatchHookEvent(projectId, buildStatusChangePayload(projectId, specId, spec.title, currentStatus, newStatus));
+    // SPEC-248: Auto-capture lesson when drift is detected (validateScore < 70 on transition to done)
+    if (newStatus === 'done' &&
+        validateScore !== null &&
+        validateScore < 70 &&
+        knowledge?.projectPath) {
+        void autoCaptureLessonDrift(spec, projectId, knowledge.projectPath);
+    }
+}
+async function autoCaptureLessonDrift(spec, projectId, projectPath) {
+    try {
+        const existing = await getLessons(projectPath, {
+            specId: spec.id,
+            category: 'architecture',
+            tags: ['auto-captured'],
+        });
+        if (existing.length > 0) {
+            return;
+        }
+        await addLesson(projectPath, {
+            projectId,
+            specId: spec.id,
+            category: 'architecture',
+            severity: 'medium',
+            title: `Spec drift detected on ${spec.title}`,
+            description: 'Implementation drifted from spec definition',
+            prevention: 'Run validate earlier in the implementation cycle',
+            tags: ['auto-captured', 'drift'],
+        });
+    }
+    catch {
+        /* best-effort — never throw */
+    }
+}
+//# sourceMappingURL=side-effects.js.map

package/dist/tools/update-status/side-effects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"side-effects.js","sourceRoot":"","sources":["../../../src/tools/update-status/side-effects.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,iBAAiB,EAAE,MAAM,iDAAiD,CAAC;AACpF,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAG1E,yEAAyE;AACzE,MAAM,UAAU,wBAAwB,CAAC,MASxC;IACC,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,GAC7F,MAAM,CAAC;IAET,0EAA0E;IAC1E,IAAI,SAAS,EAAE,WAAW,EAAE,CAAC;QAC3B,KAAK,yBAAyB,CAAC,SAAS,CAAC,WAAW,EAAE,QAAQ,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1E,MAAM,aAAa,GAA8C,CAAC,OAAO,CAAC,CAAC;QAC3E,IAAI,SAAS,KAAK,MAAM,EAAE,CAAC;YACzB,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAChC,CAAC;QACD,iBAAiB,CAAC,SAAS,CAAC,WAAW,EAAE,GAAG,aAAa,CAAC,CAAC;IAC7D,CAAC;IAED,oFAAoF;IACpF,IAAI,SAAS,KAAK,MAAM,IAAI,aAAa,KAAK,IAAI,IAAI,SAAS,EAAE,WAAW,EAAE,CAAC;QAC7E,KAAK,MAAM,CAAC,oBAAoB,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE;YACtD,IAAI,CAAC;gBACH,QAAQ,CAAC,gBAAgB,EAAE,EAAE,GAAG,EAAE,SAAS,CAAC,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;YAC5E,CAAC;YAAC,MAAM,CAAC;gBACP,gCAAgC;YAClC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED,8DAA8D;IAC9D,KAAK,iBAAiB,CACpB,SAAS,EACT,wBAAwB,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,aAAa,EAAE,SAAS,CAAC,CAClF,CAAC;IAEF,kGAAkG;IAClG,IACE,SAAS,KAAK,MAAM;QACpB,aAAa,KAAK,IAAI;QACtB,aAAa,GAAG,EAAE;QAClB,SAAS,EAAE,WAAW,EACtB,CAAC;QACD,KAAK,sBAAsB,CAAC,IAAI,EAAE,SAAS,EAAE,SAAS,CAAC,WAAW,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED,KAAK,UAAU,sBAAsB,CACnC,IAAU,EACV,SAAiB,EACjB,WAAmB;IAEnB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,UAAU,CAAC,WAAW,EAAE;YAC7C,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,QAAQ,EAAE,cAAc;YACxB,IAAI,EAAE,CAAC,eAAe,CAAC;SACxB,CAAC,CAAC;QACH,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACxB,OAAO;QACT,CAAC;QACD,MAAM,SAAS,CAAC,WAAW,EAAE;YAC3B,SAAS;YACT,MAAM,EAAE,IAAI,CAAC,EAAE;YACf,QAAQ,EAAE,cAAc;YACxB,QAAQ,EAAE,QAAQ;YAClB,KAAK,EAAE,0BAA0B,IAAI,CAAC,KAAK,EAAE;YAC7C,WAAW,EAAE,6CAA6C;YAC1D,UAAU,EAAE,kDAAkD;YAC9D,IAAI,EAAE,CAAC,eAAe,EAAE,OAAO,CAAC;SACjC,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,+BAA+B;IACjC,CAAC;AACH,CAAC"}

package/dist/tools/update-status/transition-guard.d.ts

@@ -0,0 +1,20 @@
+import type { SpecStatus, UpdateStatusInput, ToolResult } from '../../types/index.js';
+import type { Spec } from '../../types/spec/core.js';
+/**
+ * Valid state transitions for spec lifecycle.
+ * draft -> review -> approved -> implementing -> done
+ * Also allow: review -> draft (send back), approved -> review (reconsider)
+ */
+export declare const VALID_TRANSITIONS: Record<SpecStatus, SpecStatus[]>;
+/**
+ * Validates that a status transition is allowed.
+ * Returns an error ToolResult if invalid, null if valid.
+ */
+export declare function checkTransition(currentStatus: SpecStatus, newStatus: SpecStatus): ToolResult | null;
+/**
+ * Validates DoR gate before transitioning to 'implementing'.
+ * Returns an error ToolResult if blocked, null if passed.
+ */
+export declare function checkDorGate(spec: Spec, specId: string, projectId: string, newStatus: SpecStatus): ToolResult | null;
+export type { UpdateStatusInput };
+//# sourceMappingURL=transition-guard.d.ts.map

package/dist/tools/update-status/transition-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition-guard.d.ts","sourceRoot":"","sources":["../../../src/tools/update-status/transition-guard.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAItF,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,UAAU,EAAE,UAAU,EAAE,CAO9D,CAAC;AAEF;;;GAGG;AACH,wBAAgB,eAAe,CAC7B,aAAa,EAAE,UAAU,EACzB,SAAS,EAAE,UAAU,GACpB,UAAU,GAAG,IAAI,CAiBnB;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,UAAU,GACpB,UAAU,GAAG,IAAI,CAmCnB;AAED,YAAY,EAAE,iBAAiB,EAAE,CAAC"}

package/dist/tools/update-status/transition-guard.js

@@ -0,0 +1,75 @@
+import { ti } from '../../i18n/index.js';
+import { validateDoR } from '../../engine/dor-dod.js';
+import { dispatchFeedbackEvent } from '../learn.js';
+/**
+ * Valid state transitions for spec lifecycle.
+ * draft -> review -> approved -> implementing -> done
+ * Also allow: review -> draft (send back), approved -> review (reconsider)
+ */
+export const VALID_TRANSITIONS = {
+    draft: ['review', 'discarded'],
+    review: ['draft', 'approved', 'discarded'],
+    approved: ['review', 'implementing', 'discarded'],
+    implementing: ['approved', 'done', 'discarded'],
+    done: [], // terminal state
+    discarded: [], // terminal state
+};
+/**
+ * Validates that a status transition is allowed.
+ * Returns an error ToolResult if invalid, null if valid.
+ */
+export function checkTransition(currentStatus, newStatus) {
+    const validNextStates = VALID_TRANSITIONS[currentStatus];
+    if (!validNextStates.includes(newStatus)) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: ti('spec.invalidTransition', {
+                        from: currentStatus,
+                        to: newStatus,
+                    }),
+                },
+            ],
+            isError: true,
+        };
+    }
+    return null;
+}
+/**
+ * Validates DoR gate before transitioning to 'implementing'.
+ * Returns an error ToolResult if blocked, null if passed.
+ */
+export function checkDorGate(spec, specId, projectId, newStatus) {
+    if (newStatus !== 'implementing') {
+        return null;
+    }
+    const dorResult = validateDoR(spec);
+    if (!dorResult.isValid) {
+        void dispatchFeedbackEvent(projectId, {
+            type: 'checklist',
+            specId,
+            input: { gate: 'dor', specType: spec.type },
+            outcome: { passed: false, failedItems: dorResult.blockingItems },
+            delta: { failedCount: dorResult.blockingItems.length },
+            timestamp: new Date().toISOString(),
+        });
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: JSON.stringify({
+                        error: 'DoR gate failed',
+                        message: dorResult.humanMessage,
+                        expertSummary: dorResult.expertSummary,
+                        blockingItems: dorResult.blockingItems,
+                        warningItems: dorResult.warningItems,
+                    }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=transition-guard.js.map

package/dist/tools/update-status/transition-guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transition-guard.js","sourceRoot":"","sources":["../../../src/tools/update-status/transition-guard.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGpD;;;;GAIG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAqC;IACjE,KAAK,EAAE,CAAC,QAAQ,EAAE,WAAW,CAAC;IAC9B,MAAM,EAAE,CAAC,OAAO,EAAE,UAAU,EAAE,WAAW,CAAC;IAC1C,QAAQ,EAAE,CAAC,QAAQ,EAAE,cAAc,EAAE,WAAW,CAAC;IACjD,YAAY,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,CAAC;IAC/C,IAAI,EAAE,EAAE,EAAE,iBAAiB;IAC3B,SAAS,EAAE,EAAE,EAAE,iBAAiB;CACjC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,eAAe,CAC7B,aAAyB,EACzB,SAAqB;IAErB,MAAM,eAAe,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;IACzD,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QACzC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,EAAE,CAAC,wBAAwB,EAAE;wBACjC,IAAI,EAAE,aAAa;wBACnB,EAAE,EAAE,SAAS;qBACd,CAAC;iBACH;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAC1B,IAAU,EACV,MAAc,EACd,SAAiB,EACjB,SAAqB;IAErB,IAAI,SAAS,KAAK,cAAc,EAAE,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACvB,KAAK,qBAAqB,CAAC,SAAS,EAAE;YACpC,IAAI,EAAE,WAAW;YACjB,MAAM;YACN,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,IAAI,EAAE;YAC3C,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,WAAW,EAAE,SAAS,CAAC,aAAa,EAAE;YAChE,KAAK,EAAE,EAAE,WAAW,EAAE,SAAS,CAAC,aAAa,CAAC,MAAM,EAAE;YACtD,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACpC,CAAC,CAAC;QACH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,IAAI,CAAC,SAAS,CAClB;wBACE,KAAK,EAAE,iBAAiB;wBACxB,OAAO,EAAE,SAAS,CAAC,YAAY;wBAC/B,aAAa,EAAE,SAAS,CAAC,aAAa;wBACtC,aAAa,EAAE,SAAS,CAAC,aAAa;wBACtC,YAAY,EAAE,SAAS,CAAC,YAAY;qBACrC,EACD,IAAI,EACJ,CAAC,CACF;iBACF;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/tools/update-status.d.ts

@@ -1,3 +1,2 @@
-import type { UpdateStatusInput, ToolResult } from '../types/index.js';
-export declare function handleUpdateStatus(params: UpdateStatusInput): Promise<ToolResult>;
+export { handleUpdateStatus } from './update-status/index.js';
 //# sourceMappingURL=update-status.d.ts.map

package/dist/tools/update-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"update-status.d.ts","sourceRoot":"","sources":["../../src/tools/update-status.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAA2B,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAsThG,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,UAAU,CAAC,CAyRvF"}
+{"version":3,"file":"update-status.d.ts","sourceRoot":"","sources":["../../src/tools/update-status.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC"}