usesteady 0.1.0-alpha.1

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

@@ -0,0 +1,161 @@
+/**
+ * Reminder Execution Types — Phase 6, Execution Layer.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ * These types represent the execution pipeline for a reminder-shaped request.
+ * They are distinct from the presentation types (Phase 5) and operate at a
+ * different layer of the system.
+ *
+ * ── Layer boundaries ──────────────────────────────────────────────────────────
+ *
+ *   Present Layer (Phase 5) → describes what to show
+ *   Execution Layer (Phase 6) → validates and produces a verified execution record
+ *
+ * The Execution Layer does NOT trust the Present Layer blindly.
+ * It re-validates independently before producing any artifact.
+ *
+ * ── What this layer does NOT do ───────────────────────────────────────────────
+ *
+ *   NOT scheduling     — no OS/calendar scheduling
+ *   NOT persisting     — no reminder storage
+ *   NOT delivering     — no notification sending
+ *   NOT resolving tz   — no timezone handling
+ *   NOT date math      — "tomorrow" stays "tomorrow", never becomes a Date
+ *
+ * ── Artifact is the product ───────────────────────────────────────────────────
+ *
+ *   ReminderExecutionArtifact is what downstream scheduling integrations consume.
+ *   It is the verified, structured record of intent-to-schedule.
+ *   An artifact is always produced — even on rejection — for complete provenance.
+ *
+ * ── Parse-once rule ───────────────────────────────────────────────────────────
+ *
+ *   parseTimeText() is called exactly once inside executeReminder().
+ *   The ParsedTime result is passed into validateExecutionRequest(req, parsedTime).
+ *   This prevents duplicate parsing and drift between validation and artifact.
+ */
+import type { ReminderConfidence } from "../../present/reminders/reminder-types.js";
+/**
+ * Input to the execution layer.
+ *
+ * Built from a ReminderPresentation by buildExecutionRequest().
+ * Only created when presentation.state === "ready_to_confirm".
+ *
+ * source_confidence is preserved from the presentation — it influences
+ * validation and is included in the artifact for provenance.
+ */
+export type ReminderExecutionRequest = {
+    readonly subject: string;
+    readonly time_text: string;
+    readonly recurrence_text: string | null;
+    readonly source_confidence: ReminderConfidence;
+};
+/**
+ * Structured intermediate from parseTimeText().
+ *
+ * ── Determinism contract ─────────────────────────────────────────────────────
+ *
+ *   ParsedTime contains ONLY the structural parse result.
+ *   It does NOT contain resolved timestamps or Date objects.
+ *   "tomorrow" stays "tomorrow" — downstream schedulers resolve relative
+ *   qualifiers against their own time context.
+ *
+ * ── Kinds ────────────────────────────────────────────────────────────────────
+ *
+ *   time_of_day      "at 3pm", "at 09:30 am"
+ *   relative_offset  "in 30 minutes", "in 2 hours"
+ *   day_with_time    "tomorrow at 9am", "next monday at 2pm"
+ *                    day is textual — never normalised to a weekday number or Date
+ *   unresolvable     anything else, or a day qualifier with no time phrase
+ */
+export type ParsedTime = {
+    readonly kind: "time_of_day";
+    readonly hour: number;
+    readonly minute: number;
+    /** "24h" when no am/pm suffix was present. */
+    readonly period: "am" | "pm" | "24h";
+} | {
+    readonly kind: "relative_offset";
+    readonly offset_minutes: number;
+    /** The original phrase for provenance, e.g. "in 30 minutes". */
+    readonly basis: string;
+} | {
+    readonly kind: "day_with_time";
+    /**
+     * Textual day qualifier as it appeared in the input, lowercased.
+     * Examples: "tomorrow", "today", "next monday", "next friday".
+     * Never normalised to a date or weekday number.
+     */
+    readonly day: string;
+    readonly hour: number;
+    readonly minute: number;
+    readonly period: "am" | "pm" | "24h";
+} | {
+    readonly kind: "unresolvable";
+    /** Human-readable reason why the time could not be parsed. */
+    readonly reason: string;
+};
+/**
+ * The four rejection codes for this slice.
+ *
+ * presentation_incomplete is intentionally absent:
+ *   buildExecutionRequest() returns null for incomplete presentations,
+ *   so executeReminder() is never called with one.
+ */
+export type ExecutionRejectionCode = "subject_empty" | "subject_unsafe" | "time_unresolvable" | "confidence_too_low";
+export type ExecutionValidation = {
+    readonly valid: true;
+} | {
+    readonly valid: false;
+    readonly reason: string;
+    readonly code: ExecutionRejectionCode;
+};
+/**
+ * ReminderExecutionArtifact — the verified, structured record of intent-to-schedule.
+ *
+ * ── What it is ───────────────────────────────────────────────────────────────
+ *
+ *   The product of the execution layer. Downstream schedulers consume this
+ *   to actually create a reminder. The execution layer itself does not schedule.
+ *
+ * ── Always produced ──────────────────────────────────────────────────────────
+ *
+ *   An artifact is produced even on rejection. This gives callers a complete
+ *   provenance record regardless of outcome.
+ *
+ * ── Field contracts ──────────────────────────────────────────────────────────
+ *
+ *   time_text         — the original phrase from the request (preserved for mapper)
+ *   parsed_time       — the full structural parse result (for downstream schedulers)
+ *   source_confidence — from the presentation; part of why accepted/rejected
+ *   rejection_reason  — present when verdict === "rejected"; for unresolvable time,
+ *                       this carries ParsedTime.reason for full context
+ *   produced_at_ts    — epoch ms; injectable via _now parameter for deterministic tests
+ */
+export type ReminderExecutionArtifact = {
+    readonly kind: "reminder_execution";
+    readonly subject: string;
+    readonly time_text: string;
+    readonly parsed_time: ParsedTime;
+    readonly recurrence_text: string | null;
+    readonly source_confidence: ReminderConfidence;
+    readonly verdict: "accepted" | "rejected";
+    readonly rejection_reason?: string;
+    readonly produced_at_ts: number;
+};
+/**
+ * ReminderExecutionResult — the discriminated result of executeReminder().
+ *
+ * Both arms carry the artifact for complete provenance.
+ */
+export type ReminderExecutionResult = {
+    readonly ok: true;
+    readonly artifact: ReminderExecutionArtifact;
+} | {
+    readonly ok: false;
+    readonly reason: string;
+    readonly code: ExecutionRejectionCode;
+    readonly artifact: ReminderExecutionArtifact;
+};
+//# sourceMappingURL=reminder-execution-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reminder-execution-types.d.ts","sourceRoot":"","sources":["../../../../src/execution/reminders/reminder-execution-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAIpF;;;;;;;;GAQG;AACH,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,OAAO,EAAY,MAAM,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAU,MAAM,CAAC;IACnC,QAAQ,CAAC,eAAe,EAAI,MAAM,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,EAAE,kBAAkB,CAAC;CAChD,CAAC;AAIF;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,UAAU,GAClB;IACE,QAAQ,CAAC,IAAI,EAAK,aAAa,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAK,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAG,MAAM,CAAC;IACzB,8CAA8C;IAC9C,QAAQ,CAAC,MAAM,EAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;CACvC,GACD;IACE,QAAQ,CAAC,IAAI,EAAa,iBAAiB,CAAC;IAC5C,QAAQ,CAAC,cAAc,EAAG,MAAM,CAAC;IACjC,gEAAgE;IAChE,QAAQ,CAAC,KAAK,EAAY,MAAM,CAAC;CAClC,GACD;IACE,QAAQ,CAAC,IAAI,EAAK,eAAe,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,GAAG,EAAM,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAK,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAG,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;CACvC,GACD;IACE,QAAQ,CAAC,IAAI,EAAK,cAAc,CAAC;IACjC,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,EAAG,MAAM,CAAC;CAC1B,CAAC;AAIN;;;;;;GAMG;AACH,MAAM,MAAM,sBAAsB,GAC9B,eAAe,GACf,gBAAgB,GAChB,mBAAmB,GACnB,oBAAoB,CAAC;AAEzB,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAA;CAAE,GACxB;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAA;CAAE,CAAC;AAI9F;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,IAAI,EAAgB,oBAAoB,CAAC;IAClD,QAAQ,CAAC,OAAO,EAAa,MAAM,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAW,MAAM,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAS,UAAU,CAAC;IACxC,QAAQ,CAAC,eAAe,EAAK,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,iBAAiB,EAAG,kBAAkB,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAa,UAAU,GAAG,UAAU,CAAC;IACrD,QAAQ,CAAC,gBAAgB,CAAC,EAAG,MAAM,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAM,MAAM,CAAC;CACrC,CAAC;AAIF;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,GAC/B;IACE,QAAQ,CAAC,EAAE,EAAQ,IAAI,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;CAC9C,GACD;IACE,QAAQ,CAAC,EAAE,EAAQ,KAAK,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAI,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAM,sBAAsB,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,yBAAyB,CAAC;CAC9C,CAAC"}

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

