@jeger-ai/opengantry 3.4.0 → 3.6.0

package/dist/cli/lib/contract/embedding-provider.js

@@ -0,0 +1,145 @@
+import fs from "node:fs";
+import path from "node:path";
+import { GantryUserError, isGantryUserError } from "../errors.js";
+/** Must stay equal to `EMBEDDING_DIMENSIONS` in vector-store.ts. This module does not import it (sqlite-vec). */
+export const OPENAI_EMBEDDING_DIMENSIONS = 1536;
+export const OPENAI_EMBEDDINGS_URL = "https://api.openai.com/v1/embeddings";
+export const OPENAI_EMBEDDING_MODEL = "text-embedding-3-small";
+export const OPENAI_API_KEY_ENV = "OPENAI_API_KEY";
+export const OPENAI_EMBEDDING_TIMEOUT_MS = 5000;
+export class OpenAiEmbeddingProvider {
+    options;
+    constructor(options = {}) {
+        this.options = options;
+    }
+    async generateEmbedding(text) {
+        const trimmed = text.trim();
+        if (!trimmed) {
+            throw new GantryUserError("INVALID_ARGUMENT", "intent text is required to generate an embedding", undefined, 2);
+        }
+        const apiKey = resolveApiKey(this.options.apiKey);
+        if (!apiKey) {
+            throw new GantryUserError("INVALID_ARGUMENT", "OPENAI_API_KEY is required to generate an embedding", "export OPENAI_API_KEY", 2);
+        }
+        const response = await postEmbeddings(this.options.fetchImpl ?? globalThis.fetch, apiKey, trimmed, resolveTimeoutMs(this.options.timeoutMs));
+        if (!response.ok)
+            throw statusError(response.status);
+        return parseEmbeddingPayload(await readJson(response));
+    }
+}
+export function writeHostEmbeddingFile(filePath, doc) {
+    const summary = doc.summary.trim();
+    if (!summary) {
+        throw new GantryUserError("INVALID_ARGUMENT", "contract embed: summary is required", undefined, 2);
+    }
+    const body = {
+        summary,
+        embedding: doc.embedding,
+    };
+    const msnId = doc.msn_id?.trim();
+    if (msnId)
+        body.msn_id = msnId;
+    fs.mkdirSync(path.dirname(path.resolve(filePath)), { recursive: true });
+    fs.writeFileSync(filePath, `${JSON.stringify(body, null, 2)}\n`);
+}
+function resolveApiKey(explicit) {
+    return (explicit ?? process.env[OPENAI_API_KEY_ENV] ?? "").trim();
+}
+function resolveTimeoutMs(timeoutMs) {
+    if (typeof timeoutMs === "number" && Number.isFinite(timeoutMs) && timeoutMs > 0)
+        return timeoutMs;
+    return OPENAI_EMBEDDING_TIMEOUT_MS;
+}
+function timeoutError() {
+    return new GantryUserError("INVALID_ARGUMENT", "OpenAI embeddings request timed out", undefined, 2);
+}
+function statusError(status) {
+    if (status === 401) {
+        return new GantryUserError("INVALID_ARGUMENT", "OpenAI rejected OPENAI_API_KEY (HTTP 401)", "export a valid OPENAI_API_KEY", 2);
+    }
+    if (status === 429) {
+        return new GantryUserError("INVALID_ARGUMENT", "OpenAI rate limit (HTTP 429). Retry later.", undefined, 2);
+    }
+    return new GantryUserError("INVALID_ARGUMENT", `OpenAI embeddings request failed (HTTP ${String(status)})`, undefined, 2);
+}
+function isAbortError(error) {
+    return error instanceof Error && error.name === "AbortError";
+}
+async function postEmbeddings(fetchImpl, apiKey, text, timeoutMs) {
+    const controller = new AbortController();
+    let timer;
+    let timedOut = false;
+    const timedOutPromise = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+            timedOut = true;
+            controller.abort();
+            reject(timeoutError());
+        }, timeoutMs);
+    });
+    try {
+        const request = fetchImpl(OPENAI_EMBEDDINGS_URL, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({
+                model: OPENAI_EMBEDDING_MODEL,
+                input: text,
+                dimensions: OPENAI_EMBEDDING_DIMENSIONS,
+            }),
+            signal: controller.signal,
+        });
+        void request.catch(() => undefined);
+        return await Promise.race([request, timedOutPromise]);
+    }
+    catch (error) {
+        if (isGantryUserError(error))
+            throw error;
+        if (timedOut || isAbortError(error))
+            throw timeoutError();
+        throw new GantryUserError("INVALID_ARGUMENT", "OpenAI embeddings request failed", undefined, 2);
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+    }
+}
+async function readJson(response) {
+    try {
+        return (await response.json());
+    }
+    catch {
+        throw new GantryUserError("INVALID_ARGUMENT", "OpenAI embeddings response is not JSON", undefined, 2);
+    }
+}
+function parseEmbeddingPayload(body) {
+    const embedding = embeddingArray(body);
+    if (embedding.length !== OPENAI_EMBEDDING_DIMENSIONS) {
+        throw new GantryUserError("INVALID_ARGUMENT", `embedding must contain ${String(OPENAI_EMBEDDING_DIMENSIONS)} numbers (got ${String(embedding.length)})`, undefined, 2);
+    }
+    const out = [];
+    for (let i = 0; i < embedding.length; i += 1) {
+        const value = embedding[i];
+        if (typeof value !== "number" || !Number.isFinite(value)) {
+            throw new GantryUserError("INVALID_ARGUMENT", `embedding[${String(i)}] is not a finite number`, undefined, 2);
+        }
+        out.push(value);
+    }
+    return out;
+}
+function embeddingArray(body) {
+    if (!body || typeof body !== "object") {
+        throw new GantryUserError("INVALID_ARGUMENT", "OpenAI embeddings response is not JSON", undefined, 2);
+    }
+    const data = body.data;
+    if (!Array.isArray(data) || data.length === 0 || !data[0] || typeof data[0] !== "object") {
+        throw new GantryUserError("INVALID_ARGUMENT", "OpenAI embeddings response has no embedding array", undefined, 2);
+    }
+    const embedding = data[0].embedding;
+    if (!Array.isArray(embedding)) {
+        throw new GantryUserError("INVALID_ARGUMENT", "OpenAI embeddings response has no embedding array", undefined, 2);
+    }
+    return embedding;
+}
+//# sourceMappingURL=embedding-provider.js.map

