usesteady 0.1.0-alpha.1

package/dist/src/present/reminders/reminder-presenter.js

@@ -0,0 +1,359 @@
+/**
+ * Reminder Presenter — Phase 5, Present Layer.
+ *
+ * ── Responsibility ────────────────────────────────────────────────────────────
+ *
+ * Takes raw input text and produces a ReminderPresentation, or null if the
+ * input does not contain sufficient reminder signal.
+ *
+ * ── What this is NOT ─────────────────────────────────────────────────────────
+ *
+ *   NOT a new interpreter       — does not enter the intake pipeline
+ *   NOT an intake pipeline step — does not affect mode, signal, or intentState
+ *   NOT an execution layer      — does not schedule, store, or trigger anything
+ *   NOT a UCP participant       — produces no envelopes
+ *
+ * ── Architecture position ────────────────────────────────────────────────────
+ *
+ *   Raw input → extractReminderCandidate() → ReminderCandidate | null
+ *                                                      ↓
+ *                                            presentReminder() → ReminderPresentation | null
+ *
+ * presentReminder() is the sole public entry point.
+ * extractReminderCandidate() is exported for testing; internal to this module.
+ *
+ * ── Extraction philosophy ────────────────────────────────────────────────────
+ *
+ *   Conservative: extract only what is EXPLICITLY present.
+ *   If a field cannot be cleanly extracted, it becomes null.
+ *   Null is never defaulted, assumed, or guessed.
+ *   This is a hard contract — the Present Layer does not invent missing facts.
+ *
+ * ── No interpreter changes ───────────────────────────────────────────────────
+ *
+ *   This module does not modify the interpreter registry.
+ *   It does not affect guided_recovery, incomplete, or any pipeline decision.
+ *   Reminder extraction is purely a PRESENTATION-LAYER concern.
+ */
+// ─────────────────────────────────────────────────────────────────────────────
+// Detection — must match before any extraction is attempted
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * A reminder signal MUST be present before extraction.
+ * If this does not match, presentReminder() returns null immediately.
+ *
+ * Recognised signals (case-insensitive):
+ *   "remind me"           — most common
+ *   "set a reminder"      — explicit creation verb
+ *   "create a reminder"   — explicit creation verb
+ *   "add a reminder"      — explicit creation verb
+ *
+ * Deliberately excluded:
+ *   "don't forget"        — too broad; could be a note or instruction
+ *   "make sure I"         — too broad; could be many things
+ *   "I should remember"   — too indirect
+ */
+const REMINDER_SIGNAL_RE = /\b(remind\s+me|set\s+(?:a\s+)?reminder|create\s+(?:a\s+)?reminder|add\s+(?:a\s+)?reminder)\b/i;
+// ─────────────────────────────────────────────────────────────────────────────
+// Time extraction — ordered from most specific to least specific
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Time patterns, evaluated in priority order.
+ * Only the FIRST match is used. More specific patterns come first.
+ *
+ * What we extract: the entire time phrase as it appears in the input.
+ * What we do NOT do: normalise to a timestamp, guess timezone, or assume date.
+ *
+ * Examples:
+ *   "tomorrow morning at 9am"  → "tomorrow morning at 9am"
+ *   "tomorrow at 9"            → "tomorrow at 9"
+ *   "tomorrow morning"         → "tomorrow morning"
+ *   "tomorrow"                 → "tomorrow"
+ *   "at 3pm"                   → "at 3pm"
+ *   "in 30 minutes"            → "in 30 minutes"
+ *   "next Monday"              → "next Monday"
+ *   "on Friday"                → "on Friday"
+ *   "this morning"             → "this morning"
+ */
+const TIME_PATTERNS = [
+    // "tomorrow morning/afternoon/evening at HH:MM am/pm" (most specific)
+    /\btomorrow\s+(?:morning|afternoon|evening)\s+at\s+\d{1,2}(?::\d{2})?\s*(?:am|pm)?\b/i,
+    // "tomorrow at HH:MM am/pm"
+    /\btomorrow\s+at\s+\d{1,2}(?::\d{2})?\s*(?:am|pm)?\b/i,
+    // "tomorrow morning/afternoon/evening"
+    /\btomorrow\s+(?:morning|afternoon|evening)\b/i,
+    // "tomorrow" alone
+    /\btomorrow\b/i,
+    // "today morning/afternoon/evening at HH:MM am/pm"
+    /\btoday\s+(?:morning|afternoon|evening)\s+at\s+\d{1,2}(?::\d{2})?\s*(?:am|pm)?\b/i,
+    // "today at HH:MM am/pm"
+    /\btoday\s+at\s+\d{1,2}(?::\d{2})?\s*(?:am|pm)?\b/i,
+    // "today" alone
+    /\btoday\b/i,
+    // "at HH:MM am/pm" or "at HH am/pm"
+    /\bat\s+\d{1,2}(?::\d{2})?\s*(?:am|pm)?\b/i,
+    // "in N minutes/hours/days"
+    /\bin\s+\d+\s+(?:minutes?|hours?|days?)\b/i,
+    // "next Monday/Tuesday/.../week/month"
+    /\bnext\s+(?:monday|tuesday|wednesday|thursday|friday|saturday|sunday|week|month)\b/i,
+    // "on Monday/Tuesday/..."
+    /\bon\s+(?:monday|tuesday|wednesday|thursday|friday|saturday|sunday)\b/i,
+    // "this morning/afternoon/evening/weekend"
+    /\bthis\s+(?:morning|afternoon|evening|weekend)\b/i,
+];
+/**
+ * Extract the first matching time phrase from the input.
+ * Returns the phrase exactly as it appears in the input.
+ * Returns null if no time phrase is found.
+ */
+function extractTime(input) {
+    for (const pattern of TIME_PATTERNS) {
+        const match = pattern.exec(input);
+        if (match)
+            return match[0];
+    }
+    return null;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Recurrence extraction
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Extract an explicit recurrence phrase if present.
+ * Returns the phrase exactly as it appears in the input.
+ * Returns null if no recurrence phrase is found.
+ *
+ * Only "every [X]" patterns are considered recurrence.
+ * "daily", "weekly" without "every" are not extracted (too ambiguous without context).
+ */
+const RECURRENCE_RE = /\b(every\s+(?:day|morning|evening|hour|week|month|monday|tuesday|wednesday|thursday|friday|saturday|sunday|\d+\s+(?:hours?|days?|weeks?|minutes?)))\b/i;
+function extractRecurrence(input) {
+    const match = RECURRENCE_RE.exec(input);
+    return match ? match[0] : null;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Subject extraction
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * The time boundary regex.
+ * Used to clip the subject string at the point where time/recurrence begins.
+ * This ensures subject and time do not bleed into each other.
+ */
+const TIME_BOUNDARY_RE = /\s+(?:at\s+\d|tomorrow\b|today\b|in\s+\d|next\s+|on\s+(?:monday|tuesday|wednesday|thursday|friday|saturday|sunday)\b|every\s+|this\s+(?:morning|afternoon|evening|weekend))|[,.]/i;
+/**
+ * Subject extraction patterns — in priority order.
+ *
+ * Pattern 1: "remind me to [X]"
+ * Pattern 2: "remind me about [X]"
+ * Pattern 3: "(set|create|add) a reminder (to|for) [X]"
+ *
+ * The subject is the text between the signal and the first time/recurrence marker.
+ *
+ * "remind me" alone (with no following clause) → null (ambiguous, state = "ambiguous")
+ */
+const SUBJECT_PATTERNS = [
+    // "remind me to [X]"
+    /\bremind\s+me\s+to\s+(.+)/i,
+    // "remind me about [X]"
+    /\bremind\s+me\s+about\s+(.+)/i,
+    // "set/create/add a reminder to/for [X]"
+    /\b(?:set|create|add)\s+(?:a\s+)?reminder\s+(?:to|for)\s+(.+)/i,
+];
+/**
+ * Extract the subject from the input, given an already-extracted time_text.
+ *
+ * Strategy:
+ *   1. Find the subject candidate text using the SUBJECT_PATTERNS.
+ *   2. If time_text is known, clip the candidate just before time_text appears.
+ *   3. Otherwise, clip at the first time boundary marker.
+ *   4. Return the cleaned subject, or null if it's empty after clipping.
+ *
+ * This guarantees the subject never contains time information.
+ */
+function extractSubject(input, time_text) {
+    let candidate = null;
+    for (const pattern of SUBJECT_PATTERNS) {
+        const match = pattern.exec(input);
+        if (match) {
+            candidate = match[1] ?? null;
+            break;
+        }
+    }
+    if (!candidate)
+        return null;
+    // Clip at the known time_text position (exact substring match)
+    if (time_text) {
+        const idx = candidate.toLowerCase().indexOf(time_text.toLowerCase());
+        if (idx === 0) {
+            // time_text starts at the very beginning of the candidate —
+            // the entire candidate is time, not subject (e.g. "for tomorrow morning")
+            candidate = "";
+        }
+        else if (idx > 0) {
+            candidate = candidate.slice(0, idx);
+        }
+        else {
+            // time_text not literally in candidate — clip at any time boundary
+            const boundaryMatch = TIME_BOUNDARY_RE.exec(candidate);
+            if (boundaryMatch) {
+                candidate = candidate.slice(0, boundaryMatch.index);
+            }
+        }
+    }
+    else {
+        // No time_text known — clip at any time boundary in the candidate
+        const boundaryMatch = TIME_BOUNDARY_RE.exec(candidate);
+        if (boundaryMatch) {
+            candidate = candidate.slice(0, boundaryMatch.index);
+        }
+    }
+    const trimmed = candidate.trim();
+    return trimmed.length > 0 ? trimmed : null;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Candidate assembly
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Extract all reminder candidate fields from the raw input.
+ *
+ * Returns null if no reminder signal is found.
+ * Returns a ReminderCandidate with null fields where extraction failed.
+ *
+ * The confidence level reflects what was successfully extracted:
+ *   explicit   = subject AND time present
+ *   partial    = exactly one of subject/time present
+ *   ambiguous  = signal matched but neither subject nor time found
+ *
+ * Exported for testing. Not part of the public barrel API.
+ */
+export function extractReminderCandidate(input) {
+    if (!REMINDER_SIGNAL_RE.test(input))
+        return null;
+    const time_text = extractTime(input);
+    const recurrence_text = extractRecurrence(input);
+    const subject = extractSubject(input, time_text);
+    const hasSubject = subject !== null;
+    const hasTime = time_text !== null;
+    let confidence;
+    if (hasSubject && hasTime)
+        confidence = "explicit";
+    else if (hasSubject || hasTime)
+        confidence = "partial";
+    else
+        confidence = "ambiguous";
+    return { subject, time_text, recurrence_text, confidence };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// State logic
+// ─────────────────────────────────────────────────────────────────────────────
+function determineState(candidate) {
+    const { subject, time_text, confidence } = candidate;
+    // Ambiguous confidence → always ambiguous state regardless of fields
+    if (confidence === "ambiguous")
+        return "ambiguous";
+    // Both present → ready
+    if (subject !== null && time_text !== null)
+        return "ready_to_confirm";
+    // Subject only → ask for time
+    if (subject !== null && time_text === null)
+        return "needs_time";
+    // Time only → ask for subject
+    if (subject === null && time_text !== null)
+        return "needs_subject";
+    // Fallback (should not be reachable given confidence check above)
+    return "ambiguous";
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Missing fields
+// ─────────────────────────────────────────────────────────────────────────────
+function buildMissingFields(candidate) {
+    const missing = [];
+    if (candidate.subject === null)
+        missing.push("subject");
+    if (candidate.time_text === null)
+        missing.push("time");
+    return missing;
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Actions
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Build the three standard actions for a reminder presentation.
+ *
+ * ── Action rules ─────────────────────────────────────────────────────────────
+ *
+ *   confirm   — enabled ONLY when state === "ready_to_confirm"
+ *               Requiring both subject and time prevents confirming incomplete data.
+ *
+ *   edit      — always enabled
+ *               Label changes to "Clarify" in ambiguous state to reflect that
+ *               the user needs to clarify intent, not just edit known fields.
+ *
+ *   reject    — always enabled
+ *               The user can always dismiss a reminder presentation.
+ *
+ * These are PRESENTATION descriptors. They do not execute anything.
+ * The consumer is responsible for routing action IDs to actual behavior.
+ */
+function buildActions(state) {
+    return [
+        {
+            id: "confirm",
+            label: "Confirm",
+            enabled: state === "ready_to_confirm",
+        },
+        {
+            id: "edit",
+            label: state === "ambiguous" ? "Clarify" : "Edit",
+            enabled: true,
+        },
+        {
+            id: "reject",
+            label: "Reject",
+            enabled: true,
+        },
+    ];
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Public entry point
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * presentReminder(input) — the sole public function of this module.
+ *
+ * Takes raw input text and produces a ReminderPresentation, or null if the
+ * input does not contain enough reminder signal to justify reminder shaping.
+ *
+ * ── Return null when ─────────────────────────────────────────────────────────
+ *
+ *   The input contains no reminder signal (no "remind me", "set a reminder", etc.)
+ *   In this case, callers should fall back to existing presentation behavior.
+ *
+ * ── Return ReminderPresentation when ────────────────────────────────────────
+ *
+ *   The input contains a reminder signal, even if fields are missing.
+ *   The state field tells the consumer how complete the reminder is.
+ *   Missing fields are listed in missing_fields.
+ *
+ * ── Determinism guarantee ────────────────────────────────────────────────────
+ *
+ *   Same input → same output, always.
+ *   No randomness. No session state. No side effects.
+ */
+export function presentReminder(input) {
+    const candidate = extractReminderCandidate(input);
+    if (candidate === null)
+        return null;
+    const state = determineState(candidate);
+    const missing_fields = buildMissingFields(candidate);
+    const actions = buildActions(state);
+    return {
+        kind: "reminder",
+        state,
+        subject: candidate.subject,
+        time_text: candidate.time_text,
+        recurrence_text: candidate.recurrence_text,
+        confidence: candidate.confidence,
+        missing_fields,
+        actions,
+    };
+}
+//# sourceMappingURL=reminder-presenter.js.map

package/dist/src/present/reminders/reminder-presenter.js.map

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

package/dist/src/present/reminders/reminder-renderer.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Reminder Renderer — Phase 5, Present Layer.
+ *
+ * ── Responsibility ────────────────────────────────────────────────────────────
+ *
+ * Takes a ReminderPresentation (already-built by the presenter) and produces
+ * a RenderedReminder — the human-readable string output ready for display.
+ *
+ * ── What this does NOT do ─────────────────────────────────────────────────────
+ *
+ *   Does NOT invent new information      — renders only what the presentation has
+ *   Does NOT execute anything            — pure string formatting
+ *   Does NOT make decisions              — all state logic is in reminder-presenter.ts
+ *   Does NOT produce HTML or markup      — plain structured text only
+ *
+ * ── Rendering contract ────────────────────────────────────────────────────────
+ *
+ *   RenderedReminder is the final consumer-facing shape.
+ *   All fields are plain strings (or null where absent).
+ *   Consumers may combine them in any layout they choose.
+ *
+ *   headline     — always present; the top line
+ *   body         — lines describing known fields (subject, time, recurrence)
+ *                  array is empty when nothing is known yet
+ *   prompt       — the question to ask the user for missing fields
+ *                  null when state === "ready_to_confirm" (nothing is missing)
+ *   actions_label — a single formatted string like "Confirm · Edit · Reject"
+ *                  only includes ENABLED actions
+ *   missing      — copy of missing_fields from the presentation for convenience
+ *
+ * ── Template logic ────────────────────────────────────────────────────────────
+ *
+ *   Case A (ready_to_confirm):
+ *     headline: "Reminder"
+ *     body:     "Task: {subject}" / "Time: {time}" / "Repeats: {recurrence}"
+ *     prompt:   null
+ *     actions:  "Confirm · Edit · Reject"
+ *
+ *   Case B (needs_time):
+ *     headline: "Reminder (incomplete)"
+ *     body:     "Task: {subject}"
+ *     prompt:   "When should this reminder trigger?"
+ *     actions:  "Edit · Reject"
+ *
+ *   Case C (needs_subject):
+ *     headline: "Reminder (incomplete)"
+ *     body:     "Time: {time}" / "Repeats: {recurrence}"
+ *     prompt:   "What should this reminder be for?"
+ *     actions:  "Edit · Reject"
+ *
+ *   Case D (ambiguous):
+ *     headline: "Possible reminder"
+ *     body:     [] (empty — nothing is confirmed)
+ *     prompt:   "Is this a reminder? If so, what would you like to be reminded about, and when?"
+ *     actions:  "Clarify · Reject"
+ */
+import type { ReminderPresentation } from "./reminder-types.js";
+/**
+ * RenderedReminder — the final display-ready shape.
+ *
+ *   headline      — the primary heading line
+ *   body          — array of detail lines (Task, Time, Repeats)
+ *                   each line is a complete display-ready string
+ *   prompt        — what to ask the user next; null if nothing is missing
+ *   actions_label — display string of enabled actions joined by " · "
+ *   missing       — mirror of ReminderPresentation.missing_fields
+ */
+export type RenderedReminder = {
+    readonly headline: string;
+    readonly body: readonly string[];
+    readonly prompt: string | null;
+    readonly actions_label: string;
+    readonly missing: readonly string[];
+};
+/**
+ * renderReminder(presentation) — convert a ReminderPresentation to display strings.
+ *
+ * Deterministic: same ReminderPresentation → same RenderedReminder, always.
+ * No side effects. No decisions. Pure formatting.
+ */
+export declare function renderReminder(p: ReminderPresentation): RenderedReminder;
+//# sourceMappingURL=reminder-renderer.d.ts.map

package/dist/src/present/reminders/reminder-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reminder-renderer.d.ts","sourceRoot":"","sources":["../../../../src/present/reminders/reminder-renderer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAUhE;;;;;;;;;GASG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,QAAQ,EAAO,MAAM,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAW,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAS,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,OAAO,EAAQ,SAAS,MAAM,EAAE,CAAC;CAC3C,CAAC;AAMF;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,oBAAoB,GAAG,gBAAgB,CAuExE"}

package/dist/src/present/reminders/reminder-renderer.js

@@ -0,0 +1,136 @@
+/**
+ * Reminder Renderer — Phase 5, Present Layer.
+ *
+ * ── Responsibility ────────────────────────────────────────────────────────────
+ *
+ * Takes a ReminderPresentation (already-built by the presenter) and produces
+ * a RenderedReminder — the human-readable string output ready for display.
+ *
+ * ── What this does NOT do ─────────────────────────────────────────────────────
+ *
+ *   Does NOT invent new information      — renders only what the presentation has
+ *   Does NOT execute anything            — pure string formatting
+ *   Does NOT make decisions              — all state logic is in reminder-presenter.ts
+ *   Does NOT produce HTML or markup      — plain structured text only
+ *
+ * ── Rendering contract ────────────────────────────────────────────────────────
+ *
+ *   RenderedReminder is the final consumer-facing shape.
+ *   All fields are plain strings (or null where absent).
+ *   Consumers may combine them in any layout they choose.
+ *
+ *   headline     — always present; the top line
+ *   body         — lines describing known fields (subject, time, recurrence)
+ *                  array is empty when nothing is known yet
+ *   prompt       — the question to ask the user for missing fields
+ *                  null when state === "ready_to_confirm" (nothing is missing)
+ *   actions_label — a single formatted string like "Confirm · Edit · Reject"
+ *                  only includes ENABLED actions
+ *   missing      — copy of missing_fields from the presentation for convenience
+ *
+ * ── Template logic ────────────────────────────────────────────────────────────
+ *
+ *   Case A (ready_to_confirm):
+ *     headline: "Reminder"
+ *     body:     "Task: {subject}" / "Time: {time}" / "Repeats: {recurrence}"
+ *     prompt:   null
+ *     actions:  "Confirm · Edit · Reject"
+ *
+ *   Case B (needs_time):
+ *     headline: "Reminder (incomplete)"
+ *     body:     "Task: {subject}"
+ *     prompt:   "When should this reminder trigger?"
+ *     actions:  "Edit · Reject"
+ *
+ *   Case C (needs_subject):
+ *     headline: "Reminder (incomplete)"
+ *     body:     "Time: {time}" / "Repeats: {recurrence}"
+ *     prompt:   "What should this reminder be for?"
+ *     actions:  "Edit · Reject"
+ *
+ *   Case D (ambiguous):
+ *     headline: "Possible reminder"
+ *     body:     [] (empty — nothing is confirmed)
+ *     prompt:   "Is this a reminder? If so, what would you like to be reminded about, and when?"
+ *     actions:  "Clarify · Reject"
+ */
+import { evaluateControlVisibility, assertControlVisibilityConsistency, } from "../control-visibility/index.js";
+// ─────────────────────────────────────────────────────────────────────────────
+// Renderer
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * renderReminder(presentation) — convert a ReminderPresentation to display strings.
+ *
+ * Deterministic: same ReminderPresentation → same RenderedReminder, always.
+ * No side effects. No decisions. Pure formatting.
+ */
+export function renderReminder(p) {
+    // CVG read-only hook — compute and assert, output shape unchanged.
+    const cvg = evaluateControlVisibility({ kind: "reminder_presentation", presentation: p });
+    assertControlVisibilityConsistency(cvg);
+    // Build the actions label from enabled actions only
+    const actions_label = p.actions
+        .filter((a) => a.enabled)
+        .map((a) => a.label)
+        .join(" · ");
+    switch (p.state) {
+        // ── Case A: ready_to_confirm ────────────────────────────────────────────
+        case "ready_to_confirm": {
+            const body = [];
+            // subject and time_text are guaranteed non-null in ready_to_confirm
+            // (state logic in reminder-presenter.ts ensures this)
+            if (p.subject !== null)
+                body.push(`Task: ${p.subject}`);
+            if (p.time_text !== null)
+                body.push(`Time: ${p.time_text}`);
+            if (p.recurrence_text !== null)
+                body.push(`Repeats: ${p.recurrence_text}`);
+            return {
+                headline: "Reminder",
+                body,
+                prompt: null,
+                actions_label,
+                missing: p.missing_fields,
+            };
+        }
+        // ── Case B: needs_time ──────────────────────────────────────────────────
+        case "needs_time": {
+            const body = [];
+            if (p.subject !== null)
+                body.push(`Task: ${p.subject}`);
+            return {
+                headline: "Reminder (incomplete)",
+                body,
+                prompt: "When should this reminder trigger?",
+                actions_label,
+                missing: p.missing_fields,
+            };
+        }
+        // ── Case C: needs_subject ───────────────────────────────────────────────
+        case "needs_subject": {
+            const body = [];
+            if (p.time_text !== null)
+                body.push(`Time: ${p.time_text}`);
+            if (p.recurrence_text !== null)
+                body.push(`Repeats: ${p.recurrence_text}`);
+            return {
+                headline: "Reminder (incomplete)",
+                body,
+                prompt: "What should this reminder be for?",
+                actions_label,
+                missing: p.missing_fields,
+            };
+        }
+        // ── Case D: ambiguous ───────────────────────────────────────────────────
+        case "ambiguous": {
+            return {
+                headline: "Possible reminder",
+                body: [],
+                prompt: "Is this a reminder? If so, what would you like to be reminded about, and when?",
+                actions_label,
+                missing: p.missing_fields,
+            };
+        }
+    }
+}
+//# sourceMappingURL=reminder-renderer.js.map

package/dist/src/present/reminders/reminder-renderer.js.map

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