@cleocode/cleo 2026.5.123 → 2026.5.125

package/dist/cli/index.js

@@ -18713,7 +18713,6 @@ import {
   exportDocument,
   findSimilarDocs,
   generateDocsLlmsTxt,
-  getCleoDirAbsolute,
   getProjectRoot as getProjectRoot5,
   isLifecycleStatus,
   listDocVersions,
@@ -18728,6 +18727,8 @@ import {
   releaseReservedSlug,
   reserveSlugForDispatch,
   resolveAttachmentBackend,
+  resolveCanonicalCleoDir,
+  resolveProjectByCwd,
   runDocsImport,
   SlugCollisionError,
   SUPERSEDE_NOT_FOUND_CODE,
@@ -19284,7 +19285,7 @@ var init_docs2 = __esm({
           return lafsError("E_NOT_FOUND", `Attachment not found: ${ref}`, "fetch");
         }
         const cwd = getProjectRoot5();
-        const cleoDir = getCleoDirAbsolute(cwd);
+        const cleoDir = resolveCanonicalCleoDir(resolveProjectByCwd(cwd));
         let storagePath;
         if (metadata.attachment.kind === "local-file") {
           storagePath = metadata.attachment.path;
@@ -28848,7 +28849,8 @@ async function orchestrateSpawnOp(params) {
     params.tier,
     params.noWorktree,
     params.spawnScope,
-    params.atomicityScope
+    params.atomicityScope,
+    params.resume
   );
 }
 async function orchestrateHandoffOp(params) {
@@ -28928,12 +28930,12 @@ async function orchestrateRejectOp(params) {
 async function orchestrateClassify(request, context, projectRoot) {
   try {
     const { getCleoCantWorkflowsDir } = await import("@cleocode/core/internal");
-    const { readFileSync: readFileSync22, readdirSync: readdirSync3, existsSync: existsSync20 } = await import("node:fs");
+    const { readFileSync: readFileSync22, readdirSync: readdirSync3, existsSync: existsSync21 } = await import("node:fs");
     const { join: join38 } = await import("node:path");
     const workflowsDir = getCleoCantWorkflowsDir();
     const combined = `${request} ${context ?? ""}`.toLowerCase();
     const matches = [];
-    if (existsSync20(workflowsDir)) {
+    if (existsSync21(workflowsDir)) {
       const files = readdirSync3(workflowsDir).filter((f) => f.endsWith(".cant"));
       for (const file of files) {
         try {
@@ -28953,7 +28955,7 @@ async function orchestrateClassify(request, context, projectRoot) {
       }
     }
     const localCantDir = join38(projectRoot, CLEO_DIR_NAME, WORKFLOWS_SUBDIR);
-    if (existsSync20(localCantDir)) {
+    if (existsSync21(localCantDir)) {
       const files = readdirSync3(localCantDir).filter((f) => f.endsWith(".cant"));
       for (const file of files) {
         try {
@@ -29149,11 +29151,11 @@ async function orchestrateAnalyzeParallelSafety(taskIds, projectRoot) {
     };
   }
 }
-async function handleWorktreeComplete(taskId, projectRoot, resolve10) {
+async function handleWorktreeComplete(taskId, projectRoot, resolve11) {
   try {
     const { completeWorktreeForTask } = await import("@cleocode/core/internal");
     const result = completeWorktreeForTask(taskId, projectRoot, {
-      resolve: resolve10 ?? "auto"
+      resolve: resolve11 ?? "auto"
     });
     if (result.outcome === "conflict") {
       return {
@@ -29851,10 +29853,10 @@ var init_orchestrate2 = __esm({
                   startTime
                 );
               const rawResolve = params.resolve;
-              const resolve10 = rawResolve === "manual" ? "manual" : rawResolve === "auto" ? "auto" : void 0;
+              const resolve11 = rawResolve === "manual" ? "manual" : rawResolve === "auto" ? "auto" : void 0;
               const p = {
                 taskId: params.taskId,
-                ...resolve10 !== void 0 ? { resolve: resolve10 } : {}
+                ...resolve11 !== void 0 ? { resolve: resolve11 } : {}
               };
               return wrapResult(
                 await coreOps2["worktree.complete"](p),
@@ -35464,7 +35466,7 @@ function wrapParseError(rawInput, parseErr, sourceLabel) {
   return new Error(`Invalid JSON in ${sourceLabel}: ${parseErr.message} (got: ${snippet2})`);
 }
 function readStdinJson(stdin2) {
-  return new Promise((resolve10, reject) => {
+  return new Promise((resolve11, reject) => {
     const chunks = [];
     stdin2.on("data", (chunk) => {
       chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
@@ -35475,7 +35477,7 @@ function readStdinJson(stdin2) {
     stdin2.on("end", () => {
       const raw = Buffer.concat(chunks).toString("utf8");
       try {
-        resolve10(JSON.parse(raw));
+        resolve11(JSON.parse(raw));
       } catch (err) {
         reject(wrapParseError(raw, err, "stdin"));
       }
@@ -36704,12 +36706,12 @@ var init_agent = __esm({
             transportConfig: {},
             isActive: true
           });
-          const { existsSync: existsSync20, mkdirSync: mkdirSync7, writeFileSync: writeFileSync7 } = await import("node:fs");
+          const { existsSync: existsSync21, mkdirSync: mkdirSync7, writeFileSync: writeFileSync7 } = await import("node:fs");
           const { join: join38 } = await import("node:path");
           const cantDir = join38(CLEO_DIR_NAME, AGENTS_SUBDIR);
           const cantPath = join38(cantDir, `${agentId}.cant`);
           let cantScaffolded = false;
-          if (!existsSync20(cantPath)) {
+          if (!existsSync21(cantPath)) {
             mkdirSync7(cantDir, { recursive: true });
             const role = classification ?? "specialist";
             const cantContent = `---
@@ -36769,7 +36771,7 @@ agent ${agentId}:
               data: {
                 agentId: credential.agentId,
                 displayName: credential.displayName,
-                cantFile: cantScaffolded ? cantPath : existsSync20(cantPath) ? cantPath : null,
+                cantFile: cantScaffolded ? cantPath : existsSync21(cantPath) ? cantPath : null,
                 cantScaffolded
               }
             },
@@ -36888,7 +36890,7 @@ agent ${agentId}:
         try {
           const { AgentRegistryAccessor } = await import("@cleocode/core/agents");
           const { createRuntime } = await import("@cleocode/runtime");
-          const { existsSync: existsSync20, readFileSync: readFileSync22 } = await import("node:fs");
+          const { existsSync: existsSync21, readFileSync: readFileSync22 } = await import("node:fs");
           const { join: join38 } = await import("node:path");
           await openCleoDb("tasks");
           const registry = new AgentRegistryAccessor(getProjectRoot24());
@@ -36910,7 +36912,7 @@ agent ${agentId}:
           let profile = null;
           let cantValidation = null;
           const cantPath = args.cant ?? join38(CLEO_DIR_NAME, AGENTS_SUBDIR, `${args.agentId}.cant`);
-          if (existsSync20(cantPath)) {
+          if (existsSync21(cantPath)) {
             profile = readFileSync22(cantPath, "utf-8");
             try {
               const cantModule = await import("@cleocode/cant");
@@ -37434,7 +37436,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
         try {
           const { AgentRegistryAccessor } = await import("@cleocode/core/agents");
           const { createRuntime } = await import("@cleocode/runtime");
-          const { existsSync: existsSync20 } = await import("node:fs");
+          const { existsSync: existsSync21 } = await import("node:fs");
           const { join: join38 } = await import("node:path");
           await openCleoDb("tasks");
           const registry = new AgentRegistryAccessor(getProjectRoot24());
@@ -37453,7 +37455,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           await registry.update(args.agentId, { isActive: true });
           await registry.markUsed(args.agentId);
           const cantPath = join38(CLEO_DIR_NAME, AGENTS_SUBDIR, `${args.agentId}.cant`);
-          const hasProfile = existsSync20(cantPath);
+          const hasProfile = existsSync21(cantPath);
           const runtime = await createRuntime(registry, {
             agentId: args.agentId,
             pollIntervalMs: 5e3,
@@ -38249,10 +38251,10 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
       async run({ args }) {
         let tempDir = null;
         try {
-          const { existsSync: existsSync20 } = await import("node:fs");
-          const { basename, resolve: resolve10 } = await import("node:path");
-          const resolvedPath = resolve10(args.path);
-          if (!existsSync20(resolvedPath)) {
+          const { existsSync: existsSync21 } = await import("node:fs");
+          const { basename, resolve: resolve11 } = await import("node:path");
+          const resolvedPath = resolve11(args.path);
+          if (!existsSync21(resolvedPath)) {
             cliOutput(
               {
                 success: false,
@@ -38377,11 +38379,11 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
       },
       async run({ args }) {
         try {
-          const { existsSync: existsSync20, statSync } = await import("node:fs");
-          const { resolve: resolve10, basename, dirname: dirname12 } = await import("node:path");
+          const { existsSync: existsSync21, statSync: statSync2 } = await import("node:fs");
+          const { resolve: resolve11, basename, dirname: dirname12 } = await import("node:path");
           const { execFileSync: execFileSync5 } = await import("node:child_process");
-          const resolvedDir = resolve10(args.dir);
-          if (!existsSync20(resolvedDir) || !statSync(resolvedDir).isDirectory()) {
+          const resolvedDir = resolve11(args.dir);
+          if (!existsSync21(resolvedDir) || !statSync2(resolvedDir).isDirectory()) {
             cliOutput(
               {
                 success: false,
@@ -38397,7 +38399,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           }
           const { join: join38 } = await import("node:path");
           const personaPath = join38(resolvedDir, "persona.cant");
-          if (!existsSync20(personaPath)) {
+          if (!existsSync21(personaPath)) {
             cliOutput(
               {
                 success: false,
@@ -38413,7 +38415,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
           }
           const agentName = basename(resolvedDir);
           const archiveName = `${agentName}.cantz`;
-          const archivePath = resolve10(archiveName);
+          const archivePath = resolve11(archiveName);
           const parentDir = dirname12(resolvedDir);
           try {
             execFileSync5("zip", ["-r", archivePath, agentName], {
@@ -38435,7 +38437,7 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
             process.exitCode = 1;
             return;
           }
-          const archiveStats = statSync(archivePath);
+          const archiveStats = statSync2(archivePath);
           const { readdirSync: readdirSync3 } = await import("node:fs");
           let fileCount = 0;
           const countFiles = (dirPath) => {
@@ -38692,17 +38694,17 @@ Task ${args.taskId} reassigned to you by ${active.agentId}. Run: cleo show ${arg
       },
       async run({ args }) {
         try {
-          const { existsSync: existsSync20, readFileSync: readFileSync22, mkdirSync: mkdirSync7 } = await import("node:fs");
-          const { resolve: resolve10, join: join38 } = await import("node:path");
-          const specPath = resolve10(args.spec);
-          if (!existsSync20(specPath)) {
+          const { existsSync: existsSync21, readFileSync: readFileSync22, mkdirSync: mkdirSync7 } = await import("node:fs");
+          const { resolve: resolve11, join: join38 } = await import("node:path");
+          const specPath = resolve11(args.spec);
+          if (!existsSync21(specPath)) {
             cliError(`spec file not found: ${specPath}`, 4, { name: "E_NOT_FOUND" });
             process.exitCode = 4;
             return;
           }
           const specContent = readFileSync22(specPath, "utf-8");
           const projectRoot = getProjectRoot24();
-          const outputDir = args["output-dir"] ? resolve10(args["output-dir"]) : join38(projectRoot, ".cleo", "cant", "agents");
+          const outputDir = args["output-dir"] ? resolve11(args["output-dir"]) : join38(projectRoot, ".cleo", "cant", "agents");
           mkdirSync7(outputDir, { recursive: true });
           if (args["dry-run"]) {
             cliOutput(
@@ -39453,8 +39455,8 @@ function detectAuthType(provider, token) {
 async function promptYesNo(question) {
   const rl = createInterface({ input: process.stdin, output: process.stderr });
   try {
-    const answer = await new Promise((resolve10) => {
-      rl.question(question, (a) => resolve10(a));
+    const answer = await new Promise((resolve11) => {
+      rl.question(question, (a) => resolve11(a));
     });
     const clean = answer.trim().toLowerCase();
     return clean === "y" || clean === "yes";
@@ -40390,12 +40392,12 @@ async function promptPassphrase() {
       "Cannot prompt for passphrase: stdin is not a TTY. Set the CLEO_BACKUP_PASSPHRASE environment variable for non-interactive use."
     );
   }
-  return new Promise((resolve10) => {
+  return new Promise((resolve11) => {
     process.stdout.write("Passphrase: ");
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
     rl.question("", (answer) => {
       rl.close();
-      resolve10(answer.trim());
+      resolve11(answer.trim());
     });
   });
 }
@@ -41505,11 +41507,11 @@ var init_caamp = __esm({
         }
         if (args["dry-run"]) {
           const { parseCaampBlocks } = await import("@cleocode/caamp");
-          const { existsSync: existsSync20 } = await import("node:fs");
+          const { existsSync: existsSync21 } = await import("node:fs");
           const { readFile: readFile9 } = await import("node:fs/promises");
           const dryResults = [];
           for (const filePath of filePaths) {
-            if (!existsSync20(filePath)) {
+            if (!existsSync21(filePath)) {
               dryResults.push({ filePath, exists: false, blockCount: 0, wouldRemove: 0 });
               continue;
             }
@@ -42603,11 +42605,11 @@ var init_check2 = __esm({
       },
       async run({ args }) {
         const { spawnSync } = await import("node:child_process");
-        const { existsSync: existsSync20 } = await import("node:fs");
-        const { join: join38, resolve: resolve10 } = await import("node:path");
+        const { existsSync: existsSync21 } = await import("node:fs");
+        const { join: join38, resolve: resolve11 } = await import("node:path");
         const strict = Boolean(args.strict);
         const jsonOnly = Boolean(args.json);
-        const repoRoot = resolve10(process.cwd());
+        const repoRoot = resolve11(process.cwd());
         const gates = [
           {
             id: "gate-1",
@@ -42645,7 +42647,7 @@ var init_check2 = __esm({
         let anyFailed = false;
         for (const gate of gates) {
           const scriptPath = join38(repoRoot, gate.script);
-          if (!existsSync20(scriptPath)) {
+          if (!existsSync21(scriptPath)) {
             results.push({
               id: gate.id,
               task: gate.task,
@@ -54325,7 +54327,7 @@ async function _headlessPkceFlow(provider, authUrl) {
     `  After approving, paste the full redirect URL (http://localhost?code=\u2026&state=\u2026):
   `
   );
-  return new Promise((resolve10, reject) => {
+  return new Promise((resolve11, reject) => {
     let buf = "";
     process.stdin.setEncoding("utf8");
     process.stdin.once("data", (chunk) => {
@@ -54337,7 +54339,7 @@ async function _headlessPkceFlow(provider, authUrl) {
           reject(new Error('Redirect URL is missing the "code" parameter'));
           return;
         }
-        resolve10(code);
+        resolve11(code);
       } catch {
         reject(new Error(`Invalid redirect URL: ${buf}`));
       }
@@ -54345,7 +54347,7 @@ async function _headlessPkceFlow(provider, authUrl) {
   });
 }
 async function _localCallbackPkceFlow(provider, authUrl, expectedState, port) {
-  return new Promise((resolve10) => {
+  return new Promise((resolve11) => {
     const server = createServer2((req, res) => {
       const url = new URL(req.url ?? "/", `http://localhost:${port}`);
       const code = url.searchParams.get("code");
@@ -54355,7 +54357,7 @@ async function _localCallbackPkceFlow(provider, authUrl, expectedState, port) {
       if (error) {
         res.end(`<h1>Authorization failed</h1><p>${error}</p><p>You may close this tab.</p>`);
         server.close();
-        resolve10({
+        resolve11({
           error: {
             code: "E_PKCE_AUTH_DENIED",
             codeName: "E_PKCE_AUTH_DENIED",
@@ -54367,7 +54369,7 @@ async function _localCallbackPkceFlow(provider, authUrl, expectedState, port) {
       if (!code || state !== expectedState) {
         res.end("<h1>Invalid callback</h1><p>You may close this tab.</p>");
         server.close();
-        resolve10({
+        resolve11({
           error: {
             code: "E_PKCE_INVALID_CALLBACK",
             codeName: "E_PKCE_INVALID_CALLBACK",
@@ -54378,7 +54380,7 @@ async function _localCallbackPkceFlow(provider, authUrl, expectedState, port) {
       }
       res.end("<h1>Authorized</h1><p>You may close this tab and return to your terminal.</p>");
       server.close();
-      resolve10({ code });
+      resolve11({ code });
     });
     server.listen(port, "localhost", () => {
       process.stderr.write("\n");
@@ -54511,7 +54513,7 @@ function _generateState() {
   return Array.from(bytes, (b) => b.toString(16).padStart(2, "0")).join("");
 }
 function _findFreePort() {
-  return new Promise((resolve10, reject) => {
+  return new Promise((resolve11, reject) => {
     const srv = createServer2();
     srv.listen(0, "localhost", () => {
       const addr = srv.address();
@@ -54521,7 +54523,7 @@ function _findFreePort() {
         return;
       }
       const port = addr.port;
-      srv.close(() => resolve10(port));
+      srv.close(() => resolve11(port));
     });
     srv.on("error", reject);
   });
@@ -55143,14 +55145,14 @@ async function readStdin() {
   if (process.stdin.isTTY) {
     return "";
   }
-  return new Promise((resolve10, reject) => {
+  return new Promise((resolve11, reject) => {
     let data = "";
     process.stdin.setEncoding("utf-8");
     process.stdin.on("data", (chunk) => {
       data += chunk;
     });
     process.stdin.on("end", () => {
-      resolve10(data.trim());
+      resolve11(data.trim());
     });
     process.stdin.on("error", reject);
   });
@@ -58719,13 +58721,13 @@ var init_nexus3 = __esm({
           if (!skipPrompt) {
             const { createInterface: createInterface5 } = await import("node:readline");
             const rl = createInterface5({ input: process.stdin, output: process.stdout });
-            const confirmed = await new Promise((resolve10) => {
+            const confirmed = await new Promise((resolve11) => {
               rl.question(
                 `
 [nexus] Delete ${matchCount} project(s) from the registry? [y/N] `,
                 (answer) => {
                   rl.close();
-                  resolve10(answer.trim().toLowerCase() === "y");
+                  resolve11(answer.trim().toLowerCase() === "y");
                 }
               );
             });
@@ -60376,6 +60378,10 @@ var init_orchestrate3 = __esm({
         "orchestrator-defer": {
           type: "boolean",
           description: "T9214 atomicity waiver: defer worker file-scope declaration to commit time. Tier-1+ orchestrators only \u2014 records auditable atomicity_waiver in the spawn manifest. Bypasses E_ATOMICITY_NO_SCOPE for worker tasks without explicit AC.files."
+        },
+        resume: {
+          type: "boolean",
+          description: "T10078 \u2014 skip worktree provisioning and attach to an existing locked worktree at the canonical XDG path. If the worktree does not exist, returns E_RESUME_WORKTREE_MISSING. Use after a prior aborted spawn left a worktree behind."
         }
       },
       async run({ args }) {
@@ -60397,7 +60403,8 @@ var init_orchestrate3 = __esm({
             tier,
             noWorktree: args["no-worktree"] === true,
             ...args.scope ? { spawnScope: args.scope } : {},
-            ...atomicityScope ? { atomicityScope } : {}
+            ...atomicityScope ? { atomicityScope } : {},
+            resume: args.resume === true
           },
           { command: "orchestrate" }
         );
@@ -61675,6 +61682,181 @@ var init_playbook3 = __esm({
   }
 });
 
+// packages/cleo/src/cli/commands/project.ts
+var project_exports = {};
+__export(project_exports, {
+  projectCommand: () => projectCommand
+});
+import { existsSync as existsSync16, statSync } from "node:fs";
+import { resolve as resolve7 } from "node:path";
+import { moveProject, projectLifecycle, renameProject } from "@cleocode/core";
+function formatSuccessSection(header, icon, items) {
+  const prefix = icon ? `${icon} ` : "";
+  return { kind: "section", data: { header: `${prefix}${header}`, items } };
+}
+function formatErrorSection(code, message, details) {
+  const items = [message];
+  if (details) {
+    for (const [key, value] of Object.entries(details)) {
+      if (value !== void 0 && value !== null) {
+        items.push(`${key}: ${typeof value === "string" ? value : JSON.stringify(value)}`);
+      }
+    }
+  }
+  return { kind: "section", data: { header: `Error: ${code}`, items } };
+}
+var moveSubCommand, renameSubCommand, reregisterSubCommand, projectCommand;
+var init_project = __esm({
+  "packages/cleo/src/cli/commands/project.ts"() {
+    "use strict";
+    init_dist();
+    init_renderers();
+    moveSubCommand = defineCommand({
+      meta: { name: "move", description: "Move a CLEO project to a new directory." },
+      args: {
+        newPath: {
+          type: "positional",
+          description: "New absolute path for the project root.",
+          required: true
+        },
+        "dry-run": {
+          type: "boolean",
+          description: "Compute the plan without executing.",
+          default: false
+        },
+        json: { type: "boolean", description: "Output raw JSON envelope.", default: false }
+      },
+      async run({ args }) {
+        const newPathRaw = args["newPath"];
+        const dryRun = args["dry-run"] ?? false;
+        const newPath = resolve7(newPathRaw);
+        if (!dryRun && existsSync16(newPath) && statSync(newPath).isFile()) {
+          cliOutput(formatErrorSection("E_INVALID_PATH", `newPath is not a directory: ${newPath}`), {
+            command: "project",
+            operation: "project.move"
+          });
+          process.exit(1);
+        }
+        const result = await moveProject(newPath, process.cwd());
+        if (result.success) {
+          const r = result.data;
+          cliOutput(
+            formatSuccessSection("Project Moved", "\u2705", [
+              `Project ID:  ${r.projectId}`,
+              `Old path:    ${r.oldPath}`,
+              `New path:    ${r.newPath}`,
+              `New hash:    ${r.newProjectHash}`,
+              `Registry:    ${r.reconcileStatus}`
+            ]),
+            { command: "project", operation: "project.move" }
+          );
+        } else {
+          cliOutput(
+            formatErrorSection(result.error.code, result.error.message, { fix: result.error.fix }),
+            { command: "project", operation: "project.move" }
+          );
+          process.exit(1);
+        }
+      }
+    });
+    renameSubCommand = defineCommand({
+      meta: { name: "rename", description: "Rename this project." },
+      args: {
+        newName: { type: "positional", description: "New project name.", required: true },
+        "dry-run": { type: "boolean", description: "Validate without applying.", default: false },
+        json: { type: "boolean", description: "Output raw JSON envelope.", default: false }
+      },
+      async run({ args }) {
+        const newName = args["newName"];
+        const dryRun = args["dry-run"] ?? false;
+        const nameRe = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,99}$/;
+        if (!newName || !nameRe.test(newName)) {
+          cliOutput(formatErrorSection("E_VALIDATION", `Invalid project name: "${newName}".`), {
+            command: "project",
+            operation: "project.rename"
+          });
+          process.exit(2);
+        }
+        if (dryRun) {
+          cliOutput(
+            formatSuccessSection("Dry Run", void 0, [
+              `Would rename project to "${newName}".`,
+              "Run without --dry-run to apply."
+            ]),
+            { command: "project", operation: "project.rename" }
+          );
+          return;
+        }
+        const result = await renameProject(newName, process.cwd());
+        if (result.success) {
+          const r = result.data;
+          cliOutput(
+            formatSuccessSection("Project Renamed", "\u2705", [
+              `Project ID:   ${r.projectId}`,
+              `Old name:     ${r.oldName}`,
+              `New name:     ${r.newName}`,
+              `Project hash: ${r.newProjectHash}`
+            ]),
+            { command: "project", operation: "project.rename" }
+          );
+        } else {
+          cliOutput(
+            formatErrorSection(result.error.code, result.error.message, { fix: result.error.fix }),
+            { command: "project", operation: "project.rename" }
+          );
+          process.exit(1);
+        }
+      }
+    });
+    reregisterSubCommand = defineCommand({
+      meta: { name: "re-register", description: "Re-register project with NEXUS." },
+      args: {
+        fix: { type: "boolean", description: "Auto-heal path_updated drift.", default: false },
+        json: { type: "boolean", description: "Output raw JSON envelope.", default: false }
+      },
+      async run() {
+        const result = await projectLifecycle.reregisterProject(process.cwd());
+        if (result.success) {
+          const r = result.data;
+          const icon = r.drifted ? "\u26A0\uFE0F" : "\u2705";
+          const items = [
+            `Project ID:  ${r.projectId}`,
+            `Project root: ${r.projectRoot}`,
+            `Hash:        ${r.projectHash}`,
+            `Status:      ${r.reconcileStatus}`
+          ];
+          if (r.drifted && r.oldPath) items.push(`Old path:    ${r.oldPath}`);
+          cliOutput(
+            formatSuccessSection(
+              r.drifted ? "Project Re-registered (Drift Detected)" : "Project Re-registered",
+              icon,
+              items
+            ),
+            { command: "project", operation: "project.re-register" }
+          );
+        } else {
+          cliOutput(
+            formatErrorSection(result.error.code, result.error.message, { fix: result.error.fix }),
+            { command: "project", operation: "project.re-register" }
+          );
+          process.exit(1);
+        }
+      }
+    });
+    projectCommand = defineCommand({
+      meta: {
+        name: "project",
+        description: "Project lifecycle management (move, rename, re-register)."
+      },
+      subCommands: {
+        move: moveSubCommand,
+        rename: renameSubCommand,
+        "re-register": reregisterSubCommand
+      }
+    });
+  }
+});
+
 // packages/cleo/src/cli/commands/promote.ts
 var promote_exports = {};
 __export(promote_exports, {
@@ -62320,13 +62502,13 @@ var init_relates = __esm({
         }
       },
       async run({ args }) {
-        const input2 = args.file === "-" ? await new Promise((resolve10, reject) => {
+        const input2 = args.file === "-" ? await new Promise((resolve11, reject) => {
           let data = "";
           process.stdin.setEncoding("utf8");
           process.stdin.on("data", (chunk) => {
             data += chunk;
           });
-          process.stdin.on("end", () => resolve10(data));
+          process.stdin.on("end", () => resolve11(data));
           process.stdin.on("error", reject);
         }) : await readFile5(args.file, "utf8");
         const parsed = JSON.parse(input2);
@@ -64958,11 +65140,11 @@ async function runPostUpdateDiagnostics(opts) {
         input: process.stdin,
         output: process.stdout
       });
-      shouldMigrate = await new Promise((resolve10) => {
+      shouldMigrate = await new Promise((resolve11) => {
         rl.question("  Do you want to run the upgrade now? [Y/n] ", (answer) => {
           rl.close();
           const clean = answer.trim().toLowerCase();
-          resolve10(clean === "" || clean === "y" || clean === "yes");
+          resolve11(clean === "" || clean === "y" || clean === "yes");
         });
       });
     }
@@ -66489,7 +66671,7 @@ async function promptOwnerAuthPassword(sessionName) {
     terminal: true
   });
   process.stderr.write(`[cleo] Enter owner-auth password for session "${sessionName}": `);
-  const password = await new Promise((resolve10) => {
+  const password = await new Promise((resolve11) => {
     if (process.stdin.setRawMode) {
       process.stdin.setRawMode(
         true
@@ -66507,10 +66689,10 @@ async function promptOwnerAuthPassword(sessionName) {
           );
         }
         process.stderr.write("\n");
-        resolve10(pw);
+        resolve11(pw);
       } else if (ch === "") {
         process.stderr.write("\n[cleo] Cancelled.\n");
-        resolve10("");
+        resolve11("");
       } else if (ch === "\x7F" || ch === "\b") {
         pw = pw.slice(0, -1);
       } else {
@@ -69587,12 +69769,12 @@ var init_telemetry2 = __esm({
 
 // packages/cleo/src/cli/commands/templates/lib.ts
 import { readFileSync as readFileSync15 } from "node:fs";
-import { isAbsolute as isAbsolute3, resolve as resolve7 } from "node:path";
+import { isAbsolute as isAbsolute3, resolve as resolve8 } from "node:path";
 import { getProjectRoot as getProjectRoot52 } from "@cleocode/core";
 import { resolveSourcePathAbsolute } from "@cleocode/core/templates/registry";
 function resolveProjectRoot6(raw) {
   if (typeof raw === "string" && raw.length > 0) {
-    return isAbsolute3(raw) ? raw : resolve7(process.cwd(), raw);
+    return isAbsolute3(raw) ? raw : resolve8(process.cwd(), raw);
   }
   return getProjectRoot52();
 }
@@ -69613,7 +69795,7 @@ var init_lib = __esm({
 });
 
 // packages/cleo/src/cli/commands/templates/diff.ts
-import { existsSync as existsSync16, readFileSync as readFileSync16 } from "node:fs";
+import { existsSync as existsSync17, readFileSync as readFileSync16 } from "node:fs";
 import { join as join31 } from "node:path";
 import { getTemplateById } from "@cleocode/core/templates/registry";
 function unifiedDiff(a, b) {
@@ -69695,7 +69877,7 @@ var init_diff = __esm({
           process.exit(1 /* GENERAL_ERROR */);
           return;
         }
-        if (!existsSync16(installPath)) {
+        if (!existsSync17(installPath)) {
           const missingResult = {
             id,
             installPath,
@@ -69734,7 +69916,7 @@ ${unifiedDiff("", rendered)}`
 });
 
 // packages/cleo/src/cli/commands/templates/install.ts
-import { existsSync as existsSync17, mkdirSync as mkdirSync5, readFileSync as readFileSync17, writeFileSync as writeFileSync5 } from "node:fs";
+import { existsSync as existsSync18, mkdirSync as mkdirSync5, readFileSync as readFileSync17, writeFileSync as writeFileSync5 } from "node:fs";
 import { dirname as dirname9, join as join32 } from "node:path";
 import { getTemplateById as getTemplateById2 } from "@cleocode/core/templates/registry";
 var templatesInstallCommand;
@@ -69802,7 +69984,7 @@ var init_install = __esm({
           process.exit(1 /* GENERAL_ERROR */);
           return;
         }
-        if (existsSync17(installPath)) {
+        if (existsSync18(installPath)) {
           const current = readFileSync17(installPath, "utf8");
           if (current === rendered) {
             const noopResult = {
@@ -69951,7 +70133,7 @@ var init_show3 = __esm({
 });
 
 // packages/cleo/src/cli/commands/templates/upgrade.ts
-import { existsSync as existsSync18, mkdirSync as mkdirSync6, readFileSync as readFileSync18, writeFileSync as writeFileSync6 } from "node:fs";
+import { existsSync as existsSync19, mkdirSync as mkdirSync6, readFileSync as readFileSync18, writeFileSync as writeFileSync6 } from "node:fs";
 import { dirname as dirname10, join as join33 } from "node:path";
 import { getTemplateById as getTemplateById4 } from "@cleocode/core/templates/registry";
 var templatesUpgradeCommand;
@@ -70027,7 +70209,7 @@ var init_upgrade2 = __esm({
         }
         const previewOnly = args["diff"] === true;
         const accept = args["accept"] === true;
-        const current = existsSync18(installPath) ? readFileSync18(installPath, "utf8") : null;
+        const current = existsSync19(installPath) ? readFileSync18(installPath, "utf8") : null;
         const diffBody = current === null ? "" : current === rendered ? "" : unifiedDiff(current, rendered);
         let outcome;
         let reason;
@@ -71469,7 +71651,7 @@ var upgrade_exports = {};
 __export(upgrade_exports, {
   upgradeCommand: () => upgradeCommand
 });
-import { resolve as resolve8 } from "node:path";
+import { resolve as resolve9 } from "node:path";
 import { CleoError as CleoError10, diagnoseUpgrade, runUpgrade as runUpgrade2, upgradeWorkflows as upgradeWorkflows2 } from "@cleocode/core/internal";
 var workflowsSubcommand, upgradeCommand;
 var init_upgrade3 = __esm({
@@ -71509,7 +71691,7 @@ var init_upgrade3 = __esm({
           const dryRun = args["dry-run"] === true || args.check === true;
           const force = args.force === true && !dryRun;
           const result = await upgradeWorkflows2({
-            projectRoot: resolve8(process.cwd()),
+            projectRoot: resolve9(process.cwd()),
             templatesDir: getWorkflowTemplatesDir2(),
             dryRun,
             force
@@ -71875,7 +72057,7 @@ Logs: ${logFile}`
       }
     } catch {
     }
-    await new Promise((resolve10) => setTimeout(resolve10, 500));
+    await new Promise((resolve11) => setTimeout(resolve11, 500));
   }
   if (!started) {
     try {
@@ -71952,7 +72134,7 @@ var init_web = __esm({
           }
           for (let i = 0; i < 60; i++) {
             if (!isProcessRunning(status.pid)) break;
-            await new Promise((resolve10) => setTimeout(resolve10, 500));
+            await new Promise((resolve11) => setTimeout(resolve11, 500));
           }
           if (isProcessRunning(status.pid)) {
             try {
@@ -72004,7 +72186,7 @@ var init_web = __esm({
             }
             for (let i = 0; i < 60; i++) {
               if (!isProcessRunning(status.pid)) break;
-              await new Promise((resolve10) => setTimeout(resolve10, 500));
+              await new Promise((resolve11) => setTimeout(resolve11, 500));
             }
             if (isProcessRunning(status.pid)) {
               try {
@@ -72100,7 +72282,7 @@ __export(workgraph_exports, {
   workgraphCommand: () => workgraphCommand
 });
 import { readFileSync as readFileSync20 } from "node:fs";
-import { resolve as resolve9 } from "node:path";
+import { resolve as resolve10 } from "node:path";
 var validateCommand10, applyCommand, planCommand4, structureCommand, workgraphCommand;
 var init_workgraph2 = __esm({
   "packages/cleo/src/cli/commands/workgraph.ts"() {
@@ -72121,7 +72303,7 @@ var init_workgraph2 = __esm({
       async run({ args }) {
         const { validateWorkGraphScaffold } = await import("@cleocode/core/workgraph");
         const { cliOutput: cliOutput2 } = await Promise.resolve().then(() => (init_renderers(), renderers_exports));
-        const filePath = resolve9(String(args.file));
+        const filePath = resolve10(String(args.file));
         let raw;
         try {
           raw = readFileSync20(filePath, "utf-8");
@@ -72166,7 +72348,7 @@ var init_workgraph2 = __esm({
       async run({ args }) {
         const { applyWorkGraphScaffold } = await import("@cleocode/core/workgraph");
         const { cliOutput: cliOutput2 } = await Promise.resolve().then(() => (init_renderers(), renderers_exports));
-        const filePath = resolve9(String(args.file));
+        const filePath = resolve10(String(args.file));
         let raw;
         try {
           raw = readFileSync20(filePath, "utf-8");
@@ -72273,12 +72455,12 @@ __export(worktree_exports, {
 import readline4 from "node:readline";
 import { getProjectRoot as getProjectRoot55, listWorktrees as listWorktrees2 } from "@cleocode/core/internal";
 async function promptYesNo2(question) {
-  return new Promise((resolve10) => {
+  return new Promise((resolve11) => {
     const rl = readline4.createInterface({ input: process.stdin, output: process.stdout });
     rl.question(`${question} [y/N]: `, (answer) => {
       rl.close();
       const trimmed = answer.trim().toLowerCase();
-      resolve10(trimmed === "y" || trimmed === "yes");
+      resolve11(trimmed === "y" || trimmed === "yes");
     });
   });
 }
@@ -73199,6 +73381,12 @@ var COMMAND_MANIFEST = [
     description: "Playbook runtime operations (run, status, resume, list, create, validate)",
     load: async () => (await Promise.resolve().then(() => (init_playbook3(), playbook_exports))).playbookCommand
   },
+  {
+    exportName: "projectCommand",
+    name: "project",
+    description: "Project lifecycle management (move, rename, re-register).",
+    load: async () => (await Promise.resolve().then(() => (init_project(), project_exports))).projectCommand
+  },
   {
     exportName: "promoteCommand",
     name: "promote",
@@ -73653,14 +73841,14 @@ function lazyCommand(meta, loader2) {
 init_did_you_mean();
 
 // packages/cleo/src/cli/lib/first-run-detection.ts
-import { existsSync as existsSync19 } from "node:fs";
+import { existsSync as existsSync20 } from "node:fs";
 import { join as join36 } from "node:path";
 async function detectFirstRun() {
   const envKey = process.env["ANTHROPIC_API_KEY"];
   if (typeof envKey === "string" && envKey.length > 0) return false;
   const { getCleoPlatformPaths } = await import("@cleocode/paths");
   const configPath = join36(getCleoPlatformPaths().config, "config.json");
-  if (existsSync19(configPath)) return false;
+  if (existsSync20(configPath)) return false;
   try {
     const { getCredentialPool } = await import("@cleocode/core/llm/credential-pool.js");
     const pool = getCredentialPool();
@@ -73671,7 +73859,7 @@ async function detectFirstRun() {
   return true;
 }
 function waitForEnterOrTimeout(timeoutMs) {
-  return new Promise((resolve10) => {
+  return new Promise((resolve11) => {
     let resolved = false;
     const finish = () => {
       if (resolved) return;
@@ -73683,7 +73871,7 @@ function waitForEnterOrTimeout(timeoutMs) {
         process.stdin.pause();
       } catch {
       }
-      resolve10();
+      resolve11();
     };
     const onData = (chunk) => {
       const s = typeof chunk === "string" ? chunk : chunk.toString("utf8");