usesteady 0.1.0-alpha.1

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

@@ -0,0 +1,233 @@
+/**
+ * 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 { buildCursorHandoffArtifact, evaluateOCDForHandoff, applyOCDClearance, } from "../../cursor/index.js";
+import { CursorDeliveryGate } from "../../cursor/delivery-gate.js";
+// ─── Phase 1: prepareCursorExecution ─────────────────────────────────────────
+/**
+ * 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 function prepareCursorExecution(intakeResult, intentId, responseId, policy, parsedChange) {
+    if (intakeResult.mode !== "execute") {
+        return {
+            kind: "not_execute",
+            reason: `Cannot prepare cursor execution for mode "${intakeResult.mode}". Only "execute" mode is valid.`,
+        };
+    }
+    const artifact = buildCursorHandoffArtifact(intakeResult, intentId, responseId, policy, parsedChange);
+    const ocdClearance = evaluateOCDForHandoff(artifact, policy);
+    const withClearance = applyOCDClearance(artifact, ocdClearance);
+    const display = formatPreparationDisplay(withClearance);
+    const presentHints = {
+        prohibitedGlobs: policy.alwaysProhibitedGlobs,
+        ...(parsedChange?.filePath !== undefined
+            ? { parsedChangeFilePath: parsedChange.filePath }
+            : {}),
+    };
+    if (ocdClearance.status === "cleared" || ocdClearance.status === "conflict_accepted") {
+        return { kind: "ready_for_confirmation", artifact: withClearance, display, presentHints };
+    }
+    return { kind: "conflict_detected", artifact: withClearance, display, presentHints };
+}
+// ─── Phase 2: deliverCursorExecution ─────────────────────────────────────────
+/**
+ * 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 async function deliverCursorExecution(approvedArtifact, plugin, storeDir, deps) {
+    const gate = new CursorDeliveryGate(plugin, storeDir, deps);
+    const result = await gate.deliver(approvedArtifact);
+    switch (result.outcome) {
+        case "accepted":
+            return {
+                kind: "accepted",
+                deliveryId: result.deliveryId,
+                artifactId: approvedArtifact.id,
+                handoffEnvelopeId: result.handoffEnvelopeId,
+                receiptEnvelopeId: result.receiptEnvelopeId,
+                display: { verdict: "accepted", headline: "Edit applied.", note: null },
+            };
+        case "refused_due_to_scope":
+            return {
+                kind: "refused_due_to_scope",
+                deliveryId: result.deliveryId,
+                scopeQuestion: result.scopeQuestion,
+                display: {
+                    verdict: "refused",
+                    headline: "Scope clarification needed.",
+                    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.detail,
+                display: {
+                    verdict: "refused",
+                    headline: formatErrorHeadline(result.errorCode),
+                    note: result.detail,
+                },
+            };
+        case "blocked_ineligible":
+            return {
+                kind: "blocked_ineligible",
+                display: {
+                    verdict: "blocked",
+                    headline: "Delivery blocked: artifact not approved.",
+                    note: result.reason,
+                },
+            };
+        case "blocked_persistence_failure":
+            return {
+                kind: "blocked_persistence_failure",
+                reason: result.reason,
+                display: {
+                    verdict: "blocked",
+                    headline: "Delivery blocked: provenance record could not be written.",
+                    note: result.reason,
+                },
+            };
+    }
+}
+// ─── Consumer helpers ─────────────────────────────────────────────────────────
+/**
+ * Returns true if the preparation result needs H to review OCD conflicts
+ * before the artifact can be approved.
+ */
+export function hasConflicts(result) {
+    return result.kind === "conflict_detected";
+}
+/**
+ * Returns true if the execution result is "accepted" (edit applied on disk).
+ */
+export function isCursorExecutionAccepted(result) {
+    return result.kind === "accepted";
+}
+/**
+ * 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 function getCursorExecutionNote(result) {
+    switch (result.kind) {
+        case "accepted":
+            return null;
+        case "refused_due_to_scope":
+            return result.scopeQuestion.explanation;
+        case "refused_due_to_execution_error":
+            return result.detail;
+        case "blocked_ineligible":
+            return "Artifact must be approved by H before delivery.";
+        case "blocked_persistence_failure":
+            return result.reason;
+    }
+}
+// ─── Internal formatters ──────────────────────────────────────────────────────
+function formatPreparationDisplay(artifact) {
+    const { ocdClearance, changeSpec, scopeConstraint } = artifact;
+    const cleared = ocdClearance.status === "cleared" || ocdClearance.status === "conflict_accepted";
+    const headline = cleared ? "Ready to apply." : "Conflict detected — review before confirming.";
+    const targetFile = scopeConstraint.allowedFiles.length === 1
+        ? (scopeConstraint.allowedFiles[0] ?? null)
+        : null;
+    return {
+        headline,
+        summary: changeSpec.summary,
+        targetFile,
+        conflicts: ocdClearance.conflictsDetected,
+    };
+}
+function formatErrorHeadline(errorCode) {
+    switch (errorCode) {
+        case "old_value_not_found": return "Edit target not found in file.";
+        case "ambiguous_match": return "Edit target is ambiguous — found more than once.";
+        case "file_not_found": return "Target file not found.";
+        case "scope_outside_allowed": return "Target file is outside the approved scope.";
+        case "prohibited_pattern_match": return "Target file matches a prohibited pattern.";
+        case "parse_error": return "No edit directive available.";
+        case "merge_conflict": return "File could not be written — possible merge conflict.";
+        case "delivery_timeout": return "Delivery timed out.";
+    }
+}
+//# sourceMappingURL=cursor-execution-coordinator.js.map

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

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

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

@@ -0,0 +1,20 @@
+/**
+ * Cursor execution layer — public API.
+ *
+ * Exports the two-phase product seam coordinator and its display types.
+ * Internal cursor module (src/cursor/) is re-exported separately via src/cursor/index.ts.
+ *
+ * Consumer entry points:
+ *   prepareCursorExecution()   — Phase 1: build + OCD → artifact for H confirmation
+ *   deliverCursorExecution()   — Phase 2: approved artifact + gate → file mutation
+ *
+ * Consumer helpers:
+ *   hasConflicts()             — check if OCD fired (H must review before approving)
+ *   isCursorExecutionAccepted() — check if edit was applied
+ *   getCursorExecutionNote()   — plain-English note for display
+ */
+export type { CursorPreparationResult, CursorPreparationDisplay, CursorExecutionResult, CursorExecutionDisplay, } from "./cursor-execution-coordinator.js";
+export { prepareCursorExecution, deliverCursorExecution, hasConflicts, isCursorExecutionAccepted, getCursorExecutionNote, } from "./cursor-execution-coordinator.js";
+export type { ParsedChange } from "../../understand/interpretation/types.js";
+export { parseChange } from "../../understand/interpretation/parser.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/execution/cursor/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,YAAY,EACV,uBAAuB,EACvB,wBAAwB,EACxB,qBAAqB,EACrB,sBAAsB,GACvB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,YAAY,EACZ,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,mCAAmC,CAAC;AAI3C,YAAY,EAAE,YAAY,EAAE,MAAM,0CAA0C,CAAC;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAY,2CAA2C,CAAC"}

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

