@planu/cli 5.0.0 → 5.2.0

package/dist/engine/planu-core.win32-x64-msvc.node.sbom.json

@@ -4,14 +4,14 @@
   "version": 1,
   "metadata": {
     "component": {
-      "bom-ref": "pkg:cargo/planu-core@5.0.0",
+      "bom-ref": "pkg:cargo/planu-core@5.2.0",
       "type": "library",
       "name": "planu-core",
-      "version": "5.0.0",
+      "version": "5.2.0",
       "hashes": [
         {
           "alg": "SHA-256",
-          "content": "fc9c98775c98b2f91d36ce9cb74567a547512ba5d11635052f230868af9ca9e3"
+          "content": "bb7d31e5232b18f0ec9e03196cffdc57e48ac6993b6df064ff85b60c37804b93"
         }
       ]
     }
@@ -291,9 +291,9 @@
     },
     {
       "type": "library",
-      "bom-ref": "pkg:cargo/globset@0.4.19",
+      "bom-ref": "pkg:cargo/globset@0.4.20",
       "name": "globset",
-      "version": "0.4.19",
+      "version": "0.4.20",
       "externalReferences": [
         {
           "type": "distribution",
@@ -529,9 +529,9 @@
     },
     {
       "type": "library",
-      "bom-ref": "pkg:cargo/regex-automata@0.4.16",
+      "bom-ref": "pkg:cargo/regex-automata@0.4.18",
       "name": "regex-automata",
-      "version": "0.4.16",
+      "version": "0.4.18",
       "externalReferences": [
         {
           "type": "distribution",
@@ -1046,12 +1046,12 @@
       ]
     },
     {
-      "ref": "pkg:cargo/globset@0.4.19",
+      "ref": "pkg:cargo/globset@0.4.20",
       "dependsOn": [
         "pkg:cargo/aho-corasick@1.1.5",
         "pkg:cargo/bstr@1.13.0",
         "pkg:cargo/log@0.4.33",
-        "pkg:cargo/regex-automata@0.4.16",
+        "pkg:cargo/regex-automata@0.4.18",
         "pkg:cargo/regex-syntax@0.8.11"
       ]
     },
@@ -1069,10 +1069,10 @@
       "ref": "pkg:cargo/ignore@0.4.25",
       "dependsOn": [
         "pkg:cargo/crossbeam-deque@0.8.7",
-        "pkg:cargo/globset@0.4.19",
+        "pkg:cargo/globset@0.4.20",
         "pkg:cargo/log@0.4.33",
         "pkg:cargo/memchr@2.8.3",
-        "pkg:cargo/regex-automata@0.4.16",
+        "pkg:cargo/regex-automata@0.4.18",
         "pkg:cargo/same-file@1.0.6",
         "pkg:cargo/walkdir@2.5.0",
         "pkg:cargo/winapi-util@0.1.11"
@@ -1106,7 +1106,7 @@
       "dependsOn": []
     },
     {
-      "ref": "pkg:cargo/planu-core@5.0.0",
+      "ref": "pkg:cargo/planu-core@5.2.0",
       "dependsOn": [
         "pkg:cargo/core-foundation@0.10.1",
         "pkg:cargo/hmac@0.12.1",
@@ -1151,7 +1151,7 @@
       ]
     },
     {
-      "ref": "pkg:cargo/regex-automata@0.4.16",
+      "ref": "pkg:cargo/regex-automata@0.4.18",
       "dependsOn": [
         "pkg:cargo/aho-corasick@1.1.5",
         "pkg:cargo/memchr@2.8.3",
@@ -1167,7 +1167,7 @@
       "dependsOn": [
         "pkg:cargo/aho-corasick@1.1.5",
         "pkg:cargo/memchr@2.8.3",
-        "pkg:cargo/regex-automata@0.4.16",
+        "pkg:cargo/regex-automata@0.4.18",
         "pkg:cargo/regex-syntax@0.8.11"
       ]
     },

package/dist/engine/reverse-engineer/api-detector.js

@@ -1,5 +1,6 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
+import { shouldIgnoreDir } from './walk-ignore.js';
 const ROUTE_PATTERNS = [
     // Express/Koa/Hono: app.get('/path', handler) or router.post(...)
     {
@@ -69,18 +70,6 @@ const SOURCE_EXTENSIONS = new Set([
     '.kt',
     '.rb',
 ]);
-const IGNORE_DIRS = new Set([
-    'node_modules',
-    '.git',
-    'dist',
-    'build',
-    'out',
-    '.next',
-    '.nuxt',
-    'coverage',
-    'vendor',
-    '__pycache__',
-]);
 function collectSourceFiles(dir) {
     const results = [];
     const queue = [dir];
@@ -97,7 +86,7 @@ function collectSourceFiles(dir) {
             continue;
         }
         for (const entry of entries) {
-            if (IGNORE_DIRS.has(entry.name)) {
+            if (shouldIgnoreDir(entry.name)) {
                 continue;
             }
             const full = path.join(current, entry.name);

package/dist/engine/reverse-engineer/complexity-analyzer.js

@@ -1,5 +1,6 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
+import { shouldIgnoreDir } from './walk-ignore.js';
 const SOURCE_EXTENSIONS = new Set([
     '.ts',
     '.tsx',
@@ -14,18 +15,6 @@ const SOURCE_EXTENSIONS = new Set([
     '.rs',
     '.rb',
 ]);
-const IGNORE_DIRS = new Set([
-    'node_modules',
-    '.git',
-    'dist',
-    'build',
-    'out',
-    '.next',
-    '.nuxt',
-    'coverage',
-    'vendor',
-    '__pycache__',
-]);
 // Patterns that increase cyclomatic complexity
 const BRANCH_PATTERNS = [
     /\bif\s*\(/g,
@@ -73,7 +62,7 @@ function collectSourceFiles(dir) {
             continue;
         }
         for (const entry of entries) {
-            if (IGNORE_DIRS.has(entry.name)) {
+            if (shouldIgnoreDir(entry.name)) {
                 continue;
             }
             const full = path.join(current, entry.name);

package/dist/engine/reverse-engineer/config-analyzer.js

@@ -1,6 +1,7 @@
 import { technologyValue } from '../technology-registry.js';
 import * as fs from 'node:fs';
 import * as path from 'node:path';
+import { shouldIgnoreDir } from './walk-ignore.js';
 const ENV_VAR_PATTERNS = [
     // JS/TS: process.env.VAR_NAME
     /process\.env\.([A-Z_][A-Z0-9_]*)/g,
@@ -55,18 +56,6 @@ const INFRA_INDICATORS = {
     'azure-pipelines.yml': 'Azure Pipelines',
     'cloudbuild.yaml': 'Google Cloud Build',
 };
-const IGNORE_DIRS = new Set([
-    'node_modules',
-    '.git',
-    'dist',
-    'build',
-    'out',
-    '.next',
-    '.nuxt',
-    'coverage',
-    'vendor',
-    '__pycache__',
-]);
 const SOURCE_EXTENSIONS = new Set([
     '.ts',
     '.tsx',
@@ -97,7 +86,7 @@ function collectAllFiles(dir) {
             continue;
         }
         for (const entry of entries) {
-            if (IGNORE_DIRS.has(entry.name)) {
+            if (shouldIgnoreDir(entry.name)) {
                 continue;
             }
             const full = path.join(current, entry.name);

package/dist/engine/reverse-engineer/dependency-graph.js

@@ -1,5 +1,6 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
+import { shouldIgnoreDir } from './walk-ignore.js';
 const IMPORT_PATTERNS = [
     // ES import: import ... from './foo'
     /(?:import\s+(?:[\s\S]*?)\s+from\s+['"]([^'"]+)['"])/g,
@@ -22,18 +23,6 @@ const SOURCE_EXTENSIONS = new Set([
     '.rs',
     '.rb',
 ]);
-const IGNORE_DIRS = new Set([
-    'node_modules',
-    '.git',
-    'dist',
-    'build',
-    'out',
-    '.next',
-    '.nuxt',
-    'coverage',
-    'vendor',
-    '__pycache__',
-]);
 const HUB_THRESHOLD = 10;
 function collectSourceFiles(dir) {
     const results = [];
@@ -51,7 +40,7 @@ function collectSourceFiles(dir) {
             continue;
         }
         for (const entry of entries) {
-            if (IGNORE_DIRS.has(entry.name)) {
+            if (shouldIgnoreDir(entry.name)) {
                 continue;
             }
             const full = path.join(current, entry.name);

package/dist/engine/reverse-engineer/test-analyzer.js

@@ -1,5 +1,6 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
+import { shouldIgnoreDir } from './walk-ignore.js';
 const TEST_PATTERNS = [
     /\.test\.\w+$/,
     /\.spec\.\w+$/,
@@ -25,18 +26,6 @@ const SOURCE_EXTENSIONS = new Set([
     '.c',
     '.swift',
 ]);
-const IGNORE_DIRS = new Set([
-    'node_modules',
-    '.git',
-    'dist',
-    'build',
-    'out',
-    '.next',
-    '.nuxt',
-    'coverage',
-    'vendor',
-    '__pycache__',
-]);
 export function isTestFile(filePath) {
     const basename = path.basename(filePath);
     if (TEST_PATTERNS.some((p) => p.test(basename))) {
@@ -61,7 +50,7 @@ function collectFiles(dir) {
             continue;
         }
         for (const entry of entries) {
-            if (IGNORE_DIRS.has(entry.name)) {
+            if (shouldIgnoreDir(entry.name)) {
                 continue;
             }
             const full = path.join(current, entry.name);

package/dist/engine/reverse-engineer/walk-ignore.d.ts

@@ -0,0 +1,3 @@
+export declare const WALK_IGNORE_DIRS: ReadonlySet<string>;
+export declare function shouldIgnoreDir(name: string): boolean;
+//# sourceMappingURL=walk-ignore.d.ts.map

package/dist/engine/reverse-engineer/walk-ignore.js

@@ -0,0 +1,26 @@
+// engine/reverse-engineer/walk-ignore.ts — shared directory-walk ignore list
+// Consumed by all reverse-engineer analyzers (dependency-graph, test-analyzer,
+// api-detector, config-analyzer, complexity-analyzer) so the ignore rules stay
+// in one place instead of five duplicated copies.
+export const WALK_IGNORE_DIRS = new Set([
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    'out',
+    '.next',
+    '.nuxt',
+    'coverage',
+    'vendor',
+    '__pycache__',
+    '.worktrees',
+    '.claude',
+    'planu',
+    'website',
+    'data',
+    'benchmarks',
+]);
+export function shouldIgnoreDir(name) {
+    return WALK_IGNORE_DIRS.has(name);
+}
+//# sourceMappingURL=walk-ignore.js.map

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

@@ -1,6 +1,7 @@
 import { parseFrontmatterScenarios } from '../validator/spec-compliance-runner.js';
 import { stripFrontmatter } from '../frontmatter-parser.js';
 import { extractListItems, extractSection } from './markdown-sections.js';
+import { stripFencedBlocks } from './text-fences.js';
 import { createCriterionIdentity, normalizeCriterionText } from '../criterion-identity.js';
 const BDD_STEP = /^(GIVEN|WHEN|THEN|AND|DADO|CUANDO|ENTONCES|Y)\b/i;
 const BDD_START = /^(GIVEN|DADO)\b/i;
@@ -91,7 +92,7 @@ function extractSectionCriteria(section) {
     return extractBddBlocks(section);
 }
 function extractBodyCriteria(raw, options) {
-    const body = stripFrontmatter(raw);
+    const body = stripFencedBlocks(stripFrontmatter(raw));
     const acceptanceCriteria = extractSection(body, 'acceptance criteria', 'criterios de aceptaci');
     if (acceptanceCriteria) {
         const sectionCriteria = extractSectionCriteria(acceptanceCriteria);
@@ -99,18 +100,18 @@ function extractBodyCriteria(raw, options) {
             return sectionCriteria;
         }
     }
-    if (options.allowLegacyBodyFallback === false) {
-        return [];
-    }
-    const checkboxCriteria = body
-        .split('\n')
-        .map((line) => line.trim())
-        .filter((line) => /^-\s*\[[ x]\]/i.test(line))
-        .map((line) => line.replace(/^-\s*\[[ x]\]\s*/i, '').trim());
-    if (checkboxCriteria.length > 0) {
-        return checkboxCriteria;
+    if (options.allowLegacyBodyFallback !== false) {
+        const checkboxCriteria = body
+            .split('\n')
+            .map((line) => line.trim())
+            .filter((line) => /^-\s*\[[ x]\]/i.test(line))
+            .map((line) => line.replace(/^-\s*\[[ x]\]\s*/i, '').trim());
+        if (checkboxCriteria.length > 0) {
+            return checkboxCriteria;
+        }
+        return extractBddBlocks(body);
     }
-    return extractBddBlocks(body);
+    return [];
 }
 function buildCriterion(text, source, index) {
     const trimmed = text.trim();

package/dist/engine/spec-format/text-fences.js

@@ -4,7 +4,25 @@
  * Returns the remaining prose only, preserving line structure.
  */
 export function stripFencedBlocks(md) {
-    // Match ``` or ~~~ fences (with optional language specifier) spanning multiple lines
-    return md.replace(/^(`{3,}|~{3,})[^\n]*\n[\s\S]*?^\1\s*$/gm, '');
+    const lines = md.split('\n');
+    let openFence;
+    return lines
+        .map((line) => {
+        if (openFence !== undefined) {
+            const close = new RegExp(`^ {0,3}${openFence.marker}{${String(openFence.length)},}[ \\t]*\\r?$`);
+            if (close.test(line)) {
+                openFence = undefined;
+            }
+            return '';
+        }
+        const opening = /^ {0,3}(`{3,}|~{3,})[^\r\n]*\r?$/.exec(line);
+        if (opening?.[1]) {
+            const marker = opening[1][0];
+            openFence = { marker, length: opening[1].length };
+            return '';
+        }
+        return line;
+    })
+        .join('\n');
 }
 //# sourceMappingURL=text-fences.js.map

package/dist/engine/spec-language/english-only.d.ts

@@ -1,4 +1,5 @@
 import type { EnglishOnlyArtifactKind, EnglishOnlyValidationResult } from '../../types/spec-language.js';
+import type { EnglishOnlyGateResolution } from '../../types/spec-language-translation.js';
 /**
  * Validate that a Planu-owned persisted artifact is authored in English.
  *
@@ -12,5 +13,18 @@ export declare function validateEnglishOnlyArtifactText(text: string, kind?: Eng
  * Backward-compatible spec-specific entrypoint used by create_spec/update_status gates.
  */
 export declare function validateEnglishOnlySpecText(text: string): EnglishOnlyValidationResult;
+/** clarificationAnswers key carrying the LLM-provided English translation of the spec title. */
+export declare const TRANSLATED_TITLE_ANSWER_KEY = "Title-EN";
+/** clarificationAnswers key carrying the LLM-provided English translation of the description. */
+export declare const TRANSLATED_DESCRIPTION_ANSWER_KEY = "Desc-EN";
+/**
+ * SPEC-1342: Resolve the English-only gate for create_spec's title/description.
+ *
+ * Instead of hard-rejecting non-English input, this offers one clarification round:
+ * the calling LLM is asked (via the existing clarificationAnswers mechanism) to supply
+ * the English translation inline. Only rejects if that translation is missing or itself
+ * still non-English after the round.
+ */
+export declare function resolveEnglishOnlySpecGate(title: string, description: string, clarificationAnswers?: Record<string, string>): EnglishOnlyGateResolution;
 export declare function assertEnglishOnlyArtifactText(text: string, kind: EnglishOnlyArtifactKind): void;
 //# sourceMappingURL=english-only.d.ts.map

package/dist/engine/spec-language/english-only.js

@@ -119,6 +119,64 @@ export function validateEnglishOnlyArtifactText(text, kind = 'spec') {
 export function validateEnglishOnlySpecText(text) {
     return validateEnglishOnlyArtifactText(text, 'spec');
 }
+/** clarificationAnswers key carrying the LLM-provided English translation of the spec title. */
+export const TRANSLATED_TITLE_ANSWER_KEY = 'Title-EN';
+/** clarificationAnswers key carrying the LLM-provided English translation of the description. */
+export const TRANSLATED_DESCRIPTION_ANSWER_KEY = 'Desc-EN';
+/**
+ * SPEC-1342: Resolve the English-only gate for create_spec's title/description.
+ *
+ * Instead of hard-rejecting non-English input, this offers one clarification round:
+ * the calling LLM is asked (via the existing clarificationAnswers mechanism) to supply
+ * the English translation inline. Only rejects if that translation is missing or itself
+ * still non-English after the round.
+ */
+export function resolveEnglishOnlySpecGate(title, description, clarificationAnswers) {
+    const validation = validateEnglishOnlySpecText(`${title}\n\n${description}`);
+    if (validation.ok) {
+        return { action: 'ok' };
+    }
+    const originalLanguage = validation.detectedLanguage === 'pt' ? 'pt' : 'es';
+    const titleAnswer = clarificationAnswers?.[TRANSLATED_TITLE_ANSWER_KEY]?.trim();
+    const descriptionAnswer = clarificationAnswers?.[TRANSLATED_DESCRIPTION_ANSWER_KEY]?.trim();
+    if (!titleAnswer || !descriptionAnswer) {
+        return {
+            action: 'ask',
+            originalLanguage,
+            questions: buildTranslationRequestQuestions(title),
+        };
+    }
+    const translatedValidation = validateEnglishOnlySpecText(`${titleAnswer}\n\n${descriptionAnswer}`);
+    if (!translatedValidation.ok) {
+        return { action: 'reject', originalLanguage, reason: validation.reason };
+    }
+    return {
+        action: 'translated',
+        originalLanguage,
+        englishTitle: titleAnswer,
+        englishDescription: descriptionAnswer,
+    };
+}
+function buildTranslationRequestQuestions(title) {
+    return [
+        {
+            question: `The spec title "${title}" is not in English. What is the English translation of the title?`,
+            header: TRANSLATED_TITLE_ANSWER_KEY,
+            options: [
+                { label: 'Provide translation', description: 'Type the English translation as free text.' },
+            ],
+            multiSelect: false,
+        },
+        {
+            question: 'What is the English translation of the spec description?',
+            header: TRANSLATED_DESCRIPTION_ANSWER_KEY,
+            options: [
+                { label: 'Provide translation', description: 'Type the English translation as free text.' },
+            ],
+            multiSelect: false,
+        },
+    ];
+}
 export function assertEnglishOnlyArtifactText(text, kind) {
     const validation = validateEnglishOnlyArtifactText(text, kind);
     if (!validation.ok) {

package/dist/engine/spec-migrator/criteria-scanner.js

@@ -2,7 +2,7 @@
 import { readFile, readdir, stat } from 'node:fs/promises';
 import { join } from 'node:path';
 import { checkCriteriaQuality } from '../criteria-quality-checker.js';
-import { isNativeActive, fastScanSpecs } from '../core-bridge.js';
+import { fastScanSpecsAsync } from '../core-bridge.js';
 const SPEC_DIR_RE = /^SPEC-\d+/;
 /** Extract YAML frontmatter content (between first and second ---). */
 function extractFrontmatterAndBody(content) {
@@ -43,18 +43,16 @@ function extractField(frontmatter, field) {
  * Returns an array of ambiguous criteria with context for LLM rewriting.
  */
 export async function scanForAmbiguousCriteria(projectPath) {
-    if (isNativeActive()) {
-        const briefs = fastScanSpecs(projectPath);
-        if (briefs) {
-            return briefs.flatMap((b) => b.ambiguousCriteria.map((a) => ({
-                specId: a.specId,
-                specTitle: a.specTitle,
-                specContext: '', // Native scanner doesn't return full body context yet
-                criterionText: a.criterionText,
-                score: a.score,
-                reason: a.reason,
-            })));
-        }
+    const { value: briefs } = await fastScanSpecsAsync(projectPath);
+    if (briefs) {
+        return briefs.flatMap((b) => b.ambiguousCriteria.map((a) => ({
+            specId: a.specId,
+            specTitle: a.specTitle,
+            specContext: '', // Native scanner doesn't return full body context yet
+            criterionText: a.criterionText,
+            score: a.score,
+            reason: a.reason,
+        })));
     }
     const ambiguous = [];
     const specsDir = join(projectPath, 'planu/specs');

package/dist/engine/spec-migrator/drift-detector.js

@@ -2,7 +2,7 @@
 import { readdir, stat, access, readFile } from 'node:fs/promises';
 import { join } from 'node:path';
 import { isOldFormat } from './lean-migration.js';
-import { isNativeActive, fastScanSpecs } from '../core-bridge.js';
+import { fastScanSpecsAsync } from '../core-bridge.js';
 import { isCanonicalPlanuRootDir, isCanonicalPlanuRootFile, isCanonicalSpecFile, } from './planu-canonical-policy.js';
 async function scanPlanuRoot(projectPath) {
     const rootFiles = [];
@@ -82,22 +82,20 @@ export async function detectDrift(projectPath) {
     const specsDir = join(projectPath, 'planu', 'specs');
     const unifiedSpecs = [];
     const leanSpecs = [];
-    if (isNativeActive()) {
-        const briefs = fastScanSpecs(projectPath);
-        if (briefs) {
-            for (const b of briefs) {
-                if (b.needsUnified) {
-                    unifiedSpecs.push(b.id);
-                }
-                if (b.needsLean) {
-                    leanSpecs.push(b.id);
-                }
+    const { value: briefs } = await fastScanSpecsAsync(projectPath);
+    if (briefs) {
+        for (const b of briefs) {
+            if (b.needsUnified) {
+                unifiedSpecs.push(b.id);
+            }
+            if (b.needsLean) {
+                leanSpecs.push(b.id);
             }
         }
     }
     const rootFiles = await scanPlanuRoot(projectPath);
     const specDirEntries = await readdir(specsDir).catch(() => []);
-    if (isNativeActive()) {
+    if (briefs) {
         for (const entry of specDirEntries) {
             const specPath = join(specsDir, entry);
             try {

package/dist/engine/spec-state-syncer.js

@@ -72,7 +72,7 @@ async function processSingleSpec(filePath, dataStatusMap, report) {
  * The caller (tool layer) is responsible for persisting updates to storage.
  */
 export async function detectSpecStateDivergences(projectPath, dataEntries) {
-    const report = { synced: 0, divergences: [], errors: [], rejected: [] };
+    const report = { synced: 0, divergences: [], errors: [], rejected: [], ghosts: [] };
     const updates = [];
     const dataStatusMap = new Map(dataEntries.map((s) => [s.id, s.status]));
     let specFiles;

package/dist/engine/timing/budget.js

@@ -107,7 +107,11 @@ export async function withTotalBudget(operationName, ceilingMs, fn) {
                 timedOut: false,
                 category: 'operation_failed',
                 elapsedMs,
-                warning: `[SPEC-713] Operation "${operationName}" failed after ${String(elapsedMs)}ms (operation_failed)`,
+                // SPEC-1351: keep the thrown error's message — the production bug this
+                // fixed surfaced only as an opaque "operation_failed" with no way to
+                // tell what actually broke — but never leak the raw call stack into
+                // this user-facing warning string.
+                warning: `[SPEC-713] Operation "${operationName}" failed after ${String(elapsedMs)}ms (operation_failed): ${outcome.error.message}`,
             };
         }
         return {

package/dist/engine/vector-store/tfidf.d.ts

@@ -1,4 +1,6 @@
-import type { TFIDFConfig } from '../../types/index.js';
+import type { TFIDFConfig, TFIDFExportedState } from '../../types/index.js';
+/** Bumped when the exported state shape changes; persisted stores rebuild on mismatch. */
+export declare const TFIDF_SCHEMA_VERSION = 1;
 /** Tokenize text: split on whitespace/punctuation, split camelCase, lowercase, remove stop words. */
 export declare function tokenize(text: string, stopWords?: Set<string>): string[];
 /** TF-IDF engine: stateful, maintains vocabulary (IDF) across documents. */
@@ -22,14 +24,16 @@ export declare class TFIDFEngine {
     /** Get document count in corpus. */
     getDocumentCount(): number;
     /** Export state for serialization. */
-    exportState(): {
-        docFreq: [string, number][];
-        docCount: number;
-    };
+    exportState(): TFIDFExportedState;
     /** Import state from serialized form. */
-    importState(state: {
-        docFreq: [string, number][];
-        docCount: number;
-    }): void;
+    importState(state: TFIDFExportedState): void;
+    /**
+     * Remove a document's contribution to the corpus (SPEC-1345: incremental
+     * updates). `tokens` must be the unique token set the document contributed
+     * when it was added via `addDocument` — callers persisting the index keep
+     * this alongside the content hash so a changed document can be decremented
+     * before its new version is added back in.
+     */
+    removeDocument(tokens: string[]): void;
 }
 //# sourceMappingURL=tfidf.d.ts.map

package/dist/engine/vector-store/tfidf.js

@@ -1,6 +1,8 @@
 // engine/vector-store/tfidf.ts — TF-IDF embedding engine.
 // SPEC-075 AC-01: Tokenize, compute TF-IDF, generate dense vectors.
 import { normalizeVector } from './similarity.js';
+/** Bumped when the exported state shape changes; persisted stores rebuild on mismatch. */
+export const TFIDF_SCHEMA_VERSION = 1;
 const DEFAULT_STOP_WORDS = new Set([
     // English
     'the',
@@ -238,6 +240,7 @@ export class TFIDFEngine {
     /** Export state for serialization. */
     exportState() {
         return {
+            schemaVersion: TFIDF_SCHEMA_VERSION,
             docFreq: [...this.docFreq.entries()],
             docCount: this.docCount,
         };
@@ -251,5 +254,28 @@ export class TFIDFEngine {
         this.docCount = state.docCount;
         this.vocabDirty = true;
     }
+    /**
+     * Remove a document's contribution to the corpus (SPEC-1345: incremental
+     * updates). `tokens` must be the unique token set the document contributed
+     * when it was added via `addDocument` — callers persisting the index keep
+     * this alongside the content hash so a changed document can be decremented
+     * before its new version is added back in.
+     */
+    removeDocument(tokens) {
+        for (const term of new Set(tokens)) {
+            const freq = this.docFreq.get(term);
+            if (freq === undefined) {
+                continue;
+            }
+            if (freq <= 1) {
+                this.docFreq.delete(term);
+            }
+            else {
+                this.docFreq.set(term, freq - 1);
+            }
+        }
+        this.docCount = Math.max(0, this.docCount - 1);
+        this.vocabDirty = true;
+    }
 }
 //# sourceMappingURL=tfidf.js.map

package/dist/engine/worker-config-loader.d.ts

@@ -36,7 +36,7 @@ export declare class WorkerConfigLoader {
      *
      * Slug-to-env: 'test-gaps' → 'TEST_GAPS'
      * Full pattern: PLANU_WORKER_{WORKER_ENV}_{SETTING}
-     * Known settings: ENABLED (bool), COOLDOWNMS (number), PRIORITY (number), TIER (string)
+     * Known settings: ENABLED (bool), COOLDOWNMS (number), PRIORITY (number)
      */
     parseEnvOverride(workerName: string): WorkerOverride;
     /**