usesteady 0.1.0-alpha.1

package/dist/src/ucp/mappers/map-disambiguation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-disambiguation.d.ts","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-disambiguation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,sBAAsB,EAAyB,OAAO,EAAE,MAAM,aAAa,CAAC;AAC1F,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0CAA0C,CAAC;AAErF,wBAAgB,2BAA2B,CACzC,MAAM,EAAE,oBAAoB,EAC5B,IAAI,CAAC,EAAE,OAAO,GACb,sBAAsB,CAYxB"}

package/dist/src/ucp/mappers/map-disambiguation.js

@@ -0,0 +1,21 @@
+/**
+ * Mapper: DisambiguationResult → DisambiguationEnvelope.
+ *
+ * Maps exactly from DisambiguationResult (src/understand/disambiguation/types.ts).
+ * The "unknown" kind carries no extra fields — the input simply had no signal.
+ */
+import { createDisambiguationEnvelope } from "../envelope.js";
+export function mapDisambiguationToEnvelope(result, refs) {
+    let payload;
+    if (result.kind === "clear") {
+        payload = { kind: "clear", normalized: result.normalized };
+    }
+    else if (result.kind === "ambiguous") {
+        payload = { kind: "ambiguous", reason: result.reason, options: result.options };
+    }
+    else {
+        payload = { kind: "unknown" };
+    }
+    return createDisambiguationEnvelope(payload, refs);
+}
+//# sourceMappingURL=map-disambiguation.js.map

package/dist/src/ucp/mappers/map-disambiguation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-disambiguation.js","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-disambiguation.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAI9D,MAAM,UAAU,2BAA2B,CACzC,MAA4B,EAC5B,IAAc;IAEd,IAAI,OAA8B,CAAC;IAEnC,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QAC5B,OAAO,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC;IAC7D,CAAC;SAAM,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QACvC,OAAO,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC;IAClF,CAAC;SAAM,CAAC;QACN,OAAO,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;IAChC,CAAC;IAED,OAAO,4BAA4B,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACrD,CAAC"}

package/dist/src/ucp/mappers/map-execution-trace.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Mapper: ArtifactLike (trace portion) → ExecutionTraceEnvelope.
+ *
+ * Seals the full execution timeline for one run as a lightweight identity
+ * envelope. Individual trace entries are not copied — they are represented
+ * by a content hash (traceHash) and a sequence of kind strings.
+ *
+ * ── traceHash specification (5 locked rules) ─────────────────────────────────
+ *
+ *   1. Ordering:       Recorded/append order — same as artifact.trace[] index order.
+ *                      No resorting.
+ *   2. Included:       ALL TraceEntry fields: kind, runId, nodeId, timestampMs, payload.
+ *   3. Excluded:       None. No derived summaries or presentation fields.
+ *   4. Timestamps:     timestampMs IS included. Two runs at different times produce
+ *                      different traceHash values. This is correct — each trace is
+ *                      a specific, time-stamped execution record.
+ *   5. Serialization:  stableStringify() — sorted keys at all nesting levels.
+ *                      Same algorithm as FinalizedArtifact.checksum computation.
+ *
+ * ── Mapping rules ─────────────────────────────────────────────────────────────
+ *
+ *   runId       ← artifact.runId
+ *   entryCount  ← artifact.trace.length
+ *   kinds       ← artifact.trace.map(e => e.kind)  (ordered, string values)
+ *   traceHash   ← hashObject(artifact.trace)
+ *
+ * ── What this mapper does NOT do ─────────────────────────────────────────────
+ *
+ *   ✗ Copy individual trace entry payloads, nodeIds, or timestamps
+ *   ✗ Reshape or reorder trace entries
+ *   ✗ Add derived summaries or presentation fields
+ *   ✗ Affect FinalizedArtifact.checksum
+ */
+import type { ExecutionTraceEnvelope, UCPRefs } from "../types.js";
+/**
+ * Minimal structural type for one trace entry.
+ * Consumers pass objects with kind, runId, nodeId, timestampMs, payload.
+ * We access .kind for the kinds[] field; the full entry is hashed as-is.
+ */
+export type TraceEntryLike = {
+    readonly kind: string;
+    readonly [key: string]: unknown;
+};
+/**
+ * Minimal structural type for the artifact's trace portion.
+ */
+export type ArtifactWithTraceLike = {
+    readonly runId: string;
+    readonly trace: ReadonlyArray<TraceEntryLike>;
+};
+/**
+ * Map an artifact's execution trace to its canonical sealed envelope.
+ *
+ * Pure function — same trace → same envelope id.
+ * Note: traceHash will differ between runs even for identical logic, because
+ * timestampMs is included per the locked spec.
+ *
+ * @param artifact  Must have runId and trace[] satisfying the shapes above
+ * @param refs      Optional provenance refs:
+ *                    refs.parentId = ucp.artifact.v1 ID (immediate predecessor)
+ *                    refs.rootId   = ucp.intent.v1 ID  (originating intent)
+ */
+export declare function mapExecutionTraceToEnvelope(artifact: ArtifactWithTraceLike, refs?: UCPRefs): ExecutionTraceEnvelope;
+//# sourceMappingURL=map-execution-trace.d.ts.map

