agentera 3.0.0-dev.5 → 3.0.0-dev.7

package/dist/hooks/todoLayout.js

@@ -0,0 +1,177 @@
+/**
+ * TODO.md layout contract: open items live in severity bands; resolved
+ * items live only under `## ✓ Resolved`. Shared by validate-artifact and
+ * compaction so mis-placed resolved rows cannot bypass retention gates.
+ */
+import { parseTodoMarkdownListItem } from "../cli/todoMarkdown.js";
+import { parseEntries } from "./compaction/parse.js";
+const SEVERITY_HEADING_RE = /^##\s*(⇶|⇉|→|⇢)\s/m;
+const RESOLVED_HEADING_RE = /^##\s*(?:✓\s+)?Resolved\s*$/im;
+const STRIKETHROUGH_ITEM_RE = /^(\s*)-\s+~~(.+?)~~\s*(.*)$/;
+export function isTodoSeveritySectionHeading(line) {
+    return SEVERITY_HEADING_RE.test(line.trim());
+}
+export function isTodoResolvedSectionHeading(line) {
+    return RESOLVED_HEADING_RE.test(line.trim());
+}
+export function classifyTodoSectionHeading(line) {
+    if (isTodoSeveritySectionHeading(line))
+        return "severity";
+    if (isTodoResolvedSectionHeading(line))
+        return "resolved";
+    if (/^##\s/.test(line.trim()))
+        return "other";
+    return "other";
+}
+export function strikethroughTodoLineToCheckbox(line) {
+    const m = STRIKETHROUGH_ITEM_RE.exec(line);
+    if (!m)
+        return null;
+    const tail = m[3]?.trim();
+    const body = m[2].trim();
+    return `${m[1]}- [x] ${body}${tail ? (tail.startsWith("·") ? ` ${tail}` : ` ${tail}`) : ""}`;
+}
+export function isLegacyStrikethroughTodoLine(line) {
+    return /^(\s*)-\s+~~/.test(line);
+}
+export function countTodoResolvedInSeverityBands(content) {
+    let count = 0;
+    let section = "other";
+    for (const line of content.split(/\r\n|\r|\n/)) {
+        const kind = classifyTodoSectionHeading(line);
+        if (kind !== "other" || /^##\s/.test(line.trim())) {
+            section = kind;
+            continue;
+        }
+        if (section !== "severity")
+            continue;
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("-"))
+            continue;
+        const parsed = parseTodoMarkdownListItem(trimmed);
+        if (parsed?.status === "resolved" || isLegacyStrikethroughTodoLine(trimmed)) {
+            count += 1;
+        }
+    }
+    return count;
+}
+export function countTodoResolvedEntries(content) {
+    const resolvedSection = parseEntries(content, "todo-resolved");
+    const misplaced = countTodoResolvedInSeverityBands(content);
+    return {
+        full: resolvedSection.filter((e) => e.kind === "full").length,
+        oneline: resolvedSection.filter((e) => e.kind === "oneline").length + misplaced,
+    };
+}
+export function validateTodoResolvedPlacement(content, name) {
+    const violations = [];
+    let section = "other";
+    let hasResolvedHeading = RESOLVED_HEADING_RE.test(content);
+    let hasResolvedItems = false;
+    for (const line of content.split(/\r\n|\r|\n/)) {
+        const kind = classifyTodoSectionHeading(line);
+        if (kind === "resolved") {
+            hasResolvedHeading = true;
+            section = "resolved";
+            continue;
+        }
+        if (kind === "severity") {
+            section = "severity";
+            continue;
+        }
+        if (/^##\s/.test(line.trim())) {
+            section = "other";
+            continue;
+        }
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("-"))
+            continue;
+        const parsed = parseTodoMarkdownListItem(trimmed);
+        if (parsed?.status === "resolved") {
+            hasResolvedItems = true;
+            if (section === "severity") {
+                violations.push(`${name}: resolved checkbox item must live under '## ✓ Resolved', not in severity bands`);
+                break;
+            }
+        }
+        if (isLegacyStrikethroughTodoLine(trimmed)) {
+            hasResolvedItems = true;
+            violations.push(`${name}: legacy strikethrough resolved items are not allowed; use '- [x]' under '## ✓ Resolved'`);
+            break;
+        }
+    }
+    if (hasResolvedItems && !hasResolvedHeading) {
+        violations.push(`${name}: missing '## ✓ Resolved' section for resolved items`);
+    }
+    return violations;
+}
+/**
+ * Move resolved rows from severity bands into `## ✓ Resolved`, creating the
+ * section when absent. Newly migrated rows are prepended (newest-first folds).
+ */
+export function normalizeTodoResolvedLayout(content) {
+    const lines = content.split(/\r\n|\r|\n/);
+    const beforeResolved = [];
+    const migratedResolved = [];
+    const existingResolved = [];
+    const afterResolved = [];
+    let section = "other";
+    let seenResolvedHeading = false;
+    for (const line of lines) {
+        const headingKind = classifyTodoSectionHeading(line);
+        if (headingKind === "resolved") {
+            seenResolvedHeading = true;
+            section = "resolved";
+            continue;
+        }
+        if (headingKind === "severity") {
+            section = "severity";
+            if (!seenResolvedHeading)
+                beforeResolved.push(line);
+            else
+                afterResolved.push(line);
+            continue;
+        }
+        if (/^##\s/.test(line.trim())) {
+            section = "other";
+            if (!seenResolvedHeading)
+                beforeResolved.push(line);
+            else
+                afterResolved.push(line);
+            continue;
+        }
+        const trimmed = line.trim();
+        if (section === "resolved") {
+            if (trimmed)
+                existingResolved.push(line);
+            continue;
+        }
+        if (section === "severity" && trimmed.startsWith("-")) {
+            const converted = strikethroughTodoLineToCheckbox(line) ?? line;
+            const parsed = parseTodoMarkdownListItem(converted.trim());
+            if (parsed?.status === "resolved" || isLegacyStrikethroughTodoLine(trimmed)) {
+                migratedResolved.push(converted.trim());
+                continue;
+            }
+        }
+        if (!seenResolvedHeading)
+            beforeResolved.push(line);
+        else
+            afterResolved.push(line);
+    }
+    if (migratedResolved.length === 0) {
+        return { text: content, changed: false };
+    }
+    const rebuilt = [...beforeResolved];
+    if (rebuilt.length > 0 && rebuilt[rebuilt.length - 1]?.trim() !== "")
+        rebuilt.push("");
+    rebuilt.push("## ✓ Resolved");
+    rebuilt.push(...migratedResolved, ...existingResolved);
+    if (afterResolved.length > 0) {
+        rebuilt.push("");
+        rebuilt.push(...afterResolved);
+    }
+    const text = rebuilt.join("\n").replace(/\n*$/, "\n");
+    return { text, changed: text !== content };
+}
+//# sourceMappingURL=todoLayout.js.map

