@pennixrv/trellis 0.6.17

package/dist/cli/index.js

@@ -0,0 +1,299 @@
+import fs from "node:fs";
+import path from "node:path";
+import chalk from "chalk";
+import { Command } from "commander";
+import { init } from "../commands/init.js";
+import { update } from "../commands/update.js";
+import { upgrade } from "../commands/upgrade.js";
+import { uninstall } from "../commands/uninstall.js";
+import { ablate, restore } from "../commands/ablate.js";
+import { runMem } from "../commands/mem.js";
+import { runWorkflowCommand, WorkflowCommandError, } from "../commands/workflow.js";
+import { registerChannelCommand } from "../commands/channel/index.js";
+import { DIR_NAMES } from "../constants/paths.js";
+import { PACKAGE_NAME, VERSION } from "../constants/version.js";
+import { compareVersions } from "../utils/compare-versions.js";
+import { getConfiguredPlatforms } from "../configurators/index.js";
+import { AI_TOOLS } from "../types/ai-tools.js";
+// Re-export for backwards compatibility (consumers should prefer constants/version.js)
+export { VERSION, PACKAGE_NAME };
+/**
+ * Check if a Trellis update is available (compare project version with CLI version)
+ */
+function checkForUpdates(cwd) {
+    const versionFile = path.join(cwd, DIR_NAMES.WORKFLOW, ".version");
+    if (!fs.existsSync(versionFile))
+        return;
+    const projectVersion = fs.readFileSync(versionFile, "utf-8").trim();
+    const cliVersion = VERSION;
+    const comparison = compareVersions(cliVersion, projectVersion);
+    if (comparison > 0) {
+        // CLI is newer than project - update available
+        console.log(chalk.yellow(`\n⚠️  Trellis update available: ${projectVersion} → ${cliVersion}`));
+        console.log(chalk.gray(`   Run: trellis update\n`));
+    }
+    else if (comparison < 0) {
+        // CLI is older than project - CLI needs updating
+        console.log(chalk.yellow(`\n⚠️  Your CLI (${cliVersion}) is older than project (${projectVersion})`));
+        console.log(chalk.gray(`   Run: trellis upgrade\n`));
+    }
+}
+// Check for updates at CLI startup (only if .trellis exists)
+const cwd = process.cwd();
+if (fs.existsSync(path.join(cwd, DIR_NAMES.WORKFLOW))) {
+    checkForUpdates(cwd);
+}
+const program = new Command();
+program
+    .name("trellis")
+    .description("AI-assisted development workflow framework for Cursor, Claude Code and more")
+    .version(VERSION, "-v, --version", "output the version number");
+program
+    .command("init")
+    .description("Initialize trellis in the current project")
+    .option("--cursor", "Include Cursor commands")
+    .option("--claude", "Include Claude Code commands")
+    .option("--opencode", "Include OpenCode commands")
+    .option("--codex", "Include Codex skills")
+    .option("--kilo", "Include Kilo CLI commands")
+    .option("--kiro", "Include Kiro Code skills")
+    .option("--gemini", "Include Gemini CLI commands")
+    .option("--antigravity", "Include Antigravity workflows")
+    .option("--devin", "Include Devin workflows")
+    .option("--windsurf", "Deprecated alias for --devin (Windsurf was renamed)")
+    .option("--qoder", "Include Qoder commands")
+    .option("--codebuddy", "Include CodeBuddy commands")
+    .option("--copilot", "Include GitHub Copilot hooks")
+    .option("--droid", "Include Factory Droid commands")
+    .option("--dsh", "Include DeepSeek Harness (dsh) skills")
+    .option("--pi", "Include Pi Agent extension assets")
+    .option("--reasonix", "Include Reasonix skills")
+    .option("--zcode", "Include ZCode commands")
+    .option("--omp", "Include Oh My Pi extension assets")
+    .option("--trae", "Include Trae IDE commands")
+    .option("--grok", "Include Grok Build skills and agents")
+    .option("--kimi", "Include Kimi Code skills")
+    .option("--snow", "Include Snow CLI skills and commands")
+    .option("--with-statusline", "Install the Trellis statusLine for Claude Code (off by default)")
+    .option("-y, --yes", "Skip prompts and use defaults")
+    .option("-u, --user <name>", "Initialize developer identity with specified name")
+    .option("-f, --force", "Overwrite existing files without asking")
+    .option("-s, --skip-existing", "Skip existing files without asking")
+    .option("--monorepo", "Force monorepo mode")
+    .option("--no-monorepo", "Skip monorepo detection")
+    .option("-t, --template <name>", "Use a remote spec template (e.g., electron-fullstack)")
+    .option("--overwrite", "Overwrite existing spec directory when using template")
+    .option("--append", "Only add missing files when using template")
+    .option("-r, --registry <source>", "Use a custom template registry (e.g., gh:myorg/myrepo/specs)")
+    .option("--workflow <id>", "Workflow template id for .trellis/workflow.md (default: native; e.g., tdd, channel-driven-subagent-dispatch)")
+    .option("--workflow-source <source>", "Custom marketplace source for the --workflow lookup (e.g., gh:myorg/myrepo/marketplace)")
+    .action(async (options) => {
+    try {
+        // Deprecated alias: --windsurf → --devin (Windsurf was renamed to Devin).
+        if (options.windsurf) {
+            console.log(chalk.yellow("⚠ --windsurf is deprecated (Windsurf was renamed to Devin). Use --devin instead."));
+            options.devin = true;
+            delete options.windsurf;
+        }
+        await init(options);
+    }
+    catch (error) {
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        if (process.env.DEBUG || process.env.TRELLIS_DEBUG) {
+            console.error(error instanceof Error ? error.stack : error);
+        }
+        process.exit(1);
+    }
+});
+program
+    .command("update")
+    .description("Update trellis configuration and commands to latest version")
+    .option("--dry-run", "Preview changes without applying them")
+    .option("-f, --force", "Overwrite all changed files without asking")
+    .option("-s, --skip-all", "Skip all changed files without asking")
+    .option("-n, --create-new", "Create .new copies for all changed files")
+    .option("--allow-downgrade", "Allow downgrading to an older version")
+    .option("--migrate", "Apply pending file migrations (renames/deletions)")
+    .action(async (options) => {
+    try {
+        await update({
+            dryRun: options.dryRun,
+            force: options.force,
+            skipAll: options.skipAll,
+            createNew: options.createNew,
+            allowDowngrade: options.allowDowngrade,
+            migrate: options.migrate,
+        });
+    }
+    catch (error) {
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        if (process.env.DEBUG || process.env.TRELLIS_DEBUG) {
+            console.error(error instanceof Error ? error.stack : error);
+        }
+        process.exit(1);
+    }
+});
+program
+    .command("upgrade")
+    .description("Upgrade the global Trellis CLI package")
+    .option("--tag <tag>", "npm dist-tag or version to install (default follows current channel: latest, beta, or rc)")
+    .option("--dry-run", "Print the install command without running it")
+    .action(async (options) => {
+    try {
+        await upgrade({
+            tag: options.tag,
+            dryRun: options.dryRun,
+        });
+    }
+    catch (error) {
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        if (process.env.DEBUG || process.env.TRELLIS_DEBUG) {
+            console.error(error instanceof Error ? error.stack : error);
+        }
+        process.exit(1);
+    }
+});
+program
+    .command("uninstall")
+    .description("Remove all trellis files (managed platform files + .trellis/) from this project")
+    .option("-y, --yes", "Skip confirmation prompt")
+    .option("--dry-run", "List what would be removed without changing anything")
+    .action(async (options) => {
+    try {
+        await uninstall({
+            yes: options.yes,
+            dryRun: options.dryRun,
+        });
+    }
+    catch (error) {
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        if (process.env.DEBUG || process.env.TRELLIS_DEBUG) {
+            console.error(error instanceof Error ? error.stack : error);
+        }
+        process.exit(1);
+    }
+});
+program
+    .command("ablate")
+    .description("Temporarily remove all project Trellis surfaces with an external recovery transaction")
+    .option("-y, --yes", "Skip confirmation prompt")
+    .option("--dry-run", "Preview full ablation without changing files or state")
+    .action(async (options) => {
+    try {
+        await ablate({
+            yes: options.yes,
+            dryRun: options.dryRun,
+        });
+    }
+    catch (error) {
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        if (process.env.DEBUG || process.env.TRELLIS_DEBUG) {
+            console.error(error instanceof Error ? error.stack : error);
+        }
+        process.exit(1);
+    }
+});
+program
+    .command("restore")
+    .description("Restore the exact project state saved by `trellis ablate`")
+    .option("-y, --yes", "Skip confirmation prompt")
+    .option("--dry-run", "Preview restoration and check conflicts")
+    .action(async (options) => {
+    try {
+        await restore({
+            yes: options.yes,
+            dryRun: options.dryRun,
+        });
+    }
+    catch (error) {
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        if (process.env.DEBUG || process.env.TRELLIS_DEBUG) {
+            console.error(error instanceof Error ? error.stack : error);
+        }
+        process.exit(1);
+    }
+});
+program
+    .command("mem")
+    .description("Search/recall AI conversation history across Claude Code, Codex, OpenCode, Pi (run 'trellis mem help' for subcommands and flags)")
+    .allowUnknownOption(true)
+    .helpOption(false)
+    .argument("[args...]", "subcommand and arguments (list|search|context|extract|projects|help)")
+    .action((args = []) => {
+    try {
+        runMem(args);
+    }
+    catch (error) {
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        if (process.env.DEBUG || process.env.TRELLIS_DEBUG) {
+            console.error(error instanceof Error ? error.stack : error);
+        }
+        process.exit(1);
+    }
+});
+program
+    .command("workflow")
+    .description("List or switch the project's .trellis/workflow.md template (native, tdd, channel-driven-subagent-dispatch, or marketplace)")
+    .option("-t, --template <id>", "Workflow template id (e.g., native, tdd, channel-driven-subagent-dispatch)")
+    .option("-m, --marketplace <source>", "Custom marketplace source (e.g., gh:myorg/myrepo/marketplace)")
+    .option("--list", "List available workflow templates and exit")
+    .option("-f, --force", "Overwrite a modified workflow.md without asking")
+    .option("-n, --create-new", "Write .trellis/workflow.md.new instead of replacing the active workflow")
+    .action(async (options) => {
+    try {
+        await runWorkflowCommand({
+            template: options.template,
+            marketplace: options.marketplace,
+            list: options.list,
+            force: options.force,
+            createNew: options.createNew,
+        });
+    }
+    catch (error) {
+        if (error instanceof WorkflowCommandError) {
+            console.error(chalk.red("Error:"), error.message);
+            process.exit(1);
+        }
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        if (process.env.DEBUG || process.env.TRELLIS_DEBUG) {
+            console.error(error instanceof Error ? error.stack : error);
+        }
+        process.exit(1);
+    }
+});
+program
+    .command("platforms")
+    .description("Show which AI platforms are configured (active) in the current project")
+    .option("--json", "Output machine-readable JSON")
+    .action((options) => {
+    try {
+        const configured = getConfiguredPlatforms(cwd);
+        const platforms = [...configured].map((id) => ({
+            id,
+            displayName: AI_TOOLS[id].name,
+            configDir: AI_TOOLS[id].configDir,
+        }));
+        if (options.json) {
+            console.log(JSON.stringify({ platforms }, null, 2));
+            return;
+        }
+        if (platforms.length === 0) {
+            console.log(chalk.gray("No platforms configured in this project."));
+            return;
+        }
+        console.log(chalk.bold("Configured platforms:"));
+        for (const p of platforms) {
+            console.log(`  ${p.displayName} (${p.id}) — ${p.configDir}`);
+        }
+    }
+    catch (error) {
+        console.error(chalk.red("Error:"), error instanceof Error ? error.message : error);
+        if (process.env.DEBUG || process.env.TRELLIS_DEBUG) {
+            console.error(error instanceof Error ? error.stack : error);
+        }
+        process.exit(1);
+    }
+});
+registerChannelCommand(program);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/ablate.d.ts