package/dist/src/ucp/mappers/map-execution-trace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-execution-trace.d.ts","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-execution-trace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAIH,OAAO,KAAK,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEnE;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACjC,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;CAC/C,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CACzC,QAAQ,EAAE,qBAAqB,EAC/B,IAAI,CAAC,EAAE,OAAO,GACb,sBAAsB,CAWxB"}

package/dist/src/ucp/mappers/map-execution-trace.js

@@ -0,0 +1,57 @@
+/**
+ * Mapper: ArtifactLike (trace portion) → ExecutionTraceEnvelope.
+ *
+ * Seals the full execution timeline for one run as a lightweight identity
+ * envelope. Individual trace entries are not copied — they are represented
+ * by a content hash (traceHash) and a sequence of kind strings.
+ *
+ * ── traceHash specification (5 locked rules) ─────────────────────────────────
+ *
+ *   1. Ordering:       Recorded/append order — same as artifact.trace[] index order.
+ *                      No resorting.
+ *   2. Included:       ALL TraceEntry fields: kind, runId, nodeId, timestampMs, payload.
+ *   3. Excluded:       None. No derived summaries or presentation fields.
+ *   4. Timestamps:     timestampMs IS included. Two runs at different times produce
+ *                      different traceHash values. This is correct — each trace is
+ *                      a specific, time-stamped execution record.
+ *   5. Serialization:  stableStringify() — sorted keys at all nesting levels.
+ *                      Same algorithm as FinalizedArtifact.checksum computation.
+ *
+ * ── Mapping rules ─────────────────────────────────────────────────────────────
+ *
+ *   runId       ← artifact.runId
+ *   entryCount  ← artifact.trace.length
+ *   kinds       ← artifact.trace.map(e => e.kind)  (ordered, string values)
+ *   traceHash   ← hashObject(artifact.trace)
+ *
+ * ── What this mapper does NOT do ─────────────────────────────────────────────
+ *
+ *   ✗ Copy individual trace entry payloads, nodeIds, or timestamps
+ *   ✗ Reshape or reorder trace entries
+ *   ✗ Add derived summaries or presentation fields
+ *   ✗ Affect FinalizedArtifact.checksum
+ */
+import { createExecutionTraceEnvelope } from "../envelope.js";
+import { hashObject } from "../hashes.js";
+/**
+ * Map an artifact's execution trace to its canonical sealed envelope.
+ *
+ * Pure function — same trace → same envelope id.
+ * Note: traceHash will differ between runs even for identical logic, because
+ * timestampMs is included per the locked spec.
+ *
+ * @param artifact  Must have runId and trace[] satisfying the shapes above
+ * @param refs      Optional provenance refs:
+ *                    refs.parentId = ucp.artifact.v1 ID (immediate predecessor)
+ *                    refs.rootId   = ucp.intent.v1 ID  (originating intent)
+ */
+export function mapExecutionTraceToEnvelope(artifact, refs) {
+    const trace = artifact.trace;
+    return createExecutionTraceEnvelope({
+        runId: artifact.runId,
+        entryCount: trace.length,
+        kinds: trace.map((e) => e.kind),
+        traceHash: hashObject(trace),
+    }, refs);
+}
+//# sourceMappingURL=map-execution-trace.js.map

package/dist/src/ucp/mappers/map-execution-trace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-execution-trace.js","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-execution-trace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAqB1C;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,2BAA2B,CACzC,QAA+B,EAC/B,IAAc;IAEd,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC;IAC7B,OAAO,4BAA4B,CACjC;QACE,KAAK,EAAO,QAAQ,CAAC,KAAK;QAC1B,UAAU,EAAE,KAAK,CAAC,MAAM;QACxB,KAAK,EAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACpC,SAAS,EAAG,UAAU,CAAC,KAAK,CAAC;KAC9B,EACD,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/src/ucp/mappers/map-intent-interpretation.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Mapper: IntentInterpretation → IntentInterpretationEnvelope.
+ *
+ * Maps exactly from IntentInterpretation
+ * (src/understand/intent-interpretation/types.ts).
+ * Returns null when no interpretation was produced (bridge stayed silent).
+ */
+import type { IntentInterpretationEnvelope, UCPRefs } from "../types.js";
+import type { IntentInterpretation } from "../../understand/intent-interpretation/types.js";
+export declare function mapIntentInterpretationToEnvelope(interpretation: IntentInterpretation, refs?: UCPRefs): IntentInterpretationEnvelope;
+//# sourceMappingURL=map-intent-interpretation.d.ts.map

