xtctx 0.3.2 → 0.11.3

package/dist/src/cli/setup.js

@@ -0,0 +1,76 @@
+import { createInterface } from "node:readline/promises";
+import { stdin as input, stdout as output } from "node:process";
+import { resolve } from "node:path";
+import { describeSetupPlan, runSetup as setup } from "../config/setup.js";
+import { BUILT_IN_SKILL_ID, discoverProjectSkills } from "../config/skills.js";
+export async function runSetup(options = {}) {
+    const selectedSkillIds = options.yes ? undefined : await promptSkillSelection(options.projectPath);
+    if (!options.yes) {
+        const confirmed = await confirmSetup(options, selectedSkillIds);
+        if (!confirmed) {
+            process.stdout.write("xtctx setup cancelled.\n");
+            return;
+        }
+    }
+    const result = await setup({
+        projectPath: options.projectPath,
+        yes: options.yes,
+        repair: options.repair,
+        selectedSkillIds,
+        includeGlobalMcp: options.includeGlobalMcp,
+    });
+    if (result.failures.length > 0) {
+        process.exitCode = 1;
+    }
+}
+async function promptSkillSelection(projectPath) {
+    if (input.isTTY !== true || output.isTTY !== true) {
+        return undefined;
+    }
+    const projectRoot = resolve(projectPath ?? process.cwd());
+    const skills = (await discoverProjectSkills({ projectRoot }))
+        .filter((skill) => skill.id !== BUILT_IN_SKILL_ID)
+        .sort((left, right) => left.id.localeCompare(right.id));
+    process.stdout.write("xtctx will sync the built-in xtctx-handoff skill.\n");
+    if (skills.length === 0) {
+        process.stdout.write("No additional project or user skills were discovered.\n");
+        return [BUILT_IN_SKILL_ID];
+    }
+    process.stdout.write("Additional skills discovered:\n");
+    skills.forEach((skill, index) => {
+        process.stdout.write(`  ${String(index + 1).padStart(2)} ${skill.id} (${skill.source})\n`);
+    });
+    const rl = createInterface({ input, output });
+    try {
+        const answer = await rl.question("Add skills by number, comma separated. Press Enter for built-in only. ");
+        const selected = answer
+            .split(",")
+            .map((part) => Number.parseInt(part.trim(), 10))
+            .filter((value) => Number.isInteger(value) && value > 0 && value <= skills.length)
+            .map((value) => skills[value - 1]?.id)
+            .filter((value) => Boolean(value));
+        return [BUILT_IN_SKILL_ID, ...selected];
+    }
+    finally {
+        rl.close();
+    }
+}
+async function confirmSetup(options, selectedSkillIds) {
+    const plan = describeSetupPlan(options.projectPath, selectedSkillIds, options.includeGlobalMcp);
+    process.stdout.write(`xtctx setup will configure handoff for ${plan.projectRoot}\n`);
+    for (const write of plan.writes) {
+        process.stdout.write(`  ${write.kind.padEnd(22)} ${write.path}\n`);
+    }
+    if (input.isTTY !== true || output.isTTY !== true) {
+        throw new Error("Refusing non-interactive setup without --yes.");
+    }
+    const rl = createInterface({ input, output });
+    try {
+        const answer = await rl.question("Apply these changes? [y/N] ");
+        return answer.trim().toLowerCase() === "y" || answer.trim().toLowerCase() === "yes";
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/src/cli/setup.js.map

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

package/dist/src/cli/status.d.ts

@@ -0,0 +1,7 @@
+import { type ProjectServices } from "../runtime/services.js";
+export interface StatusOptions {
+    projectPath?: string;
+}
+export declare function runStatus(options?: StatusOptions): Promise<void>;
+export declare function renderStatusBlock(services: ProjectServices): Promise<string>;
+//# sourceMappingURL=status.d.ts.map

package/dist/src/cli/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../src/cli/status.ts"],"names":[],"mappings":"AAGA,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAIrF,MAAM,WAAW,aAAa;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAsB,SAAS,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ1E;AAED,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAAC,MAAM,CAAC,CAqGlF"}

package/dist/src/cli/status.js

@@ -0,0 +1,133 @@
+import { join, resolve } from "node:path";
+import { inspectManagedFile, pathExists } from "../config/setup.js";
+import { inspectSkillStatus } from "../config/skills.js";
+import { createProjectServices } from "../runtime/services.js";
+import { SUPPORTED_TOOLS } from "../tools/sources.js";
+import { readXtctxPackage } from "../utils/package-info.js";
+export async function runStatus(options = {}) {
+    const projectRoot = resolve(options.projectPath ?? process.cwd());
+    const services = await createProjectServices(projectRoot);
+    try {
+        process.stdout.write((await renderStatusBlock(services)) + "\n");
+    }
+    finally {
+        await services.sessions.close().catch(() => { });
+    }
+}
+export async function renderStatusBlock(services) {
+    const { version } = readXtctxPackage(import.meta.url);
+    const status = await services.sessions.getStatus();
+    const skills = await inspectSkillStatus(services.projectRoot, services.configPath);
+    const configPresent = await pathExists(services.configPath);
+    const managed = await Promise.all(managedTargets(services.projectRoot).map(async (target) => ({
+        ...target,
+        ...(await inspectManagedFile(target.path)),
+    })));
+    const lines = [];
+    lines.push(`xtctx ${version} - handoff status`);
+    lines.push("");
+    lines.push(`Project  ${services.projectRoot}`);
+    lines.push(`Config   ${configPresent ? services.configPath : "missing (run xtctx setup)"}`);
+    lines.push(`Index    ${services.dbPath}`);
+    lines.push(`MCP      npx -y xtctx`);
+    lines.push(`Scan     ${status.last_scan_at ?? "never"}`);
+    if (status.embedding_error) {
+        lines.push(`Search   semantic unavailable (keyword only): ${status.embedding_error}`);
+    }
+    lines.push(`Data     ${status.sessions} sessions, ${status.messages} messages, ` +
+        `${status.retrieval_units} retrieval windows, ${status.vectorized_units} vectorized`);
+    lines.push("");
+    lines.push("Tools:");
+    for (const tool of status.tools) {
+        const definition = SUPPORTED_TOOLS.find((item) => item.id === tool.tool);
+        const hook = definition?.hookMode ?? "mcp-only";
+        const marker = tool.detected ? "+" : "-";
+        const error = tool.last_error ? `; last scrape error: ${tool.last_error}` : "";
+        lines.push(`  ${marker} ${tool.tool.padEnd(13)} ${tool.detected ? "detected" : "not detected"}; ` +
+            `${tool.indexed_sessions} sessions; hook: ${hook}${error}`);
+        // `.xtctx/config.yaml` is committable, so a cloned repo can point a
+        // scraper at any directory on disk. Overrides stay legal but visible.
+        const custom = customStorePaths(definition, tool.store_paths);
+        for (const path of custom) {
+            lines.push(`      custom store path (not the ${tool.tool} default): ${path}`);
+        }
+    }
+    lines.push("");
+    lines.push("Skills:");
+    lines.push(`  Source ${skills.sourceDir}`);
+    for (const skill of skills.selected) {
+        const marker = skill.exists ? "ok" : "missing";
+        const hash = skill.hash ? ` ${skill.hash.slice(0, 18)}` : "";
+        lines.push(`  ${marker.padEnd(8)} ${skill.id}${hash}`);
+    }
+    for (const target of skills.targets) {
+        const skillPart = target.skillId ? ` ${target.skillId}` : "";
+        const pathPart = target.path ? ` ${target.path}` : "";
+        lines.push(`  ${target.state.padEnd(13)} ${target.tool} ${target.mode}${skillPart}${pathPart}`);
+    }
+    lines.push("");
+    lines.push("Managed files:");
+    for (const file of managed) {
+        const state = !file.exists
+            ? "missing"
+            : file.blockCount === 1 && file.staleReferences.length === 0
+                ? "ok"
+                : "needs repair";
+        const details = [];
+        if (file.blockCount !== 1) {
+            details.push(`${file.blockCount} xtctx blocks`);
+        }
+        if (file.staleReferences.length > 0) {
+            details.push(`stale: ${file.staleReferences.join(", ")}`);
+        }
+        lines.push(`  ${state.padEnd(12)} ${file.label} ${file.path}${details.length ? ` (${details.join("; ")})` : ""}`);
+    }
+    // Status always ends with one concrete next step, as ux-walkthrough.md
+    // promises. Repairing wiring outranks indexing advice: a drifted managed
+    // file or missing skill target is why an agent would see nothing at all.
+    const needsRepair = !configPresent ||
+        managed.some((file) => file.exists && (file.blockCount !== 1 || file.staleReferences.length > 0)) ||
+        skills.selected.some((skill) => !skill.exists) ||
+        // Only `missing` and `drift` are faults. `managed-block` and
+        // `unsupported` are the normal, healthy states for tools that carry
+        // skills inside their instruction file or not at all.
+        skills.targets.some((target) => target.state === "missing" || target.state === "drift");
+    lines.push("");
+    if (needsRepair) {
+        lines.push("Next     Wiring has drifted. Run: xtctx setup --repair");
+    }
+    else if (status.sessions === 0) {
+        lines.push("Next     No sessions are indexed yet. Ask a configured agent to call xtctx_recent_sessions.");
+    }
+    else {
+        lines.push("Next     Handoff is wired. Ask a configured agent to call xtctx_recent_sessions.");
+    }
+    return lines.join("\n");
+}
+function managedTargets(projectRoot) {
+    return [
+        { label: "codex/opencode", path: join(projectRoot, "AGENTS.md") },
+        { label: "claude-code", path: join(projectRoot, "CLAUDE.md") },
+        { label: "antigravity", path: join(projectRoot, "GEMINI.md") },
+        { label: "cursor", path: join(projectRoot, ".cursor", "rules", "xtctx.mdc") },
+        { label: "copilot", path: join(projectRoot, ".github", "copilot-instructions.md") },
+    ];
+}
+/** Store paths that differ from the tool's built-in default location. */
+function customStorePaths(definition, storePaths) {
+    if (!definition) {
+        return [];
+    }
+    let fallback;
+    try {
+        fallback = normalizePath(definition.defaultStorePath());
+    }
+    catch {
+        return [];
+    }
+    return storePaths.filter((path) => normalizePath(path) !== fallback);
+}
+function normalizePath(value) {
+    return value.replace(/\\/g, "/").replace(/\/+$/, "").toLowerCase();
+}
+//# sourceMappingURL=status.js.map

package/dist/src/cli/status.js.map

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

package/dist/src/config/disconnect.d.ts

@@ -0,0 +1,34 @@
+import { type ToolId } from "../tools/sources.js";
+export interface DisconnectOptions {
+    projectPath?: string;
+    tool?: string;
+    all?: boolean;
+    homeDir?: string;
+}
+export interface DisconnectResult {
+    projectRoot: string;
+    tools: ToolId[];
+    writes: Array<{
+        path: string;
+        kind: string;
+        changed: boolean;
+        /** What happened to the file. Defaults to "removed" for real removals. */
+        action?: "removed" | "updated";
+        note?: string;
+    }>;
+    warnings: string[];
+}
+export interface PlannedDisconnectWrite {
+    path: string;
+    kind: string;
+    note?: string;
+}
+export declare function describeDisconnectPlan(options?: DisconnectOptions): {
+    projectRoot: string;
+    tools: ToolId[];
+    writes: PlannedDisconnectWrite[];
+    warnings: string[];
+};
+export declare function disconnectProject(options?: DisconnectOptions): Promise<DisconnectResult>;
+export declare function printDisconnectResult(result: DisconnectResult): void;
+//# sourceMappingURL=disconnect.d.ts.map

package/dist/src/config/disconnect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disconnect.d.ts","sourceRoot":"","sources":["../../../src/config/disconnect.ts"],"names":[],"mappings":"AAOA,OAAO,EAAsC,KAAK,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAiBtF,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,0EAA0E;QAC1E,MAAM,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;QAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;IACH,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,sBAAsB,CAAC,OAAO,GAAE,iBAAsB,GAAG;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB,CAiCA;AAED,wBAAsB,iBAAiB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4ElG;AAED,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI,CAapE"}

package/dist/src/config/disconnect.js

@@ -0,0 +1,386 @@
+import { readFile, rm, stat } from "node:fs/promises";
+import { join, resolve } from "node:path";
+import { writeFileAtomic } from "../utils/atomic-file.js";
+import { matchLineEndings, normalizeNewlines, removeManagedBlocks } from "./managed-block.js";
+import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
+import { removeMcpServerConfigs } from "./mcp-config.js";
+import { BUILT_IN_SKILL_ID, removeSyncedSkillsForTools } from "./skills.js";
+import { SUPPORTED_TOOLS, getToolDefinition } from "../tools/sources.js";
+const TOOL_ALIASES = {
+    claude: "claude-code",
+    "claude_code": "claude-code",
+    "claude-code": "claude-code",
+    cursor: "cursor",
+    codex: "codex",
+    copilot: "copilot",
+    "github-copilot": "copilot",
+    antigravity: "antigravity",
+    opencode: "opencode",
+    "open-code": "opencode",
+    "copilot-cli": "copilot-cli",
+    "github-copilot-cli": "copilot-cli",
+};
+export function describeDisconnectPlan(options = {}) {
+    const projectRoot = resolve(options.projectPath ?? process.cwd());
+    const tools = resolveToolIds(options);
+    const writes = [
+        { path: join(projectRoot, ".xtctx", "config.yaml"), kind: "config" },
+    ];
+    const warnings = [];
+    for (const tool of tools) {
+        const definition = getToolDefinition(tool);
+        if (!definition)
+            continue;
+        writes.push(...plannedMcpWrites(projectRoot, tool, options.homeDir));
+        if (tool === "claude-code") {
+            writes.push({ path: join(projectRoot, ".claude", "settings.json"), kind: "hook:claude-code" });
+            writes.push({ path: join(projectRoot, ".claude", "hooks.json"), kind: "hook:claude-code" });
+        }
+        writes.push(...plannedSkillWrites(projectRoot, tool));
+        if (tool === "antigravity") {
+            warnings.push("Antigravity stores MCP config at app level, so disconnect removes xtctx from Antigravity globally.");
+        }
+    }
+    for (const path of memoryPathsToDisconnect(projectRoot, tools, options.all === true)) {
+        writes.push({ path, kind: "memory" });
+    }
+    return { projectRoot, tools, writes: dedupePlannedWrites(writes), warnings };
+}
+export async function disconnectProject(options = {}) {
+    const projectRoot = resolve(options.projectPath ?? process.cwd());
+    const tools = resolveToolIds(options);
+    const warnings = [];
+    const writes = [];
+    const configPath = join(projectRoot, ".xtctx", "config.yaml");
+    writes.push({
+        path: configPath,
+        kind: "config",
+        // config.yaml is rewritten with the tools disabled, never deleted — it is
+        // the record that xtctx was disconnected.
+        action: "updated",
+        changed: await disableToolsInProjectConfig(configPath, tools),
+    });
+    const mcpSummary = await removeMcpServerConfigs(projectRoot, "xtctx", tools, options.homeDir ? { homeDir: options.homeDir } : {});
+    for (const result of mcpSummary.results) {
+        writes.push({
+            path: result.path,
+            kind: `mcp:${result.tool}`,
+            changed: result.removed,
+            note: result.scope === "global" ? "global config" : undefined,
+        });
+        if (result.warning)
+            warnings.push(result.warning);
+    }
+    for (const path of memoryPathsToDisconnect(projectRoot, tools, options.all === true)) {
+        writes.push({
+            path,
+            kind: "memory",
+            changed: await removeManagedBlocksFromFile(path),
+        });
+    }
+    writes.push(...(await removeSyncedSkillsForTools(projectRoot, tools)));
+    if (options.all === true) {
+        // Nothing is left managing skills, so the synced source and the ignore
+        // file setup wrote are xtctx's own scaffolding, not user content.
+        // Transcript data under .xtctx/state is deliberately untouched.
+        for (const path of [
+            join(projectRoot, ".xtctx", "skills"),
+            join(projectRoot, ".xtctx", ".gitignore"),
+        ]) {
+            writes.push({
+                path,
+                kind: "skill-source",
+                changed: await removeIfPresent(path),
+            });
+        }
+    }
+    if (tools.includes("claude-code")) {
+        const settingsPath = join(projectRoot, ".claude", "settings.json");
+        writes.push({
+            path: settingsPath,
+            kind: "hook:claude-code",
+            changed: await removeClaudeHookFromSettings(settingsPath),
+        });
+        const legacyHooksPath = join(projectRoot, ".claude", "hooks.json");
+        writes.push({
+            path: legacyHooksPath,
+            kind: "hook:claude-code",
+            changed: await removeClaudeHook(legacyHooksPath),
+            note: "legacy hook file",
+        });
+    }
+    if (tools.includes("antigravity")) {
+        warnings.push("Antigravity MCP config is app-level; xtctx was removed from the Antigravity config for this user account.");
+    }
+    return { projectRoot, tools, writes, warnings };
+}
+export function printDisconnectResult(result) {
+    const changed = result.writes.filter((write) => write.changed).length;
+    process.stdout.write(`xtctx disconnect complete (${changed} changed, ${result.writes.length - changed} unchanged)\n`);
+    process.stdout.write(`Project: ${result.projectRoot}\n`);
+    process.stdout.write(`Tools: ${result.tools.join(", ")}\n`);
+    for (const write of result.writes) {
+        const marker = write.changed ? (write.action ?? "removed") : "ok";
+        const note = write.note ? ` (${write.note})` : "";
+        process.stdout.write(`  ${marker.padEnd(8)} ${write.kind} ${write.path}${note}\n`);
+    }
+    for (const warning of result.warnings) {
+        process.stdout.write(`  warning ${warning}\n`);
+    }
+}
+function resolveToolIds(options) {
+    if (options.all && options.tool) {
+        throw new Error("Use either a tool name or --all, not both.");
+    }
+    if (options.all) {
+        return SUPPORTED_TOOLS.map((tool) => tool.id);
+    }
+    if (!options.tool) {
+        throw new Error(`Choose a tool to disconnect, or use --all. Supported tools: ${supportedToolList()}`);
+    }
+    const canonical = TOOL_ALIASES[options.tool.trim().toLowerCase()];
+    if (!canonical || !getToolDefinition(canonical)) {
+        throw new Error(`Unknown tool "${options.tool}". Supported tools: ${supportedToolList()}`);
+    }
+    return [canonical];
+}
+function supportedToolList() {
+    return SUPPORTED_TOOLS.map((tool) => tool.id).join(", ");
+}
+async function disableToolsInProjectConfig(configPath, tools) {
+    const raw = await readUtf8IfExists(configPath);
+    if (raw === null) {
+        return false;
+    }
+    const parsed = parseYaml(raw);
+    const config = isRecord(parsed) ? parsed : {};
+    const currentTools = isRecord(config.tools) ? { ...config.tools } : {};
+    let changed = false;
+    for (const tool of tools) {
+        const existing = isRecord(currentTools[tool]) ? { ...currentTools[tool] } : {};
+        if (existing.enabled !== false) {
+            existing.enabled = false;
+            changed = true;
+        }
+        currentTools[tool] = existing;
+    }
+    if (!changed) {
+        return false;
+    }
+    config.tools = currentTools;
+    await writeFileAtomic(configPath, stringifyYaml(config));
+    return true;
+}
+function memoryPathsToDisconnect(projectRoot, tools, all) {
+    const targetTools = new Set(tools);
+    const sharedPaths = new Map();
+    for (const tool of SUPPORTED_TOOLS) {
+        for (const path of tool.memoryTargets) {
+            const absolute = join(projectRoot, path);
+            sharedPaths.set(absolute, [...(sharedPaths.get(absolute) ?? []), tool.id]);
+        }
+    }
+    const paths = [];
+    for (const [path, owners] of sharedPaths.entries()) {
+        const ownerSet = new Set(owners);
+        const selectedOwners = owners.filter((owner) => targetTools.has(owner));
+        if (selectedOwners.length === 0)
+            continue;
+        if (!all && [...ownerSet].some((owner) => !targetTools.has(owner)))
+            continue;
+        paths.push(path);
+    }
+    return paths;
+}
+function plannedMcpWrites(projectRoot, tool, homeDir) {
+    const home = homeDir ?? process.env.USERPROFILE ?? process.env.HOME;
+    const writes = [];
+    switch (tool) {
+        case "claude-code":
+            writes.push({ path: join(projectRoot, ".mcp.json"), kind: "mcp:claude-code" });
+            break;
+        case "cursor":
+            writes.push({ path: join(projectRoot, ".cursor", "mcp.json"), kind: "mcp:cursor" });
+            break;
+        case "copilot":
+            writes.push({ path: join(projectRoot, ".vscode", "mcp.json"), kind: "mcp:copilot" });
+            break;
+        case "codex":
+            writes.push({ path: join(projectRoot, ".codex", "config.toml"), kind: "mcp:codex" });
+            break;
+        case "opencode":
+            writes.push({ path: join(projectRoot, "opencode.json"), kind: "mcp:opencode" });
+            break;
+        case "antigravity":
+            if (home) {
+                writes.push({
+                    path: join(home, ".gemini", "antigravity", "mcp_config.json"),
+                    kind: "mcp:antigravity",
+                    note: "global config",
+                });
+            }
+            break;
+        case "copilot-cli":
+            if (home) {
+                writes.push({
+                    path: join(home, ".copilot", "mcp-config.json"),
+                    kind: "mcp:copilot-cli",
+                    note: "global config",
+                });
+            }
+            break;
+        default: {
+            const _exhaustive = tool;
+            void _exhaustive;
+            break;
+        }
+    }
+    return writes;
+}
+function plannedSkillWrites(projectRoot, tool) {
+    const definition = getToolDefinition(tool);
+    const capability = definition?.skillSync;
+    if (!capability || capability.mode === "managed-block" || capability.mode === "unsupported") {
+        return [];
+    }
+    const targetPath = capability.targetPath?.(projectRoot, BUILT_IN_SKILL_ID);
+    if (!targetPath) {
+        return [];
+    }
+    const writes = [{ path: targetPath, kind: `skill:${tool}:${BUILT_IN_SKILL_ID}` }];
+    return writes;
+}
+async function removeManagedBlocksFromFile(filePath) {
+    const existing = await readUtf8IfExists(filePath);
+    if (existing === null) {
+        return false;
+    }
+    const repaired = removeManagedBlocks(existing).trimEnd();
+    if (normalizeNewlines(existing).trimEnd() === repaired) {
+        return false;
+    }
+    if (!repaired || isOnlyFrontmatter(repaired)) {
+        // The file held nothing but the xtctx block — or the YAML frontmatter
+        // xtctx itself wrote above it, which Cursor would keep loading as an
+        // xtctx rule. Either way setup created it and disconnect owns removing
+        // it, rather than leaving a stub behind.
+        await rm(filePath, { force: true });
+        return true;
+    }
+    // Put the author's line endings back: removal must not reformat the file.
+    await writeFileAtomic(filePath, matchLineEndings(`${repaired}\n`, existing));
+    return true;
+}
+async function removeIfPresent(path) {
+    try {
+        await stat(path);
+    }
+    catch {
+        return false;
+    }
+    await rm(path, { recursive: true, force: true });
+    return true;
+}
+/** True when nothing survives but a single YAML frontmatter block. */
+function isOnlyFrontmatter(content) {
+    const trimmed = content.trim();
+    if (!trimmed.startsWith("---")) {
+        return false;
+    }
+    const end = trimmed.indexOf("\n---", 3);
+    return end !== -1 && trimmed.slice(end + 4).trim().length === 0;
+}
+/** Strip xtctx SessionStart matcher groups from .claude/settings.json. */
+async function removeClaudeHookFromSettings(settingsPath) {
+    const raw = await readUtf8IfExists(settingsPath);
+    if (raw === null) {
+        return false;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return false;
+    }
+    if (!isRecord(parsed) || !isRecord(parsed.hooks)) {
+        return false;
+    }
+    const sessionStart = Array.isArray(parsed.hooks.SessionStart) ? parsed.hooks.SessionStart : [];
+    const kept = sessionStart
+        .map((group) => {
+        if (!isRecord(group) || !Array.isArray(group.hooks)) {
+            return group;
+        }
+        const hooks = group.hooks.filter((hook) => !isRecord(hook) ||
+            typeof hook.command !== "string" ||
+            !hook.command.includes("xtctx --hook session-start"));
+        return hooks.length === group.hooks.length ? group : { ...group, hooks };
+    })
+        .filter((group) => !isRecord(group) || !Array.isArray(group.hooks) || group.hooks.length > 0);
+    if (JSON.stringify(kept) === JSON.stringify(sessionStart)) {
+        return false;
+    }
+    parsed.hooks.SessionStart = kept;
+    // A settings file left holding nothing but an empty SessionStart list was
+    // created by setup for that hook alone; remove it rather than leave litter.
+    const hooksOnly = Object.keys(parsed).length === 1 &&
+        Object.keys(parsed.hooks).length === 1 &&
+        kept.length === 0;
+    if (hooksOnly) {
+        await rm(settingsPath, { force: true });
+        return true;
+    }
+    await writeFileAtomic(settingsPath, JSON.stringify(parsed, null, 2) + "\n");
+    return true;
+}
+async function removeClaudeHook(hooksPath) {
+    const raw = await readUtf8IfExists(hooksPath);
+    if (raw === null) {
+        return false;
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return false;
+    }
+    if (!isRecord(parsed) || !isRecord(parsed.hooks)) {
+        return false;
+    }
+    const sessionStart = Array.isArray(parsed.hooks.SessionStart) ? parsed.hooks.SessionStart : [];
+    const nextSessionStart = sessionStart.filter((entry) => !isRecord(entry) ||
+        typeof entry.command !== "string" ||
+        !entry.command.includes("xtctx --hook session-start"));
+    if (nextSessionStart.length === sessionStart.length) {
+        return false;
+    }
+    parsed.hooks.SessionStart = nextSessionStart;
+    await writeFileAtomic(hooksPath, JSON.stringify(parsed, null, 2) + "\n");
+    return true;
+}
+async function readUtf8IfExists(filePath) {
+    try {
+        return await readFile(filePath, "utf-8");
+    }
+    catch {
+        return null;
+    }
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === "object" && !Array.isArray(value);
+}
+function dedupePlannedWrites(writes) {
+    const seen = new Set();
+    const result = [];
+    for (const write of writes) {
+        const key = `${write.kind}\0${write.path}`;
+        if (seen.has(key))
+            continue;
+        seen.add(key);
+        result.push(write);
+    }
+    return result;
+}
+//# sourceMappingURL=disconnect.js.map