package/dist/hooks/todoLayout.js.map

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

package/dist/hooks/validateArtifact/agentFacing.js

@@ -0,0 +1,10 @@
+/**
+ * Re-exports of protocol classification sets used by the validator.
+ * Kept as a separate module so the runtime, schema, and orchestrator
+ * submodules can all share the same set identity (no duplication of
+ * the AGENT_FACING_ARTIFACT_IDS computation across hot paths).
+ */
+import { ARTIFACT_PROTOCOL_PATHS, HUMAN_FACING_ARTIFACT_IDS } from "../../registries/artifactProtocolIds.js";
+export { ARTIFACT_PROTOCOL_PATHS, HUMAN_FACING_ARTIFACT_IDS };
+export const AGENT_FACING_ARTIFACT_IDS = new Set(Object.keys(ARTIFACT_PROTOCOL_PATHS).filter((id) => !HUMAN_FACING_ARTIFACT_IDS.has(id)));
+//# sourceMappingURL=agentFacing.js.map

package/dist/hooks/validateArtifact/agentFacing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agentFacing.js","sourceRoot":"","sources":["../../../src/hooks/validateArtifact/agentFacing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,yCAAyC,CAAC;AAE7G,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,CAAC;AAE9D,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,GAAG,CAC9C,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,yBAAyB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CACxF,CAAC"}

package/dist/hooks/validateArtifact/index.js