package/dist/src/ucp/mappers/map-intent-interpretation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-intent-interpretation.d.ts","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-intent-interpretation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,4BAA4B,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACzE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iDAAiD,CAAC;AAE5F,wBAAgB,iCAAiC,CAC/C,cAAc,EAAE,oBAAoB,EACpC,IAAI,CAAC,EAAE,OAAO,GACb,4BAA4B,CAU9B"}

package/dist/src/ucp/mappers/map-intent-interpretation.js

@@ -0,0 +1,17 @@
+/**
+ * Mapper: IntentInterpretation → IntentInterpretationEnvelope.
+ *
+ * Maps exactly from IntentInterpretation
+ * (src/understand/intent-interpretation/types.ts).
+ * Returns null when no interpretation was produced (bridge stayed silent).
+ */
+import { createIntentInterpretationEnvelope } from "../envelope.js";
+export function mapIntentInterpretationToEnvelope(interpretation, refs) {
+    return createIntentInterpretationEnvelope({
+        category: interpretation.category,
+        summary: interpretation.summary,
+        confidence: interpretation.confidence,
+        basis: interpretation.basis,
+    }, refs);
+}
+//# sourceMappingURL=map-intent-interpretation.js.map

package/dist/src/ucp/mappers/map-intent-interpretation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-intent-interpretation.js","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-intent-interpretation.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,kCAAkC,EAAE,MAAM,gBAAgB,CAAC;AAIpE,MAAM,UAAU,iCAAiC,CAC/C,cAAoC,EACpC,IAAc;IAEd,OAAO,kCAAkC,CACvC;QACE,QAAQ,EAAI,cAAc,CAAC,QAAQ;QACnC,OAAO,EAAK,cAAc,CAAC,OAAO;QAClC,UAAU,EAAE,cAAc,CAAC,UAAU;QACrC,KAAK,EAAO,cAAc,CAAC,KAAK;KACjC,EACD,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/src/ucp/mappers/map-intent.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Mapper: raw input string → IntentEnvelope.
+ *
+ * The intent envelope captures the user's raw input before any processing.
+ * It is always the first envelope in a UCP bundle.
+ */
+import type { IntentEnvelope, UCPRefs } from "../types.js";
+export declare function mapIntentToEnvelope(input: string, refs?: UCPRefs): IntentEnvelope;
+//# sourceMappingURL=map-intent.d.ts.map

package/dist/src/ucp/mappers/map-intent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-intent.d.ts","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-intent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3D,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,cAAc,CAEjF"}

package/dist/src/ucp/mappers/map-intent.js

@@ -0,0 +1,11 @@
+/**
+ * Mapper: raw input string → IntentEnvelope.
+ *
+ * The intent envelope captures the user's raw input before any processing.
+ * It is always the first envelope in a UCP bundle.
+ */
+import { createIntentEnvelope } from "../envelope.js";
+export function mapIntentToEnvelope(input, refs) {
+    return createIntentEnvelope({ input }, refs);
+}
+//# sourceMappingURL=map-intent.js.map

package/dist/src/ucp/mappers/map-intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-intent.js","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-intent.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAGtD,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,IAAc;IAC/D,OAAO,oBAAoB,CAAC,EAAE,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC;AAC/C,CAAC"}

package/dist/src/ucp/mappers/map-prv.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Mapper: PRVResult → PRVEnvelope.
+ *
+ * Maps exactly from PRVResult (src/prv/types.ts).
+ * No interpretation of values — fields are transferred as-is.
+ */
+import type { PRVEnvelope, UCPRefs } from "../types.js";
+import type { PRVResult } from "../../prv/types.js";
+export declare function mapPRVToEnvelope(result: PRVResult, refs?: UCPRefs): PRVEnvelope;
+//# sourceMappingURL=map-prv.d.ts.map

package/dist/src/ucp/mappers/map-prv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-prv.d.ts","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-prv.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAc,OAAO,EAAE,MAAM,aAAa,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,WAAW,CAK/E"}

package/dist/src/ucp/mappers/map-prv.js

