@maadb/core 0.0.1 → 0.7.10-rc.3

package/dist/git/commit.d.ts

@@ -0,0 +1,63 @@
+import type { SimpleGit } from 'simple-git';
+import type { DocId, DocType, CommitSha } from '../types.js';
+interface GitCommitIdentityEnv {
+    GIT_AUTHOR_NAME: string;
+    GIT_AUTHOR_EMAIL: string;
+    GIT_COMMITTER_NAME: string;
+    GIT_COMMITTER_EMAIL: string;
+}
+export declare function resolveCommitAuthor(env?: NodeJS.ProcessEnv): GitCommitIdentityEnv;
+/**
+ * 0.7.0 — Identity snapshot for commit-message enrichment. Populated from
+ * the session's token when `MAAD_COMMIT_IDENTITY` is on (default true in
+ * 0.7.0 per dec-maadb-071 since fup-066 resolved). Set to false in the
+ * deploy env to opt out for cautious deployments.
+ */
+export interface CommitIdentity {
+    role: string;
+    tokenId?: string;
+    agentId?: string;
+    userId?: string;
+}
+export interface CommitOptions {
+    action: 'create' | 'update' | 'delete';
+    docId: DocId;
+    docType: DocType;
+    detail: string;
+    summary: string;
+    files: string[];
+    identity?: CommitIdentity;
+}
+/**
+ * 0.6.10 — Three-state commit outcome. Replaces the prior `CommitSha | null`
+ * return on autoCommit so callers can distinguish benign no-ops from real
+ * failures that left staged changes uncommitted.
+ */
+export type CommitOutcome = {
+    status: 'committed';
+    sha: CommitSha;
+} | {
+    status: 'noop';
+} | {
+    status: 'failed';
+    code: string;
+    message: string;
+};
+export declare function formatCommitMessage(opts: CommitOptions): string;
+/**
+ * 0.7.0 — Default ON in 0.7.0 per dec-maadb-071 (fup-066 resolved in 0.6.10
+ * removed the silent-commit-failure concern that gated this). Operators opt
+ * out with MAAD_COMMIT_IDENTITY=false.
+ */
+export declare function isCommitIdentityEnabled(): boolean;
+export interface ParsedCommitMessage {
+    action: string;
+    docId: string;
+    docType: string;
+    detail: string;
+    summary: string;
+}
+export declare function parseCommitMessage(message: string): ParsedCommitMessage | null;
+export declare function autoCommit(git: SimpleGit, opts: CommitOptions): Promise<CommitOutcome>;
+export {};
+//# sourceMappingURL=commit.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"commit.d.ts","sourceRoot":"","sources":["../../src/git/commit.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAmB7D,UAAU,oBAAoB;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED,wBAAgB,mBAAmB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,oBAAoB,CAa9F;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;IACvC,KAAK,EAAE,KAAK,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,GAAG,EAAE,SAAS,CAAA;CAAE,GACvC;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AAMxD,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,GAAG,MAAM,CAS/D;AAED;;;;GAIG;AACH,wBAAgB,uBAAuB,IAAI,OAAO,CAEjD;AAKD,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CAU9E;AAED,wBAAsB,UAAU,CAC9B,GAAG,EAAE,SAAS,EACd,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC,aAAa,CAAC,CA4ExB"}

package/dist/git/commit.js

