@jeger-ai/opengantry 1.0.0

package/dist/cli/lib/architecture-pointer-doctor.js

@@ -0,0 +1,114 @@
+import fs from "node:fs";
+import path from "node:path";
+import { REL_ARCHITECTURE_POINTER } from "./constants.js";
+import { loadArchitectureCredential, } from "./architecture-credential.js";
+import { architecturePointerPath, loadArchitecturePointer, } from "./architecture-pointer-schema.js";
+import { architectureRequiresDiscovery, resolveArchitectureAccessSkill, resolveArchitectureDiscoverySkill, } from "./architecture-pointer-discovery.js";
+function doctorCheckArchitectureAccess(repoRoot, pointer) {
+    const lines = [];
+    if (!pointer.access?.required)
+        return lines;
+    const skillRel = resolveArchitectureAccessSkill(pointer);
+    const skillAbs = path.join(repoRoot, skillRel.split("/").join(path.sep));
+    if (!fs.existsSync(skillAbs)) {
+        lines.push({ level: "warn", message: `architecture access skill missing: ${skillRel}` });
+    }
+    else {
+        lines.push({ level: "ok", message: `architecture access skill: ${skillRel}` });
+    }
+    if (!pointer.access.credential_slot)
+        return lines;
+    const cred = loadArchitectureCredential(repoRoot, pointer.access.credential_slot);
+    if (cred) {
+        lines.push({
+            level: "ok",
+            message: `architecture credential slot stored: ${pointer.access.credential_slot} (${cred.kind})`,
+        });
+    }
+    else {
+        lines.push({
+            level: "warn",
+            message: `architecture credential not stored for slot ${pointer.access.credential_slot} — agent must configure auth before reading external docs`,
+        });
+    }
+    return lines;
+}
+function doctorCheckArchitectureTarget(repoRoot, pointer) {
+    const lines = [];
+    if (pointer.kind === "external") {
+        const looksLikeUrl = /^https?:\/\//i.test(pointer.location);
+        if (!looksLikeUrl) {
+            lines.push({
+                level: "warn",
+                message: `external architecture location is not an http(s) URL — follow read_hint: ${pointer.read_hint}`,
+            });
+        }
+        return lines;
+    }
+    const targetAbs = path.resolve(repoRoot, pointer.location.split("/").join(path.sep));
+    const rootResolved = path.resolve(repoRoot);
+    if (targetAbs !== rootResolved && !targetAbs.startsWith(`${rootResolved}${path.sep}`)) {
+        lines.push({ level: "fail", message: "architecture pointer location escapes repo root" });
+        return lines;
+    }
+    if (!fs.existsSync(targetAbs)) {
+        lines.push({
+            level: "warn",
+            message: `architecture ${pointer.kind} not found at ${pointer.location}`,
+        });
+        return lines;
+    }
+    if (pointer.kind === "file" && !fs.statSync(targetAbs).isFile()) {
+        lines.push({ level: "warn", message: `architecture pointer kind=file but ${pointer.location} is not a file` });
+    }
+    if (pointer.kind === "directory" && !fs.statSync(targetAbs).isDirectory()) {
+        lines.push({
+            level: "warn",
+            message: `architecture pointer kind=directory but ${pointer.location} is not a directory`,
+        });
+    }
+    return lines;
+}
+export function runArchitecturePointerDoctorChecks(repoRoot) {
+    const lines = [];
+    const abs = architecturePointerPath(repoRoot);
+    if (!fs.existsSync(abs)) {
+        lines.push({
+            level: "warn",
+            message: `${REL_ARCHITECTURE_POINTER} missing — agents cannot discover code layout`,
+        });
+        return lines;
+    }
+    let pointer;
+    try {
+        pointer = loadArchitecturePointer(repoRoot);
+    }
+    catch (e) {
+        lines.push({
+            level: "fail",
+            message: e instanceof Error ? e.message : String(e),
+        });
+        return lines;
+    }
+    if (pointer.kind === "unset") {
+        lines.push({
+            level: "warn",
+            message: "architecture pointer kind=unset — agents must ask user before implementing (see ARCHITECTURE-DISCOVERY.md)",
+        });
+        return lines;
+    }
+    lines.push({
+        level: "ok",
+        message: `architecture pointer: kind=${pointer.kind} location=${pointer.location}`,
+    });
+    if (architectureRequiresDiscovery(repoRoot, pointer)) {
+        lines.push({
+            level: "warn",
+            message: `architecture incomplete or stub — agents must follow ${resolveArchitectureDiscoverySkill(pointer)} before implementing`,
+        });
+    }
+    lines.push(...doctorCheckArchitectureAccess(repoRoot, pointer));
+    lines.push(...doctorCheckArchitectureTarget(repoRoot, pointer));
+    return lines;
+}
+//# sourceMappingURL=architecture-pointer-doctor.js.map

