usesteady 0.1.0-alpha.1

package/dist/src/execution/claude/claude-execution-coordinator.js

@@ -0,0 +1,198 @@
+/**
+ * Claude Execution Coordinator — product seam wiring (Phase 8C).
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ *   The execution entry point for Claude Managed Agent requests.
+ *
+ *   Mirrors cursor-execution-coordinator.ts in structure:
+ *
+ *     prepareCursorExecution()    → prepareClaude Execution()
+ *     deliverCursorExecution()    → deliverClaudeExecution()
+ *
+ *   Two phases. Same intent-separation as Cursor:
+ *     Phase 1 (prepare): deterministic, synchronous, no side effects.
+ *                        Builds the artifact, evaluates OCD, returns confirmation state.
+ *     Phase 2 (deliver): async, requires H approval, dispatches to Claude API.
+ *                        Calls the delivery gate with an already-approved artifact.
+ *
+ * ── OCD evaluation for Claude ──────────────────────────────────────────────────
+ *
+ *   Claude OCD is simpler than Cursor OCD at V1.
+ *   The artifact already carries prohibitedPatterns from the mapper (ClaudeOCDPolicy).
+ *
+ *   The OCD check fires a conflict when parsedChange.filePath matches any
+ *   prohibitedPattern glob. This surfaces the conflict to H before delivery.
+ *   The delivery gate independently enforces prohibitedPatterns at delivery time
+ *   (defense-in-depth: gate is the hard block, OCD is the early warning).
+ *
+ * ── What this is NOT ──────────────────────────────────────────────────────────
+ *
+ *   NOT a scheduler       — does not queue or retry
+ *   NOT an OCD authority  — OCD fires conflicts; this surfaces them
+ *   NOT a decision maker  — all decisions flow from intake + OCD + H approval
+ *   NOT autonomous        — deliverClaudeExecution() requires an approved artifact
+ *
+ * ── Dependency direction ───────────────────────────────────────────────────────
+ *
+ *   Coordinator imports: intake types, claude module (all phases).
+ *   Claude module NEVER imports this coordinator.
+ *   Present layer NEVER imports this coordinator.
+ *
+ * ── Authority invariants preserved ────────────────────────────────────────────
+ *
+ *   - mode === "execute" is the only intake mode that opens Phase 1.
+ *   - eligibility === "approved_for_agent" is the only state that opens Phase 2.
+ *   - Raw input never crosses to Claude (enforced by ClaudeAgentHandoffArtifact shape).
+ *   - executionDomain is derived once in buildClaudeHandoffArtifact (A1).
+ *   - OCD fires conflicts; this surfaces them — never overrides them.
+ *   - H approval is explicit (approveClaudeArtifact before deliverClaudeExecution).
+ *
+ * See: docs/claude-agent-phase-a-architecture.md
+ */
+import { matchesGlob } from "../../cursor/glob-matcher.js";
+import { buildClaudeHandoffArtifact, } from "../../claude/artifact-mapper.js";
+import { ClaudeDeliveryGate } from "../../claude/delivery-gate.js";
+// ─── Phase 1: prepareClaudeExecution ──────────────────────────────────────────
+/**
+ * Build and OCD-evaluate a ClaudeAgentHandoffArtifact from an IntakeResult.
+ *
+ * Returns a preparation result describing what will happen and whether OCD
+ * has any conflicts. Synchronous and side-effect-free.
+ *
+ * @param intakeResult  Output of runIntake(). Must have mode === "execute".
+ * @param intentId      UCP envelope id of the intent.
+ * @param responseId    UCP envelope id of the response.
+ * @param policy        OCD policy (alwaysProhibitedGlobs, writeSafeGlobs).
+ * @param toolPolicy    Tool policy (allowedTools, networkAccess, filesystemMode).
+ * @param parsedChange  Optional: structured change parsed from the input.
+ */
+export function prepareClaudeExecution(intakeResult, intentId, responseId, policy, toolPolicy, parsedChange) {
+    if (intakeResult.mode !== "execute") {
+        return {
+            kind: "not_execute",
+            reason: `Cannot prepare Claude execution for mode "${intakeResult.mode}". Only "execute" mode is valid.`,
+        };
+    }
+    const artifact = buildClaudeHandoffArtifact(intakeResult, intentId, responseId, policy, toolPolicy, parsedChange);
+    const conflicts = evaluateClaudeOCD(artifact, policy, parsedChange);
+    const display = formatPreparationDisplay(artifact, conflicts);
+    if (conflicts.length > 0) {
+        return { kind: "conflict_detected", artifact, display };
+    }
+    return { kind: "ready_for_confirmation", artifact, display };
+}
+// ─── Phase 2: deliverClaudeExecution ──────────────────────────────────────────
+/**
+ * Deliver an already-approved ClaudeAgentHandoffArtifact through the delivery gate.
+ *
+ * Call this after H has called approveClaudeArtifact() on the prepared artifact.
+ *
+ * @param approvedArtifact  A ClaudeAgentHandoffArtifact with eligibility: "approved_for_agent".
+ * @param plugin            The transport adapter (ClaudeApiAdapter or stub).
+ * @param storeDir          Absolute path to the UCP store directory.
+ * @param deps              Optional: injectable persistence fns for testing.
+ */
+export async function deliverClaudeExecution(approvedArtifact, plugin, storeDir, deps) {
+    const gate = new ClaudeDeliveryGate(plugin, storeDir, deps);
+    const result = await gate.deliver(approvedArtifact);
+    switch (result.outcome) {
+        case "accepted":
+            return {
+                kind: "accepted",
+                deliveryId: result.deliveryId,
+                sessionId: result.sessionId,
+                display: {
+                    verdict: "accepted",
+                    headline: "Claude session started.",
+                    note: `Session ID: ${result.sessionId}`,
+                },
+            };
+        case "refused_due_to_scope":
+            return {
+                kind: "refused_due_to_scope",
+                deliveryId: result.deliveryId,
+                scopeQuestion: result.scopeQuestion,
+                display: {
+                    verdict: "refused",
+                    headline: "Claude needs scope clarification.",
+                    note: result.scopeQuestion.explanation,
+                },
+            };
+        case "refused_due_to_execution_error":
+            return {
+                kind: "refused_due_to_execution_error",
+                deliveryId: result.deliveryId,
+                errorCode: result.errorCode,
+                detail: result.message,
+                display: {
+                    verdict: "refused",
+                    headline: "Claude could not complete the task.",
+                    note: result.message,
+                },
+            };
+        case "blocked_ineligible":
+            return {
+                kind: "blocked_ineligible",
+                display: {
+                    verdict: "blocked",
+                    headline: "Delivery blocked: artifact not approved.",
+                    note: result.reason,
+                },
+            };
+        case "blocked_tool_policy":
+            return {
+                kind: "blocked_tool_policy",
+                reason: result.reason,
+                display: {
+                    verdict: "blocked",
+                    headline: "Delivery blocked: tool policy violation.",
+                    note: result.reason,
+                },
+            };
+        case "blocked_persistence_failure":
+            return {
+                kind: "blocked_persistence_failure",
+                reason: result.reason,
+                display: {
+                    verdict: "blocked",
+                    headline: "Delivery blocked: provenance could not be recorded.",
+                    note: result.reason,
+                },
+            };
+    }
+}
+// ─── OCD evaluation ───────────────────────────────────────────────────────────
+/**
+ * Evaluate OCD rules for the Claude artifact.
+ *
+ * V1 rules:
+ *   CLAUDE_OCD_1 — parsedChange.filePath matches a prohibitedPattern
+ *
+ * Returns human-readable conflict messages. Empty array = no conflicts.
+ */
+function evaluateClaudeOCD(artifact, _policy, parsedChange) {
+    const conflicts = [];
+    if (!parsedChange?.filePath)
+        return conflicts;
+    for (const pattern of artifact.prohibitedPatterns) {
+        if (matchesGlob(parsedChange.filePath, pattern)) {
+            conflicts.push(`Target file "${parsedChange.filePath}" matches prohibited pattern "${pattern}". ` +
+                `Editing this file requires explicit conflict acceptance.`);
+            break; // one conflict message per file is enough
+        }
+    }
+    return conflicts;
+}
+// ─── Display formatting ───────────────────────────────────────────────────────
+function formatPreparationDisplay(artifact, conflicts) {
+    const hasConflict = conflicts.length > 0;
+    const targetFile = artifact.allowedFiles[0] ?? null;
+    return {
+        headline: hasConflict ? "Conflict detected. Review before approving." : "Ready to delegate to Claude.",
+        summary: artifact.taskSpec.summary,
+        targetFile,
+        conflicts,
+    };
+}
+//# sourceMappingURL=claude-execution-coordinator.js.map

