@jeger-ai/opengantry 3.4.0 → 3.5.0

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/contract/preflight.ts"],"names":[],"mappings":"AAEA,OAAO,EAAuB,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEzG,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,YAAY,EAAE,iBAAiB,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAClG,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE1G,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,QAAQ,CAAC,EAAE,iBAAiB,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;CAC1B;AAeD,wFAAwF;AACxF,wBAAsB,YAAY,CAAC,KAAK,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC,CAmBrF"}

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

@@ -0,0 +1,34 @@
+import { runHeuristicPreflight } from "./preflight-heuristic.js";
+import { runJevPreflight } from "./preflight-jev.js";
+import { isPreflightProvider } from "./preflight-types.js";
+import { GantryUserError } from "../errors.js";
+export { PREFLIGHT_MIN_CONFIDENCE, PREFLIGHT_PROVIDERS, isPreflightProvider } from "./preflight-types.js";
+function assertProvider(provider) {
+    const resolved = provider ?? "heuristic";
+    if (!isPreflightProvider(resolved)) {
+        throw new GantryUserError("INVALID_ARGUMENT", `contract preflight: unknown provider ${resolved}`, "Use heuristic or jev", 2);
+    }
+    return resolved;
+}
+/** Advisory classifier in front of proposeContract. Never writes a contract or hash. */
+export async function runPreflight(input) {
+    const provider = assertProvider(input.provider);
+    switch (provider) {
+        case "heuristic":
+            return runHeuristicPreflight(input);
+        case "jev":
+            return runJevPreflight({
+                root: input.root,
+                manifest: input.manifest,
+                intent: input.intent,
+                paths: input.paths,
+                apiKey: input.apiKey ?? "",
+                fetchImpl: input.fetchImpl,
+            });
+        default: {
+            const _exhaustive = provider;
+            throw new GantryUserError("INVALID_ARGUMENT", `contract preflight: unhandled provider ${String(_exhaustive)}`, undefined, 2);
+        }
+    }
+}
+//# sourceMappingURL=preflight.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"preflight.js","sourceRoot":"","sources":["../../../../src/cli/lib/contract/preflight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAgD,MAAM,sBAAsB,CAAC;AACzG,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAI/C,OAAO,EAAE,wBAAwB,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAY1G,SAAS,cAAc,CAAC,QAA4B;IAClD,MAAM,QAAQ,GAAG,QAAQ,IAAI,WAAW,CAAC;IACzC,IAAI,CAAC,mBAAmB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,eAAe,CACvB,kBAAkB,EAClB,wCAAwC,QAAQ,EAAE,EAClD,sBAAsB,EACtB,CAAC,CACF,CAAC;IACJ,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,wFAAwF;AACxF,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAAwB;IACzD,MAAM,QAAQ,GAAG,cAAc,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,WAAW;YACd,OAAO,qBAAqB,CAAC,KAAK,CAAC,CAAC;QACtC,KAAK,KAAK;YACR,OAAO,eAAe,CAAC;gBACrB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,KAAK,EAAE,KAAK,CAAC,KAAK;gBAClB,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;gBAC1B,SAAS,EAAE,KAAK,CAAC,SAAS;aAC3B,CAAC,CAAC;QACL,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,WAAW,GAAU,QAAQ,CAAC;YACpC,MAAM,IAAI,eAAe,CAAC,kBAAkB,EAAE,0CAA0C,MAAM,CAAC,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC;QAC/H,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/cli/lib/contract/propose.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"propose.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/contract/propose.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,IAAI,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGjF,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,eAAe,CAAC;IAC1B,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AA4DD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,CAmClF"}
+{"version":3,"file":"propose.d.ts","sourceRoot":"","sources":["../../../../src/cli/lib/contract/propose.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,OAAO,EAAe,KAAK,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGnE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,IAAI,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAGjF,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,eAAe,CAAC;IAC1B,IAAI,EAAE,YAAY,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAsCD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,oBAAoB,GAAG,qBAAqB,CAmClF"}

package/dist/cli/lib/contract/propose.js

@@ -1,33 +1,12 @@
-import fs from "node:fs";
-import path from "node:path";
 import { loadPolicyBundleQuiet } from "./effective-scope.js";
 import { normalizeContract, normalizeContractPath } from "./contract-hash.js";
+import { existingHintedPaths } from "./intent-path-tokens.js";
 import { proposeGate } from "./propose-gate.js";
 import { proposeImports } from "./propose-imports.js";
 import { isPathUnderRoot } from "../tmvc-path.js";
 import { resolveManifestSkillKey } from "../skill-key.js";
-const PATH_TOKEN_RE = /(?:\.{0,2}\/)?[A-Za-z0-9_.@-]+(?:\/[A-Za-z0-9_.@-]+)+\/?/g;
-function existsRepoPath(root, rel) {
-    return fs.existsSync(path.join(root, rel));
-}
-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;
-}
-function intersectWithSkillRoots(candidates, skillRoots) {
-    if (skillRoots.length === 0)
-        return [...candidates];
-    return candidates.filter((c) => skillRoots.some((s) => isPathUnderRoot(c, s)));
-}
 function proposeTmvcRoots(input, skillRoots) {
-    const hinted = [...intentPathTokens(input.intent), ...(input.paths ?? []).map(normalizeContractPath)];
-    const existing = [...new Set(hinted)].filter((p) => existsRepoPath(input.root, p.replace(/\/$/, ""))).sort();
-    const narrowed = intersectWithSkillRoots(existing, skillRoots);
+    const narrowed = existingHintedPaths(input.root, input.intent, input.paths, skillRoots);
     if (narrowed.length > 0) {
         return {
             roots: narrowed,

package/dist/cli/lib/contract/propose.js.map

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

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

@@ -0,0 +1,19 @@
+import { type PreflightProvider, type PreflightResult } from "./contract/preflight.js";
+import { type McpErrorBody } from "./mcp-governance-shared.js";
+export interface PreflightContractMcpInput {
+    intent: string;
+    paths?: string[];
+    provider?: PreflightProvider;
+}
+export type PreflightContractMcpResult = ({
+    status: "ok";
+} & PreflightResult) | {
+    status: "error";
+    error: McpErrorBody;
+};
+/** Advisory. Never writes mission law. Fail-open Jev errors become heuristic results. */
+export declare function handlePreflightContract(input: PreflightContractMcpInput, deps?: {
+    fetchImpl?: typeof fetch;
+    apiKey?: string;
+}): Promise<PreflightContractMcpResult>;
+//# sourceMappingURL=mcp-preflight-contract.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-preflight-contract.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/mcp-preflight-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAGrG,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAGzE,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,iBAAiB,CAAC;CAC9B;AAED,MAAM,MAAM,0BAA0B,GAClC,CAAC;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,GAAG,eAAe,CAAC,GACpC;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAE,CAAC;AAE7C,yFAAyF;AACzF,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,yBAAyB,EAChC,IAAI,CAAC,EAAE;IAAE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,OAAO,CAAC,0BAA0B,CAAC,CAsBrC"}

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

@@ -0,0 +1,31 @@
+import { runPreflight } from "./contract/preflight.js";
+import { TYPESAFE_API_KEY_ENV } from "./contract/preflight-jev.js";
+import { isGantryUserError } from "./errors.js";
+import { mcpError } from "./mcp-governance-shared.js";
+import { loadWorkspace } from "./workspace.js";
+/** Advisory. Never writes mission law. Fail-open Jev errors become heuristic results. */
+export async function handlePreflightContract(input, deps) {
+    try {
+        if (!input.intent?.trim()) {
+            return mcpError("VALIDATION_ERROR", "intent is required", true);
+        }
+        const { root, manifest } = loadWorkspace();
+        const result = await runPreflight({
+            root,
+            manifest,
+            intent: input.intent.trim(),
+            paths: input.paths,
+            provider: input.provider,
+            apiKey: deps?.apiKey ?? process.env[TYPESAFE_API_KEY_ENV],
+            fetchImpl: deps?.fetchImpl,
+        });
+        return { status: "ok", ...result };
+    }
+    catch (e) {
+        if (isGantryUserError(e)) {
+            return mcpError(e.code, e.message, true);
+        }
+        return mcpError("INTERNAL_ERROR", e instanceof Error ? e.message : String(e), false);
+    }
+}
+//# sourceMappingURL=mcp-preflight-contract.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-preflight-contract.js","sourceRoot":"","sources":["../../../src/cli/lib/mcp-preflight-contract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAgD,MAAM,yBAAyB,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,QAAQ,EAAqB,MAAM,4BAA4B,CAAC;AACzE,OAAO,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAY/C,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAAgC,EAChC,IAAoD;IAEpD,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;YAC1B,OAAO,QAAQ,CAAC,kBAAkB,EAAE,oBAAoB,EAAE,IAAI,CAAC,CAAC;QAClE,CAAC;QACD,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,aAAa,EAAE,CAAC;QAC3C,MAAM,MAAM,GAAG,MAAM,YAAY,CAAC;YAChC,IAAI;YACJ,QAAQ;YACR,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE;YAC3B,KAAK,EAAE,KAAK,CAAC,KAAK;YAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;YACxB,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;YACzD,SAAS,EAAE,IAAI,EAAE,SAAS;SAC3B,CAAC,CAAC;QACH,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,CAAC;IACrC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,IAAI,iBAAiB,CAAC,CAAC,CAAC,EAAE,CAAC;YACzB,OAAO,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,QAAQ,CAAC,gBAAgB,EAAE,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACvF,CAAC;AACH,CAAC"}

package/dist/cli/lib/mcp-tools-register.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp-tools-register.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/mcp-tools-register.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAoVzE,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAqB3D"}
+{"version":3,"file":"mcp-tools-register.d.ts","sourceRoot":"","sources":["../../../src/cli/lib/mcp-tools-register.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAkWzE,0EAA0E;AAC1E,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsB3D"}

package/dist/cli/lib/mcp-tools-register.js

@@ -3,6 +3,7 @@ import { INTERROGATION_FINDING_KINDS } from "./interrogate/findings.js";
 import { handleCheckSignature } from "./mcp-check-signature.js";
 import { handleDraftLegislation } from "./mcp-draft-legislation.js";
 import { handleProposeContract } from "./mcp-propose-contract.js";
+import { handlePreflightContract } from "./mcp-preflight-contract.js";
 import { handleInterrogate } from "./mcp-interrogate.js";
 import { handleExecuteLegislation } from "./mcp-execute-legislation.js";
 import { handleAttest, handleLastError, handlePinMission, handleResolveMission, handleRuntimeEnv, handleRuntimeExec, handleScan, handleVerify, } from "./mcp-runtime.js";
@@ -73,6 +74,13 @@ function registerGxtProposeContractTool(server) {
         paths: z.array(z.string()).optional().describe("Declared path hints"),
     }, async (args) => jsonText(handleProposeContract(args)));
 }
+function registerGxtPreflightContractTool(server) {
+    server.tool("gxt_preflight_contract", "Experimental advisory classifier (heuristic default; optional Jev). Returns skill_key hints and tmvc_root_candidates. Never writes a contract. Call gxt_propose_contract next.", {
+        intent: z.string().describe("Planner intent / story"),
+        paths: z.array(z.string()).optional().describe("Declared path hints"),
+        provider: z.enum(["heuristic", "jev"]).optional().describe("heuristic (default, offline) or jev (requires TYPESAFE_API_KEY)"),
+    }, async (args) => jsonText(await handlePreflightContract(args)));
+}
 function registerGxtExecuteLegislationTool(server) {
     server.tool("gxt_execute_legislation", "Execute gantry legislate using a valid draft_token after explicit human chat approval.", {
         draft_token: z.string().describe("Token from gxt_draft_legislation"),
@@ -190,6 +198,7 @@ function registerGxtUpgradeApplyTool(server) {
 export function registerGxtMcpTools(server) {
     registerGxtInterrogateTool(server);
     registerGxtProposeContractTool(server);
+    registerGxtPreflightContractTool(server);
     registerGxtDraftLegislationTool(server);
     registerGxtExecuteLegislationTool(server);
     registerGxtCheckSignatureTool(server);