@@ -0,0 +1,14 @@
+/**
+ * Mapper: PRVResult → PRVEnvelope.
+ *
+ * Maps exactly from PRVResult (src/prv/types.ts).
+ * No interpretation of values — fields are transferred as-is.
+ */
+import { createPRVEnvelope } from "../envelope.js";
+export function mapPRVToEnvelope(result, refs) {
+    const payload = result.ok
+        ? { ok: true }
+        : { ok: false, mode: result.mode, reason: result.reason };
+    return createPRVEnvelope(payload, refs);
+}
+//# sourceMappingURL=map-prv.js.map

package/dist/src/ucp/mappers/map-prv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-prv.js","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-prv.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAInD,MAAM,UAAU,gBAAgB,CAAC,MAAiB,EAAE,IAAc;IAChE,MAAM,OAAO,GAAe,MAAM,CAAC,EAAE;QACnC,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE;QACd,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;IAC5D,OAAO,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAC1C,CAAC"}

package/dist/src/ucp/mappers/map-reminder-execution.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Mapper: ReminderExecutionArtifact → ReminderExecutionEnvelope.
+ *
+ * Maps from a finalized reminder execution artifact to its canonical UCP envelope.
+ *
+ * ── Mapping rules (field-for-field) ──────────────────────────────────────────
+ *
+ *   subject           ← artifact.subject                    (direct copy)
+ *   time_text         ← artifact.time_text                  (direct copy)
+ *   parsed_time_kind  ← artifact.parsed_time.kind           (kind only — see note)
+ *   recurrence_text   ← artifact.recurrence_text            (direct copy)
+ *   source_confidence ← artifact.source_confidence          (direct copy)
+ *   verdict           ← artifact.verdict                    (direct copy)
+ *   rejection_reason  ← artifact.rejection_reason           (direct copy, optional)
+ *
+ * ── Why parsed_time_kind only ────────────────────────────────────────────────
+ *
+ *   The envelope records the execution-classification outcome: was the time
+ *   parseable, and of what structural shape? It does NOT carry the full
+ *   ParsedTime (hour, minute, period, offset_minutes, etc.) because:
+ *
+ *     1. The envelope is a lightweight canonical record, not a scheduler payload.
+ *     2. The full ParsedTime lives in the artifact for downstream integrations.
+ *     3. This keeps the envelope consistent with the Phase 3 pattern:
+ *        artifact envelopes carry identity signals, not full data copies.
+ *
+ * ── What this mapper does NOT do ─────────────────────────────────────────────
+ *
+ *   ✗ Recompute or reinterpret any field
+ *   ✗ Copy the full ParsedTime struct (only kind is copied)
+ *   ✗ Add renderer-facing concerns
+ *   ✗ Validate the artifact (validation happens in the executor before this)
+ *
+ * ── CONSTRUCTION RULE: undefined-free payloads ────────────────────────────────
+ *
+ *   Optional fields (rejection_reason) must be omitted entirely when absent.
+ *   Never assign a payload key to `undefined` — stableStringify serializes
+ *   `undefined` as the string "undefined", which breaks content addressing.
+ *   Use conditional spreading: ...(value !== undefined ? { key: value } : {})
+ *
+ *   This is the mapper where this invariant was discovered (Phase 7 audit).
+ *   See: src/ucp/types.ts — "PROTOCOL INVARIANT: Payloads must be undefined-free"
+ */
+import type { ReminderExecutionEnvelope, UCPRefs } from "../types.js";
+import type { ReminderExecutionArtifact } from "../../execution/reminders/reminder-execution-types.js";
+/**
+ * Map a finalized reminder execution artifact to its canonical UCP envelope.
+ *
+ * Pure function — same artifact → same envelope id (content-addressed).
+ *
+ * @param artifact  The finalized ReminderExecutionArtifact from executeReminder().
+ * @param refs      Optional provenance refs:
+ *                    refs.rootId   = ucp.intent.v1 ID (closes provenance chain)
+ *                    refs.parentId = ucp.response.v1 ID (immediate predecessor)
+ */
+export declare function mapReminderExecutionToEnvelope(artifact: ReminderExecutionArtifact, refs?: UCPRefs): ReminderExecutionEnvelope;
+//# sourceMappingURL=map-reminder-execution.d.ts.map

package/dist/src/ucp/mappers/map-reminder-execution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-reminder-execution.d.ts","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-reminder-execution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAGH,OAAO,KAAK,EAAE,yBAAyB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,uDAAuD,CAAC;AAEvG;;;;;;;;;GASG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,yBAAyB,EACnC,IAAI,CAAC,EAAE,OAAO,GACb,yBAAyB,CAc3B"}

package/dist/src/ucp/mappers/map-reminder-execution.js