@@ -0,0 +1,161 @@
+// ============================================================================
+// Git Commit Builder
+// Formats structured commit messages and auto-commits on write operations.
+//
+// CommitOutcome is a three-state discriminated union so callers can tell
+// (a) we committed and here's the sha; (b) nothing was staged so no commit
+// was needed (benign — e.g. an update that didn't actually change the file);
+// (c) git failed and the working tree may now hold staged-but-uncommitted
+// changes. Before 0.6.10 we returned `sha | null` and swallowed all errors
+// silently — bulk_create races or a mid-run lock conflict would leave the
+// engine ack'ing writes as durable while git quietly held staged state.
+// ============================================================================
+import { commitSha } from '../types.js';
+/**
+ * 0.7.3 (fup-2026-095) — Per-invocation git identity. The engine should never
+ * depend on the host user's `git config user.name/user.email` — when the host
+ * lacks identity, every autoCommit silently fails with "Author identity
+ * unknown" and the working tree drifts (observed 2026-04-23 on the brain-app
+ * droplet: 21 staged-uncommitted files, gitClean=false stuck).
+ *
+ * Set GIT_AUTHOR_* / GIT_COMMITTER_* env vars per-invocation so simple-git
+ * passes them to the spawned git process. These take precedence over
+ * `git config` and don't require touching repo state. Defaults are stable
+ * synthetic values; override per-deployment with MAAD_COMMIT_AUTHOR_NAME /
+ * MAAD_COMMIT_AUTHOR_EMAIL.
+ */
+const DEFAULT_COMMIT_AUTHOR_NAME = 'maadb-engine';
+const DEFAULT_COMMIT_AUTHOR_EMAIL = 'engine@maadb.local';
+export function resolveCommitAuthor(env = process.env) {
+    const name = env.MAAD_COMMIT_AUTHOR_NAME && env.MAAD_COMMIT_AUTHOR_NAME.length > 0
+        ? env.MAAD_COMMIT_AUTHOR_NAME
+        : DEFAULT_COMMIT_AUTHOR_NAME;
+    const email = env.MAAD_COMMIT_AUTHOR_EMAIL && env.MAAD_COMMIT_AUTHOR_EMAIL.length > 0
+        ? env.MAAD_COMMIT_AUTHOR_EMAIL
+        : DEFAULT_COMMIT_AUTHOR_EMAIL;
+    return {
+        GIT_AUTHOR_NAME: name,
+        GIT_AUTHOR_EMAIL: email,
+        GIT_COMMITTER_NAME: name,
+        GIT_COMMITTER_EMAIL: email,
+    };
+}
+// Format: maad:<action> <doc_id> [<doc_type>] <detail> — <summary>
+// With identity (0.7.0 MAAD_COMMIT_IDENTITY=true): title unchanged, body
+// appended with role/token/agent/user lines so `git log --grep` queries on
+// identity stay simple without polluting the summary line.
+export function formatCommitMessage(opts) {
+    const detail = opts.detail ? `${opts.detail} ` : '';
+    const title = `maad:${opts.action} ${opts.docId} [${opts.docType}] ${detail}— ${opts.summary}`;
+    if (!opts.identity)
+        return title;
+    const lines = [`role: ${opts.identity.role}`];
+    if (opts.identity.tokenId !== undefined)
+        lines.push(`token: ${opts.identity.tokenId}`);
+    if (opts.identity.agentId !== undefined)
+        lines.push(`agent: ${opts.identity.agentId}`);
+    if (opts.identity.userId !== undefined)
+        lines.push(`user: ${opts.identity.userId}`);
+    return `${title}\n\n${lines.join('\n')}`;
+}
+/**
+ * 0.7.0 — Default ON in 0.7.0 per dec-maadb-071 (fup-066 resolved in 0.6.10
+ * removed the silent-commit-failure concern that gated this). Operators opt
+ * out with MAAD_COMMIT_IDENTITY=false.
+ */
+export function isCommitIdentityEnabled() {
+    return process.env['MAAD_COMMIT_IDENTITY'] !== 'false';
+}
+// Parse a structured commit message back into components
+const COMMIT_PARSE_REGEX = /^maad:(\w+)\s+([\w.-]+)\s+\[(\w+)\]\s*(.*?)\s*—\s*(.+)$/;
+export function parseCommitMessage(message) {
+    const match = COMMIT_PARSE_REGEX.exec(message.split('\n')[0] ?? '');
+    if (!match)
+        return null;
+    return {
+        action: match[1],
+        docId: match[2],
+        docType: match[3],
+        detail: match[4].trim(),
+        summary: match[5].trim(),
+    };
+}
+export async function autoCommit(git, opts) {
+    try {
+        // Stage specified files
+        try {
+            await git.add(opts.files);
+        }
+        catch (e) {
+            return {
+                status: 'failed',
+                code: 'GIT_ADD_FAILED',
+                message: `git add failed: ${e instanceof Error ? e.message : String(e)}`,
+            };
+        }
+        // Check if there's anything to commit. Update paths where the file
+        // actually equals its on-disk form produce an empty staged list — this
+        // is benign (record is durable; git history matches state).
+        let status;
+        try {
+            status = await git.status();
+        }
+        catch (e) {
+            return {
+                status: 'failed',
+                code: 'GIT_STATUS_FAILED',
+                message: `git status failed: ${e instanceof Error ? e.message : String(e)}`,
+            };
+        }
+        if (status.staged.length === 0) {
+            return { status: 'noop' };
+        }
+        const message = formatCommitMessage(opts);
+        let result;
+        try {
+            // 0.7.3 (fup-2026-095) — set identity env per-call so we never depend
+            // on the host's `git config user.name/user.email`. simple-git's .env()
+            // is chainable and applies to the next spawned git process.
+            const identity = resolveCommitAuthor();
+            result = await git
+                .env('GIT_AUTHOR_NAME', identity.GIT_AUTHOR_NAME)
+                .env('GIT_AUTHOR_EMAIL', identity.GIT_AUTHOR_EMAIL)
+                .env('GIT_COMMITTER_NAME', identity.GIT_COMMITTER_NAME)
+                .env('GIT_COMMITTER_EMAIL', identity.GIT_COMMITTER_EMAIL)
+                .commit(message);
+        }
+        catch (e) {
+            // The add succeeded but the commit itself failed — worst case, since
+            // the working tree is now dirty with staged but uncommitted changes.
+            // Callers use this signal to stamp `write_durable: false` on the MCP
+            // response so clients know to retry (or reconcile out-of-band).
+            return {
+                status: 'failed',
+                code: 'GIT_COMMIT_FAILED',
+                message: `git commit failed: ${e instanceof Error ? e.message : String(e)}`,
+            };
+        }
+        if (!result.commit) {
+            // simple-git returned an empty commit field — shouldn't happen after a
+            // successful commit, but defend against it so durability tracking is
+            // truthful rather than optimistic.
+            return {
+                status: 'failed',
+                code: 'GIT_COMMIT_EMPTY',
+                message: 'git commit returned no commit sha',
+            };
+        }
+        return { status: 'committed', sha: commitSha(result.commit) };
+    }
+    catch (e) {
+        // Defense-in-depth: anything that escapes the inner try/catches above
+        // lands here so we never return undefined. Should be unreachable in
+        // practice.
+        return {
+            status: 'failed',
+            code: 'GIT_UNKNOWN_ERROR',
+            message: e instanceof Error ? e.message : String(e),
+        };
+    }
+}
+//# sourceMappingURL=commit.js.map

