@lumenflow/cli 4.12.4 → 4.14.0

package/dist/lumenflow-disable.js

@@ -0,0 +1,193 @@
+#!/usr/bin/env node
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file lumenflow-disable.ts
+ * Reversible opt-out: flip enforcement flags to false and regenerate hooks as
+ * no-ops (WU-2590).
+ *
+ * Pairs with `lumenflow:enable`. The prior enforcement state is persisted to
+ * `.lumenflow/state/enforcement-prior.json` so enable can restore it.
+ *
+ * Usage:
+ *   pnpm lumenflow:disable
+ *   pnpm lumenflow:disable --client claude-code
+ *   pnpm lumenflow:disable --json
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// eslint-disable-next-line security/detect-child-process -- legitimate CLI subprocess
+import { spawnSync } from 'node:child_process';
+import * as yaml from 'yaml';
+import { createWUParser, LUMENFLOW_CLIENT_IDS, WORKSPACE_CONFIG_FILE_NAME, WORKSPACE_V2_KEYS, } from '@lumenflow/core';
+import { runCLI } from './cli-entry-point.js';
+import { integrateClaudeCode } from './commands/integrate.js';
+const LOG_PREFIX = '[lumenflow:disable]';
+const ENFORCEMENT_FLAGS = [
+    'hooks',
+    'block_outside_worktree',
+    'require_wu_for_edits',
+    'warn_on_stop_without_wu_done',
+];
+const PRIOR_STATE_REL_PATH = path.join('.lumenflow', 'state', 'enforcement-prior.json');
+export function parseDisableOptions() {
+    const opts = createWUParser({
+        name: 'lumenflow-disable',
+        description: 'Flip LumenFlow enforcement flags to false and regenerate hooks as no-ops. Reversible via lumenflow:enable.',
+        options: [
+            {
+                name: 'client',
+                flags: '--client <type>',
+                description: 'Scope to a single client (default: claude-code)',
+            },
+            {
+                name: 'json',
+                flags: '--json',
+                description: 'Emit machine-readable JSON output',
+                type: 'boolean',
+            },
+        ],
+    });
+    return {
+        client: opts.client ?? LUMENFLOW_CLIENT_IDS.CLAUDE_CODE,
+        json: opts.json ?? false,
+    };
+}
+function readWorkspaceYaml(projectDir) {
+    const configPath = path.join(projectDir, WORKSPACE_CONFIG_FILE_NAME);
+    if (!fs.existsSync(configPath))
+        return {};
+    const content = fs.readFileSync(configPath, 'utf-8');
+    const parsed = yaml.parse(content);
+    return parsed && typeof parsed === 'object' ? parsed : {};
+}
+/**
+ * Return the enforcement block for a client, or null if not configured.
+ */
+export function readClientEnforcement(projectDir, client) {
+    const ws = readWorkspaceYaml(projectDir);
+    const sd = ws[WORKSPACE_V2_KEYS.SOFTWARE_DELIVERY];
+    const agents = sd?.agents;
+    const clients = agents?.clients;
+    const entry = clients?.[client];
+    const enforcement = entry?.enforcement;
+    return enforcement ?? null;
+}
+/**
+ * Returns `true` when all enforcement flags are already false / unset.
+ */
+export function isAlreadyDisabled(enforcement) {
+    if (!enforcement)
+        return true;
+    return ENFORCEMENT_FLAGS.every((flag) => enforcement[flag] !== true);
+}
+/**
+ * Persist prior enforcement state so lumenflow:enable can restore it.
+ * Idempotent: if a prior state file already exists, do not overwrite.
+ */
+export function savePriorState(projectDir, client, enforcement) {
+    const priorPath = path.join(projectDir, PRIOR_STATE_REL_PATH);
+    fs.mkdirSync(path.dirname(priorPath), { recursive: true });
+    let existing = {};
+    if (fs.existsSync(priorPath)) {
+        try {
+            existing = JSON.parse(fs.readFileSync(priorPath, 'utf-8'));
+        }
+        catch {
+            existing = {};
+        }
+    }
+    if (!existing[client]) {
+        existing[client] = enforcement;
+    }
+    fs.writeFileSync(priorPath, JSON.stringify(existing, null, 2) + '\n', 'utf-8');
+    return priorPath;
+}
+/**
+ * Write the four enforcement flags to workspace.yaml via `config:set`.
+ * Using config:set respects constraint 9 (no raw YAML edits).
+ */
+export function setEnforcementFlags(projectDir, client, value, run = defaultRunConfigSet) {
+    for (const flag of ENFORCEMENT_FLAGS) {
+        const key = `${WORKSPACE_V2_KEYS.SOFTWARE_DELIVERY}.agents.clients.${client}.enforcement.${flag}`;
+        run(projectDir, [key, String(value)]);
+    }
+}
+function defaultRunConfigSet(projectDir, args) {
+    const [key, value] = args;
+    if (key == null || value == null) {
+        throw new Error('defaultRunConfigSet: expected [key, value]');
+    }
+    const binPath = path.join(projectDir, 'packages', '@lumenflow', 'cli', 'dist', 'config-set.js');
+    const res = spawnSync(process.execPath, [binPath, '--key', key, '--value', value], {
+        cwd: projectDir,
+        stdio: 'inherit',
+    });
+    if (res.status !== 0) {
+        throw new Error(`config:set failed for key ${key}`);
+    }
+}
+/**
+ * Core disable routine. Exposed for testing.
+ */
+export async function disableForClient(projectDir, client, runConfigSet = defaultRunConfigSet) {
+    const enforcement = readClientEnforcement(projectDir, client);
+    const alreadyDisabled = isAlreadyDisabled(enforcement);
+    if (alreadyDisabled) {
+        return { client, alreadyDisabled, priorStateSaved: false };
+    }
+    // Save prior state (idempotent)
+    const priorStatePath = savePriorState(projectDir, client, enforcement);
+    // Flip flags to false via config:set
+    setEnforcementFlags(projectDir, client, false, runConfigSet);
+    // Regenerate hooks as no-ops. With hooks:false, integrateClaudeCode short-
+    // circuits and prints "Enforcement hooks not enabled, skipping" — settings
+    // are left with existing hook references which become no-ops because the
+    // scripts are preserved but flags are false. For a stricter no-op we also
+    // clear the settings.json hooks section.
+    if (client === LUMENFLOW_CLIENT_IDS.CLAUDE_CODE) {
+        await integrateClaudeCode(projectDir, { enforcement: { hooks: false } });
+        clearClaudeHooksSection(projectDir);
+    }
+    return { client, alreadyDisabled: false, priorStateSaved: true, priorStatePath };
+}
+/**
+ * Clear the LumenFlow-managed hooks section from .claude/settings.json while
+ * preserving all user-authored content. Keeping this surgical means `enable`
+ * can re-populate without clobbering.
+ */
+export function clearClaudeHooksSection(projectDir) {
+    const settingsPath = path.join(projectDir, '.claude', 'settings.json');
+    if (!fs.existsSync(settingsPath))
+        return;
+    const raw = fs.readFileSync(settingsPath, 'utf-8');
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return;
+    }
+    delete parsed.hooks;
+    fs.writeFileSync(settingsPath, JSON.stringify(parsed, null, 2) + '\n', 'utf-8');
+}
+export async function main() {
+    const opts = parseDisableOptions();
+    const projectDir = process.cwd();
+    const result = await disableForClient(projectDir, opts.client);
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+        return;
+    }
+    if (result.alreadyDisabled) {
+        console.log(`${LOG_PREFIX} ${opts.client} enforcement is already disabled — nothing to do.`);
+    }
+    else {
+        console.log(`${LOG_PREFIX} Disabled enforcement for ${opts.client}. Prior state saved to ${result.priorStatePath}.`);
+    }
+    console.log(`${LOG_PREFIX} Restore with: pnpm lumenflow:enable --client ${opts.client}`);
+}
+if (import.meta.main) {
+    void runCLI(main);
+}
+//# sourceMappingURL=lumenflow-disable.js.map