@@ -0,0 +1,14 @@
+/** Full, reversible project-level Trellis ablation and exact restoration. */
+import { ABLATION_STATE_ROOT_ENV } from "../utils/ablation-store.js";
+export interface AblateOptions {
+    yes?: boolean;
+    dryRun?: boolean;
+}
+export interface RestoreOptions {
+    yes?: boolean;
+    dryRun?: boolean;
+}
+export declare function ablate(options?: AblateOptions): Promise<void>;
+export declare function restore(options?: RestoreOptions): Promise<void>;
+export { ABLATION_STATE_ROOT_ENV };
+//# sourceMappingURL=ablate.d.ts.map

package/dist/commands/ablate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ablate.d.ts","sourceRoot":"","sources":["../../src/commands/ablate.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAa7E,OAAO,EACL,uBAAuB,EAiBxB,MAAM,4BAA4B,CAAC;AAepC,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AA8SD,wBAAsB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsGvE;AAED,wBAAsB,OAAO,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCzE;AAED,OAAO,EAAE,uBAAuB,EAAE,CAAC"}

package/dist/commands/ablate.js

@@ -0,0 +1,307 @@
+/** Full, reversible project-level Trellis ablation and exact restoration. */
+import fs from "node:fs";
+import path from "node:path";
+import readline from "node:readline";
+import chalk from "chalk";
+import inquirer from "inquirer";
+import { ALL_MANAGED_DIRS, getConfiguredPlatforms, } from "../configurators/index.js";
+import { DIR_NAMES } from "../constants/paths.js";
+import { ABLATION_STATE_ROOT_ENV, assertExternalStateRoot, canonicalProjectRoot, expectedFileFingerprint, fingerprintPath, getAblationStateRoot, getTransactionPaths, loadAblationTransaction, rollbackAblationTransaction, restoreAblationTransaction, stageAblationTransaction, transitionAblationState, verifyAblatedState, withAblationProjectLock, } from "../utils/ablation-store.js";
+import { writeFileAtomic } from "../utils/atomic-write.js";
+import { homedirBypassEnabled, homedirGuardMessage, isCwdHomedir, } from "../utils/cwd-guard.js";
+import { buildManagedRemovalPlan, lstatIfPresent, } from "../utils/managed-removal.js";
+import { pruneOrphanManifestKeys } from "../utils/manifest-prune.js";
+import { loadHashes } from "../utils/template-hash.js";
+function isTrellisPath(relativePath) {
+    return (relativePath === DIR_NAMES.WORKFLOW ||
+        relativePath.startsWith(`${DIR_NAMES.WORKFLOW}/`));
+}
+function backupPath(relativePath) {
+    return `backup/${relativePath}`;
+}
+function promptContinue(message) {
+    return inquirer
+        .prompt([{ type: "confirm", name: "proceed", message, default: true }])
+        .then(({ proceed }) => proceed);
+}
+function refuseNonInteractivePrompt(command) {
+    console.error(chalk.red(`Refusing to prompt for ${command} confirmation in a non-interactive shell. ` +
+        "Pass --yes/-y to confirm or --dry-run to preview."));
+    readline.createInterface({ input: process.stdin }).close();
+    process.exit(1);
+}
+function assertCommandCwd(command) {
+    if (isCwdHomedir() && !homedirBypassEnabled()) {
+        console.error(chalk.red(homedirGuardMessage(command)));
+        process.exit(1);
+    }
+}
+function renderAblatePlan(plan, prunableDirectories, transactionDir) {
+    const deletions = plan.deletions.filter((entry) => !entry.missing && !isTrellisPath(entry.posixPath));
+    console.log(chalk.bold("\nTrellis full ablation plan\n"));
+    console.log(chalk.red.bold(`Will be removed (${deletions.length + 1} managed entries):`));
+    for (const entry of deletions)
+        console.log(`  ${chalk.red("-")} ${entry.posixPath}`);
+    console.log(`  ${chalk.red("-")} ${DIR_NAMES.WORKFLOW}/`);
+    if (plan.modifications.length > 0) {
+        console.log(chalk.yellow.bold(`\nWill be scrubbed (${plan.modifications.length} mixed files):`));
+        for (const entry of plan.modifications) {
+            console.log(`  ${chalk.yellow("~")} ${entry.posixPath}`);
+        }
+    }
+    if (prunableDirectories.length > 0) {
+        console.log(chalk.gray(`\n${prunableDirectories.length} empty managed directories will be pruned.`));
+    }
+    console.log(chalk.gray(`\nRecovery transaction: ${transactionDir}`));
+    console.log(chalk.yellow("Recovery copies exact .trellis task/spec/workspace bytes, which may contain user-authored sensitive text. " +
+        "The private transaction is retained until verified restore.\n"));
+}
+function renderRestorePlan(transaction) {
+    console.log(chalk.bold("\nTrellis restore plan\n"));
+    console.log(`Will restore ${transaction.state.entries.length} managed path(s) from ${transaction.paths.transactionDir}`);
+    console.log(chalk.gray(`Transaction created with Trellis ${transaction.state.trellisVersion} at ${transaction.state.createdAt}.\n`));
+}
+function relativeFromRoot(projectRoot, absPath) {
+    return path.relative(projectRoot, absPath).split(path.sep).join("/");
+}
+function isManagedDirectoryTerritory(relativeDir) {
+    if (relativeDir === DIR_NAMES.WORKFLOW || isTrellisPath(relativeDir)) {
+        return false;
+    }
+    return ALL_MANAGED_DIRS.filter((managedDir) => managedDir !== DIR_NAMES.WORKFLOW).some((root) => relativeDir === root ||
+        relativeDir.startsWith(`${root}/`) ||
+        root.startsWith(`${relativeDir}/`));
+}
+/** Predict directories that become empty after every planned deletion. */
+function collectPrunableDirectories(projectRoot, plan) {
+    const deleted = new Set(plan.deletions
+        .filter((entry) => !entry.missing && !isTrellisPath(entry.posixPath))
+        .map((entry) => path.resolve(entry.absPath)));
+    const candidates = new Set();
+    for (const deletedPath of deleted) {
+        let current = path.dirname(deletedPath);
+        while (current !== projectRoot &&
+            current.startsWith(`${projectRoot}${path.sep}`)) {
+            const relative = relativeFromRoot(projectRoot, current);
+            if (!isManagedDirectoryTerritory(relative))
+                break;
+            candidates.add(current);
+            current = path.dirname(current);
+        }
+    }
+    const memo = new Map();
+    const willBeEmpty = (directory) => {
+        const cached = memo.get(directory);
+        if (cached !== undefined)
+            return cached;
+        const stat = lstatIfPresent(directory);
+        if (!stat || !stat.isDirectory() || stat.isSymbolicLink()) {
+            memo.set(directory, false);
+            return false;
+        }
+        const empty = fs.readdirSync(directory).every((name) => {
+            const child = path.join(directory, name);
+            if (deleted.has(path.resolve(child)))
+                return true;
+            const childStat = lstatIfPresent(child);
+            return Boolean(childStat?.isDirectory() &&
+                !childStat.isSymbolicLink() &&
+                candidates.has(child) &&
+                willBeEmpty(child));
+        });
+        memo.set(directory, empty);
+        return empty;
+    };
+    return [...candidates]
+        .filter((directory) => willBeEmpty(directory))
+        .map((directory) => relativeFromRoot(projectRoot, directory))
+        .sort((left, right) => right.split("/").length - left.split("/").length);
+}
+function addEntry(entries, seen, relativePath, pre, expectedAblated) {
+    if (seen.has(relativePath))
+        return;
+    seen.add(relativePath);
+    entries.push({
+        relativePath,
+        pre,
+        expectedAblated,
+        ...(pre.kind === "absent" ? {} : { backupPath: backupPath(relativePath) }),
+    });
+}
+function buildAblationEntries(projectRoot, plan, prunableDirectories) {
+    const entries = [];
+    const seen = new Set();
+    for (const deletion of plan.deletions) {
+        if (isTrellisPath(deletion.posixPath))
+            continue;
+        const pre = fingerprintPath(deletion.absPath);
+        if (pre.kind === "directory") {
+            throw new Error(`Manifest entry is a directory rather than a managed leaf: ${deletion.posixPath}`);
+        }
+        addEntry(entries, seen, deletion.posixPath, pre, { kind: "absent" });
+    }
+    for (const modification of plan.modifications) {
+        const pre = fingerprintPath(modification.absPath);
+        if (pre.kind !== "file") {
+            throw new Error(`Mixed managed path is not a regular file: ${modification.posixPath}`);
+        }
+        addEntry(entries, seen, modification.posixPath, pre, expectedFileFingerprint(modification.result.content, pre.mode));
+    }
+    for (const relativeDir of prunableDirectories) {
+        addEntry(entries, seen, relativeDir, fingerprintPath(path.join(projectRoot, ...relativeDir.split("/"))), { kind: "absent" });
+    }
+    const trellisPath = path.join(projectRoot, DIR_NAMES.WORKFLOW);
+    addEntry(entries, seen, DIR_NAMES.WORKFLOW, fingerprintPath(trellisPath), {
+        kind: "absent",
+    });
+    return entries;
+}
+function applyAblationPlan(projectRoot, plan, prunableDirectories, transaction) {
+    const preByPath = new Map(transaction.state.entries.map((entry) => [entry.relativePath, entry.pre]));
+    for (const modification of plan.modifications) {
+        writeFileAtomic(modification.absPath, modification.result.content);
+        const pre = preByPath.get(modification.posixPath);
+        if (process.platform !== "win32" && pre?.kind === "file") {
+            fs.chmodSync(modification.absPath, pre.mode);
+        }
+    }
+    for (const deletion of plan.deletions) {
+        if (deletion.missing || isTrellisPath(deletion.posixPath))
+            continue;
+        const stat = fs.lstatSync(deletion.absPath);
+        if (stat.isDirectory() && !stat.isSymbolicLink()) {
+            throw new Error(`Refusing to unlink managed directory: ${deletion.posixPath}`);
+        }
+        fs.unlinkSync(deletion.absPath);
+    }
+    const trellisPath = path.join(projectRoot, DIR_NAMES.WORKFLOW);
+    const trellisStat = lstatIfPresent(trellisPath);
+    if (trellisStat?.isSymbolicLink()) {
+        fs.unlinkSync(trellisPath);
+    }
+    else if (trellisStat) {
+        fs.rmSync(trellisPath, { recursive: true, force: false });
+    }
+    for (const relativeDir of prunableDirectories) {
+        const directory = path.join(projectRoot, ...relativeDir.split("/"));
+        if (fs.existsSync(directory) && fs.readdirSync(directory).length === 0) {
+            fs.rmdirSync(directory);
+        }
+    }
+}
+function rollbackFailedAblation(transaction, originalError, lockHeld = false) {
+    try {
+        rollbackAblationTransaction(transaction, { lockHeld });
+    }
+    catch (rollbackError) {
+        if (transaction.state.status !== "preparing" &&
+            transaction.state.status !== "restoring") {
+            transitionAblationState(transaction, "conflict");
+        }
+        throw new Error(`Ablation failed and automatic rollback was incomplete. Recovery state remains at ${transaction.paths.transactionDir}. ` +
+            `Original error: ${originalError instanceof Error ? originalError.message : String(originalError)}. ` +
+            `Rollback error: ${rollbackError instanceof Error ? rollbackError.message : String(rollbackError)}`);
+    }
+    throw originalError;
+}
+export async function ablate(options = {}) {
+    assertCommandCwd("ablate");
+    const projectRoot = canonicalProjectRoot(process.cwd());
+    const stateRoot = getAblationStateRoot();
+    assertExternalStateRoot(projectRoot, stateRoot);
+    const transactionPaths = getTransactionPaths(projectRoot, stateRoot);
+    if (fs.existsSync(transactionPaths.transactionDir)) {
+        throw new Error("This project is already ablated or has an interrupted ablation. Run `trellis restore` first.");
+    }
+    const trellisPath = path.join(projectRoot, DIR_NAMES.WORKFLOW);
+    if (!lstatIfPresent(trellisPath)) {
+        console.log(chalk.gray("Trellis is not installed in this project."));
+        return;
+    }
+    const hashes = loadHashes(projectRoot);
+    if (Object.keys(hashes).length === 0) {
+        throw new Error("Trellis manifest is missing or not v2. Run the current `trellis update` before ablation.");
+    }
+    const configuredPlatforms = getConfiguredPlatforms(projectRoot);
+    const { hashes: prunedManifest, pruned } = pruneOrphanManifestKeys(projectRoot, [...configuredPlatforms], hashes, { persist: false });
+    if (pruned.length > 0) {
+        console.log(chalk.gray(`Pruned ${pruned.length} orphan manifest entries in memory.`));
+    }
+    let plan;
+    try {
+        plan = buildManagedRemovalPlan(projectRoot, prunedManifest, {
+            strictPaths: true,
+        });
+    }
+    catch (error) {
+        throw new Error(`${error instanceof Error ? error.message : String(error)} ` +
+            "Restore the managed file to its Trellis-generated form or remove its stale manifest entry, then retry.", { cause: error });
+    }
+    const prunableDirectories = collectPrunableDirectories(projectRoot, plan);
+    renderAblatePlan(plan, prunableDirectories, transactionPaths.transactionDir);
+    if (options.dryRun) {
+        console.log(chalk.gray("Dry run — no files or recovery state were modified."));
+        return;
+    }
+    if (!options.yes) {
+        if (!process.stdin.isTTY)
+            refuseNonInteractivePrompt("ablate");
+        if (!(await promptContinue("Temporarily remove all project Trellis surfaces?"))) {
+            console.log(chalk.yellow("Ablation cancelled. No files modified."));
+            return;
+        }
+    }
+    const entries = buildAblationEntries(projectRoot, plan, prunableDirectories);
+    withAblationProjectLock(transactionPaths, () => {
+        if (lstatIfPresent(transactionPaths.transactionDir)) {
+            throw new Error("This project is already ablated or has an interrupted ablation. Run `trellis restore` first.");
+        }
+        const transaction = stageAblationTransaction({
+            projectRoot,
+            configuredPlatforms: [...configuredPlatforms],
+            manifest: prunedManifest,
+            entries,
+        }, { lockHeld: true });
+        try {
+            applyAblationPlan(projectRoot, plan, prunableDirectories, transaction);
+            verifyAblatedState(transaction);
+            transitionAblationState(transaction, "applied");
+        }
+        catch (error) {
+            rollbackFailedAblation(transaction, error, true);
+        }
+    });
+    console.log(chalk.green("Trellis is fully ablated for this project."));
+    console.log(chalk.yellow("Start a fresh agent session before comparing behavior."));
+    console.log(chalk.gray("Git may show Trellis-managed deletions. The global CLI, channel logs, and host transcripts were not removed."));
+}
+export async function restore(options = {}) {
+    assertCommandCwd("restore");
+    const projectRoot = canonicalProjectRoot(process.cwd());
+    const transaction = loadAblationTransaction(projectRoot);
+    if (!transaction) {
+        console.log(chalk.gray("No Trellis ablation transaction exists for this project."));
+        return;
+    }
+    renderRestorePlan(transaction);
+    if (!options.dryRun && !options.yes) {
+        if (!process.stdin.isTTY)
+            refuseNonInteractivePrompt("restore");
+        if (!(await promptContinue("Restore the exact pre-ablation Trellis state?"))) {
+            console.log(chalk.yellow("Restore cancelled. No files modified."));
+            return;
+        }
+    }
+    restoreAblationTransaction(transaction, {
+        dryRun: options.dryRun,
+        deleteAfterRestore: !options.dryRun,
+    });
+    if (options.dryRun) {
+        console.log(chalk.gray("Dry run — restoration is conflict-free; no files were modified."));
+        return;
+    }
+    console.log(chalk.green("Trellis project state restored exactly."));
+    console.log(chalk.yellow("Start a fresh agent session to resume with Trellis."));
+}
+export { ABLATION_STATE_ROOT_ENV };
+//# sourceMappingURL=ablate.js.map