@jeger-ai/opengantry 1.0.0

package/dist/cli/lib/status-report.js

@@ -0,0 +1,77 @@
+import fs from "node:fs";
+import path from "node:path";
+import { REL_AGENT_ERROR_FILE } from "./constants.js";
+import { collectDoctorReport } from "./doctor-orchestration.js";
+import { resolvePinnedMission } from "./mission-resolution.js";
+import { checkSkillManifestSync } from "./skill-sync.js";
+function collectBlockers(skillSync, doctorLines, verifyReadiness) {
+    const blockers = [];
+    for (const e of skillSync.errors)
+        blockers.push(e);
+    for (const line of doctorLines) {
+        if (line.level === "fail")
+            blockers.push(line.message);
+    }
+    if (verifyReadiness === "needs_teacher") {
+        blockers.push("Teacher allowlist unset — gapman verify git-proof will fail");
+    }
+    if (verifyReadiness === "needs_mission") {
+        blockers.push("No pinned mission — legislate or pin before worker execution");
+    }
+    return blockers;
+}
+function readinessSummary(verifyReadiness, blockers) {
+    if (blockers.length > 0) {
+        return verifyReadiness === "blocked"
+            ? `blocked (${blockers.length} issue${blockers.length === 1 ? "" : "s"})`
+            : `${verifyReadiness} (${blockers.length} issue${blockers.length === 1 ? "" : "s"})`;
+    }
+    return verifyReadiness;
+}
+function assessVerifyReadiness(root, doctorLines, pinnedMission, teacherAllowlistUnset) {
+    if (doctorLines.some((l) => l.level === "fail"))
+        return "blocked";
+    if (teacherAllowlistUnset)
+        return "needs_teacher";
+    if (!pinnedMission) {
+        const example = ".gitagent/missions/example.verify.yaml";
+        if (fs.existsSync(path.join(root, example)))
+            return "ready";
+        return "needs_mission";
+    }
+    return "ready";
+}
+export function buildStatusReport(root, manifest) {
+    const skillSync = checkSkillManifestSync(root, manifest);
+    const doctorReport = collectDoctorReport(root, manifest);
+    const pinnedMission = resolvePinnedMission(root, { profile: "status" });
+    const lastErrorAbs = path.join(root, REL_AGENT_ERROR_FILE);
+    const lastErrorFile = fs.existsSync(lastErrorAbs) ? REL_AGENT_ERROR_FILE : null;
+    const verifyReadiness = assessVerifyReadiness(root, doctorReport.lines, pinnedMission, doctorReport.teacherAllowlistUnset);
+    let nextStep = doctorReport.nextStep;
+    if (pinnedMission) {
+        nextStep = `gapman verify --mission ${pinnedMission}`;
+    }
+    else if (verifyReadiness === "needs_mission") {
+        nextStep = nextStep ?? 'gapman start "<intent>" --msn MSN-0001 --skill-key <key>';
+    }
+    const hasFail = !skillSync.ok || doctorReport.hasFail;
+    const blockers = collectBlockers(skillSync, doctorReport.lines, verifyReadiness);
+    const summary = readinessSummary(verifyReadiness, blockers);
+    return {
+        repo: root,
+        schema_version: manifest.schema_version,
+        skill_sync_ok: skillSync.ok,
+        manifest_skills: skillSync.manifestKeys,
+        skills_md: skillSync.diskFiles,
+        doctor_lines: doctorReport.lines,
+        pinned_mission: pinnedMission,
+        verify_readiness: verifyReadiness,
+        blockers,
+        readiness_summary: summary,
+        last_error_file: lastErrorFile,
+        next_step: nextStep,
+        exit_code: hasFail ? 1 : 0,
+    };
+}
+//# sourceMappingURL=status-report.js.map

package/dist/cli/lib/status-report.js.map

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

package/dist/cli/lib/substrate-version.d.ts