package/dist/lumenflow-disable.js.map

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

package/dist/lumenflow-enable.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file lumenflow-enable.ts
+ * Restore LumenFlow enforcement after `lumenflow:disable` (WU-2590).
+ *
+ * Reads `.lumenflow/state/enforcement-prior.json` written by `lumenflow:disable`
+ * and restores the prior flag values. If no prior state exists, defaults to all
+ * flags true (safe default for a fresh enable).
+ *
+ * Usage:
+ *   pnpm lumenflow:enable
+ *   pnpm lumenflow:enable --client claude-code
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+// eslint-disable-next-line security/detect-child-process -- legitimate CLI subprocess
+import { spawnSync } from 'node:child_process';
+import { createWUParser, LUMENFLOW_CLIENT_IDS } from '@lumenflow/core';
+import { runCLI } from './cli-entry-point.js';
+import { integrateClaudeCode } from './commands/integrate.js';
+const LOG_PREFIX = '[lumenflow:enable]';
+const PRIOR_STATE_REL_PATH = path.join('.lumenflow', 'state', 'enforcement-prior.json');
+const DEFAULT_ENFORCEMENT = {
+    hooks: true,
+    block_outside_worktree: true,
+    require_wu_for_edits: true,
+    warn_on_stop_without_wu_done: true,
+};
+export function parseEnableOptions() {
+    const opts = createWUParser({
+        name: 'lumenflow-enable',
+        description: 'Re-enable LumenFlow enforcement previously disabled via lumenflow:disable.',
+        options: [
+            {
+                name: 'client',
+                flags: '--client <type>',
+                description: 'Scope to a single client (default: claude-code)',
+            },
+            {
+                name: 'json',
+                flags: '--json',
+                description: 'Emit machine-readable JSON output',
+                type: 'boolean',
+            },
+        ],
+    });
+    return {
+        client: opts.client ?? LUMENFLOW_CLIENT_IDS.CLAUDE_CODE,
+        json: opts.json ?? false,
+    };
+}
+export function readPriorState(projectDir, client) {
+    const priorPath = path.join(projectDir, PRIOR_STATE_REL_PATH);
+    if (!fs.existsSync(priorPath))
+        return null;
+    try {
+        const parsed = JSON.parse(fs.readFileSync(priorPath, 'utf-8'));
+        return parsed[client] ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+export function clearPriorState(projectDir, client) {
+    const priorPath = path.join(projectDir, PRIOR_STATE_REL_PATH);
+    if (!fs.existsSync(priorPath))
+        return;
+    try {
+        const parsed = JSON.parse(fs.readFileSync(priorPath, 'utf-8'));
+        delete parsed[client];
+        if (Object.keys(parsed).length === 0) {
+            fs.unlinkSync(priorPath);
+        }
+        else {
+            fs.writeFileSync(priorPath, JSON.stringify(parsed, null, 2) + '\n', 'utf-8');
+        }
+    }
+    catch {
+        // ignore — not critical
+    }
+}
+export async function enableForClient(projectDir, client, runConfigSet) {
+    const prior = readPriorState(projectDir, client);
+    const enforcement = prior ?? DEFAULT_ENFORCEMENT;
+    const restoredFrom = prior ? 'prior-state' : 'defaults';
+    // Write each flag via config:set
+    for (const flag of Object.keys(DEFAULT_ENFORCEMENT)) {
+        const value = enforcement[flag] ?? DEFAULT_ENFORCEMENT[flag] ?? false;
+        if (runConfigSet) {
+            runConfigSet(projectDir, [
+                `software_delivery.agents.clients.${client}.enforcement.${flag}`,
+                String(value),
+            ]);
+        }
+        else {
+            const binPath = path.join(projectDir, 'packages', '@lumenflow', 'cli', 'dist', 'config-set.js');
+            const res = spawnSync(process.execPath, [
+                binPath,
+                '--key',
+                `software_delivery.agents.clients.${client}.enforcement.${flag}`,
+                '--value',
+                String(value),
+            ], { cwd: projectDir, stdio: 'inherit' });
+            if (res.status !== 0)
+                throw new Error(`config:set failed for ${flag}`);
+        }
+    }
+    if (client === LUMENFLOW_CLIENT_IDS.CLAUDE_CODE) {
+        await integrateClaudeCode(projectDir, { enforcement });
+    }
+    clearPriorState(projectDir, client);
+    return { client, restoredFrom, enforcement };
+}
+export async function main() {
+    const opts = parseEnableOptions();
+    const projectDir = process.cwd();
+    const result = await enableForClient(projectDir, opts.client);
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+        return;
+    }
+    console.log(`${LOG_PREFIX} Enabled enforcement for ${result.client} (restored from ${result.restoredFrom}).`);
+}
+if (import.meta.main) {
+    void runCLI(main);
+}
+//# sourceMappingURL=lumenflow-enable.js.map

package/dist/lumenflow-enable.js.map

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

package/dist/lumenflow-file-classifier.js

@@ -0,0 +1,159 @@
+#!/usr/bin/env node
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file lumenflow-file-classifier.ts
+ * Shared file manifest for LumenFlow-generated integration artifacts (WU-2590).
+ *
+ * This module is the single source of truth for "which files does LumenFlow
+ * generate on a user's project?" It powers both `lumenflow:disable` and
+ * `lumenflow:uninstall`, and it explicitly reuses the same constants that
+ * `commands/integrate.ts` uses (`CLAUDE_HOOKS.SCRIPTS`, `DIRECTORIES`,
+ * `LUMENFLOW_CLIENT_IDS`) so there is exactly one source of truth for the
+ * integration file set.
+ *
+ * Adding a new generated file? Add it to one of the `collect*()` functions
+ * below. Do NOT maintain a parallel list anywhere else.
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { CLAUDE_HOOKS, DIRECTORIES, LUMENFLOW_CLIENT_IDS } from '@lumenflow/core';
+/**
+ * Collect Claude Code hook scripts that `integrate.ts` generates.
+ */
+function collectClaudeHooks(projectDir) {
+    const hookScripts = Object.values(CLAUDE_HOOKS.SCRIPTS);
+    const out = [];
+    for (const script of hookScripts) {
+        const rel = path.join(DIRECTORIES.CLAUDE_HOOKS, script);
+        if (fs.existsSync(path.join(projectDir, rel))) {
+            out.push({
+                path: rel,
+                category: 'hook',
+                client: LUMENFLOW_CLIENT_IDS.CLAUDE_CODE,
+            });
+        }
+    }
+    return out;
+}
+/**
+ * The Claude Code settings.json may contain user-authored content alongside
+ * the LumenFlow-managed `hooks` section.
+ */
+function collectClaudeSettings(projectDir) {
+    const rel = path.join(DIRECTORIES.CLAUDE, 'settings.json');
+    if (!fs.existsSync(path.join(projectDir, rel)))
+        return [];
+    return [
+        {
+            path: rel,
+            category: 'settings',
+            client: LUMENFLOW_CLIENT_IDS.CLAUDE_CODE,
+            surgicalStrip: true,
+        },
+    ];
+}
+/**
+ * Cursor recovery rules generated by `integrateCursor`.
+ */
+function collectCursorRules(projectDir) {
+    const rel = path.join('.cursor', 'rules', 'lumenflow-recovery.md');
+    if (!fs.existsSync(path.join(projectDir, rel)))
+        return [];
+    return [
+        {
+            path: rel,
+            category: 'vendor-rule',
+            client: LUMENFLOW_CLIENT_IDS.CURSOR,
+        },
+    ];
+}
+/**
+ * Codex CLI integration appends a section to AGENTS.md.
+ */
+function collectCodexAgents(projectDir) {
+    const rel = 'AGENTS.md';
+    const abs = path.join(projectDir, rel);
+    if (!fs.existsSync(abs))
+        return [];
+    // Only report surgical strip if the marker section exists
+    const content = fs.readFileSync(abs, 'utf-8');
+    if (!content.includes('## Context Recovery (WU-2157)'))
+        return [];
+    return [
+        {
+            path: rel,
+            category: 'docs',
+            client: LUMENFLOW_CLIENT_IDS.CODEX_CLI,
+            surgicalStrip: true,
+        },
+    ];
+}
+/**
+ * Core enforcement delegators generated by `syncCoreEnforcementDelegators`.
+ */
+function collectCoreDelegators(projectDir) {
+    const out = [];
+    const candidates = [
+        { path: path.join('.husky', 'pre-commit'), category: 'hook' },
+        {
+            path: path.join('.github', 'workflows', 'lumenflow-ci.yml'),
+            category: 'ci',
+        },
+    ];
+    for (const c of candidates) {
+        if (fs.existsSync(path.join(projectDir, c.path))) {
+            out.push({ path: c.path, category: c.category });
+        }
+    }
+    return out;
+}
+/**
+ * State, stamps, and history surfaces.
+ */
+function collectStateAndHistory(projectDir) {
+    const out = [];
+    const surfaces = [
+        { path: '.lumenflow/state', category: 'state' },
+        { path: '.lumenflow/stamps', category: 'stamp', keepWithHistory: true },
+        { path: '.lumenflow/constraints.md', category: 'config', keepWithConfig: true },
+        { path: 'docs/operations/tasks/wu', category: 'docs', keepWithHistory: true },
+        { path: 'workspace.yaml', category: 'config', keepWithConfig: true },
+    ];
+    for (const s of surfaces) {
+        if (fs.existsSync(path.join(projectDir, s.path))) {
+            out.push(s);
+        }
+    }
+    return out;
+}
+/**
+ * Return the full list of LumenFlow-generated files in a project.
+ *
+ * This is the canonical manifest. Both `lumenflow:disable` and
+ * `lumenflow:uninstall` consume this — do not duplicate the logic elsewhere.
+ */
+export function getGeneratedFileManifest(projectDir, opts = {}) {
+    const all = [
+        ...collectClaudeHooks(projectDir),
+        ...collectClaudeSettings(projectDir),
+        ...collectCursorRules(projectDir),
+        ...collectCodexAgents(projectDir),
+        ...collectCoreDelegators(projectDir),
+        ...collectStateAndHistory(projectDir),
+    ];
+    if (!opts.client)
+        return all;
+    // Scope: include client-specific files plus non-client-scoped state/config.
+    return all.filter((f) => !f.client || f.client === opts.client);
+}
+export function filterForUninstall(files, opts = {}) {
+    return files.filter((f) => {
+        if (opts.keepHistory && f.keepWithHistory)
+            return false;
+        if (opts.keepConfig && f.keepWithConfig)
+            return false;
+        return true;
+    });
+}
+//# sourceMappingURL=lumenflow-file-classifier.js.map

package/dist/lumenflow-file-classifier.js.map

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

package/dist/lumenflow-uninstall.js

@@ -0,0 +1,172 @@
+#!/usr/bin/env node
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: AGPL-3.0-only
+/**
+ * @file lumenflow-uninstall.ts
+ * Destructive eject — remove all LumenFlow-generated files from a project
+ * (WU-2590).
+ *
+ * Defaults to dry-run. `--confirm` is required to actually delete. Supports
+ * `--keep-history`, `--keep-config`, `--client <name>`, and `--json`.
+ *
+ * Usage:
+ *   pnpm lumenflow:uninstall                  # dry-run
+ *   pnpm lumenflow:uninstall --confirm         # actually delete
+ *   pnpm lumenflow:uninstall --keep-history --keep-config --confirm
+ *   pnpm lumenflow:uninstall --client cursor --confirm
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { createWUParser } from '@lumenflow/core';
+import { runCLI } from './cli-entry-point.js';
+import { getGeneratedFileManifest, filterForUninstall, } from './lumenflow-file-classifier.js';
+const LOG_PREFIX = '[lumenflow:uninstall]';
+export function parseUninstallOptions() {
+    const opts = createWUParser({
+        name: 'lumenflow-uninstall',
+        description: 'Remove all LumenFlow-generated files from this project. Dry-run by default; pass --confirm to actually delete.',
+        options: [
+            {
+                name: 'confirm',
+                flags: '--confirm',
+                description: 'Actually delete files. Without this, runs as a dry-run.',
+                type: 'boolean',
+            },
+            {
+                name: 'keepHistory',
+                flags: '--keep-history',
+                description: 'Preserve docs/operations/tasks/wu/ and .lumenflow/stamps/',
+                type: 'boolean',
+            },
+            {
+                name: 'keepConfig',
+                flags: '--keep-config',
+                description: 'Preserve workspace.yaml and .lumenflow/constraints.md',
+                type: 'boolean',
+            },
+            {
+                name: 'client',
+                flags: '--client <type>',
+                description: 'Scope deletion to a single client (default: all)',
+            },
+            {
+                name: 'json',
+                flags: '--json',
+                description: 'Emit machine-readable JSON output',
+                type: 'boolean',
+            },
+        ],
+    });
+    return {
+        confirm: opts.confirm ?? false,
+        keepHistory: opts.keepHistory ?? false,
+        keepConfig: opts.keepConfig ?? false,
+        client: opts.client,
+        json: opts.json ?? false,
+    };
+}
+export function buildUninstallPlan(projectDir, opts) {
+    const all = getGeneratedFileManifest(projectDir, { client: opts.client });
+    const filtered = filterForUninstall(all, {
+        keepHistory: opts.keepHistory,
+        keepConfig: opts.keepConfig,
+    });
+    const toStrip = filtered.filter((f) => f.surgicalStrip);
+    const toDelete = filtered.filter((f) => !f.surgicalStrip);
+    return { dryRun: !opts.confirm, toDelete, toStrip };
+}
+/**
+ * Surgically strip the LumenFlow-managed hooks section from .claude/settings.json
+ * while preserving user content.
+ */
+export function stripClaudeSettings(abs) {
+    if (!fs.existsSync(abs))
+        return false;
+    try {
+        const raw = fs.readFileSync(abs, 'utf-8');
+        const parsed = JSON.parse(raw);
+        delete parsed.hooks;
+        fs.writeFileSync(abs, JSON.stringify(parsed, null, 2) + '\n', 'utf-8');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Strip the WU-2157 recovery section appended to AGENTS.md by integrateCodexCli.
+ */
+export function stripAgentsRecovery(abs) {
+    if (!fs.existsSync(abs))
+        return false;
+    const content = fs.readFileSync(abs, 'utf-8');
+    const marker = '\n---\n\n## Context Recovery (WU-2157)';
+    const idx = content.indexOf(marker);
+    if (idx < 0)
+        return false;
+    fs.writeFileSync(abs, content.slice(0, idx).trimEnd() + '\n', 'utf-8');
+    return true;
+}
+export function executePlan(projectDir, plan) {
+    for (const file of plan.toDelete) {
+        const abs = path.join(projectDir, file.path);
+        if (!fs.existsSync(abs))
+            continue;
+        const stat = fs.statSync(abs);
+        if (stat.isDirectory()) {
+            fs.rmSync(abs, { recursive: true, force: true });
+        }
+        else {
+            fs.unlinkSync(abs);
+        }
+    }
+    for (const file of plan.toStrip) {
+        const abs = path.join(projectDir, file.path);
+        if (file.path.endsWith('settings.json')) {
+            stripClaudeSettings(abs);
+        }
+        else if (file.path === 'AGENTS.md') {
+            stripAgentsRecovery(abs);
+        }
+    }
+}
+function formatPlan(plan) {
+    const lines = [];
+    lines.push(plan.dryRun ? `${LOG_PREFIX} DRY-RUN — no files modified.` : `${LOG_PREFIX} Removing files:`);
+    if (plan.toDelete.length === 0 && plan.toStrip.length === 0) {
+        lines.push(`${LOG_PREFIX} No LumenFlow-generated files found.`);
+        return lines.join('\n');
+    }
+    for (const f of plan.toDelete) {
+        lines.push(`  delete  ${f.path}  (${f.category}${f.client ? ` · ${f.client}` : ''})`);
+    }
+    for (const f of plan.toStrip) {
+        lines.push(`  strip   ${f.path}  (${f.category}${f.client ? ` · ${f.client}` : ''})`);
+    }
+    if (plan.dryRun) {
+        lines.push('');
+        lines.push(`${LOG_PREFIX} Re-run with --confirm to apply.`);
+    }
+    else {
+        lines.push('');
+        lines.push(`${LOG_PREFIX} Restore via: git checkout -- <files>  (or: git revert <commit>  if already committed)`);
+    }
+    return lines.join('\n');
+}
+export async function main() {
+    const opts = parseUninstallOptions();
+    const projectDir = process.cwd();
+    const plan = buildUninstallPlan(projectDir, opts);
+    if (!plan.dryRun) {
+        executePlan(projectDir, plan);
+    }
+    if (opts.json) {
+        process.stdout.write(JSON.stringify(plan, null, 2) + '\n');
+        return;
+    }
+    console.log(formatPlan(plan));
+}
+if (import.meta.main) {
+    void runCLI(main);
+}
+//# sourceMappingURL=lumenflow-uninstall.js.map