@@ -0,0 +1,39 @@
+/**
+ * Reminder Execution Types — Phase 6, Execution Layer.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ * These types represent the execution pipeline for a reminder-shaped request.
+ * They are distinct from the presentation types (Phase 5) and operate at a
+ * different layer of the system.
+ *
+ * ── Layer boundaries ──────────────────────────────────────────────────────────
+ *
+ *   Present Layer (Phase 5) → describes what to show
+ *   Execution Layer (Phase 6) → validates and produces a verified execution record
+ *
+ * The Execution Layer does NOT trust the Present Layer blindly.
+ * It re-validates independently before producing any artifact.
+ *
+ * ── What this layer does NOT do ───────────────────────────────────────────────
+ *
+ *   NOT scheduling     — no OS/calendar scheduling
+ *   NOT persisting     — no reminder storage
+ *   NOT delivering     — no notification sending
+ *   NOT resolving tz   — no timezone handling
+ *   NOT date math      — "tomorrow" stays "tomorrow", never becomes a Date
+ *
+ * ── Artifact is the product ───────────────────────────────────────────────────
+ *
+ *   ReminderExecutionArtifact is what downstream scheduling integrations consume.
+ *   It is the verified, structured record of intent-to-schedule.
+ *   An artifact is always produced — even on rejection — for complete provenance.
+ *
+ * ── Parse-once rule ───────────────────────────────────────────────────────────
+ *
+ *   parseTimeText() is called exactly once inside executeReminder().
+ *   The ParsedTime result is passed into validateExecutionRequest(req, parsedTime).
+ *   This prevents duplicate parsing and drift between validation and artifact.
+ */
+export {};
+//# sourceMappingURL=reminder-execution-types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reminder-execution-types.js","sourceRoot":"","sources":["../../../../src/execution/reminders/reminder-execution-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG"}

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