package/dist/src/execution/claude/claude-execution-coordinator.js.map

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

package/dist/src/execution/claude/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Claude Execution — Phase 8C public API.
+ *
+ * Consumer pattern:
+ *   const prep = prepareClaudeExecution(intake, intentId, responseId, policy, toolPolicy);
+ *   // show prep to H; H may accept conflicts or reject
+ *   const approved = approveClaudeArtifact(prep.artifact, Date.now());
+ *   const result = await deliverClaudeExecution(approved, plugin, storeDir);
+ *   // route on result.kind
+ */
+export type { ClaudePreparationResult, ClaudePreparationDisplay, ClaudeExecutionResult, ClaudeExecutionDisplay, } from "./claude-execution-coordinator.js";
+export { prepareClaudeExecution, deliverClaudeExecution, } from "./claude-execution-coordinator.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/execution/claude/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/execution/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,mCAAmC,CAAC"}

package/dist/src/execution/claude/index.js

@@ -0,0 +1,12 @@
+/**
+ * Claude Execution — Phase 8C public API.
+ *
+ * Consumer pattern:
+ *   const prep = prepareClaudeExecution(intake, intentId, responseId, policy, toolPolicy);
+ *   // show prep to H; H may accept conflicts or reject
+ *   const approved = approveClaudeArtifact(prep.artifact, Date.now());
+ *   const result = await deliverClaudeExecution(approved, plugin, storeDir);
+ *   // route on result.kind
+ */
+export { prepareClaudeExecution, deliverClaudeExecution, } from "./claude-execution-coordinator.js";
+//# sourceMappingURL=index.js.map