package/dist/cli/lib/architecture-pointer-doctor.js.map

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

package/dist/cli/lib/architecture-pointer-schema.d.ts

@@ -0,0 +1,5 @@
+import { type ArchitecturePointer } from "./architecture-pointer-types.js";
+export declare function architecturePointerPath(repoRoot: string): string;
+export declare function validateArchitecturePointer(raw: unknown): ArchitecturePointer;
+export declare function loadArchitecturePointer(repoRoot: string): ArchitecturePointer;
+//# sourceMappingURL=architecture-pointer-schema.d.ts.map

package/dist/cli/lib/architecture-pointer-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-pointer-schema.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/architecture-pointer-schema.ts"],"names":[],"mappings":"AAGA,OAAO,EAKL,KAAK,mBAAmB,EACzB,MAAM,iCAAiC,CAAC;AAIzC,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEhE;AA4ED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,OAAO,GAAG,mBAAmB,CAwC7E;AAED,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG,mBAAmB,CAY7E"}

package/dist/cli/lib/architecture-pointer-schema.js

@@ -0,0 +1,137 @@
+import fs from "node:fs";
+import path from "node:path";
+import { REL_ARCHITECTURE_POINTER } from "./constants.js";
+import { ARCHITECTURE_POINTER_SCHEMA_VERSION, } from "./architecture-pointer-types.js";
+const VALID_KINDS = new Set(["file", "directory", "external", "unset"]);
+export function architecturePointerPath(repoRoot) {
+    return path.join(repoRoot, REL_ARCHITECTURE_POINTER.split("/").join(path.sep));
+}
+function validateDiscovery(raw) {
+    if (raw == null || typeof raw !== "object") {
+        throw new Error("architecture pointer: discovery must be an object");
+    }
+    const o = raw;
+    const discovery = {};
+    if (o.skill != null) {
+        if (typeof o.skill !== "string" || !o.skill.trim()) {
+            throw new Error("architecture pointer: discovery.skill invalid");
+        }
+        if (o.skill.includes(".."))
+            throw new Error("architecture pointer: discovery.skill must not contain ..");
+        discovery.skill = o.skill.trim().replace(/\\/g, "/");
+    }
+    return discovery;
+}
+function validateAccess(raw) {
+    if (raw == null || typeof raw !== "object") {
+        throw new Error("architecture pointer: access must be an object");
+    }
+    const o = raw;
+    if (typeof o.required !== "boolean") {
+        throw new Error("architecture pointer: access.required must be boolean");
+    }
+    const access = { required: o.required };
+    if (o.tool != null) {
+        if (typeof o.tool !== "string" || !o.tool.trim())
+            throw new Error("architecture pointer: access.tool invalid");
+        access.tool = o.tool.trim();
+    }
+    if (o.skill != null) {
+        if (typeof o.skill !== "string" || !o.skill.trim())
+            throw new Error("architecture pointer: access.skill invalid");
+        if (o.skill.includes(".."))
+            throw new Error("architecture pointer: access.skill must not contain ..");
+        access.skill = o.skill.trim().replace(/\\/g, "/");
+    }
+    if (o.credential_slot != null) {
+        if (typeof o.credential_slot !== "string" || !o.credential_slot.trim()) {
+            throw new Error("architecture pointer: access.credential_slot invalid");
+        }
+        access.credential_slot = o.credential_slot.trim();
+    }
+    if (o.auth_hint != null) {
+        if (typeof o.auth_hint !== "string" || !o.auth_hint.trim()) {
+            throw new Error("architecture pointer: access.auth_hint invalid");
+        }
+        access.auth_hint = o.auth_hint.trim();
+    }
+    if (o.detect != null) {
+        if (!Array.isArray(o.detect) || o.detect.some((d) => typeof d !== "string" || !d.trim())) {
+            throw new Error("architecture pointer: access.detect must be string array");
+        }
+        access.detect = o.detect.map((d) => d.trim()).filter(Boolean);
+    }
+    return access;
+}
+function validatePointerLocation(docKind, location) {
+    const loc = location.trim();
+    if (docKind !== "unset" && loc.length === 0) {
+        throw new Error("architecture pointer: location required unless kind is unset");
+    }
+    if (loc.includes("..")) {
+        throw new Error("architecture pointer: location must not contain ..");
+    }
+    const isUrl = /^https?:\/\//i.test(loc);
+    if (docKind === "external") {
+        if (path.isAbsolute(loc) && !isUrl) {
+            throw new Error("architecture pointer: external location must be http(s) URL or repo-relative MCP id");
+        }
+    }
+    else if (docKind !== "unset" && path.isAbsolute(loc)) {
+        throw new Error("architecture pointer: location must be repo-relative");
+    }
+    return loc;
+}
+export function validateArchitecturePointer(raw) {
+    if (raw == null || typeof raw !== "object") {
+        throw new Error("architecture pointer must be a JSON object");
+    }
+    const o = raw;
+    const schema_version = o.schema_version;
+    const kind = o.kind;
+    const location = o.location;
+    const read_hint = o.read_hint;
+    if (typeof schema_version !== "string" || schema_version.length === 0) {
+        throw new Error("architecture pointer: schema_version required");
+    }
+    if (schema_version !== ARCHITECTURE_POINTER_SCHEMA_VERSION) {
+        throw new Error(`architecture pointer: unsupported schema_version ${schema_version} (expected ${ARCHITECTURE_POINTER_SCHEMA_VERSION})`);
+    }
+    if (typeof kind !== "string" || !VALID_KINDS.has(kind)) {
+        throw new Error("architecture pointer: kind must be unset, file, directory, or external");
+    }
+    if (typeof location !== "string") {
+        throw new Error("architecture pointer: location must be a string");
+    }
+    if (typeof read_hint !== "string" || read_hint.trim().length === 0) {
+        throw new Error("architecture pointer: read_hint required");
+    }
+    const docKind = kind;
+    const loc = validatePointerLocation(docKind, location);
+    const pointer = {
+        schema_version,
+        kind: docKind,
+        location: loc,
+        read_hint: read_hint.trim(),
+    };
+    if (o.access != null)
+        pointer.access = validateAccess(o.access);
+    if (o.discovery != null)
+        pointer.discovery = validateDiscovery(o.discovery);
+    return pointer;
+}
+export function loadArchitecturePointer(repoRoot) {
+    const abs = architecturePointerPath(repoRoot);
+    if (!fs.existsSync(abs)) {
+        throw new Error(`${REL_ARCHITECTURE_POINTER} missing — run gapman init or add the pointer manually`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(abs, "utf8"));
+    }
+    catch {
+        throw new Error(`${REL_ARCHITECTURE_POINTER} is not valid JSON`);
+    }
+    return validateArchitecturePointer(parsed);
+}
+//# sourceMappingURL=architecture-pointer-schema.js.map

