codex-harness-kit 0.1.0

package/dist/src/commands/init.js

@@ -0,0 +1,138 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { createDefaultConfig, createDefaultState, renderAgentsActivationBridge, renderAgentsHarnessSupplement, renderAgentsTemplate, renderContractsReadmeTemplate, renderDecisionsTemplate, renderExampleContractTemplate, renderJsonFile, renderProjectMemoryTemplate } from "../templates.js";
+import { ensureParentDirectory, hasMarkedBlock, pathExists, relativeToRepo, upsertMarkedBlock } from "../harness.js";
+import { HARNESS_BRIDGE_MARKER_END, HARNESS_BRIDGE_MARKER_START, HARNESS_MARKER_END, HARNESS_MARKER_START } from "../templates.js";
+export async function initializeHarness(options = {}) {
+    const repoRoot = path.resolve(options.targetPath ?? process.cwd());
+    await mkdir(repoRoot, { recursive: true });
+    const actions = [];
+    const notes = [];
+    const force = options.force ?? false;
+    const templates = new Map([
+        ["docs/harness-config.json", renderJsonFile(createDefaultConfig())],
+        ["docs/harness-state.json", renderJsonFile(createDefaultState())],
+        ["docs/project-memory.md", renderProjectMemoryTemplate()],
+        ["docs/decisions.md", renderDecisionsTemplate()],
+        ["docs/contracts/README.md", renderContractsReadmeTemplate()],
+        ["docs/contracts/example-contract.md", renderExampleContractTemplate()]
+    ]);
+    const agentsResult = await writeAgentsFiles(repoRoot);
+    actions.push(...agentsResult.actions);
+    notes.push(...agentsResult.notes);
+    for (const [relativePath, content] of templates) {
+        const absolutePath = path.join(repoRoot, relativePath);
+        actions.push(await writeTextFileSafely(repoRoot, absolutePath, content, force));
+    }
+    return {
+        repoRoot,
+        actions,
+        notes
+    };
+}
+async function writeAgentsFiles(repoRoot) {
+    const agentsPath = path.join(repoRoot, "AGENTS.md");
+    const harnessAgentsPath = path.join(repoRoot, "AGENTS.harness.md");
+    const fullAgentsContent = renderAgentsTemplate();
+    const bridgeContent = renderAgentsActivationBridge();
+    const supplementContent = renderAgentsHarnessSupplement();
+    const actions = [];
+    if (!(await pathExists(agentsPath))) {
+        actions.push(await writeManagedFile(repoRoot, agentsPath, fullAgentsContent));
+        return { actions, notes: [] };
+    }
+    const existingAgents = await readFile(agentsPath, "utf8");
+    if (hasMarkedBlock(existingAgents, HARNESS_MARKER_START, HARNESS_MARKER_END)) {
+        const nextAgentsContent = upsertMarkedBlock(existingAgents, fullAgentsContent, HARNESS_MARKER_START, HARNESS_MARKER_END);
+        actions.push(await writeManagedFile(repoRoot, agentsPath, nextAgentsContent));
+        return { actions, notes: [] };
+    }
+    const nextAgentsContent = upsertMarkedBlock(existingAgents, bridgeContent, HARNESS_BRIDGE_MARKER_START, HARNESS_BRIDGE_MARKER_END);
+    actions.push(await writeManagedFile(repoRoot, agentsPath, nextAgentsContent));
+    actions.push(await writeManagedMarkedFile(repoRoot, harnessAgentsPath, supplementContent));
+    const notes = [
+        "Existing AGENTS.md was preserved and a codex-harness-kit activation bridge was added. Detailed harness rules live in AGENTS.harness.md."
+    ];
+    return { actions, notes };
+}
+async function writeTextFileSafely(repoRoot, absolutePath, content, force) {
+    const relativePath = relativeToRepo(repoRoot, absolutePath);
+    if (!(await pathExists(absolutePath))) {
+        await ensureParentDirectory(absolutePath);
+        await writeFile(absolutePath, content, "utf8");
+        return {
+            file: relativePath,
+            status: "created"
+        };
+    }
+    const existing = await readFile(absolutePath, "utf8");
+    if (existing === content) {
+        return {
+            file: relativePath,
+            status: "unchanged"
+        };
+    }
+    if (!force) {
+        return {
+            file: relativePath,
+            status: "skipped",
+            reason: "File already exists. Re-run with --force to overwrite the harness-managed version."
+        };
+    }
+    await ensureParentDirectory(absolutePath);
+    await writeFile(absolutePath, content, "utf8");
+    return {
+        file: relativePath,
+        status: "updated",
+        reason: "Overwritten because --force was provided."
+    };
+}
+async function writeManagedMarkedFile(repoRoot, absolutePath, blockContent) {
+    if (!(await pathExists(absolutePath))) {
+        return writeManagedFile(repoRoot, absolutePath, blockContent);
+    }
+    const existingContent = await readFile(absolutePath, "utf8");
+    const nextContent = upsertMarkedBlock(existingContent, blockContent, HARNESS_MARKER_START, HARNESS_MARKER_END);
+    return writeManagedFile(repoRoot, absolutePath, nextContent);
+}
+async function writeManagedFile(repoRoot, absolutePath, content) {
+    const relativePath = relativeToRepo(repoRoot, absolutePath);
+    if (!(await pathExists(absolutePath))) {
+        await ensureParentDirectory(absolutePath);
+        await writeFile(absolutePath, content, "utf8");
+        return {
+            file: relativePath,
+            status: "created"
+        };
+    }
+    const existing = await readFile(absolutePath, "utf8");
+    if (existing === content) {
+        return {
+            file: relativePath,
+            status: "unchanged"
+        };
+    }
+    await ensureParentDirectory(absolutePath);
+    await writeFile(absolutePath, content, "utf8");
+    return {
+        file: relativePath,
+        status: "updated"
+    };
+}
+export function renderInitResult(result) {
+    const lines = [];
+    lines.push(`Initialized codex-harness-kit in ${result.repoRoot}`);
+    for (const action of result.actions) {
+        const suffix = action.reason ? ` (${action.reason})` : "";
+        lines.push(`- ${action.status}: ${action.file}${suffix}`);
+    }
+    if (result.notes.length > 0) {
+        lines.push("");
+        lines.push("Notes:");
+        for (const note of result.notes) {
+            lines.push(`- ${note}`);
+        }
+    }
+    return lines.join("\n");
+}
+//# sourceMappingURL=init.js.map