@@ -0,0 +1,69 @@
+/**
+ * Mapper: ReminderExecutionArtifact → ReminderExecutionEnvelope.
+ *
+ * Maps from a finalized reminder execution artifact to its canonical UCP envelope.
+ *
+ * ── Mapping rules (field-for-field) ──────────────────────────────────────────
+ *
+ *   subject           ← artifact.subject                    (direct copy)
+ *   time_text         ← artifact.time_text                  (direct copy)
+ *   parsed_time_kind  ← artifact.parsed_time.kind           (kind only — see note)
+ *   recurrence_text   ← artifact.recurrence_text            (direct copy)
+ *   source_confidence ← artifact.source_confidence          (direct copy)
+ *   verdict           ← artifact.verdict                    (direct copy)
+ *   rejection_reason  ← artifact.rejection_reason           (direct copy, optional)
+ *
+ * ── Why parsed_time_kind only ────────────────────────────────────────────────
+ *
+ *   The envelope records the execution-classification outcome: was the time
+ *   parseable, and of what structural shape? It does NOT carry the full
+ *   ParsedTime (hour, minute, period, offset_minutes, etc.) because:
+ *
+ *     1. The envelope is a lightweight canonical record, not a scheduler payload.
+ *     2. The full ParsedTime lives in the artifact for downstream integrations.
+ *     3. This keeps the envelope consistent with the Phase 3 pattern:
+ *        artifact envelopes carry identity signals, not full data copies.
+ *
+ * ── What this mapper does NOT do ─────────────────────────────────────────────
+ *
+ *   ✗ Recompute or reinterpret any field
+ *   ✗ Copy the full ParsedTime struct (only kind is copied)
+ *   ✗ Add renderer-facing concerns
+ *   ✗ Validate the artifact (validation happens in the executor before this)
+ *
+ * ── CONSTRUCTION RULE: undefined-free payloads ────────────────────────────────
+ *
+ *   Optional fields (rejection_reason) must be omitted entirely when absent.
+ *   Never assign a payload key to `undefined` — stableStringify serializes
+ *   `undefined` as the string "undefined", which breaks content addressing.
+ *   Use conditional spreading: ...(value !== undefined ? { key: value } : {})
+ *
+ *   This is the mapper where this invariant was discovered (Phase 7 audit).
+ *   See: src/ucp/types.ts — "PROTOCOL INVARIANT: Payloads must be undefined-free"
+ */
+import { createReminderExecutionEnvelope } from "../envelope.js";
+/**
+ * Map a finalized reminder execution artifact to its canonical UCP envelope.
+ *
+ * Pure function — same artifact → same envelope id (content-addressed).
+ *
+ * @param artifact  The finalized ReminderExecutionArtifact from executeReminder().
+ * @param refs      Optional provenance refs:
+ *                    refs.rootId   = ucp.intent.v1 ID (closes provenance chain)
+ *                    refs.parentId = ucp.response.v1 ID (immediate predecessor)
+ */
+export function mapReminderExecutionToEnvelope(artifact, refs) {
+    const payload = {
+        subject: artifact.subject,
+        time_text: artifact.time_text,
+        parsed_time_kind: artifact.parsed_time.kind,
+        recurrence_text: artifact.recurrence_text,
+        source_confidence: artifact.source_confidence,
+        verdict: artifact.verdict,
+        ...(artifact.rejection_reason !== undefined
+            ? { rejection_reason: artifact.rejection_reason }
+            : {}),
+    };
+    return createReminderExecutionEnvelope(payload, refs);
+}
+//# sourceMappingURL=map-reminder-execution.js.map

package/dist/src/ucp/mappers/map-reminder-execution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-reminder-execution.js","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-reminder-execution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,EAAE,+BAA+B,EAAE,MAAM,gBAAgB,CAAC;AAIjE;;;;;;;;;GASG;AACH,MAAM,UAAU,8BAA8B,CAC5C,QAAmC,EACnC,IAAc;IAEd,MAAM,OAAO,GAAG;QACd,OAAO,EAAY,QAAQ,CAAC,OAAO;QACnC,SAAS,EAAU,QAAQ,CAAC,SAAS;QACrC,gBAAgB,EAAG,QAAQ,CAAC,WAAW,CAAC,IAAI;QAC5C,eAAe,EAAI,QAAQ,CAAC,eAAe;QAC3C,iBAAiB,EAAE,QAAQ,CAAC,iBAAiB;QAC7C,OAAO,EAAY,QAAQ,CAAC,OAAO;QACnC,GAAG,CAAC,QAAQ,CAAC,gBAAgB,KAAK,SAAS;YACzC,CAAC,CAAC,EAAE,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB,EAAE;YACjD,CAAC,CAAC,EAAE,CAAC;KACC,CAAC;IAEX,OAAO,+BAA+B,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACxD,CAAC"}