package/dist/cli/lib/architecture-pointer-schema.js.map

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

package/dist/cli/lib/architecture-pointer-types.d.ts

@@ -0,0 +1,24 @@
+export type ArchitectureDocKind = "file" | "directory" | "external" | "unset";
+export interface ArchitectureDiscovery {
+    skill?: string;
+}
+export interface ArchitectureAccess {
+    required: boolean;
+    tool?: string;
+    skill?: string;
+    credential_slot?: string;
+    auth_hint?: string;
+    detect?: string[];
+}
+export interface ArchitecturePointer {
+    schema_version: string;
+    kind: ArchitectureDocKind;
+    location: string;
+    read_hint: string;
+    access?: ArchitectureAccess;
+    discovery?: ArchitectureDiscovery;
+}
+export declare const ARCHITECTURE_POINTER_SCHEMA_VERSION: "0.1.0";
+/** Init stub markers — file content matching these still requires discovery. */
+export declare const ARCHITECTURE_STUB_MARKERS: readonly ["Replace this section with your project structure", "Your architecture notes"];
+//# sourceMappingURL=architecture-pointer-types.d.ts.map

package/dist/cli/lib/architecture-pointer-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-pointer-types.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/architecture-pointer-types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;AAE9E,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,IAAI,EAAE,mBAAmB,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAC5B,SAAS,CAAC,EAAE,qBAAqB,CAAC;CACnC;AAED,eAAO,MAAM,mCAAmC,EAAG,OAAgB,CAAC;AAEpE,gFAAgF;AAChF,eAAO,MAAM,yBAAyB,0FAG5B,CAAC"}

