frontend-harness 0.1.0

package/dist/runtime/protocol-init.js

@@ -0,0 +1,256 @@
+import fs from "node:fs";
+import path from "node:path";
+import { createHash } from "node:crypto";
+import { harnessPath, relativeHarnessPath } from "../storage/paths.js";
+import { readJson, writeJson } from "../storage/json.js";
+import { builtinProjectSkills } from "./builtin-skills.js";
+import { protocolUsefulCommandLines } from "./command-taxonomy.js";
+const blockStart = "<!-- frontend-harness:managed:start -->";
+const blockEnd = "<!-- frontend-harness:managed:end -->";
+export function initializeProtocol(projectRoot, options = {}) {
+    const createdAt = new Date().toISOString();
+    const dryRun = Boolean(options.dryRun);
+    const files = [
+        upsertProtocolFile(projectRoot, "AGENTS.md", { dryRun }),
+        upsertProtocolFile(projectRoot, "CLAUDE.md", { dryRun })
+    ];
+    const skills = upsertBuiltinProjectSkills(projectRoot, { dryRun });
+    const protocolStatus = checkProtocol(projectRoot);
+    const needsUpdate = files.some((file) => file.action !== "unchanged")
+        || skills.some((skill) => skill.action !== "unchanged")
+        || protocolStatus.status !== "passed"
+        || !protocolStatus.provenance.current;
+    const result = {
+        contractVersion: 1,
+        createdAt,
+        projectRoot,
+        dryRun,
+        needsUpdate,
+        files,
+        skills,
+        artifacts: {
+            protocol: relativeHarnessPath("protocol", "latest.json"),
+            skillsRoot: relativeHarnessPath("skills")
+        }
+    };
+    if (!dryRun) {
+        writeJson(harnessPath(projectRoot, "protocol", "latest.json"), result);
+    }
+    return result;
+}
+function upsertBuiltinProjectSkills(projectRoot, options) {
+    const skillsRoot = harnessPath(projectRoot, "skills");
+    return builtinProjectSkills.map((skill) => {
+        const relativePath = relativeHarnessPath("skills", skill.fileName);
+        const fullPath = path.join(skillsRoot, skill.fileName);
+        const exists = fs.existsSync(fullPath);
+        const content = exists ? fs.readFileSync(fullPath, "utf8") : skill.content;
+        const action = exists ? "unchanged" : "created";
+        if (!exists && !options.dryRun) {
+            fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+            fs.writeFileSync(fullPath, skill.content, "utf8");
+        }
+        return {
+            name: skill.name,
+            path: relativePath,
+            action,
+            sha256: sha256(content)
+        };
+    });
+}
+export function checkProtocol(projectRoot) {
+    const artifactPath = relativeHarnessPath("protocol", "latest.json");
+    const fullArtifactPath = harnessPath(projectRoot, "protocol", "latest.json");
+    const files = [
+        checkProtocolFile(projectRoot, "AGENTS.md"),
+        checkProtocolFile(projectRoot, "CLAUDE.md")
+    ];
+    const artifactExists = fs.existsSync(fullArtifactPath);
+    const initialized = artifactExists
+        || files.some((file) => file.exists || file.hasManagedBlock);
+    const errors = [];
+    const warnings = [];
+    let provenanceCurrent = false;
+    if (!initialized) {
+        return {
+            status: "not_initialized",
+            artifactPath,
+            provenance: {
+                exists: false,
+                current: false
+            },
+            files,
+            errors,
+            warnings: ["Run frontend-harness init --json to inject managed AGENTS.md and CLAUDE.md protocol blocks."]
+        };
+    }
+    if (!artifactExists) {
+        errors.push("Protocol provenance artifact is missing; rerun frontend-harness init --json.");
+    }
+    else {
+        const provenance = readProtocolArtifact(fullArtifactPath, errors);
+        provenanceCurrent = provenance !== null && checkProtocolProvenance(provenance, files, errors);
+    }
+    for (const file of files) {
+        if (!file.exists) {
+            errors.push(`${file.path} is missing.`);
+            continue;
+        }
+        if (!file.hasManagedBlock) {
+            errors.push(`${file.path} is missing the frontend-harness managed block.`);
+            continue;
+        }
+        if (!file.managedBlockCurrent) {
+            errors.push(`${file.path} managed block is stale; rerun frontend-harness init --json.`);
+        }
+    }
+    return {
+        status: errors.length > 0 ? "failed" : "passed",
+        artifactPath,
+        provenance: {
+            exists: artifactExists,
+            current: provenanceCurrent
+        },
+        files,
+        errors,
+        warnings
+    };
+}
+function upsertProtocolFile(projectRoot, fileName, options) {
+    const fullPath = path.join(projectRoot, fileName);
+    const existing = fs.existsSync(fullPath) ? fs.readFileSync(fullPath, "utf8") : "";
+    const nextContent = replaceManagedBlock(existing, renderManagedBlock(fileName));
+    const action = !fs.existsSync(fullPath)
+        ? "created"
+        : existing === nextContent
+            ? "unchanged"
+            : "updated";
+    if (action !== "unchanged" && !options.dryRun) {
+        fs.writeFileSync(fullPath, nextContent, "utf8");
+    }
+    const persisted = action === "unchanged" ? existing : nextContent;
+    const managedBlock = renderManagedBlock(fileName);
+    return {
+        path: fileName,
+        action,
+        sha256: createHash("sha256").update(persisted).digest("hex"),
+        managedBlockSha256: sha256(managedBlock),
+        managedBlockStart: blockStart,
+        managedBlockEnd: blockEnd
+    };
+}
+function checkProtocolFile(projectRoot, fileName) {
+    const fullPath = path.join(projectRoot, fileName);
+    if (!fs.existsSync(fullPath)) {
+        return {
+            path: fileName,
+            exists: false,
+            hasManagedBlock: false,
+            managedBlockCurrent: false,
+            sha256: null,
+            managedBlockSha256: null
+        };
+    }
+    const content = fs.readFileSync(fullPath, "utf8");
+    const managedBlock = extractManagedBlock(content);
+    return {
+        path: fileName,
+        exists: true,
+        hasManagedBlock: managedBlock !== null,
+        managedBlockCurrent: managedBlock === renderManagedBlock(fileName),
+        sha256: sha256(content),
+        managedBlockSha256: managedBlock === null ? null : sha256(managedBlock)
+    };
+}
+function readProtocolArtifact(filePath, errors) {
+    try {
+        return readJson(filePath);
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        errors.push(`Protocol provenance artifact is malformed: ${message}`);
+        return null;
+    }
+}
+function checkProtocolProvenance(provenance, files, errors) {
+    if (!provenance || provenance.contractVersion !== 1 || !Array.isArray(provenance.files)) {
+        errors.push("Protocol provenance artifact has an unsupported shape; rerun frontend-harness init --json.");
+        return false;
+    }
+    let current = true;
+    for (const file of files) {
+        const record = provenance.files.find((item) => item.path === file.path);
+        if (!record) {
+            errors.push(`Protocol provenance artifact is missing ${file.path}; rerun frontend-harness init --json.`);
+            current = false;
+            continue;
+        }
+        if (!file.managedBlockSha256 || record.managedBlockSha256 !== file.managedBlockSha256) {
+            errors.push(`${file.path} managed block hash does not match protocol provenance; rerun frontend-harness init --json.`);
+            current = false;
+        }
+    }
+    return current;
+}
+function replaceManagedBlock(content, block) {
+    if (!content.trim()) {
+        return `${block}\n`;
+    }
+    const pattern = new RegExp(`${escapeRegExp(blockStart)}[\\s\\S]*?${escapeRegExp(blockEnd)}`);
+    if (pattern.test(content)) {
+        return ensureTrailingNewline(content.replace(pattern, block));
+    }
+    return `${ensureTrailingNewline(content)}\n${block}\n`;
+}
+function renderManagedBlock(fileName) {
+    const owner = fileName === "AGENTS.md" ? "Codex" : "Claude Code";
+    return [
+        blockStart,
+        `# Frontend Harness Execution Policy for ${owner}`,
+        "",
+        "This project uses `frontend-harness` as a project-level execution policy layer.",
+        "The coding agent runtime remains responsible for its own agent loop, tools, context management, permissions, retries, subagents, and skill loading.",
+        "`frontend-harness` owns only deterministic project facts, execution contracts, validation evidence, project-local knowledge, and repair artifacts.",
+        "",
+        "Required loop:",
+        "1. Run `frontend-harness context --json` before planning edits.",
+        "2. If agent planning input is useful, write only bounded hints (`intentSuggestion`, `constraintHints`, `componentHints`) to an agent decision JSON file and validate it with `frontend-harness decision check --json --file <agent-decision.json>`.",
+        "3. Run `frontend-harness plan --json \"<task>\"` with optional `--agent-decision <agent-decision.json>`, or consume the existing `.frontend-harness/plans/latest.json` before editing.",
+        "4. Edit only project files required by the system-owned plan and current task.",
+        "5. Record every changed project file with `frontend-harness state record-change <file>`.",
+        "6. Run `frontend-harness verify --json` and inspect the JSON result.",
+        "7. If verification fails, run `frontend-harness repair packet --json`, inspect `.frontend-harness/repair/latest.json`, patch the relevant project files, record changes, and verify again.",
+        "8. Before committing, inspect relevant project-local skills under `.frontend-harness/skills/` and follow the repository commit protocol.",
+        "9. Stop only when `frontend-harness state next --json` returns `done` for the unchanged task scope.",
+        "",
+        "Commit protocol:",
+        "- Use commit header format: `<type>(<scope>): <short description>`.",
+        "- Allowed commit types: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `chore`.",
+        "- Keep the header concise and include verification evidence in the commit body or trailers when available.",
+        "",
+        "Boundaries:",
+        "- Do not treat `frontend-harness` as an agent launcher or runtime wrapper.",
+        "- Do not edit `.frontend-harness/` generated artifacts manually; let harness commands write them.",
+        "- Do not interpret planning or repair decision JSON as shell commands, patch content, scheduler directives, graph execution, skill routing, or RAG instructions.",
+        "- Do not put workflow type, execution units, file paths, dependency graph, execution order, or verification commands into agent planning input; the system plan always owns those structures.",
+        "- Keep durable project knowledge under `.frontend-harness/knowledge/` and project-local skills under `.frontend-harness/skills/` when intentionally authored.",
+        "",
+        "Useful commands:",
+        ...protocolUsefulCommandLines(),
+        blockEnd
+    ].join("\n");
+}
+function extractManagedBlock(content) {
+    const pattern = new RegExp(`${escapeRegExp(blockStart)}[\\s\\S]*?${escapeRegExp(blockEnd)}`);
+    return content.match(pattern)?.[0] ?? null;
+}
+function ensureTrailingNewline(content) {
+    return content.endsWith("\n") ? content : `${content}\n`;
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function sha256(value) {
+    return createHash("sha256").update(value).digest("hex");
+}
+//# sourceMappingURL=protocol-init.js.map

package/dist/runtime/protocol-init.js.map

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

package/dist/runtime/repair-decision.d.ts

@@ -0,0 +1,3 @@
+import type { RepairDecisionCheckResult, RepairDecisionSummary } from "../schemas/types.js";
+export declare function checkRepairDecision(projectRoot: string, file: string | undefined): RepairDecisionCheckResult;
+export declare function readAcceptedRepairDecision(projectRoot: string): RepairDecisionSummary | null;

package/dist/runtime/repair-decision.js

@@ -0,0 +1,195 @@
+import fs from "node:fs";
+import { createHash } from "node:crypto";
+import path from "node:path";
+import { harnessPath, relativeHarnessPath } from "../storage/paths.js";
+import { readJson, writeJson } from "../storage/json.js";
+import { resolveProjectRelativePath } from "./project-paths.js";
+const MAX_LIST_ITEMS = 20;
+const MAX_STRING_LENGTH = 500;
+export function checkRepairDecision(projectRoot, file) {
+    if (!file) {
+        throw new Error("repair decision check requires --file <repair-decision.json>");
+    }
+    const artifactPath = file;
+    const acceptedArtifactPath = relativeHarnessPath("repair-decision", "latest.json");
+    try {
+        const relativePath = validateReferencedFile(projectRoot, file);
+        const decision = readRepairDecision(projectRoot, relativePath);
+        const summary = {
+            artifactPath: acceptedArtifactPath,
+            sourceArtifactPath: relativePath,
+            ...readRepairProvenance(projectRoot),
+            contractVersion: 1,
+            intent: decision.intent,
+            hypothesis: decision.hypothesis,
+            targetFiles: decision.targetFiles,
+            verificationFocus: decision.verificationFocus
+        };
+        writeJson(harnessPath(projectRoot, "repair-decision", "latest.json"), summary);
+        return {
+            status: "passed",
+            artifactPath: relativePath,
+            acceptedArtifactPath,
+            contractVersion: 1,
+            decision,
+            errors: []
+        };
+    }
+    catch (error) {
+        return {
+            status: "failed",
+            artifactPath,
+            acceptedArtifactPath: null,
+            contractVersion: null,
+            decision: null,
+            errors: [error instanceof Error ? error.message : String(error)]
+        };
+    }
+}
+export function readAcceptedRepairDecision(projectRoot) {
+    const summary = readJson(harnessPath(projectRoot, "repair-decision", "latest.json"));
+    if (!summary) {
+        return null;
+    }
+    return {
+        ...summary,
+        artifactPath: relativeHarnessPath("repair-decision", "latest.json"),
+        repairPacketArtifactPath: summary.repairPacketArtifactPath ?? null,
+        repairPacketSha256: summary.repairPacketSha256 ?? null,
+        verificationArtifactPath: summary.verificationArtifactPath ?? null,
+        verificationSha256: summary.verificationSha256 ?? null
+    };
+}
+function readRepairProvenance(projectRoot) {
+    const repairPacket = describeExistingHarnessArtifact(projectRoot, relativeHarnessPath("repair", "latest.json"));
+    const verification = describeExistingHarnessArtifact(projectRoot, relativeHarnessPath("verification", "latest.json"));
+    return {
+        repairPacketArtifactPath: repairPacket.path,
+        repairPacketSha256: repairPacket.sha256,
+        verificationArtifactPath: verification.path,
+        verificationSha256: verification.sha256
+    };
+}
+function describeExistingHarnessArtifact(projectRoot, artifactPath) {
+    const fullPath = path.resolve(projectRoot, artifactPath);
+    const relativePath = path.relative(projectRoot, fullPath);
+    if (relativePath.startsWith("..") ||
+        path.isAbsolute(relativePath) ||
+        !fs.existsSync(fullPath) ||
+        !fs.statSync(fullPath).isFile()) {
+        return { path: null, sha256: null };
+    }
+    return {
+        path: artifactPath,
+        sha256: createHash("sha256").update(fs.readFileSync(fullPath)).digest("hex")
+    };
+}
+function validateReferencedFile(projectRoot, file) {
+    const { relativePath, fullPath } = resolveProjectRelativePath(projectRoot, file, "repair decision file");
+    if (!fs.existsSync(fullPath)) {
+        throw new Error(`repair decision file cannot be read: ${file}`);
+    }
+    return relativePath;
+}
+function readRepairDecision(projectRoot, file) {
+    const fullPath = path.resolve(projectRoot, file);
+    let parsed;
+    try {
+        parsed = JSON.parse(fs.readFileSync(fullPath, "utf8"));
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`repair decision file must contain valid JSON: ${file}: ${detail}`);
+    }
+    return parseRepairDecisionEnvelope(parsed, file);
+}
+function parseRepairDecisionEnvelope(value, file) {
+    if (!isRecord(value) || Array.isArray(value)) {
+        throw new Error(`repair decision file must contain a JSON object: ${file}`);
+    }
+    const allowedEnvelopeKeys = new Set(["contractVersion", "decision"]);
+    for (const key of Object.keys(value)) {
+        if (!allowedEnvelopeKeys.has(key)) {
+            throw new Error(`repair decision file contains unsupported field: ${key}`);
+        }
+    }
+    if (value["contractVersion"] !== 1) {
+        throw new Error("repair decision contractVersion must be 1");
+    }
+    if (!isRecord(value["decision"]) || Array.isArray(value["decision"])) {
+        throw new Error(`repair decision file decision must be a JSON object: ${file}`);
+    }
+    return parseRepairDecisionObject(value["decision"]);
+}
+function parseRepairDecisionObject(value) {
+    const allowedDecisionKeys = new Set(["intent", "hypothesis", "targetFiles", "verificationFocus"]);
+    for (const key of Object.keys(value)) {
+        if (!allowedDecisionKeys.has(key)) {
+            throw new Error(`repair decision file decision contains unsupported field: ${key}`);
+        }
+    }
+    return {
+        intent: parseBoundedString(value["intent"], "intent"),
+        hypothesis: parseBoundedString(value["hypothesis"], "hypothesis"),
+        targetFiles: parseTargetFiles(value["targetFiles"]),
+        verificationFocus: parseStringArray(value["verificationFocus"], "verificationFocus", 10)
+    };
+}
+function parseStringArray(value, label, maxItems) {
+    if (!Array.isArray(value)) {
+        throw new Error(`repair decision ${label} must be an array of strings`);
+    }
+    if (value.length === 0) {
+        throw new Error(`repair decision ${label} must contain at least 1 item`);
+    }
+    if (value.length > maxItems) {
+        throw new Error(`repair decision ${label} cannot contain more than ${maxItems} items`);
+    }
+    return value.map((item, index) => parseBoundedString(item, `${label}[${index}]`));
+}
+function parseTargetFiles(value) {
+    const files = parseStringArray(value, "targetFiles", MAX_LIST_ITEMS);
+    return files.map((file, index) => parseSafeRelativeProjectFile(file, `targetFiles[${index}]`));
+}
+function parseSafeRelativeProjectFile(value, label) {
+    if (value.includes("\0")) {
+        throw new Error(`repair decision ${label} cannot contain null bytes`);
+    }
+    if (value.includes("\\")) {
+        throw new Error(`repair decision ${label} must use POSIX-style relative paths`);
+    }
+    if (path.isAbsolute(value)) {
+        throw new Error(`repair decision ${label} must be a relative project file path`);
+    }
+    const normalized = path.posix.normalize(value);
+    if (normalized === "." ||
+        normalized.startsWith("../") ||
+        normalized === ".." ||
+        normalized.endsWith("/")) {
+        throw new Error(`repair decision ${label} must be a safe relative project file path`);
+    }
+    if (normalized === ".frontend-harness" ||
+        normalized === ".omx" ||
+        normalized.startsWith(".frontend-harness/") ||
+        normalized.startsWith(".omx/")) {
+        throw new Error(`repair decision ${label} must target project source files, not harness state`);
+    }
+    return normalized;
+}
+function parseBoundedString(value, label) {
+    if (typeof value !== "string") {
+        throw new Error(`repair decision ${label} must be a string`);
+    }
+    const trimmed = value.trim();
+    if (!trimmed) {
+        throw new Error(`repair decision ${label} cannot be empty`);
+    }
+    if (trimmed.length > MAX_STRING_LENGTH) {
+        throw new Error(`repair decision ${label} cannot exceed ${MAX_STRING_LENGTH} characters`);
+    }
+    return trimmed;
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=repair-decision.js.map

package/dist/runtime/repair-decision.js.map

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

package/dist/runtime/repair-packet.d.ts

@@ -0,0 +1,7 @@
+import type { RepairPacketArtifact, StateNextResult, VerificationResult } from "../schemas/types.js";
+interface RepairPacketOptions {
+    verification?: VerificationResult | null;
+    nextAction?: StateNextResult | null;
+}
+export declare function createRepairPacket(projectRoot: string, options?: RepairPacketOptions): RepairPacketArtifact;
+export {};

package/dist/runtime/repair-packet.js

@@ -0,0 +1,159 @@
+import fs from "node:fs";
+import { createHash } from "node:crypto";
+import path from "node:path";
+import { harnessPath, relativeHarnessPath } from "../storage/paths.js";
+import { readJson, writeJson, writeText } from "../storage/json.js";
+import { getNextAction, loadState } from "./state.js";
+import { isProjectRelativeSubpath } from "./project-paths.js";
+const MAX_LOG_EXCERPT_CHARS = 4000;
+export function createRepairPacket(projectRoot, options = {}) {
+    const verification = options.verification ?? readLatestVerification(projectRoot);
+    const nextAction = options.nextAction ?? getNextAction(projectRoot);
+    const state = loadState(projectRoot);
+    const failedResults = verification?.results.filter((result) => result.status === "failed" || result.status === "error") ?? [];
+    const packet = {
+        contractVersion: 1,
+        createdAt: new Date().toISOString(),
+        status: failedResults.length > 0 ? "ready" : "not_applicable",
+        stateStatus: state.status,
+        verificationStatus: verification?.status ?? state.verification.status,
+        nextAction,
+        artifacts: {
+            verification: verificationArtifactPath(),
+            repairPacket: repairPacketArtifactPath(),
+            repairPacketMarkdown: repairPacketMarkdownPath()
+        },
+        changedFiles: [...state.changedFiles].sort(),
+        failedCommands: failedResults.map((result) => {
+            const logEvidence = readLogEvidence(projectRoot, result.logPath);
+            return {
+                name: result.name,
+                command: result.command,
+                status: result.status,
+                exitCode: result.exitCode,
+                logPath: result.logPath,
+                logExcerpt: logEvidence.excerpt,
+                logSha256: logEvidence.sha256,
+                logSizeBytes: logEvidence.sizeBytes,
+                excerptStartByte: logEvidence.excerptStartByte,
+                excerptEndByte: logEvidence.excerptEndByte,
+                excerptTruncated: logEvidence.excerptTruncated
+            };
+        }),
+        retryGuidance: verification?.retryGuidance ?? null,
+        instructions: buildRepairInstructions(failedResults.length)
+    };
+    writeJson(harnessPath(projectRoot, "repair", "latest.json"), packet);
+    writeText(harnessPath(projectRoot, "repair", "latest.md"), renderRepairPacket(packet));
+    return packet;
+}
+function readLatestVerification(projectRoot) {
+    return readJson(harnessPath(projectRoot, "verification", "latest.json"));
+}
+function readLogEvidence(projectRoot, logPath) {
+    const empty = {
+        excerpt: null,
+        sha256: null,
+        sizeBytes: null,
+        excerptStartByte: null,
+        excerptEndByte: null,
+        excerptTruncated: false
+    };
+    if (!logPath) {
+        return empty;
+    }
+    if (!isProjectRelativeSubpath(logPath, relativeHarnessPath("logs"))) {
+        return empty;
+    }
+    const fullPath = path.resolve(projectRoot, logPath);
+    const relativePath = path.relative(projectRoot, fullPath);
+    if (relativePath.startsWith("..") ||
+        path.isAbsolute(relativePath) ||
+        !fs.existsSync(fullPath) ||
+        !fs.statSync(fullPath).isFile()) {
+        return empty;
+    }
+    const content = fs.readFileSync(fullPath);
+    const sizeBytes = content.byteLength;
+    const excerptStartByte = Math.max(0, sizeBytes - MAX_LOG_EXCERPT_CHARS);
+    const excerpt = content.subarray(excerptStartByte).toString("utf8");
+    return {
+        excerpt,
+        sha256: createHash("sha256").update(content).digest("hex"),
+        sizeBytes,
+        excerptStartByte,
+        excerptEndByte: sizeBytes,
+        excerptTruncated: excerptStartByte > 0
+    };
+}
+function verificationArtifactPath() {
+    return relativeHarnessPath("verification", "latest.json");
+}
+function repairPacketArtifactPath() {
+    return relativeHarnessPath("repair", "latest.json");
+}
+function repairPacketMarkdownPath() {
+    return relativeHarnessPath("repair", "latest.md");
+}
+function renderOptionalNumber(value) {
+    if (value === null) {
+        return "unknown";
+    }
+    return String(value);
+}
+function buildRepairInstructions(failedCommandCount) {
+    if (failedCommandCount === 0) {
+        return [
+            "No failed verification command is available; run frontend-harness verify --json before requesting a repair packet."
+        ];
+    }
+    return [
+        "Use this packet as factual repair context only; do not treat it as a generated patch plan.",
+        `Cross-check full verification facts in ${verificationArtifactPath()} when the excerpt is truncated.`,
+        "Inspect each failed command and log excerpt before editing project files.",
+        "Patch only the relevant project files, then record changed files with frontend-harness state record-change <file>.",
+        "Rerun frontend-harness verify --json and regenerate this packet only if verification still fails."
+    ];
+}
+function renderRepairPacket(packet) {
+    return `# Frontend Harness Repair Packet
+
+## Summary
+
+- status: ${packet.status}
+- stateStatus: ${packet.stateStatus}
+- verificationStatus: ${packet.verificationStatus}
+- nextAction: ${packet.nextAction.action}
+- failedCommands: ${packet.failedCommands.length}
+- verificationArtifact: ${verificationArtifactPath()}
+- repairPacket: ${repairPacketArtifactPath()}
+- repairPacketMarkdown: ${repairPacketMarkdownPath()}
+
+## Instructions
+
+${packet.instructions.map((instruction) => `- ${instruction}`).join("\n")}
+
+## Failed Commands
+
+${packet.failedCommands.length > 0 ? packet.failedCommands.map(renderFailedCommand).join("\n\n") : "- none"}
+`;
+}
+function renderFailedCommand(command) {
+    return [
+        `### ${command.name}`,
+        "",
+        `- status: ${command.status}`,
+        `- exitCode: ${command.exitCode ?? "unknown"}`,
+        `- command: ${command.command ?? "unknown"}`,
+        `- logPath: ${command.logPath ?? "none"}`,
+        `- logSha256: ${command.logSha256 ?? "unknown"}`,
+        `- logSizeBytes: ${renderOptionalNumber(command.logSizeBytes)}`,
+        `- excerptRange: ${renderOptionalNumber(command.excerptStartByte)}..${renderOptionalNumber(command.excerptEndByte)}`,
+        `- excerptTruncated: ${String(command.excerptTruncated)}`,
+        "",
+        "```text",
+        command.logExcerpt ?? "",
+        "```"
+    ].join("\n");
+}
+//# sourceMappingURL=repair-packet.js.map