package/dist/src/ucp/mappers/map-replay-report.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Mapper: ReplayReportLike → ReplayReportEnvelope.
+ *
+ * Maps from a replay verification report to its canonical UCP envelope.
+ * This mapper is intentionally defined against a minimal structural type
+ * (ReplayReportLike) rather than importing any branded ReplayReport — avoiding
+ * circular dependencies while remaining fully type-safe via TypeScript's
+ * structural compatibility.
+ *
+ * ── Mapping rules (field-for-field) ──────────────────────────────────────────
+ *
+ *   runId             ← report.runId                          (direct copy)
+ *   verdict           ← report.verdict                        (direct copy)
+ *   checksumValid     ← report.checksumValid                  (direct copy)
+ *   artifactChecksum  ← report.artifactChecksum               (direct copy)
+ *   nodeCount         ← report.nodeResults.length             (derived)
+ *   verifiedCount     ← filter(n => n.verdict === "VERIFIED") (derived)
+ *   driftedCount      ← filter(n => n.verdict === "DRIFTED")  (derived)
+ *   skippedCount      ← filter(n => n.verdict === "SKIPPED")  (derived)
+ *   replayedAtMs      ← report.replayedAtMs                   (direct copy)
+ *
+ * ── CORRUPTED short-circuit behavior ─────────────────────────────────────────
+ *
+ *   When report.checksumValid === false (verdict === "CORRUPTED"):
+ *     report.nodeResults is [] (verification short-circuits before drift detection)
+ *     Therefore: nodeCount = 0, verifiedCount = 0, driftedCount = 0, skippedCount = 0
+ *   This is not invented — it follows directly from the source data.
+ *   The mapper does NOT special-case CORRUPTED; it maps nodeResults.length as-is.
+ *
+ * ── Exhaustiveness invariant ──────────────────────────────────────────────────
+ *
+ *   For all non-CORRUPTED reports:
+ *     verifiedCount + driftedCount + skippedCount === nodeCount
+ *   This holds because the 3 node-level verdicts are exhaustive and the counts
+ *   are derived by independent filters over the same nodeResults array.
+ *
+ * ── What this mapper does NOT do ─────────────────────────────────────────────
+ *
+ *   ✗ Infer missing node results
+ *   ✗ Collapse states (e.g., merge SKIPPED into DRIFTED)
+ *   ✗ Reinterpret replay semantics
+ *   ✗ Add summaries beyond the spec
+ *   ✗ Derive new conclusions from the verdict
+ *
+ * The replay envelope is a mirror, not an opinion.
+ */
+import type { ReplayReportEnvelope, UCPRefs } from "../types.js";
+/**
+ * Minimal structural type for one node replay result.
+ * Consumers pass objects with nodeId, command, verdict, and optional drift fields.
+ * We access only .verdict for count derivation.
+ */
+export type NodeReplayResultLike = {
+    readonly verdict: "VERIFIED" | "DRIFTED" | "SKIPPED";
+};
+/**
+ * Minimal structural type matching the relevant fields of ReplayReport.
+ * No branded import needed — TypeScript structural typing ensures compatibility.
+ */
+export type ReplayReportLike = {
+    readonly runId: string;
+    readonly artifactChecksum: string;
+    readonly checksumValid: boolean;
+    readonly verdict: "VERIFIED" | "DRIFTED" | "CORRUPTED" | "PARTIAL";
+    /** Empty array when verdict === "CORRUPTED" (short-circuit before drift detection). */
+    readonly nodeResults: readonly NodeReplayResultLike[];
+    readonly replayedAtMs: number;
+};
+/**
+ * Map a replay report to its canonical UCP envelope.
+ *
+ * Pure function — same report → same envelope id (content-addressed).
+ * Count fields are derived from nodeResults; no logic is applied beyond counting.
+ *
+ * @param report  The replay verification outcome (must satisfy ReplayReportLike shape)
+ * @param refs    Optional provenance refs:
+ *                  refs.parentId = ucp.artifact.v1 ID (the artifact that was verified)
+ *                  refs.rootId   = ucp.intent.v1 ID   (originating intent, propagated)
+ */
+export declare function mapReplayReportToEnvelope(report: ReplayReportLike, refs?: UCPRefs): ReplayReportEnvelope;
+//# sourceMappingURL=map-replay-report.d.ts.map

