@vkenliu/adit-engine 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 vkenliu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/detector/working-tree.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Working tree change detection.
+ *
+ * Detects modified, added, deleted, and untracked files
+ * relative to HEAD or a specified base SHA.
+ */
+export interface FileChange {
+    path: string;
+    status: "M" | "A" | "D" | "R" | "??";
+    /** For renames, the original path */
+    oldPath?: string;
+}
+export interface NumstatEntry {
+    path: string;
+    additions: number;
+    deletions: number;
+}
+/** Get all changed files in the working tree (staged + unstaged + untracked) */
+export declare function getChangedFiles(cwd: string): Promise<FileChange[]>;
+/** Check if working tree has any uncommitted changes */
+export declare function hasUncommittedChanges(cwd: string): Promise<boolean>;
+/** Get line-level change stats (additions/deletions per file) */
+export declare function getNumstat(cwd: string, baseSha?: string): Promise<NumstatEntry[]>;
+/** Get a human-readable summary of changes */
+export declare function getChangesSummary(cwd: string): Promise<string>;
+/** Check if working tree differs from a specific SHA */
+export declare function isDirtyFrom(cwd: string, baseSha: string): Promise<boolean>;
+//# sourceMappingURL=working-tree.d.ts.map

package/dist/detector/working-tree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"working-tree.d.ts","sourceRoot":"","sources":["../../src/detector/working-tree.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,CAAC;IACrC,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,gFAAgF;AAChF,wBAAsB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CA0CxE;AAED,wDAAwD;AACxD,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGzE;AAED,iEAAiE;AACjE,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,EAAE,CAAC,CAoBzB;AAED,8CAA8C;AAC9C,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAiBpE;AAED,wDAAwD;AACxD,wBAAsB,WAAW,CAC/B,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAWlB"}

package/dist/detector/working-tree.js

@@ -0,0 +1,108 @@
+/**
+ * Working tree change detection.
+ *
+ * Detects modified, added, deleted, and untracked files
+ * relative to HEAD or a specified base SHA.
+ */
+import { runGit } from "../git/runner.js";
+/** Get all changed files in the working tree (staged + unstaged + untracked) */
+export async function getChangedFiles(cwd) {
+    const result = await runGit(["status", "--porcelain", "-z"], { cwd });
+    if (result.exitCode !== 0 || !result.stdout)
+        return [];
+    const changes = [];
+    const parts = result.stdout.split("\0");
+    let i = 0;
+    while (i < parts.length) {
+        const entry = parts[i];
+        if (!entry || entry.length < 3) {
+            i++;
+            continue;
+        }
+        const xy = entry.substring(0, 2);
+        const path = entry.substring(3);
+        // Rename entries have the old path as the next null-separated field
+        if (xy.includes("R")) {
+            const oldPath = parts[i + 1];
+            changes.push({ path, status: "R", oldPath });
+            i += 2;
+            continue;
+        }
+        let status;
+        if (xy === "??") {
+            status = "??";
+        }
+        else if (xy.includes("D")) {
+            status = "D";
+        }
+        else if (xy.includes("A")) {
+            status = "A";
+        }
+        else {
+            status = "M";
+        }
+        changes.push({ path, status });
+        i++;
+    }
+    return changes;
+}
+/** Check if working tree has any uncommitted changes */
+export async function hasUncommittedChanges(cwd) {
+    const changes = await getChangedFiles(cwd);
+    return changes.length > 0;
+}
+/** Get line-level change stats (additions/deletions per file) */
+export async function getNumstat(cwd, baseSha) {
+    const args = baseSha
+        ? ["diff", "--numstat", baseSha]
+        : ["diff", "--numstat"];
+    const result = await runGit(args, { cwd });
+    if (result.exitCode !== 0 || !result.stdout.trim())
+        return [];
+    return result.stdout
+        .trim()
+        .split("\n")
+        .map((line) => {
+        const [add, del, path] = line.split("\t");
+        return {
+            path: path ?? "",
+            additions: add === "-" ? 0 : parseInt(add, 10) || 0,
+            deletions: del === "-" ? 0 : parseInt(del, 10) || 0,
+        };
+    })
+        .filter((e) => e.path);
+}
+/** Get a human-readable summary of changes */
+export async function getChangesSummary(cwd) {
+    const changes = await getChangedFiles(cwd);
+    if (changes.length === 0)
+        return "No changes";
+    const counts = { M: 0, A: 0, D: 0, R: 0, "??": 0 };
+    for (const c of changes) {
+        counts[c.status]++;
+    }
+    const parts = [];
+    if (counts.M)
+        parts.push(`${counts.M} modified`);
+    if (counts.A)
+        parts.push(`${counts.A} added`);
+    if (counts.D)
+        parts.push(`${counts.D} deleted`);
+    if (counts.R)
+        parts.push(`${counts.R} renamed`);
+    if (counts["??"])
+        parts.push(`${counts["??"]} untracked`);
+    return `${changes.length} files changed: ${parts.join(", ")}`;
+}
+/** Check if working tree differs from a specific SHA */
+export async function isDirtyFrom(cwd, baseSha) {
+    const result = await runGit(["diff", "--stat", baseSha], { cwd });
+    if (result.exitCode !== 0)
+        return true;
+    if (result.stdout.trim())
+        return true;
+    // Also check for untracked files
+    const untracked = await runGit(["ls-files", "--others", "--exclude-standard"], { cwd });
+    return untracked.stdout.trim().length > 0;
+}
+//# sourceMappingURL=working-tree.js.map

package/dist/detector/working-tree.js.map

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

package/dist/environment/capture.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Environment snapshot capture.
+ *
+ * Captures the execution context beyond just code:
+ * git state, dependency versions, runtime versions,
+ * container info, system resources, and more.
+ */
+import type Database from "better-sqlite3";
+import { type AditConfig } from "@vkenliu/adit-core";
+/** Pre-computed git state to avoid duplicate git calls within the same hook */
+export interface PreComputedGitState {
+    branch?: string | null;
+    headSha?: string | null;
+    changedFiles?: {
+        path: string;
+    }[];
+}
+/** Capture a full environment snapshot */
+export declare function captureEnvironment(db: Database.Database, config: AditConfig, sessionId: string, preComputedGit?: PreComputedGitState): Promise<string>;
+//# sourceMappingURL=capture.d.ts.map

