@kontourai/lookout 0.3.0 → 0.3.2

package/dist/src/semantic-review-work.js

@@ -0,0 +1,36 @@
+import { diffProposalSets } from "./proposal-diff.js";
+import { collectSemanticChanges, projectReviewItem, reviewKey, sanitizeError, validateObservationIdentity } from "./semantic-review-projection.js";
+export { semanticReviewApiVersion } from "./semantic-review-types.js";
+/** Project one genuine proposal-observation transition into deterministic review work. */
+export function buildSemanticReviewWork(input) {
+    const identities = validateObservationIdentity(input.observationIdentity);
+    if (!identities.ok)
+        return identities;
+    const diff = diffProposalSets(input);
+    if (!diff.ok)
+        return sanitizeError(diff);
+    const transition = reviewKey({ sourceId: input.current.sourceId, priorObservationId: identities.value.prior, currentObservationId: identities.value.current });
+    if (!transition.ok)
+        return transition;
+    const items = [];
+    const occurrences = new Map();
+    for (const change of collectSemanticChanges(input, diff.value)) {
+        let target;
+        try {
+            target = input.claimTarget(change);
+        }
+        catch {
+            return { ok: false, error: { kind: "callback-threw", message: "claimTarget callback threw", path: "$.claimTarget" } };
+        }
+        const base = reviewKey(change);
+        if (!base.ok)
+            return base;
+        const occurrence = occurrences.get(base.value) ?? 0;
+        occurrences.set(base.value, occurrence + 1);
+        const item = projectReviewItem(change, occurrence, transition.value, identities.value, input.prior, input.current, target);
+        if (!item.ok)
+            return item;
+        items.push(item.value);
+    }
+    return { ok: true, value: { transitionId: transition.value, priorObservationId: identities.value.prior, currentObservationId: identities.value.current, items } };
+}

package/dist/src/snapshot-store.d.ts

@@ -1,2 +1,12 @@
-import type { SnapshotStore } from "@kontourai/traverse/fetch";
+import type { SnapshotStore } from "@kontourai/forage";
+import { type SnapshotSourceRefResolution } from "@kontourai/forage/fetch";
 export declare function createLookoutSnapshotStore(root?: string): SnapshotStore;
+export type ResolveLookoutSnapshotOptions = {
+    store: SnapshotStore;
+    root?: never;
+} | {
+    store?: never;
+    root?: string;
+};
+/** Replay one Lookout-emitted durable reference without any network access. */
+export declare function resolveLookoutSnapshot(reference: string, options?: ResolveLookoutSnapshotOptions): Promise<SnapshotSourceRefResolution>;

package/dist/src/snapshot-store.js

@@ -1,5 +1,22 @@
 import path from "node:path";
-import { createFilesystemSnapshotStore } from "@kontourai/traverse/fetch";
+import { createFilesystemSnapshotStore } from "@kontourai/forage";
+import { resolveSnapshotSourceRef, } from "@kontourai/forage/fetch";
 export function createLookoutSnapshotStore(root = path.join(process.cwd(), ".kontourai", "lookout", "snapshots")) {
     return createFilesystemSnapshotStore({ root });
 }
+/** Replay one Lookout-emitted durable reference without any network access. */
+export async function resolveLookoutSnapshot(reference, options = {}) {
+    try {
+        const store = options.store ?? createLookoutSnapshotStore(options.root);
+        return await resolveSnapshotSourceRef(store, reference);
+    }
+    catch {
+        return {
+            ok: false,
+            error: {
+                kind: "snapshot-store-error",
+                message: "the supplied snapshot store could not resolve the reference",
+            },
+        };
+    }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@kontourai/lookout",
-  "version": "0.3.0",
-  "description": "A small source registry and drift-check runner built on Traverse snapshots.",
+  "version": "0.3.2",
+  "description": "A small source registry and drift-check runner built on Forage snapshots.",
   "license": "Apache-2.0",
   "type": "module",
   "private": false,
@@ -44,10 +44,11 @@
   },
   "dependencies": {
     "@kontourai/datum": "0.3.0",
-    "@kontourai/forage": "0.2.0",
-    "@kontourai/traverse": "0.14.1"
+    "@kontourai/forage": "0.4.1",
+    "@kontourai/traverse": "0.18.0"
   },
   "devDependencies": {
+    "@kontourai/survey": "1.17.0",
     "@types/node": "^25.6.0",
     "typescript": "^5.8.0"
   },