@@ -0,0 +1,18 @@
+/**
+ * Cursor execution layer — public API.
+ *
+ * Exports the two-phase product seam coordinator and its display types.
+ * Internal cursor module (src/cursor/) is re-exported separately via src/cursor/index.ts.
+ *
+ * Consumer entry points:
+ *   prepareCursorExecution()   — Phase 1: build + OCD → artifact for H confirmation
+ *   deliverCursorExecution()   — Phase 2: approved artifact + gate → file mutation
+ *
+ * Consumer helpers:
+ *   hasConflicts()             — check if OCD fired (H must review before approving)
+ *   isCursorExecutionAccepted() — check if edit was applied
+ *   getCursorExecutionNote()   — plain-English note for display
+ */
+export { prepareCursorExecution, deliverCursorExecution, hasConflicts, isCursorExecutionAccepted, getCursorExecutionNote, } from "./cursor-execution-coordinator.js";
+export { parseChange } from "../../understand/interpretation/parser.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/execution/cursor/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AASH,OAAO,EACL,sBAAsB,EACtB,sBAAsB,EACtB,YAAY,EACZ,yBAAyB,EACzB,sBAAsB,GACvB,MAAM,mCAAmC,CAAC;AAK3C,OAAO,EAAE,WAAW,EAAE,MAAY,2CAA2C,CAAC"}

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