package/dist/environment/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../src/environment/capture.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAQH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,oBAAoB,CAAC;AA8D5B,+EAA+E;AAC/E,MAAM,WAAW,mBAAmB;IAClC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACnC;AAED,0CAA0C;AAC1C,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,UAAU,EAClB,SAAS,EAAE,MAAM,EACjB,cAAc,CAAC,EAAE,mBAAmB,GACnC,OAAO,CAAC,MAAM,CAAC,CAuEjB"}

package/dist/environment/capture.js

@@ -0,0 +1,231 @@
+/**
+ * Environment snapshot capture.
+ *
+ * Captures the execution context beyond just code:
+ * git state, dependency versions, runtime versions,
+ * container info, system resources, and more.
+ */
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { createHash } from "node:crypto";
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { platform, release, cpus, totalmem, freemem, arch } from "node:os";
+import { generateId, createClock, serialize, insertEnvSnapshot, } from "@vkenliu/adit-core";
+import { getHeadSha, getCurrentBranch } from "../git/runner.js";
+import { getChangedFiles } from "../detector/working-tree.js";
+const execFileAsync = promisify(execFile);
+const ENV_CACHE_TTL_MS = 5 * 60 * 1000; // 5 minutes
+const versionCache = new Map();
+/** Known lockfile names and their paths */
+const LOCKFILES = [
+    "package-lock.json",
+    "pnpm-lock.yaml",
+    "yarn.lock",
+    "bun.lockb",
+    "Pipfile.lock",
+    "poetry.lock",
+    "Cargo.lock",
+    "go.sum",
+    "Gemfile.lock",
+];
+/** Safe environment variable prefixes to capture */
+const SAFE_ENV_PREFIXES = [
+    "NODE_",
+    "NPM_",
+    "PYTHON",
+    "SHELL",
+    "TERM",
+    "LANG",
+    "LC_",
+    "HOME",
+    "USER",
+    "PATH",
+];
+/**
+ * Known secret environment variable names that match safe prefixes but must
+ * never be captured (authentication tokens, registry credentials, etc.).
+ */
+const SECRET_ENV_NAMES = new Set([
+    "NPM_TOKEN",
+    "NPM_CONFIG_AUTHTOKEN",
+    "NPM_CONFIG__AUTH",
+    "NODE_AUTH_TOKEN",
+    "NODE_PRE_GYP_GITHUB_TOKEN",
+]);
+/** Capture a full environment snapshot */
+export async function captureEnvironment(db, config, sessionId, preComputedGit) {
+    const cwd = config.projectRoot;
+    const id = generateId();
+    // Use cached version data if available and fresh (within TTL).
+    // Version detections (node, python, runtimes, shell, package manager, container)
+    // rarely change within a session, so we cache them to avoid spawning
+    // multiple child processes on every hook event.
+    const now = Date.now();
+    let cached = versionCache.get(sessionId);
+    if (!cached || now - cached.cachedAt > ENV_CACHE_TTL_MS) {
+        // Cache miss or expired — run all version detections in parallel
+        const [nodeV, pythonV, container, runtimes, shell, pkgMgr] = await Promise.all([
+            getVersion("node", ["--version"]),
+            getVersion("python3", ["--version"]),
+            detectContainer(),
+            detectRuntimeVersions(),
+            detectShellInfo(),
+            detectPackageManager(cwd),
+        ]);
+        cached = {
+            nodeVersion: nodeV,
+            pythonVersion: pythonV,
+            containerInfo: container,
+            runtimeVersions: runtimes,
+            shellInfo: shell,
+            packageManagerInfo: pkgMgr,
+            cachedAt: now,
+        };
+        versionCache.set(sessionId, cached);
+    }
+    // Use pre-computed git state when available to avoid duplicate git calls
+    // within the same hook event. Only fetch what wasn't pre-computed.
+    const needBranch = preComputedGit?.branch === undefined;
+    const needHeadSha = preComputedGit?.headSha === undefined;
+    const needChanges = preComputedGit?.changedFiles === undefined;
+    const [branch, headSha, changes] = await Promise.all([
+        needBranch ? getCurrentBranch(cwd) : Promise.resolve(preComputedGit.branch),
+        needHeadSha ? getHeadSha(cwd) : Promise.resolve(preComputedGit.headSha),
+        needChanges ? getChangedFiles(cwd) : Promise.resolve(preComputedGit.changedFiles),
+    ]);
+    const modifiedFiles = changes.map((c) => c.path);
+    const lockfile = findLockfile(cwd);
+    const safeEnvVars = captureSafeEnvVars();
+    const systemResources = captureSystemResources();
+    insertEnvSnapshot(db, {
+        id,
+        sessionId,
+        gitBranch: branch ?? "unknown",
+        gitHeadSha: headSha ?? "unknown",
+        modifiedFiles: JSON.stringify(modifiedFiles),
+        depLockHash: lockfile ? hashFile(join(cwd, lockfile)) : null,
+        depLockPath: lockfile,
+        envVarsJson: JSON.stringify(safeEnvVars),
+        nodeVersion: cached.nodeVersion,
+        pythonVersion: cached.pythonVersion,
+        osInfo: `${platform()} ${release()}`,
+        containerInfo: cached.containerInfo ? JSON.stringify(cached.containerInfo) : null,
+        runtimeVersionsJson: cached.runtimeVersions ? JSON.stringify(cached.runtimeVersions) : null,
+        shellInfo: cached.shellInfo ? JSON.stringify(cached.shellInfo) : null,
+        systemResourcesJson: JSON.stringify(systemResources),
+        packageManagerJson: cached.packageManagerInfo ? JSON.stringify(cached.packageManagerInfo) : null,
+        vclockJson: serialize(createClock(config.clientId)),
+    });
+    return id;
+}
+/** Get version string from a command */
+async function getVersion(cmd, args) {
+    try {
+        const { stdout } = await execFileAsync(cmd, args, { timeout: 5000 });
+        return stdout.trim();
+    }
+    catch {
+        return null;
+    }
+}
+/** Find the first matching lockfile in the project */
+function findLockfile(cwd) {
+    for (const name of LOCKFILES) {
+        if (existsSync(join(cwd, name)))
+            return name;
+    }
+    return null;
+}
+/** Hash a file's contents */
+function hashFile(path) {
+    try {
+        const content = readFileSync(path);
+        return createHash("sha256").update(content).digest("hex").substring(0, 16);
+    }
+    catch {
+        return null;
+    }
+}
+/** Capture safe environment variables (no secrets) */
+function captureSafeEnvVars() {
+    const result = {};
+    for (const [key, value] of Object.entries(process.env)) {
+        if (value && !SECRET_ENV_NAMES.has(key) && SAFE_ENV_PREFIXES.some((p) => key.startsWith(p))) {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/** Detect Docker/container environment */
+async function detectContainer() {
+    const inDocker = existsSync("/.dockerenv");
+    if (inDocker) {
+        return { inDocker: true };
+    }
+    // Check cgroup for container indicators
+    try {
+        const content = readFileSync("/proc/1/cgroup", "utf-8");
+        if (content.includes("docker") || content.includes("containerd") || content.includes("kubepods")) {
+            return { inDocker: true };
+        }
+    }
+    catch {
+        // Not in a container or no access to cgroup
+    }
+    return null;
+}
+/** Detect additional runtime versions */
+async function detectRuntimeVersions() {
+    const checks = [
+        { name: "rust", cmd: "rustc", args: ["--version"] },
+        { name: "cargo", cmd: "cargo", args: ["--version"] },
+        { name: "go", cmd: "go", args: ["version"] },
+        { name: "java", cmd: "java", args: ["--version"] },
+        { name: "ruby", cmd: "ruby", args: ["--version"] },
+    ];
+    const results = {};
+    await Promise.allSettled(checks.map(async ({ name, cmd, args }) => {
+        const version = await getVersion(cmd, args);
+        if (version)
+            results[name] = version;
+    }));
+    return Object.keys(results).length > 0 ? results : null;
+}
+/** Detect shell information */
+async function detectShellInfo() {
+    const shell = process.env.SHELL;
+    if (!shell)
+        return null;
+    const version = await getVersion(shell, ["--version"]);
+    return { shell, version: version ?? undefined };
+}
+/** Capture system resource information */
+function captureSystemResources() {
+    const cpuList = cpus();
+    return {
+        arch: arch(),
+        cpuModel: cpuList[0]?.model ?? "unknown",
+        totalMem: totalmem(),
+        freeMem: freemem(),
+    };
+}
+/** Detect package manager and version */
+async function detectPackageManager(cwd) {
+    const lockfileMap = {
+        "pnpm-lock.yaml": { name: "pnpm", cmd: "pnpm" },
+        "yarn.lock": { name: "yarn", cmd: "yarn" },
+        "bun.lockb": { name: "bun", cmd: "bun" },
+        "package-lock.json": { name: "npm", cmd: "npm" },
+    };
+    for (const [lockfile, info] of Object.entries(lockfileMap)) {
+        if (existsSync(join(cwd, lockfile))) {
+            const version = await getVersion(info.cmd, ["--version"]);
+            if (version) {
+                return { name: info.name, version };
+            }
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=capture.js.map

package/dist/environment/capture.js.map

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

package/dist/environment/differ.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Environment snapshot differ.
+ *
+ * Compares two environment snapshots and produces a structured diff
+ * with categorized changes and severity levels.
+ */
+import type { EnvSnapshot, EnvDiff } from "@vkenliu/adit-core";
+/**
+ * Compare two environment snapshots and produce a structured diff.
+ */
+export declare function diffEnvironments(prev: EnvSnapshot, current: EnvSnapshot): EnvDiff;
+//# sourceMappingURL=differ.d.ts.map

package/dist/environment/differ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"differ.d.ts","sourceRoot":"","sources":["../../src/environment/differ.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAa,MAAM,oBAAoB,CAAC;AAE1E;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CA+BjF"}

package/dist/environment/differ.js

@@ -0,0 +1,114 @@
+/**
+ * Environment snapshot differ.
+ *
+ * Compares two environment snapshots and produces a structured diff
+ * with categorized changes and severity levels.
+ */
+/**
+ * Compare two environment snapshots and produce a structured diff.
+ */
+export function diffEnvironments(prev, current) {
+    const changes = [];
+    // Git changes
+    compareField(changes, "gitBranch", "git", prev.gitBranch, current.gitBranch, "warning");
+    compareField(changes, "gitHeadSha", "git", prev.gitHeadSha, current.gitHeadSha, "info");
+    // Dependency changes
+    compareField(changes, "depLockHash", "dependency", prev.depLockHash, current.depLockHash, "warning");
+    compareField(changes, "depLockPath", "dependency", prev.depLockPath, current.depLockPath, "info");
+    // Runtime version changes
+    compareField(changes, "nodeVersion", "runtime", prev.nodeVersion, current.nodeVersion, "warning");
+    compareField(changes, "pythonVersion", "runtime", prev.pythonVersion, current.pythonVersion, "warning");
+    // Enriched runtime versions (JSON comparison)
+    compareJsonField(changes, "runtimeVersions", "runtime", prev.runtimeVersionsJson, current.runtimeVersionsJson);
+    // System changes
+    compareField(changes, "osInfo", "system", prev.osInfo, current.osInfo, "breaking");
+    compareJsonField(changes, "containerInfo", "system", prev.containerInfo, current.containerInfo);
+    compareJsonField(changes, "shellInfo", "system", prev.shellInfo, current.shellInfo);
+    compareJsonField(changes, "packageManager", "dependency", prev.packageManagerJson, current.packageManagerJson);
+    // Modified files changes
+    compareModifiedFiles(changes, prev.modifiedFiles, current.modifiedFiles);
+    // Compute overall severity
+    const severity = computeOverallSeverity(changes);
+    return { changes, severity };
+}
+function compareField(changes, field, category, oldValue, newValue, severity) {
+    if (oldValue !== newValue) {
+        changes.push({ field, category, oldValue, newValue, severity });
+    }
+}
+function compareJsonField(changes, field, category, oldJson, newJson) {
+    if (oldJson === newJson)
+        return;
+    // If one is null and the other isn't, that's a change
+    if (!oldJson || !newJson) {
+        changes.push({
+            field,
+            category,
+            oldValue: oldJson,
+            newValue: newJson,
+            severity: "info",
+        });
+        return;
+    }
+    // Parse and do field-by-field comparison
+    try {
+        const oldObj = JSON.parse(oldJson);
+        const newObj = JSON.parse(newJson);
+        const allKeys = new Set([...Object.keys(oldObj), ...Object.keys(newObj)]);
+        for (const key of allKeys) {
+            const oldVal = oldObj[key];
+            const newVal = newObj[key];
+            if (JSON.stringify(oldVal) !== JSON.stringify(newVal)) {
+                changes.push({
+                    field: `${field}.${key}`,
+                    category,
+                    oldValue: oldVal != null ? String(oldVal) : null,
+                    newValue: newVal != null ? String(newVal) : null,
+                    severity: "info",
+                });
+            }
+        }
+    }
+    catch {
+        // Fallback: treat as opaque string
+        changes.push({
+            field,
+            category,
+            oldValue: oldJson,
+            newValue: newJson,
+            severity: "info",
+        });
+    }
+}
+function compareModifiedFiles(changes, oldFiles, newFiles) {
+    try {
+        const oldList = oldFiles ? JSON.parse(oldFiles) : [];
+        const newList = newFiles ? JSON.parse(newFiles) : [];
+        const oldSet = new Set(oldList);
+        const newSet = new Set(newList);
+        const added = newList.filter((f) => !oldSet.has(f));
+        const removed = oldList.filter((f) => !newSet.has(f));
+        if (added.length > 0 || removed.length > 0) {
+            changes.push({
+                field: "modifiedFiles",
+                category: "git",
+                oldValue: `${oldList.length} files`,
+                newValue: `${newList.length} files (+${added.length} -${removed.length})`,
+                severity: "info",
+            });
+        }
+    }
+    catch {
+        // Ignore parse errors
+    }
+}
+function computeOverallSeverity(changes) {
+    if (changes.length === 0)
+        return "none";
+    if (changes.some((c) => c.severity === "breaking"))
+        return "breaking";
+    if (changes.some((c) => c.severity === "warning"))
+        return "warning";
+    return "info";
+}
+//# sourceMappingURL=differ.js.map

package/dist/environment/differ.js.map

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

package/dist/git/refs.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Git ref management for ADIT checkpoints.
+ *
+ * Checkpoints are stored under refs/adit/checkpoints/<id>
+ * This keeps them entirely out of the branch history.
+ */
+/** Create or update a checkpoint ref */
+export declare function storeCheckpointRef(cwd: string, stepId: string, sha: string): Promise<void>;
+/** Resolve a checkpoint ref to its SHA */
+export declare function resolveCheckpointRef(cwd: string, stepId: string): Promise<string | null>;
+/** Delete a checkpoint ref */
+export declare function deleteCheckpointRef(cwd: string, stepId: string): Promise<boolean>;
+/** List all checkpoint refs with their SHAs */
+export declare function listCheckpointRefs(cwd: string): Promise<Array<{
+    stepId: string;
+    sha: string;
+}>>;
+/** Get parent SHA of a commit */
+export declare function getParentSha(cwd: string, sha: string): Promise<string | null>;
+/** Get the ref prefix constant */
+export declare function getRefPrefix(): string;
+//# sourceMappingURL=refs.d.ts.map

package/dist/git/refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/git/refs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,wCAAwC;AACxC,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,IAAI,CAAC,CAKf;AAED,0CAA0C;AAC1C,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAMxB;AAED,8BAA8B;AAC9B,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,OAAO,CAAC,CAMlB;AAED,+CAA+C;AAC/C,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,KAAK,CAAC;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAqBjD;AAED,iCAAiC;AACjC,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGxB;AAED,kCAAkC;AAClC,wBAAgB,YAAY,IAAI,MAAM,CAErC"}

package/dist/git/refs.js

@@ -0,0 +1,51 @@
+/**
+ * Git ref management for ADIT checkpoints.
+ *
+ * Checkpoints are stored under refs/adit/checkpoints/<id>
+ * This keeps them entirely out of the branch history.
+ */
+import { runGit, runGitOrThrow } from "./runner.js";
+const REF_PREFIX = "refs/adit/checkpoints";
+/** Create or update a checkpoint ref */
+export async function storeCheckpointRef(cwd, stepId, sha) {
+    await runGitOrThrow(["update-ref", `${REF_PREFIX}/${stepId}`, sha], { cwd });
+}
+/** Resolve a checkpoint ref to its SHA */
+export async function resolveCheckpointRef(cwd, stepId) {
+    const result = await runGit(["rev-parse", `${REF_PREFIX}/${stepId}`], { cwd });
+    return result.exitCode === 0 ? result.stdout.trim() : null;
+}
+/** Delete a checkpoint ref */
+export async function deleteCheckpointRef(cwd, stepId) {
+    const result = await runGit(["update-ref", "-d", `${REF_PREFIX}/${stepId}`], { cwd });
+    return result.exitCode === 0;
+}
+/** List all checkpoint refs with their SHAs */
+export async function listCheckpointRefs(cwd) {
+    const result = await runGit([
+        "for-each-ref",
+        `${REF_PREFIX}/`,
+        "--format=%(refname)%00%(objectname)",
+    ], { cwd });
+    if (result.exitCode !== 0 || !result.stdout.trim())
+        return [];
+    return result.stdout
+        .trim()
+        .split("\n")
+        .map((line) => {
+        const [refname, sha] = line.split("\0");
+        const stepId = refname.replace(`${REF_PREFIX}/`, "");
+        return { stepId, sha };
+    })
+        .filter((r) => r.stepId && r.sha);
+}
+/** Get parent SHA of a commit */
+export async function getParentSha(cwd, sha) {
+    const result = await runGit(["rev-parse", `${sha}^1`], { cwd });
+    return result.exitCode === 0 ? result.stdout.trim() : null;
+}
+/** Get the ref prefix constant */
+export function getRefPrefix() {
+    return REF_PREFIX;
+}
+//# sourceMappingURL=refs.js.map

package/dist/git/refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refs.js","sourceRoot":"","sources":["../../src/git/refs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,UAAU,GAAG,uBAAuB,CAAC;AAE3C,wCAAwC;AACxC,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAW,EACX,MAAc,EACd,GAAW;IAEX,MAAM,aAAa,CACjB,CAAC,YAAY,EAAE,GAAG,UAAU,IAAI,MAAM,EAAE,EAAE,GAAG,CAAC,EAC9C,EAAE,GAAG,EAAE,CACR,CAAC;AACJ,CAAC;AAED,0CAA0C;AAC1C,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,GAAW,EACX,MAAc;IAEd,MAAM,MAAM,GAAG,MAAM,MAAM,CACzB,CAAC,WAAW,EAAE,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC,EACxC,EAAE,GAAG,EAAE,CACR,CAAC;IACF,OAAO,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED,8BAA8B;AAC9B,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,GAAW,EACX,MAAc;IAEd,MAAM,MAAM,GAAG,MAAM,MAAM,CACzB,CAAC,YAAY,EAAE,IAAI,EAAE,GAAG,UAAU,IAAI,MAAM,EAAE,CAAC,EAC/C,EAAE,GAAG,EAAE,CACR,CAAC;IACF,OAAO,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC;AAC/B,CAAC;AAED,+CAA+C;AAC/C,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,GAAW;IAEX,MAAM,MAAM,GAAG,MAAM,MAAM,CACzB;QACE,cAAc;QACd,GAAG,UAAU,GAAG;QAChB,qCAAqC;KACtC,EACD,EAAE,GAAG,EAAE,CACR,CAAC;IAEF,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAE9D,OAAO,MAAM,CAAC,MAAM;SACjB,IAAI,EAAE;SACN,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACZ,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,UAAU,GAAG,EAAE,EAAE,CAAC,CAAC;QACrD,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IACzB,CAAC,CAAC;SACD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;AACtC,CAAC;AAED,iCAAiC;AACjC,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,GAAW,EACX,GAAW;IAEX,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7D,CAAC;AAED,kCAAkC;AAClC,MAAM,UAAU,YAAY;IAC1B,OAAO,UAAU,CAAC;AACpB,CAAC"}

package/dist/git/runner.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Git command runner.
+ *
+ * Thin wrapper around child_process that handles timeouts,
+ * error formatting, and environment variable injection
+ * (especially GIT_INDEX_FILE for temp-index operations).
+ */
+export interface GitResult {
+    stdout: string;
+    stderr: string;
+    exitCode: number;
+}
+export interface GitRunOptions {
+    cwd: string;
+    env?: Record<string, string>;
+    timeout?: number;
+}
+/** Run a git command and return structured result */
+export declare function runGit(args: string[], opts: GitRunOptions): Promise<GitResult>;
+/** Run git and throw if it fails */
+export declare function runGitOrThrow(args: string[], opts: GitRunOptions): Promise<string>;
+/** Get the current HEAD SHA */
+export declare function getHeadSha(cwd: string): Promise<string | null>;
+/** Get the current branch name */
+export declare function getCurrentBranch(cwd: string): Promise<string | null>;
+/** Get the remote URL for origin */
+export declare function getRemoteUrl(cwd: string): Promise<string | null>;
+/** Check if a path is inside a git repository */
+export declare function isGitRepo(cwd: string): Promise<boolean>;
+/** Check if a local branch exists */
+export declare function branchExists(cwd: string, branch: string): Promise<boolean>;
+/** Check if a git object (commit, tree, blob) exists in the object store */
+export declare function shaExists(cwd: string, sha: string): Promise<boolean>;
+//# sourceMappingURL=runner.d.ts.map

package/dist/git/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/git/runner.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID,qDAAqD;AACrD,wBAAsB,MAAM,CAC1B,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,SAAS,CAAC,CAqBpB;AAED,oCAAoC;AACpC,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED,+BAA+B;AAC/B,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGpE;AAED,kCAAkC;AAClC,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAG1E;AAED,oCAAoC;AACpC,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAGtE;AAED,iDAAiD;AACjD,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG7D;AAED,qCAAqC;AACrC,wBAAsB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGhF;AAED,4EAA4E;AAC5E,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG1E"}

package/dist/git/runner.js

@@ -0,0 +1,70 @@
+/**
+ * Git command runner.
+ *
+ * Thin wrapper around child_process that handles timeouts,
+ * error formatting, and environment variable injection
+ * (especially GIT_INDEX_FILE for temp-index operations).
+ */
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+const DEFAULT_TIMEOUT = 30_000;
+/** Run a git command and return structured result */
+export async function runGit(args, opts) {
+    try {
+        const { stdout, stderr } = await execFileAsync("git", args, {
+            cwd: opts.cwd,
+            env: { ...process.env, ...opts.env },
+            timeout: opts.timeout ?? DEFAULT_TIMEOUT,
+            maxBuffer: 10 * 1024 * 1024, // 10MB
+        });
+        return { stdout, stderr, exitCode: 0 };
+    }
+    catch (err) {
+        const error = err;
+        return {
+            stdout: error.stdout ?? "",
+            stderr: error.stderr ?? String(err),
+            exitCode: typeof error.code === "number" ? error.code : 1,
+        };
+    }
+}
+/** Run git and throw if it fails */
+export async function runGitOrThrow(args, opts) {
+    const result = await runGit(args, opts);
+    if (result.exitCode !== 0) {
+        throw new Error(`git ${args.join(" ")} failed (exit ${result.exitCode}): ${result.stderr}`);
+    }
+    return result.stdout.trim();
+}
+/** Get the current HEAD SHA */
+export async function getHeadSha(cwd) {
+    const result = await runGit(["rev-parse", "HEAD"], { cwd });
+    return result.exitCode === 0 ? result.stdout.trim() : null;
+}
+/** Get the current branch name */
+export async function getCurrentBranch(cwd) {
+    const result = await runGit(["rev-parse", "--abbrev-ref", "HEAD"], { cwd });
+    return result.exitCode === 0 ? result.stdout.trim() : null;
+}
+/** Get the remote URL for origin */
+export async function getRemoteUrl(cwd) {
+    const result = await runGit(["remote", "get-url", "origin"], { cwd });
+    return result.exitCode === 0 ? result.stdout.trim() : null;
+}
+/** Check if a path is inside a git repository */
+export async function isGitRepo(cwd) {
+    const result = await runGit(["rev-parse", "--git-dir"], { cwd });
+    return result.exitCode === 0;
+}
+/** Check if a local branch exists */
+export async function branchExists(cwd, branch) {
+    const result = await runGit(["rev-parse", "--verify", `refs/heads/${branch}`], { cwd });
+    return result.exitCode === 0;
+}
+/** Check if a git object (commit, tree, blob) exists in the object store */
+export async function shaExists(cwd, sha) {
+    const result = await runGit(["cat-file", "-t", sha], { cwd });
+    return result.exitCode === 0;
+}
+//# sourceMappingURL=runner.js.map

package/dist/git/runner.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @vkenliu/adit-engine — Git operations, snapshots, detection, timeline, and environment capture.
+ */
+export { runGit, runGitOrThrow, getHeadSha, getCurrentBranch, getRemoteUrl, isGitRepo, branchExists, shaExists, type GitResult, type GitRunOptions, } from "./git/runner.js";
+export { storeCheckpointRef, resolveCheckpointRef, deleteCheckpointRef, listCheckpointRefs, getParentSha, getRefPrefix, } from "./git/refs.js";
+export { getChangedFiles, hasUncommittedChanges, getNumstat, getChangesSummary, isDirtyFrom, type FileChange, type NumstatEntry, } from "./detector/working-tree.js";
+export { createSnapshot, getCheckpointDiff, type SnapshotResult, } from "./snapshot/creator.js";
+export { createTimelineManager, type TimelineManager, type RecordEventParams, type ListOptions, } from "./timeline/manager.js";
+export { captureEnvironment, type PreComputedGitState } from "./environment/capture.js";
+export { diffEnvironments } from "./environment/differ.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,MAAM,EACN,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,SAAS,EACT,KAAK,SAAS,EACd,KAAK,aAAa,GACnB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,YAAY,GACb,MAAM,eAAe,CAAC;AAGvB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,UAAU,EACV,iBAAiB,EACjB,WAAW,EACX,KAAK,UAAU,EACf,KAAK,YAAY,GAClB,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,KAAK,cAAc,GACpB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,WAAW,GACjB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EAAE,kBAAkB,EAAE,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,16 @@
+/**
+ * @vkenliu/adit-engine — Git operations, snapshots, detection, timeline, and environment capture.
+ */
+// Git operations
+export { runGit, runGitOrThrow, getHeadSha, getCurrentBranch, getRemoteUrl, isGitRepo, branchExists, shaExists, } from "./git/runner.js";
+export { storeCheckpointRef, resolveCheckpointRef, deleteCheckpointRef, listCheckpointRefs, getParentSha, getRefPrefix, } from "./git/refs.js";
+// Working tree detection
+export { getChangedFiles, hasUncommittedChanges, getNumstat, getChangesSummary, isDirtyFrom, } from "./detector/working-tree.js";
+// Snapshot creation
+export { createSnapshot, getCheckpointDiff, } from "./snapshot/creator.js";
+// Timeline management
+export { createTimelineManager, } from "./timeline/manager.js";
+// Environment capture & diffing
+export { captureEnvironment } from "./environment/capture.js";
+export { diffEnvironments } from "./environment/differ.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,iBAAiB;AACjB,OAAO,EACL,MAAM,EACN,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,SAAS,GAGV,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,EAClB,YAAY,EACZ,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,yBAAyB;AACzB,OAAO,EACL,eAAe,EACf,qBAAqB,EACrB,UAAU,EACV,iBAAiB,EACjB,WAAW,GAGZ,MAAM,4BAA4B,CAAC;AAEpC,oBAAoB;AACpB,OAAO,EACL,cAAc,EACd,iBAAiB,GAElB,MAAM,uBAAuB,CAAC;AAE/B,sBAAsB;AACtB,OAAO,EACL,qBAAqB,GAItB,MAAM,uBAAuB,CAAC;AAE/B,gCAAgC;AAChC,OAAO,EAAE,kBAAkB,EAA4B,MAAM,0BAA0B,CAAC;AACxF,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/snapshot/creator.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Snapshot creator using temporary Git index.
+ *
+ * Creates git commit snapshots WITHOUT touching the user's staging area.
+ * This is the key technique from Rewindo: we set GIT_INDEX_FILE to a
+ * temp file, stage all changes there, create a tree+commit, and store
+ * it as a ref. The user's real index is never modified.
+ */
+import { type FileChange } from "../detector/working-tree.js";
+export interface SnapshotResult {
+    /** The commit SHA of the snapshot */
+    sha: string;
+    /** The ref path where it's stored */
+    ref: string;
+    /** Files included in the snapshot */
+    files: Array<{
+        path: string;
+        status: string;
+        additions?: number;
+        deletions?: number;
+    }>;
+}
+/** Create a snapshot of the current working tree state */
+export declare function createSnapshot(cwd: string, parentSha: string | null, message: string, refPath: string, preComputedChanges?: FileChange[]): Promise<SnapshotResult | null>;
+/** Get the unified diff between a checkpoint and its parent */
+export declare function getCheckpointDiff(cwd: string, sha: string, parentSha?: string, filePath?: string): Promise<string>;
+//# sourceMappingURL=creator.d.ts.map

package/dist/snapshot/creator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"creator.d.ts","sourceRoot":"","sources":["../../src/snapshot/creator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,EAAmB,KAAK,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAG/E,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,qCAAqC;IACrC,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ;AAED,0DAA0D;AAC1D,wBAAsB,cAAc,CAClC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,GAAG,IAAI,EACxB,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,kBAAkB,CAAC,EAAE,UAAU,EAAE,GAChC,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA8DhC;AAuBD,+DAA+D;AAC/D,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,SAAS,CAAC,EAAE,MAAM,EAClB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,MAAM,CAAC,CAgBjB"}

package/dist/snapshot/creator.js

@@ -0,0 +1,103 @@
+/**
+ * Snapshot creator using temporary Git index.
+ *
+ * Creates git commit snapshots WITHOUT touching the user's staging area.
+ * This is the key technique from Rewindo: we set GIT_INDEX_FILE to a
+ * temp file, stage all changes there, create a tree+commit, and store
+ * it as a ref. The user's real index is never modified.
+ */
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { unlinkSync, existsSync } from "node:fs";
+import { randomBytes } from "node:crypto";
+import { runGit, runGitOrThrow } from "../git/runner.js";
+import { getChangedFiles } from "../detector/working-tree.js";
+import { getNumstat } from "../detector/working-tree.js";
+/** Create a snapshot of the current working tree state */
+export async function createSnapshot(cwd, parentSha, message, refPath, preComputedChanges) {
+    // Reuse pre-computed changes when the caller already ran git status
+    const changes = preComputedChanges ?? await getChangedFiles(cwd);
+    if (changes.length === 0)
+        return null;
+    // Create temp index file
+    const tempIndex = join(tmpdir(), `adit-index-${randomBytes(8).toString("hex")}`);
+    const env = { GIT_INDEX_FILE: tempIndex };
+    try {
+        // Start from HEAD's tree in the temp index.
+        // On a brand-new repo with no commits (unborn HEAD), read-tree HEAD
+        // fails. In that case we start with an empty index, which is correct —
+        // the subsequent git-add will stage all files as new.
+        const readTreeResult = await runGit(["read-tree", "HEAD"], { cwd, env });
+        if (readTreeResult.exitCode !== 0) {
+            // Unborn HEAD — start from an empty tree
+            await runGitOrThrow(["read-tree", "--empty"], { cwd, env });
+        }
+        // Stage all changes into temp index
+        await stageChanges(cwd, changes, env);
+        // Write tree object
+        const treeSha = await runGitOrThrow(["write-tree"], { cwd, env });
+        // Create commit object
+        const commitArgs = ["commit-tree", treeSha, "-m", message];
+        if (parentSha) {
+            commitArgs.splice(2, 0, "-p", parentSha);
+        }
+        const commitSha = await runGitOrThrow(commitArgs, { cwd, env });
+        // Store as a ref
+        await runGitOrThrow(["update-ref", refPath, commitSha], { cwd });
+        // Get file stats
+        const numstat = await getNumstat(cwd, parentSha ?? undefined);
+        const files = changes.map((c) => {
+            const stat = numstat.find((n) => n.path === c.path);
+            return {
+                path: c.path,
+                status: c.status,
+                additions: stat?.additions,
+                deletions: stat?.deletions,
+            };
+        });
+        return { sha: commitSha, ref: refPath, files };
+    }
+    finally {
+        // Always clean up temp index
+        if (existsSync(tempIndex)) {
+            try {
+                unlinkSync(tempIndex);
+            }
+            catch {
+                // Best effort cleanup
+            }
+        }
+    }
+}
+/** Stage file changes into a (possibly temp) index */
+async function stageChanges(cwd, changes, env) {
+    // Batch into at most 2 git commands instead of N sequential spawns.
+    // Use runGitOrThrow so that staging failures (e.g. files deleted between
+    // getChangedFiles and staging) surface immediately rather than producing
+    // corrupted checkpoint snapshots with missing files.
+    const toDelete = changes.filter((c) => c.status === "D").map((c) => c.path);
+    const toAdd = changes.filter((c) => c.status !== "D").map((c) => c.path);
+    if (toDelete.length > 0) {
+        await runGitOrThrow(["rm", "--cached", "--", ...toDelete], { cwd, env });
+    }
+    if (toAdd.length > 0) {
+        await runGitOrThrow(["add", "--", ...toAdd], { cwd, env });
+    }
+}
+/** Get the unified diff between a checkpoint and its parent */
+export async function getCheckpointDiff(cwd, sha, parentSha, filePath) {
+    // When parentSha is provided, diff between the two commits.
+    // When parentSha is absent this is the first checkpoint — use diff-tree
+    // with --root to show the full diff against an empty tree. The old
+    // `diff ${sha}^ ${sha}` approach fails silently when the commit has no
+    // parent, producing an empty string and losing the diff data.
+    const args = parentSha
+        ? ["diff", parentSha, sha]
+        : ["diff-tree", "--root", "-p", sha];
+    if (filePath) {
+        args.push("--", filePath);
+    }
+    const result = await runGit(args, { cwd });
+    return result.stdout;
+}
+//# sourceMappingURL=creator.js.map

package/dist/snapshot/creator.js.map

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

package/dist/timeline/manager.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Timeline manager — the high-level orchestrator.
+ *
+ * Coordinates between the database, git operations, and snapshot creation
+ * to provide the unified timeline experience.
+ */
+import type Database from "better-sqlite3";
+import { type AditEvent, type EventType, type Actor, type AditConfig } from "@vkenliu/adit-core";
+import type { FileChange } from "../detector/working-tree.js";
+export interface TimelineManager {
+    /** Record a new event in the timeline */
+    recordEvent(params: RecordEventParams): Promise<AditEvent>;
+    /** Create a git checkpoint for an event */
+    createCheckpoint(eventId: string, message: string, preComputedChanges?: FileChange[]): Promise<{
+        sha: string;
+        ref: string;
+    } | null>;
+    /** Revert working tree to a checkpoint */
+    revertTo(eventId: string): Promise<void>;
+    /** Undo the last checkpoint */
+    undo(): Promise<void>;
+    /** Search events by text */
+    search(query: string, limit?: number): Promise<AditEvent[]>;
+    /** List recent events */
+    list(opts?: ListOptions): Promise<AditEvent[]>;
+    /** Get a single event by ID */
+    get(eventId: string): Promise<AditEvent | null>;
+    /** Get diff text for an event */
+    getDiff(eventId: string, maxLines?: number, offsetLines?: number): Promise<string | null>;
+}
+export interface RecordEventParams {
+    sessionId: string;
+    parentEventId?: string | null;
+    eventType: EventType;
+    actor: Actor;
+    promptText?: string | null;
+    cotText?: string | null;
+    responseText?: string | null;
+    toolName?: string | null;
+    toolInputJson?: string | null;
+    toolOutputJson?: string | null;
+    errorJson?: string | null;
+    planTaskId?: string | null;
+}
+export interface ListOptions {
+    sessionId?: string;
+    eventType?: EventType;
+    actor?: Actor;
+    hasCheckpoint?: boolean;
+    limit?: number;
+}
+/** Create a timeline manager instance */
+export declare function createTimelineManager(db: Database.Database, config: AditConfig): TimelineManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/timeline/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/timeline/manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAYL,KAAK,SAAS,EACd,KAAK,SAAS,EACd,KAAK,KAAK,EACV,KAAK,UAAU,EAEhB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAK9D,MAAM,WAAW,eAAe;IAC9B,yCAAyC;IACzC,WAAW,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAE3D,2CAA2C;IAC3C,gBAAgB,CACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,EACf,kBAAkB,CAAC,EAAE,UAAU,EAAE,GAChC,OAAO,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAEhD,0CAA0C;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEzC,+BAA+B;IAC/B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB,4BAA4B;IAC5B,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAE5D,yBAAyB;IACzB,IAAI,CAAC,IAAI,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAE/C,+BAA+B;IAC/B,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IAEhD,iCAAiC;IACjC,OAAO,CACL,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,yCAAyC;AACzC,wBAAgB,qBAAqB,CACnC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,MAAM,EAAE,UAAU,GACjB,eAAe,CAyLjB"}

package/dist/timeline/manager.js

@@ -0,0 +1,154 @@
+/**
+ * Timeline manager — the high-level orchestrator.
+ *
+ * Coordinates between the database, git operations, and snapshot creation
+ * to provide the unified timeline experience.
+ */
+import { generateId, createClock, serialize, insertEventAutoSeq, getEventById, queryEvents, updateEventCheckpoint, searchEvents, getLatestCheckpointEvent, insertDiff, getDiffText, withPerf, } from "@vkenliu/adit-core";
+import { createSnapshot, getCheckpointDiff } from "../snapshot/creator.js";
+import { getHeadSha, getCurrentBranch, shaExists } from "../git/runner.js";
+import { getRefPrefix } from "../git/refs.js";
+import { runGitOrThrow } from "../git/runner.js";
+/** Create a timeline manager instance */
+export function createTimelineManager(db, config) {
+    const cwd = config.projectRoot;
+    return {
+        async recordEvent(params) {
+            const id = generateId();
+            const now = new Date().toISOString();
+            const branch = await getCurrentBranch(cwd);
+            const headSha = await getHeadSha(cwd);
+            const vclock = serialize(createClock(config.clientId));
+            // Use insertEventAutoSeq to atomically allocate the sequence number
+            // inside the INSERT, preventing duplicate sequences from concurrent
+            // hook processes that could read the same MAX(sequence).
+            insertEventAutoSeq(db, {
+                id,
+                sessionId: params.sessionId,
+                parentEventId: params.parentEventId ?? null,
+                eventType: params.eventType,
+                actor: params.actor,
+                promptText: params.promptText ?? null,
+                cotText: params.cotText ?? null,
+                responseText: params.responseText ?? null,
+                toolName: params.toolName ?? null,
+                toolInputJson: params.toolInputJson ?? null,
+                toolOutputJson: params.toolOutputJson ?? null,
+                gitBranch: branch,
+                gitHeadSha: headSha,
+                startedAt: now,
+                status: "success",
+                endedAt: now,
+                errorJson: params.errorJson ?? null,
+                planTaskId: params.planTaskId ?? null,
+                clientId: config.clientId,
+                vclockJson: vclock,
+            });
+            const event = getEventById(db, id);
+            if (!event) {
+                throw new Error(`Failed to retrieve event after insert: ${id}`);
+            }
+            return event;
+        },
+        async createCheckpoint(eventId, message, preComputedChanges) {
+            return withPerf(config.dataDir, "snapshot", "createCheckpoint", async () => {
+                const event = getEventById(db, eventId);
+                if (!event)
+                    throw new Error(`Event not found: ${eventId}`);
+                // Find the parent checkpoint SHA for proper chaining
+                const lastCheckpoint = getLatestCheckpointEvent(db, event.sessionId);
+                const parentSha = lastCheckpoint?.checkpointSha ?? (await getHeadSha(cwd));
+                const refPath = `${getRefPrefix()}/${eventId}`;
+                const result = await createSnapshot(cwd, parentSha, message, refPath, preComputedChanges);
+                if (!result)
+                    return null;
+                // Store the diff
+                const diffText = await getCheckpointDiff(cwd, result.sha, parentSha ?? undefined);
+                if (diffText) {
+                    insertDiff(db, {
+                        id: generateId(),
+                        eventId,
+                        diffText,
+                    });
+                }
+                // Update the event with checkpoint info
+                updateEventCheckpoint(db, eventId, result.sha, result.ref, JSON.stringify(result.files));
+                return { sha: result.sha, ref: result.ref };
+            });
+        },
+        async revertTo(eventId) {
+            const event = getEventById(db, eventId);
+            if (!event)
+                throw new Error(`Event not found: ${eventId}`);
+            if (!event.checkpointSha) {
+                throw new Error(`Event ${eventId} has no checkpoint`);
+            }
+            // Verify the checkpoint commit object is reachable (may have been
+            // garbage collected if the ref was deleted after a squash merge).
+            const reachable = await shaExists(cwd, event.checkpointSha);
+            if (!reachable) {
+                throw new Error(`Checkpoint ${event.checkpointSha.substring(0, 8)} is no longer reachable in the git object store. ` +
+                    `The checkpoint ref may have been deleted and the object garbage collected.`);
+            }
+            // Use checkout to restore working tree content from the checkpoint
+            // WITHOUT moving the branch pointer. git reset --hard would move HEAD
+            // to the ADIT-internal checkpoint commit, corrupting branch history.
+            await runGitOrThrow(["checkout", event.checkpointSha, "--", "."], { cwd });
+        },
+        async undo() {
+            const latest = getLatestCheckpointEvent(db);
+            if (!latest?.checkpointSha) {
+                throw new Error("No checkpoints to undo");
+            }
+            // Find the target SHA to restore to. Try the git parent first;
+            // if that fails (e.g., after a squash merge where the parent commit
+            // is unreachable), fall back to the previous checkpoint in the DB
+            // by sequence order, or HEAD as a last resort.
+            let targetSha = null;
+            // Attempt 1: git parent of latest checkpoint commit
+            const parentResult = await import("../git/refs.js").then((m) => m.getParentSha(cwd, latest.checkpointSha));
+            if (parentResult && (await shaExists(cwd, parentResult))) {
+                targetSha = parentResult;
+            }
+            // Attempt 2: previous checkpoint in DB sequence
+            if (!targetSha) {
+                const allCheckpoints = queryEvents(db, { hasCheckpoint: true, limit: 2 });
+                // allCheckpoints is ordered by started_at DESC; [0] is latest, [1] is previous
+                const previous = allCheckpoints.find((e) => e.id !== latest.id);
+                if (previous?.checkpointSha && (await shaExists(cwd, previous.checkpointSha))) {
+                    targetSha = previous.checkpointSha;
+                }
+            }
+            // Attempt 3: fall back to HEAD
+            if (!targetSha) {
+                targetSha = await getHeadSha(cwd);
+            }
+            if (!targetSha) {
+                throw new Error("Cannot find a valid target to undo to");
+            }
+            // Use checkout to restore working tree content from the target
+            // WITHOUT moving the branch pointer. git reset --hard would move HEAD
+            // to the ADIT-internal checkpoint commit, corrupting branch history.
+            await runGitOrThrow(["checkout", targetSha, "--", "."], { cwd });
+        },
+        async search(query, limit = 20) {
+            return searchEvents(db, query, limit);
+        },
+        async list(opts) {
+            return queryEvents(db, {
+                sessionId: opts?.sessionId,
+                eventType: opts?.eventType,
+                actor: opts?.actor,
+                hasCheckpoint: opts?.hasCheckpoint,
+                limit: opts?.limit ?? 50,
+            });
+        },
+        async get(eventId) {
+            return getEventById(db, eventId);
+        },
+        async getDiff(eventId, maxLines, offsetLines) {
+            return getDiffText(db, eventId, maxLines, offsetLines);
+        },
+    };
+}
+//# sourceMappingURL=manager.js.map

package/dist/timeline/manager.js.map

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

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@vkenliu/adit-engine",
+  "version": "0.2.0",
+  "description": "Git operations, snapshots, detection, and timeline engine for ADIT",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "@vkenliu/adit-core": "0.2.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "typescript": "^5.7.2"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  }
+}