@planu/cli 4.11.1 → 4.11.2

package/dist/tools/schemas/runtime-security.d.ts

@@ -2,11 +2,11 @@ import { z } from 'zod';
 export declare const SecurityReportTimeRangeEnum: z.ZodEnum<{
     all: "all";
     last24h: "last24h";
-    last7d: "last7d";
     last30d: "last30d";
+    last7d: "last7d";
 }>;
 export declare const SecurityReportFormatEnum: z.ZodEnum<{
-    summary: "summary";
     detailed: "detailed";
+    summary: "summary";
 }>;
 //# sourceMappingURL=runtime-security.d.ts.map

package/dist/tools/schemas/session.d.ts

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 export declare const SessionFormatEnum: z.ZodEnum<{
-    markdown: "markdown";
     json: "json";
+    markdown: "markdown";
 }>;
 export declare const SessionHandoffSchema: {
     readonly projectPath: z.ZodString;
@@ -19,8 +19,8 @@ export declare const ExportSessionSchema: {
     readonly projectPath: z.ZodString;
     readonly sessionId: z.ZodOptional<z.ZodString>;
     readonly format: z.ZodOptional<z.ZodEnum<{
-        markdown: "markdown";
         json: "json";
+        markdown: "markdown";
     }>>;
 };
 export declare const AutoCheckpointSchema: {

package/dist/tools/schemas/spec.d.ts

@@ -5,43 +5,43 @@ export declare const SupportedLocaleEnum: z.ZodEnum<{
     pt: "pt";
 }>;
 export declare const SpecStatusEnum: z.ZodEnum<{
-    draft: "draft";
-    review: "review";
     approved: "approved";
-    implementing: "implementing";
-    done: "done";
     discarded: "discarded";
+    done: "done";
+    draft: "draft";
+    implementing: "implementing";
+    review: "review";
 }>;
 export declare const SpecTypeEnum: z.ZodEnum<{
-    feature: "feature";
-    refactor: "refactor";
+    agent: "agent";
     bugfix: "bugfix";
-    infra: "infra";
     docs: "docs";
+    feature: "feature";
+    infra: "infra";
     project: "project";
-    agent: "agent";
+    refactor: "refactor";
     "tech-debt": "tech-debt";
 }>;
 export declare const SpecScopeEnum: z.ZodEnum<{
+    architectural: "architectural";
+    "cross-module": "cross-module";
     feature: "feature";
     trivial: "trivial";
-    "cross-module": "cross-module";
-    architectural: "architectural";
 }>;
 export declare const SpecTargetEnum: z.ZodEnum<{
-    frontend: "frontend";
+    android: "android";
     backend: "backend";
-    shared: "shared";
+    database: "database";
+    frontend: "frontend";
     fullstack: "fullstack";
     infrastructure: "infrastructure";
-    database: "database";
     ios: "ios";
-    android: "android";
+    shared: "shared";
 }>;
 export declare const ExperienceLevelEnum: z.ZodEnum<{
     beginner: "beginner";
-    intermediate: "intermediate";
     expert: "expert";
+    intermediate: "intermediate";
 }>;
 /** SPEC-313: Work mode enum for init_project and set_work_mode */
 export declare const WorkModeEnum: z.ZodEnum<{

package/dist/tools/schemas/token-intelligence.d.ts

@@ -1,23 +1,23 @@
 import { z } from 'zod';
 export declare const TokenIntelligencePeriodEnum: z.ZodEnum<{
+    all_time: "all_time";
+    month: "month";
     today: "today";
     week: "week";
-    month: "month";
-    all_time: "all_time";
 }>;
 export declare const TokenIntelligenceGroupByEnum: z.ZodEnum<{
+    day: "day";
     model: "model";
     spec: "spec";
     tool: "tool";
-    day: "day";
 }>;
 export declare const TokenIntelligenceViewEnum: z.ZodEnum<{
-    graph: "graph";
-    summary: "summary";
+    autopilot: "autopilot";
     budget: "budget";
     detailed: "detailed";
-    autopilot: "autopilot";
+    graph: "graph";
     reconciliation: "reconciliation";
+    summary: "summary";
     trends: "trends";
 }>;
 //# sourceMappingURL=token-intelligence.d.ts.map

package/dist/tools/schemas/token-optimization.d.ts

@@ -1,9 +1,9 @@
 import { z } from 'zod';
 export declare const TokenUsagePeriodEnum: z.ZodEnum<{
-    today: "today";
+    all_time: "all_time";
     current_session: "current_session";
     last_hour: "last_hour";
-    all_time: "all_time";
+    today: "today";
 }>;
 export declare const TokenUsageGroupByEnum: z.ZodEnum<{
     session: "session";

package/dist/tools/schemas/workers-schema.d.ts

@@ -8,13 +8,13 @@ export declare const ConfigureWorkersInputSchema: z.ZodObject<{
     projectId: z.ZodString;
     workerName: z.ZodString;
     action: z.ZodEnum<{
-        enable: "enable";
+        "add-pattern": "add-pattern";
         disable: "disable";
+        enable: "enable";
+        "enable-auto-memory": "enable-auto-memory";
+        "remove-pattern": "remove-pattern";
         "set-cooldown": "set-cooldown";
         "set-priority": "set-priority";
-        "add-pattern": "add-pattern";
-        "remove-pattern": "remove-pattern";
-        "enable-auto-memory": "enable-auto-memory";
     }>;
     value: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
 }, z.core.$strip>;

package/dist/tools/skill-bootstrap-handler.d.ts

@@ -5,20 +5,20 @@ export declare const DiscoverSkillsInputSchema: {
     stack: z.ZodOptional<z.ZodArray<z.ZodString>>;
     sources: z.ZodOptional<z.ZodArray<z.ZodEnum<{
         "awesome-cursorrules": "awesome-cursorrules";
-        "skills-sh": "skills-sh";
         "github-custom": "github-custom";
+        "skills-sh": "skills-sh";
     }>>>;
 };
 export declare const BootstrapSkillsInputSchema: {
     projectPath: z.ZodString;
     stack: z.ZodOptional<z.ZodArray<z.ZodString>>;
     targets: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        "agents-md": "agents-md";
         "claude-md": "claude-md";
+        clinerules: "clinerules";
         cursorrules: "cursorrules";
-        windsurfrules: "windsurfrules";
         "kiro-steering": "kiro-steering";
-        "agents-md": "agents-md";
-        clinerules: "clinerules";
+        windsurfrules: "windsurfrules";
     }>>>;
     dryRun: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
 };
@@ -34,12 +34,12 @@ export declare const ConfigureSkillRegistriesInputSchema: {
     enableSource: z.ZodOptional<z.ZodString>;
     disableSource: z.ZodOptional<z.ZodString>;
     setTargets: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        "agents-md": "agents-md";
         "claude-md": "claude-md";
+        clinerules: "clinerules";
         cursorrules: "cursorrules";
-        windsurfrules: "windsurfrules";
         "kiro-steering": "kiro-steering";
-        "agents-md": "agents-md";
-        clinerules: "clinerules";
+        windsurfrules: "windsurfrules";
     }>>>;
     setAutoMerge: z.ZodOptional<z.ZodBoolean>;
 };

package/dist/tools/tool-registry/deprecated-stubs.d.ts

@@ -5,7 +5,7 @@ export declare const DEPRECATION_MESSAGE_TEMPLATE = "This tool has been migrated
  * The 5 MCP tool names that have been migrated to skills.
  * Used in smoke tests (Scenario 6) and anywhere a guard on migrated tools is needed.
  */
-export declare const DEPRECATED_TOOLS: readonly ["execute_sdd_flow", "implement_plan", "multi_teammate_review", "run_healing_loop", "generate_orchestration_plan"];
+export declare const DEPRECATED_TOOLS: readonly ['execute_sdd_flow', 'implement_plan', 'multi_teammate_review', 'run_healing_loop', 'generate_orchestration_plan'];
 export type DeprecatedToolName = (typeof DEPRECATED_TOOLS)[number];
 /**
  * Create a ToolEntry-compatible deprecation stub.

package/dist/tools/triage-request.d.ts

@@ -5,11 +5,11 @@ export declare const TriageRequestInputSchema: z.ZodObject<{
     sessionId: z.ZodOptional<z.ZodString>;
     hint: z.ZodOptional<z.ZodObject<{
         kind: z.ZodOptional<z.ZodEnum<{
-            idea: "idea";
-            "quick-fix": "quick-fix";
             "bug-spec": "bug-spec";
-            "feature-spec": "feature-spec";
             epic: "epic";
+            "feature-spec": "feature-spec";
+            idea: "idea";
+            "quick-fix": "quick-fix";
         }>>;
     }, z.core.$strip>>;
     projectId: z.ZodOptional<z.ZodString>;

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

@@ -10,7 +10,7 @@ export interface FrontmatterSyncWarning {
     specPath: string | null;
     reason: string;
 }
-export declare function syncSpecFiles(updatedSpec: Spec, currentStatus: SpecStatus, newStatus: SpecStatus, projectPath?: string): Promise<{
+export declare function syncSpecFiles(updatedSpec: Spec, _currentStatus: SpecStatus, newStatus: SpecStatus, projectPath?: string): Promise<{
     warning?: FrontmatterSyncWarning;
 }>;
 export declare function tryReconcile(newStatus: string, specId: string, projectId: string): Promise<string | null>;

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

@@ -2,14 +2,15 @@ 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 } from '../../engine/progress-writer.js';
 import { autoReconcileOnDone } from '../update-status-reconcile.js';
 import { readFile, writeFile } from 'node:fs/promises';
-import { replaceSectionInSpec } from '../../engine/spec-format/replace-section.js';
 import { parseFrontmatter } from '../../engine/frontmatter-parser.js';
 import { computeFrontmatterSha } from '../../engine/frontmatter-sha/index.js';
 import { appendTransitionEvent } from '../../storage/transition-log.js';
 export async function recordDoneMetrics(projectId, specId, spec, actuals, projectPath) {
+    if (actuals.devHours + actuals.reviewHours === 0) {
+        return;
+    }
     const accuracyScore = calculateAccuracy(spec.estimation, actuals.devHours + actuals.reviewHours);
     const metricEntry = {
         specId,
@@ -19,7 +20,7 @@ export async function recordDoneMetrics(projectId, specId, spec, actuals, projec
         accuracyScore,
     };
     await metricsStore.addMetricEntry(projectId, metricEntry);
-    if (accuracyScore < 0.7 || accuracyScore > 1.3) {
+    if (accuracyScore < 70) {
         void dispatchFeedbackEvent(projectId, {
             type: 'validate',
             specId,
@@ -29,13 +30,13 @@ export async function recordDoneMetrics(projectId, specId, spec, actuals, projec
                 estimatedHours: spec.estimation.devHours + spec.estimation.reviewHours,
                 actualHours: actuals.devHours + actuals.reviewHours,
             },
-            delta: { accuracyDrift: Math.abs(1 - accuracyScore) },
+            delta: { accuracyDrift: Math.abs(100 - accuracyScore) },
             timestamp: new Date().toISOString(),
         }).catch((err) => {
             console.error('[planu] dispatchFeedbackEvent failed:', err);
         });
     }
-    if (accuracyScore < 0.7 && projectPath) {
+    if (accuracyScore < 70 && projectPath) {
         void autoCaptureLessonEstimation(spec, actuals, accuracyScore, projectId, projectPath);
     }
 }
@@ -51,14 +52,14 @@ async function autoCaptureLessonEstimation(spec, actuals, accuracy, projectId, p
         }
         const estimatedHours = spec.estimation.devHours + spec.estimation.reviewHours;
         const actualHours = actuals.devHours + actuals.reviewHours;
-        const severity = accuracy < 0.6 ? 'high' : 'medium';
+        const severity = accuracy < 60 ? '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)`,
+            description: `Spec took ${String(actualHours)}h actual vs ${String(estimatedHours)}h estimated (${String(Math.round(accuracy))}% accuracy)`,
             prevention: 'Review complexity and scope assumptions before estimating similar specs',
             tags: [...spec.tags, 'auto-captured', 'estimation'],
         });
@@ -90,7 +91,7 @@ function assertSpecBodyIntegrity(args) {
         throw new Error(`SPEC_INTEGRITY_WRITE_FAILED: refusing to write ${args.specId} because update_status(${args.newStatus}) would shrink spec.md body by ${String(lost)} characters without an explicit migration marker.`);
     }
 }
-export async function syncSpecFiles(updatedSpec, currentStatus, newStatus, projectPath) {
+export async function syncSpecFiles(updatedSpec, _currentStatus, newStatus, projectPath) {
     let warning;
     if (updatedSpec.specPath) {
         try {
@@ -145,21 +146,6 @@ export async function syncSpecFiles(updatedSpec, currentStatus, newStatus, proje
         console.warn(`[Planu] update_status: ${reason} (${updatedSpec.id})`);
         warning = { specId: updatedSpec.id, specPath: null, reason };
     }
-    // SPEC-1010 PR-C: Write progress into the unified spec.md ## Progress section
-    // instead of a standalone progress.md file. We do this only when specPath is
-    // known (which it always is for specs that reach syncSpecFiles).
-    if (updatedSpec.specPath) {
-        try {
-            const existing = await readFile(updatedSpec.specPath, 'utf-8');
-            // Extract current ## Progress body (may be empty for new lean specs)
-            const progressBody = extractProgressBody(existing);
-            const updatedProgress = generateProgressUpdate(updatedSpec, currentStatus, progressBody);
-            await replaceSectionInSpec(updatedSpec.specPath, 'Progress', updatedProgress);
-        }
-        catch {
-            // best-effort — never blocks the transition
-        }
-    }
     return warning ? { warning } : {};
 }
 /** Flip all `    done: false` lines to `    done: true` in spec content.
@@ -169,7 +155,7 @@ function markAllCriteriaDone(content) {
 }
 /** True when content is a lean-format spec (has a `criteria:` key in the frontmatter). */
 function isLeanSpecContent(content) {
-    return /^criteria:/m.test(content);
+    return /^criteria:[ \t]*(?:#.*)?\r?\n(?:[ \t]*\r?\n)*[ \t]+-\s+text:/m.test(content);
 }
 /**
  * SPEC-630: Remove done criteria entries from lean spec and annotate the count on the criteria key.
@@ -183,27 +169,6 @@ function stripDoneCriteria(content) {
     });
     return stripped.replace(/^(criteria:)(\s*#.*)?$/m, `$1 # ${String(doneCount)} done`);
 }
-/**
- * Extract the body of the `## Progress` section from spec.md content.
- * Returns "" when the section is absent so callers get a clean empty string.
- * Mirrors the extractSectionBody logic without importing from spec-format to
- * keep this module's dependency chain flat.
- */
-function extractProgressBody(specContent) {
-    const normalized = specContent.replace(/\r\n/g, '\n');
-    // Mask fenced code blocks so inner markdown headings are not matched
-    const masked = normalized.replace(/(```|~~~)[\s\S]*?\1/g, (block) => block.replace(/[^\n]/g, ' '));
-    const headingMatch = /^##\s+Progress\b.*$/m.exec(masked);
-    if (!headingMatch) {
-        return '';
-    }
-    const afterHeading = headingMatch.index + headingMatch[0].length;
-    const nextRe = /^##\s+\S/gm;
-    nextRe.lastIndex = afterHeading;
-    const next = nextRe.exec(masked);
-    const end = next ? next.index : normalized.length;
-    return normalized.slice(afterHeading, end).trim();
-}
 export async function tryReconcile(newStatus, specId, projectId) {
     if (newStatus !== 'done') {
         return null;

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

@@ -16,8 +16,6 @@ import { isLocked, getLock } from '../../storage/spec-lock-store.js';
 import { runValidateGate, checkDoneGates, checkComplianceGate, checkQaGate, checkApprovedFormatGate, checkValidationReportGate, checkSpecReviewGate, writeSpecReviewArtifact, } from './dod-gates.js';
 import { checkLifecycleEvidenceTransitionGate } from './evidence-gate.js';
 import { buildStatusResponse, buildValidateBlockedResponse, buildDryRunResponse, } from './response-builder.js';
-import { getSuggestedMode } from './mode-hints.js';
-import { autoFillActuals, createDefaultActuals } from '../../engine/actuals-estimator.js';
 import { recordDoneMetrics, syncSpecFiles, tryReconcile, recordTerminalTransitionEvent, } from './file-sync.js';
 import { appendEntry, getLastHash } from '../../storage/audit-trail-store.js';
 import { appendTransitionEvent } from '../../storage/transition-log.js';
@@ -117,18 +115,18 @@ function computeDoneMetrics(newStatus, spec, actuals) {
     if (newStatus !== 'done' || actuals === undefined || spec === null) {
         return null;
     }
+    const actualHours = actuals.devHours + actuals.reviewHours;
+    if (actualHours === 0) {
+        return null;
+    }
     return {
-        accuracyScore: calculateAccuracy(spec.estimation, actuals.devHours + actuals.reviewHours),
+        accuracyScore: calculateAccuracy(spec.estimation, actualHours),
         estimatedHours: spec.estimation.devHours + spec.estimation.reviewHours,
-        actualHours: actuals.devHours + actuals.reviewHours,
+        actualHours,
         estimatedCost: spec.estimation.totalCostUsd,
         actualCost: actuals.totalCostUsd,
     };
 }
-/** Extract recordActualHint from doneActions without adding cyclomatic complexity inline. */
-function extractRecordActualHint(doneActions) {
-    return doneActions?.recordActualHint;
-}
 /** SPEC-447: Build a blocked-by-compliance response. */
 function buildBlockedByComplianceResponse(_specId, result) {
     const scoreStr = result.score !== null ? String(result.score) : 'N/A';
@@ -269,6 +267,22 @@ export async function handleUpdateStatus(params, server) {
                 };
             }
             const originalStatus = spec.status;
+            if (newStatus === 'done' && actuals === undefined) {
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: 'actuals_required: provide measured values for done. Use zero only when a metric is explicitly unavailable; Planu does not estimate provider tokens or costs.',
+                        },
+                    ],
+                    isError: true,
+                    structuredContent: {
+                        error: 'actuals_required',
+                        code: 422,
+                        fixHint: 'Provide actuals with measured values or zero for unavailable metrics. Values are preserved without estimation.',
+                    },
+                };
+            }
             // SPEC-301: Reject status changes when spec is locked by another holder (legacy manual lock)
             const lockError = await checkSpecLockGate(params.projectPath, specId);
             if (lockError) {
@@ -477,7 +491,7 @@ export async function handleUpdateStatus(params, server) {
                 let forcedBypassWarning = null;
                 const [codeRealityResult, doneGatesResult] = await Promise.all([
                     // Code reality: only relevant for 'implementing'
-                    newStatus === 'implementing' && effectiveGatePath
+                    newStatus === 'implementing' && !reverseTransition && effectiveGatePath
                         ? checkCodeReality(effectiveGatePath, spec.title).catch(() => null)
                         : Promise.resolve(null),
                     // Done gates: only relevant for 'done'
@@ -521,8 +535,8 @@ export async function handleUpdateStatus(params, server) {
                     newStatus === 'done' && effectiveGatePath && !crashShieldSkipReason
                         ? withToolTimeout(scanCrashRisks(effectiveGatePath).catch(() => null), 9_000, null)
                         : Promise.resolve(null),
-                    // Compliance gate: only on 'done' or 'implementing' (score-compliance is heavy) — hard deadline 9s
-                    newStatus === 'done' || newStatus === 'implementing' || newStatus === 'review'
+                    // The heuristic scorer is a review aid. Done relies on the authoritative validate report.
+                    newStatus === 'review'
                         ? withToolTimeout(checkComplianceGate(specId, projectId, effectiveGatePath), 9_000, {
                             skipped: true,
                             blocked: false,
@@ -631,18 +645,8 @@ export async function handleUpdateStatus(params, server) {
                         blockingReasons: [],
                     });
                 }
-                // SPEC-495: Auto-generate actuals when not provided; auto-fill zeros when provided
-                let resolvedActuals = actuals;
-                if (newStatus === 'done') {
-                    if (!resolvedActuals) {
-                        // Agent did not pass actuals at all — create from spec estimation
-                        resolvedActuals = createDefaultActuals(spec.estimation);
-                    }
-                    else {
-                        // Agent passed actuals but tokens/costs are zero — auto-fill
-                        resolvedActuals = autoFillActuals(resolvedActuals, spec.estimation);
-                    }
-                }
+                // Explicit actuals are preserved verbatim. Provider usage and cost are never inferred.
+                const resolvedActuals = actuals;
                 // Run transition-specific actions
                 const implActions = newStatus === 'implementing' ? await runImplementingActions(projectId, specId) : null;
                 const doneActions = newStatus === 'done' ? await runDoneActions(projectId, specId, spec.gitBranch) : null;
@@ -1030,7 +1034,6 @@ export async function handleUpdateStatus(params, server) {
                 if (cascadeResult.affectedSpecs.length > 0) {
                     collector.pushOk('cascade', `Notified ${String(cascadeResult.affectedSpecs.length)} downstream spec(s)`);
                 }
-                const modeSuggestion = getSuggestedMode(newStatus);
                 const result = compactObj({
                     specId,
                     projectId,
@@ -1068,8 +1071,6 @@ export async function handleUpdateStatus(params, server) {
                     metrics: doneMetrics,
                     complianceGateResult,
                     versionSnapshotTag,
-                    suggestedClaudeMode: modeSuggestion?.mode ?? null,
-                    modeHint: modeSuggestion?.hint ?? null,
                     orchestrationPlan,
                     // SPEC-728: DepGuard result (null when gate was not applicable)
                     depGuard: depGuardResult,
@@ -1105,7 +1106,7 @@ export async function handleUpdateStatus(params, server) {
                 const reconciliationMarkdown = await tryReconcile(newStatus, specId, projectId);
                 // SPEC-754: Append shell-hygiene reminder when transitioning to done on claude-code host
                 const shellHygieneHint = newStatus === 'done' && detectHost() === 'claude-code' ? shellHygieneReminder() : null;
-                return buildStatusResponse(result, specId, currentStatus, newStatus, reconciliationMarkdown, extractRecordActualHint(doneActions), spec.title, shellHygieneHint);
+                return buildStatusResponse(result, specId, currentStatus, newStatus, reconciliationMarkdown, spec.title, shellHygieneHint);
             }
             finally {
                 // SPEC-719: Release cross-process lock in all exit paths (return, throw)

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

@@ -13,5 +13,5 @@ export declare function buildValidateBlockedResponse(specId: string, result: Ext
  */
 export declare function buildDryRunResponse(dryRunResult: DryRunResult): ToolResult;
 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, recordActualHint?: string | null, specTitle?: string, shellHygieneHint?: string | null): ToolResult;
+export declare function buildStatusResponse(result: Record<string, unknown>, specId: string, currentStatus: SpecStatus, newStatus: SpecStatus, reconciliationMarkdown?: string | null, specTitle?: string, shellHygieneHint?: string | null): ToolResult;
 //# sourceMappingURL=response-builder.d.ts.map

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

@@ -79,7 +79,7 @@ export const STATUS_EMOJIS = {
     discarded: '🗑️',
 };
 // eslint-disable-next-line complexity -- aggregates many host- and status-specific branches
-export function buildStatusResponse(result, specId, currentStatus, newStatus, reconciliationMarkdown, recordActualHint, specTitle, shellHygieneHint) {
+export function buildStatusResponse(result, specId, currentStatus, newStatus, reconciliationMarkdown, specTitle, shellHygieneHint) {
     const fromEmoji = STATUS_EMOJIS[currentStatus];
     const toEmoji = STATUS_EMOJIS[newStatus];
     const r = result;
@@ -102,18 +102,15 @@ export function buildStatusResponse(result, specId, currentStatus, newStatus, re
         lines.push(`\n🔗 ${r.prSuggestion.title}`);
     }
     if (r.metrics) {
-        lines.push(`\n📊 Accuracy: ${Math.round(r.metrics.accuracyScore * 100)}% | ` +
+        lines.push(`\n📊 Accuracy: ${Math.round(r.metrics.accuracyScore)}% | ` +
             `Estimated: ${String(r.metrics.estimatedHours)}h → Actual: ${String(r.metrics.actualHours)}h`);
     }
     if (r.actuals && (r.actuals.tokensOpus > 0 || r.actuals.tokensSonnet > 0)) {
-        const prefix = r.actuals.estimated ? '~' : '';
-        const opus = r.actuals.tokensOpus > 0 ? `${prefix}${r.actuals.tokensOpus.toLocaleString()} opus` : null;
-        const sonnet = r.actuals.tokensSonnet > 0
-            ? `${prefix}${r.actuals.tokensSonnet.toLocaleString()} sonnet`
-            : null;
+        const opus = r.actuals.tokensOpus > 0 ? `${r.actuals.tokensOpus.toLocaleString()} opus` : null;
+        const sonnet = r.actuals.tokensSonnet > 0 ? `${r.actuals.tokensSonnet.toLocaleString()} sonnet` : null;
         const tokenStr = [opus, sonnet].filter(Boolean).join(' + ');
-        const costStr = r.actuals.apiCostUsd > 0 ? ` | ${prefix}$${r.actuals.apiCostUsd.toFixed(3)} API` : '';
-        lines.push(`\n🤖 Tokens: ${tokenStr}${costStr}${r.actuals.estimated ? ' *(auto-estimated)*' : ''}`);
+        const costStr = r.actuals.apiCostUsd > 0 ? ` | $${r.actuals.apiCostUsd.toFixed(3)} API` : '';
+        lines.push(`\n🤖 Tokens: ${tokenStr}${costStr}`);
     }
     if (r.validateScore !== null && r.validateScore !== undefined) {
         const sourceSuffix = r.validateScoreSource === 'forced-best-effort-validateSpec'
@@ -180,22 +177,17 @@ export function buildStatusResponse(result, specId, currentStatus, newStatus, re
         const v = r.orchestrationPlan.parallelSafetyVerdict ? 'parallel-safe' : 'sequential-required';
         lines.push(`\n🤖 Orchestration: ${String(r.orchestrationPlan.executionOrder.length)} waves | ${v}`);
     }
-    // SPEC-494: Claude Code mode hint
-    if (r.suggestedClaudeMode) {
-        lines.push(`\n💡 **Suggested Claude mode:** \`${r.suggestedClaudeMode}\` — ${r.modeHint ?? ''}`);
-    }
-    if (recordActualHint) {
-        lines.push(`\n💡 ${recordActualHint}`);
-    }
     // SPEC-754: Shell hygiene reminder for claude-code host on done transition
     if (shellHygieneHint) {
         lines.push(`\n🐚 **Shell hygiene:** ${shellHygieneHint}`);
     }
     // SPEC-340: nextAction and lifecycleMap
-    const nextAction = buildNextAction(newStatus);
     const lifecycleMap = buildLifecycleMap(newStatus);
+    const nextAction = lifecycleMap.next === null ? null : buildNextAction(newStatus);
     lines.push(buildLifecycleMapLine(lifecycleMap));
-    lines.push(`\n**Next step:** ${nextAction.step}\n> ${nextAction.prompt}\n> \`${nextAction.suggestedCommand}\` — ${nextAction.whenToDoIt}`);
+    if (nextAction) {
+        lines.push(`\n**Next step:** ${nextAction.step}\n> ${nextAction.prompt}\n> \`${nextAction.suggestedCommand}\` — ${nextAction.whenToDoIt}`);
+    }
     const allNextSteps = [...(r.implementingSuggestions ?? [])];
     const baseText = formatSuccess(t('tools.response.statusTitle'), lines.join(''));
     const withNextSteps = allNextSteps.length > 0 ? addNextSteps(baseText, allNextSteps) : baseText;
@@ -284,7 +276,7 @@ export function buildStatusResponse(result, specId, currentStatus, newStatus, re
         warningsTop5: warningItems.slice(0, 5),
         affectedSpecsCount: r.cascade.affectedSpecs.length,
         affectedSpecsTop5: r.cascade.affectedSpecs.slice(0, 5),
-        nextAction,
+        nextAction: nextAction ?? undefined,
         lifecycleMap,
         humanSummary,
         orchestrationPlan: r.orchestrationPlan

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

@@ -115,7 +115,7 @@ export function checkTransition(currentStatus, newStatus) {
  * Returns an error ToolResult if blocked, null if passed.
  */
 export function checkDorGate(spec, specId, projectId, newStatus) {
-    if (newStatus !== 'implementing') {
+    if (newStatus !== 'implementing' || isReverseTransition(spec.status, newStatus)) {
         return null;
     }
     const dorResult = validateDoR(spec);

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

@@ -13,7 +13,6 @@ export declare function runDoneActions(projectId: string, specId: string, gitBra
     } | null;
     validationWarning: string | null;
     uncommittedWarning: string | null;
-    recordActualHint: string | null;
     autopilotSummary: string[];
 }>;
 /**