package/dist/cli/lib/contract/embedding-provider.js.map

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

package/dist/cli/lib/contract/intent-path-tokens.d.ts

@@ -0,0 +1,7 @@
+export declare function existsRepoPath(root: string, rel: string): boolean;
+/** Path-like tokens from intent prose (same regex as contract propose). */
+export declare function intentPathTokens(intent: string): string[];
+export declare function intersectWithSkillRoots(candidates: readonly string[], skillRoots: readonly string[]): string[];
+/** Intent/--path hints that exist on disk and sit under skill roots. */
+export declare function existingHintedPaths(root: string, intent: string, paths: readonly string[] | undefined, skillRoots: readonly string[]): string[];
+//# sourceMappingURL=intent-path-tokens.d.ts.map

package/dist/cli/lib/contract/intent-path-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-path-tokens.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/contract/intent-path-tokens.ts"],"names":[],"mappings":"AAOA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAEjE;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAOzD;AAED,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,SAAS,MAAM,EAAE,EAC7B,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,MAAM,EAAE,CAGV;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,EACpC,UAAU,EAAE,SAAS,MAAM,EAAE,GAC5B,MAAM,EAAE,CAIV"}

package/dist/cli/lib/contract/intent-path-tokens.js

@@ -0,0 +1,30 @@
+import fs from "node:fs";
+import path from "node:path";
+import { normalizeContractPath } from "./contract-hash.js";
+import { isPathUnderRoot } from "../tmvc-path.js";
+const PATH_TOKEN_RE = /(?:\.{0,2}\/)?[A-Za-z0-9_.@-]+(?:\/[A-Za-z0-9_.@-]+)+\/?/g;
+export function existsRepoPath(root, rel) {
+    return fs.existsSync(path.join(root, rel));
+}
+/** Path-like tokens from intent prose (same regex as contract propose). */
+export function intentPathTokens(intent) {
+    const out = [];
+    for (const m of intent.matchAll(PATH_TOKEN_RE)) {
+        const norm = normalizeContractPath(m[0]);
+        if (norm && !norm.includes("://"))
+            out.push(norm);
+    }
+    return out;
+}
+export function intersectWithSkillRoots(candidates, skillRoots) {
+    if (skillRoots.length === 0)
+        return [...candidates];
+    return candidates.filter((c) => skillRoots.some((s) => isPathUnderRoot(c, s)));
+}
+/** Intent/--path hints that exist on disk and sit under skill roots. */
+export function existingHintedPaths(root, intent, paths, skillRoots) {
+    const hinted = [...intentPathTokens(intent), ...(paths ?? []).map(normalizeContractPath)];
+    const existing = [...new Set(hinted)].filter((p) => existsRepoPath(root, p.replace(/\/$/, ""))).sort();
+    return intersectWithSkillRoots(existing, skillRoots);
+}
+//# sourceMappingURL=intent-path-tokens.js.map