@@ -0,0 +1,11 @@
+/**
+ * Reminder Execution — Phase 6, Execution Layer.
+ * Barrel export.
+ */
+export type { ReminderExecutionRequest, ParsedTime, ExecutionRejectionCode, ExecutionValidation, ReminderExecutionArtifact, ReminderExecutionResult, } from "./reminder-execution-types.js";
+export { parseTimeText } from "./reminder-time-parser.js";
+export { validateExecutionRequest } from "./reminder-execution-validator.js";
+export { buildExecutionRequest, executeReminder } from "./reminder-executor.js";
+export type { ReminderExecutionDisplay, ReminderExecuteResult, } from "./reminder-execution-coordinator.js";
+export { executeFromPresent, isExecutionAccepted, getExecutionNote, } from "./reminder-execution-coordinator.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/execution/reminders/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,YAAY,EACV,wBAAwB,EACxB,UAAU,EACV,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAE,MAAiB,2BAA2B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGhF,YAAY,EACV,wBAAwB,EACxB,qBAAqB,GACtB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,qCAAqC,CAAC"}

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

@@ -0,0 +1,9 @@
+/**
+ * Reminder Execution — Phase 6, Execution Layer.
+ * Barrel export.
+ */
+export { parseTimeText } from "./reminder-time-parser.js";
+export { validateExecutionRequest } from "./reminder-execution-validator.js";
+export { buildExecutionRequest, executeReminder } from "./reminder-executor.js";
+export { executeFromPresent, isExecutionAccepted, getExecutionNote, } from "./reminder-execution-coordinator.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/execution/reminders/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,EAAE,aAAa,EAAE,MAAiB,2BAA2B,CAAC;AACrE,OAAO,EAAE,wBAAwB,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAOhF,OAAO,EACL,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,qCAAqC,CAAC"}

package/dist/src/execution/reminders/reminder-execution-coordinator.d.ts