@@ -0,0 +1,45 @@
+/**
+ * Reminder execution validator — Phase 6, Execution Layer.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ * Re-validates a ReminderExecutionRequest independently of the presentation.
+ * A ready_to_confirm presentation does NOT equal "safe to execute."
+ * Every execution request must pass validation before an artifact is produced.
+ *
+ * ── Parse-once contract ───────────────────────────────────────────────────────
+ *
+ * validateExecutionRequest(req, parsedTime) accepts the already-parsed ParsedTime.
+ * Callers (executeReminder) parse once and pass the result here.
+ * This prevents duplicate parsing and drift between validation and artifact.
+ *
+ * ── subject_unsafe scope ─────────────────────────────────────────────────────
+ *
+ * The unsafe pattern is intentionally narrow: only obvious destructive/system
+ * vocabulary that cannot appear in legitimate reminder subjects.
+ *
+ * It does NOT match broad "scary" language — words like "cancel", "delete",
+ * "remove", or "clear" appear legitimately in reminders:
+ *   "remind me to cancel the meeting"
+ *   "remind me to delete the temp files"
+ *
+ * Only multi-word or highly unambiguous destructive patterns are blocked.
+ * This mirrors the vocabulary of the existing safety gate, not intent inference.
+ */
+import type { ReminderExecutionRequest, ExecutionValidation, ParsedTime } from "./reminder-execution-types.js";
+/**
+ * Validate a ReminderExecutionRequest against the already-parsed ParsedTime.
+ *
+ * Returns { valid: true } or { valid: false, reason, code }.
+ *
+ * Checks in order:
+ *   1. subject_empty      — blank or whitespace-only subject
+ *   2. subject_unsafe     — subject matches narrow destructive pattern list
+ *   3. confidence_too_low — source_confidence === "ambiguous"
+ *   4. time_unresolvable  — parsedTime.kind === "unresolvable"
+ *
+ * @param req        The execution request.
+ * @param parsedTime The result of parseTimeText(req.time_text), parsed once by caller.
+ */
+export declare function validateExecutionRequest(req: ReminderExecutionRequest, parsedTime: ParsedTime): ExecutionValidation;
+//# sourceMappingURL=reminder-execution-validator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reminder-execution-validator.d.ts","sourceRoot":"","sources":["../../../../src/execution/reminders/reminder-execution-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EACV,wBAAwB,EACxB,mBAAmB,EACnB,UAAU,EACX,MAAM,+BAA+B,CAAC;AAoBvC;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAS,wBAAwB,EACpC,UAAU,EAAE,UAAU,GACrB,mBAAmB,CAsCrB"}

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