package/dist/cli/lib/contract/intent-path-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent-path-tokens.js","sourceRoot":"","sources":["../../../../src/cli/lib/contract/intent-path-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,MAAM,aAAa,GAAG,2DAA2D,CAAC;AAElF,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,GAAW;IACtD,OAAO,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,qBAAqB,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC;QAC1C,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACpD,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,uBAAuB,CACrC,UAA6B,EAC7B,UAA6B;IAE7B,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,GAAG,UAAU,CAAC,CAAC;IACpD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACjF,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,mBAAmB,CACjC,IAAY,EACZ,MAAc,EACd,KAAoC,EACpC,UAA6B;IAE7B,MAAM,MAAM,GAAG,CAAC,GAAG,gBAAgB,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC,CAAC;IAC1F,MAAM,QAAQ,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvG,OAAO,uBAAuB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;AACvD,CAAC"}

package/dist/cli/lib/contract/preflight-heuristic.d.ts

@@ -0,0 +1,11 @@
+import { type PreflightResult } from "./preflight-types.js";
+import type { Manifest } from "../types.js";
+export interface HeuristicPreflightInput {
+    root: string;
+    manifest: Manifest;
+    intent: string;
+    paths?: string[];
+}
+/** Offline skill/path classifier. Never calls a network. */
+export declare function runHeuristicPreflight(input: HeuristicPreflightInput): PreflightResult;
+//# sourceMappingURL=preflight-heuristic.d.ts.map

package/dist/cli/lib/contract/preflight-heuristic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight-heuristic.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/contract/preflight-heuristic.ts"],"names":[],"mappings":"AAEA,OAAO,EAA4B,KAAK,eAAe,EAA0B,MAAM,sBAAsB,CAAC;AAE9G,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAiBD,4DAA4D;AAC5D,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,uBAAuB,GAAG,eAAe,CAiBrF"}

package/dist/cli/lib/contract/preflight-heuristic.js