package/dist/src/ucp/mappers/map-replay-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-replay-report.d.ts","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-replay-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEjE;;;;GAIG;AACH,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;CACtD,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,QAAQ,CAAC,KAAK,EAAa,MAAM,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAK,OAAO,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAW,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IAC5E,uFAAuF;IACvF,QAAQ,CAAC,WAAW,EAAO,SAAS,oBAAoB,EAAE,CAAC;IAC3D,QAAQ,CAAC,YAAY,EAAM,MAAM,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,gBAAgB,EACxB,IAAI,CAAC,EAAE,OAAO,GACb,oBAAoB,CAoBtB"}

package/dist/src/ucp/mappers/map-replay-report.js

@@ -0,0 +1,76 @@
+/**
+ * Mapper: ReplayReportLike → ReplayReportEnvelope.
+ *
+ * Maps from a replay verification report to its canonical UCP envelope.
+ * This mapper is intentionally defined against a minimal structural type
+ * (ReplayReportLike) rather than importing any branded ReplayReport — avoiding
+ * circular dependencies while remaining fully type-safe via TypeScript's
+ * structural compatibility.
+ *
+ * ── Mapping rules (field-for-field) ──────────────────────────────────────────
+ *
+ *   runId             ← report.runId                          (direct copy)
+ *   verdict           ← report.verdict                        (direct copy)
+ *   checksumValid     ← report.checksumValid                  (direct copy)
+ *   artifactChecksum  ← report.artifactChecksum               (direct copy)
+ *   nodeCount         ← report.nodeResults.length             (derived)
+ *   verifiedCount     ← filter(n => n.verdict === "VERIFIED") (derived)
+ *   driftedCount      ← filter(n => n.verdict === "DRIFTED")  (derived)
+ *   skippedCount      ← filter(n => n.verdict === "SKIPPED")  (derived)
+ *   replayedAtMs      ← report.replayedAtMs                   (direct copy)
+ *
+ * ── CORRUPTED short-circuit behavior ─────────────────────────────────────────
+ *
+ *   When report.checksumValid === false (verdict === "CORRUPTED"):
+ *     report.nodeResults is [] (verification short-circuits before drift detection)
+ *     Therefore: nodeCount = 0, verifiedCount = 0, driftedCount = 0, skippedCount = 0
+ *   This is not invented — it follows directly from the source data.
+ *   The mapper does NOT special-case CORRUPTED; it maps nodeResults.length as-is.
+ *
+ * ── Exhaustiveness invariant ──────────────────────────────────────────────────
+ *
+ *   For all non-CORRUPTED reports:
+ *     verifiedCount + driftedCount + skippedCount === nodeCount
+ *   This holds because the 3 node-level verdicts are exhaustive and the counts
+ *   are derived by independent filters over the same nodeResults array.
+ *
+ * ── What this mapper does NOT do ─────────────────────────────────────────────
+ *
+ *   ✗ Infer missing node results
+ *   ✗ Collapse states (e.g., merge SKIPPED into DRIFTED)
+ *   ✗ Reinterpret replay semantics
+ *   ✗ Add summaries beyond the spec
+ *   ✗ Derive new conclusions from the verdict
+ *
+ * The replay envelope is a mirror, not an opinion.
+ */
+import { createReplayReportEnvelope } from "../envelope.js";
+/**
+ * Map a replay report to its canonical UCP envelope.
+ *
+ * Pure function — same report → same envelope id (content-addressed).
+ * Count fields are derived from nodeResults; no logic is applied beyond counting.
+ *
+ * @param report  The replay verification outcome (must satisfy ReplayReportLike shape)
+ * @param refs    Optional provenance refs:
+ *                  refs.parentId = ucp.artifact.v1 ID (the artifact that was verified)
+ *                  refs.rootId   = ucp.intent.v1 ID   (originating intent, propagated)
+ */
+export function mapReplayReportToEnvelope(report, refs) {
+    const nodeCount = report.nodeResults.length;
+    const verifiedCount = report.nodeResults.filter((n) => n.verdict === "VERIFIED").length;
+    const driftedCount = report.nodeResults.filter((n) => n.verdict === "DRIFTED").length;
+    const skippedCount = report.nodeResults.filter((n) => n.verdict === "SKIPPED").length;
+    return createReplayReportEnvelope({
+        runId: report.runId,
+        verdict: report.verdict,
+        checksumValid: report.checksumValid,
+        artifactChecksum: report.artifactChecksum,
+        nodeCount,
+        verifiedCount,
+        driftedCount,
+        skippedCount,
+        replayedAtMs: report.replayedAtMs,
+    }, refs);
+}
+//# sourceMappingURL=map-replay-report.js.map