@@ -0,0 +1,92 @@
+/**
+ * Reminder execution validator — Phase 6, Execution Layer.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ * Re-validates a ReminderExecutionRequest independently of the presentation.
+ * A ready_to_confirm presentation does NOT equal "safe to execute."
+ * Every execution request must pass validation before an artifact is produced.
+ *
+ * ── Parse-once contract ───────────────────────────────────────────────────────
+ *
+ * validateExecutionRequest(req, parsedTime) accepts the already-parsed ParsedTime.
+ * Callers (executeReminder) parse once and pass the result here.
+ * This prevents duplicate parsing and drift between validation and artifact.
+ *
+ * ── subject_unsafe scope ─────────────────────────────────────────────────────
+ *
+ * The unsafe pattern is intentionally narrow: only obvious destructive/system
+ * vocabulary that cannot appear in legitimate reminder subjects.
+ *
+ * It does NOT match broad "scary" language — words like "cancel", "delete",
+ * "remove", or "clear" appear legitimately in reminders:
+ *   "remind me to cancel the meeting"
+ *   "remind me to delete the temp files"
+ *
+ * Only multi-word or highly unambiguous destructive patterns are blocked.
+ * This mirrors the vocabulary of the existing safety gate, not intent inference.
+ */
+// ─── Patterns ─────────────────────────────────────────────────────────────────
+/**
+ * Narrow list of destructive patterns that should not appear in reminder subjects.
+ * Same vocabulary style as the safety gate — no broad "scary language" matching.
+ *
+ * Examples that ARE blocked:
+ *   "rm -rf everything", "delete all files", "wipe the database",
+ *   "purge all records", "drop table users"
+ *
+ * Examples that are NOT blocked (legitimate reminder text):
+ *   "cancel the meeting", "delete temp files", "clear the whiteboard"
+ */
+const UNSAFE_SUBJECT_RE = /\b(?:rm\s+-rf|delete\s+all|wipe\b|purge\s+all|drop\s+table|format\s+(?:disk|drive|c:|\/dev))\b/i;
+// ─── Public API ───────────────────────────────────────────────────────────────
+/**
+ * Validate a ReminderExecutionRequest against the already-parsed ParsedTime.
+ *
+ * Returns { valid: true } or { valid: false, reason, code }.
+ *
+ * Checks in order:
+ *   1. subject_empty      — blank or whitespace-only subject
+ *   2. subject_unsafe     — subject matches narrow destructive pattern list
+ *   3. confidence_too_low — source_confidence === "ambiguous"
+ *   4. time_unresolvable  — parsedTime.kind === "unresolvable"
+ *
+ * @param req        The execution request.
+ * @param parsedTime The result of parseTimeText(req.time_text), parsed once by caller.
+ */
+export function validateExecutionRequest(req, parsedTime) {
+    // 1. Subject must not be empty or whitespace
+    if (!req.subject || req.subject.trim().length === 0) {
+        return {
+            valid: false,
+            reason: "subject is empty or whitespace",
+            code: "subject_empty",
+        };
+    }
+    // 2. Subject must not contain obvious destructive patterns
+    if (UNSAFE_SUBJECT_RE.test(req.subject)) {
+        return {
+            valid: false,
+            reason: "subject contains unsafe content",
+            code: "subject_unsafe",
+        };
+    }
+    // 3. Confidence must not be ambiguous
+    if (req.source_confidence === "ambiguous") {
+        return {
+            valid: false,
+            reason: "source confidence is ambiguous — cannot execute safely",
+            code: "confidence_too_low",
+        };
+    }
+    // 4. Time must have been parseable
+    if (parsedTime.kind === "unresolvable") {
+        return {
+            valid: false,
+            reason: `time_text could not be resolved: ${parsedTime.reason}`,
+            code: "time_unresolvable",
+        };
+    }
+    return { valid: true };
+}
+//# sourceMappingURL=reminder-execution-validator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reminder-execution-validator.js","sourceRoot":"","sources":["../../../../src/execution/reminders/reminder-execution-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAQH,iFAAiF;AAEjF;;;;;;;;;;GAUG;AACH,MAAM,iBAAiB,GACrB,iGAAiG,CAAC;AAEpG,iFAAiF;AAEjF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,wBAAwB,CACtC,GAAoC,EACpC,UAAsB;IAEtB,6CAA6C;IAC7C,IAAI,CAAC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO;YACL,KAAK,EAAG,KAAK;YACb,MAAM,EAAE,gCAAgC;YACxC,IAAI,EAAI,eAAe;SACxB,CAAC;IACJ,CAAC;IAED,2DAA2D;IAC3D,IAAI,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QACxC,OAAO;YACL,KAAK,EAAG,KAAK;YACb,MAAM,EAAE,iCAAiC;YACzC,IAAI,EAAI,gBAAgB;SACzB,CAAC;IACJ,CAAC;IAED,sCAAsC;IACtC,IAAI,GAAG,CAAC,iBAAiB,KAAK,WAAW,EAAE,CAAC;QAC1C,OAAO;YACL,KAAK,EAAG,KAAK;YACb,MAAM,EAAE,wDAAwD;YAChE,IAAI,EAAI,oBAAoB;SAC7B,CAAC;IACJ,CAAC;IAED,mCAAmC;IACnC,IAAI,UAAU,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QACvC,OAAO;YACL,KAAK,EAAG,KAAK;YACb,MAAM,EAAE,oCAAoC,UAAU,CAAC,MAAM,EAAE;YAC/D,IAAI,EAAI,mBAAmB;SAC5B,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AACzB,CAAC"}

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