package/dist/cli/lib/architecture-pointer-types.js

@@ -0,0 +1,7 @@
+export const ARCHITECTURE_POINTER_SCHEMA_VERSION = "0.1.0";
+/** Init stub markers — file content matching these still requires discovery. */
+export const ARCHITECTURE_STUB_MARKERS = [
+    "Replace this section with your project structure",
+    "Your architecture notes",
+];
+//# sourceMappingURL=architecture-pointer-types.js.map

package/dist/cli/lib/architecture-pointer-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-pointer-types.js","sourceRoot":"","sources":["../../../src/cli/lib/architecture-pointer-types.ts"],"names":[],"mappings":"AAwBA,MAAM,CAAC,MAAM,mCAAmC,GAAG,OAAgB,CAAC;AAEpE,gFAAgF;AAChF,MAAM,CAAC,MAAM,yBAAyB,GAAG;IACvC,kDAAkD;IAClD,yBAAyB;CACjB,CAAC"}

package/dist/cli/lib/architecture-pointer.d.ts

@@ -0,0 +1,7 @@
+export type { ArchitectureAccess, ArchitectureDiscovery, ArchitectureDocKind, ArchitecturePointer, } from "./architecture-pointer-types.js";
+export { ARCHITECTURE_POINTER_SCHEMA_VERSION, ARCHITECTURE_STUB_MARKERS, } from "./architecture-pointer-types.js";
+export { architecturePointerPath, loadArchitecturePointer, validateArchitecturePointer, } from "./architecture-pointer-schema.js";
+export { architectureFileIsStub, architectureRequiresDiscovery, resolveArchitectureAccessSkill, resolveArchitectureDiscoverySkill, summarizeArchitecturePointer, } from "./architecture-pointer-discovery.js";
+export { runArchitecturePointerDoctorChecks } from "./architecture-pointer-doctor.js";
+export declare function architectureCredentialConfigured(repoRoot: string, slot: string): boolean;
+//# sourceMappingURL=architecture-pointer.d.ts.map

package/dist/cli/lib/architecture-pointer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-pointer.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/architecture-pointer.ts"],"names":[],"mappings":"AAGA,YAAY,EACV,kBAAkB,EAClB,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,mCAAmC,EACnC,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,8BAA8B,EAC9B,iCAAiC,EACjC,4BAA4B,GAC7B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,kCAAkC,EAAE,MAAM,kCAAkC,CAAC;AAEtF,wBAAgB,gCAAgC,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAExF"}

package/dist/cli/lib/architecture-pointer.js

@@ -0,0 +1,10 @@
+import fs from "node:fs";
+import { architectureCredentialPath } from "./architecture-credential.js";
+export { ARCHITECTURE_POINTER_SCHEMA_VERSION, ARCHITECTURE_STUB_MARKERS, } from "./architecture-pointer-types.js";
+export { architecturePointerPath, loadArchitecturePointer, validateArchitecturePointer, } from "./architecture-pointer-schema.js";
+export { architectureFileIsStub, architectureRequiresDiscovery, resolveArchitectureAccessSkill, resolveArchitectureDiscoverySkill, summarizeArchitecturePointer, } from "./architecture-pointer-discovery.js";
+export { runArchitecturePointerDoctorChecks } from "./architecture-pointer-doctor.js";
+export function architectureCredentialConfigured(repoRoot, slot) {
+    return fs.existsSync(architectureCredentialPath(repoRoot, slot));
+}
+//# sourceMappingURL=architecture-pointer.js.map

