@planu/cli 4.7.3 → 4.7.5

package/dist/engine/session-state/writer.js

@@ -1,8 +1,9 @@
 // @crash-shield-ignore-file — config/cache reader for Planu-controlled JSON; writer is this codebase, shape guaranteed by build/seed.
 // engine/session-state/writer.ts — SPEC-633: Write session.json universal state file
-import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { readFile, mkdir } from 'node:fs/promises';
 import { join } from 'node:path';
 import { execSync } from 'node:child_process';
+import { stableJsonStringify, stableWriteGeneratedFile, stripRootUpdatedAt, } from '../generated-artifact-writer.js';
 const STATE_DIR = 'state';
 const ROOT_SESSION = 'session.json';
 function stateDir(projectPath) {
@@ -69,12 +70,15 @@ export async function writeSpecSessionState(projectPath, specId, specTitle, last
             resumePrompt: resumePrompt.slice(0, 300),
             updatedAt: new Date().toISOString(),
         };
-        await writeFile(specFile(projectPath, specId), JSON.stringify(state, null, 2), 'utf-8');
+        await stableWriteGeneratedFile(specFile(projectPath, specId), stableJsonStringify(state), {
+            equivalence: stripRootUpdatedAt,
+        });
         // Update root session.json index
+        let existingIndexContent = null;
         let index = { activeSpecs: [], updatedAt: '' };
         try {
-            const raw = await readFile(rootFile(projectPath), 'utf-8');
-            index = JSON.parse(raw);
+            existingIndexContent = await readFile(rootFile(projectPath), 'utf-8');
+            index = JSON.parse(existingIndexContent);
         }
         catch {
             /* start fresh */
@@ -83,7 +87,10 @@ export async function writeSpecSessionState(projectPath, specId, specTitle, last
             index.activeSpecs.push(specId);
         }
         index.updatedAt = new Date().toISOString();
-        await writeFile(rootFile(projectPath), JSON.stringify(index, null, 2), 'utf-8');
+        await stableWriteGeneratedFile(rootFile(projectPath), stableJsonStringify(index), {
+            equivalence: stripRootUpdatedAt,
+            existingContent: existingIndexContent,
+        });
         // Auto-commit planu/ changes so session.json is never left unstaged
         void (async () => {
             try {
@@ -127,10 +134,11 @@ export async function updateEpicProgressInSession(projectPath, specs) {
             return;
         }
         const filePath = rootFile(projectPath);
+        let existingContent = null;
         let index = { activeSpecs: [], updatedAt: '' };
         try {
-            const raw = await readFile(filePath, 'utf-8');
-            index = JSON.parse(raw);
+            existingContent = await readFile(filePath, 'utf-8');
+            index = JSON.parse(existingContent);
         }
         catch {
             /* start fresh */
@@ -141,7 +149,10 @@ export async function updateEpicProgressInSession(projectPath, specs) {
         index.activeSpecs = index.activeSpecs.filter((specId) => !terminalSpecIds.has(specId));
         index.epicProgress = epicProgress;
         index.updatedAt = new Date().toISOString();
-        await writeFile(filePath, JSON.stringify(index, null, 2), 'utf-8');
+        await stableWriteGeneratedFile(filePath, stableJsonStringify(index), {
+            equivalence: stripRootUpdatedAt,
+            existingContent,
+        });
         // Auto-commit planu/ changes so session.json is never left unstaged
         void (async () => {
             try {
@@ -166,10 +177,11 @@ export async function patchSessionJson(projectPath, patch) {
     try {
         const filePath = rootFile(projectPath);
         await mkdir(stateDir(projectPath), { recursive: true });
+        let existingContent = null;
         let index = { activeSpecs: [], updatedAt: '' };
         try {
-            const raw = await readFile(filePath, 'utf-8');
-            index = JSON.parse(raw);
+            existingContent = await readFile(filePath, 'utf-8');
+            index = JSON.parse(existingContent);
         }
         catch {
             /* start fresh */
@@ -179,7 +191,10 @@ export async function patchSessionJson(projectPath, patch) {
             ...patch,
             updatedAt: new Date().toISOString(),
         };
-        await writeFile(filePath, JSON.stringify(updated, null, 2), 'utf-8');
+        await stableWriteGeneratedFile(filePath, stableJsonStringify(updated), {
+            equivalence: stripRootUpdatedAt,
+            existingContent,
+        });
         // Auto-commit planu/ changes so session.json is never left unstaged
         void (async () => {
             try {
@@ -200,11 +215,15 @@ export async function patchSessionJson(projectPath, patch) {
  */
 export async function removeSpecFromSession(projectPath, specId) {
     try {
-        const raw = await readFile(rootFile(projectPath), 'utf-8');
-        const index = JSON.parse(raw);
+        const filePath = rootFile(projectPath);
+        const existingContent = await readFile(filePath, 'utf-8');
+        const index = JSON.parse(existingContent);
         index.activeSpecs = index.activeSpecs.filter((id) => id !== specId);
         index.updatedAt = new Date().toISOString();
-        await writeFile(rootFile(projectPath), JSON.stringify(index, null, 2), 'utf-8');
+        await stableWriteGeneratedFile(filePath, stableJsonStringify(index), {
+            equivalence: stripRootUpdatedAt,
+            existingContent,
+        });
         // Auto-commit planu/ changes so session.json is never left unstaged
         void (async () => {
             try {

package/dist/engine/spec-format/acceptance-criteria.d.ts

@@ -0,0 +1,5 @@
+import type { NormalizedAcceptanceCriterion } from '../../types/spec-format.js';
+export declare function extractNormalizedAcceptanceCriteria(raw: string): NormalizedAcceptanceCriterion[];
+export declare function extractAcceptanceCriteriaTexts(raw: string): string[];
+export declare function normalizeAcceptanceCriterionToken(value: string): string;
+//# sourceMappingURL=acceptance-criteria.d.ts.map

package/dist/engine/spec-format/acceptance-criteria.js

@@ -0,0 +1,106 @@
+import { parseFrontmatterScenarios } from '../validator/spec-compliance-runner.js';
+import { stripFrontmatter } from '../frontmatter-parser.js';
+import { extractListItems, extractSection } from '../validator/extractors.js';
+function normalizeCriterionValue(value) {
+    return value
+        .replace(/^-\s*\[[ x]\]\s*/i, '')
+        .replace(/[`*_()[\]:]/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .toLowerCase();
+}
+function stripCriterionIdPrefix(value) {
+    return value.replace(/^(AC\d+)\s*[:.)-]?\s*/i, '').trim();
+}
+function detectCriterionId(value, index) {
+    const explicit = /^(AC\d+)\b/i.exec(value)?.[1];
+    return (explicit ?? `AC${String(index + 1)}`).toUpperCase();
+}
+function extractSectionCriteria(section) {
+    const listItems = extractListItems(section);
+    if (listItems.length > 0) {
+        return listItems;
+    }
+    const lines = section.split('\n').map((line) => line.trim());
+    if (lines.length === 0) {
+        return [];
+    }
+    const bddBlocks = [];
+    let current = [];
+    for (const line of lines) {
+        if (line.length === 0) {
+            if (current.length > 0) {
+                bddBlocks.push(current.join(' '));
+                current = [];
+            }
+            continue;
+        }
+        if (/^(GIVEN|WHEN|THEN|AND|DADO|CUANDO|ENTONCES|Y)\b/i.test(line)) {
+            if (/^(GIVEN|DADO)\b/i.test(line) && current.length > 0) {
+                bddBlocks.push(current.join(' '));
+                current = [];
+            }
+            current.push(line.replace(/^[-*+]\s*/, ''));
+            continue;
+        }
+        if (current.length > 0) {
+            current.push(line);
+        }
+    }
+    if (current.length > 0) {
+        bddBlocks.push(current.join(' '));
+    }
+    return bddBlocks;
+}
+function extractBodyCriteria(raw) {
+    const body = stripFrontmatter(raw);
+    const acceptanceCriteria = extractSection(body, 'acceptance criteria', 'criterios de aceptaci');
+    if (acceptanceCriteria) {
+        const sectionCriteria = extractSectionCriteria(acceptanceCriteria);
+        if (sectionCriteria.length > 0) {
+            return sectionCriteria;
+        }
+    }
+    return body
+        .split('\n')
+        .map((line) => line.trim())
+        .filter((line) => /^-\s*\[[ x]\]/i.test(line) || /^- .*\bgiven\b.*\bwhen\b.*\bthen\b/i.test(line))
+        .map((line) => line.replace(/^-\s*\[[ x]\]\s*/i, '').trim());
+}
+function buildCriterion(text, source, index) {
+    const trimmed = text.trim();
+    if (trimmed.length === 0) {
+        return null;
+    }
+    const id = detectCriterionId(trimmed, index);
+    const withoutId = stripCriterionIdPrefix(trimmed);
+    const aliases = new Set([
+        normalizeCriterionValue(trimmed),
+        normalizeCriterionValue(withoutId),
+        normalizeCriterionValue(id),
+    ]);
+    return {
+        id,
+        text: withoutId,
+        source,
+        aliases: [...aliases].filter((alias) => alias.length > 0),
+    };
+}
+export function extractNormalizedAcceptanceCriteria(raw) {
+    const bodyCriteria = extractBodyCriteria(raw)
+        .map((criterion, index) => buildCriterion(criterion, 'body', index))
+        .filter((criterion) => criterion !== null);
+    if (bodyCriteria.length > 0) {
+        return bodyCriteria;
+    }
+    return parseFrontmatterScenarios(raw)
+        .map((scenario, index) => buildCriterion(scenario.title, 'frontmatter', index))
+        .filter((criterion) => criterion !== null);
+}
+export function extractAcceptanceCriteriaTexts(raw) {
+    return extractNormalizedAcceptanceCriteria(raw).map((criterion) => criterion.text);
+}
+export function normalizeAcceptanceCriterionToken(value) {
+    return normalizeCriterionValue(stripCriterionIdPrefix(value));
+}
+//# sourceMappingURL=acceptance-criteria.js.map

package/dist/engine/spec-migrator/strict-planu-cleanup.js

@@ -133,6 +133,13 @@ async function walkSpecDirectory(projectPath, specDir, result) {
         }
     }
 }
+async function shouldDeleteOrphanSpecDir(specDir) {
+    const entries = await readdir(specDir).catch(() => []);
+    if (entries.includes('spec.md')) {
+        return false;
+    }
+    return !entries.some((entry) => mustMergeBeforeDeleteSpecFile(entry));
+}
 export async function runStrictPlanuCleanup(projectPath) {
     const result = { deleted: [], merged: [], gitignoreUpdated: false };
     const planuDir = join(projectPath, 'planu');
@@ -170,6 +177,11 @@ export async function runStrictPlanuCleanup(projectPath) {
             result.deleted.push(relative(projectPath, full));
             continue;
         }
+        if (await shouldDeleteOrphanSpecDir(full)) {
+            await removePath(projectPath, full);
+            result.deleted.push(relative(projectPath, full));
+            continue;
+        }
         await walkSpecDirectory(projectPath, full, result);
     }
     result.gitignoreUpdated = await updateGitignore(projectPath);
@@ -210,6 +222,10 @@ export async function validateStrictPlanuLayout(projectPath, options = {}) {
             offenders.push(relative(projectPath, full));
             continue;
         }
+        if (await shouldDeleteOrphanSpecDir(full)) {
+            offenders.push(relative(projectPath, full));
+            continue;
+        }
         for (const entry of await readdir(full).catch(() => [])) {
             const entryPath = join(full, entry);
             const isDir = await pathIsDirectory(entryPath);

package/dist/engine/universal-rules/catalog.js

@@ -9,6 +9,7 @@ import { planuBddCriteriaRule } from './rules/planu-bdd-criteria.js';
 import { planuApprovalGatesRule } from './rules/planu-approval-gates.js';
 import { planuReleasePolicyRule } from './rules/planu-release-policy.js';
 import { planuSddModelRoutingRule } from './rules/planu-sdd-model-routing.js';
+import { planuMinimalChangeRule } from './rules/planu-minimal-change.js';
 /**
  * The full catalog of universal Planu rules.
  * Order matters: rules are installed in catalog order.
@@ -19,6 +20,7 @@ export const UNIVERSAL_RULES = [
     planuBddCriteriaRule,
     planuApprovalGatesRule,
     planuSddModelRoutingRule,
+    planuMinimalChangeRule,
     planuReleasePolicyRule,
     planuModesRule,
     agentTeamsRule,

package/dist/engine/universal-rules/rules/planu-minimal-change.d.ts

@@ -0,0 +1,3 @@
+import type { UniversalRule } from '../../../types/universal-rules/index.js';
+export declare const planuMinimalChangeRule: UniversalRule;
+//# sourceMappingURL=planu-minimal-change.d.ts.map

package/dist/engine/universal-rules/rules/planu-minimal-change.js

@@ -0,0 +1,44 @@
+// engine/universal-rules/rules/planu-minimal-change.ts
+// Universal rule: minimal-change implementation discipline.
+function buildBody() {
+    return `# Planu Minimal Change
+
+Use the smallest correct change after reading the task and the code path it touches.
+
+Before writing code, stop at the first rung that holds:
+
+1. Does this need to be built at all? If not, do not build it.
+2. Does this codebase already have the helper, utility, convention, or pattern? Reuse it.
+3. Does the standard library already do this? Use it.
+4. Does the native platform already cover it? Use it.
+5. Does an already-installed dependency solve it? Use it.
+6. Can this be one clear line? Use one clear line.
+7. Only then, write the minimum code that satisfies the approved spec.
+
+The ladder runs after understanding, not instead of understanding. Read the relevant files, trace the real flow, and fix shared root causes rather than patching one visible symptom per caller.
+
+Prefer deletion over addition, boring over clever, and fewer touched files over broader refactors. Do not add abstractions, dependencies, configuration, feature flags, compatibility paths, or future-proofing unless the approved spec explicitly requires them.
+
+Minimal does not mean unsafe. Never remove or weaken:
+
+- security checks
+- trust-boundary validation
+- data-loss error handling
+- accessibility
+- explicit user requirements
+- required tests or validation commands
+- SDD approval, evidence, review, or done gates
+
+If a deliberate shortcut has a known ceiling, record the ceiling and upgrade trigger as structured Planu debt evidence instead of leaving a vague comment.
+`;
+}
+export const planuMinimalChangeRule = {
+    id: 'planu-minimal-change',
+    name: 'Planu Minimal Change',
+    description: 'Smallest-correct-change ladder with explicit safety boundaries.',
+    category: 'quality',
+    applicableHosts: ['all'],
+    defaultEnabled: true,
+    buildContent: (_host) => buildBody(),
+};
+//# sourceMappingURL=planu-minimal-change.js.map

package/dist/engine/universal-rules/rules/planu-release-policy.js

@@ -6,23 +6,26 @@ Auto-generated by \`init_project\`. Do not edit manually.
 
 ## Rule
 
-When implementation changes are complete and validated, always address release explicitly:
+When implementation changes are complete and validated, always address release explicitly with a local-first flow:
 
-- create the release when the user has already requested shipping or publishing
-- otherwise ask before publishing, tagging, or pushing externally visible release artifacts
+- canonical local gates: \`pnpm validate\` then \`pnpm check:strict\`
+- canonical local release command: \`pnpm release:local\`
+- publish externally only when the user has explicitly requested shipping/publishing
+- use \`main\` as the default release branch; treat \`develop\` as optional gitflow compatibility only when the repository actively uses it
 
 ## Required Release Checklist
 
-- tests and validation commands passed
+- local validation commands passed
 - changelog or release notes updated when applicable
 - package version and git tag stay aligned
-- main/develop branch state is reconciled when the repository uses both
+- release metadata under \`planu/releases/pending.json\` contains only genuinely pending entries
 - published package smoke check is run after release when applicable
 
 ## Hard Blocks
 
 - Do not silently skip release discussion after completed product/runtime changes.
 - Do not publish without validation evidence.
+- Do not let hosted CI, branch protection, or release bots redefine the canonical local release contract.
 - Do not leave release notes promising capabilities that are not in the public runtime.
 `;
 }

package/dist/native/lightweight-command-catalog.d.ts

@@ -47,7 +47,7 @@ export declare const LIGHTWEIGHT_COMMANDS: readonly [{
 }, {
     readonly id: "planu.release.check";
     readonly title: "Check release readiness";
-    readonly description: "Check local branch cleanliness and main/develop/release sync readiness.";
+    readonly description: "Check local-first release readiness, branch cleanliness, and optional gitflow drift.";
     readonly invocation: "planu release check";
     readonly hosts: readonly ["codex", "claude-code"];
     readonly requiresMcp: false;

package/dist/native/lightweight-command-catalog.js

@@ -54,7 +54,7 @@ export const LIGHTWEIGHT_COMMANDS = [
     {
         id: 'planu.release.check',
         title: 'Check release readiness',
-        description: 'Check local branch cleanliness and main/develop/release sync readiness.',
+        description: 'Check local-first release readiness, branch cleanliness, and optional gitflow drift.',
         invocation: 'planu release check',
         hosts: ['codex', 'claude-code'],
         requiresMcp: false,

package/dist/resources/process.js

@@ -93,8 +93,9 @@ function getSddProcess() {
                 id: 'documenting',
                 name: '8. Document & Ship',
                 tools: ['generate_docs', 'generate_docs_site', 'integrate_pm', 'learn_pattern'],
-                description: 'Generate documentation. Sync with project management tools. ' +
-                    'Learn patterns for future estimations.',
+                description: 'Generate documentation, run the local-first release contract ' +
+                    '(`pnpm validate`, `pnpm check:strict`, `pnpm release:local` when shipping), ' +
+                    'sync with project management tools, and learn patterns for future estimations.',
             },
         ],
         specLifecycle: ['draft', 'review', 'approved', 'implementing', 'done'],

package/dist/tools/challenge-spec/event-challenge-scenarios.js

@@ -6,12 +6,8 @@ import { detectBrokers, getBrokerConfig, requiresIdempotence, } from '../../engi
  * Returns true when the spec or project has event-driven characteristics.
  */
 export function isEventDrivenSpec(spec, specContent, knowledge) {
-    const brokers = detectBrokers(knowledge.stack);
-    if (brokers.length > 0 && brokers[0] !== 'unknown') {
-        return true;
-    }
     const lower = `${spec.title} ${spec.tags.join(' ')} ${specContent}`.toLowerCase();
-    return (lower.includes('event') ||
+    const specSignals = lower.includes('event') ||
         lower.includes('kafka') ||
         lower.includes('rabbitmq') ||
         lower.includes('pubsub') ||
@@ -21,7 +17,15 @@ export function isEventDrivenSpec(spec, specContent, knowledge) {
         lower.includes('sns') ||
         lower.includes('message') ||
         lower.includes('consumer') ||
-        lower.includes('producer'));
+        lower.includes('producer');
+    if (spec.target === 'frontend' && !specSignals) {
+        return false;
+    }
+    const brokers = detectBrokers(knowledge.stack);
+    if (specSignals) {
+        return true;
+    }
+    return brokers.length > 0 && brokers[0] !== 'unknown' && spec.target !== 'frontend';
 }
 /**
  * Generate event-driven failure scenarios for challenge_spec.

package/dist/tools/git/hook-ops.js

@@ -265,7 +265,7 @@ export async function handleSetupHooks(projectId, config) {
     /* v8 ignore start */
     const protectedBranches = mergedConfig.protectedBranches ?? DEFAULT_PROTECTED_BRANCHES;
     const stalenessThreshold = mergedConfig.stalenessThreshold ?? 50;
-    const baseBranch = mergedConfig.baseBranch ?? 'develop';
+    const baseBranch = mergedConfig.baseBranch ?? 'main';
     /* v8 ignore end */
     const preCommitScript = buildPreCommitScript(
     /* v8 ignore next */ mergedConfig.requireSpecInCommit ?? true, stalenessThreshold, baseBranch);

package/dist/tools/init-project/per-client-files-writer.js

@@ -63,6 +63,7 @@ Planu enforces Spec Driven Development — spec first, then implement, then vali
 
 - NEVER write production code before spec is \`approved\`
 - NEVER skip \`validate\` after implementation
+- Specs stay \`spec.md\`-only. Do not recreate standalone \`technical.md\` or \`progress.md\`.
 `;
 const CODEX_NATIVE_SKILL_CONTENT = `# planu-native — Planu Lightweight Native Surface
 
@@ -79,7 +80,7 @@ Use Planu's lightweight CLI surface for common SDD checks without loading the fu
 - \`planu spec list\` — list specs
 - \`planu spec validate SPEC-001\` — validate one spec
 - \`planu audit debt\` — read-only technical debt audit
-- \`planu release check\` — local release readiness check
+- \`planu release check\` — local-first release readiness check
 
 ## Escalate to Full MCP
 

package/dist/tools/init-project/rules-generator.js

@@ -20,6 +20,19 @@ Auto-generated by \`init_project\`. Do not edit manually.
 
 Flow: \`facilitate → create_spec → challenge_spec → check_readiness → approve → implement → validate → done\`
 
+## Evidence Gates
+
+For non-trivial specs, Planu blocks lifecycle transitions unless evidence is present:
+
+| Transition | Required evidence |
+|------------|-------------------|
+| \`approved\` | Discovery evidence: rules, examples, open questions, out-of-scope, glossary |
+| \`implementing\` | Task plan mapped to acceptance criteria |
+| \`done\` | Traceability matrix covering every acceptance criterion |
+| \`done\` for API/UI/event/MCP work | Passing contract validation evidence |
+
+Evidence lives in the external Planu handoff store, not under \`planu/specs/<spec>/\`. Spec folders remain \`spec.md\`-only.
+
 ## When to use \`facilitate\`
 
 Any new feature, bug fix, refactor, integration, or task > 5 min.
@@ -51,6 +64,7 @@ Any new feature, bug fix, refactor, integration, or task > 5 min.
 - NEVER write code before spec is \`approved\`
 - NEVER skip \`validate\` after implementation
 - NEVER create design docs outside \`planu/specs/\`
+- NEVER recreate legacy \`technical.md\`, \`progress.md\`, or \`HU.md\` files for new specs
 
 ## Model Selection (MANDATORY)
 

package/dist/tools/update-status/evidence-gate.js

@@ -1,12 +1,12 @@
 import { readFile } from 'node:fs/promises';
 import { isAbsolute, join } from 'node:path';
-import { extractCriteria, extractListItems, extractSection, } from '../../engine/validator/extractors.js';
-import { stripFrontmatter } from '../../engine/frontmatter-parser.js';
+import { extractCriteria } from '../../engine/validator/extractors.js';
 import { readEvidenceArtifacts } from '../../engine/evidence-gates/artifact-reader.js';
 import { checkLifecycleEvidenceGate } from '../../engine/evidence-gates/lifecycle-gate.js';
 import { buildSpecEvidenceIndex } from '../../engine/evidence-index/index-builder.js';
 import { checkDoneDriftContract } from '../../engine/evidence-index/done-drift.js';
 import { parseTechnicalReferenceGroundingRecords } from '../../engine/spec-grounding/contract.js';
+import { extractAcceptanceCriteriaTexts } from '../../engine/spec-format/acceptance-criteria.js';
 /** SPEC-1054: BDD/SDD lifecycle evidence gate. */
 export async function checkLifecycleEvidenceTransitionGate(args) {
     const [criteriaResult, artifacts] = await Promise.all([
@@ -54,13 +54,9 @@ async function extractLifecycleGateCriteriaAndBody(spec, projectPath) {
     const specPath = isAbsolute(spec.specPath) || !projectPath ? spec.specPath : join(projectPath, spec.specPath);
     try {
         const raw = await readFile(specPath, 'utf-8');
-        const body = stripFrontmatter(raw);
-        const acceptanceCriteria = extractSection(body, 'acceptance criteria', 'criterios de aceptaci');
-        if (acceptanceCriteria) {
-            const items = extractListItems(acceptanceCriteria);
-            if (items.length > 0) {
-                return { criteria: [...new Set(items)], body: raw };
-            }
+        const criteria = extractAcceptanceCriteriaTexts(raw);
+        if (criteria.length > 0) {
+            return { criteria: [...new Set(criteria)], body: raw };
         }
     }
     catch {

package/dist/types/cascade-hooks.d.ts

@@ -35,6 +35,11 @@ export type CoreActionResult = {
     ok: false;
     error: string;
 };
+export interface PendingReleaseEntry {
+    specId: string;
+    title: string;
+    completedAt: string;
+}
 /** SPEC-772: Result of a single fast hook execution. */
 export interface FastHookResult {
     hookId: string;

package/dist/types/generated-artifacts.d.ts

@@ -0,0 +1,13 @@
+export interface StableWriteResult {
+    written: boolean;
+    reason: 'changed' | 'missing' | 'unchanged';
+}
+export interface StableWriteOptions {
+    /**
+     * Normalize content for semantic comparison. The original content is still
+     * written when formatting differs, but volatile-only differences can be skipped.
+     */
+    equivalence?: (content: string) => string;
+    existingContent?: string | null;
+}
+//# sourceMappingURL=generated-artifacts.d.ts.map

package/dist/types/generated-artifacts.js

@@ -0,0 +1,3 @@
+// types/generated-artifacts.ts — stable generated artifact write contracts.
+export {};
+//# sourceMappingURL=generated-artifacts.js.map

package/dist/types/spec-format.d.ts

@@ -27,6 +27,12 @@ export interface BddScenario {
         line?: number;
     }[];
 }
+export interface NormalizedAcceptanceCriterion {
+    id: string;
+    text: string;
+    source: 'body' | 'frontmatter';
+    aliases: string[];
+}
 /** Input for lean spec generation. */
 export interface LeanSpecInput {
     spec: Spec;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@planu/cli",
-  "version": "4.7.3",
+  "version": "4.7.5",
   "description": "Planu — MCP Server for Spec Driven Development with native Rust acceleration for hot paths. Cross-platform (Linux/macOS/Windows, x64/arm64, glibc/musl).",
   "type": "module",
   "main": "dist/index.js",
@@ -34,14 +34,14 @@
     "packageName": "@planu/core"
   },
   "optionalDependencies": {
-    "@planu/core-darwin-arm64": "4.7.3",
-    "@planu/core-darwin-x64": "4.7.3",
-    "@planu/core-linux-arm64-gnu": "4.7.3",
-    "@planu/core-linux-arm64-musl": "4.7.3",
-    "@planu/core-linux-x64-gnu": "4.7.3",
-    "@planu/core-linux-x64-musl": "4.7.3",
-    "@planu/core-win32-arm64-msvc": "4.7.3",
-    "@planu/core-win32-x64-msvc": "4.7.3"
+    "@planu/core-darwin-arm64": "4.7.5",
+    "@planu/core-darwin-x64": "4.7.5",
+    "@planu/core-linux-arm64-gnu": "4.7.5",
+    "@planu/core-linux-arm64-musl": "4.7.5",
+    "@planu/core-linux-x64-gnu": "4.7.5",
+    "@planu/core-linux-x64-musl": "4.7.5",
+    "@planu/core-win32-arm64-msvc": "4.7.5",
+    "@planu/core-win32-x64-msvc": "4.7.5"
   },
   "engines": {
     "node": ">=24.0.0"
@@ -168,8 +168,8 @@
     }
   },
   "devDependencies": {
-    "@commitlint/cli": "^21.0.2",
-    "@commitlint/config-conventional": "^21.0.2",
+    "@commitlint/cli": "^21.1.0",
+    "@commitlint/config-conventional": "^21.1.0",
     "@eslint/js": "^10.0.1",
     "@napi-rs/cli": "^3.7.2",
     "@secretlint/secretlint-rule-no-homedir": "^13.0.2",
@@ -183,7 +183,7 @@
     "@stryker-mutator/core": "^9.6.1",
     "@stryker-mutator/vitest-runner": "^9.6.1",
     "@supabase/supabase-js": "^2.108.2",
-    "@types/node": "^25.9.3",
+    "@types/node": "^26.0.0",
     "@vitejs/plugin-vue": "^6.0.7",
     "@vitest/coverage-v8": "^4.1.9",
     "@vue/test-utils": "^2.4.11",
@@ -194,8 +194,8 @@
     "happy-dom": "^20.10.6",
     "husky": "^9.1.7",
     "javascript-obfuscator": "^5.4.3",
-    "knip": "^6.17.1",
-    "lint-staged": "^17.0.7",
+    "knip": "^6.20.0",
+    "lint-staged": "^17.0.8",
     "madge": "^8.0.0",
     "prettier": "^3.8.4",
     "secretlint": "^13.0.2",
@@ -203,8 +203,8 @@
     "tsc-alias": "^1.8.17",
     "type-coverage": "^2.29.7",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.61.1",
-    "vite": "^8.0.16",
+    "typescript-eslint": "^8.62.0",
+    "vite": "^8.1.0",
     "vitest": "^4.1.9",
     "vue": "^3.5.38"
   }