@@ -0,0 +1,22 @@
+export declare const REL_SUBSTRATE_VERSION: ".gitagent/foreman/SUBSTRATE.version.json";
+export type SubstrateVersionSource = "substrate_file" | "legacy_compat" | "legacy_default";
+export interface InstalledSubstrateVersion {
+    version: string;
+    source: SubstrateVersionSource;
+}
+export interface SubstrateVersionFile {
+    schema_version: string;
+    opengantry_version: string;
+    installed_at: string;
+    installed_by: string;
+}
+/** Compare semver core (major.minor.patch). Returns negative if a < b, 0 if equal, positive if a > b. */
+export declare function compareSemver(a: string, b: string): number;
+export declare function readRepoCompatVersion(repoRoot: string): string | null;
+export declare function readInstalledSubstrateVersion(repoRoot: string): InstalledSubstrateVersion;
+export declare function serializeSubstrateVersionFile(version: string, installedBy: string): string;
+export declare function writeSubstrateVersionFile(repoRoot: string, version: string, installedBy: string): void;
+export declare function alreadyCurrentMessage(installed: string, bundled: string): string;
+export declare function ensureSubstrateVersionOnInit(repoRoot: string, templatesRoot: string): void;
+export declare function legacyVersionWarning(source: SubstrateVersionSource): string | null;
+//# sourceMappingURL=substrate-version.d.ts.map

package/dist/cli/lib/substrate-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"substrate-version.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/substrate-version.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,qBAAqB,EAAG,0CAAmD,CAAC;AAEzF,MAAM,MAAM,sBAAsB,GAAG,gBAAgB,GAAG,eAAe,GAAG,gBAAgB,CAAC;AAE3F,MAAM,WAAW,yBAAyB;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,sBAAsB,CAAC;CAChC;AAED,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAYD,yGAAyG;AACzG,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ1D;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWrE;AAED,wBAAgB,6BAA6B,CAAC,QAAQ,EAAE,MAAM,GAAG,yBAAyB,CAmBzF;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,MAAM,CAQR;AAED,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,MAAM,GAClB,IAAI,CAIN;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAMhF;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAK1F;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,sBAAsB,GAAG,MAAM,GAAG,IAAI,CAQlF"}

package/dist/cli/lib/substrate-version.js

