@delorenj/pjangler 1.5.35 → 1.5.37

package/dist/index.js

@@ -343,8 +343,8 @@ var init_types = __esm({
     CREDENTIAL_KEY = /(?:^|[_-])(?:password|passwd|api[_-]?key|access[_-]?token|refresh[_-]?token|client[_-]?secret|private[_-]?key|credential|authorization)(?:$|[_-])/iu;
     SECRET_SHAPED_VALUE = /(?:-----BEGIN (?:RSA |EC |OPENSSH )?PRIVATE KEY-----|(?<![A-Za-z0-9])eyJ[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}\.[A-Za-z0-9_-]{8,}(?![A-Za-z0-9])|AKIA[0-9A-Z]{16}|gh[pousr]_[A-Za-z0-9]{20,}|(?:password|api[_-]?key|access[_-]?token|client[_-]?secret)\s*[:=]\s*[^\s]{8,})/iu;
     NotebookError = class extends Error {
-      constructor(code, message, retryable = false, details = {}, options) {
-        super(message, options);
+      constructor(code, message2, retryable = false, details = {}, options) {
+        super(message2, options);
         this.code = code;
         this.retryable = retryable;
         this.details = details;
@@ -501,8 +501,8 @@ var init_manifestIndex = __esm({
     init_registryClient();
     init_notebookSettingsValidation();
     RegistryError = class extends Error {
-      constructor(message, status = 422, code = "invalid_manifest") {
-        super(message);
+      constructor(message2, status = 422, code = "invalid_manifest") {
+        super(message2);
         this.status = status;
         this.code = code;
       }
@@ -1023,8 +1023,8 @@ var init_boardQuery = __esm({
     init_version();
     BOARD_PROVIDERS = ["plane", "trello", "linear"];
     BoardError = class extends Error {
-      constructor(message) {
-        super(message);
+      constructor(message2) {
+        super(message2);
         this.name = "BoardError";
       }
     };
@@ -4561,14 +4561,14 @@ function parseNote(value, noteMaxBytes) {
   if (note.content === null) throw new NotebookError("REMOTE_PROTOCOL_ERROR", "Open Notebook returned invalid note content");
   return note;
 }
-function errorForStatus(status, message) {
-  if (status === 400 || status === 422) return new NotebookError("INVALID_INPUT", message, false, { http_status: status, definitive_rejection: true });
-  if (status === 401 || status === 403) return new NotebookError("AUTHENTICATION_FAILED", message);
-  if (status === 404) return new NotebookError("NOT_FOUND", message);
-  if (status === 409) return new NotebookError("CONFLICT", message);
-  if (status === 429) return new NotebookError("THROTTLED", message, true);
-  if (status >= 500) return new NotebookError("SERVICE_UNAVAILABLE", message, true);
-  return new NotebookError("REMOTE_PROTOCOL_ERROR", message);
+function errorForStatus(status, message2) {
+  if (status === 400 || status === 422) return new NotebookError("INVALID_INPUT", message2, false, { http_status: status, definitive_rejection: true });
+  if (status === 401 || status === 403) return new NotebookError("AUTHENTICATION_FAILED", message2);
+  if (status === 404) return new NotebookError("NOT_FOUND", message2);
+  if (status === 409) return new NotebookError("CONFLICT", message2);
+  if (status === 429) return new NotebookError("THROTTLED", message2, true);
+  if (status >= 500) return new NotebookError("SERVICE_UNAVAILABLE", message2, true);
+  return new NotebookError("REMOTE_PROTOCOL_ERROR", message2);
 }
 async function readResponseBody(response, maxBytes) {
   const declared = Number(response.headers.get("content-length") ?? "0");
@@ -6063,9 +6063,9 @@ var init_capture = __esm({
 });
 
 // src/index.ts
-import { spawnSync as spawnSync17 } from "node:child_process";
-import { existsSync as existsSync26, readdirSync as readdirSync12, readFileSync as readFileSync29, statSync as statSync8 } from "node:fs";
-import { basename as basename11, join as join34, resolve as resolve25 } from "node:path";
+import { spawnSync as spawnSync18 } from "node:child_process";
+import { existsSync as existsSync27, readdirSync as readdirSync13, readFileSync as readFileSync30, statSync as statSync9 } from "node:fs";
+import { basename as basename11, join as join35, resolve as resolve25 } from "node:path";
 import { Command as Command3, CommanderError, Option } from "commander";
 
 // src/recipes/Recipe.ts
@@ -6083,8 +6083,8 @@ var Command = class {
   /**
    * Format message with [DRY RUN] prefix if in dry-run mode
    */
-  formatMessage(message) {
-    return this.context.dryRun ? `[DRY RUN] ${message}` : message;
+  formatMessage(message2) {
+    return this.context.dryRun ? `[DRY RUN] ${message2}` : message2;
   }
   fileExists(filePath) {
     const fullPath = join(this.context.targetDir, filePath);
@@ -9884,11 +9884,11 @@ async function runDeclaredBmadUpdate(root, options, scope) {
     try {
       sb = captureScopedBackup(root, scope);
     } catch (error) {
-      const message = error instanceof UnreadableSurfaceError ? error.message : `could not capture the BMAD update surface: ${error instanceof Error ? error.message : String(error)}`;
+      const message2 = error instanceof UnreadableSurfaceError ? error.message : `could not capture the BMAD update surface: ${error instanceof Error ? error.message : String(error)}`;
       return {
         ok: false,
-        error: message,
-        details: [message, "No eviction or installer ran; nothing was written.", scopeNote],
+        error: message2,
+        details: [message2, "No eviction or installer ran; nothing was written.", scopeNote],
         changedFiles: [],
         companion: preflight
       };
@@ -10133,8 +10133,8 @@ function scanToml(text2) {
   let i = 0;
   let line = 0;
   let table = -1;
-  const fail2 = (message) => {
-    throw new TomlScanError(`line ${line + 1}: ${message}`);
+  const fail2 = (message2) => {
+    throw new TomlScanError(`line ${line + 1}: ${message2}`);
   };
   const skipBlank = () => {
     while (i < n && (text2[i] === " " || text2[i] === "	" || text2[i] === "\r")) i++;
@@ -14598,6 +14598,18 @@ init_project();
 import { spawnSync as spawnSync14 } from "node:child_process";
 import { existsSync as existsSync18, lstatSync as lstatSync16, readFileSync as readFileSync22, rmSync as rmSync8 } from "node:fs";
 import { dirname as dirname18, isAbsolute as isAbsolute10, join as join24, relative as relativePath, resolve as resolve19 } from "node:path";
+
+// src/project/ticketScope.ts
+function ticketScope(ticket) {
+  const block = ticket !== null && typeof ticket === "object" ? ticket : {};
+  const label = typeof block.scope_label === "string" ? block.scope_label.trim() : "";
+  return {
+    ...label ? { scope_label: label } : {},
+    ...block.scope_default === true ? { scope_default: true } : {}
+  };
+}
+
+// src/recipes/ProjectRecipe.ts
 init_tree_diff();
 
 // src/recipes/NotebookRecipe.ts
@@ -15666,8 +15678,8 @@ function installProjectNotebookIntegration(input = {}) {
   return { skill, hooksChanged: /\bchanged\b/u.test(result2.stdout) };
 }
 function boundedDiagnostic(value, max = 512) {
-  const message = value instanceof NotebookError ? value.message : "Project Notebook encountered an unexpected internal error";
-  return message.replace(/[\u0000-\u001f\u007f]/gu, " ").replace(/\s+/gu, " ").slice(0, max);
+  const message2 = value instanceof NotebookError ? value.message : "Project Notebook encountered an unexpected internal error";
+  return message2.replace(/[\u0000-\u001f\u007f]/gu, " ").replace(/\s+/gu, " ").slice(0, max);
 }
 function parsePayload(value, maxBytes) {
   if (Buffer.byteLength(value, "utf8") > maxBytes) throw new NotebookError("INVALID_INPUT", "Hook payload exceeds its configured ceiling");
@@ -16563,8 +16575,8 @@ var NotebookRecipe = class extends Recipe {
       return { recipeId: this.metadata.id, ok: true, dryRun: Boolean(ctx.dryRun), changedFiles: [], logs: ["notebook: local skill/hooks skipped"], errors: [], phases: [{ id: "notebook.local", status: "skipped", changedFiles: [], message: "Notebook is disabled or this is a plan-only invocation" }] };
     }
     if (notebookPlan.remote_effect === "none") {
-      const message = `Notebook has no configured endpoint (${notebookPlan.reason}); global skill and hook projection deferred to \`pj notebook migrate --apply\``;
-      return { recipeId: this.metadata.id, ok: true, dryRun: false, changedFiles: [], logs: [`notebook: ${message}`], errors: [], phases: [{ id: "notebook.local", status: "skipped", changedFiles: [], message }] };
+      const message2 = `Notebook has no configured endpoint (${notebookPlan.reason}); global skill and hook projection deferred to \`pj notebook migrate --apply\``;
+      return { recipeId: this.metadata.id, ok: true, dryRun: false, changedFiles: [], logs: [`notebook: ${message2}`], errors: [], phases: [{ id: "notebook.local", status: "skipped", changedFiles: [], message: message2 }] };
     }
     try {
       const env2 = integrationEnvironment(this.module, ctx);
@@ -16593,8 +16605,8 @@ var NotebookRecipe = class extends Recipe {
         phases: [{ id: "notebook.local", status: applied.changedFiles.length ? "changed" : "unchanged", changedFiles: applied.changedFiles, message: "Canonical Project Notebook skill and hooks verified" }]
       };
     } catch (error) {
-      const message = error instanceof Error ? error.message : String(error);
-      return { recipeId: this.metadata.id, ok: false, dryRun: false, changedFiles: [], logs: [], errors: [message], phases: [{ id: "notebook.local", status: "failed", changedFiles: [], message }] };
+      const message2 = error instanceof Error ? error.message : String(error);
+      return { recipeId: this.metadata.id, ok: false, dryRun: false, changedFiles: [], logs: [], errors: [message2], phases: [{ id: "notebook.local", status: "failed", changedFiles: [], message: message2 }] };
     }
   }
   async applyExternal(plan, notebookPlan) {
@@ -16720,6 +16732,7 @@ function refreshPlanFromCanonicalManifest(plan) {
     ...carriesProvenance && identifierSource === "provider" && recorded?.identifier_fetched_at ? { identifier_fetched_at: recorded.identifier_fetched_at } : {},
     board_id: manifestBoardId,
     ...boardConfirmedAt ? { board_confirmed_at: boardConfirmedAt } : {},
+    ...ticketScope(manifestTicket),
     state: manifestState === "skipped" ? "skipped" : manifestBoardId && boardConfirmedAt && keyIsProven ? "linked" : "planned"
   };
   plan.manifest = manifest;
@@ -17077,8 +17090,8 @@ var ProjectRecipe = class extends Recipe {
       } else try {
         rmSync8(targetDir, { recursive: true, force: true });
         const insideTarget = (path) => {
-          const relative16 = relativePath(resolve19(targetDir), resolve19(path));
-          return relative16 === "" || !relative16.startsWith("..") && !isAbsolute10(relative16);
+          const relative17 = relativePath(resolve19(targetDir), resolve19(path));
+          return relative17 === "" || !relative17.startsWith("..") && !isAbsolute10(relative17);
         };
         const orphaned = [...new Set(changedFiles.filter((path) => !insideTarget(path)))].sort();
         changedFiles.length = 0;
@@ -18231,6 +18244,43 @@ async function fetchPlaneBoards(workspace, env2 = process.env, home = homedir12(
   }
   return boards;
 }
+async function patchPlaneBoardIdentifier(workspace, boardId, identifier, env2 = process.env, home = homedir12()) {
+  const apiKey = planeApiKeyFor(workspace, env2, home);
+  if (!apiKey) {
+    throw new BoardError(
+      `no Plane API key for workspace "${workspace}": set PLANE_API_KEY, or add one to ${env2.HERMES_FLEET_ENV?.trim() || join30(home, ".hermes", "fleet.env")}`
+    );
+  }
+  const base = planeBase(env2, home);
+  const url = `${base}/api/v1/workspaces/${encodeURIComponent(workspace)}/projects/${encodeURIComponent(boardId)}/`;
+  let response;
+  try {
+    response = await fetch(url, {
+      method: "PATCH",
+      headers: {
+        "X-API-Key": apiKey,
+        "User-Agent": `pjangler/${PJANGLER_VERSION}`,
+        "Content-Type": "application/json"
+      },
+      body: JSON.stringify({ identifier }),
+      signal: AbortSignal.timeout(2e4)
+    });
+  } catch (error) {
+    throw new BoardError(
+      `could not reach Plane at ${base} to rename board ${boardId}: ` + (error instanceof Error ? error.message : String(error))
+    );
+  }
+  if (!response.ok) {
+    let detail = "";
+    try {
+      detail = (await response.text()).replace(/\s+/g, " ").trim().slice(0, 200);
+    } catch {
+    }
+    throw new BoardError(
+      `Plane refused identifier "${identifier}" for board ${boardId} (HTTP ${response.status})${detail ? `: ${detail}` : ""}`
+    );
+  }
+}
 function trelloCredential(name, env2, home) {
   const fleetEnv = env2.HERMES_FLEET_ENV?.trim() || join30(home, ".hermes", "fleet.env");
   const raw = env2[name]?.trim() || dotenvValue(fleetEnv, name)?.trim();
@@ -18931,19 +18981,499 @@ async function linkProjectBoard(options) {
   };
 }
 
+// src/project/rename.ts
+init_boardUrl();
+import { spawnSync as spawnSync15 } from "node:child_process";
+import { existsSync as existsSync22, readdirSync as readdirSync11, readFileSync as readFileSync27, realpathSync as realpathSync11, statSync as statSync6 } from "node:fs";
+import { homedir as homedir13 } from "node:os";
+import { isAbsolute as isAbsolute11, join as join31, relative as relative16 } from "node:path";
+import YAML8 from "yaml";
+init_project();
+init_registryClient();
+var KEY_PATTERN = /^[a-z0-9]{1,12}$/;
+var RenameError = class extends Error {
+  constructor(code, message2) {
+    super(message2);
+    this.code = code;
+    this.name = "RenameError";
+  }
+};
+function isRecord7(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function message(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+function readJsonObject(path) {
+  let parsed;
+  try {
+    parsed = JSON.parse(readFileSync27(path, "utf8"));
+  } catch {
+    throw new RenameError("manifest_invalid", `${path} is not readable JSON; fix it before renaming`);
+  }
+  if (!isRecord7(parsed)) throw new RenameError("manifest_invalid", `${path} must hold a JSON object`);
+  return parsed;
+}
+function escapeRegExp2(value) {
+  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+var YAML_WORDS = /* @__PURE__ */ new Set(["Y", "N", "YES", "NO", "ON", "OFF", "NULL", "TRUE", "FALSE"]);
+function yamlScalarFor(identifier, originalSlice) {
+  const plainSafe = /^[A-Z][A-Z0-9]*$/.test(identifier) && !YAML_WORDS.has(identifier);
+  if (originalSlice.startsWith("'") && !originalSlice.startsWith("''")) return `'${identifier}'`;
+  if (originalSlice.startsWith('"')) return `"${identifier}"`;
+  return plainSafe ? identifier : `"${identifier}"`;
+}
+async function renameProject(options) {
+  const newId = String(options.newId ?? "").trim().toLowerCase();
+  if (!KEY_PATTERN.test(newId)) {
+    throw new RenameError(
+      "invalid_key",
+      `invalid key ${JSON.stringify(String(options.newId ?? ""))}: use 1-12 lowercase letters and digits (Plane identifiers are alphanumeric, max 12)`
+    );
+  }
+  const NEW = newId.toUpperCase();
+  const oldInput = String(options.oldId ?? "").trim().toLowerCase();
+  const env2 = options.env ?? process.env;
+  const home = options.home ?? homedir13();
+  const apply = options.apply ?? false;
+  const now = (options.now ?? /* @__PURE__ */ new Date()).toISOString();
+  const registryPath = resolveRegistryLocation(options.registryPath, env2);
+  const service = isRegistryServiceLocation(registryPath);
+  const warnings = [];
+  let registry;
+  try {
+    registry = loadProjectRegistry(registryPath);
+  } catch (error) {
+    throw new RenameError("registry_unavailable", message(error));
+  }
+  let oldId = oldInput;
+  let resumed = false;
+  let renamedFromIdentifier = "";
+  let project = oldInput ? getOwnRecordValue(registry.projects, oldInput) : void 0;
+  if (project) {
+    if (oldInput !== newId && getOwnRecordValue(registry.projects, newId)) {
+      throw new RenameError("identity_collision", `project_id "${newId}" is already registered to another project`);
+    }
+  } else {
+    const existing = getOwnRecordValue(registry.projects, newId);
+    let from;
+    if (existing && oldInput) {
+      try {
+        const candidate = readJsonObject(join31(existing.repo_path, ".project.json")).renamed_from;
+        if (isRecord7(candidate)) from = candidate;
+      } catch {
+      }
+    }
+    if (!existing || !from || from.project_id !== oldInput) {
+      throw new RenameError("unknown_project", `Project not found in registry: ${options.oldId}`);
+    }
+    project = existing;
+    resumed = true;
+    renamedFromIdentifier = typeof from.identifier === "string" ? from.identifier : "";
+  }
+  const record3 = project;
+  const provider = record3.ticket_provider;
+  const type = String(provider.type ?? "").trim().toLowerCase();
+  const boardId = String(provider.board_id ?? "").trim();
+  const isPlane = type === "plane";
+  const workspace = isPlane ? String(provider.workspace ?? "").trim() || DEFAULT_PLANE_WORKSPACE : String(provider.workspace ?? "").trim();
+  const repoPath = record3.repo_path;
+  const manifestPath = join31(repoPath, ".project.json");
+  const manifestExists = existsSync22(manifestPath);
+  if (service && !manifestExists) {
+    throw new RenameError("manifest_missing", `${manifestPath} is missing; the registry service indexes manifests, so there is nothing to rename`);
+  }
+  const manifestBefore = manifestExists ? readJsonObject(manifestPath) : void 0;
+  const fetchBoards = options.fetchBoards ?? ((ws) => fetchPlaneBoards(ws, env2, home));
+  let live;
+  if (isPlane && boardId) {
+    let boards;
+    try {
+      boards = await fetchBoards(workspace);
+    } catch (error) {
+      throw new RenameError("provider_unreachable", message(error));
+    }
+    live = boards.get(boardId);
+    if (!live) throw new RenameError("board_not_found", `Plane workspace "${workspace}" has no board ${boardId}`);
+    if (live.archived) {
+      throw new RenameError("board_archived", `Plane board ${boardId} ("${live.name}") is archived; an archived board answers but is not usable`);
+    }
+    const owner = liveKeyIndex(boards).get(NEW);
+    if (owner && owner.id !== boardId) {
+      throw new RenameError("identity_collision", `board identifier ${NEW} already belongs to Plane board ${owner.id} ("${owner.name}") in workspace "${workspace}"`);
+    }
+  } else if (type === "trello" && boardId) {
+    try {
+      const facts = await (options.fetchTrello ?? ((id) => fetchTrelloBoard(id, env2, home)))(boardId);
+      if (!facts) throw new RenameError("board_not_found", `Trello has no visible board ${boardId}`);
+      if (facts.closed) throw new RenameError("board_archived", `Trello board ${boardId} ("${facts.name}") is archived`);
+    } catch (error) {
+      if (error instanceof RenameError) throw error;
+      warnings.push(`Trello board ${boardId} could not be verified (${message(error)}); renamed locally`);
+    }
+  }
+  const manifestProvider = manifestBefore?.ticket_provider;
+  const manifestIdentifier = isRecord7(manifestProvider) ? String(manifestProvider.identifier ?? "") : "";
+  const oldIdentifiers = [
+    ...new Set(
+      [String(provider.identifier ?? ""), manifestIdentifier, live?.identifier ?? "", renamedFromIdentifier].map((value) => value.trim()).filter((value) => value && value.toUpperCase() !== NEW)
+    )
+  ];
+  const oldIdentifier = oldIdentifiers[0] ?? "";
+  const providerConfirmed = isPlane && Boolean(boardId);
+  function nextProvider(current) {
+    if (!current.identifier && !providerConfirmed) return current;
+    const next = { ...current, identifier: NEW };
+    if (providerConfirmed) {
+      const unchanged = String(current.identifier ?? "").toUpperCase() === NEW && current.identifier_source === "provider" && typeof current.identifier_fetched_at === "string" && current.identifier_fetched_at !== "";
+      next.identifier_source = "provider";
+      next.identifier_fetched_at = unchanged ? current.identifier_fetched_at : now;
+    }
+    return next;
+  }
+  const planeCall = options.patchBoard ?? ((ws, id, identifier) => patchPlaneBoardIdentifier(ws, id, identifier, env2, home));
+  const planeStep = async (doApply) => {
+    if (!isPlane) return { status: "skipped", detail: type === "trello" ? "trello assigns no key; no provider write" : "no Plane board; no provider write" };
+    if (!boardId || !live) return { status: "skipped", detail: "no board bound; nothing to rename at the provider" };
+    if (live.identifier.toUpperCase() === NEW) return { status: "already", detail: `board ${boardId} already reads ${live.identifier}` };
+    if (!doApply) return { status: "planned", detail: `Plane board ${boardId}: ${live.identifier} -> ${NEW}` };
+    let patchError;
+    try {
+      await planeCall(workspace, boardId, NEW);
+    } catch (error) {
+      patchError = message(error);
+    }
+    try {
+      const after = (await fetchBoards(workspace)).get(boardId);
+      if (after && after.identifier.toUpperCase() === NEW) {
+        return { status: "done", detail: `Plane board ${boardId}: ${live.identifier} -> ${NEW}${patchError ? ` (the PATCH reported: ${patchError})` : ""}` };
+      }
+      if (patchError) {
+        return { status: "failed", detail: `${patchError}; the board still reads ${after?.identifier ?? "(missing)"}, but the request may yet land: re-running is safe` };
+      }
+      return { status: "failed", detail: `Plane accepted the rename but board ${boardId} reads ${after?.identifier ?? "(missing)"}` };
+    } catch (error) {
+      return {
+        status: "failed",
+        detail: `${patchError ? `${patchError}; ` : ""}the read-back failed (${message(error)}), so the outcome is unknown; re-running is safe`
+      };
+    }
+  };
+  const manifestStep = async (doApply) => {
+    if (!manifestExists) return { status: "skipped", detail: `no .project.json at ${repoPath}` };
+    let current;
+    try {
+      current = readJsonObject(manifestPath);
+    } catch (error) {
+      return { status: "failed", detail: message(error) };
+    }
+    const next = { ...current, project_id: newId };
+    delete next.project_slug;
+    if (isRecord7(current.ticket_provider)) next.ticket_provider = nextProvider(current.ticket_provider);
+    if (!resumed && (oldId !== newId || oldIdentifier !== "")) {
+      const previous = current.renamed_from;
+      const same = isRecord7(previous) && previous.project_id === oldId && String(previous.identifier ?? "") === oldIdentifier;
+      next.renamed_from = same ? previous : { project_id: oldId, ...oldIdentifier ? { identifier: oldIdentifier } : {}, at: now };
+    }
+    if (JSON.stringify(next) === JSON.stringify(current)) {
+      return { status: "already", detail: `project_id ${newId}, identifier ${NEW}` };
+    }
+    const detail = `project_id ${String(current.project_id ?? current.project_slug ?? "(none)")} -> ${newId}, identifier -> ${NEW}`;
+    if (!doApply) return { status: "planned", detail, files: [manifestPath] };
+    try {
+      atomicWrite(manifestPath, `${JSON.stringify(next, null, 2)}
+`);
+    } catch (error) {
+      return { status: "failed", detail: `could not write ${manifestPath}: ${message(error)}` };
+    }
+    return { status: "done", detail, files: [manifestPath] };
+  };
+  const registryStep = async (doApply) => {
+    const identifierNow = (r) => String(r?.ticket_provider?.identifier ?? "").toUpperCase();
+    const keyed = getOwnRecordValue(registry.projects, newId);
+    const keyedIdentifier = identifierNow(keyed);
+    const settled = Boolean(keyed) && (oldId === newId || !getOwnRecordValue(registry.projects, oldId)) && (keyedIdentifier === NEW || keyedIdentifier === "" && !providerConfirmed);
+    if (settled) return { status: "already", detail: `registry already keys ${newId}` };
+    const detail = `${oldId} -> ${newId}${service ? " (service re-index)" : ""}`;
+    if (!doApply) return { status: "planned", detail };
+    try {
+      if (service) {
+        registryRequest(registryPath, "POST", "/v1/index", { manifest_path: manifestPath });
+        const after = loadProjectRegistry(registryPath);
+        if (!getOwnRecordValue(after.projects, newId)) throw new Error(`the service index does not list ${newId} after re-indexing`);
+        if (oldId !== newId && getOwnRecordValue(after.projects, oldId)) throw new Error(`the service index still lists ${oldId} after re-indexing`);
+      } else {
+        const fresh = loadProjectRegistry(registryPath);
+        const current = getOwnRecordValue(fresh.projects, oldId);
+        if (!current) throw new Error(`${oldId} vanished from ${registryPath} mid-rename`);
+        const renamed = {
+          ...current,
+          slug: newId,
+          ...Object.hasOwn(current, "project_id") ? { project_id: newId } : {},
+          ticket_provider: nextProvider(current.ticket_provider),
+          updated_at: now
+        };
+        delete fresh.projects[oldId];
+        fresh.projects[newId] = renamed;
+        saveProjectRegistry(fresh, registryPath);
+      }
+    } catch (error) {
+      return { status: "failed", detail: message(error) };
+    }
+    return { status: "done", detail, files: service ? [] : [registryPath] };
+  };
+  const roleStep = async (doApply) => {
+    const hermesDir = join31(repoPath, "agents", "hermes");
+    if (!existsSync22(hermesDir)) return { status: "skipped", detail: "no agents/hermes directory" };
+    if (!isPlane) return { status: "skipped", detail: "role.yaml plane.identifier is a Plane field" };
+    const files = [];
+    let touched2 = 0;
+    let settled = 0;
+    let entries;
+    try {
+      entries = readdirSync11(hermesDir, { withFileTypes: true });
+    } catch (error) {
+      return { status: "failed", detail: `${hermesDir}: ${message(error)}` };
+    }
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      const path = join31(hermesDir, entry.name, "role.yaml");
+      if (!existsSync22(path)) continue;
+      try {
+        const original = readFileSync27(path, "utf8");
+        const document = YAML8.parseDocument(original);
+        if (document.errors.length) throw new Error("YAML is invalid");
+        const node = document.getIn(["plane", "identifier"], true);
+        if (!YAML8.isScalar(node) || !node.range) continue;
+        if (String(node.value) === NEW) {
+          settled += 1;
+          continue;
+        }
+        touched2 += 1;
+        files.push(path);
+        if (!doApply) continue;
+        const [start, end] = node.range;
+        const text2 = `${original.slice(0, start)}${yamlScalarFor(NEW, original.slice(start, end))}${original.slice(end)}`;
+        const before = document.toJS();
+        const after = YAML8.parse(text2);
+        if (isRecord7(before.plane)) before.plane.identifier = NEW;
+        if (JSON.stringify(after) !== JSON.stringify(before)) throw new Error("the edit changed more than plane.identifier");
+        atomicWrite(path, text2);
+      } catch (error) {
+        return { status: "failed", detail: `${path}: ${message(error)}` };
+      }
+    }
+    if (!touched2 && !settled) return { status: "skipped", detail: "no role.yaml carries plane.identifier" };
+    if (!touched2) return { status: "already", detail: `${settled} role.yaml already read ${NEW}` };
+    return { status: doApply ? "done" : "planned", detail: `${touched2} role.yaml: plane.identifier -> ${NEW}`, files };
+  };
+  const fleetStep = async (doApply) => {
+    if (!isPlane || !boardId) return { status: "skipped", detail: "no Plane board bound" };
+    const hermesPath = hermesAgentsRegistryPath(env2, home);
+    if (!existsSync22(hermesPath)) return { status: "skipped", detail: `no fleet registry at ${hermesPath}` };
+    try {
+      const bound = readHermesAgentBoards(hermesPath).filter((agent) => agent.boardId === boardId);
+      if (!bound.length) return { status: "skipped", detail: "no fleet agent is bound to this board" };
+      const stale = bound.filter((agent) => agent.identifier !== NEW);
+      if (!stale.length) return { status: "already", detail: `${bound.length} fleet agent(s) already read ${NEW}` };
+      if (!doApply) return { status: "planned", detail: `${stale.length} fleet agent(s): plane.identifier -> ${NEW} (${hermesPath})`, files: [hermesPath] };
+      const report = await reconcileProjectIdentity({
+        target: newId,
+        apply: true,
+        hermesRegistryPath: hermesPath,
+        registryPath,
+        env: env2,
+        home,
+        now: new Date(now),
+        ...options.fetchBoards ? { fetchBoards: options.fetchBoards } : {}
+      });
+      if (!report.ok) return { status: "failed", detail: report.errors.join("; ") || "identity reconcile reported errors" };
+      const lagging = readHermesAgentBoards(hermesPath).filter((agent) => agent.boardId === boardId && agent.identifier !== NEW);
+      if (lagging.length) {
+        return { status: "failed", detail: `fleet agent(s) still read another identifier: ${lagging.map((agent) => `${agent.agentId} (${agent.identifier || "empty"})`).join(", ")}` };
+      }
+      return { status: "done", detail: `${stale.length} fleet agent(s): plane.identifier -> ${NEW} (${hermesPath})`, files: [hermesPath] };
+    } catch (error) {
+      return { status: "failed", detail: message(error) };
+    }
+  };
+  const agentsMdStep = async (doApply) => {
+    const link = join31(repoPath, "AGENTS.md");
+    if (!existsSync22(link)) return { status: "skipped", detail: "no AGENTS.md" };
+    try {
+      const path = realpathSync11(link);
+      const inside = relative16(realpathSync11(repoPath), path);
+      if (inside.startsWith("..") || isAbsolute11(inside)) {
+        return { status: "skipped", detail: `AGENTS.md resolves outside the repo (${path}); left untouched` };
+      }
+      const original = readFileSync27(path, "utf8");
+      const lines = original.split("\n");
+      let boardLines = 0;
+      let replaced = 0;
+      let current = 0;
+      const out = lines.map((line) => {
+        if (!/^\s*Board:/.test(line)) return line;
+        boardLines += 1;
+        if (line.includes(`(${NEW})`)) current += 1;
+        let next = line;
+        for (const old of oldIdentifiers) {
+          const swapped = next.replace(new RegExp(`\\(${escapeRegExp2(old)}\\)`, "g"), `(${NEW})`);
+          if (swapped !== next) {
+            replaced += 1;
+            next = swapped;
+          }
+        }
+        return next;
+      });
+      if (!boardLines) return { status: "skipped", detail: "AGENTS.md has no Board: line" };
+      if (!replaced) {
+        return current ? { status: "already", detail: `Board: line already reads (${NEW})` } : { status: "skipped", detail: `no (${oldIdentifier || "OLD"}) on the Board: line` };
+      }
+      if (doApply) atomicWrite(path, out.join("\n"));
+      return { status: doApply ? "done" : "planned", detail: `Board: (${oldIdentifier}) -> (${NEW})`, files: [path] };
+    } catch (error) {
+      return { status: "failed", detail: message(error) };
+    }
+  };
+  const hintsStep = async (doApply) => {
+    const configDir = env2.PILOT_CONFIG_DIR?.trim() || join31(env2.XDG_CONFIG_HOME?.trim() || join31(home, ".config"), "pilot");
+    const path = join31(configDir, "harvest", "project-hints.json");
+    if (!existsSync22(path)) return { status: "skipped", detail: `no harvest hints at ${path}` };
+    try {
+      const hints = readJsonObject(path);
+      const projects = hints.projects;
+      if (!isRecord7(projects)) return { status: "skipped", detail: "hints file has no projects map" };
+      if (oldId === newId || !Object.hasOwn(projects, oldId)) {
+        return Object.hasOwn(projects, newId) ? { status: "already", detail: `hints already keyed ${newId}` } : { status: "skipped", detail: `no hints entry for ${oldId}` };
+      }
+      const collides = Object.hasOwn(projects, newId);
+      const detail = collides ? `projects.${oldId} merged into the existing projects.${newId}; "${oldId}" kept as an alias` : `projects.${oldId} -> projects.${newId}, "${oldId}" kept as an alias`;
+      if (!doApply) return { status: "planned", detail, files: [path] };
+      const aliasesOf = (value) => isRecord7(value) && Array.isArray(value.aliases) ? value.aliases.map(String) : [];
+      const moved = projects[oldId];
+      const base = collides ? isRecord7(projects[newId]) ? { ...projects[newId] } : {} : isRecord7(moved) ? { ...moved } : {};
+      base.aliases = [.../* @__PURE__ */ new Set([...aliasesOf(collides ? projects[newId] : moved), ...collides ? aliasesOf(moved) : [], oldId])];
+      const rekeyed = {};
+      for (const [key, value] of Object.entries(projects)) {
+        if (key === oldId) {
+          if (!collides) rekeyed[newId] = base;
+        } else if (key === newId) rekeyed[newId] = base;
+        else rekeyed[key] = value;
+      }
+      atomicWrite(path, `${JSON.stringify({ ...hints, projects: rekeyed }, null, 2)}
+`);
+      return { status: "done", detail, files: [path] };
+    } catch (error) {
+      return { status: "failed", detail: message(error) };
+    }
+  };
+  const candystoreStep = async (doApply) => {
+    if (oldInput === newId && steps.every((step) => step.status === "already" || step.status === "skipped")) {
+      return { status: "already", detail: "nothing changed; projection not re-synced" };
+    }
+    const cwd = join31(home, "code", "33GOD", "candystore");
+    try {
+      if (!statSync6(cwd).isDirectory()) throw new Error("not a directory");
+    } catch {
+      return { status: "skipped", detail: `no candystore checkout at ${cwd}` };
+    }
+    if (!doApply) return { status: "planned", detail: `mise run project:sync in ${cwd}` };
+    const run = spawnSync15("mise", ["run", "project:sync"], { cwd, env: env2, shell: false, encoding: "utf8", timeout: 18e4, maxBuffer: 8 * 1024 * 1024 });
+    if (run.error) {
+      return run.error.code === "ENOENT" ? { status: "skipped", detail: "mise is not installed; run `mise run project:sync` in candystore" } : { status: "failed", detail: `mise run project:sync: ${run.error.message}` };
+    }
+    if (run.status !== 0) {
+      const tail = `${run.stderr ?? ""}${run.stdout ?? ""}`.trim().split("\n").slice(-3).join(" | ").slice(0, 300);
+      return { status: "failed", detail: `mise run project:sync exited ${run.status}${tail ? `: ${tail}` : ""}` };
+    }
+    return { status: "done", detail: "candystore project projection re-synced" };
+  };
+  const steps = [];
+  const changedFiles = [];
+  const note = (step, outcome) => {
+    steps.push({ step, status: outcome.status, detail: outcome.detail });
+    if (outcome.status === "done" || outcome.status === "planned") changedFiles.push(...outcome.files ?? []);
+  };
+  const critical = [
+    ["plane", planeStep],
+    ["manifest", manifestStep],
+    ["registry", registryStep]
+  ];
+  let blockedBy;
+  for (const [name, run] of critical) {
+    if (blockedBy) {
+      note(name, { status: "blocked", detail: `not attempted: ${blockedBy} failed` });
+      continue;
+    }
+    const outcome = await run(apply);
+    note(name, outcome);
+    if (outcome.status === "failed") blockedBy = name;
+  }
+  const downstream = [
+    ["role.yaml", roleStep],
+    ["fleet-registry", fleetStep],
+    ["AGENTS.md", agentsMdStep],
+    ["harvest-hints", hintsStep],
+    ["candystore", candystoreStep]
+  ];
+  for (const [name, run] of downstream) {
+    if (blockedBy) note(name, { status: "blocked", detail: `not attempted: ${blockedBy} failed` });
+    else note(name, await run(apply));
+  }
+  const changed = (name) => steps.some((step) => step.step === name && (step.status === "done" || step.status === "planned"));
+  if (oldId !== newId && (changed("manifest") || changed("registry"))) {
+    warnings.push("notebook state is keyed by the project hash and restarts fresh under the new id");
+  }
+  if (isPlane && changed("plane")) {
+    warnings.push(`old ticket refs (${oldIdentifier || "OLD"}-n) stop resolving once the board prefix changes`);
+  }
+  const insideRepo = (file) => {
+    const rel = relative16(repoPath, file);
+    return rel !== "" && !rel.startsWith("..") && !isAbsolute11(rel);
+  };
+  if (changedFiles.some(insideRepo)) {
+    warnings.push(`files changed inside ${repoPath} must be committed and pushed`);
+  }
+  const failed = steps.find((step) => step.status === "failed");
+  const noop = steps.every((step) => step.status === "already" || step.status === "skipped");
+  const result2 = {
+    ok: !failed,
+    apply,
+    noop,
+    resumed,
+    oldId,
+    newId,
+    oldIdentifier,
+    newIdentifier: NEW,
+    provider: type || "none",
+    workspace,
+    boardId,
+    registryPath,
+    steps,
+    warnings,
+    changedFiles: [...new Set(changedFiles)]
+  };
+  if (failed) {
+    result2.error = apply ? `${failed.step} failed: ${failed.detail}; re-run the same command to resume` : `${failed.step} would fail: ${failed.detail}; fix this before running with --apply`;
+    result2.code = "step_failed";
+  }
+  return result2;
+}
+
 // src/index.ts
 init_boardQuery();
 
 // src/describe/activity.ts
-import { spawn as spawn3, spawnSync as spawnSync15 } from "node:child_process";
-import { statSync as statSync6 } from "node:fs";
-import { join as join31 } from "node:path";
+import { spawn as spawn3, spawnSync as spawnSync16 } from "node:child_process";
+import { statSync as statSync7 } from "node:fs";
+import { join as join32 } from "node:path";
 var ACTIVE_WINDOW_SECONDS = 24 * 60 * 60;
 var MAX_DIRTY_STATS = 500;
 var GIT_TIMEOUT_MS = 5e3;
 var GIT_MAX_BUFFER = 16 * 1024 * 1024;
 function git3(repo, args) {
-  const result2 = spawnSync15("git", ["-C", repo, ...args], {
+  const result2 = spawnSync16("git", ["-C", repo, ...args], {
     encoding: "utf8",
     timeout: GIT_TIMEOUT_MS,
     maxBuffer: GIT_MAX_BUFFER
@@ -19102,7 +19632,7 @@ function uncommittedSource(repo, paths) {
   let newest = 0;
   for (const path of paths.slice(0, MAX_DIRTY_STATS)) {
     try {
-      const mtime = Math.floor(statSync6(join31(repo, path)).mtimeMs / 1e3);
+      const mtime = Math.floor(statSync7(join32(repo, path)).mtimeMs / 1e3);
       if (mtime > newest) newest = mtime;
     } catch {
     }
@@ -19300,8 +19830,8 @@ function openUrl(url, env2 = process.env, platform = process.platform) {
 }
 
 // src/describe/index.ts
-import { existsSync as existsSync22, readFileSync as readFileSync27, readdirSync as readdirSync11, statSync as statSync7 } from "node:fs";
-import { join as join32, resolve as resolve23 } from "node:path";
+import { existsSync as existsSync23, readFileSync as readFileSync28, readdirSync as readdirSync12, statSync as statSync8 } from "node:fs";
+import { join as join33, resolve as resolve23 } from "node:path";
 init_project();
 init_config();
 init_state();
@@ -19357,7 +19887,7 @@ var CONFIG_FILES = [
 ];
 function readJson(path) {
   try {
-    const parsed = JSON.parse(readFileSync27(path, "utf8"));
+    const parsed = JSON.parse(readFileSync28(path, "utf8"));
     return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : void 0;
   } catch {
     return void 0;
@@ -19379,23 +19909,23 @@ function describeType(repo) {
   const evidence = [];
   const note = (signal, file) => evidence.push(`${signal} (${file})`);
   for (const marker of LANGUAGE_MARKERS) {
-    if (!existsSync22(join32(repo, marker.file))) continue;
+    if (!existsSync23(join33(repo, marker.file))) continue;
     if (!languages.includes(marker.language)) {
       languages.push(marker.language);
       note(marker.language, marker.file);
     }
   }
   try {
-    const dotnet = readdirSync11(repo).find((entry) => entry.endsWith(".csproj") || entry.endsWith(".sln"));
+    const dotnet = readdirSync12(repo).find((entry) => entry.endsWith(".csproj") || entry.endsWith(".sln"));
     if (dotnet && !languages.includes("dotnet")) {
       languages.push("dotnet");
       note("dotnet", dotnet);
     }
   } catch {
   }
-  const pkg = readJson(join32(repo, "package.json"));
+  const pkg = readJson(join33(repo, "package.json"));
   if (pkg) {
-    if (existsSync22(join32(repo, "tsconfig.json"))) {
+    if (existsSync23(join33(repo, "tsconfig.json"))) {
       const index = languages.indexOf("javascript");
       if (index >= 0) languages.splice(index, 1);
       if (!languages.includes("typescript")) {
@@ -19429,14 +19959,14 @@ function describeType(repo) {
     ["hermes-fleet-host", "agents/hermes"]
   ];
   for (const [role, marker] of roleMarkers) {
-    if (!existsSync22(join32(repo, marker))) continue;
+    if (!existsSync23(join33(repo, marker))) continue;
     roles.push(role);
     note(role, marker);
   }
   return { primaryLanguage: languages[0], languages, roles, evidence };
 }
 function describeIdentity(repo, registryPath) {
-  const manifestPath = join32(repo, ".project.json");
+  const manifestPath = join33(repo, ".project.json");
   const manifest = readJson(manifestPath);
   const drift = [];
   let record3;
@@ -19529,12 +20059,12 @@ function describeSubsystems(repo, findings) {
     const markers = SUBSYSTEM_MARKERS[metadata.id] ?? [];
     const evidence = metadata.id === "notebook" ? (() => {
       try {
-        const manifest = JSON.parse(readFileSync27(join32(repo, ".project.json"), "utf8"));
+        const manifest = JSON.parse(readFileSync28(join33(repo, ".project.json"), "utf8"));
         return manifest.notebook && typeof manifest.notebook === "object" ? [".project.json#notebook"] : [];
       } catch {
         return [];
       }
-    })() : markers.filter((marker) => existsSync22(join32(repo, marker)));
+    })() : markers.filter((marker) => existsSync23(join33(repo, marker)));
     const rules = (byRecipe.get(metadata.id) ?? []).map((finding2) => ({
       id: finding2.id,
       title: finding2.title,
@@ -19553,7 +20083,7 @@ function describeNotebook(repo, registryPath) {
   try {
     const registry = loadProjectRegistry(registryPath);
     const project = Object.values(registry.projects).find((entry) => resolve23(entry.repo_path) === resolve23(repo));
-    const manifest = existsSync22(join32(repo, ".project.json")) ? JSON.parse(readFileSync27(join32(repo, ".project.json"), "utf8")) : void 0;
+    const manifest = existsSync23(join33(repo, ".project.json")) ? JSON.parse(readFileSync28(join33(repo, ".project.json"), "utf8")) : void 0;
     const declared = Boolean(project?.notebook || manifest?.notebook && typeof manifest.notebook === "object");
     if (!declared) return { declared: false, bindingState: null, notebookId: null, overviewNoteId: null, health: null, remoteCheck: "skip", captureAdmission: null };
     const config = loadEffectiveNotebookConfig(repo, registryPath);
@@ -19571,7 +20101,7 @@ function describeNotebook(repo, registryPath) {
   }
 }
 function describeConfigFiles(repo) {
-  return CONFIG_FILES.filter((spec) => existsSync22(join32(repo, spec.path))).map((spec) => ({ path: spec.path, purpose: spec.purpose, subsystem: spec.subsystem }));
+  return CONFIG_FILES.filter((spec) => existsSync23(join33(repo, spec.path))).map((spec) => ({ path: spec.path, purpose: spec.purpose, subsystem: spec.subsystem }));
 }
 function describeNextSteps(description, findings) {
   const steps = [];
@@ -19650,8 +20180,8 @@ function describeNextSteps(description, findings) {
 }
 async function describeProject(input = {}) {
   const repo = resolve23(input.repoArg ?? process.cwd());
-  if (!existsSync22(repo)) throw new Error(`Path does not exist: ${repo}`);
-  if (!statSync7(repo).isDirectory()) throw new Error(`Not a directory: ${repo}`);
+  if (!existsSync23(repo)) throw new Error(`Path does not exist: ${repo}`);
+  if (!statSync8(repo).isDirectory()) throw new Error(`Not a directory: ${repo}`);
   const registryPath = input.registryPath ?? projectRegistryPath();
   const report = await recipeRegistry.auditRecipes(lifecycleContext(repo, true, false, { registryPath }));
   const findings = report.rules;
@@ -19995,7 +20525,7 @@ init_style();
 // src/notebook/cli.ts
 init_project();
 init_capture();
-import { closeSync as closeSync8, constants as constants6, existsSync as existsSync23, fstatSync as fstatSync4, lstatSync as lstatSync18, openSync as openSync8, readSync as readSync4 } from "node:fs";
+import { closeSync as closeSync8, constants as constants6, existsSync as existsSync24, fstatSync as fstatSync4, lstatSync as lstatSync18, openSync as openSync8, readSync as readSync4 } from "node:fs";
 import { resolve as resolve24 } from "node:path";
 import { createInterface } from "node:readline/promises";
 
@@ -20137,7 +20667,7 @@ async function execute(input) {
 }
 function readBoundedRegularFile(path, maxBytes) {
   const absolute = resolve24(path);
-  if (!existsSync23(absolute)) throw new NotebookError("INVALID_INPUT", `File not found: ${absolute}`);
+  if (!existsSync24(absolute)) throw new NotebookError("INVALID_INPUT", `File not found: ${absolute}`);
   const before = lstatSync18(absolute);
   if (!before.isFile() || before.isSymbolicLink()) throw new NotebookError("INVALID_INPUT", `File must be a regular non-symlink: ${absolute}`);
   if (before.size > maxBytes) throw new NotebookError("INVALID_INPUT", `File exceeds the configured ceiling: ${absolute}`);
@@ -20321,7 +20851,7 @@ function registerNotebookCli(program2, module = new NotebookModule()) {
       const registry = loadProjectRegistry(registryFile);
       const root = notebookStateRoot();
       const explicit = process.env.PJ_NOTEBOOK_WORKER_PROJECT_SLUG?.toLowerCase();
-      const slug = explicit && registry.projects[explicit] ? explicit : Object.keys(registry.projects).find((candidate) => existsSync23(statePathForReceipt(root, candidate, options.receiptId)));
+      const slug = explicit && registry.projects[explicit] ? explicit : Object.keys(registry.projects).find((candidate) => existsSync24(statePathForReceipt(root, candidate, options.receiptId)));
       if (!slug) throw new NotebookError("NOT_FOUND", "Receipt does not belong to a registered project");
       await runCaptureWorker(new NotebookModule({ registryPath: registryFile, stateRoot: root }), slug, options.receiptId);
     } catch (error) {
@@ -20377,7 +20907,7 @@ init_project();
 init_style();
 
 // src/tui/load.ts
-import { existsSync as existsSync24 } from "node:fs";
+import { existsSync as existsSync25 } from "node:fs";
 import { fileURLToPath as fileURLToPath6 } from "node:url";
 var TuiUnavailableError = class extends Error {
 };
@@ -20399,7 +20929,7 @@ async function loadScreen(relativeToDist, base) {
   } catch (error) {
     const err = error;
     if (err?.code !== "ERR_MODULE_NOT_FOUND") throw error;
-    if (!existsSync24(fileURLToPath6(url))) {
+    if (!existsSync25(fileURLToPath6(url))) {
       throw new TuiUnavailableError(`TUI screen ${relativeToDist} is not built (run: npm run build); looked for ${url.pathname}`);
     }
     if (typeof err.stack !== "string" || !RESOLVER_FRAME.test(err.stack)) throw error;
@@ -20412,9 +20942,9 @@ async function loadScreen(relativeToDist, base) {
 // src/crank/index.ts
 init_boardQuery();
 init_style();
-import { spawnSync as spawnSync16 } from "node:child_process";
-import { readFileSync as readFileSync28 } from "node:fs";
-import { join as join33 } from "node:path";
+import { spawnSync as spawnSync17 } from "node:child_process";
+import { readFileSync as readFileSync29 } from "node:fs";
+import { join as join34 } from "node:path";
 var ZCRANK_REDIS_HOST = "127.0.0.1";
 var ZCRANK_REDIS_PORT = 6379;
 function redisEndpoint(env2 = process.env) {
@@ -20428,7 +20958,7 @@ var ZCRANK_SESSION = "Workspace";
 var ZCRANK_LOG_CAP = 500;
 var TAB_STATUS_SUFFIX = /[\s🟢🟡🔴🔔⚫✳✻●·─]+$/u;
 var defaultShell = (command, args) => {
-  const result2 = spawnSync16(command, args, { encoding: "utf8", timeout: 1e4 });
+  const result2 = spawnSync17(command, args, { encoding: "utf8", timeout: 1e4 });
   if (result2.error) return { stdout: "", status: 127 };
   return { stdout: result2.stdout ?? "", status: result2.status ?? 1, stderr: result2.stderr ?? "" };
 };
@@ -20694,7 +21224,7 @@ function resolveTabForProject(project, live, storedTabs) {
 function projectNameFor(handle, registryName) {
   if (registryName && registryName.trim()) return registryName.trim();
   try {
-    const manifest = JSON.parse(readFileSync28(join33(handle.root, ".project.json"), "utf8"));
+    const manifest = JSON.parse(readFileSync29(join34(handle.root, ".project.json"), "utf8"));
     const name = manifest.project_name;
     if (typeof name === "string" && name.trim()) return name.trim();
   } catch {
@@ -20705,7 +21235,7 @@ function projectAgentsFor(handle, registryAgents) {
   const fromRecord = Object.entries(registryAgents ?? {}).map(([agentHandle, value]) => ({ handle: agentHandle, role: String(value?.role ?? "") }));
   if (fromRecord.length) return fromRecord;
   try {
-    const manifest = JSON.parse(readFileSync28(join33(handle.root, ".project.json"), "utf8"));
+    const manifest = JSON.parse(readFileSync29(join34(handle.root, ".project.json"), "utf8"));
     const agents = manifest.agents;
     if (agents && typeof agents === "object" && !Array.isArray(agents)) {
       return Object.entries(agents).map(([agentHandle, value]) => ({ handle: agentHandle, role: typeof value?.role === "string" ? value.role : "" }));
@@ -21112,13 +21642,13 @@ function printMigrationReport(report, asJson) {
 }
 async function promptForRuleIds(rules) {
   const fixable = rules.filter((rule) => rule.fixable);
-  const { message, options } = formatRulePicker(fixable);
+  const { message: message2, options } = formatRulePicker(fixable);
   if (!options.length) {
     return [];
   }
   const initialValues = fixable.filter((rule) => rule.status !== "pass" && rule.status !== "skip").map((rule) => rule.id);
   const selected = await multiselect({
-    message,
+    message: message2,
     options,
     initialValues
   });
@@ -21128,16 +21658,16 @@ async function promptForRuleIds(rules) {
   return selected;
 }
 function readJson2(path) {
-  if (!existsSync26(path)) return void 0;
+  if (!existsSync27(path)) return void 0;
   try {
-    const parsed = JSON.parse(readFileSync29(path, "utf8"));
+    const parsed = JSON.parse(readFileSync30(path, "utf8"));
     return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : void 0;
   } catch {
     return void 0;
   }
 }
 function findGitRoot(cwd) {
-  const result2 = spawnSync17("git", ["rev-parse", "--show-toplevel"], { cwd, encoding: "utf8" });
+  const result2 = spawnSync18("git", ["rev-parse", "--show-toplevel"], { cwd, encoding: "utf8" });
   if (result2.status !== 0) return void 0;
   return resolve25(result2.stdout.trim());
 }
@@ -21147,8 +21677,8 @@ function packageNameToProjectName(value) {
   return name.replace(/[-_]+/g, " ").replace(/\b\w/g, (letter) => letter.toUpperCase()).trim();
 }
 function deriveProjectDefaults(targetDir) {
-  const manifest = readJson2(join34(targetDir, ".project.json"));
-  const pkg = readJson2(join34(targetDir, "package.json"));
+  const manifest = readJson2(join35(targetDir, ".project.json"));
+  const pkg = readJson2(join35(targetDir, "package.json"));
   const name = String(manifest?.project_name ?? "").trim() || packageNameToProjectName(typeof pkg?.name === "string" ? pkg.name : void 0) || packageNameToProjectName(basename11(targetDir)) || "Project";
   const ticketProvider = manifest?.ticket_provider && typeof manifest.ticket_provider === "object" ? manifest.ticket_provider : {};
   return {
@@ -21164,9 +21694,9 @@ function deriveProjectDefaults(targetDir) {
 function isInteractiveProjectInit(options) {
   return !options.json && !options.yes && options.tui !== false && Boolean(process.stdin.isTTY && process.stdout.isTTY);
 }
-async function promptTextValue(message, initialValue) {
+async function promptTextValue(message2, initialValue) {
   const value = await text({
-    message,
+    message: message2,
     initialValue,
     validate: (input) => input?.trim() ? void 0 : "Required"
   });
@@ -21223,7 +21753,7 @@ function actionNeedsRun(plan, kind, syncMode) {
     if (!action || action.kind !== "project.write-manifest") return false;
     const next = `${JSON.stringify(action.manifest, null, 2)}
 `;
-    return !existsSync26(action.path) || readFileSync29(action.path, "utf8") !== next;
+    return !existsSync27(action.path) || readFileSync30(action.path, "utf8") !== next;
   }
   if (kind === "copier.copy.commonproject") return true;
   if (kind === "ticket-provider.create-or-link") return plan.actions.some((action) => action.kind === kind && action.enabled);
@@ -21280,7 +21810,7 @@ async function resolveProjectInitTarget(name, options) {
   if (!targetDir && cwdGitRoot) {
     targetDir = cwdGitRoot;
   }
-  if (!targetDir && !name && existsSync26(join34(cwd, ".project.json"))) {
+  if (!targetDir && !name && existsSync27(join35(cwd, ".project.json"))) {
     targetDir = cwd;
   }
   if (!targetDir && interactive) {
@@ -21291,14 +21821,14 @@ async function resolveProjectInitTarget(name, options) {
   if (!targetDir) {
     throw new Error("Project name or --target-dir is required when project init is not run inside a git repo or a directory carrying .project.json");
   }
-  const targetExists = existsSync26(targetDir);
-  if (targetExists && !statSync8(targetDir).isDirectory()) throw new Error(`Target path is not a directory: ${targetDir}`);
+  const targetExists = existsSync27(targetDir);
+  if (targetExists && !statSync9(targetDir).isDirectory()) throw new Error(`Target path is not a directory: ${targetDir}`);
   const targetGitRoot = targetExists ? findGitRoot(targetDir) : void 0;
-  const alreadyScaffolded = targetExists && (existsSync26(join34(targetDir, ".project.json")) || existsSync26(join34(targetDir, ".copier-answers.yml")));
+  const alreadyScaffolded = targetExists && (existsSync27(join35(targetDir, ".project.json")) || existsSync27(join35(targetDir, ".copier-answers.yml")));
   const syncMode = Boolean(
     targetGitRoot && resolve25(targetGitRoot) === resolve25(targetDir) || alreadyScaffolded
   );
-  if (targetExists && !syncMode && !options.force && readdirSync12(targetDir).length > 0) {
+  if (targetExists && !syncMode && !options.force && readdirSync13(targetDir).length > 0) {
     throw new Error(`Target already exists and is not empty: ${targetDir} (pass --force to render over it)`);
   }
   const defaults = targetExists ? deriveProjectDefaults(targetDir) : { name: packageNameToProjectName(basename11(targetDir)) ?? "Project", description: "" };
@@ -21384,8 +21914,8 @@ program.command("subsystems").description("List available subsystems").action(()
   console.log("");
 });
 function boardFailure(error) {
-  const message = error instanceof BoardError || error instanceof Error ? error.message : String(error);
-  console.error(`${xmark2} ${message}`);
+  const message2 = error instanceof BoardError || error instanceof Error ? error.message : String(error);
+  console.error(`${xmark2} ${message2}`);
   process.exit(1);
 }
 function parseTicketCount(raw, fallback2) {
@@ -21601,6 +22131,39 @@ async function runProjectInit(name, options) {
     process.exit(1);
   }
 }
+var RENAME_MARK = {
+  planned: "plan",
+  done: "done",
+  already: "ok",
+  skipped: "skip",
+  blocked: "blocked",
+  failed: "FAIL"
+};
+function formatRenameResult(result2) {
+  const lines = [""];
+  const headline = result2.noop ? "Nothing to rename" : result2.apply ? result2.ok ? "Renamed" : "Rename incomplete" : "Would rename";
+  const mark = !result2.ok ? red(glyph.fail) : result2.apply && !result2.noop ? green(glyph.pass) : yellow(glyph.warn);
+  lines.push(`  ${mark} ${bold(headline)}  ${dim(glyph.dot)}  ${cyan(result2.oldId)} ${dim(glyph.pointer)} ${cyan(result2.newId)}${result2.resumed ? dim("  (resuming an earlier run)") : ""}`);
+  lines.push(`  ${dim("board".padEnd(14))} ${result2.oldIdentifier || dim("(none)")} ${dim(glyph.pointer)} ${result2.newIdentifier}${result2.boardId ? dim(`  ${result2.provider}/${result2.workspace} ${result2.boardId}`) : ""}`);
+  lines.push("");
+  const width = Math.max(...result2.steps.map((step) => step.step.length));
+  for (const step of result2.steps) {
+    const label = RENAME_MARK[step.status].padEnd(7);
+    const colored = step.status === "failed" ? red(label) : step.status === "done" ? green(label) : step.status === "planned" ? yellow(label) : dim(label);
+    lines.push(`  ${colored} ${step.step.padEnd(width)}  ${step.status === "failed" ? step.detail : dim(step.detail)}`);
+  }
+  if (result2.changedFiles.length) {
+    lines.push("");
+    lines.push(`  ${dim(result2.apply ? "files changed" : "files that would change")}`);
+    for (const file of result2.changedFiles) lines.push(`    ${dim(file)}`);
+  }
+  lines.push("");
+  for (const warning of result2.warnings) lines.push(`  ${yellow(glyph.warn)} ${dim(warning)}`);
+  if (result2.error) lines.push(`  ${red(glyph.fail)} ${result2.error}`);
+  if (!result2.apply) lines.push(`  ${dim("dry run \u2014 re-run with --apply to write")}`);
+  lines.push("");
+  return lines.join("\n");
+}
 function registerProjectCommands(parent, legacy = false) {
   parent.command("list").description("List projects in the pjangler registry").option("--registry <location>", `Registry service URL or fixture path (default: ${projectRegistryPath()})`).option("--json", "Output machine-parseable JSON").action(async (options) => {
     try {
@@ -21658,9 +22221,9 @@ function registerProjectCommands(parent, legacy = false) {
       if (!result2.apply) console.log(`  ${dim("dry run \u2014 re-run with --apply to write")}`);
       console.log("");
     } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      if (options.json) console.log(JSON.stringify({ ok: false, error: message }, null, 2));
-      else console.error(`${xmark2} project remove failed: ${message}`);
+      const message2 = err instanceof Error ? err.message : String(err);
+      if (options.json) console.log(JSON.stringify({ ok: false, error: message2 }, null, 2));
+      else console.error(`${xmark2} project remove failed: ${message2}`);
       process.exit(1);
     }
   });
@@ -21690,9 +22253,28 @@ function registerProjectCommands(parent, legacy = false) {
       if (!result2.apply) console.log(`  ${dim("dry run \u2014 re-run with --apply to write")}`);
       console.log("");
     } catch (err) {
-      const message = err instanceof Error ? err.message : String(err);
-      if (options.json) console.log(JSON.stringify({ ok: false, error: message }, null, 2));
-      else console.error(`${xmark2} project link failed: ${message}`);
+      const message2 = err instanceof Error ? err.message : String(err);
+      if (options.json) console.log(JSON.stringify({ ok: false, error: message2 }, null, 2));
+      else console.error(`${xmark2} project link failed: ${message2}`);
+      process.exit(1);
+    }
+  });
+  parent.command("rename").argument("<old-id>", "Current project ID").argument("<new-id>", "New project ID; also becomes the board identifier, upper-cased (1-12 lowercase letters/digits)").description("Rename a project: one key becomes the project ID and the board identifier, across registry, manifest and provider").option("--apply", "Write the rename (default is a dry run)").option("--registry <location>", `Registry service URL or fixture path (default: ${projectRegistryPath()})`).option("--json", "Output machine-parseable JSON").action(async (oldId, newId, options) => {
+    try {
+      const result2 = await renameProject({
+        oldId,
+        newId,
+        apply: Boolean(options.apply),
+        registryPath: options.registry
+      });
+      if (options.json) console.log(JSON.stringify(result2, null, 2));
+      else console.log(formatRenameResult(result2));
+      if (!result2.ok) process.exit(1);
+    } catch (err) {
+      const code = err instanceof RenameError ? err.code : "error";
+      const text2 = err instanceof Error ? err.message : String(err);
+      if (options.json) console.log(JSON.stringify({ ok: false, error: text2, code }, null, 2));
+      else console.error(`${xmark2} project rename failed: [${code}] ${text2}`);
       process.exit(1);
     }
   });
@@ -21764,7 +22346,7 @@ program.command("reindex").argument("[project-id]", "Canonical project ID (defau
     else if (options.all) result2 = registryRequest(location, "POST", "/v1/reindex", {});
     else {
       const repo = projectId ? getProject(loadProjectRegistry(location), projectId).repo_path : resolveProject(process.cwd()).root;
-      result2 = registryRequest(location, "POST", "/v1/index", { manifest_path: join34(repo, ".project.json") });
+      result2 = registryRequest(location, "POST", "/v1/index", { manifest_path: join35(repo, ".project.json") });
     }
     const statuses = result2.__registry_status;
     const stale = Object.entries(statuses ?? {}).filter(([, item]) => item.status !== "ok");

package/dist/mcp-server.js

@@ -13329,6 +13329,18 @@ init_project();
 import { spawnSync as spawnSync13 } from "node:child_process";
 import { existsSync as existsSync18, lstatSync as lstatSync16, readFileSync as readFileSync20, rmSync as rmSync8 } from "node:fs";
 import { dirname as dirname17, isAbsolute as isAbsolute10, join as join23, relative as relativePath, resolve as resolve18 } from "node:path";
+
+// src/project/ticketScope.ts
+function ticketScope(ticket) {
+  const block = ticket !== null && typeof ticket === "object" ? ticket : {};
+  const label = typeof block.scope_label === "string" ? block.scope_label.trim() : "";
+  return {
+    ...label ? { scope_label: label } : {},
+    ...block.scope_default === true ? { scope_default: true } : {}
+  };
+}
+
+// src/recipes/ProjectRecipe.ts
 init_tree_diff();
 
 // src/recipes/NotebookRecipe.ts
@@ -15214,6 +15226,7 @@ function refreshPlanFromCanonicalManifest(plan) {
     ...carriesProvenance && identifierSource === "provider" && recorded?.identifier_fetched_at ? { identifier_fetched_at: recorded.identifier_fetched_at } : {},
     board_id: manifestBoardId,
     ...boardConfirmedAt ? { board_confirmed_at: boardConfirmedAt } : {},
+    ...ticketScope(manifestTicket),
     state: manifestState === "skipped" ? "skipped" : manifestBoardId && boardConfirmedAt && keyIsProven ? "linked" : "planned"
   };
   plan.manifest = manifest;

package/dist/project-registry-service.js

@@ -225,7 +225,8 @@ function validateManifestFields(manifest, path) {
     if (!object(artifact)) fail(`source_artifacts.${index}`, "an object");
     strings(artifact, ["kind", "path", "package_name"], `source_artifacts.${index}.`);
   }
-  if (manifest.ticket_provider) strings(manifest.ticket_provider, ["type", "workspace", "identifier", "identifier_source", "identifier_fetched_at", "board_id", "board_confirmed_at", "board_url", "state"], "ticket_provider.");
+  if (manifest.ticket_provider) strings(manifest.ticket_provider, ["type", "workspace", "identifier", "identifier_source", "identifier_fetched_at", "board_id", "board_confirmed_at", "board_url", "state", "scope_label"], "ticket_provider.");
+  if (manifest.ticket_provider?.scope_default !== void 0 && typeof manifest.ticket_provider.scope_default !== "boolean") fail("ticket_provider.scope_default", "a boolean");
   for (const [name, agent] of Object.entries(manifest.agents ?? {})) {
     if (!object(agent)) fail(`agents.${name}`, "an object");
     strings(agent, ["role", "role_dir", "provisioning_state"], `agents.${name}.`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@delorenj/pjangler",
-  "version": "1.5.35",
+  "version": "1.5.37",
   "description": "Project subsystem bootstrapper CLI",
   "type": "module",
   "main": "dist/index.js",