@@ -0,0 +1,125 @@
+/**
+ * Reminder Execution Coordinator — Phase 6, integration path.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ * A single consumer entry point that bridges the Present Layer (Phase 5) and
+ * the Execution Layer (Phase 6). It takes a PresentResult and, if the reminder
+ * is ready to confirm, runs the execution pipeline and returns a display-ready
+ * outcome.
+ *
+ * This is the exact equivalent of Phase 5's presentFromInput() for execution:
+ *   presentFromInput()   — intake result → display-ready presentation
+ *   executeFromPresent() — present result → display-ready execution outcome
+ *
+ * ── What this is NOT ─────────────────────────────────────────────────────────
+ *
+ *   NOT a scheduler       — does not schedule or persist reminders
+ *   NOT an OS integration — does not call any calendar/notification APIs
+ *   NOT a decision maker  — all decisions flow from intake + execution pipeline
+ *   NOT creepy            — does not act without consumer triggering it
+ *
+ * ── Consumer contract ─────────────────────────────────────────────────────────
+ *
+ *   Consumer calls executeFromPresent(presentResult) when the user confirms.
+ *   Consumer receives ReminderExecuteResult.
+ *   Consumer checks result.kind to route:
+ *
+ *     "accepted"    → show accepted display; ready for downstream scheduling
+ *     "rejected"    → show rejection display; prompt user to correct
+ *     "not_ready"   → reminder present but incomplete; do not execute
+ *     "not_reminder" → was not a reminder at all; ignore or reroute
+ *
+ * ── "accepted" semantics ──────────────────────────────────────────────────────
+ *
+ *   "accepted" means: structurally valid for downstream scheduling.
+ *   It does NOT mean:  scheduled, delivered, or resolved to a concrete date.
+ *   The artifact is the handoff record. A real scheduler would consume it.
+ *
+ * ── Dependency direction ──────────────────────────────────────────────────────
+ *
+ *   Coordinator imports Present (PresentResult) and Execution.
+ *   Present NEVER imports Execution.
+ *   Execution NEVER imports Coordinator.
+ *   One-way dependencies only.
+ */
+import type { PresentResult } from "../../present/present-coordinator.js";
+import type { ReminderPresentationState } from "../../present/reminders/reminder-types.js";
+import type { ReminderExecutionArtifact, ExecutionRejectionCode } from "./reminder-execution-types.js";
+/**
+ * ReminderExecutionDisplay — consumer-ready formatted strings for the result.
+ *
+ * Keeps the coordinator honest: it formats, it does not execute.
+ *
+ *   verdict        — "accepted" or "rejected"
+ *   headline       — single-line summary ("Reminder accepted" / "Reminder rejected")
+ *   subject        — the reminder task, for display
+ *   time_text      — the original time phrase, for display (not normalised)
+ *   rejection_note — why it was rejected; present only when verdict === "rejected"
+ */
+export type ReminderExecutionDisplay = {
+    readonly verdict: "accepted" | "rejected";
+    readonly headline: string;
+    readonly subject: string;
+    readonly time_text: string;
+    readonly rejection_note?: string;
+};
+/**
+ * ReminderExecuteResult — discriminated union returned by executeFromPresent().
+ *
+ *   "accepted"     — execution artifact produced with verdict === "accepted"
+ *   "rejected"     — execution artifact produced with verdict === "rejected"
+ *   "not_ready"    — input was a reminder but not yet complete (missing fields)
+ *   "not_reminder" — input was not a reminder at all
+ *
+ * Both "accepted" and "rejected" arms carry:
+ *   - artifact: the full ReminderExecutionArtifact (for UCP mapping, audit)
+ *   - display:  formatted strings ready for rendering
+ */
+export type ReminderExecuteResult = {
+    readonly kind: "accepted";
+    readonly artifact: ReminderExecutionArtifact;
+    readonly display: ReminderExecutionDisplay;
+} | {
+    readonly kind: "rejected";
+    readonly artifact: ReminderExecutionArtifact;
+    readonly display: ReminderExecutionDisplay;
+    readonly code: ExecutionRejectionCode;
+} | {
+    readonly kind: "not_ready";
+    /** The presentation state explains why it was not ready. */
+    readonly presentation_state: ReminderPresentationState;
+    /** The fields the user still needs to provide. */
+    readonly missing: readonly string[];
+} | {
+    readonly kind: "not_reminder";
+};
+/**
+ * Execute a reminder from an already-produced PresentResult.
+ *
+ * Call this when the user clicks "Confirm" on a reminder presentation.
+ * Returns a ReminderExecuteResult the consumer can render directly.
+ *
+ * @param presentResult  The output of presentFromInput().
+ * @param _now           Epoch ms; defaults to Date.now(). Injectable for tests.
+ */
+export declare function executeFromPresent(presentResult: PresentResult, _now?: number): ReminderExecuteResult;
+/**
+ * Returns true if the execution result is "accepted".
+ *
+ * Convenience predicate — consumers use this to enable downstream actions
+ * (e.g. passing the artifact to a real scheduler in Phase 7+).
+ *
+ * Zero authority: this only reads the result, never changes it.
+ */
+export declare function isExecutionAccepted(result: ReminderExecuteResult): boolean;
+/**
+ * Returns a plain-English note for the consumer to display alongside the result.
+ *
+ * "accepted"     → null (no extra note needed; display.headline is sufficient)
+ * "rejected"     → the rejection note from the display
+ * "not_ready"    → a prompt describing which fields are still missing
+ * "not_reminder" → null
+ */
+export declare function getExecutionNote(result: ReminderExecuteResult): string | null;
+//# sourceMappingURL=reminder-execution-coordinator.d.ts.map

package/dist/src/execution/reminders/reminder-execution-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reminder-execution-coordinator.d.ts","sourceRoot":"","sources":["../../../../src/execution/reminders/reminder-execution-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAoB,sCAAsC,CAAC;AACxF,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAQ,2CAA2C,CAAC;AAC7F,OAAO,KAAK,EACV,yBAAyB,EACzB,sBAAsB,EACvB,MAAM,+BAA+B,CAAC;AAKvC;;;;;;;;;;GAUG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,OAAO,EAAU,UAAU,GAAG,UAAU,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAS,MAAM,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAU,MAAM,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAQ,MAAM,CAAC;IACjC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC,CAAC;AAIF;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,qBAAqB,GAC7B;IACE,QAAQ,CAAC,IAAI,EAAM,UAAU,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAG,wBAAwB,CAAC;CAC7C,GACD;IACE,QAAQ,CAAC,IAAI,EAAM,UAAU,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;IAC7C,QAAQ,CAAC,OAAO,EAAG,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,IAAI,EAAM,sBAAsB,CAAC;CAC3C,GACD;IACE,QAAQ,CAAC,IAAI,EAAgB,WAAW,CAAC;IACzC,4DAA4D;IAC5D,QAAQ,CAAC,kBAAkB,EAAE,yBAAyB,CAAC;IACvD,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAa,SAAS,MAAM,EAAE,CAAC;CAChD,GACD;IACE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;CAC/B,CAAC;AAIN;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,aAAa,EAC5B,IAAI,GAAW,MAAmB,GACjC,qBAAqB,CA0BvB;AAID;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAE1E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,qBAAqB,GAAG,MAAM,GAAG,IAAI,CAiB7E"}

