@chinhae/atw-cli 0.1.0

package/dist/commands/uninstall.js

@@ -0,0 +1,205 @@
+/**
+ * `atw uninstall` — remove every file written by `atw init` / `update`
+ * from the current project, plus the `.atw/` directory itself.
+ *
+ * The single source of truth for "what atw wrote" is
+ * `.atw/.template-hashes.json`. Files outside that manifest are never
+ * touched (e.g. user-added hooks under `.cursor/hooks/`).
+ *
+ * Manifest-listed files split into two groups:
+ *   A. Opaque content files (`.py` / `.md` / `.ts` / etc.) — unlinked outright.
+ *   B. Structured config files (settings.json / hooks.json / config.toml /
+ *      package.json) — passed through a scrubber that strips just the atw
+ *      fields, leaving user-added neighbors intact. If the scrubber says the
+ *      file is fully empty afterwards, we delete it.
+ *
+ * Whether the user has modified a manifest-listed file or not, it is removed
+ * (full removal). The `.atw/` tree is removed unconditionally.
+ */
+import { execFileSync } from "node:child_process";
+import fs from "node:fs";
+import path from "node:path";
+import readline from "node:readline";
+import chalk from "chalk";
+import inquirer from "inquirer";
+import { DIR_NAMES } from "../constants/paths.js";
+import { loadHashes } from "../utils/template-hash.js";
+import { getConfiguredPlatforms } from "../configurators/index.js";
+import { pruneOrphanManifestKeys } from "../utils/manifest-prune.js";
+import { isCwdHomedir, homedirGuardMessage, homedirBypassEnabled, } from "../utils/cwd-guard.js";
+import { buildManagedRemovalPlan, executeManagedRemovalPlan, } from "../utils/managed-removal.js";
+/**
+ * Render the two-column uninstall plan to stdout.
+ */
+function renderPlan(cwd, plan) {
+    const atwDir = path.join(cwd, DIR_NAMES.WORKFLOW);
+    console.log(chalk.bold("\nATW uninstall plan\n"));
+    const deletePaths = plan.deletions
+        .filter((d) => !d.missing)
+        .map((d) => d.posixPath);
+    console.log(chalk.red.bold(`Will be deleted (${deletePaths.length + 1} entries):`));
+    for (const p of deletePaths) {
+        console.log(`  ${chalk.red("-")} ${p}`);
+    }
+    if (plan.removeAtwDir && fs.existsSync(atwDir)) {
+        console.log(`  ${chalk.red("-")} ${DIR_NAMES.WORKFLOW}/  ${chalk.gray("(entire directory — including your specs, task PRDs, journals, and memory)")}`);
+    }
+    if (plan.modifications.length > 0) {
+        console.log();
+        console.log(chalk.yellow.bold(`Will be modified (${plan.modifications.length} files):`));
+        for (const m of plan.modifications) {
+            console.log(`  ${chalk.yellow("~")} ${m.posixPath}  ${chalk.gray(`(${m.reason})`)}`);
+        }
+    }
+    const skipped = plan.deletions.filter((d) => d.missing);
+    if (skipped.length > 0) {
+        console.log();
+        console.log(chalk.gray(`(${skipped.length} manifest entries already missing on disk — skipped.)`));
+    }
+    console.log();
+}
+/**
+ * Prompt `Continue? [Y/n]` with default = yes. Returns true if user agrees.
+ *
+ * We use `inquirer` to match update.ts so the CLI behaves consistently and
+ * tests can mock the same library.
+ */
+async function promptContinue() {
+    const { proceed } = await inquirer.prompt([
+        {
+            type: "confirm",
+            name: "proceed",
+            message: "Continue?",
+            default: true,
+        },
+    ]);
+    return proceed;
+}
+/**
+ * List uncommitted (modified, staged, or untracked) files under the
+ * user-data subdirectories of `.atw/` — spec/, tasks/, workspace/ — which
+ * hold user-authored specs, task PRDs, and journals that `update.ts` marks as
+ * PROTECTED. Uninstall deletes the whole `.atw/` tree with no backup, so
+ * these are surfaced before the destructive step. Returns `[]` when this is
+ * not a git repo or git is unavailable (nothing we can check).
+ */
+export function collectUncommittedAtwData(cwd) {
+    const w = DIR_NAMES.WORKFLOW;
+    const userDataDirs = [
+        `${w}/${DIR_NAMES.SPEC}`,
+        `${w}/${DIR_NAMES.TASKS}`,
+        `${w}/${DIR_NAMES.WORKSPACE}`,
+    ];
+    try {
+        const out = execFileSync("git", ["-C", cwd, "status", "--porcelain", "--", ...userDataDirs], { encoding: "utf-8", stdio: ["ignore", "pipe", "ignore"] });
+        return (out
+            .split("\n")
+            .map((line) => line.trim())
+            .filter(Boolean)
+            // Strip the 2-char status code, then keep the post-rename path if any.
+            .map((line) => line.replace(/^\S+\s+/, "").replace(/^.*\s->\s/, "")));
+    }
+    catch {
+        return [];
+    }
+}
+/** Whether the uncommitted-data guard has been explicitly overridden. */
+function dirtyUninstallBypassEnabled() {
+    return process.env.ATW_ALLOW_DIRTY_UNINSTALL === "1";
+}
+/**
+ * Entry point.
+ */
+export async function uninstall(options = {}) {
+    // Refuse to run in $HOME — same reasoning as init. A manifest poisoned by
+    // a prior buggy init would otherwise unlink global platform runtime data
+    // (chat history, session JSONLs).
+    if (isCwdHomedir() && !homedirBypassEnabled()) {
+        console.error(chalk.red(homedirGuardMessage("uninstall")));
+        process.exit(1);
+    }
+    const cwd = process.cwd();
+    const atwDir = path.join(cwd, DIR_NAMES.WORKFLOW);
+    // Pre-check 1: must have a `.atw/` directory.
+    if (!fs.existsSync(atwDir)) {
+        console.log(chalk.gray("ATW is not installed in this project (no .atw/ directory found)."));
+        return;
+    }
+    // Pre-check 2: must have a manifest. Without it we cannot determine which
+    // platform files are atw-owned vs user-owned.
+    const hashes = loadHashes(cwd);
+    if (Object.keys(hashes).length === 0) {
+        console.error(chalk.red("ATW directory found but manifest is missing — cannot determine which platform files to remove. " +
+            "You can manually delete .atw/ if needed."));
+        process.exit(1);
+    }
+    // Self-heal poisoned manifests from buggy init versions: prune any manifest
+    // entry that no current configurator owns. Runs BEFORE buildPlan so the
+    // user-owned paths (.codex/sessions/, .claude/projects/, pre-existing
+    // AGENTS.md, etc.) never reach the deletion list. See PRD R3.
+    //
+    // Dry-run: still compute the pruned hashes (so the plan reflects post-prune
+    // reality) but pass `persist: false` so no disk write happens. The actual
+    // disk write defers to executePlan time, where we'd be rewriting the
+    // manifest only to delete the whole .atw/ dir anyway — but the
+    // computation must remain to keep the rendered plan honest.
+    const configuredPlatforms = getConfiguredPlatforms(cwd);
+    const { pruned, hashes: prunedHashes } = pruneOrphanManifestKeys(cwd, [...configuredPlatforms], hashes, { persist: !options.dryRun });
+    if (pruned.length > 0) {
+        // Surface counts only — listing every poisoned entry would alarm users
+        // without giving them an actionable signal.
+        console.log(chalk.gray(`   Pruned ${pruned.length} orphan manifest entries (user-owned files atw did not write).`));
+    }
+    const plan = buildManagedRemovalPlan(cwd, prunedHashes);
+    renderPlan(cwd, plan);
+    // .atw/ holds user-authored specs, task PRDs, and journals that have no
+    // backup here. Surface any uncommitted such files before deleting the tree,
+    // and — for scripted `--yes` runs where nobody reads the warning — fail
+    // closed unless explicitly overridden.
+    const uncommitted = collectUncommittedAtwData(cwd);
+    if (uncommitted.length > 0) {
+        console.warn(chalk.red.bold(`\n⚠ ${uncommitted.length} uncommitted file(s) under .atw/ (spec/tasks/workspace) ` +
+            `will be permanently deleted with no backup:`));
+        for (const p of uncommitted.slice(0, 20)) {
+            console.warn(chalk.red(`    ${p}`));
+        }
+        if (uncommitted.length > 20) {
+            console.warn(chalk.red(`    … and ${uncommitted.length - 20} more`));
+        }
+        console.warn(chalk.yellow("Commit or stash them first if you want to keep them.\n"));
+    }
+    if (options.dryRun) {
+        console.log(chalk.gray("Dry run — no files were modified."));
+        return;
+    }
+    if (uncommitted.length > 0 && options.yes && !dirtyUninstallBypassEnabled()) {
+        console.error(chalk.red("Refusing to uninstall with --yes while .atw/ has uncommitted user data " +
+            "(spec/tasks/workspace). Commit or stash it, re-run without --yes to confirm " +
+            "interactively, or set ATW_ALLOW_DIRTY_UNINSTALL=1 to override."));
+        process.exit(1);
+    }
+    if (!options.yes) {
+        // Make sure stdin is in a usable state for the prompt; in scripted
+        // environments that closed stdin, inquirer would otherwise raise. We
+        // honor the same UX as `atw update` (which also fails closed in
+        // that case).
+        if (!process.stdin.isTTY) {
+            console.error(chalk.red("Refusing to prompt for confirmation in a non-interactive shell. " +
+                "Pass --yes/-y to confirm or --dry-run to preview."));
+            // Try to release the readline ref if anything else opened stdin.
+            readline.createInterface({ input: process.stdin }).close();
+            process.exit(1);
+        }
+        const ok = await promptContinue();
+        if (!ok) {
+            console.log(chalk.yellow("Uninstall cancelled. No files modified."));
+            return;
+        }
+    }
+    const summary = executeManagedRemovalPlan(cwd, plan);
+    console.log();
+    console.log(chalk.green(`Uninstalled atw: ${summary.deletedFiles} files deleted, ` +
+        `${summary.modifiedFiles} files modified, ` +
+        `${summary.deletedDirs} directories removed.`));
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/commands/uninstall.js.map

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

package/dist/commands/update.d.ts

@@ -0,0 +1,133 @@
+import type { ConfigSectionAdded, MigrationItem, ClassifiedMigrations, MigrationResult, TemplateHashes } from "../types/migration.js";
+export { cleanupEmptyDirs, ATW_BLOCK_END, ATW_BLOCK_START, } from "../utils/managed-paths.js";
+export interface UpdateOptions {
+    dryRun?: boolean;
+    force?: boolean;
+    skipAll?: boolean;
+    createNew?: boolean;
+    allowDowngrade?: boolean;
+    migrate?: boolean;
+}
+/**
+ * Load update.skip paths from .atw/config.yaml
+ *
+ * Parses simple YAML structure:
+ *   update:
+ *     skip:
+ *       - path1
+ *       - path2
+ *
+ * @internal Exported for testing only
+ */
+export declare function loadUpdateSkipPaths(cwd: string): string[];
+/**
+ * Extract a "section" from a config.yaml-style template by sectionHeading.
+ *
+ * A section is delimited by `#---...---` separator lines (the same pattern
+ * used in the bundled `config.yaml` template). The first line inside the
+ * separator block whose `# ` content matches `sectionHeading` identifies the
+ * section; the section spans from that opening separator block through the
+ * line preceding the next `#---` separator block (or EOF).
+ *
+ * Returns the extracted text including its leading separator block, or `null`
+ * when no matching section is found.
+ *
+ * @internal Exported for testing only.
+ */
+export declare function extractConfigSection(template: string, sectionHeading: string): string | null;
+/**
+ * Apply additive config.yaml sections introduced between two versions.
+ *
+ * Walks the supplied entries, dedupes by `file+sentinel`, and for each unique
+ * entry: if the user file exists and lacks the sentinel, extracts the named
+ * section from `templateContent` and appends it. Idempotent — re-running the
+ * step on a file that already contains the sentinel is a no-op.
+ *
+ * @internal Exported for testing only.
+ */
+export declare function applyConfigSectionsAdded(entries: ConfigSectionAdded[], cwd: string, bundledTemplates: Map<string, string>): {
+    appended: number;
+};
+/**
+ * Carry the user's own top-level `config.yaml` keys across a template rewrite.
+ *
+ * `config.yaml` is delivered as a whole file, so overwriting it — on `--force`,
+ * or when the user picks "overwrite" at the modified-file prompt — replaces
+ * every local edit with the template. That is a problem specific to this file,
+ * because the template ships its opt-in surface *commented out* and tells the
+ * reader to uncomment it: `hooks`, `packages`, `default_package`,
+ * `session_auto_commit`, `codex`, `context_injection`, `prompt_injection`.
+ * Filling any of them in creates a top-level key the template does not have,
+ * and the next overwrite deletes it.
+ *
+ * Two of those are not hypothetical. `atw init` writes `packages:` /
+ * `default_package:` itself when it detects a monorepo, and `update:` — the
+ * `update.skip` list, which exists precisely to tell this command "leave these
+ * files alone" — is not in the template at all, so update deletes its own
+ * opt-out.
+ *
+ * `registry:` already had a bespoke rescue ({@link preserveExistingRegistryConfig}).
+ * This is the general form of the same problem, so run it *after* that one:
+ * the registry block is part of the effective template by then and is not
+ * carried twice.
+ *
+ * @internal Exported for testing only.
+ */
+export declare function preserveLocalConfigKeys(template: string, existing: string): {
+    merged: string;
+    carried: string[];
+};
+/**
+ * Check if a path should be excluded from backup
+ * @internal Exported for testing only
+ */
+export declare function shouldExcludeFromBackup(relativePath: string): boolean;
+/**
+ * Classify migrations based on file state and user modifications
+ */
+/**
+ * Whether the manifest records any file under `dirRelativePath` — i.e. whether
+ * ATW actually created this directory. Used to gate rename-dir migrations:
+ * a directory ATW never wrote (e.g. a user's own `.windsurf/` editor
+ * config that merely shares a path with a retired ATW platform dir) must
+ * not be auto-moved.
+ */
+export declare function dirHasManifestEntries(dirRelativePath: string, hashes: TemplateHashes): boolean;
+export declare function classifyMigrations(migrations: MigrationItem[], cwd: string, hashes: TemplateHashes, templates: Map<string, string>): ClassifiedMigrations;
+/**
+ * Sort migrations for safe execution order
+ * - rename-dir with deeper paths first (to handle nested directories)
+ * - rename-dir before rename/delete
+ */
+/** @internal Exported for testing only */
+export declare function sortMigrationsForExecution(migrations: MigrationItem[]): MigrationItem[];
+/**
+ * Execute classified migrations
+ *
+ * @param options.force - Force migrate modified files without asking
+ * @param options.skipAll - Skip all modified files without asking
+ * If neither is set, prompts interactively for modified files
+ */
+export declare function executeMigrations(classified: ClassifiedMigrations, cwd: string, options: {
+    force?: boolean;
+    skipAll?: boolean;
+}, templates: Map<string, string>): Promise<MigrationResult>;
+/**
+ * One-time migration: rename `traces-*.md` → `journal-*.md` in every
+ * developer workspace directory.
+ *
+ * Never overwrites an existing `journal-N.md`: a newer session may already
+ * have created it, and `.atw/workspace/` is excluded from the update
+ * backup (see `BACKUP_EXCLUDE_PATTERNS`), so clobbering it would be
+ * unrecoverable data loss. Conflicting `traces-N.md` files are left in place
+ * and reported instead.
+ */
+export declare function renameTracesToJournal(workspaceDir: string): {
+    renamed: number;
+    skipped: string[];
+};
+/**
+ * Main update command
+ */
+export declare function update(options: UpdateOptions): Promise<void>;
+//# sourceMappingURL=update.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/commands/update.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EACV,kBAAkB,EAClB,aAAa,EACb,oBAAoB,EACpB,eAAe,EAEf,cAAc,EACf,MAAM,uBAAuB,CAAC;AA0D/B,OAAO,EACL,gBAAgB,EAChB,aAAa,EACb,eAAe,GAChB,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AA4XD;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CA6DzD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,MAAM,GAAG,IAAI,CA2Bf;AAED;;;;;;;;;GASG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,kBAAkB,EAAE,EAC7B,GAAG,EAAE,MAAM,EACX,gBAAgB,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GACpC;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,CA0CtB;AA6FD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAyDvC;AAgjBD;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAerE;AAyOD;;GAEG;AACH;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,cAAc,GACrB,OAAO,CAOT;AAED,wBAAgB,kBAAkB,CAChC,UAAU,EAAE,aAAa,EAAE,EAC3B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,oBAAoB,CA+FtB;AAwJD;;;;GAIG;AACH,0CAA0C;AAC1C,wBAAgB,0BAA0B,CACxC,UAAU,EAAE,aAAa,EAAE,GAC1B,aAAa,EAAE,CAajB;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,oBAAoB,EAChC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,EAC/C,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC7B,OAAO,CAAC,eAAe,CAAC,CAqL1B;AA4BD;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAsBA;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAwzBlE"}