arcane-cli 0.17.1 → 0.20.0

package/dist/index.js

@@ -6,11 +6,11 @@ const require = __createRequire(import.meta.url);
 import { Command } from "commander";
 import { createRequire as createRequire2 } from "module";
 import { fileURLToPath } from "url";
-import { dirname as dirname3, join as join11 } from "path";
+import { dirname as dirname3, join as join12 } from "path";
 
 // src/commands/init.ts
-import { select as select2, confirm } from "@inquirer/prompts";
-import { join as join4 } from "path";
+import { select as select2, confirm, input as input2 } from "@inquirer/prompts";
+import { join as join5 } from "path";
 import chalk2 from "chalk";
 
 // src/modules/copier.ts
@@ -98,6 +98,20 @@ var ManifestInvalidFieldError = class extends Error {
 var MANIFEST_FILE = ".arcane.json";
 var VALID_TRACKING_MODES = ["internal", "external"];
 var VALID_EXTERNAL_PROVIDERS = ["ado", "jira", "other"];
+var VALID_CONTENT_SENSITIVITY = ["standard", "sensitive"];
+var VALID_PUSH_POLICIES = ["open", "guarded", "blocked"];
+function isValidSubjectRoot(value) {
+  const invalid = value.trim() === "" || path2.isAbsolute(value) || // Windows drive-relative ("C:docs") and UNC-ish values also escape.
+  /^[a-zA-Z]:/.test(value) || value.startsWith("\\\\") || value.startsWith("\\") || value.split(/[\\/]/).includes("..") || // A stored subject_root is interpolated into agent prompts downstream, so
+  // keep it a single path-shaped token rather than a multi-line payload.
+  /[\r\n\0]/.test(value);
+  return !invalid;
+}
+function validateSubjectRoot(value, filePath) {
+  if (!isValidSubjectRoot(value)) {
+    throw new ManifestInvalidFieldError(filePath, "subject_root", value);
+  }
+}
 function manifestPath(targetDir) {
   return path2.join(targetDir, MANIFEST_FILE);
 }
@@ -108,6 +122,22 @@ function validateTrackingFields(manifest, filePath) {
   if (manifest.external_provider !== void 0 && manifest.external_provider !== null && !VALID_EXTERNAL_PROVIDERS.includes(manifest.external_provider)) {
     throw new ManifestInvalidFieldError(filePath, "external_provider", manifest.external_provider);
   }
+  if (manifest.content_sensitivity !== void 0 && !VALID_CONTENT_SENSITIVITY.includes(manifest.content_sensitivity)) {
+    throw new ManifestInvalidFieldError(
+      filePath,
+      "content_sensitivity",
+      manifest.content_sensitivity
+    );
+  }
+  if (manifest.push_policy !== void 0 && !VALID_PUSH_POLICIES.includes(manifest.push_policy)) {
+    throw new ManifestInvalidFieldError(filePath, "push_policy", manifest.push_policy);
+  }
+  if (manifest.subject_root !== void 0 && manifest.subject_root !== null) {
+    if (typeof manifest.subject_root !== "string") {
+      throw new ManifestInvalidFieldError(filePath, "subject_root", manifest.subject_root);
+    }
+    validateSubjectRoot(manifest.subject_root, filePath);
+  }
 }
 async function readManifest(targetDir) {
   const filePath = manifestPath(targetDir);
@@ -155,15 +185,35 @@ var PROFILE_CONFIGS = [
     id: "lite",
     displayName: "Essentials",
     description: "Spells + core governance \u2014 fast start",
-    components: ["spell-prompts", "claude-commands", "agent-output-instructions", "git-conventions", "testing-standards", "framework-decisions", "session-continuity"]
+    components: [
+      "spells-session",
+      "spells-capture",
+      "spells-delivery",
+      "spells-review",
+      "spells-planning",
+      "spells-build",
+      "spells-venture",
+      "spells-meta",
+      "agent-output-instructions",
+      "git-conventions",
+      "testing-standards",
+      "framework-decisions",
+      "session-continuity"
+    ]
   },
   {
     id: "methodology",
     displayName: "Methodology Suite",
     description: "Spells + governance \u2014 full methodology without security/infra docs",
     components: [
-      "spell-prompts",
-      "claude-commands",
+      "spells-session",
+      "spells-capture",
+      "spells-delivery",
+      "spells-review",
+      "spells-planning",
+      "spells-build",
+      "spells-venture",
+      "spells-meta",
       "agent-output-instructions",
       "git-conventions",
       "testing-standards",
@@ -175,6 +225,44 @@ var PROFILE_CONFIGS = [
       "spell-authoring-standards"
     ]
   },
+  {
+    id: "docs",
+    displayName: "Docs / Records",
+    description: "Documentation and records repositories \u2014 no code, test, or deployment workflows",
+    components: [
+      // Deliberate exclusions, per docs-mode PRD MH-01: "spells-build"
+      // (implementation, tests, stack experts, release, deployment, PRD
+      // enchantment, asset tooling), "spells-review" (adversarial CODE review
+      // -- its own workflow validates test coverage against source, which a
+      // docs repo has neither of), and "spells-venture" (hub-only).
+      //
+      // MH-01 requires every retained spell to complete its core workflow
+      // without source code, tests, CI, or an external tracker. Asserted --
+      // exclusions included, which MH-01 requires explicitly -- in
+      // test/docs-profile-registry-split.test.ts.
+      "spells-session",
+      "spells-capture",
+      "spells-delivery",
+      "spells-planning",
+      "spells-meta",
+      "spells-docs",
+      "docs-baseline",
+      "records-conventions",
+      "agent-output-instructions",
+      "git-conventions",
+      // Four retained docs spells link to agent-policies; it carries no code
+      // implication, so shipping it closes a dangling reference cheaply.
+      "agent-policies",
+      "framework-decisions",
+      "session-continuity",
+      "decision-documentation-standard",
+      "agent-work-queue-model",
+      "development-methodology",
+      "naming-conventions",
+      "universal-agent-rules",
+      "spell-authoring-standards"
+    ]
+  },
   {
     id: "governance-only",
     displayName: "Governance Only",
@@ -323,46 +411,159 @@ var COMPONENTS = [
     description: "Copilot enforcement rules: PR link format, merge strategy, and branch naming",
     files: [".github/instructions/agent-output.instructions.md"]
   },
-  // Spell prompts — installed to .github/prompts/ (VS Code Copilot convention)
+  // Repository baseline files (EF-10 + EF-17). skipExisting: these are
+  // user-owned once written -- a repo with its own .gitattributes has an
+  // intentional policy Arcane must not overwrite. Sources are stored under a
+  // non-dotfile path and mapped via sourceOverrides; see RegistryComponent.
+  {
+    name: "docs-baseline",
+    description: "Line-ending and binary-format baseline for document repositories (.gitattributes/.gitignore)",
+    files: [".gitattributes", ".gitignore"],
+    sourceOverrides: {
+      ".gitattributes": "docs-baseline/gitattributes",
+      ".gitignore": "docs-baseline/gitignore"
+    },
+    skipExisting: true,
+    initOnly: true
+  },
+  {
+    name: "records-conventions",
+    description: "Supersession, tombstone, and retention conventions for records repositories",
+    files: [".arcane/governance/records-conventions.md"]
+  },
+  // ─── Spells ────────────────────────────────────────────────────────────────
+  // Split from the former monolithic `spell-prompts` + `claude-commands` pair
+  // so a profile can select spells by capability (see ARC-0NN). Grouping lives
+  // here and only here -- every spell file stays flat and unrenamed on disk.
+  //
+  // Each component carries BOTH client formats of the same spell: the Copilot
+  // prompt (.github/prompts/*.prompt.md) and the Claude Code wrapper
+  // (.claude/commands/*.md). They are never independently selectable -- every
+  // profile that wanted one always wanted the other -- and pairing them here
+  // makes it structurally impossible for the two formats of one spell to drift
+  // apart across profiles.
   {
-    name: "spell-prompts",
-    description: "Full Arcane spell prompt library (34 spells)",
+    name: "spells-session",
+    description: "Session lifecycle \u2014 open, close, commit, status, version",
     files: [
+      ".github/prompts/spell-open-session.prompt.md",
+      ".claude/commands/spell-open-session.md",
+      ".github/prompts/spell-close-session.prompt.md",
+      ".claude/commands/spell-close-session.md",
+      ".github/prompts/spell-commit-work.prompt.md",
+      ".claude/commands/spell-commit-work.md",
+      ".github/prompts/spell-status.prompt.md",
+      ".claude/commands/spell-status.md",
       ".github/prompts/spell-arcane-version.prompt.md",
-      ".github/prompts/spell-architect.prompt.md",
+      ".claude/commands/spell-arcane-version.md"
+    ]
+  },
+  {
+    name: "spells-capture",
+    description: "Idea, todo, feedback and explanation capture",
+    files: [
+      ".github/prompts/spell-save-idea.prompt.md",
+      ".claude/commands/spell-save-idea.md",
+      ".github/prompts/spell-todo.prompt.md",
+      ".claude/commands/spell-todo.md",
+      ".github/prompts/spell-feedback.prompt.md",
+      ".claude/commands/spell-feedback.md",
+      ".github/prompts/spell-suggest-feature.prompt.md",
+      ".claude/commands/spell-suggest-feature.md",
+      ".github/prompts/spell-document.prompt.md",
+      ".claude/commands/spell-document.md",
       ".github/prompts/spell-brainstorm.prompt.md",
+      ".claude/commands/spell-brainstorm.md",
+      ".github/prompts/spell-explain-concept.prompt.md",
+      ".claude/commands/spell-explain-concept.md"
+    ]
+  },
+  {
+    name: "spells-delivery",
+    description: "Pull-request lifecycle \u2014 open a PR, respond to review feedback",
+    files: [
+      ".github/prompts/spell-create-pull-request.prompt.md",
+      ".claude/commands/spell-create-pull-request.md",
+      ".github/prompts/spell-address-review.prompt.md",
+      ".claude/commands/spell-address-review.md"
+    ]
+  },
+  {
+    name: "spells-review",
+    description: "Adversarial code review \u2014 requires source and tests, so excluded from docs-only profiles",
+    files: [
+      ".github/prompts/spell-review.prompt.md",
+      ".claude/commands/spell-review.md",
+      ".github/prompts/spell-review-batch.prompt.md",
+      ".claude/commands/spell-review-batch.md"
+    ]
+  },
+  {
+    name: "spells-planning",
+    description: "PRD, architecture, scoping and product review",
+    files: [
+      ".github/prompts/spell-plan.prompt.md",
+      ".claude/commands/spell-plan.md",
+      ".github/prompts/spell-architect.prompt.md",
+      ".claude/commands/spell-architect.md",
       ".github/prompts/spell-scope.prompt.md",
-      ".github/prompts/spell-summon-venture.prompt.md",
+      ".claude/commands/spell-scope.md",
+      ".github/prompts/spell-product-review.prompt.md",
+      ".claude/commands/spell-product-review.md"
+    ]
+  },
+  {
+    name: "spells-build",
+    description: "Code and product delivery \u2014 implementation, tests, stack experts, release, deployment, asset tooling",
+    files: [
+      ".github/prompts/spell-implement.prompt.md",
+      ".claude/commands/spell-implement.md",
+      ".github/prompts/spell-test.prompt.md",
+      ".claude/commands/spell-test.md",
+      ".github/prompts/spell-full-cycle.prompt.md",
+      ".claude/commands/spell-full-cycle.md",
       ".github/prompts/spell-bug.prompt.md",
+      ".claude/commands/spell-bug.md",
       ".github/prompts/spell-bump.prompt.md",
-      ".github/prompts/spell-check-drift.prompt.md",
-      ".github/prompts/spell-close-session.prompt.md",
-      ".github/prompts/spell-commit-work.prompt.md",
+      ".claude/commands/spell-bump.md",
       ".github/prompts/spell-dotnet-expert.prompt.md",
-      ".github/prompts/spell-enchant.prompt.md",
-      ".github/prompts/spell-explain-concept.prompt.md",
-      ".github/prompts/spell-full-cycle.prompt.md",
-      ".github/prompts/spell-generate-bot-icons.prompt.md",
-      ".github/prompts/spell-implement.prompt.md",
-      ".github/prompts/spell-open-session.prompt.md",
-      ".github/prompts/spell-plan.prompt.md",
-      ".github/prompts/spell-present-arcane.prompt.md",
-      ".github/prompts/spell-product-review.prompt.md",
-      ".github/prompts/spell-review.prompt.md",
+      ".claude/commands/spell-dotnet-expert.md",
       ".github/prompts/spell-security-review.prompt.md",
+      ".claude/commands/spell-security-review.md",
       ".github/prompts/spell-ship.prompt.md",
-      ".github/prompts/spell-suggest-feature.prompt.md",
-      ".github/prompts/spell-test.prompt.md",
-      ".github/prompts/spell-todo.prompt.md",
-      // Workflow spell additions — PR lifecycle, status, capture, feedback
-      ".github/prompts/spell-address-review.prompt.md",
-      ".github/prompts/spell-create-pull-request.prompt.md",
-      ".github/prompts/spell-document.prompt.md",
-      ".github/prompts/spell-feedback.prompt.md",
+      ".claude/commands/spell-ship.md",
+      ".github/prompts/spell-enchant.prompt.md",
+      ".claude/commands/spell-enchant.md",
+      ".github/prompts/spell-generate-bot-icons.prompt.md",
+      ".claude/commands/spell-generate-bot-icons.md"
+    ]
+  },
+  {
+    name: "spells-docs",
+    description: "Documentation and records workflows \u2014 adopt an existing document tree",
+    files: [
+      ".github/prompts/spell-adopt-docs.prompt.md",
+      ".claude/commands/spell-adopt-docs.md"
+    ]
+  },
+  {
+    name: "spells-venture",
+    description: "Hub-only venture management",
+    files: [
+      ".github/prompts/spell-summon-venture.prompt.md",
+      ".claude/commands/spell-summon-venture.md",
       ".github/prompts/spell-manifest.prompt.md",
-      ".github/prompts/spell-save-idea.prompt.md",
-      ".github/prompts/spell-status.prompt.md",
-      ".github/prompts/spell-review-batch.prompt.md"
+      ".claude/commands/spell-manifest.md"
+    ]
+  },
+  {
+    name: "spells-meta",
+    description: "Arcane-about-Arcane \u2014 presentation and documentation drift detection",
+    files: [
+      ".github/prompts/spell-present-arcane.prompt.md",
+      ".claude/commands/spell-present-arcane.md",
+      ".github/prompts/spell-check-drift.prompt.md",
+      ".claude/commands/spell-check-drift.md"
     ]
   },
   // Templates
@@ -396,53 +597,11 @@ var COMPONENTS = [
     name: "agent-definitions",
     description: "Agent policy reference template (for governance-only setups \u2014 use `spell agents init` for the full agent system)",
     files: [".arcane/agents/agent-policies-template.md"]
-  },
+  }
   // NOTE: the static `agent-files` component was retired — `.github/agents/*.agent.md`
   // files are generated per-roster by `spell agents init` / `spell agents sync`, so
   // installing a fixed-name set via `spell init` shipped stale names and collided
   // with the generated output.
-  // Claude commands
-  {
-    name: "claude-commands",
-    description: "Claude Code slash command wrappers for all 34 Arcane spells",
-    files: [
-      ".claude/commands/spell-arcane-version.md",
-      ".claude/commands/spell-architect.md",
-      ".claude/commands/spell-brainstorm.md",
-      ".claude/commands/spell-scope.md",
-      ".claude/commands/spell-summon-venture.md",
-      ".claude/commands/spell-bug.md",
-      ".claude/commands/spell-bump.md",
-      ".claude/commands/spell-check-drift.md",
-      ".claude/commands/spell-close-session.md",
-      ".claude/commands/spell-commit-work.md",
-      ".claude/commands/spell-dotnet-expert.md",
-      ".claude/commands/spell-enchant.md",
-      ".claude/commands/spell-explain-concept.md",
-      ".claude/commands/spell-full-cycle.md",
-      ".claude/commands/spell-generate-bot-icons.md",
-      ".claude/commands/spell-implement.md",
-      ".claude/commands/spell-open-session.md",
-      ".claude/commands/spell-plan.md",
-      ".claude/commands/spell-present-arcane.md",
-      ".claude/commands/spell-product-review.md",
-      ".claude/commands/spell-review.md",
-      ".claude/commands/spell-security-review.md",
-      ".claude/commands/spell-ship.md",
-      ".claude/commands/spell-suggest-feature.md",
-      ".claude/commands/spell-test.md",
-      ".claude/commands/spell-todo.md",
-      // Workflow spell additions — PR lifecycle, status, capture, feedback
-      ".claude/commands/spell-address-review.md",
-      ".claude/commands/spell-create-pull-request.md",
-      ".claude/commands/spell-document.md",
-      ".claude/commands/spell-feedback.md",
-      ".claude/commands/spell-manifest.md",
-      ".claude/commands/spell-save-idea.md",
-      ".claude/commands/spell-status.md",
-      ".claude/commands/spell-review-batch.md"
-    ]
-  }
 ];
 function buildProfileMap() {
   const allNames = COMPONENTS.map((c) => c.name);
@@ -454,6 +613,23 @@ function buildProfileMap() {
 }
 var PROFILE_MAP = buildProfileMap();
 var componentIndex = new Map(COMPONENTS.map((c) => [c.name, c]));
+var SPELL_COMPONENT_NAMES = COMPONENTS.map((c) => c.name).filter(
+  (n) => n.startsWith("spells-")
+);
+var LEGACY_MONOLITH_REPLACEMENTS = [
+  "spells-session",
+  "spells-capture",
+  "spells-delivery",
+  "spells-review",
+  "spells-planning",
+  "spells-build",
+  "spells-venture",
+  "spells-meta"
+];
+var LEGACY_COMPONENT_MIGRATIONS = Object.assign(/* @__PURE__ */ Object.create(null), {
+  "spell-prompts": LEGACY_MONOLITH_REPLACEMENTS,
+  "claude-commands": LEGACY_MONOLITH_REPLACEMENTS
+});
 function getComponent(name) {
   const component = componentIndex.get(name);
   if (!component) {
@@ -496,7 +672,7 @@ var WORDMARK = [
 var INDENT = "  ";
 var LOCKUP_WIDTH = INDENT.length + Math.max(...WORDMARK.map((l) => l.length));
 function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
 }
 function isAnimatable() {
   return !!process.stdout.isTTY && process.env["TERM"] !== "dumb" && process.env["CI"] !== "true" && process.env["ARCANE_DISABLE_ANIMATION"] !== "true" && (process.stdout.columns ?? 80) >= LOCKUP_WIDTH;
@@ -1618,6 +1794,10 @@ async function runAgentsList(targetDir) {
   console.log();
 }
 
+// src/modules/push-safety.ts
+import { mkdir as mkdir4, readFile as readFile4, writeFile as writeFile5, chmod } from "fs/promises";
+import { join as join4 } from "path";
+
 // src/modules/git.ts
 import { execFile } from "child_process";
 var GitTimeoutError = class extends Error {
@@ -1713,7 +1893,7 @@ function buildGitEnv() {
 function runGit(cwd, args, options = {}) {
   const commandClass = options.commandClass ?? classifyGitCommand(args);
   const timeoutMs = options.timeoutMs ?? DEFAULT_TIMEOUTS_MS[commandClass] ?? DEFAULT_TIMEOUTS_MS.write;
-  return new Promise((resolve, reject) => {
+  return new Promise((resolve2, reject) => {
     const child = execFile(
       "git",
       args,
@@ -1747,7 +1927,7 @@ function runGit(cwd, args, options = {}) {
           reject(error);
           return;
         }
-        resolve({ stdout, stderr });
+        resolve2({ stdout, stderr });
       }
     );
     child.stdin?.end();
@@ -1836,28 +2016,169 @@ async function ensureLocalPullRebase(cwd) {
   }
 }
 
+// src/modules/push-safety.ts
+var DISABLED_PUSH_URL = "arcane-push-blocked://this-repository-is-push-blocked";
+var ARCANE_HOOKS_DIR = ".arcane/hooks";
+async function readHooksPath(cwd) {
+  let effective;
+  try {
+    const { stdout } = await runGit(cwd, ["config", "--get", "core.hooksPath"]);
+    effective = stdout.trim();
+  } catch {
+    return void 0;
+  }
+  if (effective === "") return void 0;
+  let local = "";
+  try {
+    const { stdout } = await runGit(cwd, ["config", "--local", "--get", "core.hooksPath"]);
+    local = stdout.trim();
+  } catch {
+  }
+  return { value: effective, scope: local === effective && local !== "" ? "local" : "inherited" };
+}
+var HOOK_BODY = `#!/bin/sh
+# Installed by Arcane because this repository's .arcane.json sets
+# push_policy: "blocked".
+#
+# This is deliberately not tamper-proof. It guards against an accidental push
+# -- the wrong remote, muscle memory, an unsupervised agent -- not against a
+# determined operator, who can always bypass it.
+#
+# To push legitimately, undo the policy first:
+#
+#     spell unblock-push
+#
+# That command is interactive-only and asks you to confirm the repository by
+# name. Do not work around this hook by other means: the manifest would then
+# claim a protection this repository no longer has.
+echo "arcane: push blocked (push_policy: blocked). Run 'spell unblock-push' to undo." >&2
+exit 1
+`;
+function hookFilePath(cwd) {
+  return join4(cwd, ARCANE_HOOKS_DIR, "pre-push");
+}
+async function installPrePushHook(cwd) {
+  const existing = await readHooksPath(cwd);
+  if (existing !== void 0 && existing.value !== ARCANE_HOOKS_DIR) {
+    return {
+      status: "refused-foreign-hooks-path",
+      existing: existing.value,
+      scope: existing.scope
+    };
+  }
+  const hookPath = hookFilePath(cwd);
+  if (existing?.value === ARCANE_HOOKS_DIR && await fileExists(hookPath)) {
+    const current = await readFile4(hookPath, "utf-8");
+    if (current === HOOK_BODY) return { status: "already-ours" };
+  }
+  await mkdir4(join4(cwd, ARCANE_HOOKS_DIR), { recursive: true });
+  await writeFile5(hookPath, HOOK_BODY, "utf-8");
+  await chmod(hookPath, 493);
+  await runGit(cwd, ["config", "--local", "core.hooksPath", ARCANE_HOOKS_DIR]);
+  return { status: "installed", path: hookPath };
+}
+async function isHookEnforced(cwd) {
+  const hooksPath = await readHooksPath(cwd);
+  if (hooksPath?.value !== ARCANE_HOOKS_DIR) return false;
+  return fileExists(hookFilePath(cwd));
+}
+async function removePrePushHook(cwd) {
+  const existing = await readHooksPath(cwd);
+  if (existing?.value !== ARCANE_HOOKS_DIR || existing.scope !== "local") return;
+  try {
+    await runGit(cwd, ["config", "--local", "--unset", "core.hooksPath"]);
+  } catch {
+  }
+}
+async function listRemotes(cwd) {
+  try {
+    const { stdout } = await runGit(cwd, ["remote"]);
+    return stdout.split("\n").map((r) => r.trim()).filter(Boolean);
+  } catch {
+    return [];
+  }
+}
+async function disablePushUrls(cwd) {
+  const results = [];
+  for (const remote of await listRemotes(cwd)) {
+    let current;
+    try {
+      const { stdout } = await runGit(cwd, ["remote", "get-url", "--push", remote]);
+      current = stdout.trim();
+    } catch {
+      continue;
+    }
+    if (current === DISABLED_PUSH_URL) {
+      results.push({ remote, status: "already-disabled" });
+      continue;
+    }
+    await runGit(cwd, ["config", "--local", `arcane.originalPushUrl.${remote}`, current]);
+    await runGit(cwd, ["remote", "set-url", "--push", remote, DISABLED_PUSH_URL]);
+    results.push({ remote, status: "disabled" });
+  }
+  return results;
+}
+async function undisabledRemotes(cwd) {
+  const open = [];
+  for (const remote of await listRemotes(cwd)) {
+    try {
+      const { stdout } = await runGit(cwd, ["remote", "get-url", "--push", remote]);
+      if (stdout.trim() !== DISABLED_PUSH_URL) open.push(remote);
+    } catch {
+      open.push(remote);
+    }
+  }
+  return open;
+}
+async function restorePushUrls(cwd) {
+  const restored = [];
+  for (const remote of await listRemotes(cwd)) {
+    let original = "";
+    try {
+      const { stdout } = await runGit(cwd, [
+        "config",
+        "--local",
+        "--get",
+        `arcane.originalPushUrl.${remote}`
+      ]);
+      original = stdout.trim();
+    } catch {
+      continue;
+    }
+    if (original === "") continue;
+    await runGit(cwd, ["remote", "set-url", "--push", remote, original]);
+    try {
+      await runGit(cwd, ["config", "--local", "--unset", `arcane.originalPushUrl.${remote}`]);
+    } catch {
+    }
+    restored.push(remote);
+  }
+  return restored;
+}
+
 // src/commands/init.ts
-var VALID_PROFILES = ["full", "lite", "governance-only", "methodology"];
+var VALID_PROFILES = ["full", "lite", "governance-only", "methodology", "docs"];
+var PROFILE_ICONS = {
+  full: "\u{1F9D9}",
+  lite: "\u26A1",
+  docs: "\u{1F4D6}"
+};
+function isSpellComponent(name) {
+  return name.startsWith("spells-");
+}
 function categorizeComponents(components) {
   const groups = [];
-  const prompts = components.find((c) => c.name === "spell-prompts");
-  if (prompts) {
-    groups.push({
-      icon: "\u2728",
-      label: "Copilot Spells",
-      count: prompts.files.length
-    });
+  const spellFiles = components.filter((c) => isSpellComponent(c.name)).flatMap((c) => c.files);
+  const promptCount = spellFiles.filter((f) => f.startsWith(".github/prompts/")).length;
+  if (promptCount > 0) {
+    groups.push({ icon: "\u2728", label: "Copilot Spells", count: promptCount });
   }
-  const claude = components.find((c) => c.name === "claude-commands");
-  if (claude) {
-    groups.push({
-      icon: "\u26A1",
-      label: "Claude Spells",
-      count: claude.files.length
-    });
+  const claudeCount = spellFiles.filter((f) => f.startsWith(".claude/commands/")).length;
+  if (claudeCount > 0) {
+    groups.push({ icon: "\u26A1", label: "Claude Spells", count: claudeCount });
   }
   const governance = components.filter(
-    (c) => c.name !== "spell-prompts" && c.name !== "claude-commands" && c.name !== "venture-template" && c.name !== "agent-definitions" && c.files.some((f) => f.startsWith(".arcane/governance/"))
+    (c) => !isSpellComponent(c.name) && c.name !== "venture-template" && c.name !== "agent-definitions" && c.files.some((f) => f.startsWith(".arcane/governance/"))
   );
   if (governance.length > 0) {
     groups.push({
@@ -1963,7 +2284,7 @@ async function runInit(options, targetDir, assetsDir, packageVersion) {
         const profileComponents = getProfile(p.id);
         return {
           value: p.id,
-          name: `${p.id === "full" ? "\u{1F9D9}" : p.id === "lite" ? "\u26A1" : "\u{1F4CB}"}  ${p.displayName} \u2014 ${p.description}`,
+          name: `${PROFILE_ICONS[p.id] ?? "\u{1F4CB}"}  ${p.displayName} \u2014 ${p.description}`,
           description: buildProfileDescription(profileComponents, p.id)
         };
       })
@@ -1997,7 +2318,7 @@ async function runInit(options, targetDir, assetsDir, packageVersion) {
   for (const component of components) {
     const installedFiles = [];
     for (const file of component.files) {
-      const srcPath = join4(assetsDir, file);
+      const srcPath = join5(assetsDir, component.sourceOverrides?.[file] ?? file);
       if (options.dryRun) {
         printDryRun(`Would copy: ${file}`);
       } else {
@@ -2014,7 +2335,7 @@ async function runInit(options, targetDir, assetsDir, packageVersion) {
       fileCount++;
     }
     for (const dir of component.directories ?? []) {
-      const srcDirPath = join4(assetsDir, dir);
+      const srcDirPath = join5(assetsDir, dir);
       if (options.dryRun) {
         printDryRun(`Would copy directory: ${dir}/`);
       } else {
@@ -2039,7 +2360,7 @@ async function runInit(options, targetDir, assetsDir, packageVersion) {
   if (options.dryRun) {
     if (hasAgents) {
       const agentFiles = await import("fs").then(
-        (fsModule) => fsModule.promises.readdir(join4(assetsDir, "agents"))
+        (fsModule) => fsModule.promises.readdir(join5(assetsDir, "agents"))
       );
       const yamlFiles = agentFiles.filter((f) => f.endsWith(".yaml")).sort();
       printDryRun("Would run agent setup (interactive):");
@@ -2062,7 +2383,7 @@ async function runInit(options, targetDir, assetsDir, packageVersion) {
   }
   let tracking_mode;
   let external_provider;
-  if (profile === "governance-only" || profile === "methodology") {
+  if (profile === "governance-only" || profile === "methodology" || profile === "docs") {
     tracking_mode = "internal";
     external_provider = null;
   } else if (!options.profile) {
@@ -2087,16 +2408,110 @@ async function runInit(options, targetDir, assetsDir, packageVersion) {
       external_provider = null;
     }
   }
+  let subject_root;
+  if (profile === "docs" && !options.profile) {
+    console.log();
+    const shape = await select2({
+      message: "What does this repository hold?",
+      choices: [
+        {
+          value: "root",
+          name: "One subject, at the repository root (documents sit alongside Arcane's files)"
+        },
+        { value: "subdir", name: "One subject, in its own directory" },
+        { value: "portfolio", name: "Several subjects or ventures (decide per-document later)" }
+      ]
+    });
+    if (shape === "root") {
+      subject_root = ".";
+    } else if (shape === "subdir") {
+      const answer = await input2({
+        message: "Directory holding the subject's documents:",
+        default: "docs",
+        validate: (v) => isValidSubjectRoot(v.trim() || "docs") || "Must be a relative path inside the repository (no leading /, drive letter, or ..)."
+      });
+      subject_root = answer.trim() || "docs";
+    } else if (shape === "portfolio") {
+      subject_root = null;
+    }
+  }
+  let content_sensitivity;
+  if (!options.profile) {
+    console.log();
+    content_sensitivity = await select2({
+      message: "How should agents treat this repository's contents?",
+      choices: [
+        { value: "standard", name: "Standard \u2014 agents may quote contents in journals and decisions" },
+        {
+          value: "sensitive",
+          name: "Sensitive \u2014 agents reference documents by path, never transcribe them"
+        }
+      ],
+      default: "standard"
+    });
+  }
+  let push_policy;
+  if (!options.profile) {
+    console.log();
+    push_policy = await select2({
+      message: "Should this repository be allowed to push to a remote?",
+      choices: [
+        { value: "open", name: "Yes \u2014 normal repository" },
+        { value: "guarded", name: "Sensitive, but keep push working \u2014 remind me instead" },
+        {
+          value: "blocked",
+          name: "No \u2014 block pushes (a pre-push hook plus a disabled push URL)"
+        }
+      ],
+      default: "open"
+    });
+  }
   const manifest = {
     version: packageVersion,
     profile,
     installedAt: (/* @__PURE__ */ new Date()).toISOString(),
     components: installedComponents,
     ...role ? { role } : {},
-    ...tracking_mode ? { tracking_mode, external_provider } : {}
+    ...tracking_mode ? { tracking_mode, external_provider } : {},
+    ...subject_root !== void 0 ? { subject_root } : {},
+    ...content_sensitivity ? { content_sensitivity } : {},
+    ...push_policy ? { push_policy } : {}
   };
   await writeManifest(targetDir, manifest);
   printSuccess(`Initialized with profile "${profile}" \u2014 ${fileCount} files installed`);
+  if (push_policy === "blocked" || push_policy === "guarded") {
+    try {
+      if (push_policy === "blocked") {
+        const hook = await installPrePushHook(targetDir);
+        if (hook.status === "refused-foreign-hooks-path") {
+          printWarning(
+            `Did not install the pre-push hook: core.hooksPath is already "${hook.existing}" (set ${hook.scope === "local" ? "for this repository" : "globally"}), so another hook manager owns it. Overwriting would silently disable those hooks. Chain an Arcane pre-push guard into that directory yourself, or unset core.hooksPath first.`
+          );
+        } else {
+          printInfo("Installed a pre-push hook that blocks pushes from this repository.");
+        }
+        const urls = await disablePushUrls(targetDir);
+        if (urls.length === 0) {
+          printWarning(
+            "No remote is configured, so only the pre-push hook is active. A remote added later will NOT have its push URL disabled automatically, and a `--no-verify` push to it would succeed. Run `spell doctor` after adding one \u2014 it reports this gap."
+          );
+        } else {
+          printInfo(
+            `Disabled the push URL for: ${urls.map((u) => u.remote).join(", ")} (fetch still works).`
+          );
+        }
+        printInfo("Run `spell unblock-push` from a terminal to undo this.");
+      } else {
+        printInfo(
+          "Marked as push-guarded. No technical control was installed \u2014 check the remote is the one you intend before pushing. `spell doctor` will keep reminding you."
+        );
+      }
+    } catch (err) {
+      printWarning(
+        `Could not fully apply push-safety controls: ${err instanceof Error ? err.message : String(err)}. The manifest records push_policy: "${push_policy}", but this repository may not actually be protected. Run \`spell doctor\` to see exactly what is and isn't in place.`
+      );
+    }
+  }
   let agentsConfigured = false;
   if (hasAgents && !options.profile) {
     console.log();
@@ -2142,7 +2557,7 @@ async function runInit(options, targetDir, assetsDir, packageVersion) {
 }
 
 // src/commands/add.ts
-import { join as join5 } from "path";
+import { join as join6 } from "path";
 async function runAdd(name, options, targetDir, assetsDir, packageVersion) {
   let manifest;
   try {
@@ -2177,7 +2592,7 @@ async function runAdd(name, options, targetDir, assetsDir, packageVersion) {
   let fileCount = 0;
   const installedFiles = [];
   for (const file of component.files) {
-    const srcPath = join5(assetsDir, file);
+    const srcPath = join6(assetsDir, component.sourceOverrides?.[file] ?? file);
     if (options.dryRun) {
       console.log(`  [dry-run] Would copy: ${file}`);
     } else {
@@ -2187,7 +2602,7 @@ async function runAdd(name, options, targetDir, assetsDir, packageVersion) {
     fileCount++;
   }
   for (const dir of component.directories ?? []) {
-    const srcDirPath = join5(assetsDir, dir);
+    const srcDirPath = join6(assetsDir, dir);
     if (options.dryRun) {
       console.log(`  [dry-run] Would copy directory: ${dir}/`);
     } else {
@@ -2217,12 +2632,12 @@ async function runAdd(name, options, targetDir, assetsDir, packageVersion) {
 }
 
 // src/commands/update.ts
-import { join as join7 } from "path";
+import { join as join8 } from "path";
 
 // src/modules/hub.ts
-import { confirm as confirm2, select as select3 } from "@inquirer/prompts";
-import { readdir as readdir3, writeFile as writeFile5 } from "fs/promises";
-import { join as join6 } from "path";
+import { confirm as confirm2, select as select3, input as input3 } from "@inquirer/prompts";
+import { readdir as readdir3, writeFile as writeFile6 } from "fs/promises";
+import { join as join7 } from "path";
 var MANIFEST_RETROFITS = [
   {
     field: "role",
@@ -2241,7 +2656,7 @@ var MANIFEST_RETROFITS = [
     // Mirrors init.ts's Step 5b branching exactly (EF-14 D5): docs-only
     // profiles get a silent default, full/lite get asked.
     ask: async (manifest) => {
-      if (manifest.profile === "governance-only" || manifest.profile === "methodology") {
+      if (manifest.profile === "governance-only" || manifest.profile === "methodology" || manifest.profile === "docs") {
         return { tracking_mode: "internal", external_provider: null };
       }
       const tracking_mode = await select3({
@@ -2264,6 +2679,85 @@ var MANIFEST_RETROFITS = [
       }
       return { tracking_mode, external_provider: null };
     }
+  },
+  {
+    field: "content_sensitivity",
+    needsRetrofit: (m) => m.content_sensitivity === void 0,
+    // EF-12. Asked for every profile -- a code repo can hold sensitive records
+    // too -- and defaults to "standard", so an operator who just presses enter
+    // keeps today's behaviour exactly.
+    ask: async () => {
+      const content_sensitivity = await select3({
+        message: "How should agents treat this repository's contents?",
+        choices: [
+          {
+            value: "standard",
+            name: "Standard \u2014 agents may quote contents in journals and decisions"
+          },
+          {
+            value: "sensitive",
+            name: "Sensitive \u2014 agents reference documents by path, never transcribe them"
+          }
+        ],
+        default: "standard"
+      });
+      return { content_sensitivity };
+    }
+  },
+  {
+    field: "subject_root",
+    // EF-07. Only the docs profile is asked: other profiles describe code or a
+    // venture portfolio, where "what is this repo about" is already answered.
+    // A docs install that legitimately holds several subjects answers
+    // "portfolio" and stays unset -- so this retrofit deliberately does NOT
+    // re-ask on every update. It is gated on the field being absent AND the
+    // profile being docs, and once answered (either way) it never fires again,
+    // because "portfolio" writes an explicit empty marker.
+    needsRetrofit: (m) => m.profile === "docs" && m.subject_root === void 0,
+    ask: async () => {
+      const shape = await select3({
+        message: "What does this repository hold?",
+        choices: [
+          {
+            value: "root",
+            name: "One subject, at the repository root (documents sit alongside Arcane's files)"
+          },
+          { value: "subdir", name: "One subject, in its own directory" },
+          { value: "portfolio", name: "Several subjects or ventures" }
+        ]
+      });
+      if (shape === "root") return { subject_root: "." };
+      if (shape === "subdir") {
+        const answer = await input3({
+          message: "Directory holding the subject's documents:",
+          default: "docs",
+          validate: (v) => isValidSubjectRoot(v.trim() || "docs") || "Must be a relative path inside the repository (no leading /, drive letter, or ..)."
+        });
+        return { subject_root: answer.trim() || "docs" };
+      }
+      return { subject_root: null };
+    }
+  },
+  {
+    field: "push_policy",
+    needsRetrofit: (m) => m.push_policy === void 0,
+    // EF-09. Defaults to "open", so an operator who just presses enter keeps
+    // today's behaviour exactly. NOTE: this only records the choice -- unlike
+    // init, the retrofit does not install the hook or disable the push URL,
+    // because an update should not silently start blocking pushes in a repo
+    // someone is mid-workflow in. doctor reports the gap instead.
+    ask: async () => {
+      const push_policy = await select3({
+        message: "Should this repository be allowed to push to a remote?",
+        choices: [
+          { value: "open", name: "Yes \u2014 normal repository" },
+          { value: "guarded", name: "Sensitive, but keep push working \u2014 remind me instead" },
+          { value: "blocked", name: "No \u2014 block pushes" }
+        ],
+        default: "open"
+      });
+      return { push_policy };
+    }
   }
 ];
 async function runManifestRetrofits(manifest) {
@@ -2281,9 +2775,9 @@ async function runManifestRetrofits(manifest) {
   return patch;
 }
 async function offerRegistryScaffold(targetDir, businessRoot) {
-  const registryPath = join6(targetDir, businessRoot, "registry.json");
+  const registryPath = join7(targetDir, businessRoot, "registry.json");
   if (await fileExists(registryPath)) return;
-  const businessRootPath = join6(targetDir, businessRoot);
+  const businessRootPath = join7(targetDir, businessRoot);
   let ventureDirs;
   try {
     const entries = await readdir3(businessRootPath, { withFileTypes: true });
@@ -2321,13 +2815,32 @@ async function offerRegistryScaffold(targetDir, businessRoot) {
     updated: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10),
     ventures
   };
-  await writeFile5(registryPath, JSON.stringify(registry, null, 2) + "\n", "utf-8");
+  await writeFile6(registryPath, JSON.stringify(registry, null, 2) + "\n", "utf-8");
   console.log(
     `  \u2713 Scaffolded ${businessRoot}/registry.json with ${Object.keys(ventures).length} venture(s).`
   );
 }
 
 // src/commands/update.ts
+function migrateLegacyComponents(components) {
+  const out = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const entry of components) {
+    const replacements = LEGACY_COMPONENT_MIGRATIONS[entry.name];
+    if (!replacements) {
+      if (seen.has(entry.name)) continue;
+      seen.add(entry.name);
+      out.push(entry);
+      continue;
+    }
+    for (const name of replacements) {
+      if (seen.has(name)) continue;
+      seen.add(name);
+      out.push({ name, files: [], installedVersion: entry.installedVersion });
+    }
+  }
+  return out;
+}
 async function runUpdate(options, targetDir, assetsDir, packageVersion) {
   let manifest;
   try {
@@ -2380,7 +2893,8 @@ async function runUpdate(options, targetDir, assetsDir, packageVersion) {
   }
   let fileCount = 0;
   const updatedComponents = [];
-  for (const installed of manifest.components) {
+  const componentsToUpdate = migrateLegacyComponents(manifest.components);
+  for (const installed of componentsToUpdate) {
     let component;
     try {
       component = getComponent(installed.name);
@@ -2394,8 +2908,15 @@ async function runUpdate(options, targetDir, assetsDir, packageVersion) {
     }
     const updatedFiles = [];
     for (const file of component.files) {
-      const srcPath = join7(assetsDir, file);
-      const preserveExisting = component.skipExisting && await fileExists(join7(targetDir, file));
+      const srcPath = join8(assetsDir, component.sourceOverrides?.[file] ?? file);
+      const targetExists = await fileExists(join8(targetDir, file));
+      const preserveExisting = Boolean(component.skipExisting) && targetExists;
+      if (component.initOnly && !targetExists) {
+        console.log(
+          `  ! Missing: ${file} \u2014 not added automatically, because doing so would change how Git treats existing files. Run "spell add ${component.name}" if you want it.`
+        );
+        continue;
+      }
       if (preserveExisting) {
         console.log(`  ${options.dryRun ? "[dry-run] Would preserve" : "Preserved"}: ${file}`);
       } else if (options.dryRun) {
@@ -2405,10 +2926,12 @@ async function runUpdate(options, targetDir, assetsDir, packageVersion) {
         await copyFile(srcPath, targetDir, file, { force: true });
         fileCount++;
       }
-      updatedFiles.push(file);
+      if (!preserveExisting || installed.files.includes(file)) {
+        updatedFiles.push(file);
+      }
     }
     for (const dir of component.directories ?? []) {
-      const srcDirPath = join7(assetsDir, dir);
+      const srcDirPath = join8(assetsDir, dir);
       if (options.dryRun) {
         console.log(`  [dry-run] Would update directory: ${dir}/`);
       } else {
@@ -2436,7 +2959,16 @@ async function runUpdate(options, targetDir, assetsDir, packageVersion) {
     }
     return;
   }
-  const retrofitPatch = await runManifestRetrofits(manifest);
+  const interactive = Boolean(process.stdin.isTTY);
+  const retrofitPatch = interactive ? await runManifestRetrofits(manifest) : {};
+  if (!interactive) {
+    const pending = MANIFEST_RETROFITS.filter((r) => r.needsRetrofit(manifest));
+    if (pending.length > 0) {
+      console.log(
+        `  ! Skipped ${pending.length} manifest question${pending.length === 1 ? "" : "s"} (${pending.map((r) => r.field).join(", ")}) \u2014 no interactive terminal. Run \`spell update\` from a terminal to answer.`
+      );
+    }
+  }
   const updated = {
     ...manifest,
     version: packageVersion,
@@ -2454,8 +2986,8 @@ async function runUpdate(options, targetDir, assetsDir, packageVersion) {
 }
 
 // src/modules/version-check.ts
-import { readFile as readFile4, writeFile as writeFile6, mkdir as mkdir4 } from "fs/promises";
-import { dirname, join as join8 } from "path";
+import { readFile as readFile5, writeFile as writeFile7, mkdir as mkdir5 } from "fs/promises";
+import { dirname, join as join9 } from "path";
 import { homedir as homedir2 } from "os";
 import { createRequire } from "module";
 var require2 = createRequire(import.meta.url);
@@ -2469,11 +3001,11 @@ function getFeedUrl() {
   }
   return url;
 }
-var DEFAULT_CACHE_PATH = join8(homedir2(), ".arcane", "version-cache.json");
+var DEFAULT_CACHE_PATH = join9(homedir2(), ".arcane", "version-cache.json");
 var CACHE_TTL_MS = 24 * 60 * 60 * 1e3;
 async function readCache(cachePath) {
   try {
-    const content = await readFile4(cachePath, "utf-8");
+    const content = await readFile5(cachePath, "utf-8");
     const parsed = JSON.parse(content);
     if (typeof parsed.latest !== "string" || typeof parsed.checkedAt !== "string") {
       return null;
@@ -2484,9 +3016,9 @@ async function readCache(cachePath) {
   }
 }
 async function writeCache(cachePath, latest) {
-  await mkdir4(dirname(cachePath), { recursive: true });
+  await mkdir5(dirname(cachePath), { recursive: true });
   const entry = { latest, checkedAt: (/* @__PURE__ */ new Date()).toISOString() };
-  await writeFile6(cachePath, JSON.stringify(entry, null, 2), "utf-8");
+  await writeFile7(cachePath, JSON.stringify(entry, null, 2), "utf-8");
 }
 async function getLatestVersion(feedUrl) {
   const normalizedBase = feedUrl.endsWith("/") ? feedUrl : feedUrl + "/";
@@ -2599,7 +3131,7 @@ async function runStatus(targetDir, packageVersion) {
 
 // src/commands/uninstall.ts
 import { rm as rm2 } from "fs/promises";
-import { join as join9 } from "path";
+import { join as join10 } from "path";
 import { confirm as confirm3 } from "@inquirer/prompts";
 async function runUninstall(options, targetDir) {
   let manifest;
@@ -2642,7 +3174,7 @@ async function runUninstall(options, targetDir) {
   let removed = 0;
   for (const component of manifest.components) {
     for (const file of component.files) {
-      const filePath = join9(targetDir, file);
+      const filePath = join10(targetDir, file);
       try {
         await rm2(filePath, { force: true });
         removed++;
@@ -2650,16 +3182,16 @@ async function runUninstall(options, targetDir) {
       }
     }
   }
-  await rm2(join9(targetDir, ".arcane.json"), { force: true });
+  await rm2(join10(targetDir, ".arcane.json"), { force: true });
   const agentDirs = [
     ".github/agents",
     ".arcane/agents",
     ".arcane/generated"
   ];
   for (const dir of agentDirs) {
-    await rm2(join9(targetDir, dir), { recursive: true, force: true });
+    await rm2(join10(targetDir, dir), { recursive: true, force: true });
   }
-  await rm2(join9(targetDir, ".arcane/agents.yaml"), { force: true });
+  await rm2(join10(targetDir, ".arcane/agents.yaml"), { force: true });
   const markerFiles = [
     "CLAUDE.md",
     "AGENTS.md",
@@ -2673,8 +3205,8 @@ async function runUninstall(options, targetDir) {
 }
 
 // src/commands/doctor.ts
-import { access as access3, readFile as readFile5, mkdir as mkdir5, copyFile as fsCopyFile2 } from "fs/promises";
-import { join as join10, dirname as dirname2 } from "path";
+import { access as access3, readFile as readFile6, mkdir as mkdir6, copyFile as fsCopyFile2 } from "fs/promises";
+import { join as join11, dirname as dirname2 } from "path";
 import { execFile as execFile2 } from "child_process";
 import { promisify } from "util";
 
@@ -2762,8 +3294,8 @@ async function checkVSCodeExtension(id, label) {
   const name = `VS Code extension: ${label}`;
   const home = process.env["HOME"] ?? "";
   const extDirs = [
-    join10(home, ".vscode", "extensions"),
-    join10(home, ".vscode-insiders", "extensions")
+    join11(home, ".vscode", "extensions"),
+    join11(home, ".vscode-insiders", "extensions")
   ];
   for (const dir of extDirs) {
     try {
@@ -2797,13 +3329,13 @@ async function checkVSCodeExtension(id, label) {
 }
 async function checkArcaneManifest(targetDir) {
   const name = "Arcane manifest (.arcane.json)";
-  const manifestPath2 = join10(targetDir, ".arcane.json");
+  const manifestPath2 = join11(targetDir, ".arcane.json");
   try {
     await access3(manifestPath2);
   } catch {
-    const selfHostedManifestPath = join10(targetDir, "src", "assets", ".arcane.json");
+    const selfHostedManifestPath = join11(targetDir, "src", "assets", ".arcane.json");
     try {
-      const raw = await readFile5(selfHostedManifestPath, "utf8");
+      const raw = await readFile6(selfHostedManifestPath, "utf8");
       const manifest = JSON.parse(raw);
       if (manifest.selfHosted === true && manifest.tracking_mode === "internal") {
         return {
@@ -2822,7 +3354,7 @@ async function checkArcaneManifest(targetDir) {
     };
   }
   try {
-    const raw = await readFile5(manifestPath2, "utf8");
+    const raw = await readFile6(manifestPath2, "utf8");
     const manifest = JSON.parse(raw);
     if (!manifest.version || !Array.isArray(manifest.components)) {
       return {
@@ -2893,7 +3425,7 @@ async function checkSessionContinuity(targetDir) {
   const results = [];
   for (const file of SESSION_CONTINUITY_FILES) {
     const name = `Session file: ${file}`;
-    const filePath = join10(targetDir, file);
+    const filePath = join11(targetDir, file);
     try {
       await access3(filePath);
       results.push({ name, passed: true, message: "present" });
@@ -2911,18 +3443,69 @@ async function checkSessionContinuity(targetDir) {
 async function fixSessionContinuity(targetDir, assetsDir) {
   const created = [];
   for (const file of SESSION_CONTINUITY_FILES) {
-    const destPath = join10(targetDir, file);
+    const destPath = join11(targetDir, file);
     try {
       await access3(destPath);
     } catch {
-      const srcPath = join10(assetsDir, file);
-      await mkdir5(dirname2(destPath), { recursive: true });
+      const srcPath = join11(assetsDir, file);
+      await mkdir6(dirname2(destPath), { recursive: true });
       await fsCopyFile2(srcPath, destPath);
       created.push(file);
     }
   }
   return created;
 }
+async function checkPushPolicy(targetDir) {
+  const name = "Push policy (EF-09)";
+  let manifest;
+  try {
+    manifest = await readManifest(targetDir);
+  } catch {
+    return { name, passed: true, message: "not initialized \u2014 nothing to check" };
+  }
+  const policy = manifest.push_policy ?? "open";
+  if (policy === "open") {
+    return { name, passed: true, message: "open \u2014 pushes allowed" };
+  }
+  if (policy === "guarded") {
+    const remotes2 = await listRemotes(targetDir);
+    const where = remotes2.length === 0 ? "none configured" : remotes2.join(", ");
+    return {
+      name,
+      passed: false,
+      blocking: false,
+      message: `guarded \u2014 no technical control installed. Push targets: ${where}. Confirm those are the remotes you intend before pushing.`
+    };
+  }
+  const hookActive = await isHookEnforced(targetDir);
+  const remotes = await listRemotes(targetDir);
+  const open = await undisabledRemotes(targetDir);
+  if (hookActive && open.length === 0) {
+    if (remotes.length === 0) {
+      return {
+        name,
+        passed: false,
+        blocking: false,
+        message: "blocked \u2014 pre-push hook in place, but no remote is configured, so no push URL is disabled. If a remote is added later, run `spell doctor` again: a --no-verify push to it would succeed until the URL is disabled too."
+      };
+    }
+    return {
+      name,
+      passed: true,
+      message: `blocked \u2014 pre-push hook in place and push URL disabled for ${remotes.join(", ")}`
+    };
+  }
+  const missing = [
+    hookActive ? null : "pre-push hook (config or hook file absent)",
+    open.length > 0 ? `push URL still live for: ${open.join(", ")}` : null
+  ].filter(Boolean);
+  return {
+    name,
+    passed: false,
+    blocking: false,
+    message: `declared "blocked" but not enforced \u2014 ${missing.join("; ")}. The manifest claims a protection this repository does not have.`
+  };
+}
 async function runDoctor(targetDir, options = {}, assetsDir) {
   console.log("\nspell doctor \u2014 checking your Arcane environment\n");
   const results = await Promise.all([
@@ -2930,7 +3513,8 @@ async function runDoctor(targetDir, options = {}, assetsDir) {
     checkVSCodeExtension("GitHub.copilot-chat", "GitHub Copilot (Chat)"),
     checkArcaneManifest(targetDir),
     Promise.resolve(checkIncidentReleaseGate()),
-    checkPullRebase(targetDir)
+    checkPullRebase(targetDir),
+    checkPushPolicy(targetDir)
   ]);
   const sessionResults = await checkSessionContinuity(targetDir);
   results.push(...sessionResults);
@@ -2974,17 +3558,83 @@ async function runDoctor(targetDir, options = {}, assetsDir) {
   }
 }
 
+// src/commands/unblock-push.ts
+import { basename, resolve } from "path";
+import { input as input4 } from "@inquirer/prompts";
+async function runUnblockPush(targetDir) {
+  let manifest;
+  try {
+    manifest = await readManifest(targetDir);
+  } catch (err) {
+    if (err instanceof ManifestNotFoundError) {
+      console.error('Not initialized. Run "spell init" first.');
+      process.exit(1);
+      return;
+    }
+    throw err;
+  }
+  const policy = manifest.push_policy ?? "open";
+  if (policy === "open") {
+    printInfo("This repository is not push-blocked \u2014 nothing to undo.");
+    return;
+  }
+  if (!process.stdin.isTTY) {
+    console.error(
+      "spell unblock-push must be run from an interactive terminal.\nLifting a push block is a deliberate decision, so it cannot be scripted, piped, or run in CI."
+    );
+    process.exit(1);
+    return;
+  }
+  const repoName = basename(resolve(targetDir));
+  if (repoName === "") {
+    console.error(
+      "Could not determine a repository name to confirm against (is this repository at a filesystem root?). Refusing to unblock."
+    );
+    process.exit(1);
+    return;
+  }
+  printWarning(`This repository's push_policy is "${policy}".`);
+  printInfo(
+    "Unblocking restores the ability to push this repository's full history to its remote. Deleting a file later does not undo a push: the content stays in history, in any clone already made, and in the remote's own backups."
+  );
+  console.log();
+  const typed = await input4({
+    message: `Type the repository name to confirm (${repoName}):`
+  });
+  if (typed.trim() !== repoName) {
+    console.error(`
+Name did not match ("${typed.trim()}" \u2260 "${repoName}"). Nothing changed.`);
+    process.exit(1);
+    return;
+  }
+  await removePrePushHook(targetDir);
+  const restored = await restorePushUrls(targetDir);
+  const updated = {
+    ...manifest,
+    push_policy: "open",
+    push_policy_unblocked_at: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  await writeManifest(targetDir, updated);
+  printSuccess(`Push unblocked for "${repoName}".`);
+  if (restored.length > 0) {
+    printInfo(`Restored push URL for: ${restored.join(", ")}.`);
+  }
+  printInfo(
+    "Recorded in .arcane.json as push_policy: open, with the time it was lifted. Commit that change so the repository's actual posture stays visible to everyone."
+  );
+}
+
 // src/index.ts
 import { realpathSync } from "fs";
 var require3 = createRequire2(import.meta.url);
 var pkg = require3("../package.json");
-var ASSETS_DIR = process.env["ARCANE_ASSETS_DIR"] ?? join11(dirname3(fileURLToPath(import.meta.url)), "assets");
+var ASSETS_DIR = process.env["ARCANE_ASSETS_DIR"] ?? join12(dirname3(fileURLToPath(import.meta.url)), "assets");
 var program = new Command();
 program.name("spell").description("Arcane framework CLI \u2014 scaffold and manage governance files").version(pkg.version).action(async () => {
   await printWelcome(pkg.version, process.cwd());
   program.outputHelp();
 });
-program.command("init").description("Scaffold Arcane framework files into the current repository").option("--profile <profile>", "Profile: full | lite | methodology | governance-only").option("--force", "Overwrite existing files without error").option("--dry-run", "Preview what would be installed without making changes").action(
+program.command("init").description("Scaffold Arcane framework files into the current repository").option("--profile <profile>", "Profile: full | lite | methodology | docs | governance-only").option("--force", "Overwrite existing files without error").option("--dry-run", "Preview what would be installed without making changes").action(
   async (opts) => {
     await runInit(
       {
@@ -3023,6 +3673,9 @@ program.command("status").description("Show installed components and check for u
 program.command("uninstall").description("Remove all installed Arcane framework files").option("--yes", "Skip confirmation prompt").option("--dry-run", "Preview what would be removed without deleting files").action(async (opts) => {
   await runUninstall({ yes: opts.yes, dryRun: opts.dryRun }, process.cwd());
 });
+program.command("unblock-push").description("Lift this repository's push block (interactive terminal only)").action(async () => {
+  await runUnblockPush(process.cwd());
+});
 program.command("doctor").description("Check your environment for Arcane prerequisites").option("--fix", "Automatically create missing session continuity files").action(async (opts) => {
   await runDoctor(process.cwd(), { fix: opts.fix }, ASSETS_DIR);
 });