@jeger-ai/opengantry 1.0.0

package/dist/cli/lib/init-tutorial.js

@@ -0,0 +1,156 @@
+import path from "node:path";
+import fs from "node:fs";
+import { CLI_NAME } from "./constants.js";
+import { logError, logInfo, setExitCode } from "./cli-io.js";
+import { teacherMissionStamped } from "./git-proof.js";
+import { ONBOARDING_ADOPTION_DOC, onboardingRuntimeEnvHint, onboardingStatusHint, onboardingVerifyHint, tutorialTeacherStampBlock, TUTORIAL_INTENT, TUTORIAL_MSN_ID, } from "./onboarding-flow.js";
+import { runStartOrchestration } from "./start-orchestration.js";
+import { loadWorkspace } from "./workspace.js";
+import { runVerify } from "../commands/verify.js";
+function findExistingTutorialMission(repoRoot) {
+    const missionsDir = path.join(repoRoot, ".gitagent", "missions");
+    if (!fs.existsSync(missionsDir))
+        return null;
+    for (const name of fs.readdirSync(missionsDir)) {
+        if (name.startsWith(`${TUTORIAL_MSN_ID}.`) && name.endsWith(".yaml")) {
+            return `.gitagent/missions/${name}`;
+        }
+    }
+    return null;
+}
+function pickTutorialSkillKey(skillKeys) {
+    const preferred = ["logic", "ui", "gapman"];
+    for (const key of preferred) {
+        if (skillKeys.includes(key))
+            return key;
+    }
+    const nonSubstrate = skillKeys.filter((k) => k !== "substrate");
+    return nonSubstrate[0] ?? skillKeys[0] ?? "logic";
+}
+function missionAbsolute(repoRoot, missionRel) {
+    return path.join(repoRoot, missionRel.split("/").join(path.sep));
+}
+async function confirmTeacherStamp(p, repoRoot, missionPath) {
+    while (true) {
+        logInfo(tutorialTeacherStampBlock(missionPath, TUTORIAL_MSN_ID));
+        const ready = await p.confirm({
+            message: "I've run the git commands above (gapman will check git history before continuing)",
+            initialValue: false,
+        });
+        if (p.isCancel(ready) || !ready)
+            return false;
+        if (teacherMissionStamped(repoRoot, missionAbsolute(repoRoot, missionPath), { msnId: TUTORIAL_MSN_ID })) {
+            p.log.success("Teacher stamp OK — [MSN-9001] commit touches this mission file");
+            return true;
+        }
+        p.log.warn("Git-proof not satisfied yet: no allowlisted Teacher commit [MSN-9001] modifying this mission file.");
+        const retry = await p.confirm({
+            message: "Run the commands above in another terminal, then check again?",
+            initialValue: true,
+        });
+        if (p.isCancel(retry) || !retry)
+            return false;
+    }
+}
+function verifyExitOk() {
+    const code = process.exitCode;
+    return code === undefined || code === 0;
+}
+async function scaffoldTutorialMission(p, repoRoot, skillKey) {
+    p.log.step("Step 2 — Scaffold tutorial mission (gapman start)");
+    const existing = findExistingTutorialMission(repoRoot);
+    if (existing) {
+        p.log.message(`Using existing tutorial mission: ${existing}`);
+        return existing;
+    }
+    const start = runStartOrchestration({
+        intent: TUTORIAL_INTENT,
+        msn: TUTORIAL_MSN_ID,
+        skillKey,
+        gateCommand: "gapman check",
+        writeMission: true,
+        silent: true,
+        audience: "teacher",
+    });
+    if (!start.ok || !start.mission_file_path) {
+        logError("Tutorial start failed — run gapman onboarding or pass --skill-key");
+        setExitCode(start.exit_code);
+        p.outro("Tutorial incomplete");
+        return null;
+    }
+    p.log.success(`Mission scaffold: ${start.mission_file_path}`);
+    return start.mission_file_path;
+}
+async function runTutorialVerifyStep(p, missionPath) {
+    p.log.step("Step 5 — Verify");
+    logInfo(`  ${onboardingVerifyHint(missionPath)}`);
+    const runVerifyNow = await p.confirm({
+        message: "Run gapman verify now (git-proof, gate, trace — expect errors until trace is complete)?",
+        initialValue: true,
+    });
+    if (p.isCancel(runVerifyNow) || !runVerifyNow) {
+        return { verifyOk: true, ranVerify: false };
+    }
+    process.exitCode = undefined;
+    await runVerify({
+        mission: missionPath,
+        fix: true,
+        fixNonInteractive: true,
+        audience: "teacher",
+    });
+    const verifyOk = verifyExitOk();
+    if (!verifyOk) {
+        p.log.warn("Verify did not pass yet — expected until gate runs and trace rows cite WORKER_LOG.md");
+    }
+    return { verifyOk, ranVerify: true };
+}
+function emitTutorialOutro(p, missionPath, verifyOk, ranVerify) {
+    if (!verifyOk) {
+        setExitCode(typeof process.exitCode === "number" ? process.exitCode : 1);
+        p.outro(`Tutorial incomplete — finish stamp/trace, then: gapman verify --mission ${missionPath} — see ${ONBOARDING_ADOPTION_DOC}`);
+        return;
+    }
+    if (!ranVerify) {
+        p.outro(`Tutorial paused before verify — run: gapman verify --mission ${missionPath} — see ${ONBOARDING_ADOPTION_DOC}`);
+        return;
+    }
+    p.outro(`Tutorial complete — full loop: ${ONBOARDING_ADOPTION_DOC}`);
+}
+export async function runInitTutorial() {
+    const p = await import("@clack/prompts");
+    const { root: repoRoot, manifest } = loadWorkspace();
+    const manifestPath = path.join(repoRoot, ".gitagent", "foreman", "MANIFEST.json");
+    if (!fs.existsSync(manifestPath)) {
+        logError("init --tutorial: substrate missing — init must complete before tutorial");
+        setExitCode(2);
+        return;
+    }
+    p.intro(`${CLI_NAME} init --tutorial — first mission loop (~3 min)`);
+    const confirm = await p.confirm({
+        message: "Walk through scaffold → Teacher stamp → trace → verify (strict checks)?",
+        initialValue: true,
+    });
+    if (p.isCancel(confirm) || !confirm) {
+        p.cancel("Tutorial skipped");
+        return;
+    }
+    p.log.step("Step 1 — Teacher allowlist");
+    logInfo('  gapman teacher set "$(git config user.email)"');
+    const missionPath = await scaffoldTutorialMission(p, repoRoot, pickTutorialSkillKey(Object.keys(manifest.skills)));
+    if (!missionPath)
+        return;
+    p.log.step("Step 3 — Teacher stamp (manual, required)");
+    if (!(await confirmTeacherStamp(p, repoRoot, missionPath))) {
+        p.note("Verify will fail until git-proof passes. Re-run: gapman verify --mission " + missionPath, "Paused");
+        p.outro(`Tutorial paused — see ${ONBOARDING_ADOPTION_DOC}`);
+        return;
+    }
+    p.log.step("Step 4 — Worker trace");
+    logInfo(`  ${onboardingRuntimeEnvHint(missionPath)}`);
+    logInfo("  Append a unique gate evidence line to WORKER_LOG.md, then set mission trace_row PASS + trace_quote");
+    const { verifyOk, ranVerify } = await runTutorialVerifyStep(p, missionPath);
+    p.log.step("Step 6 — Status dashboard");
+    logInfo(`  ${onboardingStatusHint()}`);
+    emitTutorialOutro(p, missionPath, verifyOk, ranVerify);
+}
+//# sourceMappingURL=init-tutorial.js.map

