@izagood/avcs 0.27.0 → 0.28.0

package/dist/importer/gitHistory.d.ts

@@ -0,0 +1,98 @@
+import type { Repo } from "../api/repo.ts";
+import type { Actor } from "../objects/types.ts";
+/**
+ * Programmatic git-history import (issue #63).
+ *
+ * A server process (or any embedder) replays a git repository's history into
+ * an AVCS operation graph without shelling out to the `avcs` CLI. Two layers,
+ * so the core's git-independence is preserved:
+ *
+ *  - {@link GitHistorySource} — the seam. Anything that can enumerate commits
+ *    (sha + metadata + per-commit file changes) drives the import; no git
+ *    binary is required at this layer.
+ *  - {@link gitCliSource} — the batteries-included source. Reads a checkout,
+ *    a bare repo, a bundle file, or a clone URL by shelling out to `git`
+ *    (exactly like the CLI's existing git-bridge does). Fails with a clear
+ *    error when no git binary is available.
+ *
+ * History maps onto AVCS the way `commitWorkingTree` established: one intent +
+ * one session per commit (title = the commit subject, owner = the git author),
+ * `put_file`/`delete_file` operations per changed path, each new commit's ops
+ * anchored on the previous frontier via `causalDeps`. AVCS history is an
+ * operation graph, not replayed diffs — the import walks the FIRST-PARENT
+ * line, so a merge commit lands as its net effect on the mainline (the side
+ * branch's internal commits are not replayed).
+ *
+ * Commit metadata travels in existing fields — no object-schema change:
+ * the actor is `git:<author-email>`, `Co-authored-by:` trailers become
+ * `coAuthors`, and `declaredPurpose` carries the full commit message plus a
+ * `[git <sha>] <author> <date>` provenance line.
+ */
+/** One file touched by a commit. `read` is required for `kind: "write"`. */
+export interface GitFileChange {
+    readonly path: string;
+    readonly kind: "write" | "delete";
+    readonly read?: () => Promise<Uint8Array>;
+}
+/** One commit on the imported line, in replay (oldest-first) order. */
+export interface GitCommitRecord {
+    readonly sha: string;
+    readonly subject: string;
+    readonly message: string;
+    readonly authorName: string;
+    readonly authorEmail: string;
+    /** Author date, ISO-8601. */
+    readonly authorDate: string;
+    readonly coAuthors: ReadonlyArray<{
+        name: string;
+        email: string;
+    }>;
+    readonly changes: readonly GitFileChange[];
+}
+/** The import seam: enumerate commits oldest-first. No git binary implied. */
+export interface GitHistorySource {
+    commits(): AsyncIterable<GitCommitRecord>;
+    /** Release temp resources (e.g. a bare clone). Safe to omit. */
+    close?(): Promise<void>;
+}
+export interface ImportGitHistoryOptions {
+    /** AVCS line (view) to import onto. Default `main`. */
+    readonly line?: string;
+    /**
+     * Actor recorded when a commit has no usable author identity, and the
+     * session opener. Defaults to `{ id: "git-import", kind: "ci_bot" }`.
+     */
+    readonly actor?: Actor;
+    /** Progress callback: commits replayed so far + the sha just finished. */
+    readonly onCommit?: (done: number, sha: string) => void;
+}
+export interface ImportGitHistoryResult {
+    /** Commits walked on the first-parent line (empty ones included). */
+    readonly commits: number;
+    /** Operations authored. */
+    readonly operations: number;
+    /** Intents created (one per commit that changed anything). */
+    readonly intents: number;
+}
+/** What {@link gitCliSource} accepts: a checkout/bare dir, a bundle, or a URL. */
+export type GitCliTarget = string | {
+    dir?: string;
+    url?: string;
+    bundle?: string;
+    ref?: string;
+};
+/**
+ * A {@link GitHistorySource} backed by the `git` binary. A URL or bundle is
+ * bare-cloned into a temp dir (removed on `close()`); a local dir is read in
+ * place. The walk is `rev-list --first-parent --reverse <ref>` and per-commit
+ * changes come from `diff-tree` against the first parent (`--no-renames`, so
+ * a rename is a delete + write — the reducer treats paths as entities).
+ */
+export declare function gitCliSource(target: GitCliTarget): Promise<GitHistorySource>;
+/**
+ * Replay a git history into `repo` as an operation graph. See the module doc
+ * for the mapping. Accepts a {@link GitHistorySource}, or anything
+ * {@link gitCliSource} understands (dir / URL / bundle path).
+ */
+export declare function importGitHistory(repo: Repo, source: GitHistorySource | GitCliTarget, opts?: ImportGitHistoryOptions): Promise<ImportGitHistoryResult>;
+//# sourceMappingURL=gitHistory.d.ts.map