@@ -0,0 +1,62 @@
+/**
+ * Reminder executor — Phase 6, Execution Layer.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ * Orchestrates the execution pipeline for a reminder-shaped request:
+ *   buildExecutionRequest  — one-way Present→Execution adapter
+ *   executeReminder        — parses, validates, produces artifact
+ *
+ * ── Dependency direction ──────────────────────────────────────────────────────
+ *
+ * Execution imports from Present (ReminderPresentation type).
+ * Present NEVER imports from Execution.
+ * This is a one-way dependency — the Present Layer remains zero-authority.
+ *
+ * ── Artifact contract ─────────────────────────────────────────────────────────
+ *
+ * An artifact is always produced — even when validation fails.
+ * This gives callers a complete, inspectable provenance record.
+ * Downstream schedulers only consume artifacts where verdict === "accepted".
+ *
+ * ── Parse-once contract ───────────────────────────────────────────────────────
+ *
+ * parseTimeText is called exactly once inside executeReminder.
+ * The ParsedTime result is passed to validateExecutionRequest(req, parsedTime).
+ * No duplicate parsing. No drift between validation and artifact construction.
+ */
+import type { ReminderPresentation } from "../../present/reminders/reminder-types.js";
+import type { ReminderExecutionRequest, ReminderExecutionResult } from "./reminder-execution-types.js";
+/**
+ * One-way adapter: ReminderPresentation → ReminderExecutionRequest | null.
+ *
+ * Returns null when the presentation is not ready to execute:
+ *   - state !== "ready_to_confirm"
+ *   - subject or time_text are missing (null)
+ *
+ * This is the gating function that prevents executeReminder from ever
+ * receiving an incomplete or ambiguous presentation.
+ *
+ * Note: null here does NOT mean "reject with an artifact". It means the
+ * presentation has not reached the execution layer yet — the consumer should
+ * prompt the user for the missing field(s) instead.
+ *
+ * @param presentation  A ReminderPresentation from presentFromInput().
+ */
+export declare function buildExecutionRequest(presentation: ReminderPresentation): ReminderExecutionRequest | null;
+/**
+ * Execute a validated reminder request.
+ *
+ * Produces a ReminderExecutionArtifact — the verified, structured record
+ * of intent-to-schedule. Does NOT schedule, persist, or notify.
+ *
+ * Pipeline:
+ *   1. parseTimeText(req.time_text)               → ParsedTime (once)
+ *   2. validateExecutionRequest(req, parsedTime)  → ExecutionValidation
+ *   3. Build artifact (accepted or rejected)
+ *
+ * @param req   The execution request (from buildExecutionRequest).
+ * @param _now  Epoch ms timestamp; defaults to Date.now(). Injectable for tests.
+ */
+export declare function executeReminder(req: ReminderExecutionRequest, _now?: number): ReminderExecutionResult;
+//# sourceMappingURL=reminder-executor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reminder-executor.d.ts","sourceRoot":"","sources":["../../../../src/execution/reminders/reminder-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACtF,OAAO,KAAK,EACV,wBAAwB,EAExB,uBAAuB,EACxB,MAAM,+BAA+B,CAAC;AAMvC;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,oBAAoB,GACjC,wBAAwB,GAAG,IAAI,CAWjC;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAI,wBAAwB,EAC/B,IAAI,GAAG,MAAmB,GACzB,uBAAuB,CAyCzB"}

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

