@maind-dev/cli 0.1.0 → 0.3.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":"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"}

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":"AAAA,gFAAgF;AAChF,gFAAgF;AAChF,kFAAkF;AAClF,iFAAiF;AACjF,0EAA0E;AAC1E,gFAAgF;AAChF,gCAAgC;AAChC,EAAE;AACF,gFAAgF;AAChF,2EAA2E;AAE3E,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAG5D,MAAM,kBAAkB,GAAG,qCAAqC,CAAC;AAUjE,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,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI;QACjC,YAAY,EAAE,GAAG,CAAC,YAAY,CAAC,IAAI,sBAAsB;QACzD,MAAM,EAAE,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI;QAChC,MAAM,EAAE,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI;QAChC,SAAS,EAAE,GAAG,CAAC,cAAc,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,kBAAkB;KACrF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,gBAAgB,CAAC,GAAW;IACnC,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACnC,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,SAAS,CAAC;IAC/F,IAAI,CAAC,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;QAClG,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,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,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,4DAA4D;AAC5D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAqB;IACrD,IAAI,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,IAAI,CAAC,yEAAyE,CAAC,CAAC;YAChF,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,IAAI,CAAC,2BAA2B,IAAI,CAAC,OAAO,8BAA8B,CAAC,CAAC;YAC5E,OAAO,CAAC,CAAC;QACX,CAAC;QAED,IAAI,WAAmB,CAAC;QACxB,IAAI,CAAC;YACH,WAAW,GAAG,YAAY,CAAC,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,kBAAkB,IAAI,CAAC,YAAY,0DAA0D,CAAC,CAAC;YACpG,OAAO,CAAC,CAAC;QACX,CAAC;QAED,IAAI,QAAkB,CAAC;QACvB,IAAI,CAAC;YACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAa,CAAC;QACjD,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC,eAAe,IAAI,CAAC,YAAY,+BAA+B,CAAC,CAAC;YACtE,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;YAC9C,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAgB,EAAE,CAAC,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;YACxG,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,IAAI,CAAC,sDAAsD,CAAC,CAAC;YAC7D,OAAO,CAAC,CAAC;QACX,CAAC;QAED,MAAM,GAAG,GAAG,KAAK,EAAE,CAAC;QACpB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,QAAQ,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,IAAI,IAAI,CAAC;QACrE,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,0FAA0F,CAAC,CAAC;YACjG,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,IAAI,IAAI,CAAC;QAElD,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC1B,OAAO;YACP,OAAO,EAAE,MAAM;YACf,OAAO,EAAE,MAAM;YACf,UAAU,EAAE,SAAS;SACtB,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,GAA4C,EAAE,CAAC;QACzD,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,OAAO,eAAe,MAAM,CAAC,QAAQ,IAAI,GAAG,cAAc,MAAM,CAAC,OAAO,IAAI,CAAC,EAAE;YACjG,SAAS,MAAM,KAAK,CACvB,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/index.js

@@ -10,14 +10,36 @@
 // 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";
+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
 
 Usage:
   maind context [options]      Pull stack-relevant lessons + conventions into the runner
+  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
 
+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 +71,12 @@ async function main() {
     if (cmd === "context") {
         return runContext(parseContextArgs(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;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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maind-dev/cli",
-  "version": "0.1.0",
+  "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.",
   "type": "module",
   "main": "./build/index.js",