@@ -0,0 +1,38 @@
+import { normalizeContractPath } from "./contract-hash.js";
+import { existingHintedPaths } from "./intent-path-tokens.js";
+import { PREFLIGHT_MIN_CONFIDENCE } from "./preflight-types.js";
+import { isTriageEscalated, triageIntent } from "../triage-logic.js";
+function skillRootsFor(manifest, skillKey) {
+    if (!skillKey)
+        return [];
+    return (manifest.skills[skillKey]?.tmvc_roots ?? []).map(normalizeContractPath);
+}
+function candidateScores(paths) {
+    return paths.map((path) => ({ path, score: 1 }));
+}
+function emitSkillKey(skillKey, confidence, escalate) {
+    if (escalate || skillKey === null || skillKey === "NONE")
+        return null;
+    if (confidence < PREFLIGHT_MIN_CONFIDENCE)
+        return null;
+    return skillKey;
+}
+/** Offline skill/path classifier. Never calls a network. */
+export function runHeuristicPreflight(input) {
+    const triage = triageIntent(input.root, input.intent, input.manifest);
+    const escalate = isTriageEscalated(triage);
+    const resolved = escalate ? null : triage.skill_key === "NONE" ? null : triage.skill_key;
+    const roots = skillRootsFor(input.manifest, resolved);
+    const hinted = existingHintedPaths(input.root, input.intent, input.paths, roots);
+    const tmvc_root_candidates = hinted.length > 0 ? candidateScores(hinted) : candidateScores([...roots].sort());
+    const rationale = [...triage.match_reasons, triage.reason];
+    return {
+        provider: "heuristic",
+        skill_key: emitSkillKey(resolved, triage.confidence, escalate),
+        skill_confidence: triage.confidence,
+        tmvc_root_candidates,
+        escalate,
+        rationale,
+    };
+}
+//# sourceMappingURL=preflight-heuristic.js.map

package/dist/cli/lib/contract/preflight-heuristic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight-heuristic.js","sourceRoot":"","sources":["../../../../src/cli/lib/contract/preflight-heuristic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC9D,OAAO,EAAE,wBAAwB,EAAgD,MAAM,sBAAsB,CAAC;AAC9G,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAUrE,SAAS,aAAa,CAAC,QAAkB,EAAE,QAAuB;IAChE,IAAI,CAAC,QAAQ;QAAE,OAAO,EAAE,CAAC;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;AAClF,CAAC;AAED,SAAS,eAAe,CAAC,KAAwB;IAC/C,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,SAAS,YAAY,CAAC,QAAuB,EAAE,UAAkB,EAAE,QAAiB;IAClF,IAAI,QAAQ,IAAI,QAAQ,KAAK,IAAI,IAAI,QAAQ,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IACtE,IAAI,UAAU,GAAG,wBAAwB;QAAE,OAAO,IAAI,CAAC;IACvD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,qBAAqB,CAAC,KAA8B;IAClE,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,QAAQ,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;IACzF,MAAM,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACtD,MAAM,MAAM,GAAG,mBAAmB,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACjF,MAAM,oBAAoB,GACxB,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;IACnF,MAAM,SAAS,GAAG,CAAC,GAAG,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3D,OAAO;QACL,QAAQ,EAAE,WAAW;QACrB,SAAS,EAAE,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,UAAU,EAAE,QAAQ,CAAC;QAC9D,gBAAgB,EAAE,MAAM,CAAC,UAAU;QACnC,oBAAoB;QACpB,QAAQ;QACR,SAAS;KACV,CAAC;AACJ,CAAC"}

package/dist/cli/lib/contract/preflight-jev.d.ts