@@ -0,0 +1,113 @@
+/**
+ * Reminder executor — Phase 6, Execution Layer.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ * Orchestrates the execution pipeline for a reminder-shaped request:
+ *   buildExecutionRequest  — one-way Present→Execution adapter
+ *   executeReminder        — parses, validates, produces artifact
+ *
+ * ── Dependency direction ──────────────────────────────────────────────────────
+ *
+ * Execution imports from Present (ReminderPresentation type).
+ * Present NEVER imports from Execution.
+ * This is a one-way dependency — the Present Layer remains zero-authority.
+ *
+ * ── Artifact contract ─────────────────────────────────────────────────────────
+ *
+ * An artifact is always produced — even when validation fails.
+ * This gives callers a complete, inspectable provenance record.
+ * Downstream schedulers only consume artifacts where verdict === "accepted".
+ *
+ * ── Parse-once contract ───────────────────────────────────────────────────────
+ *
+ * parseTimeText is called exactly once inside executeReminder.
+ * The ParsedTime result is passed to validateExecutionRequest(req, parsedTime).
+ * No duplicate parsing. No drift between validation and artifact construction.
+ */
+import { parseTimeText } from "./reminder-time-parser.js";
+import { validateExecutionRequest } from "./reminder-execution-validator.js";
+// ─── buildExecutionRequest ────────────────────────────────────────────────────
+/**
+ * One-way adapter: ReminderPresentation → ReminderExecutionRequest | null.
+ *
+ * Returns null when the presentation is not ready to execute:
+ *   - state !== "ready_to_confirm"
+ *   - subject or time_text are missing (null)
+ *
+ * This is the gating function that prevents executeReminder from ever
+ * receiving an incomplete or ambiguous presentation.
+ *
+ * Note: null here does NOT mean "reject with an artifact". It means the
+ * presentation has not reached the execution layer yet — the consumer should
+ * prompt the user for the missing field(s) instead.
+ *
+ * @param presentation  A ReminderPresentation from presentFromInput().
+ */
+export function buildExecutionRequest(presentation) {
+    if (presentation.state !== "ready_to_confirm")
+        return null;
+    if (presentation.subject === null)
+        return null;
+    if (presentation.time_text === null)
+        return null;
+    return {
+        subject: presentation.subject,
+        time_text: presentation.time_text,
+        recurrence_text: presentation.recurrence_text,
+        source_confidence: presentation.confidence,
+    };
+}
+// ─── executeReminder ──────────────────────────────────────────────────────────
+/**
+ * Execute a validated reminder request.
+ *
+ * Produces a ReminderExecutionArtifact — the verified, structured record
+ * of intent-to-schedule. Does NOT schedule, persist, or notify.
+ *
+ * Pipeline:
+ *   1. parseTimeText(req.time_text)               → ParsedTime (once)
+ *   2. validateExecutionRequest(req, parsedTime)  → ExecutionValidation
+ *   3. Build artifact (accepted or rejected)
+ *
+ * @param req   The execution request (from buildExecutionRequest).
+ * @param _now  Epoch ms timestamp; defaults to Date.now(). Injectable for tests.
+ */
+export function executeReminder(req, _now = Date.now()) {
+    // ── Parse once ────────────────────────────────────────────────────────────
+    const parsedTime = parseTimeText(req.time_text);
+    // ── Validate ──────────────────────────────────────────────────────────────
+    const validation = validateExecutionRequest(req, parsedTime);
+    // ── Build artifact ────────────────────────────────────────────────────────
+    if (!validation.valid) {
+        // For time_unresolvable, the ParsedTime.reason is the most specific
+        // explanation — carry it forward in rejection_reason.
+        const rejection_reason = validation.code === "time_unresolvable" && parsedTime.kind === "unresolvable"
+            ? `${validation.reason} (parse detail: ${parsedTime.reason})`
+            : validation.reason;
+        const artifact = {
+            kind: "reminder_execution",
+            subject: req.subject,
+            time_text: req.time_text,
+            parsed_time: parsedTime,
+            recurrence_text: req.recurrence_text,
+            source_confidence: req.source_confidence,
+            verdict: "rejected",
+            rejection_reason,
+            produced_at_ts: _now,
+        };
+        return { ok: false, reason: validation.reason, code: validation.code, artifact };
+    }
+    const artifact = {
+        kind: "reminder_execution",
+        subject: req.subject,
+        time_text: req.time_text,
+        parsed_time: parsedTime,
+        recurrence_text: req.recurrence_text,
+        source_confidence: req.source_confidence,
+        verdict: "accepted",
+        produced_at_ts: _now,
+    };
+    return { ok: true, artifact };
+}
+//# sourceMappingURL=reminder-executor.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reminder-executor.js","sourceRoot":"","sources":["../../../../src/execution/reminders/reminder-executor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAQH,OAAO,EAAE,aAAa,EAAE,MAAkB,2BAA2B,CAAC;AACtE,OAAO,EAAE,wBAAwB,EAAE,MAAO,mCAAmC,CAAC;AAE9E,iFAAiF;AAEjF;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,qBAAqB,CACnC,YAAkC;IAElC,IAAI,YAAY,CAAC,KAAK,KAAK,kBAAkB;QAAE,OAAO,IAAI,CAAC;IAC3D,IAAI,YAAY,CAAC,OAAO,KAAK,IAAI;QAAc,OAAO,IAAI,CAAC;IAC3D,IAAI,YAAY,CAAC,SAAS,KAAK,IAAI;QAAY,OAAO,IAAI,CAAC;IAE3D,OAAO;QACL,OAAO,EAAY,YAAY,CAAC,OAAO;QACvC,SAAS,EAAU,YAAY,CAAC,SAAS;QACzC,eAAe,EAAI,YAAY,CAAC,eAAe;QAC/C,iBAAiB,EAAE,YAAY,CAAC,UAAU;KAC3C,CAAC;AACJ,CAAC;AAED,iFAAiF;AAEjF;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAC7B,GAA+B,EAC/B,OAAgB,IAAI,CAAC,GAAG,EAAE;IAE1B,6EAA6E;IAC7E,MAAM,UAAU,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAEhD,6EAA6E;IAC7E,MAAM,UAAU,GAAG,wBAAwB,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAE7D,6EAA6E;IAC7E,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;QACtB,oEAAoE;QACpE,sDAAsD;QACtD,MAAM,gBAAgB,GACpB,UAAU,CAAC,IAAI,KAAK,mBAAmB,IAAI,UAAU,CAAC,IAAI,KAAK,cAAc;YAC3E,CAAC,CAAC,GAAG,UAAU,CAAC,MAAM,mBAAmB,UAAU,CAAC,MAAM,GAAG;YAC7D,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC;QAExB,MAAM,QAAQ,GAA8B;YAC1C,IAAI,EAAgB,oBAAoB;YACxC,OAAO,EAAa,GAAG,CAAC,OAAO;YAC/B,SAAS,EAAW,GAAG,CAAC,SAAS;YACjC,WAAW,EAAS,UAAU;YAC9B,eAAe,EAAK,GAAG,CAAC,eAAe;YACvC,iBAAiB,EAAG,GAAG,CAAC,iBAAiB;YACzC,OAAO,EAAa,UAAU;YAC9B,gBAAgB;YAChB,cAAc,EAAM,IAAI;SACzB,CAAC;QACF,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,QAAQ,EAAE,CAAC;IACnF,CAAC;IAED,MAAM,QAAQ,GAA8B;QAC1C,IAAI,EAAe,oBAAoB;QACvC,OAAO,EAAY,GAAG,CAAC,OAAO;QAC9B,SAAS,EAAU,GAAG,CAAC,SAAS;QAChC,WAAW,EAAQ,UAAU;QAC7B,eAAe,EAAI,GAAG,CAAC,eAAe;QACtC,iBAAiB,EAAE,GAAG,CAAC,iBAAiB;QACxC,OAAO,EAAY,UAAU;QAC7B,cAAc,EAAK,IAAI;KACxB,CAAC;IACF,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;AAChC,CAAC"}

