@awebai/oats 0.25.1 → 0.25.3

package/lib/materialize.mjs

@@ -571,6 +571,35 @@ export function driftOf(instanceJson, discovery, { lock } = {}) {
   return rows;
 }
 
+/**
+ * soulDriftOf(instanceJson, discovery)
+ * → { name, repoKey, commit, current: { commit } | null, status: "current"|"moved"|"missing", reason? } | null
+ *
+ * Decision 17 for the SOUL SOURCE: a workspace spawn records `instance.json.workspace.soul =
+ * { repoKey, commit, team }` (the member and commit the soul was fetched from). The member row
+ * for `repoKey` in `discovery.members` is the current state: a different commit → "moved", the
+ * soul gone from the member → "missing" (reason "soul-absent"), no usable row → "missing"
+ * (reason "unconfirmed" / the row's reason). A standalone view's own member row is unconfirmed
+ * by construction (reason "cannot-read") yet carries the repo's current commit — it is compared,
+ * not reported missing. Returns null for a home without a recorded workspace soul (classic).
+ */
+export function soulDriftOf(instanceJson, discovery) {
+  const soul = plainObject(instanceJson?.workspace) && plainObject(instanceJson.workspace.soul) ? instanceJson.workspace.soul : null;
+  if (!soul || typeof soul.repoKey !== "string") return null;
+  const name = typeof instanceJson.agent === "string" ? instanceJson.agent : (typeof instanceJson.soul === "string" ? instanceJson.soul : null);
+  const commit = typeof soul.commit === "string" ? soul.commit : null;
+  const members = Array.isArray(discovery?.members) ? discovery.members : [];
+  const member = members.find((m) => m && m.key === soul.repoKey) || null;
+  const standaloneOwn = discovery?.standalone === true && member && member.key === discovery.key && typeof member.commit === "string";
+  const base = { name, repoKey: soul.repoKey, commit, team: soul.team ?? null };
+  if (!member || (!member.confirmed && !standaloneOwn) || typeof member.commit !== "string") {
+    return { ...base, current: null, status: "missing", reason: member ? (member.reason || "unconfirmed") : "unconfirmed" };
+  }
+  const present = name === null || (Array.isArray(member.souls) && member.souls.some((s) => s && s.name === name));
+  if (!present) return { ...base, current: { commit: member.commit }, status: "missing", reason: "soul-absent" };
+  return { ...base, current: { commit: member.commit }, status: member.commit === commit ? "current" : "moved" };
+}
+
 /** Read the modules recorded in an instance home (→ {} when absent). */
 export function recordedModules(home) {
   const file = join(resolve(home), "instance.json");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@awebai/oats",
-  "version": "0.25.1",
+  "version": "0.25.3",
   "description": "OATS (Open Agent Team Specification) — durable souls, disposable instances, targetable capability packages, and the runtime-neutral oats CLI/kernel.",
   "keywords": [
     "agents",