agentpack-cli 0.1.0

package/dist/src/core/store.js

@@ -0,0 +1,240 @@
+import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { createId } from "./ids.js";
+export const PACK_DIR = ".agentpack";
+export const SCHEMA_VERSION = 1;
+export const AGENTPACK_IGNORE_PATTERNS = [
+    `${PACK_DIR}/`,
+    ".codex",
+    ".claude",
+    ".mcp.json",
+    "AGENTS.md",
+    "CLAUDE.md"
+];
+const LOCK_TIMEOUT_MS = 10_000;
+const STALE_LOCK_MS = 5 * 60_000;
+const heldLocks = new Set();
+const sleepBuffer = new SharedArrayBuffer(4);
+const sleepArray = new Int32Array(sleepBuffer);
+export function findPackRoot(startDir) {
+    let current = path.resolve(startDir);
+    while (true) {
+        if (existsSync(path.join(current, PACK_DIR))) {
+            return current;
+        }
+        const parent = path.dirname(current);
+        if (parent === current) {
+            return null;
+        }
+        current = parent;
+    }
+}
+export function requirePackRoot(startDir) {
+    const root = findPackRoot(startDir);
+    if (!root) {
+        throw new Error("No .agentpack directory found. Run `agentpack init` first.");
+    }
+    return root;
+}
+export function initPack(root) {
+    const packPath = path.join(root, PACK_DIR);
+    const now = new Date().toISOString();
+    mkdirSync(packPath, { recursive: true });
+    for (const dir of ["checkpoints", "evidence", "instructions", "exports", "cache"]) {
+        mkdirSync(path.join(packPath, dir), { recursive: true });
+    }
+    writeJsonIfMissing(path.join(packPath, "config.json"), {
+        schemaVersion: SCHEMA_VERSION,
+        projectName: path.basename(root),
+        redactions: [
+            "OPENAI_API_KEY",
+            "ANTHROPIC_API_KEY",
+            "GITHUB_TOKEN",
+            "NPM_TOKEN"
+        ],
+        defaultBudget: 4000,
+        includeGitDiff: true
+    });
+    writeJsonIfMissing(path.join(packPath, "state.json"), {
+        schemaVersion: SCHEMA_VERSION,
+        goal: null,
+        currentStatus: "Initialized Agentpack.",
+        nextActions: [],
+        currentCheckpoint: null,
+        createdAt: now,
+        updatedAt: now
+    });
+    writeJsonIfMissing(path.join(packPath, "sources.json"), {
+        schemaVersion: SCHEMA_VERSION,
+        sources: []
+    });
+    if (!existsSync(path.join(packPath, "events.jsonl"))) {
+        writeFileSync(path.join(packPath, "events.jsonl"), "", "utf8");
+    }
+    ensurePackIgnored(root);
+    return packPath;
+}
+export function ensurePackIgnored(root) {
+    const gitignorePath = path.join(root, ".gitignore");
+    const existing = existsSync(gitignorePath) ? readFileSync(gitignorePath, "utf8") : "";
+    const lines = existing.split(/\r?\n/).map((line) => line.trim());
+    const missing = AGENTPACK_IGNORE_PATTERNS.filter((pattern) => !hasIgnorePattern(lines, pattern));
+    if (!missing.length) {
+        return;
+    }
+    const prefix = existing && !existing.endsWith("\n") ? "\n" : "";
+    writeFileSync(gitignorePath, `${existing}${prefix}${missing.join("\n")}\n`, "utf8");
+}
+function hasIgnorePattern(lines, pattern) {
+    const normalized = pattern.endsWith("/") ? pattern.slice(0, -1) : pattern;
+    return lines.some((line) => {
+        const normalizedLine = line.endsWith("/") ? line.slice(0, -1) : line;
+        return normalizedLine === normalized;
+    });
+}
+export function getPackPath(root, ...parts) {
+    return path.join(root, PACK_DIR, ...parts);
+}
+export function readJson(filePath, fallback) {
+    if (!existsSync(filePath)) {
+        return fallback;
+    }
+    return JSON.parse(readFileSync(filePath, "utf8"));
+}
+export function writeJson(filePath, value) {
+    writeTextFileAtomic(filePath, `${JSON.stringify(value, null, 2)}\n`);
+}
+export function writeJsonIfMissing(filePath, value) {
+    if (!existsSync(filePath)) {
+        writeJson(filePath, value);
+    }
+}
+export function readState(root) {
+    const state = readJson(getPackPath(root, "state.json"), null);
+    if (!state) {
+        throw new Error("Agentpack state.json is missing. Run `agentpack init` again.");
+    }
+    return state;
+}
+export function writeState(root, state) {
+    withPackWriteLock(root, () => {
+        writeJson(getPackPath(root, "state.json"), {
+            ...state,
+            updatedAt: new Date().toISOString()
+        });
+    });
+}
+export function readSources(root) {
+    return readJson(getPackPath(root, "sources.json"), { schemaVersion: SCHEMA_VERSION, sources: [] });
+}
+export function writeSources(root, sources) {
+    withPackWriteLock(root, () => {
+        writeJson(getPackPath(root, "sources.json"), sources);
+    });
+}
+export function appendEvent(root, type, payload = {}) {
+    const event = {
+        id: createId("evt"),
+        ts: new Date().toISOString(),
+        type,
+        ...payload
+    };
+    withPackWriteLock(root, () => {
+        writeFileSync(getPackPath(root, "events.jsonl"), `${JSON.stringify(event)}\n`, {
+            encoding: "utf8",
+            flag: "a"
+        });
+    });
+    return event;
+}
+export function readEvents(root) {
+    const content = readFileSync(getPackPath(root, "events.jsonl"), "utf8");
+    return content
+        .split("\n")
+        .filter(Boolean)
+        .map((line) => JSON.parse(line));
+}
+export function listCheckpoints(root) {
+    const checkpointsPath = getPackPath(root, "checkpoints");
+    if (!existsSync(checkpointsPath)) {
+        return [];
+    }
+    return readdirSync(checkpointsPath, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory())
+        .map((entry) => entry.name)
+        .sort();
+}
+export function withPackWriteLock(root, fn) {
+    const lockPath = getPackPath(root, ".lock");
+    if (heldLocks.has(lockPath)) {
+        return fn();
+    }
+    acquireLock(lockPath);
+    heldLocks.add(lockPath);
+    try {
+        return fn();
+    }
+    finally {
+        heldLocks.delete(lockPath);
+        releaseLock(lockPath);
+    }
+}
+function writeTextFileAtomic(filePath, content) {
+    const dir = path.dirname(filePath);
+    const tempPath = path.join(dir, `.${path.basename(filePath)}.${process.pid}.${Date.now()}.${Math.random().toString(16).slice(2)}.tmp`);
+    try {
+        writeFileSync(tempPath, content, "utf8");
+        renameSync(tempPath, filePath);
+    }
+    catch (error) {
+        try {
+            unlinkSync(tempPath);
+        }
+        catch {
+            // Best effort cleanup; preserve the original write error.
+        }
+        throw error;
+    }
+}
+function acquireLock(lockPath) {
+    const startedAt = Date.now();
+    while (true) {
+        try {
+            mkdirSync(lockPath, { mode: 0o700 });
+            return;
+        }
+        catch (error) {
+            if (!isErrnoException(error) || error.code !== "EEXIST") {
+                throw error;
+            }
+            removeStaleLock(lockPath);
+            if (Date.now() - startedAt > LOCK_TIMEOUT_MS) {
+                throw new Error(`Timed out waiting for Agentpack state lock: ${lockPath}`);
+            }
+            sleepSync(25);
+        }
+    }
+}
+function releaseLock(lockPath) {
+    rmSync(lockPath, { recursive: true, force: true });
+}
+function removeStaleLock(lockPath) {
+    try {
+        const ageMs = Date.now() - statSync(lockPath).mtimeMs;
+        if (ageMs > STALE_LOCK_MS) {
+            rmSync(lockPath, { recursive: true, force: true });
+        }
+    }
+    catch (error) {
+        if (!isErrnoException(error) || error.code !== "ENOENT") {
+            throw error;
+        }
+    }
+}
+function sleepSync(ms) {
+    Atomics.wait(sleepArray, 0, 0, ms);
+}
+function isErrnoException(error) {
+    return error instanceof Error && "code" in error;
+}
+//# sourceMappingURL=store.js.map