package/dist/src/commands/init.js.map

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

package/dist/src/commands/validate-harness.d.ts

@@ -0,0 +1,4 @@
+export declare function runValidateHarness(repoRoot: string): Promise<{
+    ok: boolean;
+    output: string;
+}>;

package/dist/src/commands/validate-harness.js

@@ -0,0 +1,9 @@
+import { renderValidationReport, validateHarness } from "../harness.js";
+export async function runValidateHarness(repoRoot) {
+    const report = await validateHarness(repoRoot);
+    return {
+        ok: report.ok,
+        output: renderValidationReport(report)
+    };
+}
+//# sourceMappingURL=validate-harness.js.map

package/dist/src/commands/validate-harness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-harness.js","sourceRoot":"","sources":["../../../src/commands/validate-harness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAExE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,QAAgB;IAEhB,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,QAAQ,CAAC,CAAC;IAC/C,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,MAAM,EAAE,sBAAsB,CAAC,MAAM,CAAC;KACvC,CAAC;AACJ,CAAC"}

package/dist/src/harness.d.ts

@@ -0,0 +1,13 @@
+import { DEFAULT_CONFIG_PATH, HARNESS_BRIDGE_MARKER_END, HARNESS_BRIDGE_MARKER_START, HARNESS_MARKER_END, HARNESS_MARKER_START } from "./templates.js";
+import type { ValidationReport } from "./types.js";
+export { DEFAULT_CONFIG_PATH, HARNESS_BRIDGE_MARKER_END, HARNESS_BRIDGE_MARKER_START, HARNESS_MARKER_END, HARNESS_MARKER_START };
+export declare function pathExists(targetPath: string): Promise<boolean>;
+export declare function ensureParentDirectory(filePath: string): Promise<void>;
+export declare function relativeToRepo(repoRoot: string, targetPath: string): string;
+export declare function resolveFromRepo(repoRoot: string, configuredPath: string): string;
+export declare function hasMarkedBlock(content: string, startMarker: string, endMarker: string): boolean;
+export declare function getMarkedBlockContent(content: string, startMarker: string, endMarker: string): string | null;
+export declare function upsertMarkedBlock(existingContent: string, blockContent: string, startMarker: string, endMarker: string): string;
+export declare function validateHarness(repoRootInput: string): Promise<ValidationReport>;
+export declare function renderValidationReport(report: ValidationReport): string;
+export declare function buildStateSummary(repoRootInput: string): Promise<string>;