package/dist/src/ucp/mappers/map-replay-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-replay-report.js","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-replay-report.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,gBAAgB,CAAC;AA0B5D;;;;;;;;;;GAUG;AACH,MAAM,UAAU,yBAAyB,CACvC,MAAwB,EACxB,IAAc;IAEd,MAAM,SAAS,GAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC;IAChD,MAAM,aAAa,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC,MAAM,CAAC;IACxF,MAAM,YAAY,GAAI,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IACvF,MAAM,YAAY,GAAI,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;IAEvF,OAAO,0BAA0B,CAC/B;QACE,KAAK,EAAa,MAAM,CAAC,KAAK;QAC9B,OAAO,EAAW,MAAM,CAAC,OAAO;QAChC,aAAa,EAAK,MAAM,CAAC,aAAa;QACtC,gBAAgB,EAAE,MAAM,CAAC,gBAAgB;QACzC,SAAS;QACT,aAAa;QACb,YAAY;QACZ,YAAY;QACZ,YAAY,EAAM,MAAM,CAAC,YAAY;KACtC,EACD,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/src/ucp/mappers/map-response.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Mapper: IntakeResult → ResponseEnvelope.
+ *
+ * Maps the final planner decision from IntakeResult (src/intake/types.ts).
+ * This is always the last decision envelope in a UCP bundle.
+ *
+ * Optional fields (guidance) use conditional spreading — never explicit undefined.
+ * See: src/ucp/types.ts — "PROTOCOL INVARIANT: Payloads must be undefined-free"
+ */
+import type { ResponseEnvelope, UCPRefs } from "../types.js";
+import type { IntakeResult } from "../../intake/types.js";
+export declare function mapResponseToEnvelope(result: IntakeResult, refs?: UCPRefs): ResponseEnvelope;
+//# sourceMappingURL=map-response.d.ts.map

package/dist/src/ucp/mappers/map-response.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-response.d.ts","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-response.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAiB5F"}

package/dist/src/ucp/mappers/map-response.js

@@ -0,0 +1,25 @@
+/**
+ * Mapper: IntakeResult → ResponseEnvelope.
+ *
+ * Maps the final planner decision from IntakeResult (src/intake/types.ts).
+ * This is always the last decision envelope in a UCP bundle.
+ *
+ * Optional fields (guidance) use conditional spreading — never explicit undefined.
+ * See: src/ucp/types.ts — "PROTOCOL INVARIANT: Payloads must be undefined-free"
+ */
+import { createResponseEnvelope } from "../envelope.js";
+export function mapResponseToEnvelope(result, refs) {
+    const guidance = result.guidance !== undefined
+        ? {
+            missing: [...result.guidance.missing],
+            nextSteps: result.guidance.nextSteps.map((s) => ({ type: s.type, label: s.label })),
+        }
+        : undefined;
+    return createResponseEnvelope({
+        mode: result.mode,
+        reason: result.reason,
+        intentState: result.intentState,
+        ...(guidance !== undefined ? { guidance } : {}),
+    }, refs);
+}
+//# sourceMappingURL=map-response.js.map

package/dist/src/ucp/mappers/map-response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-response.js","sourceRoot":"","sources":["../../../../src/ucp/mappers/map-response.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAIxD,MAAM,UAAU,qBAAqB,CAAC,MAAoB,EAAE,IAAc;IACxE,MAAM,QAAQ,GAAG,MAAM,CAAC,QAAQ,KAAK,SAAS;QAC5C,CAAC,CAAC;YACE,OAAO,EAAI,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC;YACvC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC;SACpF;QACH,CAAC,CAAC,SAAS,CAAC;IAEd,OAAO,sBAAsB,CAC3B;QACE,IAAI,EAAS,MAAM,CAAC,IAAI;QACxB,MAAM,EAAO,MAAM,CAAC,MAAM;QAC1B,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAChD,EACD,IAAI,CACL,CAAC;AACJ,CAAC"}

package/dist/src/ucp/mappers/map-safety.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Mapper: SafetyResult → SafetyEnvelope.
+ *
+ * Maps exactly from SafetyResult (src/safety/types.ts).
+ * Includes inspection fields (detectorId, matchedPattern) when present.
+ * "allow" results carry only the verdict — no reason or note.
+ *
+ * Optional fields use conditional spreading — never explicit undefined.
+ * See: src/ucp/types.ts — "PROTOCOL INVARIANT: Payloads must be undefined-free"
+ */
+import type { SafetyEnvelope, UCPRefs } from "../types.js";
+import type { SafetyResult } from "../../safety/types.js";
+export declare function mapSafetyToEnvelope(result: SafetyResult, refs?: UCPRefs): SafetyEnvelope;
+//# sourceMappingURL=map-safety.d.ts.map