@@ -0,0 +1,151 @@
+/**
+ * Public surface for the validate-artifact hook. The CLI command
+ * (`packages/cli/src/cli/commands/validate.ts`), the smoke checks, and
+ * the dispatch entry all import the public classes from this barrel
+ * to keep import paths stable as the file is split across the
+ * per-responsibility submodules.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import { loadYamlMapping } from "../../core/yaml.js";
+import { resolvePath } from "../../core/paths.js";
+import { normalizeArtifactProtocolId } from "../../registries/artifactProtocolIds.js";
+import { DEFAULT_ARTIFACT_PATHS } from "../common.js";
+import { ArtifactWrite, RuntimeEventParser } from "./runtime.js";
+import { isMapping } from "./schema.js";
+import { validateMd } from "./markdown.js";
+import { artifactForWrite, defaultArtifactPath, readIfNeeded, compactAfterValidWrite, } from "./traversal.js";
+import { schemasDirDefault, validateYamlContent } from "./violations.js";
+import { AGENT_FACING_ARTIFACT_IDS, HUMAN_FACING_ARTIFACT_IDS } from "./agentFacing.js";
+export class ArtifactSchemaValidator {
+    schemasDir;
+    schemaCache;
+    constructor(schemasDir = schemasDirDefault()) {
+        this.schemasDir = schemasDir;
+        this.schemaCache = new Map();
+    }
+    loadSchema(name) {
+        if (!this.schemaCache.has(name)) {
+            const p = path.join(this.schemasDir, `${name}.yaml`);
+            if (fs.existsSync(p) && fs.statSync(p).isFile()) {
+                // cast: artifact schema parsed from a YAML schema file
+                this.schemaCache.set(name, loadYamlMapping(fs.readFileSync(p, "utf8")));
+            }
+            else {
+                this.schemaCache.set(name, null);
+            }
+        }
+        return this.schemaCache.get(name) ?? null;
+    }
+    validateYaml(content, schema, name) {
+        return validateYamlContent(content, schema, name);
+    }
+    validateMarkdown(content, name, schema = null) {
+        return validateMd(content, name, schema);
+    }
+    validateWrite(write, cwd) {
+        const absPath = path.isAbsolute(write.file_path) ? write.file_path : path.join(cwd, write.file_path);
+        const rel = path.relative(cwd, absPath).replace(/\\/g, "/");
+        const basename = path.basename(absPath);
+        const artifact = artifactForWrite(absPath, rel, basename, cwd);
+        if (artifact && AGENT_FACING_ARTIFACT_IDS.has(artifact)) {
+            const schema = this.loadSchema(artifact);
+            if (schema === null)
+                return [];
+            if (Object.keys(schema).length === 0)
+                return [`${artifact}: schema file is empty or contains no valid definitions`];
+            const content = readIfNeeded(write.content, absPath);
+            if (content === null)
+                return [];
+            let violations = this.validateYaml(content, schema, artifact);
+            if (violations.length > 0)
+                return violations;
+            return compactAfterValidWrite(artifact, absPath);
+        }
+        if (artifact && HUMAN_FACING_ARTIFACT_IDS.has(artifact)) {
+            const content = readIfNeeded(write.content, absPath);
+            if (content === null)
+                return [];
+            const schema = this.loadSchema(artifact);
+            const violations = this.validateMarkdown(content, artifact, schema);
+            if (violations.length > 0)
+                return violations;
+            return compactAfterValidWrite(artifact, absPath);
+        }
+        return [];
+    }
+    validateExplicit(artifact, filePath, cwd) {
+        const content = readIfNeeded(null, filePath);
+        if (content === null)
+            return [`${artifact}: cannot read artifact file '${filePath}'`];
+        const protocolId = normalizeArtifactProtocolId(artifact);
+        if (protocolId === null) {
+            return [`${artifact}: unsupported artifact protocol id`];
+        }
+        if (AGENT_FACING_ARTIFACT_IDS.has(protocolId)) {
+            const schema = this.loadSchema(protocolId);
+            if (schema === null)
+                return [`${protocolId}: schema '${protocolId}' is not available`];
+            if (Object.keys(schema).length === 0) {
+                return [`${protocolId}: schema '${protocolId}' file is empty or contains no valid definitions`];
+            }
+            return this.validateYaml(content, schema, protocolId);
+        }
+        if (HUMAN_FACING_ARTIFACT_IDS.has(protocolId)) {
+            const schema = this.loadSchema(protocolId);
+            return this.validateMarkdown(content, artifact, schema);
+        }
+        return [
+            `${artifact}: unsupported artifact; expected one of: ${Object.keys(DEFAULT_ARTIFACT_PATHS).sort().join(", ")}`,
+        ];
+    }
+}
+export function loadSchema(name) {
+    return new ArtifactSchemaValidator().loadSchema(name);
+}
+export class HookCliAdapter {
+    parser;
+    validator;
+    constructor(parser, validator) {
+        this.parser = parser ?? new RuntimeEventParser();
+        this.validator = validator ?? new ArtifactSchemaValidator();
+    }
+    run(raw, defaultCwd = null) {
+        let data;
+        try {
+            if (!raw.trim())
+                return [0, []];
+            data = JSON.parse(raw);
+        }
+        catch {
+            return [0, []];
+        }
+        if (!isMapping(data))
+            return [0, []];
+        const write = this.parser.parse(data);
+        if (write === null)
+            return [0, []];
+        // cast: cwd read from the runtime hook's JSON stdin payload
+        const cwd = (data.cwd ?? defaultCwd ?? process.cwd());
+        const violations = this.validator.validateWrite(write, cwd);
+        return violations.length > 0 ? [2, violations] : [0, []];
+    }
+    runExplicit(artifact, filePath, cwd) {
+        artifact = artifact.trim();
+        const defaultPath = defaultArtifactPath(artifact, cwd);
+        const resolvedFile = filePath ? (path.isAbsolute(filePath) ? filePath : path.join(cwd, filePath)) : defaultPath;
+        const violations = this.validator.validateExplicit(artifact, resolvedFile, cwd);
+        const payload = {
+            command: "validate-artifact",
+            status: violations.length > 0 ? "fail" : "pass",
+            artifact,
+            file: resolvedFile,
+            docs_mapped_default: defaultPath || null,
+            path_source: filePath ? "provided" : "docs_mapped_default",
+            violations,
+        };
+        return violations.length > 0 ? [2, payload] : [0, payload];
+    }
+}
+export { ArtifactWrite, RuntimeEventParser, resolvePath };
+//# sourceMappingURL=index.js.map

package/dist/hooks/validateArtifact/index.js.map

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

package/dist/hooks/validateArtifact/markdown.js

@@ -0,0 +1,146 @@
+/**
+ * Markdown validation for human-facing artifacts (TODO.md, CHANGELOG.md,
+ * SKILL.md, ...). Walks the artifact's schema looking for any group
+ * with required `field` entries and dispatches to the appropriate
+ * section check (ITEM, RELEASE, TOKEN).
+ */
+import { parseTodoMarkdownListItem } from "../../cli/todoMarkdown.js";
+import { classifyTodoSectionHeading, isLegacyStrikethroughTodoLine, } from "../compaction/parse.js";
+import { isMapping } from "./schema.js";
+const TODO_RESOLVED_HEADING_RE = /^##\s*(?:✓\s+)?Resolved\s*$/im;
+function validateTodoResolvedPlacement(content, name) {
+    const violations = [];
+    let section = "other";
+    let hasResolvedHeading = TODO_RESOLVED_HEADING_RE.test(content);
+    let hasResolvedItems = false;
+    for (const line of content.split(/\r\n|\r|\n/)) {
+        const kind = classifyTodoSectionHeading(line);
+        if (kind === "resolved") {
+            hasResolvedHeading = true;
+            section = "resolved";
+            continue;
+        }
+        if (kind === "severity") {
+            section = "severity";
+            continue;
+        }
+        if (/^##\s/.test(line.trim())) {
+            section = "other";
+            continue;
+        }
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("-"))
+            continue;
+        const parsed = parseTodoMarkdownListItem(trimmed);
+        if (parsed?.status === "resolved") {
+            hasResolvedItems = true;
+            if (section === "severity") {
+                violations.push(`${name}: resolved checkbox item must live under '## ✓ Resolved', not in severity bands`);
+                break;
+            }
+        }
+        if (isLegacyStrikethroughTodoLine(trimmed)) {
+            hasResolvedItems = true;
+            violations.push(`${name}: legacy strikethrough resolved items are not allowed; use '- [x]' under '## ✓ Resolved'`);
+            break;
+        }
+    }
+    if (hasResolvedItems && !hasResolvedHeading) {
+        violations.push(`${name}: missing '## ✓ Resolved' section for resolved items`);
+    }
+    return violations;
+}
+const SKIP_META = new Set(["meta", "GROUP_PREFIXES", "BUDGET", "COMPACTION", "VALIDATION", "CONVENTION"]);
+export function validateMd(content, name, schema = null) {
+    const violations = [];
+    if (!content.trim())
+        violations.push(`${name}: empty content`);
+    const fences = (content.match(/^```/gm) ?? []).length;
+    if (fences % 2)
+        violations.push(`${name}: unclosed code fence`);
+    if (schema)
+        violations.push(...validateMdSchema(content, name, schema));
+    return violations;
+}
+export function validateMdSchema(content, name, schema) {
+    const violations = [];
+    if (!content.trim())
+        return violations;
+    for (const [groupKey, groupValue] of Object.entries(schema)) {
+        if (SKIP_META.has(groupKey) || !isMapping(groupValue))
+            continue;
+        const hasRequired = Object.values(groupValue).some((e) => isMapping(e) && e.required && e.field);
+        if (!hasRequired)
+            continue;
+        if (groupKey === "ITEM")
+            validateMdItems(content, name, violations);
+        else if (groupKey === "RELEASE")
+            validateMdReleases(content, name, violations);
+        else if (groupKey === "TOKEN")
+            validateMdTokens(content, name, violations);
+    }
+    return violations;
+}
+export function validateMdItems(content, name, violations) {
+    const versionHeading = /^##\s+/m.exec(content);
+    if (!versionHeading) {
+        violations.push(`${name}: missing severity sections (expected '## <glyph> <name>' headings)`);
+        return;
+    }
+    const severityGlyphs = ["⇶", "⇉", "→", "⇢"];
+    let found = false;
+    for (const glyph of severityGlyphs) {
+        const g = glyph.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+        if (new RegExp(`^##\\s*${g}`, "m").test(content)) {
+            found = true;
+            const sectionStart = new RegExp(`^##\\s*${g}.+$`, "m").exec(content);
+            if (sectionStart) {
+                const idx = sectionStart.index + sectionStart[0].length;
+                const nextMatch = content.slice(idx).match(/\n##\s/);
+                let bodyStart = idx;
+                if (content.startsWith("\r\n", bodyStart))
+                    bodyStart += 2;
+                else if (content[bodyStart] === "\n")
+                    bodyStart += 1;
+                const sectionEnd = nextMatch ? idx + nextMatch.index : content.length;
+                const sectionBody = content.slice(bodyStart, sectionEnd);
+                const headingSlice = content.slice(sectionStart.index, sectionStart.index + sectionStart[0].length);
+                const glyphNameMatch = new RegExp(`^##\\s*(${g}.+)$`, "m").exec(headingSlice);
+                const headingText = glyphNameMatch ? glyphNameMatch[1] : glyph;
+                const gluedNextSection = nextMatch?.index === 0;
+                if (gluedNextSection || /^\s*##\s/m.test(sectionBody)) {
+                    violations.push(`${name}: severity section '${headingText}' body contains a nested heading; add a blank line before the next '##' section`);
+                }
+                if (glyph === "⇶" && /^\s*-\s+\[x\]/im.test(sectionBody)) {
+                    violations.push(`${name}: severity section '⇶ Critical' must not contain resolved '- [x]' items; move them to '## ✓ Resolved'`);
+                }
+            }
+        }
+    }
+    if (name === "TODO.md" || name === "todo") {
+        violations.push(...validateTodoResolvedPlacement(content, name));
+    }
+    if (!found) {
+        violations.push(`${name}: missing severity glyph in section headings (expected '## ⇶ Critical', '## ⇉ Degraded', '## → Normal', '## ⇢ Annoying')`);
+    }
+}
+export function validateMdReleases(content, name, violations) {
+    if (!/^##\s*\[/m.test(content)) {
+        violations.push(`${name}: missing version header (expected '## [X.Y.Z]')`);
+    }
+    const changeSections = new Set(["### Added", "### Changed", "### Fixed", "### Removed"]);
+    const lines = new Set(content.split("\n"));
+    if (![...changeSections].some((s) => lines.has(s))) {
+        violations.push(`${name}: missing change sections (expected '### Added', '### Changed', '### Fixed', or '### Removed')`);
+    }
+}
+export function validateMdTokens(content, name, violations) {
+    if (!/^##\s/m.test(content)) {
+        violations.push(`${name}: missing section heading (expected '## SectionName')`);
+    }
+    const yamlBlocks = (content.match(/^```yaml\s*$/gm) ?? []).length;
+    if (!yamlBlocks) {
+        violations.push(`${name}: missing YAML code block with token definitions (expected '\`\`\`yaml')`);
+    }
+}
+//# sourceMappingURL=markdown.js.map

package/dist/hooks/validateArtifact/markdown.js.map

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

package/dist/hooks/validateArtifact/runtime.js

@@ -0,0 +1,86 @@
+/**
+ * Runtime event parsing for agent artifact writes.
+ *
+ * Detects which file a runtime wants to write (or which apply_patch
+ * headers describe) and packages it as an `ArtifactWrite`. The CLI
+ * adapter uses this on the JSON payload that Claude, OpenCode, Codex,
+ * and Copilot hand to a PostToolUse hook.
+ */
+import { isMapping } from "./schema.js";
+export class ArtifactWrite {
+    file_path;
+    content;
+    constructor(filePath, content = null) {
+        this.file_path = filePath;
+        this.content = content;
+    }
+}
+export class RuntimeEventParser {
+    parseClaude(data) {
+        const ti = data.tool_input;
+        if (!isMapping(ti))
+            return null;
+        const fp = ti.file_path;
+        // cast: tool_input.content parsed from the runtime hook's JSON stdin payload
+        if (fp)
+            return new ArtifactWrite(String(fp), (ti.content ?? null));
+        return null;
+    }
+    parseOpencode(data) {
+        const inp = data.input;
+        if (!isMapping(inp))
+            return null;
+        const fp = inp.path;
+        // cast: input.content parsed from the runtime hook's JSON stdin payload
+        if (fp)
+            return new ArtifactWrite(String(fp), (inp.content ?? null));
+        return null;
+    }
+    parseCodex(data) {
+        const ti = data.tool_input;
+        if (!isMapping(ti))
+            return null;
+        const fp = ti.path;
+        const patchBody = ti.patch || ti.command || "";
+        if (fp)
+            return new ArtifactWrite(String(fp));
+        if (typeof patchBody === "string") {
+            const headers = [...patchBody.matchAll(/^\*\*\*\s+(?:Add File|Update File):\s+(.+?)\s*$/gm)];
+            if (headers.length > 0)
+                return new ArtifactWrite(headers[0][1]);
+        }
+        return null;
+    }
+    parseCopilot(data) {
+        const inp = data.input;
+        if (!isMapping(inp))
+            return null;
+        const fp = inp.filePath || inp.file_path;
+        // cast: input.content parsed from the runtime hook's JSON stdin payload
+        if (fp)
+            return new ArtifactWrite(String(fp), (inp.content ?? null));
+        return null;
+    }
+    parse(data) {
+        const tn = data.tool_name ?? "";
+        if (tn === "apply_patch") {
+            const candidate = this.parseCodex(data);
+            if (candidate)
+                return candidate;
+        }
+        if (tn === "Edit" || tn === "Write" || (isMapping(data.tool_input) && "file_path" in data.tool_input)) {
+            const candidate = this.parseClaude(data);
+            if (candidate)
+                return candidate;
+        }
+        if (isMapping(data.input)) {
+            const inp = data.input;
+            if ("filePath" in inp || "file_path" in inp)
+                return this.parseCopilot(data);
+            if ("path" in inp)
+                return this.parseOpencode(data);
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/hooks/validateArtifact/runtime.js.map

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