package/dist/importer/gitHistory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitHistory.d.ts","sourceRoot":"","sources":["../../src/importer/gitHistory.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAIjD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,4EAA4E;AAC5E,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,CAAC;IAClC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;CAC3C;AAED,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,6BAA6B;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACnE,QAAQ,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,CAAC;CAC5C;AAED,8EAA8E;AAC9E,MAAM,WAAW,gBAAgB;IAC/B,OAAO,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC;IAC1C,gEAAgE;IAChE,KAAK,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,uBAAuB;IACtC,uDAAuD;IACvD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CACzD;AAED,MAAM,WAAW,sBAAsB;IACrC,qEAAqE;IACrE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,2BAA2B;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,8DAA8D;IAC9D,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,kFAAkF;AAClF,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AA0BlG;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAsFlF;AASD;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,IAAI,EACV,MAAM,EAAE,gBAAgB,GAAG,YAAY,EACvC,IAAI,GAAE,uBAA4B,GACjC,OAAO,CAAC,sBAAsB,CAAC,CA0EjC"}

package/dist/importer/gitHistory.js

@@ -0,0 +1,203 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { existsSync } from "node:fs";
+import { mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+const execFileAsync = promisify(execFile);
+async function runGit(dir, args) {
+    const { stdout } = await execFileAsync("git", ["-C", dir, ...args], {
+        maxBuffer: 1 << 28,
+    });
+    return stdout;
+}
+async function runGitBuffer(dir, args) {
+    const { stdout } = await execFileAsync("git", ["-C", dir, ...args], {
+        maxBuffer: 1 << 28,
+        encoding: "buffer",
+    });
+    return stdout;
+}
+function parseCoAuthors(message) {
+    const out = [];
+    for (const line of message.split("\n")) {
+        const m = /^co-authored-by:\s*(.+?)\s*<([^>]*)>\s*$/i.exec(line.trim());
+        if (m)
+            out.push({ name: m[1], email: m[2] });
+    }
+    return out;
+}
+/**
+ * A {@link GitHistorySource} backed by the `git` binary. A URL or bundle is
+ * bare-cloned into a temp dir (removed on `close()`); a local dir is read in
+ * place. The walk is `rev-list --first-parent --reverse <ref>` and per-commit
+ * changes come from `diff-tree` against the first parent (`--no-renames`, so
+ * a rename is a delete + write — the reducer treats paths as entities).
+ */
+export async function gitCliSource(target) {
+    try {
+        await execFileAsync("git", ["--version"]);
+    }
+    catch {
+        throw new Error("gitCliSource requires a `git` executable on PATH. To import without one, " +
+            "implement GitHistorySource yourself (e.g. over a parsed bundle) and pass it " +
+            "to importGitHistory directly.");
+    }
+    const t = typeof target === "string" ? inferTarget(target) : target;
+    const ref = t.ref ?? "HEAD";
+    let dir;
+    let tempClone = null;
+    if (t.dir) {
+        dir = t.dir;
+    }
+    else {
+        const source = t.url ?? t.bundle;
+        if (!source)
+            throw new Error("gitCliSource: pass one of dir, url, or bundle");
+        tempClone = await mkdtemp(join(tmpdir(), "avcs-git-import-"));
+        await execFileAsync("git", ["clone", "--bare", "--quiet", source, join(tempClone, "src.git")], {
+            maxBuffer: 1 << 24,
+        });
+        dir = join(tempClone, "src.git");
+    }
+    return {
+        async *commits() {
+            const shas = (await runGit(dir, ["rev-list", "--first-parent", "--reverse", ref]))
+                .split("\n")
+                .filter(Boolean);
+            for (const sha of shas) {
+                // %x00-separated to survive arbitrary subjects/messages.
+                const meta = await runGit(dir, [
+                    "show",
+                    "-s",
+                    "--format=%an%x00%ae%x00%aI%x00%s%x00%B",
+                    sha,
+                ]);
+                const [authorName = "", authorEmail = "", authorDate = "", subject = "", ...rest] = meta.split("\0");
+                const message = rest.join("\0").replace(/\n$/, "");
+                // First-parent diff; --root covers the parentless first commit.
+                const hasParent = (await runGit(dir, ["rev-list", "--parents", "-n", "1", sha])).trim().split(" ").length > 1;
+                const rawDiff = hasParent
+                    ? await runGit(dir, ["diff-tree", "--no-renames", "-r", "-z", "--name-status", `${sha}^`, sha])
+                    : await runGit(dir, ["diff-tree", "--root", "--no-renames", "-r", "-z", "--name-status", sha]);
+                const fields = rawDiff.split("\0").filter(Boolean);
+                // A --root diff-tree echoes the sha as its first record; drop it.
+                const records = fields[0] === sha ? fields.slice(1) : fields;
+                const changes = [];
+                for (let i = 0; i + 1 < records.length; i += 2) {
+                    const status = records[i];
+                    const path = records[i + 1];
+                    if (status.startsWith("D")) {
+                        changes.push({ path, kind: "delete" });
+                    }
+                    else {
+                        changes.push({
+                            path,
+                            kind: "write",
+                            read: () => runGitBuffer(dir, ["cat-file", "blob", `${sha}:${path}`]),
+                        });
+                    }
+                }
+                yield {
+                    sha,
+                    subject,
+                    message,
+                    authorName,
+                    authorEmail,
+                    authorDate,
+                    coAuthors: parseCoAuthors(message),
+                    changes,
+                };
+            }
+        },
+        async close() {
+            if (tempClone)
+                await rm(tempClone, { recursive: true, force: true });
+        },
+    };
+}
+function inferTarget(target) {
+    if (/^[a-z+]+:\/\//i.test(target) || /^[^/\s]+@[^/\s]+:/.test(target))
+        return { url: target };
+    if (target.endsWith(".bundle"))
+        return { bundle: target };
+    if (existsSync(target))
+        return { dir: target };
+    return { url: target };
+}
+/**
+ * Replay a git history into `repo` as an operation graph. See the module doc
+ * for the mapping. Accepts a {@link GitHistorySource}, or anything
+ * {@link gitCliSource} understands (dir / URL / bundle path).
+ */
+export async function importGitHistory(repo, source, opts = {}) {
+    const src = typeof source === "object" && source !== null && "commits" in source
+        ? source
+        : await gitCliSource(source);
+    const fallback = opts.actor ?? { id: "git-import", kind: "ci_bot" };
+    let commits = 0;
+    let operations = 0;
+    let intents = 0;
+    try {
+        for await (const c of src.commits()) {
+            commits += 1;
+            if (c.changes.length === 0) {
+                opts.onCommit?.(commits, c.sha);
+                continue;
+            }
+            const authorId = c.authorEmail || c.authorName;
+            const actor = authorId ? { id: `git:${authorId}`, kind: "human" } : fallback;
+            const coAuthors = c.coAuthors.map((a) => ({
+                id: `git:${a.email || a.name}`,
+                kind: "human",
+            }));
+            const purpose = `${c.message.trimEnd()}\n\n` +
+                `[git ${c.sha}] ${c.authorName} <${c.authorEmail}> ${c.authorDate}`;
+            // Anchor this commit's ops on the current frontier — the same shape
+            // commitWorkingTree produces, so downstream tooling sees familiar graphs.
+            const res = await repo.materialize(opts.line ?? "main");
+            const deps = res.headOps;
+            const intentOid = await repo.createIntent({ title: c.subject || c.sha, owner: actor.id });
+            const sessionOid = await repo.startSession({ intentOid, actor });
+            intents += 1;
+            for (const change of c.changes) {
+                if (change.kind === "write") {
+                    if (!change.read)
+                        throw new Error(`GitFileChange for ${change.path} lacks read()`);
+                    const blobOid = await repo.putBlob(await change.read());
+                    await repo.proposeOperation({
+                        sessionOid,
+                        intentOid,
+                        actor,
+                        target: { entityKind: "file", entityId: change.path },
+                        body: { kind: "put_file", path: change.path, blobOid },
+                        declaredPurpose: purpose,
+                        causalDeps: deps,
+                        coAuthors,
+                        line: opts.line,
+                    });
+                }
+                else {
+                    await repo.proposeOperation({
+                        sessionOid,
+                        intentOid,
+                        actor,
+                        target: { entityKind: "file", entityId: change.path },
+                        body: { kind: "delete_file", path: change.path },
+                        declaredPurpose: purpose,
+                        causalDeps: deps,
+                        coAuthors,
+                        line: opts.line,
+                    });
+                }
+                operations += 1;
+            }
+            opts.onCommit?.(commits, c.sha);
+        }
+    }
+    finally {
+        await src.close?.();
+    }
+    return { commits, operations, intents };
+}
+//# sourceMappingURL=gitHistory.js.map

package/dist/importer/gitHistory.js.map

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

package/dist/index.d.ts

@@ -20,4 +20,5 @@ export { Logger, consoleLogger, silentLogger } from "./observe/logger.ts";
 export type { LogEntry, LogLevel } from "./observe/logger.ts";
 export { Metrics } from "./observe/metrics.ts";
 export type { Timing } from "./observe/metrics.ts";
+export { importGitHistory, gitCliSource, type GitHistorySource, type GitCommitRecord, type GitFileChange, type GitCliTarget, type ImportGitHistoryOptions, type ImportGitHistoryResult, } from "./importer/gitHistory.ts";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAO9E,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAG1E,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC7H,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAKjH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGtF,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACzE,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACpE,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC3E,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACzJ,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG5F,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC1F,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGxE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC1E,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,YAAY,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,YAAY,EAAE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAO9E,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAG1E,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC7H,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAKjH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAGtF,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AACzE,YAAY,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AACpE,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC3E,YAAY,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGxE,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACzJ,YAAY,EAAE,cAAc,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAG5F,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAC1F,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGxE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC1E,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,YAAY,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD,OAAO,EACL,gBAAgB,EAChB,YAAY,EACZ,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,GAC5B,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -33,4 +33,6 @@ export { Keyring, generateKeypair, signMessage, verifyMessage } from "./core/ide
 // Observability seams (avcshub wires these to OTel / a real collector)
 export { Logger, consoleLogger, silentLogger } from "./observe/logger.js";
 export { Metrics } from "./observe/metrics.js";
+// Programmatic git-history import (issue #63) — also at `@izagood/avcs/importer`.
+export { importGitHistory, gitCliSource, } from "./importer/gitHistory.js";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,EAAE;AACF,mFAAmF;AACnF,yFAAyF;AACzF,wFAAwF;AACxF,iFAAiF;AAEjF,+BAA+B;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAGrC,mFAAmF;AACnF,uFAAuF;AACvF,sFAAsF;AACtF,wFAAwF;AACxF,6EAA6E;AAC7E,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAE1E,uEAAuE;AACvE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAG7H,iFAAiF;AACjF,qFAAqF;AACrF,yDAAyD;AACzD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEtF,6BAA6B;AAC7B,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGzE,kFAAkF;AAClF,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE3E,iFAAiF;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,yFAAyF;AACzF,4FAA4F;AAC5F,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGzJ,8DAA8D;AAC9D,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAG1F,uEAAuE;AACvE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE1E,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;AACtF,EAAE;AACF,mFAAmF;AACnF,yFAAyF;AACzF,wFAAwF;AACxF,iFAAiF;AAEjF,+BAA+B;AAC/B,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAGrC,mFAAmF;AACnF,uFAAuF;AACvF,sFAAsF;AACtF,wFAAwF;AACxF,6EAA6E;AAC7E,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAE1E,uEAAuE;AACvE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAG7H,iFAAiF;AACjF,qFAAqF;AACrF,yDAAyD;AACzD,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAEtF,6BAA6B;AAC7B,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAGzE,kFAAkF;AAClF,OAAO,EAAE,QAAQ,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE3E,iFAAiF;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,yFAAyF;AACzF,4FAA4F;AAC5F,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,UAAU,EAAE,gBAAgB,EAAE,UAAU,EAAE,WAAW,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAGzJ,8DAA8D;AAC9D,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAG1F,uEAAuE;AACvE,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE1E,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAG/C,kFAAkF;AAClF,OAAO,EACL,gBAAgB,EAChB,YAAY,GAOb,MAAM,0BAA0B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@izagood/avcs",
-  "version": "0.27.0",
+  "version": "0.28.0",
   "type": "module",
   "description": "Agentic Version Control System — an AI-native VCS where intent, session, operation, evidence and decision are first-class objects and code is a materialized projection of an operation graph.",
   "license": "Apache-2.0",
@@ -38,6 +38,10 @@
       "types": "./dist/hub/hubClient.d.ts",
       "default": "./dist/hub/hubClient.js"
     },
+    "./importer": {
+      "types": "./dist/importer/gitHistory.d.ts",
+      "default": "./dist/importer/gitHistory.js"
+    },
     "./store": {
       "types": "./dist/store/objectStore.d.ts",
       "default": "./dist/store/objectStore.js"