package/dist/cli/lib/init-tutorial.js.map

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

package/dist/cli/lib/integration-compat.d.ts

@@ -0,0 +1,24 @@
+export declare const INTEGRATION_IDE_KEYS: readonly ["cursor", "claude-code", "codex-cli", "opencode", "junie", "antigravity", "cline", "aider", "openhands"];
+export type IntegrationIdeKey = (typeof INTEGRATION_IDE_KEYS)[number];
+export interface IntegrationCompatEntry {
+    display_name: string;
+    verified_date: string;
+    docs_url: string;
+    recipe_file: string;
+    canonical_paths: string[];
+    deprecated_paths: string[];
+    hooks_schema_version?: number;
+    cli_probe?: string[] | null;
+    disambiguation?: string;
+}
+export interface IntegrationCompatManifest {
+    schema_version: string;
+    opengantry_version: string;
+    integrations: Record<IntegrationIdeKey, IntegrationCompatEntry>;
+}
+export declare function isIntegrationIdeKey(key: string): key is IntegrationIdeKey;
+export declare function resolveTemplateRootFromModule(): string;
+export declare function loadIntegrationCompat(templatesRoot?: string): IntegrationCompatManifest;
+export declare function validateIntegrationCompat(manifest: IntegrationCompatManifest): void;
+export declare function integrationWizardLabel(entry: IntegrationCompatEntry): string;
+//# sourceMappingURL=integration-compat.d.ts.map