package/dist/src/execution/claude/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/execution/claude/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,OAAO,EACL,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,mCAAmC,CAAC"}

package/dist/src/execution/cursor/cursor-execution-coordinator.d.ts

@@ -0,0 +1,216 @@
+/**
+ * Cursor Execution Coordinator — product seam wiring.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ *   The execution entry point for code-change requests.
+ *
+ *   Mirrors the reminder execution coordinator in structure:
+ *
+ *     presentFromInput()         — intake result → display-ready presentation
+ *     executeFromPresent()       — present result → display-ready execution outcome
+ *
+ *     prepareCursorExecution()   — intake result → artifact ready for H confirmation
+ *     deliverCursorExecution()   — approved artifact + gate → display-ready outcome
+ *
+ *   Two phases are intentional. The split preserves the authority model:
+ *     Phase 1 (prepare): deterministic, synchronous, no side effects.
+ *                        Builds the artifact, runs OCD, returns confirmation state.
+ *     Phase 2 (deliver): async, requires H approval, produces real file changes.
+ *                        Calls the delivery gate with an already-approved artifact.
+ *
+ * ── What this is NOT ──────────────────────────────────────────────────────────
+ *
+ *   NOT a scheduler       — does not queue or retry
+ *   NOT an OCD authority  — OCD fires conflicts; this surfaces them
+ *   NOT a decision maker  — all decisions flow from intake + OCD + H approval
+ *   NOT autonomous        — deliverCursorExecution() requires an approved artifact
+ *
+ * ── Consumer contract ─────────────────────────────────────────────────────────
+ *
+ *   Step 1 — Prepare:
+ *     const prep = prepareCursorExecution(intakeResult, intentId, responseId, policy);
+ *     if (prep.kind !== "ready_for_confirmation" && prep.kind !== "conflict_detected") return;
+ *     // show prep.artifact to H; H may narrow scope or accept conflicts
+ *
+ *   Step 2 — H approves:
+ *     const approved = approveArtifact(prep.artifact, Date.now());
+ *
+ *   Step 3 — Deliver:
+ *     const result = await deliverCursorExecution(approved, gate);
+ *     // route on result.kind: "accepted" | "refused_due_to_scope" | ...
+ *
+ * ── Dependency direction ───────────────────────────────────────────────────────
+ *
+ *   Coordinator imports: intake types, cursor module (all phases).
+ *   Cursor module NEVER imports this coordinator.
+ *   Present layer NEVER imports this coordinator.
+ *   One-way dependencies only.
+ *
+ * ── Authority invariants preserved ────────────────────────────────────────────
+ *
+ *   - mode === "execute" is the only intake mode that opens Phase 1.
+ *   - eligibility === "approved_for_cursor" is the only state that opens Phase 2.
+ *   - Raw input never crosses to the delivery gate (enforced by CursorHandoffArtifact shape).
+ *   - OCD fires conflicts; this surfaces them — never overrides them.
+ *   - H approval is explicit (approveArtifact before deliverCursorExecution).
+ *
+ * See: docs/cursor-integration-architecture.md — authority model
+ *      docs/cursor-delivery-contract.md        — delivery paths
+ *      src/execution/reminders/reminder-execution-coordinator.ts — pattern reference
+ */
+import type { IntakeResult } from "../../intake/types.js";
+import type { ReplaceChange } from "../../understand/interpretation/types.js";
+type ParsedChange = ReplaceChange;
+import type { CursorHandoffArtifact, CursorOCDPolicy, CursorScopeQuestion, CursorExecutionErrorCode } from "../../cursor/index.js";
+import type { CursorEditorPlugin } from "../../cursor/delivery-gate.js";
+import type { CursorGateDeps } from "../../cursor/delivery-gate.js";
+/**
+ * Hints for wiring contradiction visibility via presentFromInput().
+ *
+ * Pass these to presentFromInput(rawInput, intakeResult, trace, policyHint, parsedChangeHint)
+ * to surface policy_may_block_target when an execute-mode request targets a
+ * prohibited path (Phase 5D cross-layer contradiction visibility).
+ *
+ *   prohibitedGlobs    — from CursorOCDPolicy.alwaysProhibitedGlobs
+ *   parsedChangeFilePath — from the parsedChange extracted during preparation (if any)
+ */
+export type CursorPresentHints = {
+    readonly prohibitedGlobs: readonly string[];
+    readonly parsedChangeFilePath?: string;
+};
+/**
+ * CursorPreparationResult — returned by prepareCursorExecution().
+ *
+ *   "ready_for_confirmation"  OCD cleared. Artifact awaits H approval.
+ *   "conflict_detected"       OCD fired one or more conflicts. H must review.
+ *                             H may call acceptOCDConflict() then approve.
+ *   "not_execute"             intakeResult.mode was not "execute". No artifact produced.
+ *
+ * For execute-mode results, presentHints can be passed directly to
+ * presentFromInput() to enable Phase 5D contradiction visibility.
+ */
+export type CursorPreparationResult = {
+    readonly kind: "ready_for_confirmation";
+    readonly artifact: CursorHandoffArtifact;
+    readonly display: CursorPreparationDisplay;
+    readonly presentHints: CursorPresentHints;
+} | {
+    readonly kind: "conflict_detected";
+    readonly artifact: CursorHandoffArtifact;
+    readonly display: CursorPreparationDisplay;
+    readonly presentHints: CursorPresentHints;
+} | {
+    readonly kind: "not_execute";
+    readonly reason: string;
+};
+/**
+ * CursorPreparationDisplay — consumer-ready strings for the Phase 1 result.
+ *
+ *   headline     — "Ready to apply" / "Conflict detected" (for confirm UI)
+ *   summary      — what the change will do (from changeSpec.summary)
+ *   targetFile   — the proposed target file, if already known (from allowedFiles[0])
+ *   conflicts    — human-readable OCD conflict messages; empty when cleared
+ */
+export type CursorPreparationDisplay = {
+    readonly headline: string;
+    readonly summary: string;
+    readonly targetFile: string | null;
+    readonly conflicts: readonly string[];
+};
+/**
+ * CursorExecutionResult — returned by deliverCursorExecution().
+ *
+ * Mirrors DeliveryGateResult but adds consumer-ready display strings.
+ *
+ *   "accepted"                      Edit applied. File mutated on disk.
+ *   "refused_due_to_scope"          Cursor needs H to narrow scope.
+ *   "refused_due_to_execution_error" Cursor could not apply the edit.
+ *   "blocked_ineligible"            Artifact not approved. Caller error.
+ *   "blocked_persistence_failure"   Handoff provenance could not be recorded.
+ */
+export type CursorExecutionResult = {
+    readonly kind: "accepted";
+    readonly deliveryId: string;
+    readonly artifactId: string;
+    readonly handoffEnvelopeId: string;
+    readonly receiptEnvelopeId: string;
+    readonly display: CursorExecutionDisplay;
+} | {
+    readonly kind: "refused_due_to_scope";
+    readonly deliveryId: string;
+    readonly scopeQuestion: CursorScopeQuestion;
+    readonly display: CursorExecutionDisplay;
+} | {
+    readonly kind: "refused_due_to_execution_error";
+    readonly deliveryId: string;
+    readonly errorCode: CursorExecutionErrorCode;
+    readonly detail: string;
+    readonly display: CursorExecutionDisplay;
+} | {
+    readonly kind: "blocked_ineligible";
+    readonly display: CursorExecutionDisplay;
+} | {
+    readonly kind: "blocked_persistence_failure";
+    readonly reason: string;
+    readonly display: CursorExecutionDisplay;
+};
+/**
+ * CursorExecutionDisplay — consumer-ready strings for the Phase 2 result.
+ *
+ *   verdict   — "accepted" | "refused" | "blocked"
+ *   headline  — single-line summary for the user
+ *   note      — additional detail for the user; null when headline is sufficient
+ */
+export type CursorExecutionDisplay = {
+    readonly verdict: "accepted" | "refused" | "blocked";
+    readonly headline: string;
+    readonly note: string | null;
+};
+/**
+ * Build and OCD-evaluate a CursorHandoffArtifact from an IntakeResult.
+ *
+ * Call this when intakeResult.mode === "execute" and the consumer wants to
+ * present a confirmation to H before delivery. Returns a preparation result
+ * that describes what will happen and whether OCD has any conflicts.
+ *
+ * This is synchronous and side-effect-free. No files are read or written.
+ *
+ * @param intakeResult  Output of runIntake(). Must have mode === "execute".
+ * @param intentId      UCP envelope id of the intent (from runIntakeWithUCP).
+ * @param responseId    UCP envelope id of the response (from runIntakeWithUCP).
+ * @param policy        OCD policy — write_safe_globs, prohibited patterns, etc.
+ */
+export declare function prepareCursorExecution(intakeResult: IntakeResult, intentId: string, responseId: string, policy: CursorOCDPolicy, parsedChange?: ParsedChange): CursorPreparationResult;
+/**
+ * Deliver an already-approved CursorHandoffArtifact through the delivery gate.
+ *
+ * Call this after H has called approveArtifact() on the prepared artifact.
+ * The gate enforces that eligibility === "approved_for_cursor" before proceeding.
+ *
+ * @param approvedArtifact  A CursorHandoffArtifact with eligibility: "approved_for_cursor".
+ * @param plugin            The transport adapter (in-process, IPC, etc.).
+ * @param storeDir          Absolute path to the UCP store directory.
+ * @param deps              Optional: injectable persistence fns for testing.
+ */
+export declare function deliverCursorExecution(approvedArtifact: CursorHandoffArtifact, plugin: CursorEditorPlugin, storeDir: string, deps?: CursorGateDeps): Promise<CursorExecutionResult>;
+/**
+ * Returns true if the preparation result needs H to review OCD conflicts
+ * before the artifact can be approved.
+ */
+export declare function hasConflicts(result: CursorPreparationResult): boolean;
+/**
+ * Returns true if the execution result is "accepted" (edit applied on disk).
+ */
+export declare function isCursorExecutionAccepted(result: CursorExecutionResult): boolean;
+/**
+ * Returns a plain-English note for the consumer to display.
+ *
+ * "accepted"                      → null (headline is sufficient)
+ * "refused_due_to_scope"          → scope question explanation
+ * "refused_due_to_execution_error" → detail text
+ * "blocked_*"                     → block reason
+ */
+export declare function getCursorExecutionNote(result: CursorExecutionResult): string | null;
+export {};
+//# sourceMappingURL=cursor-execution-coordinator.d.ts.map

package/dist/src/execution/cursor/cursor-execution-coordinator.d.ts.map

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