@maadb/core 0.0.1 → 0.7.9

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,41 @@
+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;
+}
+//# 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;CAG1B"}

package/dist/git/index.js

@@ -0,0 +1,86 @@
+// ============================================================================
+// 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;
+    }
+}
+//# 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"}

package/dist/git/log.js

@@ -0,0 +1,116 @@
+// ============================================================================
+// Git Log Parser
+// Queries git history and parses structured MAAD commit messages.
+// ============================================================================
+import { parseCommitMessage } from './commit.js';
+import { logger } from '../engine/logger.js';
+import { docId as toDocId, docType as toDocType, commitSha as toCommitSha, } from '../types.js';
+// Git --since="2026-04-08" excludes commits from that day.
+// Appending T00:00:00 makes it inclusive of the specified date.
+function normalizeDateArg(value) {
+    if (/^\d{4}-\d{2}-\d{2}$/.test(value))
+        return `${value}T00:00:00`;
+    return value;
+}
+export async function getHistory(git, filePath, opts) {
+    const args = ['--follow', '--format=%H|%an|%aI|%s'];
+    if (opts?.limit)
+        args.push(`-n`, String(opts.limit));
+    if (opts?.since)
+        args.push(`--since=${normalizeDateArg(opts.since)}`);
+    args.push('--', filePath);
+    let logOutput;
+    try {
+        logOutput = await git.raw(['log', ...args]);
+    }
+    catch (e) {
+        logger.bestEffort('git', 'history', `Git log failed for ${filePath}: ${e instanceof Error ? e.message : String(e)}`);
+        return [];
+    }
+    if (!logOutput.trim())
+        return [];
+    const commits = [];
+    for (const line of logOutput.trim().split('\n')) {
+        const parts = line.split('|');
+        if (parts.length < 4)
+            continue;
+        const sha = parts[0];
+        const author = parts[1];
+        const timestamp = parts[2];
+        const subject = parts.slice(3).join('|'); // subject may contain |
+        const parsed = parseCommitMessage(subject);
+        if (!parsed)
+            continue; // skip non-MAAD commits
+        commits.push({
+            action: parsed.action,
+            docId: toDocId(parsed.docId),
+            docType: toDocType(parsed.docType),
+            detail: parsed.detail,
+            summary: parsed.summary,
+            sha: toCommitSha(sha),
+            author,
+            timestamp,
+        });
+    }
+    return commits;
+}
+export async function getAudit(git, opts) {
+    const args = ['--format=%H|%an|%aI|%s'];
+    if (opts?.since)
+        args.push(`--since=${normalizeDateArg(opts.since)}`);
+    if (opts?.until)
+        args.push(`--until=${normalizeDateArg(opts.until)}`);
+    let logOutput;
+    try {
+        logOutput = await git.raw(['log', ...args]);
+    }
+    catch (e) {
+        logger.bestEffort('git', 'audit', `Git log failed: ${e instanceof Error ? e.message : String(e)}`);
+        return [];
+    }
+    if (!logOutput.trim())
+        return [];
+    // Aggregate by docId
+    const byDoc = new Map();
+    for (const line of logOutput.trim().split('\n')) {
+        const parts = line.split('|');
+        if (parts.length < 4)
+            continue;
+        const author = parts[1];
+        const timestamp = parts[2];
+        const subject = parts.slice(3).join('|');
+        const parsed = parseCommitMessage(subject);
+        if (!parsed)
+            continue;
+        // Apply filters
+        if (opts?.docType && parsed.docType !== opts.docType)
+            continue;
+        if (opts?.action && parsed.action !== opts.action)
+            continue;
+        const existing = byDoc.get(parsed.docId);
+        if (existing) {
+            existing.actions++;
+            // Keep the most recent (first in git log, which is newest)
+        }
+        else {
+            byDoc.set(parsed.docId, {
+                docType: parsed.docType,
+                actions: 1,
+                lastAction: parsed.action,
+                lastSummary: parsed.summary,
+                lastAuthor: author,
+                lastTimestamp: timestamp,
+            });
+        }
+    }
+    return [...byDoc.entries()].map(([id, data]) => ({
+        docId: toDocId(id),
+        docType: toDocType(data.docType),
+        actions: data.actions,
+        lastAction: data.lastAction,
+        lastSummary: data.lastSummary,
+        lastAuthor: data.lastAuthor,
+        lastTimestamp: data.lastTimestamp,
+    }));
+}
+//# sourceMappingURL=log.js.map