package/dist/cli/lib/integration-compat.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-compat.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/integration-compat.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,oHAUvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE,MAAM,WAAW,sBAAsB;IACrC,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,SAAS,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,yBAAyB;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,YAAY,EAAE,MAAM,CAAC,iBAAiB,EAAE,sBAAsB,CAAC,CAAC;CACjE;AAED,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,IAAI,iBAAiB,CAEzE;AAED,wBAAgB,6BAA6B,IAAI,MAAM,CAOtD;AAED,wBAAgB,qBAAqB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,yBAAyB,CAMvF;AAED,wBAAgB,yBAAyB,CAAC,QAAQ,EAAE,yBAAyB,GAAG,IAAI,CAUnF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,sBAAsB,GAAG,MAAM,CAE5E"}

package/dist/cli/lib/integration-compat.js

@@ -0,0 +1,50 @@
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+export const INTEGRATION_IDE_KEYS = [
+    "cursor",
+    "claude-code",
+    "codex-cli",
+    "opencode",
+    "junie",
+    "antigravity",
+    "cline",
+    "aider",
+    "openhands",
+];
+export function isIntegrationIdeKey(key) {
+    return INTEGRATION_IDE_KEYS.includes(key);
+}
+export function resolveTemplateRootFromModule() {
+    const moduleDir = path.dirname(fileURLToPath(import.meta.url));
+    const root = path.resolve(moduleDir, "../../../templates");
+    if (!fs.existsSync(root)) {
+        throw new Error(`missing templates directory at ${root}`);
+    }
+    return root;
+}
+export function loadIntegrationCompat(templatesRoot) {
+    const root = templatesRoot ?? resolveTemplateRootFromModule();
+    const compatPath = path.join(root, "integrations/compatibility.json");
+    const raw = JSON.parse(fs.readFileSync(compatPath, "utf8"));
+    validateIntegrationCompat(raw);
+    return raw;
+}
+export function validateIntegrationCompat(manifest) {
+    if (manifest.schema_version !== "1") {
+        throw new Error(`integration compat: unsupported schema_version ${manifest.schema_version}`);
+    }
+    for (const key of INTEGRATION_IDE_KEYS) {
+        const entry = manifest.integrations[key];
+        if (!entry)
+            throw new Error(`integration compat: missing entry for ${key}`);
+        if (!entry.recipe_file)
+            throw new Error(`integration compat: ${key} missing recipe_file`);
+        if (!entry.display_name)
+            throw new Error(`integration compat: ${key} missing display_name`);
+    }
+}
+export function integrationWizardLabel(entry) {
+    return `${entry.display_name} (verified ${entry.verified_date})`;
+}
+//# sourceMappingURL=integration-compat.js.map

