@alecsibilia/luca 13.0.0-alpha.2 → 13.0.0-alpha.3

package/dist/chunks/branch.mjs

@@ -1,6 +1,6 @@
 import { defineCommand } from 'citty';
 import 'zod';
-import '../shared/luca.CRmaAfXR.mjs';
+import '../shared/luca.DXUcpbIe.mjs';
 import 'node:fs';
 import 'node:fs/promises';
 import 'node:path';
@@ -8,13 +8,13 @@ import 'node:crypto';
 import 'node:module';
 import 'node:url';
 import 'node:child_process';
-import { r as runWriteHandler, q as lucaBranchGuardTool } from '../shared/luca.DjDTeDCi.mjs';
+import { r as runWriteHandler, t as lucaBranchGuardTool } from '../shared/luca.DykMxS_D.mjs';
 import 'node:os';
-import '../shared/luca.CrXzXueR.mjs';
-import '../shared/luca.HZxBTBgD.mjs';
-import '../shared/luca.TSMg1t7I.mjs';
+import '../shared/luca.BH2GZl5z.mjs';
+import '../shared/luca.CuvqWf4b.mjs';
+import '../shared/luca.pqZahLS5.mjs';
 import '../shared/luca.CQ3g1xrD.mjs';
-import '../shared/luca.B3Mimc0P.mjs';
+import '../shared/luca.Djs7oPPj.mjs';
 
 const guardCommand = defineCommand({
   meta: {

package/dist/chunks/checks.mjs

@@ -1,6 +1,6 @@
 import { defineCommand } from 'citty';
 import 'zod';
-import '../shared/luca.CRmaAfXR.mjs';
+import '../shared/luca.DXUcpbIe.mjs';
 import 'node:fs';
 import 'node:fs/promises';
 import 'node:path';
@@ -8,13 +8,13 @@ import 'node:crypto';
 import 'node:module';
 import 'node:url';
 import 'node:child_process';
-import { c as readJsonPayload, r as runWriteHandler, p as lucaChecksRunTool } from '../shared/luca.DjDTeDCi.mjs';
+import { e as readJsonPayload, r as runWriteHandler, s as lucaChecksRunTool } from '../shared/luca.DykMxS_D.mjs';
 import 'node:os';
-import '../shared/luca.CrXzXueR.mjs';
-import '../shared/luca.HZxBTBgD.mjs';
-import '../shared/luca.TSMg1t7I.mjs';
+import '../shared/luca.BH2GZl5z.mjs';
+import '../shared/luca.CuvqWf4b.mjs';
+import '../shared/luca.pqZahLS5.mjs';
 import '../shared/luca.CQ3g1xrD.mjs';
-import '../shared/luca.B3Mimc0P.mjs';
+import '../shared/luca.Djs7oPPj.mjs';
 
 const runCommand = defineCommand({
   meta: {

package/dist/chunks/claim-verify.mjs

@@ -1,6 +1,6 @@
 import { defineCommand } from 'citty';
 import { resolve } from 'pathe';
-import '../shared/luca.CRmaAfXR.mjs';
+import '../shared/luca.DXUcpbIe.mjs';
 import { readFileSync, existsSync, readdirSync, statSync } from 'node:fs';
 import 'node:fs/promises';
 import { join } from 'node:path';

package/dist/chunks/classify.mjs

@@ -1,5 +1,5 @@
 import { defineCommand } from 'citty';
-import { C as ClassifyComplexityInputSchema } from '../shared/luca.CRmaAfXR.mjs';
+import { C as ClassifyComplexityInputSchema } from '../shared/luca.DXUcpbIe.mjs';
 import 'node:fs';
 import 'node:fs/promises';
 import 'node:path';

package/dist/chunks/confidence.mjs

@@ -1,6 +1,6 @@
 import { defineCommand } from 'citty';
-import '../shared/luca.CRmaAfXR.mjs';
-import { l as loadCurrentState, r as resolveActiveSlug } from '../shared/luca.CrXzXueR.mjs';
+import '../shared/luca.DXUcpbIe.mjs';
+import { l as loadCurrentState, r as resolveActiveSlug } from '../shared/luca.BH2GZl5z.mjs';
 import 'node:fs';
 import 'node:fs/promises';
 import 'node:path';
@@ -8,15 +8,15 @@ import 'node:crypto';
 import 'node:module';
 import 'node:url';
 import 'node:child_process';
-import { b as renderConfidenceJournalMarkdown, r as readConfidenceJournal, g as getConfidenceSummary } from '../shared/luca.HZxBTBgD.mjs';
+import { b as renderConfidenceJournalMarkdown, r as readConfidenceJournal, g as getConfidenceSummary } from '../shared/luca.CuvqWf4b.mjs';
 import { l as logger } from '../shared/luca.dM-MKlNE.mjs';
 import 'zod';
-import { c as readJsonPayload, r as runWriteHandler, t as lucaConfidenceLogTool } from '../shared/luca.DjDTeDCi.mjs';
+import { e as readJsonPayload, r as runWriteHandler, v as lucaConfidenceLogTool } from '../shared/luca.DykMxS_D.mjs';
 import 'node:os';
-import '../shared/luca.TSMg1t7I.mjs';
+import '../shared/luca.pqZahLS5.mjs';
 import 'consola';
 import '../shared/luca.CQ3g1xrD.mjs';
-import '../shared/luca.B3Mimc0P.mjs';
+import '../shared/luca.Djs7oPPj.mjs';
 
 async function resolveSlug(opts) {
   if (opts.explicit) return opts.explicit;

package/dist/chunks/hook.mjs

@@ -1,11 +1,11 @@
 import { defineCommand } from 'citty';
-import { c as coarsePhaseOf, a as classifyWritePath, A as AUDIT_PATH_PATTERN, W as WAVE_FILE_RE } from '../shared/luca.CRmaAfXR.mjs';
-import { l as loadCurrentState, r as resolveActiveSlug } from '../shared/luca.CrXzXueR.mjs';
+import { c as coarsePhaseOf, a as classifyWritePath, A as AUDIT_PATH_PATTERN, W as WAVE_FILE_RE } from '../shared/luca.DXUcpbIe.mjs';
+import { l as loadCurrentState, r as resolveActiveSlug } from '../shared/luca.BH2GZl5z.mjs';
 import 'node:fs';
 import 'node:fs/promises';
-import 'node:path';
-import { S as STEP_ARTIFACTS } from '../shared/luca.B3Mimc0P.mjs';
-import { p as phasePathFor } from '../shared/luca.TSMg1t7I.mjs';
+import { isAbsolute, relative } from 'node:path';
+import { S as STEP_ARTIFACTS } from '../shared/luca.Djs7oPPj.mjs';
+import { p as phasePathFor } from '../shared/luca.pqZahLS5.mjs';
 import 'node:crypto';
 import 'node:module';
 import 'node:url';
@@ -72,6 +72,13 @@ function isToolAllowed({
 }
 
 const READONLY_COMMANDS = /* @__PURE__ */ new Set([
+  // Shell navigation/no-ops: mutate shell state, not files — benign for
+  // the file/repo-mutation policy this classifier enforces. `cd` is the
+  // big one: agents prefix nearly every command with `cd <dir> && …`, so
+  // omitting it made every compound command classify as a mutate.
+  "cd",
+  "pushd",
+  "popd",
   "ls",
   "cat",
   "grep",
@@ -195,7 +202,7 @@ const LUCA_READ_VERBS = /* @__PURE__ */ new Set([
 ]);
 const LUCA_NOUN_VERBS = {
   state: /* @__PURE__ */ new Set(["read", "advance"]),
-  phase: /* @__PURE__ */ new Set(["current"]),
+  phase: /* @__PURE__ */ new Set(["current", "advance", "archive"]),
   roadmap: /* @__PURE__ */ new Set(["read", "create"]),
   preferences: /* @__PURE__ */ new Set(["read", "write"]),
   todo: /* @__PURE__ */ new Set(["add", "list", "update"]),
@@ -212,7 +219,7 @@ const LUCA_NOUN_VERBS = {
 };
 function classifyLucaCommand(rest) {
   const noun = rest.find((t) => !t.startsWith("-"));
-  if (!noun) return void 0;
+  if (!noun) return "bash-readonly";
   const verbs = LUCA_NOUN_VERBS[noun];
   if (!verbs) return void 0;
   const afterNoun = rest.slice(rest.indexOf(noun) + 1);
@@ -358,6 +365,16 @@ function classifySubcommand(sub) {
       };
     }
   }
+  if (cmd === "sed" || cmd === "awk") {
+    const sedInPlace = cmd === "sed" && rest.some((a) => a === "--in-place" || a.startsWith("-i"));
+    const awkInPlace = cmd === "awk" && rest.some((a, i) => a === "-i" && rest[i + 1] === "inplace");
+    if (!sedInPlace && !awkInPlace) {
+      return {
+        category: sub.redirect ? "bash-mutate" : "bash-readonly",
+        targetPaths: targetsFromRedirect
+      };
+    }
+  }
   if (MUTATE_COMMANDS.has(cmd)) {
     const lastArg = cmd === "cp" || cmd === "mv" || cmd === "ln" ? lastNonFlag(rest) : void 0;
     const sedTarget = cmd === "sed" && rest.includes("-i") ? rest[rest.length - 1] : void 0;
@@ -494,11 +511,12 @@ async function handleStageGateHook(opts) {
       log(`stage-gate: ${toolName} without file_path \u2014 allowing`);
       return { exitCode: 0, toolName, toolInput, decision: "allow" };
     }
-    const pc = classifyWritePath(targetPath, { homedir });
+    const relTarget = isAbsolute(targetPath) ? relative(cwd, targetPath) : targetPath;
+    const pc = classifyWritePath(targetPath, { homedir, cwd });
     if (pc.class === "denied") {
       pathBlockReason = `${toolName} to '${targetPath}' is always denied: ${pc.reason ?? "forbidden path"}`;
     } else if (pc.class === "planning-general" || pc.class === "planning-audit") {
-      const gate = artifactPathGate(targetPath, state.pipelineStep, state);
+      const gate = artifactPathGate(relTarget, state.pipelineStep, state);
       if (gate.kind === "block") {
         const msg = `stage-gate BLOCK: ${toolName} ${gate.reason} (pipelineStep=${state.pipelineStep})`;
         log(msg);

package/dist/chunks/init.mjs

@@ -3,7 +3,7 @@ import { defineCommand, runMain } from 'citty';
 import { existsSync, chmodSync } from 'node:fs';
 import { mkdir, writeFile, readFile, readdir, copyFile } from 'node:fs/promises';
 import { join, dirname, delimiter } from 'node:path';
-import { l as lucaStateSchema } from '../shared/luca.CRmaAfXR.mjs';
+import { l as lucaStateSchema } from '../shared/luca.DXUcpbIe.mjs';
 import 'node:crypto';
 import 'node:module';
 import 'node:url';

package/dist/chunks/phase.mjs

@@ -1,6 +1,6 @@
 import { defineCommand } from 'citty';
 import 'zod';
-import '../shared/luca.CRmaAfXR.mjs';
+import '../shared/luca.DXUcpbIe.mjs';
 import 'node:fs';
 import 'node:fs/promises';
 import 'node:path';
@@ -8,13 +8,13 @@ import 'node:crypto';
 import 'node:module';
 import 'node:url';
 import 'node:child_process';
-import { r as runWriteHandler, b as lucaPhaseCurrentTool } from '../shared/luca.DjDTeDCi.mjs';
+import { r as runWriteHandler, b as lucaPhaseCurrentTool, c as lucaPhaseAdvanceTool, d as lucaPhaseArchiveTool } from '../shared/luca.DykMxS_D.mjs';
 import 'node:os';
-import '../shared/luca.CrXzXueR.mjs';
-import '../shared/luca.HZxBTBgD.mjs';
-import '../shared/luca.TSMg1t7I.mjs';
+import '../shared/luca.BH2GZl5z.mjs';
+import '../shared/luca.CuvqWf4b.mjs';
+import '../shared/luca.pqZahLS5.mjs';
 import '../shared/luca.CQ3g1xrD.mjs';
-import '../shared/luca.B3Mimc0P.mjs';
+import '../shared/luca.Djs7oPPj.mjs';
 
 const currentCommand = defineCommand({
   meta: {
@@ -25,13 +25,33 @@ const currentCommand = defineCommand({
     await runWriteHandler("phase current", lucaPhaseCurrentTool, {});
   }
 });
+const advanceCommand = defineCommand({
+  meta: {
+    name: "advance",
+    description: "Advance the active roadmap phase by one (currentPhase \u2192 currentPhase+1), marking the completed phase done and the next in-progress. Call at the phase boundary (learn step) when more phases remain; the final phase routes to the milestone step."
+  },
+  async run() {
+    await runWriteHandler("phase advance", lucaPhaseAdvanceTool, {});
+  }
+});
+const archiveCommand = defineCommand({
+  meta: {
+    name: "archive",
+    description: "Archive all active phase directories (.luca/phases/<slug>/ \u2192 .luca/archive/<slug>/) at milestone close, so the next milestone starts from an empty phases/ dir. Idempotent; skips slugs already archived. Allowed only in the milestone/complete steps."
+  },
+  async run() {
+    await runWriteHandler("phase archive", lucaPhaseArchiveTool, {});
+  }
+});
 const phaseCommand = defineCommand({
   meta: {
     name: "phase",
-    description: "Inspect the active Luca workflow phase"
+    description: "Inspect, advance, and archive Luca workflow phases"
   },
   subCommands: {
-    current: currentCommand
+    current: currentCommand,
+    advance: advanceCommand,
+    archive: archiveCommand
   }
 });
 

package/dist/chunks/pr-review.mjs

@@ -1,6 +1,6 @@
 import { defineCommand } from 'citty';
 import 'zod';
-import '../shared/luca.CRmaAfXR.mjs';
+import '../shared/luca.DXUcpbIe.mjs';
 import 'node:fs';
 import 'node:fs/promises';
 import 'node:path';
@@ -8,13 +8,13 @@ import 'node:crypto';
 import 'node:module';
 import 'node:url';
 import 'node:child_process';
-import { c as readJsonPayload, r as runWriteHandler, k as lucaPrReviewDetectConvergenceTool, m as lucaPrReviewFilterStaleTool, n as lucaPrReviewRegressionCheckTool } from '../shared/luca.DjDTeDCi.mjs';
+import { e as readJsonPayload, r as runWriteHandler, n as lucaPrReviewDetectConvergenceTool, o as lucaPrReviewFilterStaleTool, p as lucaPrReviewRegressionCheckTool } from '../shared/luca.DykMxS_D.mjs';
 import 'node:os';
-import '../shared/luca.CrXzXueR.mjs';
-import '../shared/luca.HZxBTBgD.mjs';
-import '../shared/luca.TSMg1t7I.mjs';
+import '../shared/luca.BH2GZl5z.mjs';
+import '../shared/luca.CuvqWf4b.mjs';
+import '../shared/luca.pqZahLS5.mjs';
 import '../shared/luca.CQ3g1xrD.mjs';
-import '../shared/luca.B3Mimc0P.mjs';
+import '../shared/luca.Djs7oPPj.mjs';
 
 const filterStaleCommand = defineCommand({
   meta: {

package/dist/chunks/preferences.mjs

@@ -1,6 +1,6 @@
 import { defineCommand } from 'citty';
 import 'zod';
-import '../shared/luca.CRmaAfXR.mjs';
+import '../shared/luca.DXUcpbIe.mjs';
 import 'node:fs';
 import 'node:fs/promises';
 import 'node:path';
@@ -8,13 +8,13 @@ import 'node:crypto';
 import 'node:module';
 import 'node:url';
 import 'node:child_process';
-import { c as readJsonPayload, r as runWriteHandler, f as lucaPreferencesReadTool, g as lucaPreferencesWriteTool } from '../shared/luca.DjDTeDCi.mjs';
+import { e as readJsonPayload, r as runWriteHandler, h as lucaPreferencesReadTool, i as lucaPreferencesWriteTool } from '../shared/luca.DykMxS_D.mjs';
 import 'node:os';
-import '../shared/luca.CrXzXueR.mjs';
-import '../shared/luca.HZxBTBgD.mjs';
-import '../shared/luca.TSMg1t7I.mjs';
+import '../shared/luca.BH2GZl5z.mjs';
+import '../shared/luca.CuvqWf4b.mjs';
+import '../shared/luca.pqZahLS5.mjs';
 import '../shared/luca.CQ3g1xrD.mjs';
-import '../shared/luca.B3Mimc0P.mjs';
+import '../shared/luca.Djs7oPPj.mjs';
 
 const readCommand = defineCommand({
   meta: {

package/dist/chunks/repair.mjs

@@ -2,7 +2,7 @@ import { defineCommand } from 'citty';
 import { existsSync } from 'node:fs';
 import { readFile, rm } from 'node:fs/promises';
 import { join } from 'node:path';
-import { l as lucaStateSchema } from '../shared/luca.CRmaAfXR.mjs';
+import { l as lucaStateSchema } from '../shared/luca.DXUcpbIe.mjs';
 import 'node:crypto';
 import 'node:module';
 import 'node:url';

package/dist/chunks/repo.mjs

@@ -1,6 +1,6 @@
 import { defineCommand } from 'citty';
 import 'zod';
-import '../shared/luca.CRmaAfXR.mjs';
+import '../shared/luca.DXUcpbIe.mjs';
 import 'node:fs';
 import 'node:fs/promises';
 import 'node:path';
@@ -8,13 +8,13 @@ import 'node:crypto';
 import 'node:module';
 import 'node:url';
 import 'node:child_process';
-import { c as readJsonPayload, r as runWriteHandler, o as lucaRepoCleanupApplyTool } from '../shared/luca.DjDTeDCi.mjs';
+import { e as readJsonPayload, r as runWriteHandler, q as lucaRepoCleanupApplyTool } from '../shared/luca.DykMxS_D.mjs';
 import 'node:os';
-import '../shared/luca.CrXzXueR.mjs';
-import '../shared/luca.HZxBTBgD.mjs';
-import '../shared/luca.TSMg1t7I.mjs';
+import '../shared/luca.BH2GZl5z.mjs';
+import '../shared/luca.CuvqWf4b.mjs';
+import '../shared/luca.pqZahLS5.mjs';
 import '../shared/luca.CQ3g1xrD.mjs';
-import '../shared/luca.B3Mimc0P.mjs';
+import '../shared/luca.Djs7oPPj.mjs';
 
 const cleanupApplyCommand = defineCommand({
   meta: {

package/dist/chunks/retro.mjs

@@ -1,5 +1,5 @@
 import { defineCommand } from 'citty';
-import '../shared/luca.CRmaAfXR.mjs';
+import '../shared/luca.DXUcpbIe.mjs';
 import 'node:fs';
 import 'node:fs/promises';
 import 'node:path';
@@ -7,13 +7,13 @@ import 'node:crypto';
 import 'node:module';
 import 'node:url';
 import 'node:child_process';
-import { a as analyzeRun, g as gatherRunArtifacts, r as renderPostmortemMarkdown, c as computePostmortemExitCode } from '../shared/luca.C4gMUoBd.mjs';
-import { l as listRuns } from '../shared/luca.HZxBTBgD.mjs';
+import { a as analyzeRun, g as gatherRunArtifacts, r as renderPostmortemMarkdown, c as computePostmortemExitCode } from '../shared/luca.BhM9TDAo.mjs';
+import { l as listRuns } from '../shared/luca.CuvqWf4b.mjs';
 import { l as logger } from '../shared/luca.dM-MKlNE.mjs';
 import 'zod';
 import 'node:os';
-import '../shared/luca.BmhNkYe2.mjs';
-import '../shared/luca.TSMg1t7I.mjs';
+import '../shared/luca.BQXFn5yo.mjs';
+import '../shared/luca.pqZahLS5.mjs';
 import 'pathe';
 import 'consola';
 

package/dist/chunks/roadmap.mjs

@@ -1,6 +1,6 @@
 import { defineCommand } from 'citty';
 import 'zod';
-import '../shared/luca.CRmaAfXR.mjs';
+import '../shared/luca.DXUcpbIe.mjs';
 import 'node:fs';
 import 'node:fs/promises';
 import 'node:path';
@@ -8,13 +8,13 @@ import 'node:crypto';
 import 'node:module';
 import 'node:url';
 import 'node:child_process';
-import { c as readJsonPayload, r as runWriteHandler, d as lucaRoadmapReadTool, e as lucaRoadmapCreateTool } from '../shared/luca.DjDTeDCi.mjs';
+import { e as readJsonPayload, r as runWriteHandler, f as lucaRoadmapReadTool, g as lucaRoadmapCreateTool } from '../shared/luca.DykMxS_D.mjs';
 import 'node:os';
-import '../shared/luca.CrXzXueR.mjs';
-import '../shared/luca.HZxBTBgD.mjs';
-import '../shared/luca.TSMg1t7I.mjs';
+import '../shared/luca.BH2GZl5z.mjs';
+import '../shared/luca.CuvqWf4b.mjs';
+import '../shared/luca.pqZahLS5.mjs';
 import '../shared/luca.CQ3g1xrD.mjs';
-import '../shared/luca.B3Mimc0P.mjs';
+import '../shared/luca.Djs7oPPj.mjs';
 
 const readCommand = defineCommand({
   meta: {

package/dist/chunks/rules.mjs

@@ -1,6 +1,6 @@
 import { defineCommand } from 'citty';
 import { join as join$1 } from 'pathe';
-import '../shared/luca.CRmaAfXR.mjs';
+import '../shared/luca.DXUcpbIe.mjs';
 import { existsSync, readdirSync, statSync, readFileSync } from 'node:fs';
 import 'node:fs/promises';
 import { isAbsolute, resolve, join, extname } from 'node:path';
@@ -8,13 +8,13 @@ import 'node:crypto';
 import { createRequire } from 'node:module';
 import { pathToFileURL } from 'node:url';
 import 'node:child_process';
-import { a as analyzeRun, g as gatherRunArtifacts } from '../shared/luca.C4gMUoBd.mjs';
-import { l as listRuns } from '../shared/luca.HZxBTBgD.mjs';
+import { a as analyzeRun, g as gatherRunArtifacts } from '../shared/luca.BhM9TDAo.mjs';
+import { l as listRuns } from '../shared/luca.CuvqWf4b.mjs';
 import { l as logger } from '../shared/luca.dM-MKlNE.mjs';
 import 'zod';
 import 'node:os';
-import '../shared/luca.BmhNkYe2.mjs';
-import '../shared/luca.TSMg1t7I.mjs';
+import '../shared/luca.BQXFn5yo.mjs';
+import '../shared/luca.pqZahLS5.mjs';
 import 'consola';
 
 let tsModuleCache = void 0;

package/dist/chunks/state.mjs

@@ -1,6 +1,6 @@
 import { defineCommand } from 'citty';
 import 'zod';
-import '../shared/luca.CRmaAfXR.mjs';
+import '../shared/luca.DXUcpbIe.mjs';
 import 'node:fs';
 import 'node:fs/promises';
 import 'node:path';
@@ -8,13 +8,13 @@ import 'node:crypto';
 import 'node:module';
 import 'node:url';
 import 'node:child_process';
-import { r as runWriteHandler, l as lucaStateAdvanceTool, a as lucaStateReadTool } from '../shared/luca.DjDTeDCi.mjs';
+import { r as runWriteHandler, l as lucaStateAdvanceTool, a as lucaStateReadTool } from '../shared/luca.DykMxS_D.mjs';
 import 'node:os';
-import '../shared/luca.CrXzXueR.mjs';
-import '../shared/luca.HZxBTBgD.mjs';
-import '../shared/luca.TSMg1t7I.mjs';
+import '../shared/luca.BH2GZl5z.mjs';
+import '../shared/luca.CuvqWf4b.mjs';
+import '../shared/luca.pqZahLS5.mjs';
 import '../shared/luca.CQ3g1xrD.mjs';
-import '../shared/luca.B3Mimc0P.mjs';
+import '../shared/luca.Djs7oPPj.mjs';
 
 const readCommand = defineCommand({
   meta: {

package/dist/chunks/stray-local-install.mjs

@@ -1,7 +1,7 @@
 import { existsSync, lstatSync } from 'node:fs';
 import { rm, writeFile, readdir, rmdir } from 'node:fs/promises';
 import { join } from 'node:path';
-import '../shared/luca.CRmaAfXR.mjs';
+import '../shared/luca.DXUcpbIe.mjs';
 import 'node:crypto';
 import 'node:module';
 import 'node:url';

package/dist/chunks/telemetry.mjs

@@ -1,5 +1,5 @@
 import { defineCommand } from 'citty';
-import { R as RunIdSchema, L as LUCA_DIR_ROOT, T as TelemetryRecordSchema } from '../shared/luca.CRmaAfXR.mjs';
+import { R as RunIdSchema, L as LUCA_DIR_ROOT, T as TelemetryRecordSchema } from '../shared/luca.DXUcpbIe.mjs';
 import { mkdirSync, appendFileSync } from 'node:fs';
 import 'node:fs/promises';
 import { join, dirname } from 'node:path';

package/dist/chunks/todo.mjs

@@ -1,6 +1,6 @@
 import { defineCommand } from 'citty';
 import 'zod';
-import '../shared/luca.CRmaAfXR.mjs';
+import '../shared/luca.DXUcpbIe.mjs';
 import 'node:fs';
 import 'node:fs/promises';
 import 'node:path';
@@ -8,13 +8,13 @@ import 'node:crypto';
 import 'node:module';
 import 'node:url';
 import 'node:child_process';
-import { c as readJsonPayload, r as runWriteHandler, h as lucaTodoUpdateTool, i as lucaTodoListTool, j as lucaTodoAddTool } from '../shared/luca.DjDTeDCi.mjs';
+import { e as readJsonPayload, r as runWriteHandler, j as lucaTodoUpdateTool, k as lucaTodoListTool, m as lucaTodoAddTool } from '../shared/luca.DykMxS_D.mjs';
 import 'node:os';
-import '../shared/luca.CrXzXueR.mjs';
-import '../shared/luca.HZxBTBgD.mjs';
-import '../shared/luca.TSMg1t7I.mjs';
+import '../shared/luca.BH2GZl5z.mjs';
+import '../shared/luca.CuvqWf4b.mjs';
+import '../shared/luca.pqZahLS5.mjs';
 import '../shared/luca.CQ3g1xrD.mjs';
-import '../shared/luca.B3Mimc0P.mjs';
+import '../shared/luca.Djs7oPPj.mjs';
 
 const addCommand = defineCommand({
   meta: {

package/dist/chunks/vault-init.mjs

@@ -1,5 +1,5 @@
 import { existsSync, chmodSync, mkdirSync } from 'node:fs';
-import '../shared/luca.CRmaAfXR.mjs';
+import '../shared/luca.DXUcpbIe.mjs';
 import 'node:fs/promises';
 import 'node:path';
 import { l as loadCurrentConfig } from '../shared/luca.CQ3g1xrD.mjs';

package/dist/chunks/verification.mjs

@@ -1,6 +1,6 @@
 import { defineCommand } from 'citty';
-import '../shared/luca.CRmaAfXR.mjs';
-import { l as loadCurrentState, r as resolveActiveSlug } from '../shared/luca.CrXzXueR.mjs';
+import '../shared/luca.DXUcpbIe.mjs';
+import { l as loadCurrentState, r as resolveActiveSlug } from '../shared/luca.BH2GZl5z.mjs';
 import 'node:fs';
 import 'node:fs/promises';
 import 'node:path';
@@ -8,11 +8,11 @@ import 'node:crypto';
 import 'node:module';
 import 'node:url';
 import 'node:child_process';
-import { l as listPhaseSlugs, r as readVerificationResult, a as aggregateVerificationResults } from '../shared/luca.BmhNkYe2.mjs';
+import { l as listPhaseSlugs, r as readVerificationResult, a as aggregateVerificationResults } from '../shared/luca.BQXFn5yo.mjs';
 import { l as logger } from '../shared/luca.dM-MKlNE.mjs';
 import 'zod';
 import 'node:os';
-import '../shared/luca.TSMg1t7I.mjs';
+import '../shared/luca.pqZahLS5.mjs';
 import 'pathe';
 import 'consola';
 

package/dist/chunks/workflow.mjs

@@ -1,6 +1,6 @@
 import { defineCommand } from 'citty';
 import 'zod';
-import '../shared/luca.CRmaAfXR.mjs';
+import '../shared/luca.DXUcpbIe.mjs';
 import 'node:fs';
 import 'node:fs/promises';
 import 'node:path';
@@ -8,13 +8,13 @@ import 'node:crypto';
 import 'node:module';
 import 'node:url';
 import 'node:child_process';
-import { r as runWriteHandler, s as lucaWorkflowResetTool } from '../shared/luca.DjDTeDCi.mjs';
+import { r as runWriteHandler, u as lucaWorkflowResetTool } from '../shared/luca.DykMxS_D.mjs';
 import 'node:os';
-import '../shared/luca.CrXzXueR.mjs';
-import '../shared/luca.HZxBTBgD.mjs';
-import '../shared/luca.TSMg1t7I.mjs';
+import '../shared/luca.BH2GZl5z.mjs';
+import '../shared/luca.CuvqWf4b.mjs';
+import '../shared/luca.pqZahLS5.mjs';
 import '../shared/luca.CQ3g1xrD.mjs';
-import '../shared/luca.B3Mimc0P.mjs';
+import '../shared/luca.Djs7oPPj.mjs';
 
 const resetCommand = defineCommand({
   meta: {

package/dist/claude/skills/caveman/SKILL.md

@@ -0,0 +1,58 @@
+---
+name: caveman
+description: "Ultra-compressed communication mode. Cuts token usage ~75% by speaking like caveman while keeping full technical accuracy. Supports intensity levels: lite, full (default), ultra. Use when user says \"caveman mode\", \"talk like caveman\", \"use caveman\", \"less tokens\", \"be brief\", or invokes /caveman. Also auto-triggers when token efficiency is requested."
+---
+
+<main>
+# Caveman
+
+Respond terse like smart caveman. All technical substance stay. Only fluff die.
+
+## Persistence
+
+ACTIVE EVERY RESPONSE. No revert after many turns. No filler drift. Still active if unsure. Off only: "stop caveman" / "normal mode".
+
+Default: **full**. Switch: `/caveman lite|full|ultra`.
+
+## Rules
+
+Drop: articles (a/an/the), filler (just/really/basically/actually/simply), pleasantries (sure/certainly/of course/happy to), hedging. Fragments OK. Short synonyms (big not extensive, fix not "implement a solution for"). Technical terms exact. Code blocks unchanged. Errors quoted exact.
+
+Pattern: `[thing] [action] [reason]. [next step].`
+
+Not: "Sure! I'd be happy to help you with that. The issue you're experiencing is likely caused by..."
+Yes: "Bug in auth middleware. Token expiry check use `<` not `<=`. Fix:"
+
+## Intensity
+
+| Level | What change |
+|-------|------------|
+| **lite** | No filler/hedging. Keep articles + full sentences. Professional but tight |
+| **full** | Drop articles, fragments OK, short synonyms. Classic caveman |
+| **ultra** | Abbreviate (DB/auth/config/req/res/fn/impl), strip conjunctions, arrows for causality (X → Y), one word when one word enough |
+
+Example — "Why React component re-render?"
+- lite: "Your component re-renders because you create a new object reference each render. Wrap it in `useMemo`."
+- full: "New object ref each render. Inline object prop = new ref = re-render. Wrap in `useMemo`."
+- ultra: "Inline obj prop → new ref → re-render. `useMemo`."
+
+Example — "Explain database connection pooling."
+- lite: "Connection pooling reuses open connections instead of creating new ones per request. Avoids repeated handshake overhead."
+- full: "Pool reuse open DB connections. No new connection per request. Skip handshake overhead."
+- ultra: "Pool = reuse DB conn. Skip handshake → fast under load."
+
+## Auto-Clarity
+
+Drop caveman for: security warnings, irreversible action confirmations, multi-step sequences where fragment order risks misread, user asks to clarify or repeats question. Resume caveman after clear part done.
+
+Example — destructive op:
+> **Warning:** This will permanently delete all rows in the `users` table and cannot be undone.
+> ```sql
+> DROP TABLE users;
+> ```
+> Caveman resume. Verify backup exist first.
+
+## Boundaries
+
+Code/commits/PRs: write normal. "stop caveman" or "normal mode": revert. Level persist until changed or session end.
+</main>

package/dist/claude/skills/lu/SKILL.md

@@ -80,7 +80,7 @@ Repeat until `pipelineStep` is `complete`:
 | `checks`      | Run `luca checks run --file <commands.json>` with the project's typecheck (and tests, if present). On failure, loop back to `execute`. |
 | `verify`      | Spawn `luca-verifier` (Agent tool). On `recommendation: fix`, loop back to `checks`; on `escalate`, stop and surface to the user. |
 | `review`      | Spawn `luca-reviewer` (Agent tool) — one per perspective, in parallel.     |
-| `learn`       | Spawn `luca-learner` (Agent tool). Then: more phases remain → advance to `plan` for the next phase; last phase → advance to `milestone`. |
+| `learn`       | Spawn `luca-learner` (Agent tool). Then, if more phases remain: run `luca phase advance` (bumps `currentPhase` to the next phase and marks the finished one complete) **before** advancing the step to `plan` — the next phase's artifacts resolve against the new `currentPhase`, so skipping this writes them into the wrong (or no) phase dir. On the last phase, do NOT run `luca phase advance`; advance the step to `milestone`. |
 | `milestone`   | Invoke `Skill(skill: "milestone-new")` to close out, or advance to `complete` if no milestone bookkeeping is needed. |
 
 ### Oversight

package/dist/claude/skills/milestone-complete/SKILL.md

@@ -71,9 +71,16 @@ When updating state during milestone completion, use the `luca` CLI write surfac
 STATE_JSON=$(luca state read 2>/dev/null || echo '{"initialized":false}')
 ```
 
-After archiving the milestone, reset workflow state for the next milestone:
+After archiving the milestone, freeze the closing milestone's phase
+directories and reset workflow state for the next milestone:
 
 ```bash
+# Move .luca/phases/<slug>/ → .luca/archive/<slug>/ so the next milestone's
+# roadmap starts from an empty phases/ dir (per LUCA_DIR_CONTRACT). Idempotent;
+# skips any slug already present under archive/. Do this BEFORE the next
+# roadmap is created, or stale phase dirs collide on phase number with it.
+luca phase archive 2>/dev/null || true
+
 luca workflow reset 2>/dev/null || true
 ```
 

package/dist/index.mjs

@@ -2,7 +2,7 @@ import { defineCommand, runMain as runMain$1 } from 'citty';
 import 'pathe';
 
 async function resolveVersion() {
-  return "13.0.0-alpha.2";
+  return "13.0.0-alpha.3";
 }
 const LUCA_VERSION = await resolveVersion();
 

package/dist/shared/{luca.CrXzXueR.mjs → luca.BH2GZl5z.mjs}

@@ -1,7 +1,7 @@
 import { existsSync } from 'node:fs';
 import { readFile } from 'node:fs/promises';
 import { join } from 'node:path';
-import { w as lucaStateSchemaTolerant, x as PhaseSlugSchema } from './luca.CRmaAfXR.mjs';
+import { x as lucaStateSchemaTolerant, P as PhaseSlugSchema } from './luca.DXUcpbIe.mjs';
 
 async function loadCurrentState(opts) {
   const statePath = join(opts.cwd, ".luca", "state.json");

package/dist/shared/{luca.BmhNkYe2.mjs → luca.BQXFn5yo.mjs}

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync, readdirSync } from 'node:fs';
 import { join } from 'node:path';
-import { u as VerificationResultSchema, v as PHASE_SLUG_RE } from './luca.CRmaAfXR.mjs';
-import { p as phasePathFor } from './luca.TSMg1t7I.mjs';
+import { v as VerificationResultSchema, w as PHASE_SLUG_RE } from './luca.DXUcpbIe.mjs';
+import { p as phasePathFor } from './luca.pqZahLS5.mjs';
 import { join as join$1 } from 'pathe';
 import 'node:fs/promises';
 import 'node:crypto';

package/dist/shared/{luca.C4gMUoBd.mjs → luca.BhM9TDAo.mjs}

@@ -1,4 +1,4 @@
-import './luca.CRmaAfXR.mjs';
+import './luca.DXUcpbIe.mjs';
 import 'node:fs';
 import 'node:fs/promises';
 import 'node:path';
@@ -6,8 +6,8 @@ import 'node:crypto';
 import 'node:module';
 import 'node:url';
 import 'node:child_process';
-import { r as readConfidenceJournal, a as readLedgerForRun } from './luca.HZxBTBgD.mjs';
-import { l as listPhaseSlugs, r as readVerificationResult } from './luca.BmhNkYe2.mjs';
+import { r as readConfidenceJournal, a as readLedgerForRun } from './luca.CuvqWf4b.mjs';
+import { l as listPhaseSlugs, r as readVerificationResult } from './luca.BQXFn5yo.mjs';
 
 function fingerprint(input) {
   let hash = 0;

package/dist/shared/{luca.HZxBTBgD.mjs → luca.CuvqWf4b.mjs}

@@ -1,7 +1,7 @@
 import { existsSync, readFileSync, mkdirSync, appendFileSync } from 'node:fs';
 import { join, dirname } from 'node:path';
-import { e as lucaRootPaths, q as LedgerEntrySchema, r as ConfidenceEntrySchema } from './luca.CRmaAfXR.mjs';
-import { p as phasePathFor } from './luca.TSMg1t7I.mjs';
+import { f as lucaRootPaths, r as LedgerEntrySchema, u as ConfidenceEntrySchema } from './luca.DXUcpbIe.mjs';
+import { p as phasePathFor } from './luca.pqZahLS5.mjs';
 
 function appendLedger(opts) {
   const entry = {

package/dist/shared/{luca.CRmaAfXR.mjs → luca.DXUcpbIe.mjs}

@@ -1,7 +1,7 @@
 import { z } from 'zod';
 import 'node:fs';
 import 'node:fs/promises';
-import 'node:path';
+import { isAbsolute, relative } from 'node:path';
 import 'node:os';
 
 const PipelineStepValues = [
@@ -266,8 +266,9 @@ function classifyWritePath(path, opts = {}) {
       }
     }
   }
-  if (path.startsWith(".luca/") || path === ".luca") {
-    if (AUDIT_PATH_PATTERN.test(path)) {
+  const rel = opts.cwd && isAbsolute(path) ? relative(opts.cwd, path) : path;
+  if (rel.startsWith(".luca/") || rel === ".luca") {
+    if (AUDIT_PATH_PATTERN.test(rel)) {
       return { class: "planning-audit" };
     }
     return { class: "planning-general" };
@@ -710,4 +711,4 @@ for (const step of Object.keys(STEP_REMINDERS)) {
   }
 }
 
-export { AUDIT_PATH_PATTERN as A, ClassifyComplexityInputSchema as C, LUCA_DIR_ROOT as L, ProjectPreferencesSchema as P, RunIdSchema as R, ShadowScanFindingSchema as S, TelemetryRecordSchema as T, VerificationRefSchema as V, WAVE_FILE_RE as W, classifyWritePath as a, ConfidenceCategorySchema as b, coarsePhaseOf as c, ConfidenceLevelSchema as d, lucaRootPaths as e, RoadmapPhaseSchema as f, PipelineStep as g, PIPELINE_TRANSITIONS as h, isLegalTransition as i, PIPELINE_STEP_TO_COARSE_PHASE as j, PipelineStepValues as k, lucaStateSchema as l, TodoIdSchema as m, TodoSchema as n, TodoStatus as o, TODO_CONCEPT_PREFIX as p, LedgerEntrySchema as q, ConfidenceEntrySchema as r, slugFromTitle as s, todoConceptFor as t, VerificationResultSchema as u, PHASE_SLUG_RE as v, lucaStateSchemaTolerant as w, PhaseSlugSchema as x, PHASE_FILE_PATHS as y };
+export { AUDIT_PATH_PATTERN as A, ClassifyComplexityInputSchema as C, LUCA_DIR_ROOT as L, PhaseSlugSchema as P, RunIdSchema as R, ShadowScanFindingSchema as S, TelemetryRecordSchema as T, VerificationRefSchema as V, WAVE_FILE_RE as W, classifyWritePath as a, ProjectPreferencesSchema as b, coarsePhaseOf as c, ConfidenceCategorySchema as d, ConfidenceLevelSchema as e, lucaRootPaths as f, RoadmapPhaseSchema as g, PipelineStep as h, isLegalTransition as i, PIPELINE_TRANSITIONS as j, PIPELINE_STEP_TO_COARSE_PHASE as k, lucaStateSchema as l, PipelineStepValues as m, TodoIdSchema as n, TodoSchema as o, TodoStatus as p, TODO_CONCEPT_PREFIX as q, LedgerEntrySchema as r, slugFromTitle as s, todoConceptFor as t, ConfidenceEntrySchema as u, VerificationResultSchema as v, PHASE_SLUG_RE as w, lucaStateSchemaTolerant as x, PHASE_FILE_PATHS as y };

package/dist/shared/{luca.B3Mimc0P.mjs → luca.Djs7oPPj.mjs}

@@ -37,6 +37,11 @@ const WRITE_COMMAND_PHASES = {
   // Phase-restricted structured mutations
   "roadmap create": ["idle", "triage"],
   "checks run": ["execute", "checks"],
+  // Phase lifecycle: advance at the phase boundary (learn); archive only
+  // at milestone close. (The tool descriptors carry matching allowedPhases,
+  // but the CLI self-check consults THIS table — runWriteHandler.)
+  "phase advance": ["learn"],
+  "phase archive": ["milestone", "complete"],
   // Phase-restricted freeform artifact writes
   "phase write-research": ["research"],
   "phase write-context": ["discuss"],

package/dist/shared/{luca.DjDTeDCi.mjs → luca.DykMxS_D.mjs}

@@ -1,17 +1,22 @@
 import { z } from 'zod';
-import { P as ProjectPreferencesSchema, b as ConfidenceCategorySchema, d as ConfidenceLevelSchema, e as lucaRootPaths, S as ShadowScanFindingSchema, f as RoadmapPhaseSchema, g as PipelineStep, i as isLegalTransition, h as PIPELINE_TRANSITIONS, j as PIPELINE_STEP_TO_COARSE_PHASE, k as PipelineStepValues, m as TodoIdSchema, s as slugFromTitle, n as TodoSchema, t as todoConceptFor, o as TodoStatus, p as TODO_CONCEPT_PREFIX, V as VerificationRefSchema, l as lucaStateSchema } from './luca.CRmaAfXR.mjs';
-import { l as loadCurrentState, r as resolveActiveSlug } from './luca.CrXzXueR.mjs';
+import { P as PhaseSlugSchema, L as LUCA_DIR_ROOT, b as ProjectPreferencesSchema, d as ConfidenceCategorySchema, e as ConfidenceLevelSchema, f as lucaRootPaths, S as ShadowScanFindingSchema, g as RoadmapPhaseSchema, h as PipelineStep, i as isLegalTransition, j as PIPELINE_TRANSITIONS, k as PIPELINE_STEP_TO_COARSE_PHASE, m as PipelineStepValues, n as TodoIdSchema, s as slugFromTitle, o as TodoSchema, t as todoConceptFor, p as TodoStatus, q as TODO_CONCEPT_PREFIX, V as VerificationRefSchema, l as lucaStateSchema } from './luca.DXUcpbIe.mjs';
+import { l as loadCurrentState, r as resolveActiveSlug } from './luca.BH2GZl5z.mjs';
 import { existsSync, readFileSync, writeFileSync } from 'node:fs';
-import { mkdir, writeFile, rename, rm, readFile, appendFile, unlink } from 'node:fs/promises';
+import { mkdir, writeFile, rename, rm, readFile, readdir, appendFile, unlink } from 'node:fs/promises';
 import { join, dirname, resolve, relative, sep } from 'node:path';
 import 'node:crypto';
 import 'node:module';
 import 'node:url';
 import { spawnSync } from 'node:child_process';
-import { c as appendConfidenceEntry, d as appendLedger } from './luca.HZxBTBgD.mjs';
-import { p as phasePathFor } from './luca.TSMg1t7I.mjs';
+import { c as appendConfidenceEntry, d as appendLedger } from './luca.CuvqWf4b.mjs';
+import { p as phasePathFor } from './luca.pqZahLS5.mjs';
 import { l as loadCurrentConfig } from './luca.CQ3g1xrD.mjs';
-import { S as STEP_ARTIFACTS, W as WRITE_COMMAND_PHASES } from './luca.B3Mimc0P.mjs';
+import { S as STEP_ARTIFACTS, W as WRITE_COMMAND_PHASES } from './luca.Djs7oPPj.mjs';
+
+function archivedPhasePathFor(slug) {
+  PhaseSlugSchema.parse(slug);
+  return `${LUCA_DIR_ROOT}/archive/${slug}`;
+}
 
 const PREFERENCE_SECTIONS = [
   "schemaVersion",
@@ -578,7 +583,7 @@ async function validateVerificationRef(opts) {
   return null;
 }
 
-const inputSchema$h = z.object({
+const inputSchema$j = z.object({
   default_branch: z.string().min(1).default("main").describe(
     "Branch name that must NOT equal the current branch (typically the repository default branch)."
   )
@@ -597,7 +602,7 @@ async function readCurrentBranch(cwd) {
 const lucaBranchGuardTool = {
   name: "luca_branch_guard",
   description: "Assert that the current git branch is NOT the repository default branch. Returns isError when on the default branch, otherwise ok=true. Use before committing to prevent accidental main writes.",
-  inputSchema: inputSchema$h,
+  inputSchema: inputSchema$j,
   async handler(args, ctx) {
     const current = await readCurrentBranch(ctx.cwd);
     if (current === null) {
@@ -634,7 +639,7 @@ const commandSchema = z.object({
     "Optional human-friendly label for this command in the summary output. Defaults to the argv joined by spaces."
   )
 });
-const inputSchema$g = z.object({
+const inputSchema$i = z.object({
   commands: z.array(commandSchema).min(1).describe(
     "Ordered list of commands to run sequentially. Each command runs only if the previous one is still within budget; failures do NOT stop the sequence."
   ),
@@ -714,7 +719,7 @@ async function runOne(argv, label, cwd, timeoutMs) {
 const lucaChecksRunTool = {
   name: "luca_checks_run",
   description: "Run verification commands (typecheck/tests/lint) sequentially with per-command timeout and SIGTERM/SIGKILL cleanup. Returns structured summary per command. Only callable in execute/checks phases.",
-  inputSchema: inputSchema$g,
+  inputSchema: inputSchema$i,
   allowedPhases: ["execute", "checks"],
   async handler(args, ctx) {
     const results = [];
@@ -732,7 +737,7 @@ const lucaChecksRunTool = {
   }
 };
 
-const inputSchema$f = z.object({
+const inputSchema$h = z.object({
   phase: z.string().min(1).describe("Phase name from the plan / roadmap."),
   wave: z.number().describe("Wave number within the phase."),
   task: z.string().min(1).describe("Task ID or description from the plan."),
@@ -752,7 +757,7 @@ const inputSchema$f = z.object({
 const lucaConfidenceLogTool = {
   name: "luca_confidence_log",
   description: "Append a confidence entry to the active phase's confidence.jsonl. One JSONL line per call. Payload matches the canonical ConfidenceEntrySchema (phase, wave, task, confidence, category, decision, alternatives, reasoning, risk, files, reviewHint?).",
-  inputSchema: inputSchema$f,
+  inputSchema: inputSchema$h,
   async handler(args, ctx) {
     const state = await loadCurrentState({ cwd: ctx.cwd });
     const slug = resolveActiveSlug(state);
@@ -790,6 +795,109 @@ const lucaConfidenceLogTool = {
   }
 };
 
+const inputSchema$g = z.object({});
+const lucaPhaseAdvanceTool = {
+  name: "luca_phase_advance",
+  description: "Advance the active roadmap phase by one (currentPhase \u2192 currentPhase+1), marking the completed phase `complete` and the next `in-progress`. Call at the phase boundary (learn step) when more phases remain; the final phase routes to the milestone step instead. Errors if no phase is active (currentPhase=0) or already at the final phase.",
+  inputSchema: inputSchema$g,
+  allowedPhases: ["learn"],
+  async handler(_args, ctx) {
+    const state = await loadCurrentState({ cwd: ctx.cwd });
+    const { currentPhase, totalPhases } = state;
+    if (currentPhase === 0) {
+      return errorResult(
+        "no active phase to advance (currentPhase=0). Create a roadmap first (`luca roadmap create`)."
+      );
+    }
+    if (currentPhase >= totalPhases) {
+      return errorResult(
+        `already at the final phase (${currentPhase}/${totalPhases}); there is no next phase. Advance to the milestone step instead.`
+      );
+    }
+    const roadmap = state.roadmap.map((phase, index) => {
+      if (index === currentPhase - 1) {
+        return { ...phase, status: "complete" };
+      }
+      if (index === currentPhase) {
+        return { ...phase, status: "in-progress" };
+      }
+      return phase;
+    });
+    const next = { ...state, roadmap, currentPhase: currentPhase + 1 };
+    const absPath = join(ctx.cwd, lucaRootPaths.state);
+    await writeAtomicFile(absPath, JSON.stringify(next, null, 2) + "\n");
+    return {
+      content: [
+        {
+          type: "text",
+          text: `phase advanced: ${currentPhase} \u2192 ${currentPhase + 1} of ${totalPhases} (phase ${currentPhase} marked complete, phase ${currentPhase + 1} in-progress)`
+        }
+      ]
+    };
+  }
+};
+function errorResult(message) {
+  return {
+    content: [{ type: "text", text: message }],
+    isError: true
+  };
+}
+
+const inputSchema$f = z.object({});
+const lucaPhaseArchiveTool = {
+  name: "luca_phase_archive",
+  description: "Archive all active phase directories (.luca/phases/<slug>/ \u2192 .luca/archive/<slug>/) at milestone close, so the next milestone starts from an empty phases/ dir. Idempotent: a slug already present under archive/ is skipped, not overwritten. Allowed only in the milestone/complete steps.",
+  inputSchema: inputSchema$f,
+  allowedPhases: ["milestone", "complete"],
+  async handler(_args, ctx) {
+    const phasesDir = join(ctx.cwd, ".luca", "phases");
+    if (!existsSync(phasesDir)) {
+      return ok("no .luca/phases/ directory \u2014 nothing to archive.");
+    }
+    const entries = await readdir(phasesDir, { withFileTypes: true });
+    const archived = [];
+    const skipped = [];
+    const invalid = [];
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      const slug = entry.name;
+      let to;
+      try {
+        to = join(ctx.cwd, archivedPhasePathFor(slug));
+      } catch {
+        invalid.push(slug);
+        continue;
+      }
+      const from = join(phasesDir, slug);
+      if (existsSync(to)) {
+        skipped.push(slug);
+        continue;
+      }
+      await mkdir(join(ctx.cwd, ".luca", "archive"), {
+        recursive: true
+      });
+      await rename(from, to);
+      archived.push(slug);
+    }
+    const parts = [`archived ${archived.length} phase(s) \u2192 .luca/archive/`];
+    if (archived.length > 0) parts.push(`moved: ${archived.join(", ")}`);
+    if (skipped.length > 0) {
+      parts.push(
+        `skipped (archive entry already exists): ${skipped.join(", ")}`
+      );
+    }
+    if (invalid.length > 0) {
+      parts.push(
+        `skipped (not a valid phase slug): ${invalid.join(", ")}`
+      );
+    }
+    return ok(parts.join(". "));
+  }
+};
+function ok(text) {
+  return { content: [{ type: "text", text }] };
+}
+
 const inputSchema$e = z.object({});
 const lucaPhaseCurrentTool = {
   name: "luca_phase_current",
@@ -1283,7 +1391,7 @@ const inputSchema$7 = z.object({
 });
 const lucaRoadmapCreateTool = {
   name: "luca_roadmap_create",
-  description: "Replace the roadmap in .luca/state.json with a new ordered list of phases. Resets currentPhase to 0; updates totalPhases. Only callable in idle or triage pipelineSteps so an active roadmap cannot be clobbered mid-execution.",
+  description: "Replace the roadmap in .luca/state.json with a new ordered list of phases. Activates phase 1 (currentPhase=1) when non-empty; updates totalPhases. Only callable in idle or triage pipelineSteps so an active roadmap cannot be clobbered mid-execution.",
   inputSchema: inputSchema$7,
   allowedPhases: ["idle", "triage"],
   async handler(args, ctx) {
@@ -1293,11 +1401,12 @@ const lucaRoadmapCreateTool = {
       deps: p.deps ?? [],
       status: p.status ?? "pending"
     }));
+    const currentPhase = phases.length > 0 ? 1 : 0;
     const next = {
       ...state,
       roadmap: phases,
       totalPhases: phases.length,
-      currentPhase: 0
+      currentPhase
     };
     const absPath = join(ctx.cwd, lucaRootPaths.state);
     await writeAtomicFile(absPath, JSON.stringify(next, null, 2) + "\n");
@@ -1305,7 +1414,7 @@ const lucaRoadmapCreateTool = {
       content: [
         {
           type: "text",
-          text: `wrote .luca/state.json (roadmap replaced with ${phases.length} phase(s); currentPhase reset to 0)`
+          text: `wrote .luca/state.json (roadmap replaced with ${phases.length} phase(s); currentPhase=${currentPhase})`
         }
       ]
     };
@@ -1901,4 +2010,4 @@ async function readJsonPayload(command, filePath) {
   }
 }
 
-export { lucaStateReadTool as a, lucaPhaseCurrentTool as b, readJsonPayload as c, lucaRoadmapReadTool as d, lucaRoadmapCreateTool as e, lucaPreferencesReadTool as f, lucaPreferencesWriteTool as g, lucaTodoUpdateTool as h, lucaTodoListTool as i, lucaTodoAddTool as j, lucaPrReviewDetectConvergenceTool as k, lucaStateAdvanceTool as l, lucaPrReviewFilterStaleTool as m, lucaPrReviewRegressionCheckTool as n, lucaRepoCleanupApplyTool as o, lucaChecksRunTool as p, lucaBranchGuardTool as q, runWriteHandler as r, lucaWorkflowResetTool as s, lucaConfidenceLogTool as t };
+export { lucaStateReadTool as a, lucaPhaseCurrentTool as b, lucaPhaseAdvanceTool as c, lucaPhaseArchiveTool as d, readJsonPayload as e, lucaRoadmapReadTool as f, lucaRoadmapCreateTool as g, lucaPreferencesReadTool as h, lucaPreferencesWriteTool as i, lucaTodoUpdateTool as j, lucaTodoListTool as k, lucaStateAdvanceTool as l, lucaTodoAddTool as m, lucaPrReviewDetectConvergenceTool as n, lucaPrReviewFilterStaleTool as o, lucaPrReviewRegressionCheckTool as p, lucaRepoCleanupApplyTool as q, runWriteHandler as r, lucaChecksRunTool as s, lucaBranchGuardTool as t, lucaWorkflowResetTool as u, lucaConfidenceLogTool as v };

package/dist/shared/{luca.TSMg1t7I.mjs → luca.pqZahLS5.mjs}

@@ -1,4 +1,4 @@
-import { x as PhaseSlugSchema, L as LUCA_DIR_ROOT, y as PHASE_FILE_PATHS } from './luca.CRmaAfXR.mjs';
+import { P as PhaseSlugSchema, L as LUCA_DIR_ROOT, y as PHASE_FILE_PATHS } from './luca.DXUcpbIe.mjs';
 
 function phasePathFor(slug, file) {
   PhaseSlugSchema.parse(slug);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@alecsibilia/luca",
   "description": "Luca — spec-driven agentic development workflow for Claude Code (umbrella; bundles luca-cli, luca-core, luca-tools)",
-  "version": "13.0.0-alpha.2",
+  "version": "13.0.0-alpha.3",
   "license": "Apache-2.0",
   "author": "Alec Sibilia <sibilia.alec@gmail.com>",
   "homepage": "https://github.com/asibilia/luca-framework#readme",