@maind-dev/cli 0.1.0 → 0.4.0

package/build/ci-report.js

@@ -0,0 +1,146 @@
+// `maind ci-report` — report a CI failure as a draft-lesson candidate (ADR-207
+// Phase 2, INGESTION). An agent running in the CI runner authors a lesson
+// candidate (frontmatter + body) capturing the gotcha + fix; this command reads
+// that file, attaches CI provenance from the runner env, and POSTs it to the
+// maind ingest endpoint with the CI key. maind files it in the maintainer review
+// inbox — never auto-published.
+//
+// Fail-open by contract: a failing report must never further break the build.
+// Any error → stderr warning, exit 0. (This already runs in an on-failure step.)
+import { createHash } from "node:crypto";
+import { readFileSync } from "node:fs";
+import { MissingApiKeyError, resolveAuth } from "./auth.js";
+const DEFAULT_REPORT_URL = "https://app.maind.dev/api/ci/report";
+export function parseCiReportArgs(argv) {
+    const get = (name) => {
+        const i = argv.indexOf(name);
+        if (i === -1 || i + 1 >= argv.length)
+            return undefined;
+        return argv[i + 1];
+    };
+    return {
+        lessonPath: get("--lesson") ?? null,
+        rationale: get("--rationale") ?? null,
+        failureType: get("--failure-type") ?? null,
+        signature: get("--signature") ?? null,
+        summary: get("--summary") ?? null,
+        provider: get("--provider") ?? "github-actions",
+        logsPath: get("--logs") ?? null,
+        remediation: get("--remediation") ?? null,
+        reportUrl: get("--report-url") ?? process.env.MAIND_REPORT_URL ?? DEFAULT_REPORT_URL,
+    };
+}
+/** Collects CI run metadata from the runner environment (GitHub Actions today). */
+function ciEnv() {
+    const env = process.env;
+    const runId = env.GITHUB_RUN_ID;
+    const repo = env.GITHUB_REPOSITORY;
+    const server = env.GITHUB_SERVER_URL ?? "https://github.com";
+    return {
+        workflow_name: env.GITHUB_WORKFLOW || undefined,
+        run_id: runId || undefined,
+        run_url: runId && repo ? `${server}/${repo}/actions/runs/${runId}` : undefined,
+    };
+}
+function sha256(s) {
+    return createHash("sha256").update(s, "utf8").digest("hex");
+}
+/** Runs the report. Always returns 0 (fail-open). */
+export async function runCiReport(opts) {
+    try {
+        if (!opts.lessonPath) {
+            warn("missing --lesson <path-to-authored-lesson.md>; nothing to report.");
+            return 0;
+        }
+        if (!opts.rationale) {
+            warn("missing --rationale; the agent should explain why this is a lesson.");
+            return 0;
+        }
+        if (!opts.failureType) {
+            warn("missing --failure-type (e.g. tsc-error, test-failure).");
+            return 0;
+        }
+        const lesson = readFileSync(opts.lessonPath, "utf8");
+        if (lesson.trim().length < 50) {
+            warn("authored lesson is too short — skipping report.");
+            return 0;
+        }
+        const env = ciEnv();
+        const runId = env.run_id ?? "local";
+        // Stable signature: explicit flag wins; else derive from failure-type + a
+        // hash of the lesson so the same recurring failure dedups server-side.
+        const signature = opts.signature ?? `${opts.failureType}:${sha256(opts.failureType + lesson).slice(0, 16)}`;
+        const provenance = {
+            ci_provider: opts.provider,
+            run_id: runId,
+            failure_type: opts.failureType,
+            failure_signature: signature,
+            draft_rationale: opts.rationale,
+        };
+        if (env.workflow_name)
+            provenance.workflow_name = env.workflow_name;
+        if (env.run_url)
+            provenance.run_url = env.run_url;
+        if (opts.summary)
+            provenance.failure_summary = opts.summary;
+        if (opts.remediation)
+            provenance.remediation_hint = opts.remediation;
+        if (opts.logsPath) {
+            try {
+                provenance.failure_logs = readFileSync(opts.logsPath, "utf8").slice(0, 8000);
+            }
+            catch {
+                // logs are best-effort
+            }
+        }
+        const auth = resolveAuth();
+        const body = JSON.stringify({
+            lesson,
+            content_hash: sha256(lesson),
+            ci_provenance: provenance,
+        });
+        let res;
+        try {
+            res = await fetch(opts.reportUrl, {
+                method: "POST",
+                headers: {
+                    "content-type": "application/json",
+                    authorization: `Bearer ${auth.apiKey}`,
+                },
+                body,
+            });
+        }
+        catch (err) {
+            warn(`network error posting to ${opts.reportUrl}: ${msg(err)}`);
+            return 0;
+        }
+        const text = await res.text().catch(() => "");
+        if (!res.ok) {
+            warn(`ingest rejected (HTTP ${res.status}): ${text.slice(0, 300)}`);
+            return 0;
+        }
+        let parsed = {};
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            // non-JSON 200 — treat as success but unparseable
+        }
+        process.stderr.write(`maind ci-report: ${parsed.deduplicated ? "deduplicated" : "filed"} draft ${parsed.draft_id ?? "?"}` +
+            (parsed.review_url ? ` → ${parsed.review_url}` : "") +
+            "\n");
+        return 0;
+    }
+    catch (err) {
+        const reason = err instanceof MissingApiKeyError ? err.message : msg(err);
+        warn(`report failed, continuing: ${reason}`);
+        return 0;
+    }
+}
+function msg(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function warn(line) {
+    process.stderr.write(`maind ci-report: ${line}\n`);
+}
+//# sourceMappingURL=ci-report.js.map

package/build/ci-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ci-report.js","sourceRoot":"","sources":["../src/ci-report.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,0EAA0E;AAC1E,gFAAgF;AAChF,6EAA6E;AAC7E,iFAAiF;AACjF,gCAAgC;AAChC,EAAE;AACF,8EAA8E;AAC9E,iFAAiF;AAEjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAE5D,MAAM,kBAAkB,GAAG,qCAAqC,CAAC;AAcjE,MAAM,UAAU,iBAAiB,CAAC,IAAc;IAC9C,MAAM,GAAG,GAAG,CAAC,IAAY,EAAsB,EAAE;QAC/C,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACvD,OAAO,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACrB,CAAC,CAAC;IACF,OAAO;QACL,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,IAAI,IAAI;QACnC,SAAS,EAAE,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI;QACrC,WAAW,EAAE,GAAG,CAAC,gBAAgB,CAAC,IAAI,IAAI;QAC1C,SAAS,EAAE,GAAG,CAAC,aAAa,CAAC,IAAI,IAAI;QACrC,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI;QACjC,QAAQ,EAAE,GAAG,CAAC,YAAY,CAAC,IAAI,gBAAgB;QAC/C,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI;QAC/B,WAAW,EAAE,GAAG,CAAC,eAAe,CAAC,IAAI,IAAI;QACzC,SAAS,EAAE,GAAG,CAAC,cAAc,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,kBAAkB;KACrF,CAAC;AACJ,CAAC;AAED,mFAAmF;AACnF,SAAS,KAAK;IACZ,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,CAAC;IAChC,MAAM,IAAI,GAAG,GAAG,CAAC,iBAAiB,CAAC;IACnC,MAAM,MAAM,GAAG,GAAG,CAAC,iBAAiB,IAAI,oBAAoB,CAAC;IAC7D,OAAO;QACL,aAAa,EAAE,GAAG,CAAC,eAAe,IAAI,SAAS;QAC/C,MAAM,EAAE,KAAK,IAAI,SAAS;QAC1B,OAAO,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,IAAI,iBAAiB,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS;KAC/E,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,CAAS;IACvB,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC9D,CAAC;AAED,qDAAqD;AACrD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAqB;IACrD,IAAI,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACrB,IAAI,CAAC,mEAAmE,CAAC,CAAC;YAC1E,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACpB,IAAI,CAAC,qEAAqE,CAAC,CAAC;YAC5E,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;YACtB,IAAI,CAAC,wDAAwD,CAAC,CAAC;YAC/D,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACrD,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,EAAE,EAAE,CAAC;YAC9B,IAAI,CAAC,iDAAiD,CAAC,CAAC;YACxD,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,GAAG,CAAC,MAAM,IAAI,OAAO,CAAC;QACpC,0EAA0E;QAC1E,uEAAuE;QACvE,MAAM,SAAS,GACb,IAAI,CAAC,SAAS,IAAI,GAAG,IAAI,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;QAE5F,MAAM,UAAU,GAA4B;YAC1C,WAAW,EAAE,IAAI,CAAC,QAAQ;YAC1B,MAAM,EAAE,KAAK;YACb,YAAY,EAAE,IAAI,CAAC,WAAW;YAC9B,iBAAiB,EAAE,SAAS;YAC5B,eAAe,EAAE,IAAI,CAAC,SAAS;SAChC,CAAC;QACF,IAAI,GAAG,CAAC,aAAa;YAAE,UAAU,CAAC,aAAa,GAAG,GAAG,CAAC,aAAa,CAAC;QACpE,IAAI,GAAG,CAAC,OAAO;YAAE,UAAU,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAClD,IAAI,IAAI,CAAC,OAAO;YAAE,UAAU,CAAC,eAAe,GAAG,IAAI,CAAC,OAAO,CAAC;QAC5D,IAAI,IAAI,CAAC,WAAW;YAAE,UAAU,CAAC,gBAAgB,GAAG,IAAI,CAAC,WAAW,CAAC;QACrE,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,UAAU,CAAC,YAAY,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;YAC/E,CAAC;YAAC,MAAM,CAAC;gBACP,uBAAuB;YACzB,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC1B,MAAM;YACN,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC;YAC5B,aAAa,EAAE,UAAU;SAC1B,CAAC,CAAC;QAEH,IAAI,GAAa,CAAC;QAClB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE;gBAChC,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,cAAc,EAAE,kBAAkB;oBAClC,aAAa,EAAE,UAAU,IAAI,CAAC,MAAM,EAAE;iBACvC;gBACD,IAAI;aACL,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,CAAC,4BAA4B,IAAI,CAAC,SAAS,KAAK,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAChE,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,IAAI,CAAC,yBAAyB,GAAG,CAAC,MAAM,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC;YACpE,OAAO,CAAC,CAAC;QACX,CAAC;QACD,IAAI,MAAM,GAAuE,EAAE,CAAC;QACpF,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,kDAAkD;QACpD,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,oBAAoB,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,UAAU,MAAM,CAAC,QAAQ,IAAI,GAAG,EAAE;YAClG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACpD,IAAI,CACP,CAAC;QACF,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,GAAG,YAAY,kBAAkB,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC1E,IAAI,CAAC,8BAA8B,MAAM,EAAE,CAAC,CAAC;QAC7C,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,SAAS,GAAG,CAAC,GAAY;IACvB,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,IAAI,CAAC,IAAY;IACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,IAAI,IAAI,CAAC,CAAC;AACrD,CAAC"}

package/build/ci-result.js

@@ -0,0 +1,145 @@
+// `maind ci-result` — report a CI build outcome (success|failure) together with
+// the served-lesson manifest (ADR-207 Phase 3, FEEDBACK). For every lesson that
+// was in the agent's context for this run (from `maind context`'s manifest.json),
+// maind records a per-run CI signal. The aggregate "CI-confirmed N×" is shown to
+// maintainers as a human-gated signal — it never changes a lesson's trust
+// automatically. The signal means "this lesson was in context for N green runs"
+// (correlation, not causation).
+//
+// Fail-open by contract: a failing report must never break the build. Any error
+// → stderr warning, exit 0. Runs at the end of a job (success OR failure).
+import { readFileSync } from "node:fs";
+import { MissingApiKeyError, resolveAuth } from "./auth.js";
+const DEFAULT_RESULT_URL = "https://app.maind.dev/api/ci/result";
+export function parseCiResultArgs(argv) {
+    const get = (name) => {
+        const i = argv.indexOf(name);
+        if (i === -1 || i + 1 >= argv.length)
+            return undefined;
+        return argv[i + 1];
+    };
+    return {
+        outcome: get("--outcome") ?? null,
+        manifestPath: get("--manifest") ?? ".maind/manifest.json",
+        runRef: get("--run-ref") ?? null,
+        runUrl: get("--run-url") ?? null,
+        resultUrl: get("--result-url") ?? process.env.MAIND_RESULT_URL ?? DEFAULT_RESULT_URL,
+    };
+}
+/**
+ * Normalizes common CI outcome spellings (incl. GitHub Actions `${{ job.status }}`
+ * → success|failure|cancelled) to the two states the server records.
+ */
+function normalizeOutcome(raw) {
+    const s = raw.trim().toLowerCase();
+    if (["success", "passed", "pass", "passing", "ok", "green", "0"].includes(s))
+        return "success";
+    if (["failure", "failed", "fail", "failing", "error", "red", "cancelled", "canceled"].includes(s)) {
+        return "failure";
+    }
+    return null;
+}
+/** Collects CI run metadata from the runner environment (GitHub Actions today). */
+function ciEnv() {
+    const env = process.env;
+    const runId = env.GITHUB_RUN_ID;
+    const repo = env.GITHUB_REPOSITORY;
+    const server = env.GITHUB_SERVER_URL ?? "https://github.com";
+    return {
+        run_id: runId || undefined,
+        run_url: runId && repo ? `${server}/${repo}/actions/runs/${runId}` : undefined,
+    };
+}
+/** Runs the result report. Always returns 0 (fail-open). */
+export async function runCiResult(opts) {
+    try {
+        if (!opts.outcome) {
+            warn("missing --outcome <success|failure> (e.g. --outcome ${{ job.status }}).");
+            return 0;
+        }
+        const outcome = normalizeOutcome(opts.outcome);
+        if (!outcome) {
+            warn(`unrecognized --outcome '${opts.outcome}'; expected success|failure.`);
+            return 0;
+        }
+        let manifestRaw;
+        try {
+            manifestRaw = readFileSync(opts.manifestPath, "utf8");
+        }
+        catch {
+            warn(`no manifest at ${opts.manifestPath} (did 'maind context' run first?); nothing to attribute.`);
+            return 0;
+        }
+        let manifest;
+        try {
+            manifest = JSON.parse(manifestRaw);
+        }
+        catch {
+            warn(`manifest at ${opts.manifestPath} is not valid JSON; skipping.`);
+            return 0;
+        }
+        const lessonIds = Array.isArray(manifest.served)
+            ? manifest.served.map((s) => s.id).filter((id) => typeof id === "string" && id.length > 0)
+            : [];
+        if (lessonIds.length === 0) {
+            warn("manifest lists no served lessons; nothing to report.");
+            return 0;
+        }
+        const env = ciEnv();
+        const runRef = opts.runRef ?? manifest.run_ref ?? env.run_id ?? null;
+        if (!runRef) {
+            warn("no run ref (--run-ref / manifest.run_ref / $GITHUB_RUN_ID); cannot attribute an outcome.");
+            return 0;
+        }
+        const runUrl = opts.runUrl ?? env.run_url ?? null;
+        const auth = resolveAuth();
+        const body = JSON.stringify({
+            outcome,
+            run_ref: runRef,
+            run_url: runUrl,
+            lesson_ids: lessonIds,
+        });
+        let res;
+        try {
+            res = await fetch(opts.resultUrl, {
+                method: "POST",
+                headers: {
+                    "content-type": "application/json",
+                    authorization: `Bearer ${auth.apiKey}`,
+                },
+                body,
+            });
+        }
+        catch (err) {
+            warn(`network error posting to ${opts.resultUrl}: ${msg(err)}`);
+            return 0;
+        }
+        const text = await res.text().catch(() => "");
+        if (!res.ok) {
+            warn(`ingest rejected (HTTP ${res.status}): ${text.slice(0, 300)}`);
+            return 0;
+        }
+        let parsed = {};
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch {
+            // non-JSON 200 — treat as success but unparseable
+        }
+        process.stderr.write(`maind ci-result: ${outcome} · recorded ${parsed.recorded ?? "?"} · skipped ${parsed.skipped ?? 0}` +
+            ` (run ${runRef})\n`);
+        return 0;
+    }
+    catch (err) {
+        const reason = err instanceof MissingApiKeyError ? err.message : msg(err);
+        warn(`result failed, continuing: ${reason}`);
+        return 0;
+    }
+}
+function msg(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+function warn(line) {
+    process.stderr.write(`maind ci-result: ${line}\n`);
+}
+//# sourceMappingURL=ci-result.js.map

package/build/ci-result.js.map

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

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

@@ -10,14 +10,44 @@
 // STDOUT is reserved for command results that are meant to be piped; all
 // diagnostics go to STDERR. Today only the `context` command exists.
 import { parseContextArgs, runContext } from "./context.js";
-const VERSION = "0.1.0";
-const HELP = `maind ${VERSION} — headless maind CLI for CI
+import { parseCiReportArgs, runCiReport } from "./ci-report.js";
+import { parseCiResultArgs, runCiResult } from "./ci-result.js";
+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
+  --failure-type <t>     e.g. tsc-error, test-failure, lint-error — required
+  --signature <s>        Stable dedup key (default: failure-type + lesson hash)
+  --summary <text>       Short failure description
+  --remediation <text>   Suggested fix
+  --logs <path>          Optional failure-log file (truncated to 8k)
+  --provider <p>         CI provider (default github-actions)
+  --report-url <url>     Override ingest endpoint (default \$MAIND_REPORT_URL or prod)
+
+ci-result options (run at the end of a job, success OR failure):
+  --outcome <s>          Build outcome, e.g. \${{ job.status }} (success|failure) — required
+  --manifest <path>      Served-lesson manifest from 'maind context' (default .maind/manifest.json)
+  --run-ref <id>         Build identifier (default manifest.run_ref or \$GITHUB_RUN_ID)
+  --run-url <url>        Link to the CI run (default derived from GitHub env)
+  --result-url <url>     Override ingest endpoint (default \$MAIND_RESULT_URL or prod)
+
 context options:
   --stack <a,b>          Stack hint (seeds the platforms filter), e.g. nextjs,supabase
   --platforms <a,b>      Explicit platforms filter (overrides --stack)
@@ -49,6 +79,15 @@ 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)));
+    }
+    if (cmd === "ci-result") {
+        return runCiResult(parseCiResultArgs(argv.slice(1)));
+    }
     process.stderr.write(`maind: unknown command '${cmd}'. Run 'maind --help'.\n`);
     return 2;
 }

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;AAE5D,MAAM,OAAO,GAAG,OAAO,CAAC;AAExB,MAAM,IAAI,GAAG,SAAS,OAAO;;;;;;;;;;;;;;;;;;;;;;;CAuB5B,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;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.1.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": {