@@ -0,0 +1,97 @@
+import fs from "node:fs";
+import path from "node:path";
+import { NPM_PACKAGE_NAME } from "./constants.js";
+import { loadIntegrationCompat } from "./integration-compat.js";
+export const REL_SUBSTRATE_VERSION = ".gitagent/foreman/SUBSTRATE.version.json";
+function parseSemverParts(version) {
+    const core = version.trim().split("-")[0] ?? "0.0.0";
+    const parts = core.split(".").map((p) => Number.parseInt(p, 10));
+    return [
+        Number.isFinite(parts[0]) ? parts[0] : 0,
+        Number.isFinite(parts[1]) ? parts[1] : 0,
+        Number.isFinite(parts[2]) ? parts[2] : 0,
+    ];
+}
+/** Compare semver core (major.minor.patch). Returns negative if a < b, 0 if equal, positive if a > b. */
+export function compareSemver(a, b) {
+    const pa = parseSemverParts(a);
+    const pb = parseSemverParts(b);
+    for (let i = 0; i < 3; i++) {
+        if (pa[i] < pb[i])
+            return -1;
+        if (pa[i] > pb[i])
+            return 1;
+    }
+    return 0;
+}
+export function readRepoCompatVersion(repoRoot) {
+    const compatPath = path.join(repoRoot, "integrations/compatibility.json");
+    if (!fs.existsSync(compatPath))
+        return null;
+    try {
+        const raw = JSON.parse(fs.readFileSync(compatPath, "utf8"));
+        return typeof raw.opengantry_version === "string" && raw.opengantry_version.length > 0
+            ? raw.opengantry_version
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function readInstalledSubstrateVersion(repoRoot) {
+    const substratePath = path.join(repoRoot, REL_SUBSTRATE_VERSION.split("/").join(path.sep));
+    if (fs.existsSync(substratePath)) {
+        try {
+            const raw = JSON.parse(fs.readFileSync(substratePath, "utf8"));
+            if (typeof raw.opengantry_version === "string" && raw.opengantry_version.length > 0) {
+                return { version: raw.opengantry_version, source: "substrate_file" };
+            }
+        }
+        catch {
+            // fall through to legacy
+        }
+    }
+    const compatVersion = readRepoCompatVersion(repoRoot);
+    if (compatVersion) {
+        return { version: compatVersion, source: "legacy_compat" };
+    }
+    return { version: "0.0.0", source: "legacy_default" };
+}
+export function serializeSubstrateVersionFile(version, installedBy) {
+    const doc = {
+        schema_version: "0.1.0",
+        opengantry_version: version,
+        installed_at: new Date().toISOString(),
+        installed_by: installedBy,
+    };
+    return `${JSON.stringify(doc, null, 2)}\n`;
+}
+export function writeSubstrateVersionFile(repoRoot, version, installedBy) {
+    const abs = path.join(repoRoot, REL_SUBSTRATE_VERSION.split("/").join(path.sep));
+    fs.mkdirSync(path.dirname(abs), { recursive: true });
+    fs.writeFileSync(abs, serializeSubstrateVersionFile(version, installedBy), "utf8");
+}
+export function alreadyCurrentMessage(installed, bundled) {
+    return [
+        `Substrate is up to date (installed ${installed}, bundled ${bundled}).`,
+        "To upgrade to a newer OpenGantry release, first update the package manager dependency",
+        `(e.g. npm install ${NPM_PACKAGE_NAME}@latest) and re-run: gapman upgrade`,
+    ].join("\n");
+}
+export function ensureSubstrateVersionOnInit(repoRoot, templatesRoot) {
+    const substrateAbs = path.join(repoRoot, REL_SUBSTRATE_VERSION.split("/").join(path.sep));
+    if (fs.existsSync(substrateAbs))
+        return;
+    const version = loadIntegrationCompat(templatesRoot).opengantry_version;
+    writeSubstrateVersionFile(repoRoot, version, "gapman init");
+}
+export function legacyVersionWarning(source) {
+    if (source === "legacy_default") {
+        return "Legacy repo detected (no SUBSTRATE.version.json); first apply will pin substrate version.";
+    }
+    if (source === "legacy_compat") {
+        return "Inferred substrate version from integrations/compatibility.json; first apply will write SUBSTRATE.version.json.";
+    }
+    return null;
+}
+//# sourceMappingURL=substrate-version.js.map

package/dist/cli/lib/substrate-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"substrate-version.js","sourceRoot":"","sources":["../../../src/cli/lib/substrate-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,MAAM,CAAC,MAAM,qBAAqB,GAAG,0CAAmD,CAAC;AAgBzF,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;IACrD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IACjE,OAAO;QACL,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,aAAa,CAAC,CAAS,EAAE,CAAS;IAChD,MAAM,EAAE,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC/B,MAAM,EAAE,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,EAAE,CAAC,CAAC,CAAE,GAAG,EAAE,CAAC,CAAC,CAAE;YAAE,OAAO,CAAC,CAAC,CAAC;QAC/B,IAAI,EAAE,CAAC,CAAC,CAAE,GAAG,EAAE,CAAC,CAAC,CAAE;YAAE,OAAO,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IACpD,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,iCAAiC,CAAC,CAAC;IAC1E,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAAoC,CAAC;QAC/F,OAAO,OAAO,GAAG,CAAC,kBAAkB,KAAK,QAAQ,IAAI,GAAG,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC;YACpF,CAAC,CAAC,GAAG,CAAC,kBAAkB;YACxB,CAAC,CAAC,IAAI,CAAC;IACX,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,6BAA6B,CAAC,QAAgB;IAC5D,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,qBAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3F,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAyB,CAAC;YACvF,IAAI,OAAO,GAAG,CAAC,kBAAkB,KAAK,QAAQ,IAAI,GAAG,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpF,OAAO,EAAE,OAAO,EAAE,GAAG,CAAC,kBAAkB,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;YACvE,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,yBAAyB;QAC3B,CAAC;IACH,CAAC;IAED,MAAM,aAAa,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACtD,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC;IAC7D,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC;AACxD,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,OAAe,EACf,WAAmB;IAEnB,MAAM,GAAG,GAAyB;QAChC,cAAc,EAAE,OAAO;QACvB,kBAAkB,EAAE,OAAO;QAC3B,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACtC,YAAY,EAAE,WAAW;KAC1B,CAAC;IACF,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,QAAgB,EAChB,OAAe,EACf,WAAmB;IAEnB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,qBAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACjF,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACrD,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,6BAA6B,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,CAAC,CAAC;AACrF,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,SAAiB,EAAE,OAAe;IACtE,OAAO;QACL,sCAAsC,SAAS,aAAa,OAAO,IAAI;QACvE,uFAAuF;QACvF,qBAAqB,gBAAgB,qCAAqC;KAC3E,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,QAAgB,EAAE,aAAqB;IAClF,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,qBAAqB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1F,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO;IACxC,MAAM,OAAO,GAAG,qBAAqB,CAAC,aAAa,CAAC,CAAC,kBAAkB,CAAC;IACxE,yBAAyB,CAAC,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAA8B;IACjE,IAAI,MAAM,KAAK,gBAAgB,EAAE,CAAC;QAChC,OAAO,2FAA2F,CAAC;IACrG,CAAC;IACD,IAAI,MAAM,KAAK,eAAe,EAAE,CAAC;QAC/B,OAAO,iHAAiH,CAAC;IAC3H,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/cli/lib/teacher-identity.d.ts

@@ -0,0 +1,24 @@
+export declare const ENV_TEACHER_EMAILS: "GAPMAN_TEACHER_EMAILS";
+export declare const GIT_CONFIG_TEACHER_EMAILS: "gapman.teacherEmails";
+export declare const REL_TEACHER_ALLOWLIST: ".gitagent/foreman/TEACHER.allowlist";
+export declare const REL_TEACHER_ALLOWLIST_LOCAL: ".gitagent/foreman/TEACHER.allowlist.local";
+export type TeacherIdentitySource = "allowlist_file" | "allowlist_local" | "git_config" | "env" | "git_user_email" | "unset";
+export interface ResolvedTeacherIdentity {
+    emails: string[];
+    source: TeacherIdentitySource;
+    /** Human-readable detail for doctor / errors */
+    detail: string;
+}
+/** Legacy env-only parser (tests / explicit CI override). */
+export declare function parseTeacherEmailsFromEnv(): string[];
+/**
+ * Resolve Teacher legislation allowlist for a repository.
+ * Repo-local sources win over shell env so multi-project developers are not cross-contaminated.
+ */
+export declare function resolveTeacherEmails(repoRoot: string): ResolvedTeacherIdentity;
+export declare function serializeTeacherAllowlist(emails: string[]): string;
+export declare function writeTeacherAllowlistLocal(repoRoot: string, emails: string[]): void;
+/** Create gitignored local allowlist from repo git user.email when missing. */
+export declare function ensureTeacherAllowlistOnInit(repoRoot: string): boolean;
+export declare function teacherIdentitySetupHint(_repoRoot: string): string;
+//# sourceMappingURL=teacher-identity.d.ts.map

package/dist/cli/lib/teacher-identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"teacher-identity.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/teacher-identity.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,kBAAkB,EAAG,uBAAgC,CAAC;AACnE,eAAO,MAAM,yBAAyB,EAAG,sBAA+B,CAAC;AAEzE,eAAO,MAAM,qBAAqB,EAAG,qCAA8C,CAAC;AACpF,eAAO,MAAM,2BAA2B,EAAG,2CAAoD,CAAC;AAEhG,MAAM,MAAM,qBAAqB,GAC7B,gBAAgB,GAChB,iBAAiB,GACjB,YAAY,GACZ,KAAK,GACL,gBAAgB,GAChB,OAAO,CAAC;AAEZ,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,qBAAqB,CAAC;IAC9B,gDAAgD;IAChD,MAAM,EAAE,MAAM,CAAC;CAChB;AAoCD,6DAA6D;AAC7D,wBAAgB,yBAAyB,IAAI,MAAM,EAAE,CAIpD;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,uBAAuB,CA2C9E;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAGlE;AAED,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAInF;AAED,+EAA+E;AAC/E,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAStE;AAED,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAOlE"}

package/dist/cli/lib/teacher-identity.js

@@ -0,0 +1,123 @@
+import fs from "node:fs";
+import path from "node:path";
+import { gitRunOk } from "./git-repo.js";
+export const ENV_TEACHER_EMAILS = "GAPMAN_TEACHER_EMAILS";
+export const GIT_CONFIG_TEACHER_EMAILS = "gapman.teacherEmails";
+export const REL_TEACHER_ALLOWLIST = ".gitagent/foreman/TEACHER.allowlist";
+export const REL_TEACHER_ALLOWLIST_LOCAL = ".gitagent/foreman/TEACHER.allowlist.local";
+function normalizeEmailList(raw) {
+    const parts = raw
+        .split(/[\n,]+/)
+        .map((s) => s.replace(/#.*$/, "").trim().toLowerCase())
+        .filter((s) => s.length > 0 && s.includes("@"));
+    return [...new Set(parts)];
+}
+function readAllowlistFile(repoRoot, relPath) {
+    const abs = path.join(repoRoot, relPath.split("/").join(path.sep));
+    if (!fs.existsSync(abs))
+        return [];
+    return normalizeEmailList(fs.readFileSync(abs, "utf8"));
+}
+function readGitConfigTeacherEmails(repoRoot) {
+    const local = gitRunOk(repoRoot, ["config", "--local", "--get", GIT_CONFIG_TEACHER_EMAILS]);
+    if (local.ok && local.stdout.trim()) {
+        return normalizeEmailList(local.stdout);
+    }
+    const global = gitRunOk(repoRoot, ["config", "--global", "--get", GIT_CONFIG_TEACHER_EMAILS]);
+    if (global.ok && global.stdout.trim()) {
+        return normalizeEmailList(global.stdout);
+    }
+    return [];
+}
+function readGitUserEmail(repoRoot) {
+    const local = gitRunOk(repoRoot, ["config", "--local", "--get", "user.email"]);
+    if (local.ok && local.stdout.trim()) {
+        return local.stdout.trim().toLowerCase();
+    }
+    return null;
+}
+/** Legacy env-only parser (tests / explicit CI override). */
+export function parseTeacherEmailsFromEnv() {
+    const raw = process.env[ENV_TEACHER_EMAILS];
+    if (!raw?.trim())
+        return [];
+    return normalizeEmailList(raw);
+}
+/**
+ * Resolve Teacher legislation allowlist for a repository.
+ * Repo-local sources win over shell env so multi-project developers are not cross-contaminated.
+ */
+export function resolveTeacherEmails(repoRoot) {
+    const team = readAllowlistFile(repoRoot, REL_TEACHER_ALLOWLIST);
+    const local = readAllowlistFile(repoRoot, REL_TEACHER_ALLOWLIST_LOCAL);
+    const mergedFile = [...new Set([...team, ...local])];
+    if (mergedFile.length > 0) {
+        const sources = [];
+        if (team.length > 0)
+            sources.push(REL_TEACHER_ALLOWLIST);
+        if (local.length > 0)
+            sources.push(REL_TEACHER_ALLOWLIST_LOCAL);
+        return {
+            emails: mergedFile,
+            source: local.length > 0 && team.length === 0 ? "allowlist_local" : "allowlist_file",
+            detail: sources.join(" + "),
+        };
+    }
+    const fromGitConfig = readGitConfigTeacherEmails(repoRoot);
+    if (fromGitConfig.length > 0) {
+        return {
+            emails: fromGitConfig,
+            source: "git_config",
+            detail: `git config ${GIT_CONFIG_TEACHER_EMAILS}`,
+        };
+    }
+    const fromEnv = parseTeacherEmailsFromEnv();
+    if (fromEnv.length > 0) {
+        return {
+            emails: fromEnv,
+            source: "env",
+            detail: ENV_TEACHER_EMAILS,
+        };
+    }
+    const gitEmail = readGitUserEmail(repoRoot);
+    if (gitEmail) {
+        return {
+            emails: [gitEmail],
+            source: "git_user_email",
+            detail: "git config user.email (implicit single Teacher)",
+        };
+    }
+    return { emails: [], source: "unset", detail: "no Teacher identity configured" };
+}
+export function serializeTeacherAllowlist(emails) {
+    const unique = [...new Set(emails.map((e) => e.trim().toLowerCase()).filter((e) => e.includes("@")))];
+    return `${unique.join("\n")}\n`;
+}
+export function writeTeacherAllowlistLocal(repoRoot, emails) {
+    const abs = path.join(repoRoot, REL_TEACHER_ALLOWLIST_LOCAL.split("/").join(path.sep));
+    fs.mkdirSync(path.dirname(abs), { recursive: true });
+    fs.writeFileSync(abs, serializeTeacherAllowlist(emails), "utf8");
+}
+/** Create gitignored local allowlist from repo git user.email when missing. */
+export function ensureTeacherAllowlistOnInit(repoRoot) {
+    const abs = path.join(repoRoot, REL_TEACHER_ALLOWLIST_LOCAL.split("/").join(path.sep));
+    if (fs.existsSync(abs))
+        return false;
+    const team = readAllowlistFile(repoRoot, REL_TEACHER_ALLOWLIST);
+    if (team.length > 0)
+        return false;
+    const gitEmail = readGitUserEmail(repoRoot);
+    if (!gitEmail)
+        return false;
+    writeTeacherAllowlistLocal(repoRoot, [gitEmail]);
+    return true;
+}
+export function teacherIdentitySetupHint(_repoRoot) {
+    return [
+        `echo "$(git config user.email)" >> ${REL_TEACHER_ALLOWLIST_LOCAL}`,
+        `or: git config gapman.teacherEmails "$(git config user.email)"`,
+        `or: gapman teacher set "$(git config user.email)"`,
+        `# env ${ENV_TEACHER_EMAILS} is CI-only fallback; prefer repo-local config`,
+    ].join("\n       ");
+}
+//# sourceMappingURL=teacher-identity.js.map

package/dist/cli/lib/teacher-identity.js.map

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

package/dist/cli/lib/telemetry-log.d.ts

@@ -0,0 +1,22 @@
+export interface TelemetryContext {
+    flight_id: string;
+    msn_id: string;
+    mission_file: string;
+    skill_key: string;
+    worker_command: string[];
+}
+export interface TelemetryEvent {
+    type: string;
+    v: 1;
+    ts: string;
+    flight_id: string;
+    msn_id: string;
+    mission_file: string;
+    [key: string]: unknown;
+}
+export interface TelemetryWriter {
+    logEvent: (event: Omit<TelemetryEvent, "v" | "ts" | "flight_id" | "msn_id" | "mission_file">) => void;
+    close: () => void;
+}
+export declare function createTelemetryWriter(workerLogPath: string, context: TelemetryContext, append: boolean): TelemetryWriter;
+//# sourceMappingURL=telemetry-log.d.ts.map

package/dist/cli/lib/telemetry-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-log.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/telemetry-log.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,EAAE,CAAC,CAAC;IACL,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,GAAG,GAAG,IAAI,GAAG,WAAW,GAAG,QAAQ,GAAG,cAAc,CAAC,KAAK,IAAI,CAAC;IACtG,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB;AAcD,wBAAgB,qBAAqB,CACnC,aAAa,EAAE,MAAM,EACrB,OAAO,EAAE,gBAAgB,EACzB,MAAM,EAAE,OAAO,GACd,eAAe,CAqCjB"}

package/dist/cli/lib/telemetry-log.js

@@ -0,0 +1,50 @@
+import fs from "node:fs";
+import path from "node:path";
+import crypto from "node:crypto";
+function nowIso() {
+    return new Date().toISOString();
+}
+function lineHash(s) {
+    return crypto.createHash("sha256").update(s).digest("hex");
+}
+function writeLine(fd, line) {
+    fs.writeSync(fd, `${line}\n`, undefined, "utf8");
+}
+export function createTelemetryWriter(workerLogPath, context, append) {
+    const dir = path.dirname(workerLogPath);
+    fs.mkdirSync(dir, { recursive: true });
+    const fd = fs.openSync(workerLogPath, append ? "a" : "w");
+    if (!append) {
+        writeLine(fd, "# WORKER_LOG");
+        writeLine(fd, "");
+    }
+    else {
+        writeLine(fd, "");
+    }
+    writeLine(fd, `## Flight ${context.msn_id || "(no-msn)"} / ${context.flight_id}`);
+    writeLine(fd, "");
+    writeLine(fd, "```jsonl");
+    return {
+        logEvent(event) {
+            const payload = {
+                v: 1,
+                ts: nowIso(),
+                flight_id: context.flight_id,
+                msn_id: context.msn_id,
+                mission_file: context.mission_file,
+                ...event,
+            };
+            const lineBody = JSON.stringify(payload);
+            const envelope = JSON.stringify({
+                ...payload,
+                line_sha256: lineHash(lineBody),
+            });
+            writeLine(fd, envelope);
+        },
+        close() {
+            writeLine(fd, "```");
+            fs.closeSync(fd);
+        },
+    };
+}
+//# sourceMappingURL=telemetry-log.js.map

package/dist/cli/lib/telemetry-log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry-log.js","sourceRoot":"","sources":["../../../src/cli/lib/telemetry-log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,MAAM,MAAM,aAAa,CAAC;AAyBjC,SAAS,MAAM;IACb,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS;IACzB,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,SAAS,CAAC,EAAU,EAAE,IAAY;IACzC,EAAE,CAAC,SAAS,CAAC,EAAE,EAAE,GAAG,IAAI,IAAI,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,aAAqB,EACrB,OAAyB,EACzB,MAAe;IAEf,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACxC,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAC1D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,SAAS,CAAC,EAAE,EAAE,cAAc,CAAC,CAAC;QAC9B,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACpB,CAAC;SAAM,CAAC;QACN,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IACpB,CAAC;IACD,SAAS,CAAC,EAAE,EAAE,aAAa,OAAO,CAAC,MAAM,IAAI,UAAU,MAAM,OAAO,CAAC,SAAS,EAAE,CAAC,CAAC;IAClF,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAClB,SAAS,CAAC,EAAE,EAAE,UAAU,CAAC,CAAC;IAE1B,OAAO;QACL,QAAQ,CAAC,KAAK;YACZ,MAAM,OAAO,GAAG;gBACd,CAAC,EAAE,CAAC;gBACJ,EAAE,EAAE,MAAM,EAAE;gBACZ,SAAS,EAAE,OAAO,CAAC,SAAS;gBAC5B,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,YAAY,EAAE,OAAO,CAAC,YAAY;gBAClC,GAAG,KAAK;aACS,CAAC;YACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;YACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;gBAC9B,GAAG,OAAO;gBACV,WAAW,EAAE,QAAQ,CAAC,QAAQ,CAAC;aAChC,CAAC,CAAC;YACH,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QAC1B,CAAC;QACD,KAAK;YACH,SAAS,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;YACrB,EAAE,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/cli/lib/trace-failure-kind.d.ts

@@ -0,0 +1,4 @@
+/** Typed trace verification failure — control flow must branch on this, not UI strings. */
+export type TraceFailureKind = "ambiguous" | "quote_missing" | "worker_log_missing" | "placeholder_quote" | "strict_line_drift" | "empty_quote" | "anchor_mismatch" | "other";
+export declare function classifyTraceFailure(reason: string, traceQuote: string, strictTrace: boolean): TraceFailureKind;
+//# sourceMappingURL=trace-failure-kind.d.ts.map

package/dist/cli/lib/trace-failure-kind.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-failure-kind.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/trace-failure-kind.ts"],"names":[],"mappings":"AAGA,2FAA2F;AAC3F,MAAM,MAAM,gBAAgB,GACxB,WAAW,GACX,eAAe,GACf,oBAAoB,GACpB,mBAAmB,GACnB,mBAAmB,GACnB,aAAa,GACb,iBAAiB,GACjB,OAAO,CAAC;AAEZ,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,OAAO,GACnB,gBAAgB,CAgBlB"}

package/dist/cli/lib/trace-failure-kind.js

@@ -0,0 +1,23 @@
+import { LEGISLATE_TRACE_PLACEHOLDER } from "./mission-legislative-stub.js";
+import { isLineDriftFailure } from "./worker-log-line-map.js";
+export function classifyTraceFailure(reason, traceQuote, strictTrace) {
+    if (reason.startsWith("WORKER_LOG missing:"))
+        return "worker_log_missing";
+    if (reason.includes("Ambiguous"))
+        return "ambiguous";
+    if (reason.includes("not found verbatim")) {
+        if (traceQuote.trim() === LEGISLATE_TRACE_PLACEHOLDER)
+            return "placeholder_quote";
+        return "quote_missing";
+    }
+    if (reason.includes("PASS row has empty"))
+        return "empty_quote";
+    if (strictTrace && isLineDriftFailure(reason))
+        return "strict_line_drift";
+    if (reason.includes("Trace quote not on anchored line") ||
+        reason.includes("No line contains both anchor")) {
+        return "anchor_mismatch";
+    }
+    return "other";
+}
+//# sourceMappingURL=trace-failure-kind.js.map

package/dist/cli/lib/trace-failure-kind.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-failure-kind.js","sourceRoot":"","sources":["../../../src/cli/lib/trace-failure-kind.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAa9D,MAAM,UAAU,oBAAoB,CAClC,MAAc,EACd,UAAkB,EAClB,WAAoB;IAEpB,IAAI,MAAM,CAAC,UAAU,CAAC,qBAAqB,CAAC;QAAE,OAAO,oBAAoB,CAAC;IAC1E,IAAI,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;QAAE,OAAO,WAAW,CAAC;IACrD,IAAI,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC1C,IAAI,UAAU,CAAC,IAAI,EAAE,KAAK,2BAA2B;YAAE,OAAO,mBAAmB,CAAC;QAClF,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,CAAC,oBAAoB,CAAC;QAAE,OAAO,aAAa,CAAC;IAChE,IAAI,WAAW,IAAI,kBAAkB,CAAC,MAAM,CAAC;QAAE,OAAO,mBAAmB,CAAC;IAC1E,IACE,MAAM,CAAC,QAAQ,CAAC,kCAAkC,CAAC;QACnD,MAAM,CAAC,QAAQ,CAAC,8BAA8B,CAAC,EAC/C,CAAC;QACD,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/cli/lib/trace.d.ts

@@ -0,0 +1,25 @@
+import type { TraceRow } from "./types.js";
+export interface TraceVerifyFailure {
+    row: TraceRow;
+    reason: string;
+}
+export interface TraceVerifyWarning {
+    row: TraceRow;
+    declaredLine: number;
+    foundLine: number;
+    autoResolved?: boolean;
+}
+export interface TraceVerifyOptions {
+    /** Force fuzzy for all numeric anchors. */
+    fuzzyNumericAnchor?: boolean;
+    /** Disable auto-retry on line drift only. */
+    strictTrace?: boolean;
+}
+export interface TraceVerifyResult {
+    failures: TraceVerifyFailure[];
+    warnings: TraceVerifyWarning[];
+}
+/** Line numbers are 1-based in mission table; other anchors match a substring on a line */
+export declare function verifyTraceRows(workerLogPath: string, rows: TraceRow[], options?: TraceVerifyOptions): TraceVerifyResult;
+export declare function defaultWorkerLogPath(repoRoot: string): string;
+//# sourceMappingURL=trace.d.ts.map

package/dist/cli/lib/trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/trace.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAQ3C,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,QAAQ,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,QAAQ,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,2CAA2C;IAC3C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,6CAA6C;IAC7C,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAyED,2FAA2F;AAC3F,wBAAgB,eAAe,CAC7B,aAAa,EAAE,MAAM,EACrB,IAAI,EAAE,QAAQ,EAAE,EAChB,OAAO,GAAE,kBAAuB,GAC/B,iBAAiB,CA2DnB;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE7D"}