@intutic/sync-daemon 2.1.0 → 2.3.0

package/dist/disconnect/originals.js

@@ -0,0 +1,257 @@
+/**
+ * originals.ts — what a file looked like before Intutic first wrote to it.
+ *
+ * `intutic disconnect` puts every file `intutic connect` touched back the way
+ * it was. For an entry Intutic adds to a file the user owns (a hook
+ * registration, a wrapped MCP server) the entry itself says it is Intutic's.
+ * But some writes replace what was there: a rules file (`CLAUDE.md`,
+ * `AGENTS.md`, ...) is written whole, a proxy base URL overwrites the user's
+ * own, a deny list is replaced. Those can only be undone if the original was
+ * kept, so every such writer calls {@link keepOriginal} before it writes, and
+ * {@link noteWritten} after a write of a file it owns whole.
+ *
+ * One record per file, under `<root>/.intutic/originals/`, where `<root>` is
+ * the workspace for files inside it and the home directory for the rest:
+ *
+ * - `existed: false` — Intutic created the file (and `createdDirs`, the
+ *   directories it had to make for it); disconnect deletes them.
+ * - `existed: true` — the bytes as they were, in a copy next to the record.
+ * - `writtenSha256` — what Intutic last wrote to a file it owns whole. A file
+ *   that no longer matches was edited since, and disconnect leaves it alone
+ *   rather than throw the edit away.
+ *
+ * Only the first record for a path is kept (created with O_EXCL, so two
+ * writers racing on one file cannot both claim it): the original is the file
+ * before Intutic's FIRST write, not before its latest one. A record per file,
+ * rather than one index, is what lets the MCP writers, which run in parallel,
+ * record without a lock.
+ *
+ * Best-effort by design: a failure to record must never stop the write it
+ * precedes. The cost is that disconnect then treats the file as one written
+ * by an earlier version, which kept no record.
+ *
+ * @module
+ */
+import * as node_fs from 'node:fs/promises';
+import * as node_path from 'node:path';
+import * as node_os from 'node:os';
+import * as node_crypto from 'node:crypto';
+export function sha256(content) {
+    return node_crypto.createHash('sha256').update(content).digest('hex');
+}
+/** The directory whose `.intutic/originals` holds `filePath`'s record. */
+export function ledgerRootFor(filePath, workspaceRoot) {
+    const rel = node_path.relative(node_path.resolve(workspaceRoot), node_path.resolve(filePath));
+    return rel && !rel.startsWith('..') && !node_path.isAbsolute(rel) ? node_path.resolve(workspaceRoot) : node_os.homedir();
+}
+export function ledgerDir(root) {
+    return node_path.join(root, '.intutic', 'originals');
+}
+function recordBase(filePath, workspaceRoot) {
+    const abs = node_path.resolve(filePath);
+    return node_path.join(ledgerDir(ledgerRootFor(abs, workspaceRoot)), sha256(abs).slice(0, 32));
+}
+async function ensureLedgerDir(dir) {
+    await node_fs.mkdir(dir, { recursive: true, mode: 0o700 });
+    // A workspace's `.intutic/` may be committed; the copies here can hold
+    // whatever the user's config held, credentials included.
+    const ignore = node_path.join(dir, '.gitignore');
+    await node_fs.writeFile(ignore, '*\n', { flag: 'wx', mode: 0o600 }).catch(() => undefined);
+}
+async function readRecord(base) {
+    try {
+        return JSON.parse(await node_fs.readFile(`${base}.json`, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** The directories between `root` and `filePath` that do not exist yet, outermost first. */
+async function missingDirs(filePath, root) {
+    const out = [];
+    let dir = node_path.dirname(filePath);
+    while (dir !== root && dir.startsWith(root + node_path.sep)) {
+        try {
+            await node_fs.access(dir);
+            break;
+        }
+        catch {
+            out.unshift(dir);
+            dir = node_path.dirname(dir);
+        }
+    }
+    return out;
+}
+/**
+ * Keeps `filePath` as it is now, unless an earlier call already did. Call it
+ * immediately before Intutic's write.
+ */
+export async function keepOriginal(filePath, workspaceRoot) {
+    try {
+        const abs = node_path.resolve(filePath);
+        const root = ledgerRootFor(abs, workspaceRoot);
+        const base = recordBase(abs, workspaceRoot);
+        try {
+            await node_fs.access(`${base}.json`);
+            return;
+        }
+        catch {
+            // No record yet.
+        }
+        let content = null;
+        let mode;
+        try {
+            content = await node_fs.readFile(abs);
+            mode = (await node_fs.stat(abs)).mode & 0o7777;
+        }
+        catch {
+            content = null;
+        }
+        const record = { path: abs, existed: content !== null, recordedAt: new Date().toISOString() };
+        if (content === null) {
+            const dirs = await missingDirs(abs, root);
+            if (dirs.length > 0)
+                record.createdDirs = dirs;
+        }
+        else {
+            record.mode = mode;
+        }
+        await ensureLedgerDir(ledgerDir(root));
+        if (content !== null)
+            await node_fs.writeFile(`${base}.orig`, content, { mode: 0o600 });
+        await node_fs.writeFile(`${base}.json`, JSON.stringify(record, null, 2) + '\n', { flag: 'wx', mode: 0o600 });
+    }
+    catch {
+        // Best-effort; see the module doc.
+    }
+}
+/**
+ * Notes what Intutic just wrote to a file it owns whole, so disconnect can
+ * tell a later edit apart; `meta` is merged into the record's.
+ */
+export async function noteWritten(filePath, workspaceRoot, content, meta) {
+    try {
+        const base = recordBase(filePath, workspaceRoot);
+        const record = await readRecord(base);
+        if (!record)
+            return;
+        const next = { ...record };
+        if (content !== null)
+            next.writtenSha256 = sha256(content);
+        if (meta)
+            next.meta = { ...(record.meta ?? {}), ...meta };
+        if (JSON.stringify(next) === JSON.stringify(record))
+            return;
+        const tmp = `${base}.${process.pid}.tmp`;
+        await node_fs.writeFile(tmp, JSON.stringify(next, null, 2) + '\n', { mode: 0o600 });
+        await node_fs.rename(tmp, `${base}.json`);
+    }
+    catch {
+        // Best-effort; see the module doc.
+    }
+}
+/**
+ * Writes a file Intutic owns whole, keeping the original first and noting
+ * what was written: the write every rules file, generated hook file and
+ * plugin goes through.
+ */
+export async function writeOwnedFile(filePath, workspaceRoot, content, mode) {
+    await keepOriginal(filePath, workspaceRoot);
+    await node_fs.mkdir(node_path.dirname(filePath), { recursive: true });
+    const tmp = `${filePath}.intutic-tmp`;
+    await node_fs.writeFile(tmp, content, 'utf-8');
+    if (mode !== undefined)
+        await node_fs.chmod(tmp, mode);
+    await node_fs.rename(tmp, filePath);
+    await noteWritten(filePath, workspaceRoot, content);
+}
+/** The record for `filePath`, with the saved bytes when the file existed. */
+export async function readOriginal(filePath, workspaceRoot) {
+    const base = recordBase(filePath, workspaceRoot);
+    const record = await readRecord(base);
+    if (!record)
+        return null;
+    if (!record.existed)
+        return record;
+    try {
+        return { ...record, content: await node_fs.readFile(`${base}.orig`) };
+    }
+    catch {
+        // The copy is gone: the record can no longer restore anything.
+        return null;
+    }
+}
+/** Forgets `filePath` once disconnect has dealt with it. */
+export async function forgetOriginal(filePath, workspaceRoot) {
+    const base = recordBase(filePath, workspaceRoot);
+    await node_fs.rm(`${base}.json`, { force: true });
+    await node_fs.rm(`${base}.orig`, { force: true });
+}
+/** Every file recorded under `root`. */
+export async function recordedFiles(root) {
+    let names;
+    try {
+        names = await node_fs.readdir(ledgerDir(root));
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const name of names.filter((n) => n.endsWith('.json')).sort()) {
+        const record = await readRecord(node_path.join(ledgerDir(root), name.slice(0, -'.json'.length)));
+        if (record && typeof record.path === 'string')
+            out.push(record);
+    }
+    return out;
+}
+/** Removes `root`'s ledger directory once it holds no record, and `.intutic/` if that leaves it empty. */
+export async function pruneLedger(root) {
+    const dir = ledgerDir(root);
+    try {
+        const left = (await node_fs.readdir(dir)).filter((n) => n !== '.gitignore');
+        if (left.length > 0)
+            return;
+        await node_fs.rm(node_path.join(dir, '.gitignore'), { force: true });
+        await node_fs.rmdir(dir);
+        await node_fs.rmdir(node_path.dirname(dir));
+    }
+    catch {
+        // Not empty, or already gone.
+    }
+}
+// ─── Proxy URLs ──────────────────────────────────────────────────────────────
+function proxyUrlsPath() {
+    return node_path.join(ledgerDir(node_os.homedir()), 'proxy-urls.json');
+}
+/**
+ * Remembers a proxy URL connect wrote into harness configs. Disconnect uses
+ * the list to recognise a base-URL setting as Intutic's when no original was
+ * kept for it.
+ */
+export async function noteProxyUrl(url) {
+    try {
+        const known = await knownProxyUrls();
+        if (!url || known.includes(url))
+            return;
+        await ensureLedgerDir(ledgerDir(node_os.homedir()));
+        const tmp = `${proxyUrlsPath()}.${process.pid}.tmp`;
+        await node_fs.writeFile(tmp, JSON.stringify([...known, url], null, 2) + '\n', { mode: 0o600 });
+        await node_fs.rename(tmp, proxyUrlsPath());
+    }
+    catch {
+        // Best-effort; see the module doc.
+    }
+}
+export async function knownProxyUrls() {
+    try {
+        const parsed = JSON.parse(await node_fs.readFile(proxyUrlsPath(), 'utf-8'));
+        return Array.isArray(parsed) ? parsed.filter((u) => typeof u === 'string') : [];
+    }
+    catch {
+        return [];
+    }
+}
+export async function forgetProxyUrls() {
+    await node_fs.rm(proxyUrlsPath(), { force: true });
+}
+//# sourceMappingURL=originals.js.map

package/dist/disconnect/originals.js.map

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

package/dist/disconnect/plan.d.ts

@@ -0,0 +1,175 @@
+/**
+ * plan.ts — the changes `intutic disconnect` will make, computed before any is
+ * made, so `--dry-run` prints exactly what a real run does.
+ *
+ * Every reverser adds to one {@link DisconnectPlan}. A change is either a
+ * file restored, rewritten or deleted, or a command run; a note is something
+ * left alone on purpose, with the reason. The helpers here cover the two
+ * shapes nearly every Intutic write takes:
+ *
+ * - {@link reverseOwnedFile}: a file Intutic writes whole (a rules file, a
+ *   gate script, a hook definition it owns).
+ * - {@link reverseStructuredFile}: a JSON, YAML or TOML file the user owns
+ *   that Intutic merges entries into.
+ *
+ * Both consult the record `originals.ts` kept, and both end the same way: a
+ * file that comes out semantically equal to its original gets the original
+ * bytes back, so an untouched file is restored exactly even where Intutic's
+ * write had reformatted it.
+ *
+ * @module
+ */
+import { type Document } from 'yaml';
+import { type OriginalRecord } from './originals.js';
+export interface PlannedChange {
+    path: string;
+    /** What happens, in the words `--dry-run` prints. */
+    describe: string;
+    /** Housekeeping (forgetting a record) that is not worth printing. */
+    quiet?: boolean;
+    apply: () => Promise<void>;
+}
+export interface PlanNote {
+    path: string;
+    message: string;
+}
+export declare class DisconnectPlan {
+    readonly changes: PlannedChange[];
+    readonly notes: PlanNote[];
+    change(path: string, describe: string, apply: () => Promise<void>): void;
+    quiet(path: string, apply: () => Promise<void>): void;
+    note(path: string, message: string): void;
+    private readonly claimed;
+    /**
+     * Claims `path` for one reverser. A file several writers touch is reversed
+     * in one pass; a second claim (another harness listing the same file)
+     * gets false and must leave it to the first.
+     */
+    claim(path: string): boolean;
+    /** The changes a user should see, without the housekeeping. */
+    visible(): PlannedChange[];
+    private readonly emptyDirs;
+    /**
+     * Removes `dir` after every change has run, if nothing is left in it. Only
+     * for directories named for Intutic (`.intutic/hooks`, a plugin directory
+     * called `intutic-governance`) and ones a record says Intutic created: a
+     * directory created for one file may hold another Intutic file deleted
+     * later in the run, so it is retried at the end.
+     */
+    removeIfEmpty(dir: string): void;
+    /** Runs every change in order, then the directory clean-up, deepest directory first. */
+    apply(): Promise<void>;
+}
+export declare function readText(file: string): Promise<string | null>;
+/** Deletes `file`, then each directory in `dirs` (deepest first) that is left empty. */
+export declare function deleteFile(file: string, dirs?: string[]): Promise<void>;
+/**
+ * The version of `file` committed at HEAD, when it is tracked in a git
+ * repository; null otherwise.
+ */
+export declare function committedVersion(file: string): Buffer | null;
+/**
+ * Plans the reversal of a file Intutic writes whole.
+ *
+ * With a record: an unedited file gets its original back, or is deleted
+ * along with the directories Intutic made for it; an edited one stays, with
+ * a note. Without one (an earlier version wrote it): a file `isOurs` does not
+ * recognise is not Intutic's and is left alone; one it does is deleted when
+ * untracked, or put back to the committed version when git has one that is
+ * not Intutic's.
+ */
+export declare function reverseOwnedFile(plan: DisconnectPlan, file: string, workspaceRoot: string, isOurs: (text: string) => boolean, options?: {
+    beforeApply?: () => Promise<void>;
+}): Promise<void>;
+/**
+ * How to read and write one config format. Edits work on the plain-object
+ * form (`toJS`); `write` turns the edited object back into text, keeping
+ * whatever the format can of the file around the edits.
+ */
+export interface StructuredFormat<H> {
+    parse(raw: string): H;
+    toJS(handle: H): JsonObject;
+    /** `original` is the parsed original, when a record was kept: a format can copy its layout back. */
+    write(handle: H, next: JsonObject, raw: string, original: H | null): string;
+}
+export type JsonObject = Record<string, unknown>;
+export declare const jsonFormat: StructuredFormat<JsonObject>;
+/**
+ * YAML through `yaml`'s Document: the edit is applied to the document node
+ * by node, so comments and layout away from the edited keys survive.
+ */
+export declare const yamlFormat: StructuredFormat<Document>;
+/** Rebuilds `doc`'s top-level keys in `original`'s order, the rest after them as they were. */
+export declare function orderLike(doc: JsonObject, original: JsonObject): void;
+/** TOML through smol-toml. Comments are lost on a rewrite, as they were on Intutic's own write. */
+export declare const tomlFormat: StructuredFormat<JsonObject>;
+export declare function isObject(v: unknown): v is JsonObject;
+/** Whether `js` holds nothing: no keys, or only empty objects and arrays. */
+export declare function isEmptyValue(js: unknown): boolean;
+export interface ReverseContext {
+    /** The file as it was before Intutic first wrote it, when a record was kept. */
+    original: JsonObject | null;
+    record: OriginalRecord | null;
+    /** The format's parsed form, for an edit that works on it directly (a YAML list). */
+    handle: unknown;
+    note(message: string): void;
+}
+/**
+ * Plans the reversal of Intutic's entries in a JSON, YAML or TOML file the
+ * user owns. `edit` removes them from `doc` in place and reports whether it
+ * changed anything.
+ *
+ * The result is written only if `edit` changed something. A result equal to
+ * the original gets the original bytes; a file Intutic created that ends up
+ * empty is deleted; a file with no record that ends up empty is deleted only
+ * when `deleteIfEmptyWithoutRecord` says an earlier version created it.
+ */
+export declare function reverseStructuredFile<H>(plan: DisconnectPlan, file: string, workspaceRoot: string, format: StructuredFormat<H>, edit: (doc: JsonObject, ctx: ReverseContext) => boolean, options?: {
+    deleteIfEmptyWithoutRecord?: boolean;
+}): Promise<void>;
+/**
+ * Plans the reversal of Intutic's lines in a text config edited line by line
+ * (Codex's and OpenHands' TOML, where a rewrite through a parser would drop
+ * the user's comments). `edit` returns the new text, or null for no change;
+ * `parse` is only used to compare: a result that means the same as the
+ * original gets the original bytes back.
+ */
+export declare function reverseTextFile(plan: DisconnectPlan, file: string, workspaceRoot: string, parse: (text: string) => unknown, edit: (text: string, ctx: {
+    originalText: string | null;
+    note(message: string): void;
+}) => string | null): Promise<void>;
+/** Reads the value at `path`; array elements are addressed by their index. */
+export declare function getPath(obj: unknown, path: readonly string[]): unknown;
+/** Sets `path` to `value`, creating objects on the way. */
+export declare function setPath(doc: JsonObject, path: readonly string[], value: unknown): void;
+/** Removes the key at `path`. Array elements are never removed this way: it would renumber their siblings. */
+export declare function deletePath(doc: JsonObject, path: readonly string[]): boolean;
+/**
+ * Walks up from `path`, removing each empty object or array that the
+ * original did not have (with no original, every empty one: Intutic made it).
+ */
+export declare function pruneEmpty(doc: JsonObject, path: readonly string[], original: JsonObject | null): void;
+/**
+ * Removes the elements of the array at `path` that `isOurs` claims. An array
+ * (and each parent object) left empty is removed too, unless the original
+ * had it there.
+ */
+export declare function removeFromArray(doc: JsonObject, path: readonly string[], isOurs: (entry: unknown) => boolean, original: JsonObject | null): boolean;
+/**
+ * Puts a key Intutic overwrote back. With an original, the key gets the
+ * original's value, or is removed when the original had none. Without one,
+ * the key is removed (the earlier value is unknown, and the harness's
+ * default is closer to it than Intutic's), with a note saying so. Only a key
+ * whose current value `isIntutic` recognises is touched: anything else was
+ * set since by someone else.
+ */
+export declare function restoreKey(doc: JsonObject, path: readonly string[], ctx: Pick<ReverseContext, 'original' | 'note'>, isIntutic: (value: unknown) => boolean): boolean;
+/**
+ * Applies {@link restoreKey} to every string value in `doc` that `isIntutic`
+ * recognises, wherever it sits — for writers that set a proxy URL on every
+ * model, or on whichever key a pattern happened to match.
+ */
+export declare function restoreMatchingValues(doc: JsonObject, ctx: Pick<ReverseContext, 'original' | 'note'>, isIntutic: (value: unknown) => boolean): boolean;
+/** Runs every edit (none short-circuits the others) and reports whether any changed something. */
+export declare function allEdits(...results: boolean[]): boolean;
+//# sourceMappingURL=plan.d.ts.map

package/dist/disconnect/plan.d.ts.map

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