package/dist/src/execution/reminders/reminder-execution-coordinator.js

@@ -0,0 +1,129 @@
+/**
+ * Reminder Execution Coordinator — Phase 6, integration path.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ * A single consumer entry point that bridges the Present Layer (Phase 5) and
+ * the Execution Layer (Phase 6). It takes a PresentResult and, if the reminder
+ * is ready to confirm, runs the execution pipeline and returns a display-ready
+ * outcome.
+ *
+ * This is the exact equivalent of Phase 5's presentFromInput() for execution:
+ *   presentFromInput()   — intake result → display-ready presentation
+ *   executeFromPresent() — present result → display-ready execution outcome
+ *
+ * ── What this is NOT ─────────────────────────────────────────────────────────
+ *
+ *   NOT a scheduler       — does not schedule or persist reminders
+ *   NOT an OS integration — does not call any calendar/notification APIs
+ *   NOT a decision maker  — all decisions flow from intake + execution pipeline
+ *   NOT creepy            — does not act without consumer triggering it
+ *
+ * ── Consumer contract ─────────────────────────────────────────────────────────
+ *
+ *   Consumer calls executeFromPresent(presentResult) when the user confirms.
+ *   Consumer receives ReminderExecuteResult.
+ *   Consumer checks result.kind to route:
+ *
+ *     "accepted"    → show accepted display; ready for downstream scheduling
+ *     "rejected"    → show rejection display; prompt user to correct
+ *     "not_ready"   → reminder present but incomplete; do not execute
+ *     "not_reminder" → was not a reminder at all; ignore or reroute
+ *
+ * ── "accepted" semantics ──────────────────────────────────────────────────────
+ *
+ *   "accepted" means: structurally valid for downstream scheduling.
+ *   It does NOT mean:  scheduled, delivered, or resolved to a concrete date.
+ *   The artifact is the handoff record. A real scheduler would consume it.
+ *
+ * ── Dependency direction ──────────────────────────────────────────────────────
+ *
+ *   Coordinator imports Present (PresentResult) and Execution.
+ *   Present NEVER imports Execution.
+ *   Execution NEVER imports Coordinator.
+ *   One-way dependencies only.
+ */
+import { buildExecutionRequest, executeReminder } from "./reminder-executor.js";
+// ─── executeFromPresent ───────────────────────────────────────────────────────
+/**
+ * Execute a reminder from an already-produced PresentResult.
+ *
+ * Call this when the user clicks "Confirm" on a reminder presentation.
+ * Returns a ReminderExecuteResult the consumer can render directly.
+ *
+ * @param presentResult  The output of presentFromInput().
+ * @param _now           Epoch ms; defaults to Date.now(). Injectable for tests.
+ */
+export function executeFromPresent(presentResult, _now = Date.now()) {
+    // ── Not a reminder ────────────────────────────────────────────────────────
+    if (presentResult.kind !== "reminder") {
+        return { kind: "not_reminder" };
+    }
+    const presentation = presentResult.presentation;
+    // ── Reminder present but not ready ────────────────────────────────────────
+    const req = buildExecutionRequest(presentation);
+    if (req === null) {
+        return {
+            kind: "not_ready",
+            presentation_state: presentation.state,
+            missing: presentation.missing_fields,
+        };
+    }
+    // ── Execute ───────────────────────────────────────────────────────────────
+    const result = executeReminder(req, _now);
+    const display = formatExecutionDisplay(result.artifact);
+    if (result.ok) {
+        return { kind: "accepted", artifact: result.artifact, display };
+    }
+    return { kind: "rejected", artifact: result.artifact, display, code: result.code };
+}
+// ─── Consumer helpers ─────────────────────────────────────────────────────────
+/**
+ * Returns true if the execution result is "accepted".
+ *
+ * Convenience predicate — consumers use this to enable downstream actions
+ * (e.g. passing the artifact to a real scheduler in Phase 7+).
+ *
+ * Zero authority: this only reads the result, never changes it.
+ */
+export function isExecutionAccepted(result) {
+    return result.kind === "accepted";
+}
+/**
+ * Returns a plain-English note for the consumer to display alongside the result.
+ *
+ * "accepted"     → null (no extra note needed; display.headline is sufficient)
+ * "rejected"     → the rejection note from the display
+ * "not_ready"    → a prompt describing which fields are still missing
+ * "not_reminder" → null
+ */
+export function getExecutionNote(result) {
+    switch (result.kind) {
+        case "accepted":
+            return null;
+        case "rejected":
+            return result.display.rejection_note ?? null;
+        case "not_ready": {
+            const missing = result.missing;
+            if (missing.length === 0)
+                return "This reminder is not yet ready to confirm.";
+            return `Still needed: ${missing.join(", ")}.`;
+        }
+        case "not_reminder":
+            return null;
+    }
+}
+// ─── Internal formatter ───────────────────────────────────────────────────────
+function formatExecutionDisplay(artifact) {
+    const accepted = artifact.verdict === "accepted";
+    return {
+        verdict: artifact.verdict,
+        headline: accepted ? "Reminder accepted" : "Reminder rejected",
+        subject: artifact.subject,
+        time_text: artifact.time_text,
+        ...(accepted
+            ? {}
+            : { rejection_note: artifact.rejection_reason ?? "Could not process this reminder." }),
+    };
+}
+//# sourceMappingURL=reminder-execution-coordinator.js.map

