@continuum-dev/runtime 0.1.0

package/lib/types.d.ts

@@ -0,0 +1,153 @@
+import type { ViewNode, NodeValue, ViewDiff, IssueCode, IssueSeverity, DataSnapshot, DataResolution, ValueLineage, DetachedValue } from '@continuum/contract';
+export interface ReconciliationResult {
+    /**
+     * The merged snapshot to persist and render after reconciliation.
+     */
+    reconciledState: DataSnapshot;
+    /**
+     * Change events describing what happened to each affected node value.
+     */
+    diffs: StateDiff[];
+    /**
+     * Validation and reconciliation warnings/errors emitted during processing.
+     */
+    issues: ReconciliationIssue[];
+    /**
+     * Per-node explanation of how each value was resolved.
+     */
+    resolutions: ReconciliationResolution[];
+}
+export interface StateDiff {
+    /**
+     * Node id in the reconciled view.
+     */
+    nodeId: string;
+    /**
+     * Diff category such as added, removed, migrated, type-changed, or restored.
+     */
+    type: ViewDiff;
+    /**
+     * Previous value from the prior snapshot (when available).
+     */
+    oldValue?: unknown;
+    /**
+     * New value produced by reconciliation (when available).
+     */
+    newValue?: unknown;
+    /**
+     * Optional machine-readable rationale for the diff.
+     */
+    reason?: string;
+}
+export interface ReconciliationResolution {
+    /**
+     * Node id in the new view this resolution applies to.
+     */
+    nodeId: string;
+    /**
+     * Matched node id from the prior view, if any.
+     */
+    priorId: string | null;
+    /**
+     * How the prior node was matched to the new node.
+     */
+    matchedBy: 'id' | 'key' | null;
+    /**
+     * Prior node type, if a prior node was found.
+     */
+    priorType: string | null;
+    /**
+     * New node type in the current view.
+     */
+    newType: string;
+    /**
+     * Final resolution outcome for this node.
+     */
+    resolution: DataResolution;
+    /**
+     * Value observed in prior state before reconciliation.
+     */
+    priorValue: unknown;
+    /**
+     * Value emitted for this node after reconciliation.
+     */
+    reconciledValue: unknown;
+}
+export interface ReconciliationIssue {
+    /**
+     * Severity level to help route handling (error, warning, info).
+     */
+    severity: IssueSeverity;
+    /**
+     * Optional node id associated with the issue.
+     */
+    nodeId?: string;
+    /**
+     * Human-readable issue message for logs or UI.
+     */
+    message: string;
+    /**
+     * Stable issue code for programmatic handling.
+     */
+    code: IssueCode;
+}
+/**
+ * Runtime behavior flags and extension points for `reconcile`.
+ */
+export interface ReconciliationOptions {
+    /**
+     * When true, suppresses node-removed warnings for partial restoration workflows.
+     *
+     * Useful when your app intentionally allows temporary view pruning while keeping
+     * detached values around for later restoration.
+     */
+    allowPartialRestore?: boolean;
+    /**
+     * When true and `priorView` is null, carries values by matching raw node ids.
+     *
+     * This is a fallback mode for sessions that have data but no previous view AST.
+     */
+    allowBlindCarry?: boolean;
+    /**
+     * Per-node migration overrides keyed by the new node id.
+     *
+     * Use this when you know a specific node changed schema and needs custom logic.
+     */
+    migrationStrategies?: Record<string, MigrationStrategy>;
+    /**
+     * Named migration functions referenced by view-level migration rules.
+     *
+     * Use with `newNode.migrations[*].strategyId` to keep migration logic reusable.
+     */
+    strategyRegistry?: Record<string, MigrationStrategy>;
+    /**
+     * Time source used for lineage and detached value timestamps.
+     *
+     * Override in tests for deterministic assertions.
+     */
+    clock?: () => number;
+}
+/**
+ * User-provided transformation function used when a node schema changes.
+ *
+ * A strategy should return the value shape expected by the new node. The runtime
+ * passes raw prior value payloads so strategies can handle both simple and nested
+ * structures. Throwing from this function reports a migration failure issue.
+ *
+ * @param nodeId Node id in the new view being reconciled.
+ * @param priorNode Prior view node definition.
+ * @param newNode New view node definition.
+ * @param priorValue Previous value payload associated with the node.
+ * @returns Reconciled value payload for the new node.
+ */
+export type MigrationStrategy = (nodeId: string, priorNode: ViewNode, newNode: ViewNode, priorValue: unknown) => unknown;
+export interface NodeResolutionAccumulator {
+    values: Record<string, NodeValue>;
+    valueLineage: Record<string, ValueLineage>;
+    detachedValues: Record<string, DetachedValue>;
+    restoredDetachedKeys: Set<string>;
+    diffs: StateDiff[];
+    resolutions: ReconciliationResolution[];
+    issues: ReconciliationIssue[];
+}
+//# sourceMappingURL=types.d.ts.map

package/lib/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../packages/runtime/src/lib/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,QAAQ,EACR,SAAS,EACT,QAAQ,EACR,SAAS,EACT,aAAa,EACb,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,aAAa,EACd,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,oBAAoB;IACnC;;OAEG;IACH,eAAe,EAAE,YAAY,CAAC;IAC9B;;OAEG;IACH,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB;;OAEG;IACH,MAAM,EAAE,mBAAmB,EAAE,CAAC;IAC9B;;OAEG;IACH,WAAW,EAAE,wBAAwB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,SAAS;IACxB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,EAAE,QAAQ,CAAC;IACf;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,wBAAwB;IACvC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB;;OAEG;IACH,SAAS,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC;IAC/B;;OAEG;IACH,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,UAAU,EAAE,cAAc,CAAC;IAC3B;;OAEG;IACH,UAAU,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,QAAQ,EAAE,aAAa,CAAC;IACxB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,IAAI,EAAE,SAAS,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACxD;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACrD;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,iBAAiB,GAAG,CAC9B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,QAAQ,EACnB,OAAO,EAAE,QAAQ,EACjB,UAAU,EAAE,OAAO,KAChB,OAAO,CAAC;AAEb,MAAM,WAAW,yBAAyB;IACxC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC3C,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IAC9C,oBAAoB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAClC,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,WAAW,EAAE,wBAAwB,EAAE,CAAC;IACxC,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B"}

package/lib/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@continuum-dev/runtime",
+  "version": "0.1.0",
+  "publishConfig": {
+    "access": "public"
+  },
+  "description": "Reconciliation engine for AI-generated view continuity",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/brytoncooper/cooper-continuum.git",
+    "directory": "packages/runtime"
+  },
+  "author": "CooperContinuum",
+  "keywords": [
+    "continuum",
+    "ai",
+    "ui",
+    "continuity",
+    "reconciliation",
+    "engine"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "main": "./index.js",
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "default": "./index.js"
+    }
+  },
+  "files": [
+    "**/*.js",
+    "**/*.d.ts",
+    "**/*.d.ts.map",
+    "README.md",
+    "LICENSE*"
+  ],
+  "dependencies": {
+    "@continuum-dev/contract": "^0.1.0"
+  }
+}