package/dist/cli/lib/integration-compat.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration-compat.js","sourceRoot":"","sources":["../../../src/cli/lib/integration-compat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ;IACR,aAAa;IACb,WAAW;IACX,UAAU;IACV,OAAO;IACP,aAAa;IACb,OAAO;IACP,OAAO;IACP,WAAW;CACH,CAAC;AAsBX,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,OAAQ,oBAA0C,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,oBAAoB,CAAC,CAAC;IAC3D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,kCAAkC,IAAI,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,aAAsB;IAC1D,MAAM,IAAI,GAAG,aAAa,IAAI,6BAA6B,EAAE,CAAC;IAC9D,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,iCAAiC,CAAC,CAAC;IACtE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,CAAC,CAA8B,CAAC;IACzF,yBAAyB,CAAC,GAAG,CAAC,CAAC;IAC/B,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,QAAmC;IAC3E,IAAI,QAAQ,CAAC,cAAc,KAAK,GAAG,EAAE,CAAC;QACpC,MAAM,IAAI,KAAK,CAAC,kDAAkD,QAAQ,CAAC,cAAc,EAAE,CAAC,CAAC;IAC/F,CAAC;IACD,KAAK,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;QACvC,MAAM,KAAK,GAAG,QAAQ,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACzC,IAAI,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,GAAG,EAAE,CAAC,CAAC;QAC5E,IAAI,CAAC,KAAK,CAAC,WAAW;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,sBAAsB,CAAC,CAAC;QAC1F,IAAI,CAAC,KAAK,CAAC,YAAY;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,uBAAuB,CAAC,CAAC;IAC9F,CAAC;AACH,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,KAA6B;IAClE,OAAO,GAAG,KAAK,CAAC,YAAY,cAAc,KAAK,CAAC,aAAa,GAAG,CAAC;AACnE,CAAC"}

package/dist/cli/lib/legislate-skill.d.ts

@@ -0,0 +1,20 @@
+import type { Manifest } from "./types.js";
+import type { TriageResult } from "./types.js";
+export declare function isTriageEscalated(triage: TriageResult): boolean;
+export type ResolveSkillKeyResult = {
+    ok: true;
+    skillKey: string;
+    triage: TriageResult;
+} | {
+    ok: false;
+    triage: TriageResult;
+    reason: string;
+    kind: "unknown_skill" | "escalated";
+};
+export declare function resolveSkillKeyForLegislation(opts: {
+    root: string;
+    manifest: Manifest;
+    intent: string;
+    skillKey?: string;
+}): ResolveSkillKeyResult;
+//# sourceMappingURL=legislate-skill.d.ts.map

package/dist/cli/lib/legislate-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legislate-skill.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/legislate-skill.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG/C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAE/D;AAED,MAAM,MAAM,qBAAqB,GAC7B;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACpD;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,YAAY,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,eAAe,GAAG,WAAW,CAAA;CAAE,CAAC;AAE7F,wBAAgB,6BAA6B,CAAC,IAAI,EAAE;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,qBAAqB,CAyBxB"}

package/dist/cli/lib/legislate-skill.js

@@ -0,0 +1,30 @@
+import { triageIntent } from "./triage-logic.js";
+export function isTriageEscalated(triage) {
+    return triage.action !== "DIRECT_EXECUTION" || triage.skill_key === "NONE";
+}
+export function resolveSkillKeyForLegislation(opts) {
+    const explicit = opts.skillKey?.trim();
+    if (explicit) {
+        if (!opts.manifest.skills[explicit]) {
+            return {
+                ok: false,
+                triage: triageIntent(opts.root, opts.intent, opts.manifest),
+                reason: `unknown skill_key "${explicit}" (manifest skills: ${Object.keys(opts.manifest.skills).join(", ")})`,
+                kind: "unknown_skill",
+            };
+        }
+        const triage = triageIntent(opts.root, opts.intent, opts.manifest);
+        return { ok: true, skillKey: explicit, triage };
+    }
+    const triage = triageIntent(opts.root, opts.intent, opts.manifest);
+    if (isTriageEscalated(triage)) {
+        return {
+            ok: false,
+            triage,
+            reason: `triage escalation — ${triage.reason}. Pass --skill-key <manifest skill> after Teacher assigns scope.`,
+            kind: "escalated",
+        };
+    }
+    return { ok: true, skillKey: triage.skill_key, triage };
+}
+//# sourceMappingURL=legislate-skill.js.map