package/dist/src/execution/reminders/reminder-execution-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reminder-execution-coordinator.js","sourceRoot":"","sources":["../../../../src/execution/reminders/reminder-execution-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AAQH,OAAO,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AA4DhF,iFAAiF;AAEjF;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,aAA4B,EAC5B,OAAwB,IAAI,CAAC,GAAG,EAAE;IAElC,6EAA6E;IAC7E,IAAI,aAAa,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACtC,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC;IAClC,CAAC;IAED,MAAM,YAAY,GAAG,aAAa,CAAC,YAAY,CAAC;IAEhD,6EAA6E;IAC7E,MAAM,GAAG,GAAG,qBAAqB,CAAC,YAAY,CAAC,CAAC;IAChD,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;QACjB,OAAO;YACL,IAAI,EAAgB,WAAW;YAC/B,kBAAkB,EAAE,YAAY,CAAC,KAAK;YACtC,OAAO,EAAa,YAAY,CAAC,cAAc;SAChD,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,sBAAsB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAExD,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,CAAC;IAClE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;AACrF,CAAC;AAED,iFAAiF;AAEjF;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAA6B;IAC/D,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC;AACpC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA6B;IAC5D,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,UAAU;YACb,OAAO,IAAI,CAAC;QAEd,KAAK,UAAU;YACb,OAAO,MAAM,CAAC,OAAO,CAAC,cAAc,IAAI,IAAI,CAAC;QAE/C,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC;YAC/B,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,4CAA4C,CAAC;YAC9E,OAAO,iBAAiB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QAChD,CAAC;QAED,KAAK,cAAc;YACjB,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC;AAED,iFAAiF;AAEjF,SAAS,sBAAsB,CAC7B,QAAmC;IAEnC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,KAAK,UAAU,CAAC;IACjD,OAAO;QACL,OAAO,EAAU,QAAQ,CAAC,OAAO;QACjC,QAAQ,EAAS,QAAQ,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,mBAAmB;QACrE,OAAO,EAAU,QAAQ,CAAC,OAAO;QACjC,SAAS,EAAQ,QAAQ,CAAC,SAAS;QACnC,GAAG,CAAC,QAAQ;YACV,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC,EAAE,cAAc,EAAE,QAAQ,CAAC,gBAAgB,IAAI,kCAAkC,EAAE,CAAC;KACzF,CAAC;AACJ,CAAC"}