package/dist/src/core/store.js.map

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

package/dist/src/core/types.d.ts

@@ -0,0 +1,43 @@
+export interface AgentpackConfig {
+    schemaVersion: number;
+    projectName: string;
+    redactions: string[];
+    defaultBudget: number;
+    includeGitDiff: boolean;
+}
+export interface AgentpackState {
+    schemaVersion: number;
+    goal: string | null;
+    currentStatus: string;
+    nextActions: string[];
+    currentCheckpoint: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface SourceRecord {
+    path: string;
+    hash: string;
+    size: number;
+    mtimeMs: number;
+    recordedAt: string;
+    summary: string;
+    snippet: string;
+}
+export interface SourcesFile {
+    schemaVersion: number;
+    sources: SourceRecord[];
+}
+export interface AgentpackEvent {
+    id: string;
+    ts: string;
+    type: string;
+    [key: string]: unknown;
+}
+export interface GitInfo {
+    available: boolean;
+    topLevel?: string;
+    branch: string | null;
+    head: string | null;
+    status: string;
+    diff: string;
+}

package/dist/src/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/types.ts"],"names":[],"mappings":""}

package/dist/src/integrations/install.d.ts

@@ -0,0 +1,5 @@
+interface InstallOptions {
+    dryRun?: boolean;
+}
+export declare function installIntegration(root: string, targetValue: string, options?: InstallOptions): string;
+export {};

package/dist/src/integrations/install.js

@@ -0,0 +1,361 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import path from "node:path";
+import { getPackPath, readJson } from "../core/store.js";
+const INSTALL_TARGETS = ["codex", "claude", "claude-desktop", "cursor"];
+const INSTRUCTIONS = `# Agentpack
+
+Use Agentpack as the task-state ledger for this repo.
+Agentpack is not an activity logger; do not record every thought, file read, or edit.
+
+At the start of a task:
+- call \`load_context\` with a small preset first
+- call \`source_status\` before re-reading previously inspected files
+
+During work:
+- call \`record_source\` after inspecting an important file, with a concise conclusion
+- call \`record_decision\` for durable technical/product decisions
+- call \`record_dead_end\` when an approach failed and should not be repeated
+- call \`attach_evidence\` for useful test output, command output, or verification notes
+
+Default cadence:
+- start with Agentpack context
+- work locally without recording every micro-step
+- record durable findings and evidence before a checkpoint
+- use full safe mode for risky or release-like changes
+
+Before re-reading an unchanged source file, prefer the recorded source conclusion unless the task requires fresh inspection.
+
+After meaningful progress, call \`checkpoint\` with:
+- summary
+- current status
+- next actions
+`;
+export function installIntegration(root, targetValue, options = {}) {
+    const target = parseTarget(targetValue);
+    const dryRun = options.dryRun !== false;
+    const plan = buildInstallPlan(root, target);
+    const statuses = plan.files.map((file) => ({
+        file,
+        status: fileStatus(file.filePath, file.content)
+    }));
+    if (!dryRun) {
+        applyPlan(plan);
+    }
+    return formatInstallResult(root, plan, statuses, dryRun);
+}
+function buildInstallPlan(root, target) {
+    mkdirSync(getPackPath(root, "instructions"), { recursive: true });
+    const serverName = mcpServerName(root);
+    if (target === "codex") {
+        const codexSnippetPath = getPackPath(root, "instructions", "codex-mcp.example.toml");
+        return {
+            target,
+            files: [
+                writeFilePlan(root, ".agentpack/instructions/codex.md", "Write Codex-specific Agentpack workflow instructions.", INSTRUCTIONS),
+                managedBlockPlan(root, "AGENTS.md", "Add or update the Agentpack block in AGENTS.md.", INSTRUCTIONS),
+                tomlTablePlan(root, ".codex/config.toml", "Add the Agentpack MCP server to project-local Codex config.", `mcp_servers.${serverName}`, codexMcpTomlTable(serverName), "mcp_servers.agentpack"),
+                writeFilePlan(root, ".agentpack/instructions/codex-mcp.example.toml", "Write a Codex MCP config snippet for manual review.", codexTomlSnippet(serverName))
+            ],
+            notes: [
+                "No global Codex config is modified.",
+                `Codex should use the project-local .codex/config.toml entry named ${serverName} for this repo.`,
+                "Remove any old ~/.codex/config.toml agentpack server that hard-codes --root or cwd to another project.",
+                `For manual review, see ${relativePath(root, codexSnippetPath)}.`
+            ]
+        };
+    }
+    if (target === "claude") {
+        return {
+            target,
+            files: [
+                writeFilePlan(root, ".agentpack/instructions/claude.md", "Write Claude-specific Agentpack workflow instructions.", INSTRUCTIONS),
+                managedBlockPlan(root, "CLAUDE.md", "Add or update the Agentpack block in CLAUDE.md.", INSTRUCTIONS),
+                jsonMergePlan(root, ".mcp.json", "Add the Agentpack MCP server to project .mcp.json.", serverName, claudeMcpServer())
+            ],
+            notes: [
+                "Only project-local files are modified.",
+                `The Claude Code MCP server key is ${serverName} to avoid cross-repo name collisions.`,
+                "Claude Code prompts before using project-scoped MCP servers from .mcp.json."
+            ]
+        };
+    }
+    if (target === "claude-desktop") {
+        const desktopSnippetPath = getPackPath(root, "instructions", "claude-desktop-mcp.example.json");
+        return {
+            target,
+            files: [
+                writeFilePlan(root, ".agentpack/instructions/claude-desktop.md", "Write Claude Desktop-specific Agentpack setup notes.", claudeDesktopInstructions(root, desktopSnippetPath)),
+                writeFilePlan(root, ".agentpack/instructions/claude-desktop-mcp.example.json", "Write a Claude Desktop MCP config snippet for manual review.", claudeDesktopJsonSnippet(root, serverName))
+            ],
+            notes: [
+                "No Claude Desktop global config is modified.",
+                "Claude Desktop does not read project .mcp.json or CLAUDE.md.",
+                `To enable local MCP in Claude Desktop manually, review ${relativePath(root, desktopSnippetPath)} and merge it into ~/Library/Application Support/Claude/claude_desktop_config.json on macOS.`
+            ]
+        };
+    }
+    return {
+        target,
+        files: [
+            writeFilePlan(root, ".agentpack/instructions/cursor.md", "Write Cursor-specific Agentpack workflow instructions.", INSTRUCTIONS),
+            writeFilePlan(root, ".cursor/rules/agentpack.mdc", "Write a Cursor project rule for Agentpack.", INSTRUCTIONS),
+            jsonMergePlan(root, ".cursor/mcp.json", "Add the Agentpack MCP server to Cursor project MCP config.", serverName, cursorMcpServer())
+        ],
+        notes: [
+            "Only project-local files are modified.",
+            "Cursor reads project-specific MCP servers from .cursor/mcp.json."
+        ]
+    };
+}
+function applyPlan(plan) {
+    for (const file of plan.files) {
+        mkdirSync(path.dirname(file.filePath), { recursive: true });
+        if (existsSync(file.filePath) && readFileSync(file.filePath, "utf8") === file.content) {
+            continue;
+        }
+        writeFileSync(file.filePath, file.content, "utf8");
+    }
+}
+function formatInstallResult(root, plan, statuses, dryRun) {
+    const lines = [
+        dryRun
+            ? `Agentpack ${plan.target} install plan (dry run)`
+            : `Installed Agentpack ${plan.target} integration`,
+        dryRun ? "No files were changed." : "Files written:",
+        "",
+        ...statuses.map(({ file, status }) => `- ${status.toUpperCase()} ${relativePath(root, file.filePath)}: ${file.description}`),
+        "",
+        "Notes:",
+        ...plan.notes.map((note) => `- ${note}`)
+    ];
+    if (dryRun) {
+        lines.push("", "To apply:", `  agentpack install ${plan.target} --write`);
+    }
+    return lines.join("\n");
+}
+function writeFilePlan(root, relativeFilePath, description, content) {
+    return {
+        filePath: path.join(root, relativeFilePath),
+        description,
+        content: ensureTrailingNewline(content)
+    };
+}
+function managedBlockPlan(root, relativeFilePath, description, block) {
+    const filePath = path.join(root, relativeFilePath);
+    const existing = existsSync(filePath) ? readFileSync(filePath, "utf8") : "";
+    return {
+        filePath,
+        description,
+        content: upsertManagedBlock(existing, block)
+    };
+}
+function jsonMergePlan(root, relativeFilePath, description, serverName, server) {
+    const filePath = path.join(root, relativeFilePath);
+    const existing = readJson(filePath, {});
+    const mcpServers = isRecord(existing.mcpServers) ? existing.mcpServers : {};
+    const nextMcpServers = {
+        ...mcpServers,
+        [serverName]: server
+    };
+    if (serverName !== "agentpack" && JSON.stringify(mcpServers.agentpack) === JSON.stringify(server)) {
+        delete nextMcpServers.agentpack;
+    }
+    const next = {
+        ...existing,
+        mcpServers: nextMcpServers
+    };
+    return {
+        filePath,
+        description,
+        content: `${JSON.stringify(next, null, 2)}\n`
+    };
+}
+function tomlTablePlan(root, relativeFilePath, description, tableName, tableBody, legacyTableName) {
+    const filePath = path.join(root, relativeFilePath);
+    const existing = existsSync(filePath) ? readFileSync(filePath, "utf8") : "";
+    const withoutLegacy = legacyTableName && legacyTableName !== tableName
+        ? removeTomlTable(existing, legacyTableName)
+        : existing;
+    return {
+        filePath,
+        description,
+        content: upsertTomlTable(withoutLegacy, tableName, tableBody)
+    };
+}
+function upsertManagedBlock(existing, block) {
+    const marker = "<!-- agentpack:start -->";
+    const endMarker = "<!-- agentpack:end -->";
+    const wrapped = `${marker}\n${block.trim()}\n${endMarker}\n`;
+    if (existing.includes(marker)) {
+        return existing.replace(new RegExp(`${escapeRegExp(marker)}[\\s\\S]*?${escapeRegExp(endMarker)}\\n?`), wrapped);
+    }
+    return `${existing.trimEnd()}\n\n${wrapped}`.trimStart();
+}
+function upsertTomlTable(existing, tableName, tableBody) {
+    const tableHeader = `[${tableName}]`;
+    const lines = existing.split(/\r?\n/);
+    const start = lines.findIndex((line) => line.trim() === tableHeader);
+    const bodyLines = tableBody.trimEnd().split("\n");
+    if (start === -1) {
+        const prefix = existing.trimEnd();
+        return ensureTrailingNewline(prefix ? `${prefix}\n\n${tableBody}` : tableBody);
+    }
+    let end = start + 1;
+    const nestedPrefix = `[${tableName}.`;
+    while (end < lines.length) {
+        const trimmed = (lines[end] || "").trim();
+        if (trimmed.startsWith("[") && trimmed.endsWith("]") && !trimmed.startsWith(nestedPrefix)) {
+            break;
+        }
+        end += 1;
+    }
+    lines.splice(start, end - start, ...bodyLines);
+    return ensureTrailingNewline(lines.join("\n").trimEnd());
+}
+function removeTomlTable(existing, tableName) {
+    const tableHeader = `[${tableName}]`;
+    const lines = existing.split(/\r?\n/);
+    const start = lines.findIndex((line) => line.trim() === tableHeader);
+    if (start === -1) {
+        return existing;
+    }
+    let end = start + 1;
+    const nestedPrefix = `[${tableName}.`;
+    while (end < lines.length) {
+        const trimmed = (lines[end] || "").trim();
+        if (trimmed.startsWith("[") && trimmed.endsWith("]") && !trimmed.startsWith(nestedPrefix)) {
+            break;
+        }
+        end += 1;
+    }
+    lines.splice(start, end - start);
+    return ensureTrailingNewline(lines.join("\n").trimEnd());
+}
+function codexTomlSnippet(serverName) {
+    return [
+        "# Add this to the repo's .codex/config.toml after reviewing it.",
+        "# Do not put a project-specific --root or cwd in ~/.codex/config.toml.",
+        "# A hard-coded global root makes Agentpack read the wrong repo.",
+        codexMcpTomlTable(serverName),
+        ""
+    ].join("\n");
+}
+function codexMcpTomlTable(serverName) {
+    return [
+        `[mcp_servers.${serverName}]`,
+        "command = \"agentpack\"",
+        "args = [\"mcp\"]",
+        "startup_timeout_sec = 10",
+        "tool_timeout_sec = 60",
+        ""
+    ].join("\n");
+}
+function claudeMcpServer() {
+    return {
+        type: "stdio",
+        command: "agentpack",
+        args: ["mcp"]
+    };
+}
+function claudeDesktopMcpServer(root) {
+    return {
+        command: "agentpack",
+        args: ["mcp", "--root", root],
+        env: {
+            AGENTPACK_ROOT: root
+        }
+    };
+}
+function claudeDesktopJsonSnippet(root, serverName) {
+    return JSON.stringify({
+        mcpServers: {
+            [serverName]: claudeDesktopMcpServer(root)
+        }
+    }, null, 2);
+}
+function claudeDesktopInstructions(root, snippetPath) {
+    return [
+        "# Agentpack for Claude Desktop",
+        "",
+        "Claude Desktop does not read project-local `.mcp.json` or `CLAUDE.md`.",
+        "Use Claude Code's `.mcp.json` for Claude Code only.",
+        "",
+        "For Claude Desktop local MCP, prefer Desktop Extensions/MCP bundles when Agentpack ships one.",
+        "Until then, review the generated JSON snippet and merge it into your Claude Desktop config manually.",
+        "Do not copy the generated snippet over the Desktop config file; that can delete existing MCP servers.",
+        "",
+        "macOS config path:",
+        "",
+        "```text",
+        "~/Library/Application Support/Claude/claude_desktop_config.json",
+        "```",
+        "",
+        "Generated snippet:",
+        "",
+        "```text",
+        relativePath(root, snippetPath),
+        "```",
+        "",
+        "Safe manual flow:",
+        "",
+        "```bash",
+        "agentpack install claude-desktop --write",
+        "cat .agentpack/instructions/claude-desktop-mcp.example.json",
+        "mkdir -p \"$HOME/Library/Application Support/Claude\"",
+        "open -e \"$HOME/Library/Application Support/Claude/claude_desktop_config.json\"",
+        "```",
+        "",
+        "If the config file does not exist yet, create it with the generated snippet content.",
+        "If it already exists, merge only the `mcpServers.agentpack` entry into the existing JSON.",
+        "",
+        "After editing the Claude Desktop config, restart Claude Desktop.",
+        "",
+        "If Claude Desktop cannot find `agentpack`, replace the `command` value with an absolute executable path.",
+        "Keep both the `--root` argument and `AGENTPACK_ROOT` env value pointed at the project whose `.agentpack/` state you want Claude Desktop to use.",
+        "When switching Claude Desktop to another repo, update both the global `mcpServers.agentpack.args` `--root` value and `mcpServers.agentpack.env.AGENTPACK_ROOT`, then restart Claude Desktop."
+    ].join("\n");
+}
+function cursorMcpServer() {
+    return {
+        type: "stdio",
+        command: "agentpack",
+        args: ["mcp", "--root", "${workspaceFolder}"]
+    };
+}
+function mcpServerName(root) {
+    const projectName = path.basename(root);
+    const slug = projectName
+        .toLowerCase()
+        .replace(/[^a-z0-9_-]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .replace(/-{2,}/g, "-");
+    if (!slug || slug === "agentpack") {
+        return "agentpack";
+    }
+    return `agentpack-${slug}`;
+}
+function parseTarget(target) {
+    if (INSTALL_TARGETS.includes(target)) {
+        return target;
+    }
+    throw new Error(`Unknown install target: ${target}`);
+}
+function fileStatus(filePath, content) {
+    if (!existsSync(filePath)) {
+        return "create";
+    }
+    return readFileSync(filePath, "utf8") === content ? "unchanged" : "update";
+}
+function relativePath(root, filePath) {
+    return path.relative(root, filePath) || ".";
+}
+function ensureTrailingNewline(value) {
+    return value.endsWith("\n") ? value : `${value}\n`;
+}
+function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=install.js.map