@@ -0,0 +1,54 @@
+import { type JevFallbackReason, type PreflightResult, type TmvcRootCandidate } from "./preflight-types.js";
+import type { Manifest } from "../types.js";
+export declare const JEV_SYSTEM_ONE_URL = "https://api.typesafe.ai/v1/systemone";
+export declare const JEV_MODEL = "jev-latest";
+export declare const TYPESAFE_API_KEY_ENV = "TYPESAFE_API_KEY";
+export declare const JEV_FETCH_TIMEOUT_MS = 2000;
+export interface JevPreflightInput {
+    root: string;
+    manifest: Manifest;
+    intent: string;
+    paths?: string[];
+    apiKey: string;
+    fetchImpl?: typeof fetch;
+    /** Override fetch timeout (ms). Production default is `JEV_FETCH_TIMEOUT_MS`. */
+    timeoutMs?: number;
+}
+export interface JevQuestionSpec {
+    type: "choice" | "noul";
+    instructions: string;
+    criteria?: Record<string, string>;
+}
+export interface JevSystemOneRequest {
+    model: string;
+    state: {
+        intent: string;
+        paths: string[];
+        skills: Record<string, {
+            desc: string;
+            tmvc_roots: string[];
+        }>;
+    };
+    questions: Record<string, JevQuestionSpec>;
+}
+type JevParsed = {
+    skillKey: string;
+    skillConfidence: number;
+    escalate: boolean;
+    candidates: TmvcRootCandidate[];
+};
+export declare function buildJevRequest(input: {
+    intent: string;
+    paths?: string[];
+    manifest: Manifest;
+}): JevSystemOneRequest;
+export declare function parseJevAnswers(body: unknown, manifest: Manifest): {
+    ok: true;
+    value: JevParsed;
+} | {
+    ok: false;
+    reason: JevFallbackReason;
+};
+export declare function runJevPreflight(input: JevPreflightInput): Promise<PreflightResult>;
+export {};
+//# sourceMappingURL=preflight-jev.d.ts.map

package/dist/cli/lib/contract/preflight-jev.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight-jev.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/contract/preflight-jev.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACvB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,eAAO,MAAM,kBAAkB,yCAAyC,CAAC;AACzE,eAAO,MAAM,SAAS,eAAe,CAAC;AACtC,eAAO,MAAM,oBAAoB,qBAAqB,CAAC;AACvD,eAAO,MAAM,oBAAoB,OAAO,CAAC;AAMzC,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,iFAAiF;IACjF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,EAAE,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAC3G,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC5C;AAED,KAAK,SAAS,GAAG;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;IACxB,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,iBAAiB,EAAE,CAAC;CACjC,CAAC;AAkBF,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;CACpB,GAAG,mBAAmB,CA4BtB;AA0ED,wBAAgB,eAAe,CAC7B,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,QAAQ,GACjB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,SAAS,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,CA0B3E;AA0DD,wBAAsB,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAwCxF"}

package/dist/cli/lib/contract/preflight-jev.js