package/dist/cli/lib/architecture-pointer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"architecture-pointer.js","sourceRoot":"","sources":["../../../src/cli/lib/architecture-pointer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAQ1E,OAAO,EACL,mCAAmC,EACnC,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,uBAAuB,EACvB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EACL,sBAAsB,EACtB,6BAA6B,EAC7B,8BAA8B,EAC9B,iCAAiC,EACjC,4BAA4B,GAC7B,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,kCAAkC,EAAE,MAAM,kCAAkC,CAAC;AAEtF,MAAM,UAAU,gCAAgC,CAAC,QAAgB,EAAE,IAAY;IAC7E,OAAO,EAAE,CAAC,UAAU,CAAC,0BAA0B,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;AACnE,CAAC"}

package/dist/cli/lib/atomic-fs.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Promote staged file to target; rename-first with retry, safe copy-via-.tmp fallback.
+ * Production target is never partially overwritten on copy failure.
+ */
+export declare function promoteFileAtomic(stagedPath: string, targetPath: string, opts?: {
+    retries?: number;
+    backoffMs?: number;
+}): Promise<void>;
+//# sourceMappingURL=atomic-fs.d.ts.map

package/dist/cli/lib/atomic-fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-fs.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/atomic-fs.ts"],"names":[],"mappings":"AA8BA;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAClD,OAAO,CAAC,IAAI,CAAC,CA4Bf"}

package/dist/cli/lib/atomic-fs.js

@@ -0,0 +1,63 @@
+import { copyFile, rename, unlink } from "node:fs/promises";
+import { setTimeout as delay } from "node:timers/promises";
+const RETRYABLE_CODES = new Set(["EPERM", "EBUSY", "EACCES"]);
+function isRetryableError(err) {
+    return (err != null &&
+        typeof err === "object" &&
+        "code" in err &&
+        typeof err.code === "string" &&
+        RETRYABLE_CODES.has(err.code));
+}
+async function retryRename(from, to, retries, backoffMs) {
+    let lastErr;
+    for (let attempt = 0; attempt < retries; attempt++) {
+        try {
+            await rename(from, to);
+            return;
+        }
+        catch (err) {
+            lastErr = err;
+            if (!isRetryableError(err) || attempt === retries - 1)
+                throw err;
+            await delay(backoffMs);
+        }
+    }
+    throw lastErr;
+}
+/**
+ * Promote staged file to target; rename-first with retry, safe copy-via-.tmp fallback.
+ * Production target is never partially overwritten on copy failure.
+ */
+export async function promoteFileAtomic(stagedPath, targetPath, opts = {}) {
+    const retries = opts.retries ?? 3;
+    const backoffMs = opts.backoffMs ?? 100;
+    try {
+        await retryRename(stagedPath, targetPath, retries, backoffMs);
+        return;
+    }
+    catch (renameErr) {
+        if (!isRetryableError(renameErr))
+            throw renameErr;
+    }
+    const tmpTarget = `${targetPath}.tmp`;
+    await copyFile(stagedPath, tmpTarget);
+    try {
+        await retryRename(tmpTarget, targetPath, retries, backoffMs);
+    }
+    catch (err) {
+        try {
+            await unlink(tmpTarget);
+        }
+        catch {
+            // orphan .tmp only — original target untouched
+        }
+        throw err;
+    }
+    try {
+        await unlink(stagedPath);
+    }
+    catch {
+        // staged copy promoted; staging leak is acceptable
+    }
+}
+//# sourceMappingURL=atomic-fs.js.map