package/dist/git/commit.js.map

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

package/dist/git/diff.d.ts

@@ -0,0 +1,4 @@
+import type { SimpleGit } from 'simple-git';
+import { type DocId, type DiffResult } from '../types.js';
+export declare function getDiff(git: SimpleGit, filePath: string, docId: DocId, from: string, to?: string): Promise<DiffResult | null>;
+//# sourceMappingURL=diff.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../../src/git/diff.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAEL,KAAK,KAAK,EAEV,KAAK,UAAU,EAChB,MAAM,aAAa,CAAC;AAErB,wBAAsB,OAAO,CAC3B,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,MAAM,EACZ,EAAE,CAAC,EAAE,MAAM,GACV,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA2C5B"}

package/dist/git/diff.js

@@ -0,0 +1,56 @@
+// ============================================================================
+// Git Diff Parser
+// Compares two versions of a document and returns structured changes.
+// ============================================================================
+import { parseMatter } from '../parser/matter.js';
+import { commitSha as toCommitSha, } from '../types.js';
+export async function getDiff(git, filePath, docId, from, to) {
+    const toRef = to ?? 'HEAD';
+    // Get old and new file contents
+    let oldContent;
+    let newContent;
+    try {
+        oldContent = await git.show(`${from}:${filePath}`);
+        newContent = await git.show(`${toRef}:${filePath}`);
+    }
+    catch {
+        return null;
+    }
+    // Parse frontmatter from both versions
+    const oldFm = parseFm(oldContent);
+    const newFm = parseFm(newContent);
+    // Diff frontmatter field by field
+    const frontmatterChanges = {};
+    const allKeys = new Set([...Object.keys(oldFm), ...Object.keys(newFm)]);
+    for (const key of allKeys) {
+        const oldVal = oldFm[key];
+        const newVal = newFm[key];
+        if (JSON.stringify(oldVal) !== JSON.stringify(newVal)) {
+            frontmatterChanges[key] = { from: oldVal ?? null, to: newVal ?? null };
+        }
+    }
+    // Get unified diff for the body
+    let bodyDiff = '';
+    try {
+        bodyDiff = await git.diff([`${from}..${toRef}`, '--', filePath]);
+    }
+    catch {
+        bodyDiff = '';
+    }
+    return {
+        docId,
+        from: toCommitSha(from),
+        to: toCommitSha(toRef),
+        frontmatterChanges,
+        bodyDiff,
+    };
+}
+function parseFm(content) {
+    try {
+        return parseMatter(content).data;
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=diff.js.map

package/dist/git/diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.js","sourceRoot":"","sources":["../../src/git/diff.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,kBAAkB;AAClB,sEAAsE;AACtE,+EAA+E;AAG/E,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EACL,SAAS,IAAI,WAAW,GAIzB,MAAM,aAAa,CAAC;AAErB,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAc,EACd,QAAgB,EAChB,KAAY,EACZ,IAAY,EACZ,EAAW;IAEX,MAAM,KAAK,GAAG,EAAE,IAAI,MAAM,CAAC;IAE3B,gCAAgC;IAChC,IAAI,UAAkB,CAAC;IACvB,IAAI,UAAkB,CAAC;IACvB,IAAI,CAAC;QACH,UAAU,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,IAAI,IAAI,QAAQ,EAAE,CAAC,CAAC;QACnD,UAAU,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,QAAQ,EAAE,CAAC,CAAC;IACtD,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uCAAuC;IACvC,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAElC,kCAAkC;IAClC,MAAM,kBAAkB,GAAmD,EAAE,CAAC;IAC9E,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACxE,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;QAC1B,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YACtD,kBAAkB,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,IAAI,IAAI,EAAE,EAAE,EAAE,MAAM,IAAI,IAAI,EAAE,CAAC;QACzE,CAAC;IACH,CAAC;IAED,gCAAgC;IAChC,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,KAAK,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,QAAQ,GAAG,EAAE,CAAC;IAChB,CAAC;IAED,OAAO;QACL,KAAK;QACL,IAAI,EAAE,WAAW,CAAC,IAAI,CAAC;QACvB,EAAE,EAAE,WAAW,CAAC,KAAK,CAAC;QACtB,kBAAkB;QAClB,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,OAAe;IAC9B,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC,IAA+B,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/git/index.d.ts

@@ -0,0 +1,63 @@
+import { type SimpleGit } from 'simple-git';
+import type { DocId, DocType, ParsedCommit, AuditEntry, DiffResult, SnapshotResult } from '../types.js';
+import { type CommitOptions, type CommitOutcome } from './commit.js';
+export { formatCommitMessage, parseCommitMessage } from './commit.js';
+export type { CommitOptions, CommitOutcome } from './commit.js';
+export declare class GitLayer {
+    private git;
+    private projectRoot;
+    constructor(projectRoot: string);
+    isRepo(): Promise<boolean>;
+    /**
+     * Detect and recover from a stale .git/index.lock left by a prior crashed
+     * process. Returns a recovery action string if the lock was removed, or
+     * throws if the lock is recent (likely live) and should block startup.
+     *
+     * Threshold: 30 seconds. A lock younger than that is treated as a concurrent
+     * process signal and not touched.
+     */
+    recoverStaleIndexLock(): {
+        action: 'none' | 'removed';
+    } | {
+        action: 'conflict';
+        mtime: Date;
+    };
+    initRepo(): Promise<void>;
+    commit(opts: CommitOptions): Promise<CommitOutcome>;
+    history(filePath: string, opts?: {
+        limit?: number;
+        since?: string;
+    }): Promise<ParsedCommit[]>;
+    audit(opts?: {
+        since?: string;
+        until?: string;
+        docType?: DocType;
+        action?: string;
+    }): Promise<AuditEntry[]>;
+    diff(filePath: string, docId: DocId, from: string, to?: string): Promise<DiffResult | null>;
+    snapshot(filePath: string, docId: DocId, at: string): Promise<SnapshotResult | null>;
+    getSimpleGit(): SimpleGit;
+    addAnnotatedTag(name: string, message: string): Promise<void>;
+    /**
+     * List annotated tags whose name starts with the given prefix. Uses
+     * for-each-ref so name + commit sha + tagger date + subject all come back
+     * in one git call. Returns [] when no tags match.
+     *
+     * For annotated tags, `%(*objectname)` is the underlying commit sha.
+     * For lightweight tags, that field is empty — we surface the empty sha
+     * verbatim rather than fall back to the tag object's own sha, since
+     * lightweight tags shouldn't appear under our prefix in practice.
+     */
+    listTagsByPrefix(prefix: string): Promise<Array<{
+        tag: string;
+        sha: string;
+        message: string;
+        createdAt: string;
+    }>>;
+    deleteTag(name: string): Promise<void>;
+    /** Returns the HEAD commit sha, or null if the repo has no commits yet. */
+    headSha(): Promise<string | null>;
+    /** Returns the short branch name (e.g. "main") or "HEAD" when detached. */
+    currentBranch(): Promise<string>;
+}
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/git/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAa,KAAK,SAAS,EAAE,MAAM,YAAY,CAAC;AAIvD,OAAO,KAAK,EACV,KAAK,EACL,OAAO,EAEP,YAAY,EACZ,UAAU,EACV,UAAU,EACV,cAAc,EACf,MAAM,aAAa,CAAC;AACrB,OAAO,EAAmC,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AAKtG,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhE,qBAAa,QAAQ;IACnB,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM;IAKzB,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAMhC;;;;;;;OAOG;IACH,qBAAqB,IAAI;QAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG;QAAE,MAAM,EAAE,UAAU,CAAC;QAAC,KAAK,EAAE,IAAI,CAAA;KAAE;IAgBvF,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBzB,MAAM,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IAInD,OAAO,CACX,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GACxC,OAAO,CAAC,YAAY,EAAE,CAAC;IAIpB,KAAK,CAAC,IAAI,CAAC,EAAE;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAInB,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,EACZ,IAAI,EAAE,MAAM,EACZ,EAAE,CAAC,EAAE,MAAM,GACV,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IAIvB,QAAQ,CACZ,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,EACZ,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAIjC,YAAY,IAAI,SAAS;IAMnB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgBnE;;;;;;;;;OASG;IACG,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAgBlH,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,2EAA2E;IACrE,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IASvC,2EAA2E;IACrE,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;CAQvC"}

package/dist/git/index.js

@@ -0,0 +1,151 @@
+// ============================================================================
+// Git Layer — Public API
+// Thin integration layer wrapping simple-git for MAAD operations.
+// ============================================================================
+import { simpleGit } from 'simple-git';
+import { existsSync, writeFileSync, statSync, unlinkSync } from 'node:fs';
+import path from 'node:path';
+import { autoCommit, resolveCommitAuthor } from './commit.js';
+import { getHistory, getAudit } from './log.js';
+import { getDiff } from './diff.js';
+import { getSnapshot } from './snapshot.js';
+export { formatCommitMessage, parseCommitMessage } from './commit.js';
+export class GitLayer {
+    git;
+    projectRoot;
+    constructor(projectRoot) {
+        this.projectRoot = projectRoot;
+        this.git = simpleGit(projectRoot);
+    }
+    async isRepo() {
+        // Check if .git exists at the project root specifically — not a parent repo
+        const gitDir = path.join(this.projectRoot, '.git');
+        return existsSync(gitDir);
+    }
+    /**
+     * Detect and recover from a stale .git/index.lock left by a prior crashed
+     * process. Returns a recovery action string if the lock was removed, or
+     * throws if the lock is recent (likely live) and should block startup.
+     *
+     * Threshold: 30 seconds. A lock younger than that is treated as a concurrent
+     * process signal and not touched.
+     */
+    recoverStaleIndexLock() {
+        const lockPath = path.join(this.projectRoot, '.git', 'index.lock');
+        if (!existsSync(lockPath))
+            return { action: 'none' };
+        const stat = statSync(lockPath);
+        const ageMs = Date.now() - stat.mtimeMs;
+        const STALE_MS = 30_000;
+        if (ageMs < STALE_MS) {
+            return { action: 'conflict', mtime: stat.mtime };
+        }
+        unlinkSync(lockPath);
+        return { action: 'removed' };
+    }
+    async initRepo() {
+        if (await this.isRepo())
+            return;
+        await this.git.init();
+        // Create .gitignore if it doesn't exist
+        const gitignorePath = path.join(this.projectRoot, '.gitignore');
+        if (!existsSync(gitignorePath)) {
+            writeFileSync(gitignorePath, '_backend/\n', 'utf-8');
+        }
+        // Initial commit. Identity env per fup-2026-095 — same fragility as
+        // autoCommit: a host without `git config user.name/email` would otherwise
+        // fail this initial commit too.
+        await this.git.add('.gitignore');
+        const identity = resolveCommitAuthor();
+        await this.git
+            .env('GIT_AUTHOR_NAME', identity.GIT_AUTHOR_NAME)
+            .env('GIT_AUTHOR_EMAIL', identity.GIT_AUTHOR_EMAIL)
+            .env('GIT_COMMITTER_NAME', identity.GIT_COMMITTER_NAME)
+            .env('GIT_COMMITTER_EMAIL', identity.GIT_COMMITTER_EMAIL)
+            .commit('maad:init — Initialize MAAD project');
+    }
+    async commit(opts) {
+        return autoCommit(this.git, opts);
+    }
+    async history(filePath, opts) {
+        return getHistory(this.git, filePath, opts);
+    }
+    async audit(opts) {
+        return getAudit(this.git, opts);
+    }
+    async diff(filePath, docId, from, to) {
+        return getDiff(this.git, filePath, docId, from, to);
+    }
+    async snapshot(filePath, docId, at) {
+        return getSnapshot(this.git, filePath, docId, at);
+    }
+    getSimpleGit() {
+        return this.git;
+    }
+    // ---- 0.7.10 — tag operations for maad_backup ---------------------------
+    async addAnnotatedTag(name, message) {
+        // Inject the committer identity env per-call — annotated tags need a
+        // tagger identity and we can't depend on the host having `git config
+        // user.name/user.email` set. Same pattern as autoCommit + initRepo
+        // (0.7.3 fup-2026-095). Without this the call fails on bare CI runners
+        // and any other host without global git config — masked locally on any
+        // dev machine that does have it set.
+        const identity = resolveCommitAuthor();
+        await this.git
+            .env('GIT_AUTHOR_NAME', identity.GIT_AUTHOR_NAME)
+            .env('GIT_AUTHOR_EMAIL', identity.GIT_AUTHOR_EMAIL)
+            .env('GIT_COMMITTER_NAME', identity.GIT_COMMITTER_NAME)
+            .env('GIT_COMMITTER_EMAIL', identity.GIT_COMMITTER_EMAIL)
+            .addAnnotatedTag(name, message);
+    }
+    /**
+     * List annotated tags whose name starts with the given prefix. Uses
+     * for-each-ref so name + commit sha + tagger date + subject all come back
+     * in one git call. Returns [] when no tags match.
+     *
+     * For annotated tags, `%(*objectname)` is the underlying commit sha.
+     * For lightweight tags, that field is empty — we surface the empty sha
+     * verbatim rather than fall back to the tag object's own sha, since
+     * lightweight tags shouldn't appear under our prefix in practice.
+     */
+    async listTagsByPrefix(prefix) {
+        const sep = '\x1f'; // ASCII unit separator — safe vs '|' in messages.
+        const format = `%(refname:short)${sep}%(*objectname)${sep}%(taggerdate:iso-strict)${sep}%(contents:subject)`;
+        const raw = await this.git.raw(['for-each-ref', `--format=${format}`, `refs/tags/${prefix}*`]);
+        if (!raw.trim())
+            return [];
+        return raw.trim().split('\n').map(line => {
+            const parts = line.split(sep);
+            return {
+                tag: parts[0] ?? '',
+                sha: parts[1] ?? '',
+                createdAt: parts[2] ?? '',
+                message: parts[3] ?? '',
+            };
+        });
+    }
+    async deleteTag(name) {
+        await this.git.tag(['-d', name]);
+    }
+    /** Returns the HEAD commit sha, or null if the repo has no commits yet. */
+    async headSha() {
+        try {
+            const out = await this.git.revparse(['HEAD']);
+            return out.trim() || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Returns the short branch name (e.g. "main") or "HEAD" when detached. */
+    async currentBranch() {
+        try {
+            const out = await this.git.revparse(['--abbrev-ref', 'HEAD']);
+            return out.trim() || 'HEAD';
+        }
+        catch {
+            return 'HEAD';
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/git/index.js.map

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

package/dist/git/log.d.ts

@@ -0,0 +1,13 @@
+import type { SimpleGit } from 'simple-git';
+import { type DocType, type ParsedCommit, type AuditEntry } from '../types.js';
+export declare function getHistory(git: SimpleGit, filePath: string, opts?: {
+    limit?: number;
+    since?: string;
+}): Promise<ParsedCommit[]>;
+export declare function getAudit(git: SimpleGit, opts?: {
+    since?: string;
+    until?: string;
+    docType?: DocType;
+    action?: string;
+}): Promise<AuditEntry[]>;
+//# sourceMappingURL=log.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/git/log.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAG5C,OAAO,EAKL,KAAK,OAAO,EACZ,KAAK,YAAY,EACjB,KAAK,UAAU,EAChB,MAAM,aAAa,CAAC;AASrB,wBAAsB,UAAU,CAC9B,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,MAAM,EAChB,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,GACxC,OAAO,CAAC,YAAY,EAAE,CAAC,CA4CzB;AAED,wBAAsB,QAAQ,CAC5B,GAAG,EAAE,SAAS,EACd,IAAI,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5E,OAAO,CAAC,UAAU,EAAE,CAAC,CAkEvB"}