package/dist/cli/lib/legislate-skill.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"legislate-skill.js","sourceRoot":"","sources":["../../../src/cli/lib/legislate-skill.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,MAAM,UAAU,iBAAiB,CAAC,MAAoB;IACpD,OAAO,MAAM,CAAC,MAAM,KAAK,kBAAkB,IAAI,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC;AAC7E,CAAC;AAMD,MAAM,UAAU,6BAA6B,CAAC,IAK7C;IACC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC;IACvC,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpC,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC;gBAC3D,MAAM,EAAE,sBAAsB,QAAQ,uBAAuB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;gBAC5G,IAAI,EAAE,eAAe;aACtB,CAAC;QACJ,CAAC;QACD,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACnE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;IAClD,CAAC;IAED,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACnE,IAAI,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAAC;QAC9B,OAAO;YACL,EAAE,EAAE,KAAK;YACT,MAAM;YACN,MAAM,EAAE,uBAAuB,MAAM,CAAC,MAAM,kEAAkE;YAC9G,IAAI,EAAE,WAAW;SAClB,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;AAC1D,CAAC"}

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

@@ -0,0 +1,6 @@
+import type { Manifest } from "./types.js";
+export declare function manifestPath(root: string): string;
+export declare function loadManifest(root: string): Manifest;
+/** Mirrors scripts/validate-gxt.sh manifest checks */
+export declare function validateManifestShape(m: unknown): asserts m is Manifest;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/manifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAQnD;AAED,sDAAsD;AACtD,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,IAAI,QAAQ,CA2BvE"}

package/dist/cli/lib/manifest.js

@@ -0,0 +1,53 @@
+import fs from "node:fs";
+import path from "node:path";
+import { REL_MANIFEST } from "./constants.js";
+export function manifestPath(root) {
+    return path.join(root, REL_MANIFEST);
+}
+export function loadManifest(root) {
+    const p = manifestPath(root);
+    if (!fs.existsSync(p)) {
+        throw new Error(`gapman: missing ${REL_MANIFEST}`);
+    }
+    const raw = JSON.parse(fs.readFileSync(p, "utf8"));
+    validateManifestShape(raw);
+    return raw;
+}
+/** Mirrors scripts/validate-gxt.sh manifest checks */
+export function validateManifestShape(m) {
+    if (typeof m !== "object" || m === null)
+        throw new Error("MANIFEST: not an object");
+    const o = m;
+    if (typeof o.schema_version !== "string" || o.schema_version.length === 0) {
+        throw new Error("MANIFEST: schema_version must be a non-empty string");
+    }
+    if (typeof o.skills !== "object" || o.skills === null || Array.isArray(o.skills)) {
+        throw new Error("MANIFEST: skills must be an object");
+    }
+    const skills = o.skills;
+    if (Object.keys(skills).length === 0)
+        throw new Error("MANIFEST: skills must be non-empty");
+    if (typeof o.path_risks !== "object" || o.path_risks === null || Array.isArray(o.path_risks)) {
+        throw new Error("MANIFEST: path_risks must be an object");
+    }
+    if (!Array.isArray(o.risk_keywords))
+        throw new Error("MANIFEST: risk_keywords must be an array");
+    for (const k of Object.keys(skills)) {
+        const s = skills[k];
+        if (typeof s !== "object" || s === null)
+            throw new Error(`MANIFEST: skills.${k} must be an object`);
+        const sk = s;
+        if (!("trust_threshold" in sk))
+            throw new Error(`MANIFEST: skills.${k} missing trust_threshold`);
+        if (!("tmvc_roots" in sk))
+            throw new Error(`MANIFEST: skills.${k} missing tmvc_roots`);
+        if (!("forbidden_zones" in sk))
+            throw new Error(`MANIFEST: skills.${k} missing forbidden_zones`);
+        if (!Array.isArray(sk.tmvc_roots))
+            throw new Error(`MANIFEST: skills.${k}.tmvc_roots must be array`);
+        if (!Array.isArray(sk.forbidden_zones)) {
+            throw new Error(`MANIFEST: skills.${k}.forbidden_zones must be array`);
+        }
+    }
+}
+//# sourceMappingURL=manifest.js.map