package/dist/cli/lib/atomic-fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atomic-fs.js","sourceRoot":"","sources":["../../../src/cli/lib/atomic-fs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE9D,SAAS,gBAAgB,CAAC,GAAY;IACpC,OAAO,CACL,GAAG,IAAI,IAAI;QACX,OAAO,GAAG,KAAK,QAAQ;QACvB,MAAM,IAAI,GAAG;QACb,OAAQ,GAA6B,CAAC,IAAI,KAAK,QAAQ;QACvD,eAAe,CAAC,GAAG,CAAE,GAA6B,CAAC,IAAK,CAAC,CAC1D,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,IAAY,EAAE,EAAU,EAAE,OAAe,EAAE,SAAiB;IACrF,IAAI,OAAgB,CAAC;IACrB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,EAAE,OAAO,EAAE,EAAE,CAAC;QACnD,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACvB,OAAO;QACT,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,GAAG,GAAG,CAAC;YACd,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,IAAI,OAAO,KAAK,OAAO,GAAG,CAAC;gBAAE,MAAM,GAAG,CAAC;YACjE,MAAM,KAAK,CAAC,SAAS,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,MAAM,OAAO,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,UAAkB,EAClB,UAAkB,EAClB,OAAiD,EAAE;IAEnD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;IAClC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC;IAExC,IAAI,CAAC;QACH,MAAM,WAAW,CAAC,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;QAC9D,OAAO;IACT,CAAC;IAAC,OAAO,SAAS,EAAE,CAAC;QACnB,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC;YAAE,MAAM,SAAS,CAAC;IACpD,CAAC;IAED,MAAM,SAAS,GAAG,GAAG,UAAU,MAAM,CAAC;IACtC,MAAM,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC;IACtC,IAAI,CAAC;QACH,MAAM,WAAW,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;IAC/D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,SAAS,CAAC,CAAC;QAC1B,CAAC;QAAC,MAAM,CAAC;YACP,+CAA+C;QACjD,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,UAAU,CAAC,CAAC;IAC3B,CAAC;IAAC,MAAM,CAAC;QACP,mDAAmD;IACrD,CAAC;AACH,CAAC"}

package/dist/cli/lib/audience-output.d.ts

@@ -0,0 +1,18 @@
+/** Tailor command output verbosity by role. */
+export type OutputAudience = "worker" | "teacher" | "verifier" | "platform";
+export declare function parseAudience(raw: string | undefined): OutputAudience | undefined;
+export interface ResolvedAudience {
+    audience?: OutputAudience;
+    /** Set when CLI --audience was provided but not a known role. */
+    invalidCli?: string;
+}
+/** CLI flag wins over env; invalid CLI value is reported via invalidCli. */
+export declare function resolveAudience(cliRaw?: string, envRaw?: string): ResolvedAudience;
+export declare function formatAudienceNextStep(step: string, audience: OutputAudience | undefined): string;
+export interface AudienceNextStep {
+    audience: OutputAudience;
+    step: string;
+}
+export declare function filterNextStepsForAudience(audience: OutputAudience | undefined, steps: string[]): string[];
+export declare function audienceSectionTitle(audience: OutputAudience | undefined): string | null;
+//# sourceMappingURL=audience-output.d.ts.map

package/dist/cli/lib/audience-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audience-output.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/audience-output.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,CAAC;AAS5E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,cAAc,GAAG,SAAS,CAOjF;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,4EAA4E;AAC5E,wBAAgB,eAAe,CAC7B,MAAM,CAAC,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,GACd,gBAAgB,CAQlB;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,CASjG;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAwBD,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,cAAc,GAAG,SAAS,EACpC,KAAK,EAAE,MAAM,EAAE,GACd,MAAM,EAAE,CAQV;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,cAAc,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CASxF"}

package/dist/cli/lib/audience-output.js

