@pipelex/sdk 0.3.1 → 0.4.0

package/dist/hooks/check-core.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Engine-agnostic core of the `.mthds` PostToolUse hook: the per-stage verdict
+ * shapes and the mapping from verdicts to the hook's decision output.
+ *
+ * The three stages (lint, format, validate) are swappable engines — local WASM
+ * today, `client.lint`/`client.format` as the documented fallback, MCP calls
+ * later. Nothing in this module knows which engine produced a verdict; it only
+ * maps verdict → decision, mirroring the Stage-3 model of the plxt-era hook:
+ *
+ * - lint diagnostics            → BLOCK (agent fixes the file)
+ * - validate `is_valid: false`  → BLOCK (input-domain by construction: over the
+ *   API a produced verdict is always a 200; server/config faults are non-2xx =
+ *   no verdict = unavailable)
+ * - validate valid + pending `PipeSignature`s → non-blocking additionalContext
+ * - any stage unavailable       → fail-open (the other stages' verdicts stand)
+ */
+import type { Diagnostic, ValidationErrorItem } from "../models.js";
+/** Verdict of the local lint stage. `unavailable` = engine failed to load. */
+export type LintStage = {
+    status: "clean";
+} | {
+    status: "diagnostics";
+    diagnostics: Diagnostic[];
+} | {
+    status: "unavailable";
+};
+/** Verdict of the networked validate stage. `unavailable` = no verdict could be produced. */
+export type ValidateStage = {
+    status: "valid";
+    pendingSignatures: string[];
+} | {
+    status: "invalid";
+    message?: string;
+    validationErrors: ValidationErrorItem[];
+    renderedMarkdown?: string;
+} | {
+    status: "unavailable";
+};
+/** The hook's decision, prior to JSON encoding. */
+export type HookOutcome = {
+    kind: "pass";
+} | {
+    kind: "block";
+    reason: string;
+} | {
+    kind: "context";
+    context: string;
+};
+/**
+ * Which harness invoked the hook. Claude and Codex share the block /
+ * `hookSpecificOutput` stdout protocol; Mistral Vibe speaks
+ * deny / `hook_specific_output.additional_context`.
+ */
+export type HookPlatform = "claude" | "codex" | "vibe";
+/**
+ * Extract the edited `.mthds` path from the Claude PostToolUse stdin payload;
+ * null = not this hook's business (fail open, mirroring the plxt-era hook,
+ * which also passed silently on unparseable input).
+ */
+export declare function extractMthdsFilePath(stdinJson: string): string | null;
+/**
+ * Extract every distinct `.mthds` path from a Codex PostToolUse(apply_patch)
+ * payload. `apply_patch` is Codex's freeform multi-file write tool: the patch
+ * envelope rides verbatim in `tool_input.command`, and the touched files are
+ * its `*** Update File: / *** Add File: / *** Move to:` headers (`Delete
+ * File:` and `Move from:` are skipped — the file no longer exists post-patch).
+ * Mirrors `mthds-agent codex hook`'s parser. Paths come back as written in
+ * the envelope (usually cwd-relative); the caller resolves and existence-checks.
+ */
+export declare function extractCodexMthdsFiles(stdinJson: string): string[];
+/**
+ * Extract the edited `.mthds` path from a Mistral Vibe AfterToolInvocation
+ * payload, plus the cwd to resolve it against. Only successful tool calls
+ * count (`tool_status: "success"`); the path rides in `tool_output.file` /
+ * `tool_output.path` / `tool_input.file_path` / `tool_input.path` — the same
+ * fallback chain as the plxt-era Vibe hook.
+ */
+export declare function extractVibeMthdsFilePath(stdinJson: string): {
+    filePath: string;
+    cwd?: string;
+} | null;
+/**
+ * Merge per-file outcomes (Codex's `apply_patch` can touch several `.mthds`
+ * files in one call) into the single decision the hook emits: any block wins
+ * (reasons joined), else contexts are joined, else pass.
+ */
+export declare function mergeOutcomes(outcomes: HookOutcome[]): HookOutcome;
+export declare function truncate(text: string): string;
+/**
+ * Map the lint verdict to a decision. Every engine diagnostic is an error by
+ * construction (the shared Rust engine emits `severity: "error"` only), so any
+ * diagnostic blocks — the same bar as `plxt lint`'s non-zero exit.
+ */
+export declare function decideAfterLint(filePath: string, lint: LintStage): HookOutcome;
+/**
+ * Map the validate verdict to a decision.
+ *
+ * Invalid blocks with the server-rendered Markdown verbatim when present (the
+ * workspace's "surface output conventions": the wire is JSON, the agent reads
+ * Markdown), falling back to a client-side rendering of `validation_errors[]`.
+ * Valid passes, with a non-blocking nudge listing still-unimplemented
+ * `PipeSignature`s. Unavailable passes silently — the local lint/format
+ * verdicts already applied.
+ */
+export declare function decideAfterValidate(filePath: string, validate: ValidateStage): HookOutcome;
+/**
+ * Encode an outcome as the harness's stdout payload. `pass` is empty output;
+ * the hook always exits 0. Claude and Codex share the block /
+ * `hookSpecificOutput` protocol; Vibe speaks deny / `hook_specific_output`.
+ */
+export declare function encodeOutcome(outcome: HookOutcome, platform?: HookPlatform): string;

package/dist/hooks/check-core.js

@@ -0,0 +1,224 @@
+/**
+ * Engine-agnostic core of the `.mthds` PostToolUse hook: the per-stage verdict
+ * shapes and the mapping from verdicts to the hook's decision output.
+ *
+ * The three stages (lint, format, validate) are swappable engines — local WASM
+ * today, `client.lint`/`client.format` as the documented fallback, MCP calls
+ * later. Nothing in this module knows which engine produced a verdict; it only
+ * maps verdict → decision, mirroring the Stage-3 model of the plxt-era hook:
+ *
+ * - lint diagnostics            → BLOCK (agent fixes the file)
+ * - validate `is_valid: false`  → BLOCK (input-domain by construction: over the
+ *   API a produced verdict is always a 200; server/config faults are non-2xx =
+ *   no verdict = unavailable)
+ * - validate valid + pending `PipeSignature`s → non-blocking additionalContext
+ * - any stage unavailable       → fail-open (the other stages' verdicts stand)
+ */
+function parseJsonOrNull(stdinJson) {
+    try {
+        return JSON.parse(stdinJson);
+    }
+    catch {
+        return null; // fail open on unparseable input, mirroring the plxt-era hooks
+    }
+}
+/**
+ * Extract the edited `.mthds` path from the Claude PostToolUse stdin payload;
+ * null = not this hook's business (fail open, mirroring the plxt-era hook,
+ * which also passed silently on unparseable input).
+ */
+export function extractMthdsFilePath(stdinJson) {
+    const parsed = parseJsonOrNull(stdinJson);
+    const filePath = parsed?.tool_input
+        ?.file_path;
+    if (typeof filePath !== "string" || !filePath.endsWith(".mthds")) {
+        return null;
+    }
+    return filePath;
+}
+/**
+ * Extract every distinct `.mthds` path from a Codex PostToolUse(apply_patch)
+ * payload. `apply_patch` is Codex's freeform multi-file write tool: the patch
+ * envelope rides verbatim in `tool_input.command`, and the touched files are
+ * its `*** Update File: / *** Add File: / *** Move to:` headers (`Delete
+ * File:` and `Move from:` are skipped — the file no longer exists post-patch).
+ * Mirrors `mthds-agent codex hook`'s parser. Paths come back as written in
+ * the envelope (usually cwd-relative); the caller resolves and existence-checks.
+ */
+export function extractCodexMthdsFiles(stdinJson) {
+    const parsed = parseJsonOrNull(stdinJson);
+    const command = parsed?.tool_input?.command;
+    if (typeof command !== "string") {
+        return [];
+    }
+    const headerRe = /^\*\*\* (?:Update File|Add File|Move to):\s*(.+\.mthds)\s*$/gm;
+    const seen = new Set();
+    let match;
+    while ((match = headerRe.exec(command)) !== null) {
+        seen.add(match[1].trim());
+    }
+    return Array.from(seen);
+}
+/**
+ * Extract the edited `.mthds` path from a Mistral Vibe AfterToolInvocation
+ * payload, plus the cwd to resolve it against. Only successful tool calls
+ * count (`tool_status: "success"`); the path rides in `tool_output.file` /
+ * `tool_output.path` / `tool_input.file_path` / `tool_input.path` — the same
+ * fallback chain as the plxt-era Vibe hook.
+ */
+export function extractVibeMthdsFilePath(stdinJson) {
+    const parsed = parseJsonOrNull(stdinJson);
+    if (!parsed || parsed.tool_status !== "success") {
+        return null;
+    }
+    const candidates = [
+        parsed.tool_output?.file,
+        parsed.tool_output?.path,
+        parsed.tool_input?.file_path,
+        parsed.tool_input?.path,
+    ];
+    const filePath = candidates.find((value) => typeof value === "string" && value.endsWith(".mthds"));
+    if (!filePath) {
+        return null;
+    }
+    return { filePath, cwd: typeof parsed.cwd === "string" ? parsed.cwd : undefined };
+}
+/**
+ * Merge per-file outcomes (Codex's `apply_patch` can touch several `.mthds`
+ * files in one call) into the single decision the hook emits: any block wins
+ * (reasons joined), else contexts are joined, else pass.
+ */
+export function mergeOutcomes(outcomes) {
+    const blocks = outcomes.filter((outcome) => outcome.kind === "block");
+    if (blocks.length > 0) {
+        return { kind: "block", reason: truncate(blocks.map((block) => block.reason).join("\n\n")) };
+    }
+    const contexts = outcomes.filter((outcome) => outcome.kind === "context");
+    if (contexts.length > 0) {
+        return {
+            kind: "context",
+            context: truncate(contexts.map((context) => context.context).join("\n\n")),
+        };
+    }
+    return { kind: "pass" };
+}
+/** Cap on emitted reason/context bodies — same guard as the plxt-era hook. */
+const MAX_OUTPUT_CHARS = 9500;
+export function truncate(text) {
+    if (text.length <= MAX_OUTPUT_CHARS) {
+        return text;
+    }
+    const omitted = text.length - MAX_OUTPUT_CHARS;
+    return `${text.slice(0, MAX_OUTPUT_CHARS)}\n\n[truncated, ${omitted} chars omitted]`;
+}
+/**
+ * One diagnostic as an agent-actionable line: severity, locators, message.
+ * `location` and `range` are independent — a schema/semantic diagnostic can name
+ * its target (a pipe, a concept) without a byte span, so both render when present.
+ */
+function renderDiagnosticLine(diagnostic) {
+    const locators = [
+        diagnostic.location,
+        diagnostic.range && `line ${diagnostic.range.start_line}, col ${diagnostic.range.start_col}`,
+    ].filter(Boolean);
+    const span = locators.length > 0 ? ` (${locators.join(", ")})` : "";
+    return `- [${diagnostic.kind}/${diagnostic.severity}] ${diagnostic.message}${span}`;
+}
+/**
+ * Map the lint verdict to a decision. Every engine diagnostic is an error by
+ * construction (the shared Rust engine emits `severity: "error"` only), so any
+ * diagnostic blocks — the same bar as `plxt lint`'s non-zero exit.
+ */
+export function decideAfterLint(filePath, lint) {
+    if (lint.status !== "diagnostics" || lint.diagnostics.length === 0) {
+        return { kind: "pass" };
+    }
+    const lines = [
+        `MTHDS lint errors in ${filePath}:`,
+        "",
+        ...lint.diagnostics.map(renderDiagnosticLine),
+    ];
+    return { kind: "block", reason: truncate(lines.join("\n")) };
+}
+/** One validation error with its locators — mirror of the plxt-era rendering. */
+function renderValidationErrorLine(item) {
+    const locators = [
+        item.pipe_code && `pipe ${item.pipe_code}`,
+        item.concept_code && `concept ${item.concept_code}`,
+        item.field_name && `field ${item.field_name}`,
+        item.source && `source ${item.source}`,
+    ]
+        .filter(Boolean)
+        .join(", ");
+    return `- [${item.category ?? "error"}] ${item.message ?? ""}${locators ? ` (${locators})` : ""}`;
+}
+/**
+ * Map the validate verdict to a decision.
+ *
+ * Invalid blocks with the server-rendered Markdown verbatim when present (the
+ * workspace's "surface output conventions": the wire is JSON, the agent reads
+ * Markdown), falling back to a client-side rendering of `validation_errors[]`.
+ * Valid passes, with a non-blocking nudge listing still-unimplemented
+ * `PipeSignature`s. Unavailable passes silently — the local lint/format
+ * verdicts already applied.
+ */
+export function decideAfterValidate(filePath, validate) {
+    switch (validate.status) {
+        case "unavailable":
+            return { kind: "pass" };
+        case "valid": {
+            if (validate.pendingSignatures.length === 0) {
+                return { kind: "pass" };
+            }
+            const context = "Bundle is valid but not yet runnable. Signatures still unimplemented (PipeSignature placeholders): " +
+                validate.pendingSignatures.join(", ") +
+                ". They mock their output on dry-run; implement them before running the method for real.";
+            return { kind: "context", context: truncate(context) };
+        }
+        case "invalid": {
+            if (validate.renderedMarkdown) {
+                return { kind: "block", reason: truncate(validate.renderedMarkdown) };
+            }
+            const lines = [
+                `Validation failed for ${filePath}:`,
+                "",
+                validate.message || "Bundle is invalid.",
+            ];
+            if (validate.validationErrors.length > 0) {
+                lines.push("");
+                lines.push(...validate.validationErrors.map(renderValidationErrorLine));
+            }
+            return { kind: "block", reason: truncate(lines.join("\n")) };
+        }
+    }
+}
+/**
+ * Encode an outcome as the harness's stdout payload. `pass` is empty output;
+ * the hook always exits 0. Claude and Codex share the block /
+ * `hookSpecificOutput` protocol; Vibe speaks deny / `hook_specific_output`.
+ */
+export function encodeOutcome(outcome, platform = "claude") {
+    switch (outcome.kind) {
+        case "pass":
+            return "";
+        case "block":
+            if (platform === "vibe") {
+                return JSON.stringify({ decision: "deny", reason: outcome.reason }) + "\n";
+            }
+            return JSON.stringify({ decision: "block", reason: outcome.reason }) + "\n";
+        case "context":
+            if (platform === "vibe") {
+                return (JSON.stringify({
+                    decision: "allow",
+                    hook_specific_output: { additional_context: outcome.context },
+                }) + "\n");
+            }
+            return (JSON.stringify({
+                hookSpecificOutput: {
+                    hookEventName: "PostToolUse",
+                    additionalContext: outcome.context,
+                },
+            }) + "\n");
+    }
+}
+//# sourceMappingURL=check-core.js.map

package/dist/hooks/check-core.js.map

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

package/dist/hooks/claude-mthds-check.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Entry point of the `.mthds` post-edit hook bundle (`check.mjs`).
+ *
+ * One bundle serves all three harnesses behind `--platform=claude|codex|vibe`
+ * (default claude) — the platform decides how the edited file(s) are extracted
+ * from the stdin payload and which stdout dialect the decision is encoded in;
+ * the pipeline itself is identical:
+ *
+ *   1. local lint  (`@pipelex/tools-wasm` — offline, no credentials) → BLOCK on diagnostics
+ *   2. local format (same engine) → write back in place when changed
+ *   3. API validate (`POST /v1/validate` via the SDK, `allow_signatures: true`)
+ *      → BLOCK on an invalid verdict, non-blocking nudge on pending signatures
+ *
+ * Per-platform input: Claude reads `tool_input.file_path` (one file); Codex
+ * parses the `apply_patch` envelope in `tool_input.command` (possibly several
+ * files — outcomes are merged, any block wins); Vibe reads the
+ * AfterToolInvocation payload (`tool_status` gate, path resolved against `cwd`).
+ *
+ * Failure posture (fail-open, per the networked-hook plan):
+ * - no `.mthds` in the payload / unparseable stdin → pass silently
+ * - WASM engine fails to load → whole hook unavailable → pass silently
+ * - validate unavailable (no `PIPELEX_API_KEY`, network error, timeout, any
+ *   non-2xx, bundle-gather overflow) → the local lint/format verdicts already
+ *   applied; the validate stage passes silently
+ *
+ * The hook always exits 0; a block/deny is expressed on stdout, never via the
+ * exit code.
+ */
+export {};

package/dist/hooks/claude-mthds-check.js

@@ -0,0 +1,220 @@
+/**
+ * Entry point of the `.mthds` post-edit hook bundle (`check.mjs`).
+ *
+ * One bundle serves all three harnesses behind `--platform=claude|codex|vibe`
+ * (default claude) — the platform decides how the edited file(s) are extracted
+ * from the stdin payload and which stdout dialect the decision is encoded in;
+ * the pipeline itself is identical:
+ *
+ *   1. local lint  (`@pipelex/tools-wasm` — offline, no credentials) → BLOCK on diagnostics
+ *   2. local format (same engine) → write back in place when changed
+ *   3. API validate (`POST /v1/validate` via the SDK, `allow_signatures: true`)
+ *      → BLOCK on an invalid verdict, non-blocking nudge on pending signatures
+ *
+ * Per-platform input: Claude reads `tool_input.file_path` (one file); Codex
+ * parses the `apply_patch` envelope in `tool_input.command` (possibly several
+ * files — outcomes are merged, any block wins); Vibe reads the
+ * AfterToolInvocation payload (`tool_status` gate, path resolved against `cwd`).
+ *
+ * Failure posture (fail-open, per the networked-hook plan):
+ * - no `.mthds` in the payload / unparseable stdin → pass silently
+ * - WASM engine fails to load → whole hook unavailable → pass silently
+ * - validate unavailable (no `PIPELEX_API_KEY`, network error, timeout, any
+ *   non-2xx, bundle-gather overflow) → the local lint/format verdicts already
+ *   applied; the validate stage passes silently
+ *
+ * The hook always exits 0; a block/deny is expressed on stdout, never via the
+ * exit code.
+ */
+import { existsSync, readFileSync, writeFileSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
+import { PipelexApiClient } from "../client.js";
+import { decideAfterLint, decideAfterValidate, encodeOutcome, extractCodexMthdsFiles, extractMthdsFilePath, extractVibeMthdsFilePath, mergeOutcomes, } from "./check-core.js";
+import { gatherBundle } from "./bundle-gather.js";
+/** Per-request ceiling on the one network call — well under the hook's overall timeout. */
+const VALIDATE_TIMEOUT_MS = 10_000;
+async function readStdin() {
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+    }
+    return Buffer.concat(chunks).toString("utf-8");
+}
+function parsePlatform(argv) {
+    for (const arg of argv) {
+        if (arg.startsWith("--platform=")) {
+            const value = arg.slice("--platform=".length);
+            if (value === "claude" || value === "codex" || value === "vibe") {
+                return value;
+            }
+        }
+    }
+    return "claude";
+}
+/** The absolute paths of edited `.mthds` files that exist on disk, per platform. */
+function resolveTargets(platform, stdinJson) {
+    let candidates;
+    switch (platform) {
+        case "claude": {
+            const filePath = extractMthdsFilePath(stdinJson);
+            candidates = filePath ? [filePath] : [];
+            break;
+        }
+        case "codex": {
+            candidates = extractCodexMthdsFiles(stdinJson).map((raw) => resolvePath(process.cwd(), raw));
+            break;
+        }
+        case "vibe": {
+            const extracted = extractVibeMthdsFilePath(stdinJson);
+            candidates = extracted
+                ? [resolvePath(extracted.cwd ?? process.cwd(), extracted.filePath)]
+                : [];
+            break;
+        }
+    }
+    // Deleted/renamed-away files have nothing to check (Codex envelopes list
+    // paths that may not survive the patch; Claude edits can race a delete).
+    return candidates.filter((filePath) => existsSync(filePath));
+}
+/**
+ * Load the WASM engine. The one-line "deprecated parameters" warning the
+ * wasm-bindgen loader glue prints on first initialize is dropped — it is
+ * upstream noise, not a hook diagnostic.
+ */
+async function loadEngine() {
+    const engine = await import("@pipelex/tools-wasm");
+    /* eslint-disable no-console */
+    const originalWarn = console.warn;
+    console.warn = (...args) => {
+        if (typeof args[0] === "string" && args[0].includes("deprecated parameters")) {
+            return;
+        }
+        originalWarn.apply(console, args);
+    };
+    try {
+        await engine.initialize();
+    }
+    finally {
+        console.warn = originalWarn;
+    }
+    /* eslint-enable no-console */
+    return engine;
+}
+/**
+ * Run the networked validate stage. Every no-verdict condition maps to
+ * `unavailable` — a machine consumer branches on the structured verdict,
+ * never on transport.
+ */
+async function runValidateStage(filePath) {
+    if (!process.env.PIPELEX_API_KEY) {
+        return { status: "unavailable" };
+    }
+    const gathered = gatherBundle(filePath);
+    if (!gathered.ok) {
+        return { status: "unavailable" };
+    }
+    try {
+        const client = new PipelexApiClient();
+        // The client owns the ceiling: on timeout it aborts the fetch itself, so the
+        // request does not keep running after the hook has given up on it.
+        const result = await client.validateFiles(gathered.files, {
+            allowSignatures: true,
+            timeoutMs: VALIDATE_TIMEOUT_MS,
+        });
+        if (result.is_valid === true) {
+            return {
+                status: "valid",
+                pendingSignatures: Array.isArray(result.pending_signatures)
+                    ? result.pending_signatures
+                    : [],
+            };
+        }
+        if (result.is_valid === false) {
+            return {
+                status: "invalid",
+                message: result.message,
+                validationErrors: Array.isArray(result.validation_errors) ? result.validation_errors : [],
+                renderedMarkdown: result.rendered_markdown,
+            };
+        }
+        return { status: "unavailable" }; // no discriminant — no verdict
+    }
+    catch {
+        return { status: "unavailable" };
+    }
+}
+/** Synchronous fd-1 write — the process exits right after, an async write could truncate. */
+function emit(outcome, platform) {
+    const encoded = encodeOutcome(outcome, platform);
+    if (encoded) {
+        writeFileSync(1, encoded);
+    }
+}
+/** Synchronous fd-2 write, for the same reason. */
+function warn(message) {
+    writeFileSync(2, `[mthds-hook] ${message}\n`);
+}
+/** The full pipeline on one edited file: lint → format write-back → validate. */
+async function checkOneFile(engine, filePath) {
+    let content;
+    try {
+        content = readFileSync(filePath, "utf-8");
+    }
+    catch {
+        return { kind: "pass" }; // file gone since the existence check — nothing to gate
+    }
+    // Stage 1 — local lint
+    const lintStage = {
+        status: "diagnostics",
+        diagnostics: engine.lintMthds(content).diagnostics,
+    };
+    const lintOutcome = decideAfterLint(filePath, lintStage);
+    if (lintOutcome.kind !== "pass") {
+        return lintOutcome;
+    }
+    // Stage 2 — local format, write back in place (mirrors `plxt fmt`)
+    try {
+        const formatted = engine.formatMthds(content);
+        if (formatted.changed) {
+            writeFileSync(filePath, formatted.formatted);
+        }
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        warn(`Warning: format failed: ${message}`);
+    }
+    // Stage 3 — API validate
+    return decideAfterValidate(filePath, await runValidateStage(filePath));
+}
+async function main() {
+    const platform = parsePlatform(process.argv.slice(2));
+    const filePaths = resolveTargets(platform, await readStdin());
+    if (filePaths.length === 0) {
+        return;
+    }
+    let engine;
+    try {
+        engine = await loadEngine();
+    }
+    catch {
+        return; // engine unavailable — whole hook fails open
+    }
+    const outcomes = [];
+    for (const filePath of filePaths) {
+        outcomes.push(await checkOneFile(engine, filePath));
+    }
+    emit(mergeOutcomes(outcomes), platform);
+}
+main()
+    .catch((err) => {
+    // Fail open: an unexpected hook fault must never block the write.
+    const message = err instanceof Error ? err.message : String(err);
+    warn(`Hook error (fail-open): ${message}`);
+})
+    .finally(() => {
+    // The WASM engine (and any raced-out fetch) can hold the event loop open;
+    // the decision is already flushed (synchronous fd writes), so end the
+    // process deterministically.
+    process.exit(0);
+});
+//# sourceMappingURL=claude-mthds-check.js.map

package/dist/hooks/claude-mthds-check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-mthds-check.js","sourceRoot":"","sources":["../../src/hooks/claude-mthds-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,aAAa,EACb,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACxB,aAAa,GAKd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,2FAA2F;AAC3F,MAAM,mBAAmB,GAAG,MAAM,CAAC;AAInC,KAAK,UAAU,SAAS;IACtB,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,KAAe,CAAC,CAAC;IAC/B,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;AACjD,CAAC;AAED,SAAS,aAAa,CAAC,IAAc;IACnC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;YAClC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;gBAChE,OAAO,KAAK,CAAC;YACf,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,oFAAoF;AACpF,SAAS,cAAc,CAAC,QAAsB,EAAE,SAAiB;IAC/D,IAAI,UAAoB,CAAC;IACzB,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,QAAQ,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;YACjD,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACxC,MAAM;QACR,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,UAAU,GAAG,sBAAsB,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;YAC7F,MAAM;QACR,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,SAAS,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;YACtD,UAAU,GAAG,SAAS;gBACpB,CAAC,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,QAAQ,CAAC,CAAC;gBACnE,CAAC,CAAC,EAAE,CAAC;YACP,MAAM;QACR,CAAC;IACH,CAAC;IACD,yEAAyE;IACzE,yEAAyE;IACzE,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,UAAU;IACvB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;IACnD,+BAA+B;IAC/B,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAClC,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,IAAe,EAAE,EAAE;QACpC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC;YAC7E,OAAO;QACT,CAAC;QACD,YAAY,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACpC,CAAC,CAAC;IACF,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,UAAU,EAAE,CAAC;IAC5B,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,IAAI,GAAG,YAAY,CAAC;IAC9B,CAAC;IACD,8BAA8B;IAC9B,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,gBAAgB,CAAC,QAAgB;IAC9C,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QACjC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACnC,CAAC;IACD,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACnC,CAAC;IACD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACtC,6EAA6E;QAC7E,mEAAmE;QACnE,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,EAAE;YACxD,eAAe,EAAE,IAAI;YACrB,SAAS,EAAE,mBAAmB;SAC/B,CAAC,CAAC;QACH,IAAI,MAAM,CAAC,QAAQ,KAAK,IAAI,EAAE,CAAC;YAC7B,OAAO;gBACL,MAAM,EAAE,OAAO;gBACf,iBAAiB,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,kBAAkB,CAAC;oBACzD,CAAC,CAAC,MAAM,CAAC,kBAAkB;oBAC3B,CAAC,CAAC,EAAE;aACP,CAAC;QACJ,CAAC;QACD,IAAI,MAAM,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC9B,OAAO;gBACL,MAAM,EAAE,SAAS;gBACjB,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,gBAAgB,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,EAAE;gBACzF,gBAAgB,EAAE,MAAM,CAAC,iBAAiB;aAC3C,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC,CAAC,+BAA+B;IACnE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACnC,CAAC;AACH,CAAC;AAED,6FAA6F;AAC7F,SAAS,IAAI,CAAC,OAAoB,EAAE,QAAsB;IACxD,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;IACjD,IAAI,OAAO,EAAE,CAAC;QACZ,aAAa,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,mDAAmD;AACnD,SAAS,IAAI,CAAC,OAAe;IAC3B,aAAa,CAAC,CAAC,EAAE,gBAAgB,OAAO,IAAI,CAAC,CAAC;AAChD,CAAC;AAED,iFAAiF;AACjF,KAAK,UAAU,YAAY,CAAC,MAAuB,EAAE,QAAgB;IACnE,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC,wDAAwD;IACnF,CAAC;IAED,uBAAuB;IACvB,MAAM,SAAS,GAAc;QAC3B,MAAM,EAAE,aAAa;QACrB,WAAW,EAAE,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,WAAW;KACnD,CAAC;IACF,MAAM,WAAW,GAAG,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IACzD,IAAI,WAAW,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAChC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,mEAAmE;IACnE,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,MAAM,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAC9C,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;YACtB,aAAa,CAAC,QAAQ,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACjE,IAAI,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,yBAAyB;IACzB,OAAO,mBAAmB,CAAC,QAAQ,EAAE,MAAM,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,KAAK,UAAU,IAAI;IACjB,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,cAAc,CAAC,QAAQ,EAAE,MAAM,SAAS,EAAE,CAAC,CAAC;IAC9D,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,IAAI,MAAuB,CAAC;IAC5B,IAAI,CAAC;QACH,MAAM,GAAG,MAAM,UAAU,EAAE,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,6CAA6C;IACvD,CAAC;IAED,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,MAAM,YAAY,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACtD,CAAC;IACD,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED,IAAI,EAAE;KACH,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACtB,kEAAkE;IAClE,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,IAAI,CAAC,2BAA2B,OAAO,EAAE,CAAC,CAAC;AAC7C,CAAC,CAAC;KACD,OAAO,CAAC,GAAG,EAAE;IACZ,0EAA0E;IAC1E,sEAAsE;IACtE,6BAA6B;IAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -7,12 +7,12 @@
  * errors. Consumers should import everything they need from `@pipelex/sdk`.
  */
 /** Package version. Kept in sync with `package.json` — enforced by `tests/index.test.ts`. */
-export declare const SDK_VERSION = "0.3.1";
+export declare const SDK_VERSION = "0.4.0";
 export * from "mthds/protocol";
 export { PipelexApiClient, DEFAULT_API_BASE_URL } from "./client.js";
 export type { MthdsFile, ValidateFilesOptions, PipelexApiClientOptions } from "./client.js";
 export { PipelexExecuteResult } from "./execute-result.js";
-export type { DictStuff, DictWorkingMemory, DictPipeOutput, DictRunResultExecute, DryRunStatus, ValidatedPipeEntry, PipelexValidationReport, PipelexInvalidReport, PipelexValidationResult, ValidationErrorCategory, ValidationErrorItem, ConceptRepresentationFormat, BuildInputsRequest, BuildOutputRequest, BuildRunnerRequest, ConceptRequest, PipeSpecRequest, BuildRunnerResponse, ConceptResponse, PipeSpecResponse, } from "./models.js";
+export type { DiagnosticKind, DiagnosticRange, Diagnostic, LintResponse, FormatResponse, DictStuff, DictWorkingMemory, DictPipeOutput, DictRunResultExecute, DryRunStatus, ValidatedPipeEntry, PipelexValidationReport, PipelexInvalidReport, PipelexValidationResult, ValidationErrorCategory, ValidationErrorItem, ConceptRepresentationFormat, InputsTemplateFormat, MthdsFileItem, BuildRequestBase, BuildInputsRequest, BuildOutputRequest, BuildRunnerRequest, ConceptRequest, PipeSpecRequest, CrateInvalidReport, BuildInputsValidReport, BuildOutputValidReport, BuildRunnerValidReport, GeneratedArtifact, RunnerStructures, BuildInputsResponse, BuildOutputResponse, BuildRunnerResponse, ConceptResponse, PipeSpecResponse, } from "./models.js";
 export type { UserProfile, MethodData, MethodWriteInput, Membership, MembershipsResponse, SubscriptionResponse, PlanView, InvoiceView, CheckoutResponse, ChangePlanResponse, BillingPortalResponse, PipelexApiKey, PipelexApiKeyCreated, PipelexApiKeyList, GatewayApiKey, GatewayApiKeyStatus, OnboardingRole, OnboardingCurrentTool, OnboardingInputType, OnboardingHeardFrom, OnboardingSubmission, ResolvedStorageUrl, UploadInput, UploadedFile, PipeStatus, PipelineRun, UpdateRunInput, } from "./product-models.js";
 export { isTerminalRunStatus, isSuccessRunStatus } from "./runs.js";
 export type { RunStatus, RunPublic, RunRead, RunResults, RunResultState, WaitForResultOptions, } from "./runs.js";

package/dist/index.js

@@ -7,7 +7,7 @@
  * errors. Consumers should import everything they need from `@pipelex/sdk`.
  */
 /** Package version. Kept in sync with `package.json` — enforced by `tests/index.test.ts`. */
-export const SDK_VERSION = "0.3.1";
+export const SDK_VERSION = "0.4.0";
 // ── Pure MTHDS Protocol surface (re-exported from the `mthds/protocol` subpath) ──
 // The standard's interface, wire models, request/options surface, abstract domain
 // shapes, and the protocol-base `PipelineRequestError`. Re-exported so apps have a

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6FAA6F;AAC7F,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC,oFAAoF;AACpF,kFAAkF;AAClF,mFAAmF;AACnF,wBAAwB;AACxB,cAAc,gBAAgB,CAAC;AAE/B,wEAAwE;AACxE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGrE,4FAA4F;AAC5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAyD3D,wEAAwE;AACxE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAUpE,+EAA+E;AAC/E,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,EAC3B,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,6FAA6F;AAC7F,MAAM,CAAC,MAAM,WAAW,GAAG,OAAO,CAAC;AAEnC,oFAAoF;AACpF,kFAAkF;AAClF,mFAAmF;AACnF,wBAAwB;AACxB,cAAc,gBAAgB,CAAC;AAE/B,wEAAwE;AACxE,OAAO,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGrE,4FAA4F;AAC5F,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAyE3D,wEAAwE;AACxE,OAAO,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAUpE,+EAA+E;AAC/E,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,yBAAyB,EACzB,qBAAqB,EACrB,2BAA2B,EAC3B,cAAc,EACd,eAAe,EACf,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,aAAa,CAAC"}