package/dist/cli/lib/manifest.js.map

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

package/dist/cli/lib/mcp-legislation.d.ts

@@ -0,0 +1,82 @@
+export type McpToolStatus = "awaiting_human_approval" | "pending_signature" | "signature_valid" | "signature_missing" | "error";
+export interface McpErrorBody {
+    code: string;
+    message: string;
+    retryable: boolean;
+}
+export interface DraftLegislationInput {
+    title: string;
+    msn_id: string;
+    skill_key: string;
+    gate_command: string;
+    gate_success_substring?: string;
+}
+export interface DraftLegislationResult {
+    status: "awaiting_human_approval";
+    draft_token: string;
+    chat_message_to_user: string;
+    expires_at: string;
+    requires_teacher_commit: true;
+}
+export interface ExecuteLegislationResult {
+    status: "pending_signature";
+    msn_id: string;
+    mission_file_path: string;
+    suggested_human_action: string;
+    commit_message: string;
+    commit_target: string;
+    requires_teacher_commit: true;
+    next_tool: "gxt_check_signature";
+}
+export interface CheckSignatureResult {
+    status: "signature_valid" | "signature_missing";
+    msn_id: string;
+    mission_file_path: string;
+    message: string;
+    next_tools?: string[];
+}
+export type PinMissionResult = {
+    status: "pinned";
+    mission_file_path: string;
+    message: string;
+} | {
+    status: "error";
+    error: McpErrorBody;
+};
+export type ResolveMissionResult = {
+    status: "resolved";
+    mission_file_path: string;
+} | {
+    status: "unpinned";
+    mission_file_path: null;
+    message: string;
+};
+export type LastErrorResult = {
+    status: "empty";
+    message: string;
+} | {
+    status: "found";
+    payload: Record<string, unknown>;
+} | {
+    status: "error";
+    message: string;
+};
+export declare function handleDraftLegislation(input: DraftLegislationInput): DraftLegislationResult | {
+    status: "error";
+    error: McpErrorBody;
+};
+export declare function handleExecuteLegislation(draftToken: string): ExecuteLegislationResult | {
+    status: "error";
+    error: McpErrorBody;
+};
+export declare function handleCheckSignature(missionFilePath: string): CheckSignatureResult | {
+    status: "error";
+    error: McpErrorBody;
+};
+export declare function handlePinMission(missionFilePath: string): PinMissionResult | {
+    status: "error";
+    error: McpErrorBody;
+};
+export declare function handleResolveMission(explicit?: string): ResolveMissionResult;
+export declare function handleLastError(): LastErrorResult;
+//# sourceMappingURL=mcp-legislation.d.ts.map

package/dist/cli/lib/mcp-legislation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-legislation.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/mcp-legislation.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,aAAa,GACrB,yBAAyB,GACzB,mBAAmB,GACnB,iBAAiB,GACjB,mBAAmB,GACnB,OAAO,CAAC;AAEZ,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,yBAAyB,CAAC;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,uBAAuB,EAAE,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,MAAM,EAAE,mBAAmB,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,uBAAuB,EAAE,IAAI,CAAC;IAC9B,SAAS,EAAE,qBAAqB,CAAC;CAClC;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,iBAAiB,GAAG,mBAAmB,CAAC;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAAC;AAE7C,MAAM,MAAM,oBAAoB,GAC5B;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,GACjD;IACE,MAAM,EAAE,UAAU,CAAC;IACnB,iBAAiB,EAAE,IAAI,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEN,MAAM,MAAM,eAAe,GACvB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GACrD;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC;AA8CzC,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,qBAAqB,GAC3B,sBAAsB,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CA6BnE;AAED,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,GACjB,wBAAwB,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAwCrE;AAED,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,MAAM,GACtB,oBAAoB,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CA8BjE;AAED,wBAAgB,gBAAgB,CAAC,eAAe,EAAE,MAAM,GAAG,gBAAgB,GAAG;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAcrH;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,oBAAoB,CAgB5E;AAED,wBAAgB,eAAe,IAAI,eAAe,CAYjD"}