@@ -0,0 +1,80 @@
+const VALID_AUDIENCES = [
+    "worker",
+    "teacher",
+    "verifier",
+    "platform",
+];
+export function parseAudience(raw) {
+    if (!raw)
+        return undefined;
+    const v = raw.trim().toLowerCase();
+    if (VALID_AUDIENCES.includes(v)) {
+        return v;
+    }
+    return undefined;
+}
+/** CLI flag wins over env; invalid CLI value is reported via invalidCli. */
+export function resolveAudience(cliRaw, envRaw) {
+    const cli = cliRaw?.trim();
+    if (cli) {
+        const parsed = parseAudience(cli);
+        if (!parsed)
+            return { invalidCli: cli };
+        return { audience: parsed };
+    }
+    return { audience: parseAudience(envRaw) };
+}
+export function formatAudienceNextStep(step, audience) {
+    if (!audience || audience === "platform")
+        return step;
+    if (audience === "worker") {
+        return step.startsWith("Constraint:") ? step : `Constraint: ${step}`;
+    }
+    if (audience === "teacher") {
+        return /^(Teacher:|git )/i.test(step) ? step : `Teacher: ${step}`;
+    }
+    return step;
+}
+const DEFAULT_NEXT_STEPS = [
+    { audience: "teacher", step: 'gapman legislate "<intent>" --msn MSN-0001 --skill-key <key>' },
+    { audience: "teacher", step: "Teacher: git commit -m \"[MSN-0001] legislate …\" including mission file" },
+    { audience: "worker", step: "eval \"$(gapman runtime env --mission .gitagent/missions/<file>.yaml)\"" },
+    { audience: "worker", step: "Append gate evidence to WORKER_LOG.md" },
+    { audience: "verifier", step: "gapman verify --mission .gitagent/missions/<file>.yaml" },
+    { audience: "platform", step: "git config core.hooksPath .githooks && gapman doctor" },
+];
+function stepMatchesAudience(step, audience) {
+    switch (audience) {
+        case "teacher":
+            return /legislate|Teacher:|git commit -m "\[MSN-/i.test(step);
+        case "worker":
+            return /runtime env|WORKER_LOG|gate evidence|eval "\$\(gapman runtime|execute worker/i.test(step);
+        case "verifier":
+            return /gapman verify/i.test(step);
+        case "platform":
+            return /hooksPath|gapman doctor|gapman init/i.test(step);
+    }
+}
+export function filterNextStepsForAudience(audience, steps) {
+    if (!audience)
+        return steps;
+    if (steps.length > 0) {
+        const filtered = [...new Set(steps.filter((step) => stepMatchesAudience(step, audience)))];
+        if (filtered.length > 0)
+            return filtered;
+    }
+    const roleDefaults = DEFAULT_NEXT_STEPS.filter((s) => s.audience === audience).map((s) => s.step);
+    return roleDefaults.length > 0 ? roleDefaults : steps;
+}
+export function audienceSectionTitle(audience) {
+    if (!audience)
+        return null;
+    const labels = {
+        worker: "Worker next steps",
+        teacher: "Teacher next steps",
+        verifier: "Verifier next steps",
+        platform: "Platform next steps",
+    };
+    return labels[audience];
+}
+//# sourceMappingURL=audience-output.js.map

package/dist/cli/lib/audience-output.js.map

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

package/dist/cli/lib/break-glass.d.ts

@@ -0,0 +1,25 @@
+export declare const ENV_BYPASS_SECRET = "GXT_BYPASS_SECRET";
+export declare const REL_BYPASS_SHA256 = ".gitagent/foreman/BYPASS.sha256";
+export declare const GXT_BYPASS_NOTES_REF = "refs/notes/gxt-bypass";
+export interface BypassAuditPayload {
+    v: 1;
+    reason: string;
+    ts: string;
+    msn_id?: string;
+    mission_file?: string;
+}
+/** True when GXT_BYPASS_SECRET matches committed BYPASS.sha256 anchor. */
+export declare function isBypassSecretAuthorized(repoRoot: string): boolean;
+export declare function assertBypassSecretAuthorized(repoRoot: string): void;
+export declare function validateBreakGlassReason(reason: string | undefined): string;
+export declare function parseBypassNoteBody(noteBody: string): BypassAuditPayload | null;
+export declare function commitHasValidBypassNote(root: string, commit: string): boolean;
+export declare function writeBypassGitNote(root: string, commit: string, payload: BypassAuditPayload): void;
+export declare function runBreakGlassAudit(root: string, options: {
+    reason: string;
+    msnId?: string | null;
+    missionFile?: string;
+    commit?: string;
+    auditCommit?: boolean;
+}): string;
+//# sourceMappingURL=break-glass.d.ts.map

package/dist/cli/lib/break-glass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"break-glass.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/break-glass.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,iBAAiB,sBAAsB,CAAC;AACrD,eAAO,MAAM,iBAAiB,oCAAoC,CAAC;AACnE,eAAO,MAAM,oBAAoB,0BAA0B,CAAC;AAI5D,MAAM,WAAW,kBAAkB;IACjC,CAAC,EAAE,CAAC,CAAC;IACL,MAAM,EAAE,MAAM,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAwBD,0EAA0E;AAC1E,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMlE;AAED,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAgBnE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQ3E;AAED,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,GAAG,IAAI,CAmB/E;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAI9E;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,kBAAkB,GAC1B,IAAI,CAMN;AAiBD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE;IACP,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,GACA,MAAM,CAwBR"}