@planu/cli 4.13.0 → 4.14.1

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

@@ -18,9 +18,16 @@ alwaysApply: true
 \`\`\`
 facilitate("what to build") → create_spec → challenge_spec → check_readiness
 → update_status(review) → approve → update_status(approved) → implement
-→ validate → update_status(done)
+→ validate (ack) → watch_job (completed) → inspect job.result → update_status(done)
 \`\`\`
 
+## Durable Validation Gate
+
+1. Call \`validate\` and capture \`operationId\`, \`projectId\`, \`workspaceId\`, and \`cursor\`
+2. Call \`watch_job\` with the latest cursor until terminal
+3. Require \`completed\` and inspect \`job.result.structuredContent\`; stop on \`failed\`, \`dead-letter\`, or \`cancelled\`
+4. Mark done only when the completed result reports \`ready: true\`, \`status: "passing"\`, and passing quality gates
+
 ## Session Start
 
 1. Call \`planu_status\` to see active specs
@@ -47,7 +54,7 @@ Planu enforces Spec Driven Development — spec first, then implement, then vali
 
 - Starting a new feature: use \`facilitate()\` or \`create_spec()\`
 - Resuming work: use \`planu_status\` to see what's in progress
-- Finishing work: use \`validate()\` then \`update_status(done)\`
+- Finishing work: submit \`validate()\`, await \`watch_job()\`, inspect \`job.result.structuredContent\`, then use \`update_status(done)\`
 
 ## Mandatory Workflow
 
@@ -56,13 +63,16 @@ Planu enforces Spec Driven Development — spec first, then implement, then vali
 3. \`check_readiness(specId)\` — verify criteria are complete
 4. \`update_status(specId, "approved")\` — lock the spec
 5. Implement the code
-6. \`validate(specId)\` — verify code matches spec
-7. \`update_status(specId, "done")\` — mark complete
+6. \`validate(specId)\` — submit validation and capture the durable job acknowledgement
+7. \`watch_job(operationId, projectId, workspaceId, cursor)\` — repeat until terminal
+8. Require \`completed\` and inspect \`job.result.structuredContent\`
+9. \`update_status(specId, "done")\` — mark complete only after a completed passing result
 
 ## Rules
 
 - NEVER write production code before spec is \`approved\`
 - NEVER skip \`validate\` after implementation
+- NEVER treat the \`validate\` acknowledgement as validation success
 - 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

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

@@ -18,7 +18,14 @@ Auto-generated by \`init_project\`. Do not edit manually.
 | implementing | work in progress |
 | done | implemented + validated |
 
-Flow: \`facilitate → create_spec → challenge_spec → check_readiness → approve → implement → validate → done\`
+Flow: \`facilitate → create_spec → challenge_spec → check_readiness → approve → implement → validate (ack) → watch_job (completed) → inspect job.result → done\`
+
+## Durable Validation Gate
+
+1. Call \`validate\` and capture \`operationId\`, \`projectId\`, \`workspaceId\`, and \`cursor\` from the acknowledgement.
+2. Call \`watch_job\` with those identifiers and the latest cursor. Repeat while state is non-terminal.
+3. Require state \`completed\`, then inspect \`job.result.structuredContent\`. Stop and report \`failed\`, \`dead-letter\`, or \`cancelled\`.
+4. Call \`update_status(done)\` only after the completed result reports \`ready: true\`, \`status: "passing"\`, and passing quality gates.
 
 ## Evidence Gates
 
@@ -45,7 +52,7 @@ Any new feature, bug fix, refactor, integration, or task > 5 min.
 ## Session End
 
 - \`session_checkpoint\` — persist context for the next session
-- \`update_status(done)\` — if work is complete
+- \`update_status(done)\` — only after a completed passing validation job
 
 ## Quick Reference
 
@@ -63,6 +70,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 treat the initial \`validate\` acknowledgement as a passing result
 - NEVER create design docs outside \`planu/specs/\`
 - NEVER recreate legacy \`technical.md\`, \`progress.md\`, or \`HU.md\` files for new specs
 

package/dist/tools/init-project/scaffold-writer.d.ts

@@ -62,5 +62,5 @@ export interface ScaffoldWriteResult {
  * - ESLint/Prettier config
  * - Architecture rules
  */
-export declare function runScaffoldWriter(projectPath: string, projectId: string, knowledge: ProjectKnowledge, recommendedSkills: RecommendedSkill[], permissionsMode?: PermissionsMode, pluginsMode?: PluginInstallMode): Promise<ScaffoldWriteResult>;
+export declare function runScaffoldWriter(projectPath: string, projectId: string, knowledge: ProjectKnowledge, recommendedSkills: RecommendedSkill[], permissionsMode?: PermissionsMode, pluginsMode?: PluginInstallMode, installSkills?: boolean): Promise<ScaffoldWriteResult>;
 //# sourceMappingURL=scaffold-writer.d.ts.map

package/dist/tools/init-project/scaffold-writer.js

@@ -28,7 +28,7 @@ import { generateWorkflowSkills } from '../../engine/skill-generator/workflow-sk
  * - Architecture rules
  */
 // eslint-disable-next-line complexity
-export async function runScaffoldWriter(projectPath, projectId, knowledge, recommendedSkills, permissionsMode, pluginsMode) {
+export async function runScaffoldWriter(projectPath, projectId, knowledge, recommendedSkills, permissionsMode, pluginsMode, installSkills = true) {
     // Generate and write AI rules files
     const rulesResult = await runRulesWriter(projectPath, projectId, knowledge, recommendedSkills);
     // Git setup: hooks, flow detection, .gitignore (SPEC-001)
@@ -51,7 +51,7 @@ export async function runScaffoldWriter(projectPath, projectId, knowledge, recom
     let opencodeConfigScaffolded = false;
     try {
         const { installInitHostAssets } = await import('./host-assets-writer.js');
-        const hostAssets = await installInitHostAssets(projectPath, knowledge);
+        const hostAssets = await installInitHostAssets(projectPath, knowledge, installSkills);
         detectedAssetHosts = hostAssets.detectedHosts;
         hostRulesWritten = hostAssets.rulesInstalled.length;
         hostSkillsWritten = hostAssets.skillsInstalled.length;
@@ -152,7 +152,7 @@ export async function runScaffoldWriter(projectPath, projectId, knowledge, recom
     }
     // SPEC-519: Write .claude/skills/compact.md if missing (best-effort)
     let compactSkillWritten = false;
-    if (shouldWriteClaudeAssets) {
+    if (shouldWriteClaudeAssets && installSkills) {
         try {
             compactSkillWritten = await generateCompactSkillIfMissing(projectPath);
         }
@@ -161,7 +161,7 @@ export async function runScaffoldWriter(projectPath, projectId, knowledge, recom
         }
     }
     // SPEC-655: Write .claude/skills/find-skills.md if missing (best-effort, idempotent)
-    if (shouldWriteClaudeAssets) {
+    if (shouldWriteClaudeAssets && installSkills) {
         try {
             await generateFindSkillsIfMissing(projectPath);
         }
@@ -193,12 +193,14 @@ export async function runScaffoldWriter(projectPath, projectId, knowledge, recom
         /* best-effort */
     }
     // SPEC-648: Generate per-client files (Cursor MDC, Codex skill) based on detected client
-    try {
-        const { generatePerClientFiles } = await import('./per-client-files-writer.js');
-        await generatePerClientFiles(projectPath);
-    }
-    catch {
-        /* best-effort */
+    if (installSkills) {
+        try {
+            const { generatePerClientFiles } = await import('./per-client-files-writer.js');
+            await generatePerClientFiles(projectPath);
+        }
+        catch {
+            /* best-effort */
+        }
     }
     // SPEC-530: Generate .claude/rules/conventions.md (best-effort, idempotent)
     let conventionsMdWritten = false;
@@ -225,7 +227,7 @@ export async function runScaffoldWriter(projectPath, projectId, knowledge, recom
     }
     // SPEC-593: Write .claude/skills/planu-multi-teammate-review.md if missing (best-effort, idempotent)
     let multiTeammateReviewSkillWritten = false;
-    if (shouldWriteClaudeAssets) {
+    if (shouldWriteClaudeAssets && installSkills) {
         try {
             multiTeammateReviewSkillWritten =
                 await generateMultiTeammateReviewSkillIfMissing(projectPath);
@@ -253,7 +255,7 @@ export async function runScaffoldWriter(projectPath, projectId, knowledge, recom
     // (idempotent — skips files already up-to-date; best-effort, no-op elsewhere)
     let planuSubagentsScaffolded = false;
     let planuUxSkillsScaffolded = 0;
-    if (shouldWriteClaudeAssets) {
+    if (shouldWriteClaudeAssets && installSkills) {
         try {
             const { scaffoldPlanuSubagents, scaffoldPlanuSkills } = await import('../../hosts/claude-code/ux/index.js');
             const [subagentResult, skillResult] = await Promise.all([
@@ -302,11 +304,11 @@ export async function runScaffoldWriter(projectPath, projectId, knowledge, recom
             /* best-effort — never fail init_project due to missing claude CLI */
         }
     }
-    // SPEC-680: Create .planu/skill-registry.json if it does not exist (idempotent, best-effort)
+    // SPEC-680: Create planu/skill-registry.json if it does not exist (idempotent, best-effort)
     try {
         const { readFile: readFileFn } = await import('node:fs/promises');
         const { join: joinFn } = await import('node:path');
-        const registryFilePath = joinFn(projectPath, '.planu', 'skill-registry.json');
+        const registryFilePath = joinFn(projectPath, 'planu', 'skill-registry.json');
         const existing = await readFileFn(registryFilePath, 'utf-8').catch(() => null);
         if (existing === null) {
             const now = new Date().toISOString();
@@ -324,7 +326,7 @@ export async function runScaffoldWriter(projectPath, projectId, knowledge, recom
     }
     // SPEC-685: Generate all 22 workflow skill files (idempotent, best-effort)
     let workflowSkillsWritten = 0;
-    if (shouldWriteClaudeAssets) {
+    if (shouldWriteClaudeAssets && installSkills) {
         try {
             const skillResult = await generateWorkflowSkills(projectPath, knowledge);
             workflowSkillsWritten = skillResult.written.length;

package/dist/tools/jobs/handlers.d.ts

@@ -0,0 +1,15 @@
+import type { ToolResult } from '../../types/index.js';
+export interface JobToolIdentityInput {
+    operationId: string;
+    projectId: string;
+    workspaceId?: string;
+}
+export interface WatchJobToolInput extends JobToolIdentityInput {
+    afterCursor?: string;
+    timeoutMs?: number;
+}
+export declare function handleGetJob(input: JobToolIdentityInput): Promise<ToolResult>;
+export declare function handleWatchJob(input: WatchJobToolInput): Promise<ToolResult>;
+export declare function handleCancelJob(input: JobToolIdentityInput): Promise<ToolResult>;
+export declare function handleRestartJob(input: JobToolIdentityInput): Promise<ToolResult>;
+//# sourceMappingURL=handlers.d.ts.map

package/dist/tools/jobs/handlers.js

@@ -0,0 +1,126 @@
+var __addDisposableResource = (this && this.__addDisposableResource) || function (env, value, async) {
+    if (value !== null && value !== void 0) {
+        if (typeof value !== "object" && typeof value !== "function") throw new TypeError("Object expected.");
+        var dispose, inner;
+        if (async) {
+            if (!Symbol.asyncDispose) throw new TypeError("Symbol.asyncDispose is not defined.");
+            dispose = value[Symbol.asyncDispose];
+        }
+        if (dispose === void 0) {
+            if (!Symbol.dispose) throw new TypeError("Symbol.dispose is not defined.");
+            dispose = value[Symbol.dispose];
+            if (async) inner = dispose;
+        }
+        if (typeof dispose !== "function") throw new TypeError("Object not disposable.");
+        if (inner) dispose = function() { try { inner.call(this); } catch (e) { return Promise.reject(e); } };
+        env.stack.push({ value: value, dispose: dispose, async: async });
+    }
+    else if (async) {
+        env.stack.push({ async: true });
+    }
+    return value;
+};
+var __disposeResources = (this && this.__disposeResources) || (function (SuppressedError) {
+    return function (env) {
+        function fail(e) {
+            env.error = env.hasError ? new SuppressedError(e, env.error, "An error was suppressed during disposal.") : e;
+            env.hasError = true;
+        }
+        var r, s = 0;
+        function next() {
+            while (r = env.stack.pop()) {
+                try {
+                    if (!r.async && s === 1) return s = 0, env.stack.push(r), Promise.resolve().then(next);
+                    if (r.dispose) {
+                        var result = r.dispose.call(r.value);
+                        if (r.async) return s |= 2, Promise.resolve(result).then(next, function(e) { fail(e); return next(); });
+                    }
+                    else s |= 1;
+                }
+                catch (e) {
+                    fail(e);
+                }
+            }
+            if (s === 1) return env.hasError ? Promise.reject(env.error) : Promise.resolve();
+            if (env.hasError) throw env.error;
+        }
+        return next();
+    };
+})(typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+});
+import { durableJobCursor, DurableJobRuntime } from '../../engine/execution/job-runtime.js';
+import { scheduleValidateJobExecution } from '../../engine/execution/validate-job-executor.js';
+function result(payload) {
+    return {
+        content: [{ type: 'text', text: JSON.stringify(payload, null, 2) }],
+        structuredContent: payload,
+    };
+}
+export function handleGetJob(input) {
+    const env_1 = { stack: [], error: void 0, hasError: false };
+    try {
+        const runtime = __addDisposableResource(env_1, new DurableJobRuntime(), false);
+        const job = runtime.get(input);
+        return Promise.resolve(result({ schemaVersion: 1, job, cursor: durableJobCursor(job) }));
+    }
+    catch (e_1) {
+        env_1.error = e_1;
+        env_1.hasError = true;
+    }
+    finally {
+        __disposeResources(env_1);
+    }
+}
+export async function handleWatchJob(input) {
+    const env_2 = { stack: [], error: void 0, hasError: false };
+    try {
+        const runtime = __addDisposableResource(env_2, new DurableJobRuntime(), false);
+        const job = await runtime.watch(input);
+        return result({ schemaVersion: 1, job, cursor: durableJobCursor(job) });
+    }
+    catch (e_2) {
+        env_2.error = e_2;
+        env_2.hasError = true;
+    }
+    finally {
+        __disposeResources(env_2);
+    }
+}
+export function handleCancelJob(input) {
+    const env_3 = { stack: [], error: void 0, hasError: false };
+    try {
+        const runtime = __addDisposableResource(env_3, new DurableJobRuntime(), false);
+        const job = runtime.cancel(input);
+        return Promise.resolve(result({ schemaVersion: 1, job, cursor: durableJobCursor(job) }));
+    }
+    catch (e_3) {
+        env_3.error = e_3;
+        env_3.hasError = true;
+    }
+    finally {
+        __disposeResources(env_3);
+    }
+}
+export function handleRestartJob(input) {
+    const env_4 = { stack: [], error: void 0, hasError: false };
+    try {
+        const runtime = __addDisposableResource(env_4, new DurableJobRuntime(), false);
+        const job = runtime.restart(input);
+        if (job.payload &&
+            typeof job.payload === 'object' &&
+            job.payload.kind === 'validate') {
+            scheduleValidateJobExecution(job.projectId, job.workspaceId);
+        }
+        return Promise.resolve(result({ schemaVersion: 1, job, cursor: durableJobCursor(job) }));
+    }
+    catch (e_4) {
+        env_4.error = e_4;
+        env_4.hasError = true;
+    }
+    finally {
+        __disposeResources(env_4);
+    }
+}
+//# sourceMappingURL=handlers.js.map

package/dist/tools/list-specs.js

@@ -67,7 +67,7 @@ export async function handleListSpecs(params) {
         const projectId = resolved.projectId;
         const collector = new AutopilotSummaryCollector();
         // SPEC-756: lazy version check — fire-and-forget, non-blocking
-        if (params.projectPath) {
+        if (detail === 'full' && params.projectPath) {
             checkBundledVersionGap(2000)
                 .then(() => undefined)
                 .catch(() => {
@@ -96,12 +96,12 @@ export async function handleListSpecs(params) {
             }
             // ─── Native optimized scan (SPEC-1004) ──────────────────────────────────
             let nativeBriefs = null;
-            if (isNativeActive() && knowledge.projectPath) {
+            if (detail === 'full' && isNativeActive() && knowledge.projectPath) {
                 nativeBriefs = fastScanSpecs(knowledge.projectPath);
             }
             // Read-only project signals only. Mutating discovery/migration/repair belongs
             // to init, validate, housekeeping, or explicit migration tools.
-            if (knowledge.projectPath) {
+            if (detail === 'full' && knowledge.projectPath) {
                 await collectReadOnlyProjectSignals(projectId, knowledge.projectPath, collector);
             }
             // Get all specs
@@ -233,7 +233,7 @@ export async function handleListSpecs(params) {
             const humanSummary = buildListSpecsSummary(allSpecs.length, statusCounts);
             // SPEC-467: Detect branches and include info for LLM branch-awareness
             let branchInfo = null;
-            if (knowledge.projectPath) {
+            if (detail === 'full' && knowledge.projectPath) {
                 try {
                     const { detectBranches } = await import('../engine/git/branch-detector.js');
                     branchInfo = detectBranches(knowledge.projectPath);
@@ -244,7 +244,7 @@ export async function handleListSpecs(params) {
             }
             // SPEC-487: Scan for ambiguous criteria — ask-then-act via InteractiveQuestion
             let migrationIssues = null;
-            if (knowledge.projectPath) {
+            if (detail === 'full' && knowledge.projectPath) {
                 try {
                     const ambiguous = await scanForAmbiguousCriteria(knowledge.projectPath);
                     if (ambiguous.length > 0) {
@@ -276,7 +276,7 @@ export async function handleListSpecs(params) {
                 : null;
             // SPEC-1012: Detect specs released but still in non-terminal status (best-effort, non-blocking)
             let staleStatusWarnings = [];
-            if (knowledge.projectPath) {
+            if (detail === 'full' && knowledge.projectPath) {
                 try {
                     const { detectReleaseStatusDrift } = await import('../engine/drift-detection/release-status-drift.js');
                     staleStatusWarnings = await detectReleaseStatusDrift(knowledge.projectPath);
@@ -285,6 +285,34 @@ export async function handleListSpecs(params) {
                     /* best-effort — never block list_specs */
                 }
             }
+            const structuredContent = {
+                projectId,
+                filters: {
+                    status: status ?? 'all',
+                    type: type ?? 'all',
+                },
+                count: specs.length,
+                totalCount: allSpecs.length,
+                specs: structuredSpecs,
+                summary: {
+                    byStatus: statusCounts,
+                    byType: typeCounts,
+                    totalDevHours: Math.round(totalDevHours * 10) / 10,
+                    totalReviewHours: Math.round(totalReviewHours * 10) / 10,
+                    totalCostUsd: Math.round(totalCostUsd * 100) / 100,
+                },
+                teamSuggestion: teamSuggestion ?? null,
+                message: ti('tools.list_specs.success', { count: String(specs.length) }),
+                teamDistributionHint: approvedSpecs.length >= 3
+                    ? `${String(approvedSpecs.length)} specs approved — run plan_team_distribution for parallel assignment`
+                    : undefined,
+                humanSummary,
+                branchInfo: branchInfo && branchInfo.count > 1 ? branchInfo : undefined,
+                autopilotSummary: collector.hasEntries() ? collector.getMessages() : undefined,
+                migrationIssues: migrationIssues ?? undefined,
+                interactiveQuestions: interactiveQuestions ?? undefined,
+                staleStatusWarnings: staleStatusWarnings.length > 0 ? staleStatusWarnings : undefined,
+            };
             return {
                 content: [
                     { type: 'text', text: textContent },
@@ -298,34 +326,7 @@ export async function handleListSpecs(params) {
                         ]
                         : []),
                 ],
-                structuredContent: {
-                    projectId,
-                    filters: {
-                        status: status ?? 'all',
-                        type: type ?? 'all',
-                    },
-                    count: specs.length,
-                    totalCount: allSpecs.length,
-                    specs: specsData,
-                    summary: {
-                        byStatus: statusCounts,
-                        byType: typeCounts,
-                        totalDevHours: Math.round(totalDevHours * 10) / 10,
-                        totalReviewHours: Math.round(totalReviewHours * 10) / 10,
-                        totalCostUsd: Math.round(totalCostUsd * 100) / 100,
-                    },
-                    teamSuggestion: teamSuggestion ?? null,
-                    message: ti('tools.list_specs.success', { count: String(specs.length) }),
-                    teamDistributionHint: approvedSpecs.length >= 3
-                        ? `${String(approvedSpecs.length)} specs approved — run plan_team_distribution for parallel assignment`
-                        : undefined,
-                    humanSummary,
-                    branchInfo: branchInfo && branchInfo.count > 1 ? branchInfo : undefined,
-                    autopilotSummary: collector.hasEntries() ? collector.getMessages() : undefined,
-                    migrationIssues: migrationIssues ?? undefined,
-                    interactiveQuestions: interactiveQuestions ?? undefined,
-                    staleStatusWarnings: staleStatusWarnings.length > 0 ? staleStatusWarnings : undefined,
-                },
+                structuredContent,
             };
         }
         catch (error) {

package/dist/tools/manage-plugins-handler.js

@@ -1,8 +1,10 @@
 // tools/manage-plugins-handler.ts — Handler for manage_plugins tool (SPEC-085 AC-09, SPEC-603, SPEC-604)
+import { dirname } from 'node:path';
 import { t, ti } from '../i18n/index.js';
 import { searchPlugins } from '../engine/plugin-installer/plugin-catalog.js';
 import { cleanupPluginArtifacts } from '../engine/plugin-installer/artifact-scanner.js';
 import { discoverPlugins, installPlugin, activatePlugin, deactivatePlugin, uninstallPlugin, readPluginState, loadPluginModule, generatePluginDocs, getPluginToolCount, getPluginWorkerCount, getPluginAnalyzerCount, getPluginTemplateCount, } from '../engine/plugins/index.js';
+import { storageCatalogById } from '../storage/storage-catalog.js';
 function text(content) {
     return { content: [{ type: 'text', text: content }] };
 }
@@ -10,11 +12,17 @@ function resolveProjectPath(input) {
     /* v8 ignore next -- process.cwd() fallback never reached when projectPath is always provided */
     return input.projectPath ?? process.cwd();
 }
-const DATA_DIR = 'data';
+function pluginStateDataRoot() {
+    const statePath = storageCatalogById('plugin-state').resolvedPath;
+    if (statePath === undefined) {
+        throw new Error('[Planu] Plugin state catalog entry has no resolved path');
+    }
+    return dirname(dirname(statePath));
+}
 async function handleList(input) {
     const projectPath = resolveProjectPath(input);
     const plugins = await discoverPlugins(projectPath);
-    const state = await readPluginState(DATA_DIR);
+    const state = await readPluginState(pluginStateDataRoot());
     const items = plugins.map((p) => {
         const persisted = state.plugins.find((s) => s.manifest.id === p.manifest.id);
         const currentState = persisted?.state ?? p.state;
@@ -42,7 +50,7 @@ async function handleInstall(input) {
         };
     }
     const projectPath = resolveProjectPath(input);
-    const reg = await installPlugin(input.pluginPath, projectPath, DATA_DIR);
+    const reg = await installPlugin(input.pluginPath, projectPath, pluginStateDataRoot());
     return text(ti('tools.manage_plugins.installSuccess', {
         name: reg.manifest.name,
         id: reg.manifest.id,
@@ -60,7 +68,7 @@ async function handleActivate(input) {
     }
     const projectPath = resolveProjectPath(input);
     const builtInTools = new Set(); // Would be populated from server
-    const reg = await activatePlugin(input.pluginId, projectPath, DATA_DIR, builtInTools);
+    const reg = await activatePlugin(input.pluginId, projectPath, pluginStateDataRoot(), builtInTools);
     if (reg.state === 'error') {
         return {
             content: [
@@ -86,7 +94,7 @@ async function handleDeactivate(input) {
             isError: true,
         };
     }
-    const reg = await deactivatePlugin(input.pluginId, DATA_DIR);
+    const reg = await deactivatePlugin(input.pluginId, pluginStateDataRoot());
     return text(ti('tools.manage_plugins.deactivateSuccess', { name: reg.manifest.name }));
 }
 async function handleUninstall(input) {
@@ -102,7 +110,7 @@ async function handleUninstall(input) {
         };
     }
     const projectPath = resolveProjectPath(input);
-    await uninstallPlugin(input.pluginId, projectPath, DATA_DIR);
+    await uninstallPlugin(input.pluginId, projectPath, pluginStateDataRoot());
     // SPEC-604: cleanup plugin artifacts from .claude/rules/, .claude/skills/, .claude/hooks/
     const cleaned = await cleanupPluginArtifacts(input.pluginId, projectPath);
     const baseMsg = ti('tools.manage_plugins.uninstallSuccess', { id: input.pluginId });
@@ -120,7 +128,7 @@ async function handleInfo(input) {
             isError: true,
         };
     }
-    const state = await readPluginState(DATA_DIR);
+    const state = await readPluginState(pluginStateDataRoot());
     const reg = state.plugins.find((p) => p.manifest.id === input.pluginId);
     if (!reg) {
         return {
@@ -176,9 +184,9 @@ async function handleUpdate(input) {
     }
     const projectPath = resolveProjectPath(input);
     // Update strategy: uninstall (with artifact cleanup) then reinstall
-    await uninstallPlugin(input.pluginId, projectPath, DATA_DIR);
+    await uninstallPlugin(input.pluginId, projectPath, pluginStateDataRoot());
     await cleanupPluginArtifacts(input.pluginId, projectPath);
-    const reg = await installPlugin(input.pluginPath, projectPath, DATA_DIR);
+    const reg = await installPlugin(input.pluginPath, projectPath, pluginStateDataRoot());
     return text(`Plugin "${reg.manifest.name}" updated successfully to version ${reg.manifest.version}.`);
 }
 /**

package/dist/tools/migrate-tech/advanced-handlers.js

@@ -2,6 +2,7 @@
 //   feature-flags | status
 import { t } from '../../i18n/index.js';
 import { scoreMigratableComponents, generateMigrationPlan, generateRollbackPlan, createMigrationCheckpoint, buildRollbackExecutionPlan, generateFeatureFlagSpec, buildMigrationStatusReport, } from '../../engine/migration/index.js';
+import { projectDataDir } from '../../storage/base-store.js';
 export function handleRollbackPlan(args) {
     const components = scoreMigratableComponents([
         {
@@ -56,7 +57,7 @@ export function handleRollbackPlan(args) {
         data,
         message: t('tools.migrate_tech.rollbackPlanSuccess'),
         warnings,
-        savedTo: args.projectId ? `data/projects/${args.projectId}/rollback-plan.json` : undefined,
+        savedTo: args.projectId ? `${projectDataDir(args.projectId)}/rollback-plan.json` : undefined,
     };
 }
 export function handleCheckpoint(args) {
@@ -73,7 +74,7 @@ export function handleCheckpoint(args) {
         message: t('tools.migrate_tech.checkpointSuccess'),
         warnings: [],
         savedTo: args.projectId
-            ? `data/projects/${args.projectId}/migration-checkpoints.json`
+            ? `${projectDataDir(args.projectId)}/migration-checkpoints.json`
             : undefined,
     };
 }

package/dist/tools/migrate-tech/build-tool-handlers.js

@@ -3,6 +3,7 @@
 // C10: webpack-to-vite → structured migration plan from catalog
 // C11: vite6-to-vite7 → structured migration plan from catalog
 import { readFile } from 'node:fs/promises';
+import { projectDataDir } from '../../storage/base-store.js';
 // ---------------------------------------------------------------------------
 // Cache
 // ---------------------------------------------------------------------------
@@ -60,7 +61,7 @@ export async function handleWebpackToVite(args) {
         message: `Webpack to Vite migration plan generated — ${migration.phases.length} phases, ${migration.postMigrationChecklist.length} post-migration checks.`,
         warnings,
         savedTo: args.projectId
-            ? `data/projects/${args.projectId}/webpack-to-vite-plan.json`
+            ? `${projectDataDir(args.projectId)}/webpack-to-vite-plan.json`
             : undefined,
     };
 }
@@ -85,7 +86,7 @@ export async function handleVite6ToVite7(args) {
         message: `Vite 6 → Vite 7 migration plan generated — ${migration.breakingChanges.length} breaking changes documented.`,
         warnings,
         savedTo: args.projectId
-            ? `data/projects/${args.projectId}/vite6-to-vite7-plan.json`
+            ? `${projectDataDir(args.projectId)}/vite6-to-vite7-plan.json`
             : undefined,
     };
 }

package/dist/tools/migrate-tech/core-handlers.js

@@ -1,6 +1,7 @@
 // tools/migrate-tech/core-handlers.ts — Handlers: analyze | map | plan | strategy | validate
 import { t } from '../../i18n/index.js';
 import { buildStackAnalysis, buildEquivalenceMap, generateMigrationPlan, recommendMigrationStrategy, generateParityValidation, } from '../../engine/migration/index.js';
+import { projectDataDir } from '../../storage/base-store.js';
 export function handleAnalyze(args) {
     const data = buildStackAnalysis({
         language: args.sourceStack ?? 'unknown',
@@ -20,7 +21,9 @@ export function handleAnalyze(args) {
         data,
         message: t('tools.migrate_tech.analyzeSuccess'),
         warnings,
-        savedTo: args.projectId ? `data/projects/${args.projectId}/migration-analysis.json` : undefined,
+        savedTo: args.projectId
+            ? `${projectDataDir(args.projectId)}/migration-analysis.json`
+            : undefined,
     };
 }
 export function handleMap(args) {
@@ -35,7 +38,7 @@ export function handleMap(args) {
         data,
         message: t('tools.migrate_tech.mapSuccess'),
         warnings,
-        savedTo: args.projectId ? `data/projects/${args.projectId}/migration-map.json` : undefined,
+        savedTo: args.projectId ? `${projectDataDir(args.projectId)}/migration-map.json` : undefined,
     };
 }
 export function handlePlan(args) {

package/dist/tools/migrate-tech/data-handlers.js

@@ -2,6 +2,7 @@
 //   analyze-services | map-services | plan-services | validate-service
 import { t } from '../../i18n/index.js';
 import { analyzeDbSchema, buildDbMigrationMap, buildDbMigrationPlan, analyzeExternalServices, buildServiceEquivalenceMap, planServicesMigration, generateServiceValidationChecklist, } from '../../engine/migration/index.js';
+import { projectDataDir } from '../../storage/base-store.js';
 export function handleAnalyzeDb(args) {
     const data = analyzeDbSchema({
         engine: args.sourceDbEngine ?? 'postgresql',
@@ -33,7 +34,7 @@ export function handleMapDb(args) {
         data,
         message: t('tools.migrate_tech.mapDbSuccess'),
         warnings,
-        savedTo: args.projectId ? `data/projects/${args.projectId}/db-migration-map.json` : undefined,
+        savedTo: args.projectId ? `${projectDataDir(args.projectId)}/db-migration-map.json` : undefined,
     };
 }
 export function handlePlanDb(args) {
@@ -75,7 +76,9 @@ export function handleAnalyzeServices(args) {
         data,
         message: t('tools.migrate_tech.analyzeServicesSuccess'),
         warnings,
-        savedTo: args.projectId ? `data/projects/${args.projectId}/services-analysis.json` : undefined,
+        savedTo: args.projectId
+            ? `${projectDataDir(args.projectId)}/services-analysis.json`
+            : undefined,
     };
 }
 export function handleMapServices(args) {
@@ -93,7 +96,7 @@ export function handleMapServices(args) {
         data,
         message: t('tools.migrate_tech.mapServicesSuccess'),
         warnings,
-        savedTo: args.projectId ? `data/projects/${args.projectId}/services-map.json` : undefined,
+        savedTo: args.projectId ? `${projectDataDir(args.projectId)}/services-map.json` : undefined,
     };
 }
 export function handlePlanServices(args) {