package/dist/git/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/git/log.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,iBAAiB;AACjB,kEAAkE;AAClE,+EAA+E;AAG/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EACL,KAAK,IAAI,OAAO,EAChB,OAAO,IAAI,SAAS,EACpB,SAAS,IAAI,WAAW,GAKzB,MAAM,aAAa,CAAC;AAErB,2DAA2D;AAC3D,gEAAgE;AAChE,SAAS,gBAAgB,CAAC,KAAa;IACrC,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,KAAK,WAAW,CAAC;IAClE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,GAAc,EACd,QAAgB,EAChB,IAAyC;IAEzC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,wBAAwB,CAAC,CAAC;IAEpD,IAAI,IAAI,EAAE,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,IAAI,IAAI,EAAE,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,WAAW,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAEtE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAE1B,IAAI,SAAiB,CAAC;IACtB,IAAI,CAAC;QACH,SAAS,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,sBAAsB,QAAQ,KAAK,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACrH,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAEjC,MAAM,OAAO,GAAmB,EAAE,CAAC;IACnC,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAE/B,MAAM,GAAG,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACtB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACzB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,wBAAwB;QAElE,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM;YAAE,SAAS,CAAC,wBAAwB;QAE/C,OAAO,CAAC,IAAI,CAAC;YACX,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;YAC5B,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,OAAO,CAAC;YAClC,MAAM,EAAE,MAAM,CAAC,MAAM;YACrB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC;YACrB,MAAM;YACN,SAAS;SACV,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,GAAc,EACd,IAA6E;IAE7E,MAAM,IAAI,GAAG,CAAC,wBAAwB,CAAC,CAAC;IAExC,IAAI,IAAI,EAAE,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,WAAW,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACtE,IAAI,IAAI,EAAE,KAAK;QAAE,IAAI,CAAC,IAAI,CAAC,WAAW,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAEtE,IAAI,SAAiB,CAAC;IACtB,IAAI,CAAC;QACH,SAAS,GAAG,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IAC9C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,mBAAmB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACnG,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,CAAC;IAEjC,qBAAqB;IACrB,MAAM,KAAK,GAAG,IAAI,GAAG,EAOjB,CAAC;IAEL,KAAK,MAAM,IAAI,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC9B,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAE/B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QACzB,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;QAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAEzC,MAAM,MAAM,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM;YAAE,SAAS;QAEtB,gBAAgB;QAChB,IAAI,IAAI,EAAE,OAAO,IAAI,MAAM,CAAC,OAAO,KAAM,IAAI,CAAC,OAAkB;YAAE,SAAS;QAC3E,IAAI,IAAI,EAAE,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;YAAE,SAAS;QAE5D,MAAM,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzC,IAAI,QAAQ,EAAE,CAAC;YACb,QAAQ,CAAC,OAAO,EAAE,CAAC;YACnB,2DAA2D;QAC7D,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE;gBACtB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,OAAO,EAAE,CAAC;gBACV,UAAU,EAAE,MAAM,CAAC,MAAM;gBACzB,WAAW,EAAE,MAAM,CAAC,OAAO;gBAC3B,UAAU,EAAE,MAAM;gBAClB,aAAa,EAAE,SAAS;aACzB,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,EAAc,EAAE,CAAC,CAAC;QAC3D,KAAK,EAAE,OAAO,CAAC,EAAE,CAAC;QAClB,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;QAChC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,aAAa,EAAE,IAAI,CAAC,aAAa;KAClC,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/git/snapshot.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot.d.ts","sourceRoot":"","sources":["../../src/git/snapshot.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EAEL,KAAK,KAAK,EAEV,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AAErB,wBAAsB,WAAW,CAC/B,GAAG,EAAE,SAAS,EACd,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,KAAK,EACZ,EAAE,EAAE,MAAM,GACT,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAuDhC"}