package/dist/cli/lib/mcp-legislation.js

@@ -0,0 +1,181 @@
+import fs from "node:fs";
+import path from "node:path";
+import { runLegislate } from "../commands/legislate.js";
+import { formatRepoRelative } from "./cli-io.js";
+import { MSN_ID_PATTERN } from "./constants.js";
+import { DraftTokenError, createDraftToken, verifyDraftToken } from "./draft-token.js";
+import { assertTeacherMissionProof } from "./git-proof.js";
+import { pinMissionFile, resolveMissionFilePath, } from "./mission-path.js";
+import { resolvePinnedMission } from "./mission-resolution.js";
+import { GapmanUserError } from "./user-error.js";
+import { loadWorkspace } from "./workspace.js";
+function mcpError(code, message, retryable) {
+    return { status: "error", error: { code, message, retryable } };
+}
+function buildDraftChatMessage(input, manifestSkillDesc) {
+    const lines = [
+        "## Proposed GXT mission (draft — not yet written)",
+        "",
+        `- **Title:** ${input.title}`,
+        `- **MSN:** ${input.msn_id}`,
+        `- **Skill:** ${input.skill_key}`,
+        `- **Gate:** \`${input.gate_command}\``,
+    ];
+    if (input.gate_success_substring?.trim()) {
+        lines.push(`- **Gate success substring:** \`${input.gate_success_substring.trim()}\``);
+    }
+    if (manifestSkillDesc) {
+        lines.push(`- **Skill scope:** ${manifestSkillDesc}`);
+    }
+    lines.push("", "Reply with clear approval (e.g. **yes**, **approve**, **looks good**) to execute legislation, or **deny** / **no** to cancel.", "", "_No mission file will be written until you approve._");
+    return lines.join("\n");
+}
+function validateDraftInput(input) {
+    if (!input.title?.trim()) {
+        return { code: "VALIDATION_ERROR", message: "title is required", retryable: true };
+    }
+    if (!MSN_ID_PATTERN.test(input.msn_id?.trim() ?? "")) {
+        return { code: "VALIDATION_ERROR", message: 'msn_id must match "MSN-0007"', retryable: true };
+    }
+    if (!input.skill_key?.trim()) {
+        return { code: "VALIDATION_ERROR", message: "skill_key is required", retryable: true };
+    }
+    if (!input.gate_command?.trim()) {
+        return { code: "VALIDATION_ERROR", message: "gate_command is required", retryable: true };
+    }
+    return null;
+}
+export function handleDraftLegislation(input) {
+    const validation = validateDraftInput(input);
+    if (validation)
+        return mcpError(validation.code, validation.message, validation.retryable);
+    const { root, manifest } = loadWorkspace();
+    const skillKey = input.skill_key.trim();
+    if (!manifest.skills[skillKey]) {
+        return mcpError("UNKNOWN_SKILL", `unknown skill_key "${skillKey}" (manifest skills: ${Object.keys(manifest.skills).join(", ")})`, true);
+    }
+    const token = createDraftToken(root, {
+        title: input.title,
+        msn_id: input.msn_id.trim(),
+        skill_key: skillKey,
+        gate_command: input.gate_command,
+        gate_success_substring: input.gate_success_substring,
+    });
+    return {
+        status: "awaiting_human_approval",
+        draft_token: token.draft_token,
+        chat_message_to_user: buildDraftChatMessage(input, manifest.skills[skillKey]?.desc),
+        expires_at: token.expires_at,
+        requires_teacher_commit: true,
+    };
+}
+export function handleExecuteLegislation(draftToken) {
+    const { root } = loadWorkspace();
+    let payload;
+    try {
+        payload = verifyDraftToken(root, draftToken, { consume: true });
+    }
+    catch (err) {
+        if (err instanceof DraftTokenError) {
+            return mcpError(err.code, err.message, err.retryable);
+        }
+        throw err;
+    }
+    const legislateOpts = {
+        intent: payload.title,
+        msn: payload.msn_id,
+        skillKey: payload.skill_key,
+        gateCommand: payload.gate_command,
+        gateSuccessSubstring: payload.gate_success_substring,
+    };
+    const result = runLegislate(legislateOpts);
+    if (!result.ok) {
+        return mcpError("LEGISLATE_FAILED", "gapman legislate failed; check skill_key, msn, or output path", true);
+    }
+    const missionRel = formatRepoRelative(root, result.missionAbs);
+    const commitMessage = `[${payload.msn_id}] Legislate ${payload.title.replace(/"/g, '\\"')}`;
+    const suggestedHumanAction = `git add ${missionRel} && git commit -m "${commitMessage}"`;
+    return {
+        status: "pending_signature",
+        msn_id: payload.msn_id,
+        mission_file_path: missionRel,
+        suggested_human_action: suggestedHumanAction,
+        commit_message: commitMessage,
+        commit_target: missionRel,
+        requires_teacher_commit: true,
+        next_tool: "gxt_check_signature",
+    };
+}
+export function handleCheckSignature(missionFilePath) {
+    const { root } = loadWorkspace();
+    const missionAbs = resolveMissionFilePath(root, missionFilePath);
+    if (!fs.existsSync(missionAbs)) {
+        return mcpError("MISSION_NOT_FOUND", `mission file not found: ${missionFilePath}`, true);
+    }
+    try {
+        const msnId = assertTeacherMissionProof(root, missionAbs);
+        const rel = formatRepoRelative(root, missionAbs);
+        return {
+            status: "signature_valid",
+            msn_id: msnId,
+            mission_file_path: rel,
+            message: `Teacher signature valid for ${msnId}. You may pin the mission and begin worker execution.`,
+            next_tools: ["gxt_pin_mission", "gxt_runtime_env"],
+        };
+    }
+    catch (err) {
+        if (err instanceof GapmanUserError) {
+            return {
+                status: "signature_missing",
+                msn_id: "unknown",
+                mission_file_path: formatRepoRelative(root, missionAbs),
+                message: err.message,
+                next_tools: [],
+            };
+        }
+        throw err;
+    }
+}
+export function handlePinMission(missionFilePath) {
+    const { root } = loadWorkspace();
+    const missionAbs = resolveMissionFilePath(root, missionFilePath);
+    if (!fs.existsSync(missionAbs)) {
+        return mcpError("MISSION_NOT_FOUND", `mission file not found: ${missionFilePath}`, true);
+    }
+    const rel = pinMissionFile(root, missionAbs);
+    return {
+        status: "pinned",
+        mission_file_path: rel,
+        message: `Pinned active mission: ${rel}`,
+    };
+}
+export function handleResolveMission(explicit) {
+    const { root } = loadWorkspace();
+    const resolved = resolvePinnedMission(root, {
+        explicit,
+        profile: "full",
+    });
+    if (resolved) {
+        return { status: "resolved", mission_file_path: resolved };
+    }
+    return {
+        status: "unpinned",
+        mission_file_path: null,
+        message: "No active mission pinned. Run Mission Architect / gxt_draft_legislation first.",
+    };
+}
+export function handleLastError() {
+    const { root } = loadWorkspace();
+    const errPath = path.join(root, ".gitagent", "history", ".ignored-last-error.json");
+    if (!fs.existsSync(errPath)) {
+        return { status: "empty", message: "No last error recorded." };
+    }
+    try {
+        const payload = JSON.parse(fs.readFileSync(errPath, "utf8"));
+        return { status: "found", payload };
+    }
+    catch {
+        return { status: "error", message: "Failed to parse last error file." };
+    }
+}
+//# sourceMappingURL=mcp-legislation.js.map