@spences10/pi-harness 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Scott Spence
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,118 @@
+# @spences10/pi-harness
+
+[![built with Vite+](https://img.shields.io/badge/built%20with-Vite+-646CFF?logo=vite&logoColor=white)](https://viteplus.dev)
+[![tested with Vitest](https://img.shields.io/badge/tested%20with-Vitest-6E9F18?logo=vitest&logoColor=white)](https://vitest.dev)
+[![npm version](https://img.shields.io/npm/v/@spences10/pi-harness?color=CB3837&logo=npm&logoColor=white)](https://www.npmjs.com/package/@spences10/pi-harness)
+[![license](https://img.shields.io/npm/l/@spences10/pi-harness)](https://www.npmjs.com/package/@spences10/pi-harness)
+
+![my-pi package preview](https://raw.githubusercontent.com/spences10/my-pi/main/assets/pi-package-preview.png)
+
+Build and run ephemeral task harnesses with my-pi primitives. A
+harness is a `/tmp` runtime containing a machine-readable contract,
+executor prompt, task brief, validation script, review script, logs,
+status, and runtime enforcement.
+
+## Installation
+
+```bash
+pi install npm:@spences10/pi-harness
+```
+
+Local development from this monorepo:
+
+```bash
+pnpm --filter @spences10/pi-harness run build
+pi install ./packages/pi-harness
+# or for one run only
+pi -e ./packages/pi-harness
+```
+
+## What it does
+
+`pi-harness` adds:
+
+- `/harness` command for create, run, review, status, use, and clear
+- `harness_create` tool to create `/tmp/my-pi-harness-*` runtimes
+- `harness_update` tool for phase/status/evidence logging
+- generated `OUTCOME.md` and `outcome.json` review artifacts
+- dirty-baseline tracking so pre-existing repo changes are reported
+  but not treated as task drift
+- worktree-aware validate/review scripts for team-mode executors
+- `harness_read` tool for summaries
+- `before_agent_start` context injection for the active harness
+- `tool_call` enforcement for edit/write paths and forbidden commands
+- TUI status/widget for the active harness
+- bundled `create-harness`, `execute-harness`, and `review-harness`
+  skills
+
+## Runtime layout
+
+```text
+/tmp/my-pi-harness-<id>/
+  harness.json      # execution contract
+  SYSTEM.md         # executor system prompt
+  TASK.md           # task brief and required loop
+  status.json       # phase/status/evidence log
+  OUTCOME.md        # reviewable outcome summary
+  outcome.json      # machine-readable outcome summary
+  outcome.mjs       # outcome artifact refresher
+  validate.sh       # validation runner
+  review.sh         # drift/review helper
+  logs/events.jsonl # append-only event log
+```
+
+## Commands
+
+```text
+/harness create <task>
+/harness run <dir>
+/harness review <dir>
+/harness status [dir]
+/harness use <dir>
+/harness clear
+```
+
+The create/run/review commands prompt the model to use the bundled
+skills. The tools provide the actual runtime and enforcement layer.
+
+Harnesses snapshot dirty files at creation time. Review and outcome
+artifacts focus on changes after that baseline, while still recording
+baseline files in `outcome.json`. If a team-mode executor runs in a
+linked git worktree, run `review.sh` from that worktree or set
+`HARNESS_CWD` so validation, guard checks, and outcome collection use
+the executor workspace.
+
+## Harness loop
+
+1. Context recovery
+2. Source-of-truth capture
+3. Assumption challenge
+4. Alignment checkpoint
+5. Surgical execution
+6. Validation evidence
+7. Drift review
+8. OUTCOME.md/outcome.json review
+9. Delta/risk report
+
+## Using from a custom harness
+
+```ts
+import harness from '@spences10/pi-harness';
+
+// pass `harness` as an ExtensionFactory to your Pi runtime
+```
+
+`my-pi` imports this package directly and enables it as the built-in
+harness workflow.
+
+## Development
+
+```bash
+pnpm --filter @spences10/pi-harness run check
+pnpm --filter @spences10/pi-harness run test
+pnpm --filter @spences10/pi-harness run build
+```
+
+## License
+
+MIT

package/dist/enforcement/policy.d.ts

@@ -0,0 +1,13 @@
+import type { HarnessContract } from '../schema.js';
+export declare function check_path_allowed(contract: HarnessContract, input_path: string): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function check_command_allowed(contract: HarnessContract, command: string): {
+    ok: true;
+} | {
+    ok: false;
+    reason: string;
+};

package/dist/enforcement/policy.js

@@ -0,0 +1,85 @@
+import { isAbsolute, relative, resolve } from 'node:path';
+function resolve_project_path(cwd, input_path) {
+    return resolve(cwd, input_path);
+}
+function pattern_to_relative(cwd, pattern) {
+    const normalized_pattern = pattern.replaceAll('\\', '/');
+    if (!isAbsolute(pattern))
+        return normalized_pattern;
+    return relative(cwd, resolve(pattern)).replaceAll('\\', '/');
+}
+function pattern_matches(cwd, pattern, absolute_path) {
+    const normalized_pattern = pattern_to_relative(cwd, pattern);
+    const relative_path = relative(cwd, absolute_path).replaceAll('\\', '/');
+    if (normalized_pattern === '.')
+        return true;
+    if (normalized_pattern.endsWith('/**')) {
+        const prefix = normalized_pattern.slice(0, -3);
+        return (relative_path === prefix ||
+            relative_path.startsWith(`${prefix}/`));
+    }
+    if (normalized_pattern.includes('*')) {
+        const regex = new RegExp(`^${normalized_pattern
+            .replace(/[.+?^${}()|[\]\\]/g, '\\$&')
+            .replaceAll('**', '.*')
+            .replaceAll('*', '[^/]*')}$`);
+        return regex.test(relative_path);
+    }
+    const target = isAbsolute(pattern)
+        ? resolve(pattern)
+        : resolve_project_path(cwd, pattern);
+    return (absolute_path === target || absolute_path.startsWith(`${target}/`));
+}
+function is_test_path(absolute_path) {
+    const path = absolute_path.replaceAll('\\', '/');
+    return (/(^|\/)(__tests__|tests?)\//.test(path) ||
+        /\.(test|spec)\.[cm]?[jt]sx?$/.test(path));
+}
+export function check_path_allowed(contract, input_path) {
+    const cwd = resolve(contract.cwd);
+    const absolute_path = resolve_project_path(cwd, input_path);
+    const inside_cwd = absolute_path === cwd || absolute_path.startsWith(`${cwd}/`);
+    if (!inside_cwd) {
+        return {
+            ok: false,
+            reason: `Harness ${contract.id}: path is outside cwd: ${input_path}`,
+        };
+    }
+    if (contract.forbidden_paths.some((pattern) => pattern_matches(cwd, pattern, absolute_path))) {
+        return {
+            ok: false,
+            reason: `Harness ${contract.id}: path is forbidden: ${input_path}`,
+        };
+    }
+    if (!contract.allow_test_changes && is_test_path(absolute_path)) {
+        return {
+            ok: false,
+            reason: `Harness ${contract.id}: test changes are not allowed by harness.json`,
+        };
+    }
+    if (!contract.allowed_paths.some((pattern) => pattern_matches(cwd, pattern, absolute_path))) {
+        return {
+            ok: false,
+            reason: `Harness ${contract.id}: path is outside allowed_paths: ${input_path}`,
+        };
+    }
+    return { ok: true };
+}
+export function check_command_allowed(contract, command) {
+    const blocked = contract.forbidden_commands.find((needle) => command.includes(needle));
+    if (blocked) {
+        return {
+            ok: false,
+            reason: `Harness ${contract.id}: command contains forbidden pattern: ${blocked}`,
+        };
+    }
+    if (!contract.allow_test_changes &&
+        /\brm\b.*((^|\/)(__tests__|tests?)\/|\.(test|spec)\.)/.test(command)) {
+        return {
+            ok: false,
+            reason: `Harness ${contract.id}: deleting tests is not allowed`,
+        };
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=policy.js.map

package/dist/enforcement/policy.js.map

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

package/dist/extension.d.ts

@@ -0,0 +1,3 @@
+import type { BeforeAgentStartEvent, ExtensionAPI } from '@earendil-works/pi-coding-agent';
+export declare function should_inject_harness_prompt(event: Pick<BeforeAgentStartEvent, 'systemPromptOptions'>): boolean;
+export default function harness(pi: ExtensionAPI): Promise<void>;

package/dist/extension.js

@@ -0,0 +1,180 @@
+import { existsSync } from 'node:fs';
+import { check_command_allowed, check_path_allowed, } from './enforcement/policy.js';
+import { harness_paths, read_contract } from './runtime/files.js';
+import { HARNESS_SYSTEM_PROMPT } from './prompt.js';
+import { active_harness_context, create_harness_runtime, format_harness_summary, update_harness_runtime, } from './runtime/index.js';
+import { HARNESS_CUSTOM_TYPE, harness_create_params_schema, harness_read_params_schema, harness_update_params_schema, } from './schema.js';
+function persist_active_harness(pi, harness_dir) {
+    pi.appendEntry(HARNESS_CUSTOM_TYPE, {
+        active_harness_dir: harness_dir,
+    });
+}
+function restore_active_harness(ctx) {
+    const entries = ctx.sessionManager.getEntries();
+    return entries
+        .filter((entry) => entry.type === 'custom' &&
+        entry.customType === HARNESS_CUSTOM_TYPE)
+        .pop()?.data?.active_harness_dir;
+}
+function update_harness_ui(ctx, harness_dir) {
+    if (!harness_dir ||
+        !existsSync(harness_paths(harness_dir).contract)) {
+        ctx.ui.setStatus('harness', undefined);
+        ctx.ui.setWidget('harness', undefined);
+        return;
+    }
+    const summary = format_harness_summary(harness_dir).split('\n');
+    ctx.ui.setStatus('harness', `🧪 ${summary[2]?.replace('Status: ', '')}`);
+    ctx.ui.setWidget('harness', summary.slice(0, 4));
+}
+function parse_command(args) {
+    const [command = 'status', ...rest] = args.trim().split(/\s+/);
+    return { command, rest: rest.join(' ').trim() };
+}
+function tool_text(text) {
+    return { content: [{ type: 'text', text }], details: {} };
+}
+export function should_inject_harness_prompt(event) {
+    const selected_tools = event.systemPromptOptions?.selectedTools;
+    return !selected_tools || selected_tools.includes('bash');
+}
+export default async function harness(pi) {
+    let active_harness_dir;
+    function set_active_harness(harness_dir, ctx) {
+        active_harness_dir = harness_dir;
+        persist_active_harness(pi, harness_dir);
+        update_harness_ui(ctx, harness_dir);
+    }
+    pi.registerCommand('harness', {
+        description: 'Create, use, run, review, and inspect ephemeral /tmp task harnesses',
+        handler: async (args, ctx) => {
+            const { command, rest } = parse_command(args);
+            if (command === 'clear') {
+                set_active_harness(undefined, ctx);
+                ctx.ui.notify('Cleared active harness', 'info');
+                return;
+            }
+            if (command === 'use') {
+                if (!rest) {
+                    ctx.ui.notify('Usage: /harness use <dir>', 'warning');
+                    return;
+                }
+                set_active_harness(rest, ctx);
+                ctx.ui.notify(`Active harness: ${rest}`, 'info');
+                return;
+            }
+            if (command === 'status') {
+                const harness_dir = rest || active_harness_dir;
+                if (!harness_dir) {
+                    ctx.ui.notify('No active harness', 'warning');
+                    return;
+                }
+                ctx.ui.notify(format_harness_summary(harness_dir), 'info');
+                return;
+            }
+            if (command === 'create') {
+                pi.sendUserMessage(`Use the create-harness skill to build a complete /tmp my-pi harness for this task. Use harness_create after context gathering. If the team tool is available, also create or reuse a team and add a team task whose description includes the harness directory.\n\n${rest}`);
+                return;
+            }
+            if (command === 'run') {
+                const harness_dir = rest || active_harness_dir;
+                if (!harness_dir) {
+                    ctx.ui.notify('Usage: /harness run <dir>', 'warning');
+                    return;
+                }
+                set_active_harness(harness_dir, ctx);
+                pi.sendUserMessage(`Use the execute-harness skill to run this harness until validation completes: ${harness_dir}. If the team tool is available, create or reuse a team, create a task for this harness, spawn one worktree mutating teammate with member_spawn, and have that teammate execute the harness. Then inspect team status/results before reporting.`);
+                return;
+            }
+            if (command === 'review') {
+                const harness_dir = rest || active_harness_dir;
+                if (!harness_dir) {
+                    ctx.ui.notify('Usage: /harness review <dir>', 'warning');
+                    return;
+                }
+                set_active_harness(harness_dir, ctx);
+                pi.sendUserMessage(`Use the review-harness skill to review drift, shortcuts, validation evidence, and remaining risks for: ${harness_dir}`);
+                return;
+            }
+            ctx.ui.notify('Usage: /harness create|run|review|status|use|clear', 'info');
+        },
+    });
+    pi.registerTool({
+        name: 'harness_create',
+        label: 'Create Harness',
+        description: 'Create an ephemeral /tmp my-pi task harness with machine-readable contract, prompts, scripts, logs, and status.',
+        promptSnippet: 'Create /tmp task harnesses for constrained agent execution',
+        promptGuidelines: [
+            'Use harness_create after context gathering for ambiguous or high-risk coding tasks.',
+            'Treat harness.json as the execution contract and record progress with harness_update.',
+        ],
+        parameters: harness_create_params_schema,
+        async execute(_tool_call_id, params, _signal, _on_update, ctx) {
+            const { harness_dir, contract } = create_harness_runtime(params, ctx.cwd);
+            set_active_harness(harness_dir, ctx);
+            return tool_text(`Created harness ${contract.id}\n${format_harness_summary(harness_dir)}`);
+        },
+    });
+    pi.registerTool({
+        name: 'harness_update',
+        label: 'Update Harness',
+        description: 'Update harness status, phase, notes, and validation evidence.',
+        parameters: harness_update_params_schema,
+        async execute(_tool_call_id, params, _signal, _on_update, ctx) {
+            const status_file = update_harness_runtime(params);
+            set_active_harness(params.harness_dir, ctx);
+            return tool_text(`Updated harness ${status_file.id}: ${status_file.status}`);
+        },
+    });
+    pi.registerTool({
+        name: 'harness_read',
+        label: 'Read Harness',
+        description: 'Read a harness contract, status, and runtime file locations.',
+        parameters: harness_read_params_schema,
+        async execute(_tool_call_id, params) {
+            return tool_text(format_harness_summary(params.harness_dir));
+        },
+    });
+    pi.on('session_start', async (_event, ctx) => {
+        active_harness_dir = restore_active_harness(ctx);
+        update_harness_ui(ctx, active_harness_dir);
+    });
+    pi.on('before_agent_start', async (event) => {
+        let system_prompt = event.systemPrompt;
+        if (should_inject_harness_prompt(event)) {
+            system_prompt = `${system_prompt}\n\n${HARNESS_SYSTEM_PROMPT}`;
+        }
+        if (active_harness_dir &&
+            existsSync(harness_paths(active_harness_dir).contract)) {
+            system_prompt = `${system_prompt}\n\n${active_harness_context(active_harness_dir)}`;
+        }
+        return { systemPrompt: system_prompt };
+    });
+    pi.on('tool_call', async (event) => {
+        if (!active_harness_dir ||
+            !existsSync(harness_paths(active_harness_dir).contract)) {
+            return;
+        }
+        const contract = read_contract(active_harness_dir);
+        if (event.toolName === 'bash') {
+            const input = event.input;
+            const command = input.command ?? '';
+            const result = check_command_allowed(contract, command);
+            if (!result.ok)
+                return { block: true, reason: result.reason };
+        }
+        if (event.toolName === 'edit' || event.toolName === 'write') {
+            const input = event.input;
+            if (!input.path)
+                return;
+            const result = check_path_allowed(contract, input.path);
+            if (!result.ok)
+                return { block: true, reason: result.reason };
+        }
+    });
+    pi.on('session_shutdown', async (_event, ctx) => {
+        ctx.ui.setStatus('harness', undefined);
+        ctx.ui.setWidget('harness', undefined);
+    });
+}
+//# sourceMappingURL=extension.js.map

package/dist/extension.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+export { default } from './extension.js';
+export { should_inject_harness_prompt } from './extension.js';
+export { check_command_allowed, check_path_allowed, } from './enforcement/policy.js';
+export { HARNESS_SYSTEM_PROMPT } from './prompt.js';
+export { active_harness_context, create_harness_runtime, format_harness_summary, update_harness_runtime, } from './runtime/index.js';
+export { collect_harness_outcome, render_outcome_markdown, write_outcome_artifacts, } from './runtime/outcome.js';
+export type { HarnessContract, HarnessCreateParams, HarnessLogEntry, HarnessOutcome, HarnessReadParams, HarnessStatus, HarnessStatusFile, HarnessThinking, HarnessUpdateParams, } from './schema.js';
+export { DEFAULT_FORBIDDEN_COMMANDS, HARNESS_CUSTOM_TYPE, HARNESS_VERSION, harness_create_params_schema, harness_read_params_schema, harness_update_params_schema, thinking_levels_schema, } from './schema.js';
+export declare const testing: {
+    harness_create_params_schema: import("typebox").TObject<{
+        task: import("typebox").TString;
+        slug: import("typebox").TOptional<import("typebox").TString>;
+        cwd: import("typebox").TOptional<import("typebox").TString>;
+        allowed_paths: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+        forbidden_paths: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+        validation_commands: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+        forbidden_commands: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+        allow_test_changes: import("typebox").TOptional<import("typebox").TBoolean>;
+        planner_model: import("typebox").TOptional<import("typebox").TString>;
+        planner_thinking: import("typebox").TOptional<import("typebox").TUnion<[import("typebox").TLiteral<"off">, import("typebox").TLiteral<"minimal">, import("typebox").TLiteral<"low">, import("typebox").TLiteral<"medium">, import("typebox").TLiteral<"high">, import("typebox").TLiteral<"xhigh">]>>;
+        executor_model: import("typebox").TOptional<import("typebox").TString>;
+        executor_thinking: import("typebox").TOptional<import("typebox").TUnion<[import("typebox").TLiteral<"off">, import("typebox").TLiteral<"minimal">, import("typebox").TLiteral<"low">, import("typebox").TLiteral<"medium">, import("typebox").TLiteral<"high">, import("typebox").TLiteral<"xhigh">]>>;
+        reviewer_model: import("typebox").TOptional<import("typebox").TString>;
+        reviewer_thinking: import("typebox").TOptional<import("typebox").TUnion<[import("typebox").TLiteral<"off">, import("typebox").TLiteral<"minimal">, import("typebox").TLiteral<"low">, import("typebox").TLiteral<"medium">, import("typebox").TLiteral<"high">, import("typebox").TLiteral<"xhigh">]>>;
+    }>;
+    harness_read_params_schema: import("typebox").TObject<{
+        harness_dir: import("typebox").TString;
+    }>;
+    harness_update_params_schema: import("typebox").TObject<{
+        harness_dir: import("typebox").TString;
+        status: import("typebox").TOptional<import("typebox").TUnion<[import("typebox").TLiteral<"created">, import("typebox").TLiteral<"running">, import("typebox").TLiteral<"reviewing">, import("typebox").TLiteral<"completed">, import("typebox").TLiteral<"failed">]>>;
+        phase: import("typebox").TOptional<import("typebox").TString>;
+        note: import("typebox").TOptional<import("typebox").TString>;
+        evidence: import("typebox").TOptional<import("typebox").TString>;
+        team_status: import("typebox").TOptional<import("typebox").TString>;
+        remaining_risks: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+        changed_files: import("typebox").TOptional<import("typebox").TArray<import("typebox").TString>>;
+    }>;
+};

package/dist/index.js

@@ -0,0 +1,14 @@
+import { harness_create_params_schema, harness_read_params_schema, harness_update_params_schema, } from './schema.js';
+export { default } from './extension.js';
+export { should_inject_harness_prompt } from './extension.js';
+export { check_command_allowed, check_path_allowed, } from './enforcement/policy.js';
+export { HARNESS_SYSTEM_PROMPT } from './prompt.js';
+export { active_harness_context, create_harness_runtime, format_harness_summary, update_harness_runtime, } from './runtime/index.js';
+export { collect_harness_outcome, render_outcome_markdown, write_outcome_artifacts, } from './runtime/outcome.js';
+export { DEFAULT_FORBIDDEN_COMMANDS, HARNESS_CUSTOM_TYPE, HARNESS_VERSION, harness_create_params_schema, harness_read_params_schema, harness_update_params_schema, thinking_levels_schema, } from './schema.js';
+export const testing = {
+    harness_create_params_schema,
+    harness_read_params_schema,
+    harness_update_params_schema,
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,GAC5B,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EACN,qBAAqB,EACrB,kBAAkB,GAClB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EACN,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,GACtB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACN,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,GACvB,MAAM,sBAAsB,CAAC;AAY9B,OAAO,EACN,0BAA0B,EAC1B,mBAAmB,EACnB,eAAe,EACf,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,EAC5B,sBAAsB,GACtB,MAAM,aAAa,CAAC;AAErB,MAAM,CAAC,MAAM,OAAO,GAAG;IACtB,4BAA4B;IAC5B,0BAA0B;IAC1B,4BAA4B;CAC5B,CAAC"}

package/dist/prompt.d.ts

@@ -0,0 +1 @@
+export declare const HARNESS_SYSTEM_PROMPT = "## my-pi harness workflow\n\nFor ambiguous, risky, or multi-step coding tasks, prefer a real harness instead of a prose-only plan. A harness is an ephemeral /tmp runtime with harness.json, SYSTEM.md, TASK.md, status.json, validation scripts, logs, and enforcement rules. Use the bundled create-harness skill plus the harness_create tool to build it, then execute inside the active harness until validation and review are complete.";

package/dist/prompt.js

@@ -0,0 +1,4 @@
+export const HARNESS_SYSTEM_PROMPT = `## my-pi harness workflow
+
+For ambiguous, risky, or multi-step coding tasks, prefer a real harness instead of a prose-only plan. A harness is an ephemeral /tmp runtime with harness.json, SYSTEM.md, TASK.md, status.json, validation scripts, logs, and enforcement rules. Use the bundled create-harness skill plus the harness_create tool to build it, then execute inside the active harness until validation and review are complete.`;
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,qBAAqB,GAAG;;kZAE6W,CAAC"}

package/dist/runtime/files.d.ts

@@ -0,0 +1,22 @@
+import type { HarnessContract, HarnessLogEntry, HarnessStatusFile } from '../schema.js';
+export declare function json_read<T>(path: string): T;
+export declare function json_write(path: string, value: unknown): void;
+export declare function shell_quote(value: string): string;
+export declare function harness_paths(harness_dir: string): {
+    contract: string;
+    system: string;
+    task: string;
+    status: string;
+    outcome: string;
+    outcome_markdown: string;
+    outcome_script: string;
+    validate: string;
+    review: string;
+    guard: string;
+    logs: string;
+};
+export declare function read_contract(harness_dir: string): HarnessContract;
+export declare function read_status(harness_dir: string): HarnessStatusFile;
+export declare function write_status(harness_dir: string, status_file: HarnessStatusFile): void;
+export declare function write_contract(harness_dir: string, contract: HarnessContract): void;
+export declare function append_event(harness_dir: string, entry: HarnessLogEntry): void;

package/dist/runtime/files.js

@@ -0,0 +1,46 @@
+import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+export function json_read(path) {
+    return JSON.parse(readFileSync(path, 'utf8'));
+}
+export function json_write(path, value) {
+    writeFileSync(path, `${JSON.stringify(value, null, 2)}\n`);
+}
+export function shell_quote(value) {
+    return `'${value.replaceAll("'", "'\\''")}'`;
+}
+export function harness_paths(harness_dir) {
+    return {
+        contract: join(harness_dir, 'harness.json'),
+        system: join(harness_dir, 'SYSTEM.md'),
+        task: join(harness_dir, 'TASK.md'),
+        status: join(harness_dir, 'status.json'),
+        outcome: join(harness_dir, 'outcome.json'),
+        outcome_markdown: join(harness_dir, 'OUTCOME.md'),
+        outcome_script: join(harness_dir, 'outcome.mjs'),
+        validate: join(harness_dir, 'validate.sh'),
+        review: join(harness_dir, 'review.sh'),
+        guard: join(harness_dir, 'guard.mjs'),
+        logs: join(harness_dir, 'logs'),
+    };
+}
+export function read_contract(harness_dir) {
+    return json_read(harness_paths(harness_dir).contract);
+}
+export function read_status(harness_dir) {
+    return json_read(harness_paths(harness_dir).status);
+}
+export function write_status(harness_dir, status_file) {
+    json_write(harness_paths(harness_dir).status, status_file);
+}
+export function write_contract(harness_dir, contract) {
+    json_write(harness_paths(harness_dir).contract, contract);
+}
+export function append_event(harness_dir, entry) {
+    const paths = harness_paths(harness_dir);
+    mkdirSync(paths.logs, { recursive: true });
+    writeFileSync(join(paths.logs, 'events.jsonl'), `${JSON.stringify(entry)}\n`, {
+        flag: 'a',
+    });
+}
+//# sourceMappingURL=files.js.map

package/dist/runtime/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/runtime/files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACjE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAOjC,MAAM,UAAU,SAAS,CAAI,IAAY;IACxC,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAM,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,IAAY,EAAE,KAAc;IACtD,aAAa,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,KAAa;IACxC,OAAO,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,WAAmB;IAChD,OAAO;QACN,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC;QAC3C,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC;QACtC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC;QAClC,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC;QACxC,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,cAAc,CAAC;QAC1C,gBAAgB,EAAE,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC;QACjD,cAAc,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC;QAChD,QAAQ,EAAE,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC;QAC1C,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC;QACtC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,WAAW,CAAC;QACrC,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC;KAC/B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,WAAmB;IAChD,OAAO,SAAS,CACf,aAAa,CAAC,WAAW,CAAC,CAAC,QAAQ,CACnC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,WAAmB;IAC9C,OAAO,SAAS,CACf,aAAa,CAAC,WAAW,CAAC,CAAC,MAAM,CACjC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAC3B,WAAmB,EACnB,WAA8B;IAE9B,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;AAC5D,CAAC;AAED,MAAM,UAAU,cAAc,CAC7B,WAAmB,EACnB,QAAyB;IAEzB,UAAU,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,UAAU,YAAY,CAC3B,WAAmB,EACnB,KAAsB;IAEtB,MAAM,KAAK,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC;IACzC,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,aAAa,CACZ,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,cAAc,CAAC,EAChC,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,EAC5B;QACC,IAAI,EAAE,GAAG;KACT,CACD,CAAC;AACH,CAAC"}

package/dist/runtime/index.d.ts

@@ -0,0 +1,8 @@
+import { type HarnessContract, type HarnessCreateParams, type HarnessStatusFile, type HarnessUpdateParams } from '../schema.js';
+export declare function create_harness_runtime(params: HarnessCreateParams, default_cwd: string): {
+    harness_dir: string;
+    contract: HarnessContract;
+};
+export declare function update_harness_runtime(params: HarnessUpdateParams): HarnessStatusFile;
+export declare function format_harness_summary(harness_dir: string): string;
+export declare function active_harness_context(harness_dir: string): string;