@maind-dev/cli 0.3.0 → 0.4.0

package/build/git-context.js

@@ -0,0 +1,212 @@
+// `maind git-context` — a session-start briefing of the LOCAL git state, enriched
+// with maind's parallel-session coordination (ADR-188) and state-relevant git
+// lessons (ADR-212 v2 / B1). Run it before an agent starts work so it begins
+// informed ("you're on feat/x, 3 ahead, CI red, a peer is editing src/auth.ts")
+// instead of blind.
+//
+// Fail-open + fail-soft: local git state always renders; the MCP enrichment
+// (peer conflicts, lessons) is best-effort and each piece degrades independently.
+// No git remote, no API key, no network, no `gh` → you still get what's available.
+// The remote URL never leaves the machine — only the project_key (sha256) does.
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { resolveAuth } from "./auth.js";
+import { McpClient } from "./mcp-client.js";
+import { gatherGitState, gatherOpenPrs } from "./git.js";
+export function parseGitContextArgs(argv) {
+    const get = (name) => {
+        const i = argv.indexOf(name);
+        if (i === -1 || i + 1 >= argv.length)
+            return undefined;
+        return argv[i + 1];
+    };
+    return {
+        out: get("--out") ?? ".maind/git-context.md",
+        manifest: get("--manifest") ?? null,
+        mcpUrl: get("--mcp-url") ?? null,
+        noMcp: argv.includes("--no-mcp"),
+        clientVersion: "0.4.0",
+    };
+}
+function nowIso() {
+    return new Date().toISOString();
+}
+function writeArtifact(path, content) {
+    const dir = dirname(path);
+    if (dir && dir !== ".")
+        mkdirSync(dir, { recursive: true });
+    writeFileSync(path, content, "utf8");
+}
+/** A state-aware query so the pulled lessons match the current situation. */
+function stateQuery(git, prs) {
+    if (prs.some((p) => p.isCurrentBranch && p.ci === "failure"))
+        return "ci failure red build fix";
+    if ((git.behind ?? 0) > 0 && (git.ahead ?? 0) > 0)
+        return "rebase merge integration diverged branch";
+    if ((git.behind ?? 0) > 0)
+        return "branch behind main pull rebase update";
+    if (prs.some((p) => p.isCurrentBranch))
+        return "pull request review merge workflow";
+    if ((git.ahead ?? 0) > 0)
+        return "open pull request commit message branch";
+    return "git branch commit pull request workflow";
+}
+export async function runGitContext(opts) {
+    const git = gatherGitState();
+    // gh is optional; only probe when we're in a repo.
+    const prResult = git.isRepo ? gatherOpenPrs(git.branch) : { available: false, prs: [] };
+    let peer = null;
+    let lessons = [];
+    let lessonsAvailable = false;
+    if (!opts.noMcp && git.isRepo) {
+        try {
+            const auth = resolveAuth();
+            const client = new McpClient({
+                apiKey: auth.apiKey,
+                deviceId: auth.deviceId,
+                clientVersion: opts.clientVersion,
+                mcpUrl: opts.mcpUrl ?? undefined,
+            });
+            // Peer/conflict check — READ-ONLY (no announce → no phantom session).
+            if (git.projectKey && git.workingPaths.length > 0) {
+                try {
+                    const c = await client.callTool("check_path_conflicts", {
+                        project_key: git.projectKey,
+                        paths: git.workingPaths,
+                    });
+                    peer = {
+                        peersActive: c.peers_active ?? 0,
+                        conflicts: (c.conflicts ?? [])
+                            .filter((x) => x.path)
+                            .map((x) => ({ path: x.path, focus: x.focus })),
+                        recommendation: c.recommendation ?? null,
+                        checked: true,
+                    };
+                }
+                catch (err) {
+                    warn(`peer check unavailable: ${msg(err)}`);
+                }
+            }
+            // State-relevant git lessons.
+            try {
+                const res = await client.callTool("search_lessons", {
+                    query: stateQuery(git, prResult.prs),
+                    platforms: ["git", "github"],
+                    limit: 3,
+                });
+                lessons = Array.isArray(res.lessons) ? res.lessons : [];
+                lessonsAvailable = true;
+            }
+            catch (err) {
+                warn(`git lessons unavailable: ${msg(err)}`);
+            }
+        }
+        catch (err) {
+            // No API key / auth failure → local-only briefing, still useful.
+            warn(`maind enrichment skipped (${msg(err)}); rendering local git state only.`);
+        }
+    }
+    writeArtifact(opts.out, renderMarkdown(git, prResult, peer, lessons, lessonsAvailable));
+    if (opts.manifest) {
+        writeArtifact(opts.manifest, JSON.stringify(buildManifest(git, prResult.prs, peer), null, 2) + "\n");
+    }
+    process.stderr.write(`maind git-context: ${git.isRepo ? `${git.branch ?? "?"} (+${git.ahead ?? "?"}/-${git.behind ?? "?"})` : "not a git repo"}` +
+        (peer?.conflicts.length ? `, ${peer.conflicts.length} peer conflict(s)` : "") +
+        ` → ${opts.out}\n`);
+    return 0;
+}
+function ciIcon(ci) {
+    return ci === "success" ? "🟢" : ci === "failure" ? "🔴" : ci === "pending" ? "🟡" : "⚪";
+}
+function renderMarkdown(git, prResult, peer, lessons, lessonsAvailable) {
+    const L = [];
+    L.push("<!-- Generated by `maind git-context` — local git state for the agent. -->");
+    L.push(`<!-- generated_at: ${nowIso()} -->`);
+    L.push("");
+    L.push("# maind git-context");
+    L.push("");
+    if (!git.isRepo) {
+        L.push("_Not inside a git work tree — no git context to report._");
+        L.push("");
+        return L.join("\n");
+    }
+    const aheadBehind = git.defaultBranch != null
+        ? `${git.ahead ?? "?"} ahead, ${git.behind ?? "?"} behind \`${git.defaultBranch}\``
+        : "no upstream default branch resolved";
+    L.push(`**Branch:** \`${git.branch ?? "?"}\` — ${aheadBehind}`);
+    L.push(`**Working tree:** ${git.uncommitted} uncommitted change${git.uncommitted === 1 ? "" : "s"}`);
+    if (git.projectKey)
+        L.push(`**Project:** \`${git.projectKey.slice(0, 12)}…\` (sha256 of remote — URL never sent)`);
+    L.push("");
+    // Open PRs
+    if (prResult.available) {
+        if (prResult.prs.length === 0) {
+            L.push("**Open PRs:** none");
+        }
+        else {
+            L.push("**Open PRs:**");
+            for (const p of prResult.prs) {
+                const tag = p.isCurrentBranch ? ` ${ciIcon(p.ci)} CI:${p.ci} · this branch` : "";
+                L.push(`- #${p.number} ${p.title}${tag}`);
+            }
+        }
+    }
+    else {
+        L.push("**Open PRs:** _unavailable (`gh` not installed / not authenticated)_");
+    }
+    L.push("");
+    // Peers (ADR-188 coordination)
+    if (peer?.checked) {
+        if (peer.conflicts.length > 0) {
+            L.push(`**⚠ Parallel sessions on this repo:** ${peer.peersActive} active — path conflicts:`);
+            for (const c of peer.conflicts) {
+                L.push(`- \`${c.path}\`${c.focus ? ` — peer focus: ${c.focus}` : ""}`);
+            }
+            if (peer.recommendation)
+                L.push(`- _${peer.recommendation}_`);
+        }
+        else if (peer.peersActive > 0) {
+            L.push(`**Parallel sessions on this repo:** ${peer.peersActive} active — no conflict on your changed paths.`);
+        }
+        else {
+            L.push("**Parallel sessions on this repo:** none.");
+        }
+    }
+    else {
+        L.push("**Parallel sessions:** _not checked (no key / no changed paths / offline)._");
+    }
+    L.push("");
+    // Lessons
+    if (lessonsAvailable && lessons.length > 0) {
+        L.push("## Relevant git lessons (maind)");
+        for (const l of lessons) {
+            L.push(`- **${l.title ?? l.id}**${l.id ? ` \`${l.id}\`` : ""}`);
+        }
+        L.push("");
+    }
+    L.push("_Full PR workflow: `activate_skill({id:\"skill_pr_lifecycle\"})`._");
+    L.push("");
+    return L.join("\n");
+}
+function buildManifest(git, prs, peer) {
+    return {
+        schema: "maind.git-context/v1",
+        generated_at: nowIso(),
+        project_key: git.projectKey,
+        branch: git.branch,
+        default_branch: git.defaultBranch,
+        ahead: git.ahead,
+        behind: git.behind,
+        uncommitted: git.uncommitted,
+        open_prs: prs.map((p) => ({ number: p.number, ci: p.ci, current_branch: p.isCurrentBranch })),
+        peers_active: peer?.checked ? peer.peersActive : null,
+        path_conflicts: peer?.conflicts.map((c) => c.path) ?? [],
+    };
+}
+function msg(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function warn(line) {
+    process.stderr.write(`maind git-context: ${line}\n`);
+}
+//# sourceMappingURL=git-context.js.map

package/build/git-context.js.map

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

package/build/git.js

@@ -0,0 +1,162 @@
+// Local git/gh state gathering for `maind git-context` (ADR-212 v2 / B1).
+//
+// All gathering is CLIENT-SIDE — the maind server is repo-blind by design
+// (ADR-188 privacy): only the project_key (sha256 of the normalized remote) and
+// repo-relative paths ever leave this machine; the remote URL never does.
+//
+// Every probe is fail-soft: a missing git, no remote, or absent `gh` degrades to
+// null/empty, never throws. The command around this is fail-open.
+import { execFileSync } from "node:child_process";
+import { createHash } from "node:crypto";
+function run(bin, args) {
+    try {
+        return execFileSync(bin, args, {
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: 5000,
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+const git = (args) => run("git", args);
+const gh = (args) => run("gh", args);
+// ── project_key contract (replicated from apps/vscode-extension/src/harness/
+// projectKey.ts — ADR-188). MUST normalize identically or sessions won't match
+// across clients. Keep in sync; extract to a shared package when a third client
+// needs it. ────────────────────────────────────────────────────────────────────
+export function sha256Hex(input) {
+    return createHash("sha256").update(input).digest("hex");
+}
+export function normalizeRemoteUrl(raw) {
+    let s = raw.trim();
+    if (!s)
+        return null;
+    const scheme = /^[a-z][a-z0-9+.-]*:\/\//i.exec(s);
+    if (scheme) {
+        s = s.slice(scheme[0].length);
+        s = s.replace(/^[^@/]+@/, "");
+        s = s.replace(/^([^/:]+):\d+(?=\/)/, "$1");
+    }
+    else {
+        s = s.replace(/^[^@/]+@/, "");
+        const i = s.indexOf(":");
+        if (i >= 0)
+            s = `${s.slice(0, i)}/${s.slice(i + 1)}`;
+    }
+    s = s
+        .replace(/\.git$/i, "")
+        .replace(/\/+$/, "")
+        .toLowerCase();
+    return s.length > 0 ? s : null;
+}
+export function projectKeyFromRemote(raw) {
+    const norm = normalizeRemoteUrl(raw);
+    return norm ? sha256Hex(norm) : null;
+}
+function resolveDefaultBranch() {
+    // origin/HEAD → refs/remotes/origin/main (when set), else probe common names.
+    const sym = git(["symbolic-ref", "--quiet", "refs/remotes/origin/HEAD"]);
+    if (sym) {
+        const m = /refs\/remotes\/origin\/(.+)$/.exec(sym);
+        if (m)
+            return m[1];
+    }
+    for (const cand of ["main", "master"]) {
+        if (git(["rev-parse", "--verify", "--quiet", `origin/${cand}`]) !== null)
+            return cand;
+    }
+    return null;
+}
+export function gatherGitState() {
+    const inside = git(["rev-parse", "--is-inside-work-tree"]);
+    if (inside !== "true") {
+        return {
+            isRepo: false,
+            projectKey: null,
+            branch: null,
+            defaultBranch: null,
+            ahead: null,
+            behind: null,
+            uncommitted: 0,
+            workingPaths: [],
+        };
+    }
+    const remote = git(["config", "--get", "remote.origin.url"]);
+    const projectKey = remote ? projectKeyFromRemote(remote) : null;
+    const branch = git(["rev-parse", "--abbrev-ref", "HEAD"]);
+    const defaultBranch = resolveDefaultBranch();
+    let ahead = null;
+    let behind = null;
+    if (defaultBranch) {
+        // `--left-right --count A...B` → "<left> <right>": left = in A not B (behind),
+        // right = in B not A (ahead). Here A=origin/default, B=HEAD.
+        const counts = git(["rev-list", "--left-right", "--count", `origin/${defaultBranch}...HEAD`]);
+        if (counts) {
+            const [b, a] = counts.split(/\s+/).map((n) => Number.parseInt(n, 10));
+            if (Number.isFinite(b))
+                behind = b;
+            if (Number.isFinite(a))
+                ahead = a;
+        }
+    }
+    const porcelain = git(["status", "--porcelain"]) ?? "";
+    const changedLines = porcelain.split("\n").filter((l) => l.trim().length > 0);
+    const workingPaths = changedLines
+        .map((l) => l.slice(3).split(" -> ").pop().trim().replace(/^"|"$/g, ""))
+        .filter((p) => p.length > 0)
+        .slice(0, 32);
+    return {
+        isRepo: true,
+        projectKey,
+        branch,
+        defaultBranch,
+        ahead,
+        behind,
+        uncommitted: changedLines.length,
+        workingPaths,
+    };
+}
+function ciFromChecks(prNumber) {
+    const out = gh(["pr", "checks", String(prNumber), "--json", "bucket"]);
+    if (!out)
+        return "unknown";
+    try {
+        const rows = JSON.parse(out);
+        if (rows.length === 0)
+            return "unknown";
+        if (rows.some((r) => r.bucket === "fail"))
+            return "failure";
+        if (rows.some((r) => r.bucket === "pending"))
+            return "pending";
+        if (rows.every((r) => r.bucket === "pass" || r.bucket === "skipping"))
+            return "success";
+        return "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
+export function gatherOpenPrs(currentBranch, max = 5) {
+    const out = gh(["pr", "list", "--state", "open", "--limit", String(max), "--json", "number,title,headRefName"]);
+    if (out === null)
+        return { available: false, prs: [] };
+    try {
+        const rows = JSON.parse(out);
+        const prs = rows.map((r) => ({
+            number: r.number,
+            title: r.title,
+            isCurrentBranch: currentBranch != null && r.headRefName === currentBranch,
+            // Only resolve CI for the current branch's PR (cheap) — others stay unknown to avoid N gh calls.
+            ci: currentBranch != null && r.headRefName === currentBranch
+                ? ciFromChecks(r.number)
+                : "unknown",
+        }));
+        return { available: true, prs };
+    }
+    catch {
+        return { available: false, prs: [] };
+    }
+}
+//# sourceMappingURL=git.js.map

package/build/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../src/git.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,EAAE;AACF,0EAA0E;AAC1E,gFAAgF;AAChF,0EAA0E;AAC1E,EAAE;AACF,iFAAiF;AACjF,kEAAkE;AAElE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,SAAS,GAAG,CAAC,GAAW,EAAE,IAAc;IACtC,IAAI,CAAC;QACH,OAAO,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE;YAC7B,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;YACnC,OAAO,EAAE,IAAI;SACd,CAAC,CAAC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,GAAG,GAAG,CAAC,IAAc,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;AACjD,MAAM,EAAE,GAAG,CAAC,IAAc,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;AAE/C,8EAA8E;AAC9E,+EAA+E;AAC/E,gFAAgF;AAChF,iFAAiF;AACjF,MAAM,UAAU,SAAS,CAAC,KAAa;IACrC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,IAAI,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IACnB,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,MAAM,GAAG,0BAA0B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClD,IAAI,MAAM,EAAE,CAAC;QACX,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC9B,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC9B,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;SAAM,CAAC;QACN,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;QAC9B,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC;YAAE,CAAC,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;IACvD,CAAC;IACD,CAAC,GAAG,CAAC;SACF,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;SACtB,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;SACnB,WAAW,EAAE,CAAC;IACjB,OAAO,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,GAAW;IAC9C,MAAM,IAAI,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACvC,CAAC;AAeD,SAAS,oBAAoB;IAC3B,8EAA8E;IAC9E,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,cAAc,EAAE,SAAS,EAAE,0BAA0B,CAAC,CAAC,CAAC;IACzE,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,CAAC,GAAG,8BAA8B,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnD,IAAI,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;QACtC,IAAI,GAAG,CAAC,CAAC,WAAW,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;IACxF,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,uBAAuB,CAAC,CAAC,CAAC;IAC3D,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QACtB,OAAO;YACL,MAAM,EAAE,KAAK;YACb,UAAU,EAAE,IAAI;YAChB,MAAM,EAAE,IAAI;YACZ,aAAa,EAAE,IAAI;YACnB,KAAK,EAAE,IAAI;YACX,MAAM,EAAE,IAAI;YACZ,WAAW,EAAE,CAAC;YACd,YAAY,EAAE,EAAE;SACjB,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,OAAO,EAAE,mBAAmB,CAAC,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,MAAM,CAAC,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChE,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;IAC1D,MAAM,aAAa,GAAG,oBAAoB,EAAE,CAAC;IAE7C,IAAI,KAAK,GAAkB,IAAI,CAAC;IAChC,IAAI,MAAM,GAAkB,IAAI,CAAC;IACjC,IAAI,aAAa,EAAE,CAAC;QAClB,+EAA+E;QAC/E,6DAA6D;QAC7D,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,UAAU,aAAa,SAAS,CAAC,CAAC,CAAC;QAC9F,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;YACtE,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAAE,MAAM,GAAG,CAAC,CAAC;YACnC,IAAI,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAAE,KAAK,GAAG,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,CAAC,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,MAAM,YAAY,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9E,MAAM,YAAY,GAAG,YAAY;SAC9B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAG,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;SACxE,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;SAC3B,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAEhB,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,UAAU;QACV,MAAM;QACN,aAAa;QACb,KAAK;QACL,MAAM;QACN,WAAW,EAAE,YAAY,CAAC,MAAM;QAChC,YAAY;KACb,CAAC;AACJ,CAAC;AAiBD,SAAS,YAAY,CAAC,QAAgB;IACpC,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC;IACvE,IAAI,CAAC,GAAG;QAAE,OAAO,SAAS,CAAC;IAC3B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA+B,CAAC;QAC3D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,SAAS,CAAC;QACxC,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC;YAAE,OAAO,SAAS,CAAC;QAC5D,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC;YAAE,OAAO,SAAS,CAAC;QAC/D,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC;YAAE,OAAO,SAAS,CAAC;QACxF,OAAO,SAAS,CAAC;IACnB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,aAA4B,EAAE,GAAG,GAAG,CAAC;IACjE,MAAM,GAAG,GAAG,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,0BAA0B,CAAC,CAAC,CAAC;IAChH,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;IACvD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkE,CAAC;QAC9F,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC3B,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,eAAe,EAAE,aAAa,IAAI,IAAI,IAAI,CAAC,CAAC,WAAW,KAAK,aAAa;YACzE,iGAAiG;YACjG,EAAE,EACA,aAAa,IAAI,IAAI,IAAI,CAAC,CAAC,WAAW,KAAK,aAAa;gBACtD,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;gBACxB,CAAC,CAAE,SAAsB;SAC9B,CAAC,CAAC,CAAC;QACJ,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC;IACvC,CAAC;AACH,CAAC"}

package/build/index.js

@@ -12,16 +12,24 @@
 import { parseContextArgs, runContext } from "./context.js";
 import { parseCiReportArgs, runCiReport } from "./ci-report.js";
 import { parseCiResultArgs, runCiResult } from "./ci-result.js";
-const VERSION = "0.3.0";
-const HELP = `maind ${VERSION} — headless maind CLI for CI
+import { parseGitContextArgs, runGitContext } from "./git-context.js";
+const VERSION = "0.4.0";
+const HELP = `maind ${VERSION} — headless maind CLI for CI + git context
 
 Usage:
   maind context [options]      Pull stack-relevant lessons + conventions into the runner
+  maind git-context [options]  Briefing of local git state + peers + relevant lessons (session-start)
   maind ci-report [options]    Report a CI failure as a draft-lesson candidate (on failure)
   maind ci-result [options]    Report a build outcome + served manifest (end of job)
   maind --help                 Show this help
   maind --version              Print version
 
+git-context options (run at session-start; reads local git + gh, all fail-open):
+  --out <path>           Briefing markdown output (default .maind/git-context.md)
+  --manifest <path>      Optional structured JSON output (git_context manifest)
+  --no-mcp               Local git state only — skip peer-conflict + lesson enrichment
+  --mcp-url <url>        Override MCP endpoint (default \$MAIND_MCP_URL or production)
+
 ci-report options (run in an on-failure step; the agent authors the lesson first):
   --lesson <path>        Agent-authored lesson markdown (frontmatter + body) — required
   --rationale <text>     Why this is a reusable lesson — required
@@ -71,6 +79,9 @@ async function main() {
     if (cmd === "context") {
         return runContext(parseContextArgs(argv.slice(1)));
     }
+    if (cmd === "git-context") {
+        return runGitContext(parseGitContextArgs(argv.slice(1)));
+    }
     if (cmd === "ci-report") {
         return runCiReport(parseCiReportArgs(argv.slice(1)));
     }

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,EAAE;AACF,gCAAgC;AAChC,EAAE;AACF,uEAAuE;AACvE,2EAA2E;AAC3E,gFAAgF;AAChF,sEAAsE;AACtE,EAAE;AACF,yEAAyE;AACzE,qEAAqE;AAErE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAEhE,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,MAAM,IAAI,GAAG,SAAS,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA2C5B,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAEpB,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QAC/D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;QACrC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,UAAU,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;QACxB,OAAO,WAAW,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;QACxB,OAAO,WAAW,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,GAAG,0BAA0B,CAAC,CAAC;IAC/E,OAAO,CAAC,CAAC;AACX,CAAC;AAED,IAAI,EAAE;KACH,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAClC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACb,+EAA+E;IAC/E,2EAA2E;IAC3E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,EAAE;AACF,gCAAgC;AAChC,EAAE;AACF,uEAAuE;AACvE,2EAA2E;AAC3E,gFAAgF;AAChF,sEAAsE;AACtE,EAAE;AACF,yEAAyE;AACzE,qEAAqE;AAErE,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAChE,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtE,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,MAAM,IAAI,GAAG,SAAS,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkD5B,CAAC;AAEF,KAAK,UAAU,IAAI;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAEpB,IAAI,CAAC,GAAG,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QAC/D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACxC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;QACrC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtB,OAAO,UAAU,CAAC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,IAAI,GAAG,KAAK,aAAa,EAAE,CAAC;QAC1B,OAAO,aAAa,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,CAAC;IACD,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;QACxB,OAAO,WAAW,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;QACxB,OAAO,WAAW,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,GAAG,0BAA0B,CAAC,CAAC;IAC/E,OAAO,CAAC,CAAC;AACX,CAAC;AAED,IAAI,EAAE;KACH,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;KAClC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACb,+EAA+E;IAC/E,2EAA2E;IAC3E,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACzG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@maind-dev/cli",
-  "version": "0.3.0",
-  "description": "Headless maind CLI — pull stack-relevant lessons into CI runners and emit a context manifest for build-outcome attribution. No device flow; authenticates from MAIND_API_KEY.",
+  "version": "0.4.0",
+  "description": "Headless maind CLI — pull stack-relevant lessons into CI runners, report CI outcomes, and brief agents on local git state (branch, PRs, peers). No device flow; authenticates from MAIND_API_KEY.",
   "type": "module",
   "main": "./build/index.js",
   "bin": {