package/dist/src/execution/reminders/reminder-time-parser.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Reminder time parser — Phase 6, Execution Layer.
+ *
+ * ── Purpose ───────────────────────────────────────────────────────────────────
+ *
+ * Converts a time_text phrase into a structured ParsedTime.
+ * Conservative, regex-only, fully deterministic.
+ *
+ * ── What it does NOT do ───────────────────────────────────────────────────────
+ *
+ *   Does NOT produce Date objects or resolved timestamps.
+ *   Does NOT assume a default time for day-only phrases.
+ *   Does NOT handle timezones.
+ *   Does NOT do fuzzy matching or ML-based inference.
+ *
+ * ── Pattern priority (first match wins) ──────────────────────────────────────
+ *
+ *   1. relative_offset  — "in N minutes" / "in N hours"
+ *   2. day_with_time    — day qualifier + explicit time phrase
+ *   3. time_of_day      — explicit time with no day qualifier
+ *   4. unresolvable     — anything else (including day qualifier without time)
+ *
+ * ── Day qualifier without time → unresolvable ────────────────────────────────
+ *
+ *   "remind me tomorrow" has no time → unresolvable.
+ *   The execution layer does not guess a default time.
+ *   The caller must surface the missing time to the user.
+ */
+import type { ParsedTime } from "./reminder-execution-types.js";
+/**
+ * Parse a time_text phrase into a structured ParsedTime.
+ *
+ * Pure function — same input always produces the same output.
+ * Called once inside executeReminder(); the result is passed to
+ * validateExecutionRequest(req, parsedTime) to avoid duplicate parsing.
+ *
+ * @param time_text  The time phrase extracted by the Present Layer, e.g.
+ *                   "tomorrow at 9am", "in 30 minutes", "at 3pm".
+ */
+export declare function parseTimeText(time_text: string): ParsedTime;
+//# sourceMappingURL=reminder-time-parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reminder-time-parser.d.ts","sourceRoot":"","sources":["../../../../src/execution/reminders/reminder-time-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AA0ChE;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CA6D3D"}