@@ -0,0 +1,247 @@
+import { normalizeContractPath } from "./contract-hash.js";
+import { runHeuristicPreflight } from "./preflight-heuristic.js";
+import { PREFLIGHT_MIN_CONFIDENCE, jevFallbackRationale, } from "./preflight-types.js";
+import { logWarn } from "../cli-io.js";
+import { GantryUserError } from "../errors.js";
+export const JEV_SYSTEM_ONE_URL = "https://api.typesafe.ai/v1/systemone";
+export const JEV_MODEL = "jev-latest";
+export const TYPESAFE_API_KEY_ENV = "TYPESAFE_API_KEY";
+export const JEV_FETCH_TIMEOUT_MS = 2000;
+const SKILL_Q = "skill";
+const ESCALATE_Q = "escalate";
+const ROOT_PREFIX = "root:";
+function skillCatalog(manifest) {
+    const out = {};
+    for (const [key, skill] of Object.entries(manifest.skills)) {
+        out[key] = { desc: skill.desc ?? key, tmvc_roots: skill.tmvc_roots.map(normalizeContractPath) };
+    }
+    return out;
+}
+function allSkillRoots(manifest) {
+    const roots = new Set();
+    for (const skill of Object.values(manifest.skills)) {
+        for (const r of skill.tmvc_roots)
+            roots.add(normalizeContractPath(r));
+    }
+    return [...roots].sort();
+}
+export function buildJevRequest(input) {
+    const catalog = skillCatalog(input.manifest);
+    const criteria = {};
+    for (const [key, meta] of Object.entries(catalog)) {
+        criteria[key] = meta.desc;
+    }
+    const questions = {
+        [SKILL_Q]: {
+            type: "choice",
+            instructions: "Which manifest skill_key owns this intent?",
+            criteria,
+        },
+        [ESCALATE_Q]: {
+            type: "noul",
+            instructions: "Does this intent hit path_risks or risk_keywords that require Planner escalation?",
+        },
+    };
+    for (const root of allSkillRoots(input.manifest)) {
+        questions[`${ROOT_PREFIX}${root}`] = {
+            type: "noul",
+            instructions: `Is ${root} a relevant TMVC root for this intent?`,
+        };
+    }
+    return {
+        model: JEV_MODEL,
+        state: { intent: input.intent, paths: [...(input.paths ?? [])], skills: catalog },
+        questions,
+    };
+}
+function fallback(input, reason) {
+    logWarn(`jev_preflight fallback reason=${reason}`);
+    const heuristic = runHeuristicPreflight({
+        root: input.root,
+        manifest: input.manifest,
+        intent: input.intent,
+        paths: input.paths,
+    });
+    return { ...heuristic, rationale: [jevFallbackRationale(reason), ...heuristic.rationale] };
+}
+function isUnit(n) {
+    return typeof n === "number" && Number.isFinite(n) && n >= 0 && n <= 1;
+}
+function asAnswers(body) {
+    if (!body || typeof body !== "object" || !("answers" in body))
+        return { ok: false, reason: "malformed_response" };
+    const answers = body.answers;
+    if (!answers || typeof answers !== "object" || Array.isArray(answers)) {
+        return { ok: false, reason: "malformed_response" };
+    }
+    const out = {};
+    for (const [key, value] of Object.entries(answers)) {
+        if (!value || typeof value !== "object" || Array.isArray(value)) {
+            return { ok: false, reason: classifyProbabilities(value) };
+        }
+        const rec = value;
+        if (!isUnit(rec.noul) && rec.noul !== undefined)
+            return { ok: false, reason: "invalid_probability" };
+        if (!isUnit(rec.confidence) && rec.confidence !== undefined)
+            return { ok: false, reason: "invalid_probability" };
+        out[key] = rec;
+    }
+    return { ok: true, answers: out };
+}
+function classifyProbabilities(value) {
+    if (value && typeof value === "object") {
+        const rec = value;
+        for (const field of ["noul", "confidence"]) {
+            const n = rec[field];
+            if (typeof n === "number" && !isUnit(n))
+                return "invalid_probability";
+        }
+    }
+    return "malformed_response";
+}
+function parseRootCandidates(answers, skillRoots, knownRoots) {
+    const skillRootSet = new Set(skillRoots);
+    const knownRootSet = new Set(knownRoots);
+    const candidates = [];
+    for (const [key, answer] of Object.entries(answers)) {
+        if (!key.startsWith(ROOT_PREFIX))
+            continue;
+        const rootPath = normalizeContractPath(key.slice(ROOT_PREFIX.length));
+        if (!knownRootSet.has(rootPath))
+            return { ok: false, reason: "unexpected_choice" };
+        if (!skillRootSet.has(rootPath))
+            continue;
+        if (answer.type !== "noul" || !isUnit(answer.noul))
+            return { ok: false, reason: "malformed_response" };
+        candidates.push({ path: rootPath, score: answer.noul });
+    }
+    return { ok: true, candidates: candidates.sort((a, b) => a.path.localeCompare(b.path)) };
+}
+function classifyParseFail(body) {
+    const parsed = asAnswers(body);
+    if (parsed.ok)
+        return "malformed_response";
+    return parsed.reason;
+}
+export function parseJevAnswers(body, manifest) {
+    const parsed = asAnswers(body);
+    if (!parsed.ok)
+        return parsed;
+    const skillAnswer = parsed.answers[SKILL_Q];
+    if (!skillAnswer || skillAnswer.type !== "choice" || typeof skillAnswer.choice !== "string" || !isUnit(skillAnswer.confidence)) {
+        return { ok: false, reason: classifyParseFail(body) };
+    }
+    const skillKeys = Object.keys(manifest.skills);
+    if (!skillKeys.includes(skillAnswer.choice))
+        return { ok: false, reason: "unexpected_choice" };
+    const escalateAnswer = parsed.answers[ESCALATE_Q];
+    const escalate = escalateAnswer?.type === "noul" && isUnit(escalateAnswer.noul)
+        ? escalateAnswer.noul >= PREFLIGHT_MIN_CONFIDENCE
+        : false;
+    const skillRoots = (manifest.skills[skillAnswer.choice]?.tmvc_roots ?? []).map(normalizeContractPath);
+    const roots = parseRootCandidates(parsed.answers, skillRoots, allSkillRoots(manifest));
+    if (!roots.ok)
+        return roots;
+    return {
+        ok: true,
+        value: {
+            skillKey: skillAnswer.choice,
+            skillConfidence: skillAnswer.confidence,
+            escalate,
+            candidates: roots.candidates,
+        },
+    };
+}
+function emitFromParsed(parsed) {
+    const low = parsed.skillConfidence < PREFLIGHT_MIN_CONFIDENCE;
+    return {
+        provider: "jev",
+        skill_key: parsed.escalate || low ? null : parsed.skillKey,
+        skill_confidence: parsed.skillConfidence,
+        tmvc_root_candidates: parsed.candidates,
+        escalate: parsed.escalate || low,
+        rationale: ["jev: systemone choice+noul pass"],
+    };
+}
+function isMappedPreflightValid(result) {
+    if (result.skill_key !== null && typeof result.skill_key !== "string")
+        return false;
+    if (!isUnit(result.skill_confidence))
+        return false;
+    if (!Array.isArray(result.tmvc_root_candidates))
+        return false;
+    for (const candidate of result.tmvc_root_candidates) {
+        if (!candidate || typeof candidate !== "object")
+            return false;
+        if (typeof candidate.path !== "string" || !isUnit(candidate.score))
+            return false;
+    }
+    return true;
+}
+function isTimeoutFailure(error) {
+    return error instanceof Error && error.name === "AbortError";
+}
+function resolveFetchTimeoutMs(timeoutMs) {
+    if (typeof timeoutMs === "number" && Number.isFinite(timeoutMs) && timeoutMs > 0)
+        return timeoutMs;
+    return JEV_FETCH_TIMEOUT_MS;
+}
+async function fetchWithTimeout(fetchImpl, init, timeoutMs) {
+    const controller = new AbortController();
+    let timer;
+    const timedOut = new Promise((_, reject) => {
+        timer = setTimeout(() => {
+            controller.abort();
+            const err = new Error("jev_timeout");
+            err.name = "AbortError";
+            reject(err);
+        }, timeoutMs);
+    });
+    try {
+        const request = fetchImpl(JEV_SYSTEM_ONE_URL, { ...init, signal: controller.signal });
+        void request.catch(() => undefined);
+        return await Promise.race([request, timedOut]);
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+    }
+}
+export async function runJevPreflight(input) {
+    if (!input.apiKey.trim()) {
+        throw new GantryUserError("INVALID_ARGUMENT", "contract preflight --provider jev requires TYPESAFE_API_KEY", "export TYPESAFE_API_KEY or use --provider heuristic", 2);
+    }
+    const fetchImpl = input.fetchImpl ?? globalThis.fetch;
+    const payload = buildJevRequest(input);
+    let response;
+    try {
+        response = await fetchWithTimeout(fetchImpl, {
+            method: "POST",
+            headers: {
+                Authorization: `Bearer ${input.apiKey}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify(payload),
+        }, resolveFetchTimeoutMs(input.timeoutMs));
+    }
+    catch (error) {
+        return fallback(input, isTimeoutFailure(error) ? "timeout" : "transport_error");
+    }
+    if (!response.ok)
+        return fallback(input, "transport_error");
+    let body;
+    try {
+        body = await response.json();
+    }
+    catch {
+        return fallback(input, "malformed_response");
+    }
+    const parsed = parseJevAnswers(body, input.manifest);
+    if (!parsed.ok)
+        return fallback(input, parsed.reason);
+    const emitted = emitFromParsed(parsed.value);
+    if (!isMappedPreflightValid(emitted))
+        return fallback(input, "malformed_response");
+    return emitted;
+}
+//# sourceMappingURL=preflight-jev.js.map

package/dist/cli/lib/contract/preflight-jev.js.map

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

package/dist/cli/lib/contract/preflight-types.d.ts

@@ -0,0 +1,19 @@
+export declare const PREFLIGHT_PROVIDERS: readonly ["heuristic", "jev"];
+export type PreflightProvider = (typeof PREFLIGHT_PROVIDERS)[number];
+export declare const PREFLIGHT_MIN_CONFIDENCE = 0.5;
+export type JevFallbackReason = "malformed_response" | "unexpected_choice" | "transport_error" | "timeout" | "invalid_probability";
+export interface TmvcRootCandidate {
+    path: string;
+    score: number;
+}
+export interface PreflightResult {
+    provider: PreflightProvider;
+    skill_key: string | null;
+    skill_confidence: number;
+    tmvc_root_candidates: TmvcRootCandidate[];
+    escalate: boolean;
+    rationale: string[];
+}
+export declare function isPreflightProvider(value: string): value is PreflightProvider;
+export declare function jevFallbackRationale(reason: JevFallbackReason): string;
+//# sourceMappingURL=preflight-types.d.ts.map

package/dist/cli/lib/contract/preflight-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight-types.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/contract/preflight-types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,+BAAgC,CAAC;AACjE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AAErE,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAE5C,MAAM,MAAM,iBAAiB,GACzB,oBAAoB,GACpB,mBAAmB,GACnB,iBAAiB,GACjB,SAAS,GACT,qBAAqB,CAAC;AAE1B,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,EAAE,iBAAiB,EAAE,CAAC;IAC1C,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,iBAAiB,CAE7E;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAEtE"}

package/dist/cli/lib/contract/preflight-types.js

@@ -0,0 +1,9 @@
+export const PREFLIGHT_PROVIDERS = ["heuristic", "jev"];
+export const PREFLIGHT_MIN_CONFIDENCE = 0.5;
+export function isPreflightProvider(value) {
+    return PREFLIGHT_PROVIDERS.includes(value);
+}
+export function jevFallbackRationale(reason) {
+    return `jev_fallback: ${reason}`;
+}
+//# sourceMappingURL=preflight-types.js.map

package/dist/cli/lib/contract/preflight-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"preflight-types.js","sourceRoot":"","sources":["../../../../src/cli/lib/contract/preflight-types.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,WAAW,EAAE,KAAK,CAAU,CAAC;AAGjE,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAuB5C,MAAM,UAAU,mBAAmB,CAAC,KAAa;IAC/C,OAAQ,mBAAyC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,MAAyB;IAC5D,OAAO,iBAAiB,MAAM,EAAE,CAAC;AACnC,CAAC"}

package/dist/cli/lib/contract/preflight.d.ts

@@ -0,0 +1,16 @@
+import { type PreflightProvider, type PreflightResult } from "./preflight-types.js";
+import type { Manifest } from "../types.js";
+export type { PreflightProvider, PreflightResult, TmvcRootCandidate } from "./preflight-types.js";
+export { PREFLIGHT_MIN_CONFIDENCE, PREFLIGHT_PROVIDERS, isPreflightProvider } from "./preflight-types.js";
+export interface RunPreflightInput {
+    root: string;
+    manifest: Manifest;
+    intent: string;
+    paths?: string[];
+    provider?: PreflightProvider;
+    apiKey?: string;
+    fetchImpl?: typeof fetch;
+}
+/** Advisory classifier in front of proposeContract. Never writes a contract or hash. */
+export declare function runPreflight(input: RunPreflightInput): Promise<PreflightResult>;
+//# sourceMappingURL=preflight.d.ts.map