@plurnk/plurnk-service 0.25.0 → 0.27.0

package/dist/server/methods/run_fork.js

@@ -0,0 +1,42 @@
+// run.fork — branch a run's log into a new run in the same session (#228). Wraps
+// Fork.fork: deep-copies loops/turns/entries (fold-state + attribution intact)
+// into a parent_run_id-lineaged branch that SHARES the session's world (entries +
+// overlay), copying nothing of it. Defaults to the session's model run (the
+// conversation); the conversation client (e.g. :AI????) forks it, then reads the
+// branch via log.read({runId}).
+import Fork from "../../core/fork.js";
+export default class RunForkMethod {
+    static register(registry) {
+        registry.registerMethod("run.fork", {
+            handler: async (params, ctx) => {
+                if (ctx.session === null)
+                    throw new Error("run.fork requires an attached session");
+                const p = params;
+                let runId = p.runId;
+                if (runId === undefined) {
+                    if (ctx.session.modelRunId === null)
+                        throw new Error("run.fork: no model run to fork — start one with loop.run, or pass runId");
+                    runId = ctx.session.modelRunId;
+                }
+                else {
+                    if (typeof runId !== "number" || !Number.isInteger(runId))
+                        throw new Error("run.fork: runId must be an integer");
+                    const owner = await ctx.db.envelope_get_run_by_id.get({ id: runId });
+                    if (owner === undefined)
+                        throw new Error(`run.fork: run ${runId} not found`);
+                    if (owner.session_id !== ctx.session.sessionId)
+                        throw new Error(`run.fork: run ${runId} is not in this session`);
+                }
+                const branchRunId = await Fork.fork(ctx.db, runId);
+                const branch = await ctx.db.envelope_get_run_by_id.get({ id: branchRunId });
+                return { runId: branchRunId, runName: branch?.name ?? null, parentRunId: runId };
+            },
+            description: "Fork a run — branch its log into a new run in the same session (parent_run_id lineage), sharing the session's world (entries + overlay), copying nothing of it. Defaults to the session's model run (the conversation); an explicit runId forks any run in the session (ownership-checked). Returns the new run's {runId, runName}; a conversation client reads it via log.read({runId}). §machine-processes / #228.",
+            params: {
+                runId: "number? — the run to fork; defaults to the session's current model run (the conversation)",
+            },
+            requiresInit: true,
+        });
+    }
+}
+//# sourceMappingURL=run_fork.js.map

package/dist/server/methods/run_fork.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run_fork.js","sourceRoot":"","sources":["../../../src/server/methods/run_fork.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,+EAA+E;AAC/E,kFAAkF;AAClF,4EAA4E;AAC5E,iFAAiF;AACjF,gCAAgC;AAIhC,OAAO,IAAI,MAAM,oBAAoB,CAAC;AAMtC,MAAM,CAAC,OAAO,OAAO,aAAa;IAC9B,MAAM,CAAC,QAAQ,CAAC,QAAwB;QACpC,QAAQ,CAAC,cAAc,CAAC,UAAU,EAAE;YAChC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;gBAC3B,IAAI,GAAG,CAAC,OAAO,KAAK,IAAI;oBAAE,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;gBACnF,MAAM,CAAC,GAAG,MAAgB,CAAC;gBAC3B,IAAI,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;gBACpB,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;oBACtB,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,IAAI;wBAAE,MAAM,IAAI,KAAK,CAAC,yEAAyE,CAAC,CAAC;oBAChI,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC;gBACnC,CAAC;qBAAM,CAAC;oBACJ,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC;wBAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;oBACjH,MAAM,KAAK,GAAG,MAAO,GAAG,CAAC,EAAE,CAAC,sBAAqC,CAAC,GAAG,CAAyB,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;oBAC7G,IAAI,KAAK,KAAK,SAAS;wBAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,YAAY,CAAC,CAAC;oBAC7E,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,CAAC,OAAO,CAAC,SAAS;wBAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,yBAAyB,CAAC,CAAC;gBACrH,CAAC;gBACD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;gBACnD,MAAM,MAAM,GAAG,MAAO,GAAG,CAAC,EAAE,CAAC,sBAAqC,CAAC,GAAG,CAAmB,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;gBAC9G,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,IAAI,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC;YACrF,CAAC;YACD,WAAW,EAAE,sZAAsZ;YACna,MAAM,EAAE;gBACJ,KAAK,EAAE,2FAA2F;aACrG;YACD,YAAY,EAAE,IAAI;SACrB,CAAC,CAAC;IACP,CAAC;CACJ"}

package/dist/server/methods/session_constraints.js

@@ -2,7 +2,7 @@ import GitMembership from "../../core/git-membership.js";
 // Client tooling for the SPEC §membership constraint overlay — the supersede over git
 // membership. `constrain`/`unconstrain` mutate session_constraints then re-resolve
 // membership so the change lands now, not next turn; `constraints` lists them.
-const EFFECTS = new Set(["add", "ignore", "read-only"]);
+const EFFECTS = new Set(["pick", "hide", "view"]);
 export default class SessionConstraintsMethod {
     static register(registry) {
         registry.registerMethod("session.constrain", {
@@ -14,9 +14,9 @@ export default class SessionConstraintsMethod {
                 await GitMembership.resolveGitMembership(ctx.db, ctx.session.sessionId, undefined);
                 return { effect, glob };
             },
-            description: "Add a workspace membership constraint (SPEC §membership overlay): `add` admits files git misses (the sole source when git is absent), `ignore` drops tracked matches, `read-only` admits a member for read but refuses edits. Takes effect immediately.",
+            description: "Add a workspace membership constraint (SPEC §membership overlay): `pick` admits files git misses (the sole source when git is absent), `hide` drops tracked matches, `view` admits a member for read but refuses edits. Takes effect immediately.",
             params: {
-                effect: "string — one of: add | ignore | read-only",
+                effect: "string — one of: pick | hide | view",
                 glob: "string — node:path glob matched against workspace-relative paths",
             },
             requiresInit: true,
@@ -30,9 +30,9 @@ export default class SessionConstraintsMethod {
                 await GitMembership.resolveGitMembership(ctx.db, ctx.session.sessionId, undefined);
                 return { effect, glob };
             },
-            description: "Remove a workspace membership constraint — the inverse of session.constrain (the `remove` verb is deleting the constraint row). Takes effect immediately.",
+            description: "Remove a workspace membership constraint — the inverse of session.constrain (the `drop` verb is deleting the constraint row). Takes effect immediately.",
             params: {
-                effect: "string — one of: add | ignore | read-only",
+                effect: "string — one of: pick | hide | view",
                 glob: "string — the glob to remove",
             },
             requiresInit: true,
@@ -52,7 +52,7 @@ export default class SessionConstraintsMethod {
     static #parse(params, method) {
         const p = params;
         if (typeof p.effect !== "string" || !EFFECTS.has(p.effect)) {
-            throw new Error(`${method}: effect must be one of add | ignore | read-only`);
+            throw new Error(`${method}: effect must be one of pick | hide | view`);
         }
         if (typeof p.glob !== "string" || p.glob.length === 0) {
             throw new Error(`${method}: glob must be a non-empty string`);

package/dist/server/methods/session_constraints.js.map

@@ -1 +1 @@
-{"version":3,"file":"session_constraints.js","sourceRoot":"","sources":["../../../src/server/methods/session_constraints.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session_constraints.js","sourceRoot":"","sources":["../../../src/server/methods/session_constraints.ts"],"names":[],"mappings":"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"}

package/dist/server/methods/session_create.d.ts

@@ -1,5 +1,6 @@
 import type MethodRegistry from "../MethodRegistry.ts";
 export default class SessionCreateMethod {
+    #private;
     static register(registry: MethodRegistry): void;
 }
 //# sourceMappingURL=session_create.d.ts.map

package/dist/server/methods/session_create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session_create.d.ts","sourceRoot":"","sources":["../../../src/server/methods/session_create.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AAGvD,MAAM,CAAC,OAAO,OAAO,mBAAmB;IACpC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;CAiDlD"}
+{"version":3,"file":"session_create.d.ts","sourceRoot":"","sources":["../../../src/server/methods/session_create.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,cAAc,MAAM,sBAAsB,CAAC;AAUvD,MAAM,CAAC,OAAO,OAAO,mBAAmB;;IACpC,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI;CA2ElD"}

package/dist/server/methods/session_create.js

@@ -1,5 +1,10 @@
 import { isAbsolute } from "node:path";
 import Envelope from "../envelope.js";
+import GitMembership from "../../core/git-membership.js";
+// #200 — membership-overlay effects, mirroring session.constrain (pick admits a
+// file git misses / the sole source when headless; hide drops a tracked match;
+// view admits a member read-only).
+const CONSTRAINT_EFFECTS = new Set(["pick", "hide", "view"]);
 export default class SessionCreateMethod {
     static register(registry) {
         registry.registerMethod("session.create", {
@@ -18,7 +23,17 @@ export default class SessionCreateMethod {
                 if (persona !== null && typeof persona !== "string") {
                     throw new Error("session.create: persona must be a string or null");
                 }
+                // #200 — seed the membership overlay atomically with the session so
+                // turn-1's manifest already reflects it (no follow-up session.constrain
+                // RPC race). Same effects/semantics as session.constrain.
+                const constraints = SessionCreateMethod.#parseConstraints(p.constraints);
                 const envelope = await Envelope.createClientEnvelope(ctx.db, { name: p.name, projectRoot, persona });
+                if (constraints.length > 0) {
+                    for (const { effect, glob } of constraints) {
+                        await ctx.db.crud_insert_session_constraint.run({ session_id: envelope.sessionId, effect, glob });
+                    }
+                    await GitMembership.resolveGitMembership(ctx.db, envelope.sessionId, undefined);
+                }
                 ctx.attachSession(envelope);
                 ctx.notify("all", "session/created", {
                     id: envelope.sessionId,
@@ -37,6 +52,7 @@ export default class SessionCreateMethod {
                 name: "string? — session name (auto-generated if omitted)",
                 projectRoot: "string? — absolute path to the client's workspace; null/omitted = headless mode (no disk side-effects on file ops)",
                 persona: "string? — session-level persona (text/markdown); cascades as: loops.persona > runs.persona > sessions.persona > PLURNK_PERSONA file",
+                constraints: "array? — [{effect, glob}] membership overlay seeded atomically at creation so turn-1's manifest is right with no follow-up RPC. effect: pick (admit a file git misses / the sole source when headless) | hide (drop a tracked match) | view (read-only). glob: node:path glob vs workspace-relative paths.",
             },
         });
         registry.registerNotification("session/created", {
@@ -49,5 +65,21 @@ export default class SessionCreateMethod {
             },
         });
     }
+    static #parseConstraints(raw) {
+        if (raw === undefined || raw === null)
+            return [];
+        if (!Array.isArray(raw))
+            throw new Error("session.create: constraints must be an array");
+        return raw.map((c, i) => {
+            const e = c;
+            if (typeof e.effect !== "string" || !CONSTRAINT_EFFECTS.has(e.effect)) {
+                throw new Error(`session.create: constraints[${i}].effect must be one of pick | hide | view`);
+            }
+            if (typeof e.glob !== "string" || e.glob.length === 0) {
+                throw new Error(`session.create: constraints[${i}].glob must be a non-empty string`);
+            }
+            return { effect: e.effect, glob: e.glob };
+        });
+    }
 }
 //# sourceMappingURL=session_create.js.map

package/dist/server/methods/session_create.js.map

@@ -1 +1 @@
-{"version":3,"file":"session_create.js","sourceRoot":"","sources":["../../../src/server/methods/session_create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,MAAM,CAAC,OAAO,OAAO,mBAAmB;IACpC,MAAM,CAAC,QAAQ,CAAC,QAAwB;QACpC,QAAQ,CAAC,cAAc,CAAC,gBAAgB,EAAE;YACtC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;gBAC3B,MAAM,CAAC,GAAG,MAAiF,CAAC;gBAC5F,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,IAAI,IAAI,CAAC;gBAC1C,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;oBACvB,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBAC9D,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;oBACtF,CAAC;oBACD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;wBAC3B,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;oBAC5E,CAAC;gBACL,CAAC;gBACD,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC;gBAClC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;oBAClD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;gBACxE,CAAC;gBACD,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;gBACrG,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;gBAC5B,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE;oBACjC,EAAE,EAAE,QAAQ,CAAC,SAAS;oBACtB,IAAI,EAAE,QAAQ,CAAC,WAAW;oBAC1B,WAAW,EAAE,QAAQ,CAAC,WAAW;oBACjC,OAAO,EAAE,QAAQ,CAAC,cAAc;iBACnC,CAAC,CAAC;gBACH,OAAO;oBACH,EAAE,EAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,WAAW;oBAClD,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO;oBAChD,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,cAAc;iBACtE,CAAC;YACN,CAAC;YACD,WAAW,EAAE,0QAA0Q;YACvR,MAAM,EAAE;gBACJ,IAAI,EAAE,oDAAoD;gBAC1D,WAAW,EAAE,oHAAoH;gBACjI,OAAO,EAAE,qIAAqI;aACjJ;SACJ,CAAC,CAAC;QAEH,QAAQ,CAAC,oBAAoB,CAAC,iBAAiB,EAAE;YAC7C,WAAW,EAAE,qEAAqE;YAClF,MAAM,EAAE;gBACJ,EAAE,EAAE,qBAAqB;gBACzB,IAAI,EAAE,uBAAuB;gBAC7B,WAAW,EAAE,mEAAmE;gBAChF,OAAO,EAAE,iFAAiF;aAC7F;SACJ,CAAC,CAAC;IACP,CAAC;CACJ"}
+{"version":3,"file":"session_create.js","sourceRoot":"","sources":["../../../src/server/methods/session_create.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAGvC,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,aAAa,MAAM,8BAA8B,CAAC;AAEzD,gFAAgF;AAChF,+EAA+E;AAC/E,mCAAmC;AACnC,MAAM,kBAAkB,GAAwB,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;AAElF,MAAM,CAAC,OAAO,OAAO,mBAAmB;IACpC,MAAM,CAAC,QAAQ,CAAC,QAAwB;QACpC,QAAQ,CAAC,cAAc,CAAC,gBAAgB,EAAE;YACtC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;gBAC3B,MAAM,CAAC,GAAG,MAAwG,CAAC;gBACnH,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,IAAI,IAAI,CAAC;gBAC1C,IAAI,WAAW,KAAK,IAAI,EAAE,CAAC;oBACvB,IAAI,OAAO,WAAW,KAAK,QAAQ,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;wBAC9D,MAAM,IAAI,KAAK,CAAC,gEAAgE,CAAC,CAAC;oBACtF,CAAC;oBACD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;wBAC3B,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;oBAC5E,CAAC;gBACL,CAAC;gBACD,MAAM,OAAO,GAAG,CAAC,CAAC,OAAO,IAAI,IAAI,CAAC;gBAClC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;oBAClD,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;gBACxE,CAAC;gBACD,oEAAoE;gBACpE,wEAAwE;gBACxE,0DAA0D;gBAC1D,MAAM,WAAW,GAAG,mBAAmB,CAAC,iBAAiB,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;gBACzE,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC,CAAC;gBACrG,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACzB,KAAK,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,WAAW,EAAE,CAAC;wBACzC,MAAO,GAAG,CAAC,EAAE,CAAC,8BAA6C,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;oBACtH,CAAC;oBACD,MAAM,aAAa,CAAC,oBAAoB,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;gBACpF,CAAC;gBACD,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;gBAC5B,GAAG,CAAC,MAAM,CAAC,KAAK,EAAE,iBAAiB,EAAE;oBACjC,EAAE,EAAE,QAAQ,CAAC,SAAS;oBACtB,IAAI,EAAE,QAAQ,CAAC,WAAW;oBAC1B,WAAW,EAAE,QAAQ,CAAC,WAAW;oBACjC,OAAO,EAAE,QAAQ,CAAC,cAAc;iBACnC,CAAC,CAAC;gBACH,OAAO;oBACH,EAAE,EAAE,QAAQ,CAAC,SAAS,EAAE,IAAI,EAAE,QAAQ,CAAC,WAAW;oBAClD,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO;oBAChD,WAAW,EAAE,QAAQ,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,CAAC,cAAc;iBACtE,CAAC;YACN,CAAC;YACD,WAAW,EAAE,0QAA0Q;YACvR,MAAM,EAAE;gBACJ,IAAI,EAAE,oDAAoD;gBAC1D,WAAW,EAAE,oHAAoH;gBACjI,OAAO,EAAE,qIAAqI;gBAC9I,WAAW,EAAE,4SAA4S;aAC5T;SACJ,CAAC,CAAC;QAEH,QAAQ,CAAC,oBAAoB,CAAC,iBAAiB,EAAE;YAC7C,WAAW,EAAE,qEAAqE;YAClF,MAAM,EAAE;gBACJ,EAAE,EAAE,qBAAqB;gBACzB,IAAI,EAAE,uBAAuB;gBAC7B,WAAW,EAAE,mEAAmE;gBAChF,OAAO,EAAE,iFAAiF;aAC7F;SACJ,CAAC,CAAC;IACP,CAAC;IAED,MAAM,CAAC,iBAAiB,CAAC,GAAY;QACjC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,EAAE,CAAC;QACjD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QACzF,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACpB,MAAM,CAAC,GAAG,CAAyC,CAAC;YACpD,IAAI,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,4CAA4C,CAAC,CAAC;YAClG,CAAC;YACD,IAAI,OAAO,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACpD,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,mCAAmC,CAAC,CAAC;YACzF,CAAC;YACD,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,CAAC,CAAC,CAAC;IACP,CAAC;CACJ"}

package/migrations/0000-00-00.01_schema.sql

@@ -29,6 +29,7 @@ CREATE TABLE IF NOT EXISTS runs (
     parent_run_id INTEGER          CHECK (parent_run_id IS NULL OR parent_run_id != id),
     cost_pico     INTEGER NOT NULL DEFAULT 0 CHECK (cost_pico >= 0),
     persona       TEXT,
+    origin        TEXT    NOT NULL DEFAULT 'client' CHECK (origin IN ('model', 'client', 'plurnk')),
     FOREIGN KEY (session_id)    REFERENCES sessions(id) ON DELETE CASCADE,
     FOREIGN KEY (parent_run_id) REFERENCES runs(id)     ON DELETE CASCADE
 ) STRICT;
@@ -108,6 +109,11 @@ CREATE TABLE IF NOT EXISTS entries (
     -- embeddings, later) ONLY when this differs from the current body hash — an
     -- unchanged entry is skipped, never re-metadatafied every turn.
     deep_hash TEXT,
+    -- SPEC §membership-change-gated-sync — the per-member sync stat-detect:
+    -- "<mtimeMs>:<size>" of the disk file at its last materialization. The pre-turn
+    -- sync stat()s every member but re-reads/re-tokenizes/rewrites only one whose
+    -- signature changed; an unchanged member is a no-op. NULL = never synced.
+    synced_sig TEXT,
     CHECK ((scope = 'agent'   AND session_id IS NULL)
         OR (scope = 'session' AND session_id IS NOT NULL)),
     FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE
@@ -184,18 +190,25 @@ CREATE INDEX IF NOT EXISTS symbol_refs_source ON symbol_refs (session_id, entry_
 -- hook alongside symbol_defs/refs: re-indexed only when body content changes.
 CREATE VIRTUAL TABLE IF NOT EXISTS entry_fts USING fts5(content);
 
--- INIT: entry_embeddings (~semantic vector half — plurnk-service#186)
--- One Float32 vector per entry (scalar-shaped), stored as a BLOB the cosine()
--- SqlRite function reads. Supplied by the mimetypes `embedding` projection at the
--- gated manifest-add hook (mimetypes#23); the fusion (semantic_rank) cosine-ranks
--- the FTS-narrowed candidates over these. CASCADE-deleted with the entry.
+-- INIT: entry_embeddings (~semantic vector half — plurnk-service#186; Project
+-- Semantics chunking). One Float32 vector per CHUNK: an entry tiles into N chunks,
+-- each addressed by its <L> line range (line_start..line_end) and embedded
+-- separately, so a large body is fully searchable instead of truncated at the
+-- embedder's window. line_start/line_end are stored for Project Findings to expose;
+-- the rank currently max-pools an entry's chunks to its pathname. Supplied at the
+-- gated manifest-add hook; the fusion (semantic_rank) FTS-narrows then cosine-ranks
+-- these. CASCADE-deleted with the entry.
 CREATE TABLE IF NOT EXISTS entry_embeddings (
-    entry_id        INTEGER NOT NULL PRIMARY KEY,
+    entry_id        INTEGER NOT NULL,
+    chunk_seq       INTEGER NOT NULL,
+    line_start      INTEGER NOT NULL,
+    line_end        INTEGER NOT NULL,
     vector          BLOB    NOT NULL,
-    -- The model id that produced this vector (mimetypes' `embeddingModel`, e.g.
-    -- "Xenova/all-MiniLM-L6-v2@751bff37"). Stored per row as the staleness detector:
-    -- a future model swap re-embeds rows whose model differs from the current one.
+    -- The model id that produced this vector (mimetypes' `embeddingModel`). Stored
+    -- per row as the dimension/staleness guard: rank filters by the current model so
+    -- a swap never cosine-compares mismatched dimensions.
     embedding_model TEXT    NOT NULL,
+    PRIMARY KEY (entry_id, chunk_seq),
     FOREIGN KEY (entry_id) REFERENCES entries(id) ON DELETE CASCADE
 ) STRICT;
 
@@ -206,7 +219,7 @@ CREATE TABLE IF NOT EXISTS entry_embeddings (
 -- status⊥state: status is the HTTP outcome, state is where in the
 -- lifecycle the entry sits. Most rows write 'resolved' directly;
 -- proposing schemes transition 'proposed' → resolved/failed/cancelled.
--- indexed: per-row visibility for OPEN/FOLD via the log:// scheme.
+-- indexed: per-row visibility for OPEN/FOLD via the log:/// scheme.
 CREATE TABLE IF NOT EXISTS log_entries (
     id              INTEGER NOT NULL PRIMARY KEY,
     version         INTEGER NOT NULL DEFAULT 0 CHECK (version >= 0),
@@ -388,13 +401,14 @@ CREATE INDEX IF NOT EXISTS subscriptions_opened_at ON subscriptions (opened_at);
 
 -- INIT: session_constraints
 -- SPEC §membership constraint overlay — the client's supersede over git membership.
--- Per (session, effect, glob): `add` (members git misses, resolved by a targeted
--- client-dictated scan), `ignore` (drop git-tracked matches), `read-only` (member
--- for read; File.edit rejects the write). git-absent, `add` rows are the sole
--- membership source. Composed at membership resolution; node:path.matchesGlob.
+-- Per (session, effect, glob/target): `pick` (members git misses, resolved by a
+-- targeted client-dictated scan), `hide` (drop git-tracked matches), `view` (member
+-- for read; File.edit rejects the write), `repo` (declare a git repo whose ls-files
+-- join membership, path-prefixed). git-absent, `pick` rows are the sole substrate
+-- source. Composed at membership resolution; node:path.matchesGlob.
 CREATE TABLE IF NOT EXISTS session_constraints (
     session_id INTEGER NOT NULL,
-    effect     TEXT    NOT NULL CHECK (effect IN ('add', 'ignore', 'read-only')),
+    effect     TEXT    NOT NULL CHECK (effect IN ('pick', 'hide', 'view', 'repo')),
     glob       TEXT    NOT NULL,
     PRIMARY KEY (session_id, effect, glob),
     FOREIGN KEY (session_id) REFERENCES sessions(id) ON DELETE CASCADE

package/package.json

@@ -1,114 +1,111 @@
 {
-  "name": "@plurnk/plurnk-service",
-  "version": "0.25.0",
-  "description": "Plurnk agent runtime — the server / engine / core. Implements the @plurnk/plurnk-grammar contract.",
-  "type": "module",
-  "license": "MIT",
-  "engines": {
-    "node": ">=25"
-  },
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "default": "./dist/index.js"
+    "name": "@plurnk/plurnk-service",
+    "version": "0.27.0",
+    "description": "Plurnk agent runtime — the server / engine / core. Implements the @plurnk/plurnk-grammar contract.",
+    "type": "module",
+    "license": "MIT",
+    "engines": {
+        "node": ">=25"
     },
-    "./package.json": "./package.json"
-  },
-  "bin": {
-    "plurnk-service": "./bin/plurnk-service.ts"
-  },
-  "files": [
-    "bin/plurnk-service.ts",
-    "dist/**/*",
-    "migrations/**/*.sql",
-    "persona.md",
-    "requirements.md",
-    "README.md",
-    "SPEC.md"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "start": "node bin/plurnk-service.ts",
-    "test:lint": "tsc --noEmit",
-    "test:unit": "node --env-file-if-exists=.env.example --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-timeout=30000 src/**/*.test.ts",
-    "test:intg": "npm run test:clean-tmp && node --env-file-if-exists=.env.example --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-timeout=30000 test/intg/*.test.ts",
-    "test:live": "npm run test:clean-tmp && node --env-file-if-exists=.env.example --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-concurrency=1 test/live/*.test.ts",
-    "test:demo": "npm run test:clean-tmp && node --env-file-if-exists=.env.example --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-concurrency=1 test/demo/*.test.ts",
-    "test:all": "npm run test:lint && npm run test:unit && npm run test:intg && npm run test:demo",
-    "test:digest": "node bin/digest.ts",
-    "test:clean-tmp": "rm -rf test/intg/.tmp",
-    "dev:digest": "node bin/digest.ts",
-    "build:dist": "tsc -p tsconfig.build.json",
-    "build": "npm run build:dist",
-    "prepare": "npm run build"
-  },
-  "dependencies": {
-    "@plurnk/plurnk-execs": "0.4.3",
-    "@plurnk/plurnk-execs-common": "0.2.1",
-    "@plurnk/plurnk-execs-git": "0.1.1",
-    "@plurnk/plurnk-execs-search": "0.2.3",
-    "@plurnk/plurnk-execs-sqlite": "0.1.4",
-    "@plurnk/plurnk-execs-wasm": "0.1.2",
-    "@plurnk/plurnk-grammar": "0.36.0",
-    "@plurnk/plurnk-mimetypes": "0.15.9",
-    "@plurnk/plurnk-mimetypes-embeddings": "0.1.0",
-    "@plurnk/plurnk-providers": "0.2.4",
-    "@plurnk/plurnk-schemes": "0.6.0",
-    "@plurnk/plurnk-schemes-http": "0.1.0",
-    "@possumtech/sqlrite": "5.1.1",
-    "diff": "^9.0.0",
-    "ws": "^8.20.1"
-  },
-  "devDependencies": {
-    "@plurnk/plurnk-mimetypes-application-pdf": "0.6.2",
-    "@plurnk/plurnk-mimetypes-text-clojure": "0.2.2",
-    "@plurnk/plurnk-mimetypes-text-cmake": "0.2.2",
-    "@plurnk/plurnk-mimetypes-text-common-lisp": "0.2.2",
-    "@plurnk/plurnk-mimetypes-text-csharp": "0.2.3",
-    "@plurnk/plurnk-mimetypes-text-datalog": "0.3.2",
-    "@plurnk/plurnk-mimetypes-text-erlang": "0.2.2",
-    "@plurnk/plurnk-mimetypes-text-graphql": "0.2.2",
-    "@plurnk/plurnk-mimetypes-text-mariadb": "0.3.3",
-    "@plurnk/plurnk-mimetypes-text-plsql": "0.2.3",
-    "@plurnk/plurnk-mimetypes-text-postgresql": "0.3.3",
-    "@plurnk/plurnk-mimetypes-text-prolog": "0.2.2",
-    "@plurnk/plurnk-mimetypes-text-protobuf": "0.3.2",
-    "@plurnk/plurnk-mimetypes-text-redis": "0.3.2",
-    "@plurnk/plurnk-mimetypes-text-sparql": "0.2.2",
-    "@plurnk/plurnk-mimetypes-text-sqlite": "0.3.3",
-    "@plurnk/plurnk-mimetypes-text-swift": "0.1.2",
-    "@plurnk/plurnk-mimetypes-text-terraform": "1.0.3",
-    "@plurnk/plurnk-mimetypes-text-tsql": "0.2.3",
-    "@tree-sitter-grammars/tree-sitter-kotlin": "^1.1.0",
-    "@tree-sitter-grammars/tree-sitter-lua": "^0.4.1",
-    "@tree-sitter-grammars/tree-sitter-toml": "^0.7.0",
-    "@tree-sitter-grammars/tree-sitter-yaml": "^0.7.1",
-    "@tree-sitter-grammars/tree-sitter-zig": "^1.1.2",
-    "@types/diff": "^7.0.2",
-    "@types/node": "^25.8.0",
-    "@types/ws": "^8.18.1",
-    "tree-sitter-bash": "^0.25.1",
-    "tree-sitter-c": "^0.24.1",
-    "tree-sitter-cpp": "^0.23.4",
-    "tree-sitter-dart": "^1.0.0",
-    "tree-sitter-elixir": "^0.3.5",
-    "tree-sitter-fsharp": "^0.1.0",
-    "tree-sitter-go": "^0.25.0",
-    "tree-sitter-haskell": "^0.23.1",
-    "tree-sitter-java": "^0.23.5",
-    "tree-sitter-javascript": "^0.25.0",
-    "tree-sitter-julia": "^0.23.1",
-    "tree-sitter-make": "^1.1.1",
-    "tree-sitter-ocaml": "^0.24.2",
-    "tree-sitter-odin": "^1.3.0",
-    "tree-sitter-php": "^0.24.2",
-    "tree-sitter-python": "^0.25.0",
-    "tree-sitter-ruby": "^0.23.1",
-    "tree-sitter-rust": "^0.24.0",
-    "tree-sitter-scala": "^0.24.0",
-    "tree-sitter-typescript": "^0.23.2",
-    "typescript": "^6.0.3"
-  }
+    "exports": {
+        ".": {
+            "types": "./dist/index.d.ts",
+            "default": "./dist/index.js"
+        },
+        "./package.json": "./package.json"
+    },
+    "bin": {
+        "plurnk-service": "./bin/plurnk-service.ts"
+    },
+    "files": [
+        "bin/plurnk-service.ts",
+        "dist/**/*",
+        "migrations/**/*.sql",
+        "persona.md",
+        "requirements.md",
+        "README.md",
+        "SPEC.md"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "start": "node bin/plurnk-service.ts",
+        "test:lint": "tsc --noEmit",
+        "test:unit": "node --env-file-if-exists=.env.example --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-timeout=30000 src/**/*.test.ts",
+        "test:intg": "npm run test:clean-tmp && node --env-file-if-exists=.env.example --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-timeout=30000 test/intg/*.test.ts",
+        "test:live": "npm run test:clean-tmp && node --env-file-if-exists=.env.example --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-concurrency=1 test/live/*.test.ts",
+        "test:demo": "npm run test:clean-tmp && node --env-file-if-exists=.env.example --env-file-if-exists=.env --env-file-if-exists=.env.test --test --test-concurrency=1 test/demo/*.test.ts",
+        "test:all": "npm run test:lint && npm run test:unit && npm run test:intg && npm run test:demo",
+        "test:digest": "node bin/digest.ts",
+        "test:clean-tmp": "rm -rf test/intg/.tmp",
+        "dev:digest": "node bin/digest.ts",
+        "build:dist": "tsc -p tsconfig.build.json",
+        "build": "npm run build:dist",
+        "prepare": "npm run build"
+    },
+    "dependencies": {
+        "@plurnk/plurnk-execs": "0.4.6",
+        "@plurnk/plurnk-execs-all": "0.1.5",
+        "@plurnk/plurnk-grammar": "0.41.0",
+        "@plurnk/plurnk-mimetypes": "0.15.14",
+        "@plurnk/plurnk-mimetypes-embeddings": "0.2.0",
+        "@plurnk/plurnk-providers": "0.3.0",
+        "@plurnk/plurnk-providers-all": "0.1.0",
+        "@plurnk/plurnk-schemes": "0.7.0",
+        "@plurnk/plurnk-schemes-http": "0.2.0",
+        "@possumtech/sqlrite": "5.1.1",
+        "diff": "^9.0.0",
+        "ws": "^8.20.1"
+    },
+    "devDependencies": {
+        "@plurnk/plurnk-mimetypes-application-pdf": "0.6.2",
+        "@plurnk/plurnk-mimetypes-text-clojure": "0.2.2",
+        "@plurnk/plurnk-mimetypes-text-cmake": "0.2.2",
+        "@plurnk/plurnk-mimetypes-text-common-lisp": "0.2.2",
+        "@plurnk/plurnk-mimetypes-text-csharp": "0.2.3",
+        "@plurnk/plurnk-mimetypes-text-datalog": "0.3.2",
+        "@plurnk/plurnk-mimetypes-text-erlang": "0.2.2",
+        "@plurnk/plurnk-mimetypes-text-graphql": "0.2.2",
+        "@plurnk/plurnk-mimetypes-text-mariadb": "0.3.3",
+        "@plurnk/plurnk-mimetypes-text-plsql": "0.2.3",
+        "@plurnk/plurnk-mimetypes-text-postgresql": "0.3.3",
+        "@plurnk/plurnk-mimetypes-text-prolog": "0.2.2",
+        "@plurnk/plurnk-mimetypes-text-protobuf": "0.3.2",
+        "@plurnk/plurnk-mimetypes-text-redis": "0.3.2",
+        "@plurnk/plurnk-mimetypes-text-sparql": "0.2.2",
+        "@plurnk/plurnk-mimetypes-text-sqlite": "0.3.3",
+        "@plurnk/plurnk-mimetypes-text-swift": "0.1.2",
+        "@plurnk/plurnk-mimetypes-text-terraform": "1.0.3",
+        "@plurnk/plurnk-mimetypes-text-tsql": "0.2.3",
+        "@tree-sitter-grammars/tree-sitter-kotlin": "^1.1.0",
+        "@tree-sitter-grammars/tree-sitter-lua": "^0.4.1",
+        "@tree-sitter-grammars/tree-sitter-toml": "^0.7.0",
+        "@tree-sitter-grammars/tree-sitter-yaml": "^0.7.1",
+        "@tree-sitter-grammars/tree-sitter-zig": "^1.1.2",
+        "@types/diff": "^7.0.2",
+        "@types/node": "^25.8.0",
+        "@types/ws": "^8.18.1",
+        "tree-sitter-bash": "^0.25.1",
+        "tree-sitter-c": "^0.24.1",
+        "tree-sitter-cpp": "^0.23.4",
+        "tree-sitter-dart": "^1.0.0",
+        "tree-sitter-elixir": "^0.3.5",
+        "tree-sitter-fsharp": "^0.1.0",
+        "tree-sitter-go": "^0.25.0",
+        "tree-sitter-haskell": "^0.23.1",
+        "tree-sitter-java": "^0.23.5",
+        "tree-sitter-javascript": "^0.25.0",
+        "tree-sitter-julia": "^0.23.1",
+        "tree-sitter-make": "^1.1.1",
+        "tree-sitter-ocaml": "^0.24.2",
+        "tree-sitter-odin": "^1.3.0",
+        "tree-sitter-php": "^0.24.2",
+        "tree-sitter-python": "^0.25.0",
+        "tree-sitter-ruby": "^0.23.1",
+        "tree-sitter-rust": "^0.24.0",
+        "tree-sitter-scala": "^0.24.0",
+        "tree-sitter-typescript": "^0.23.2",
+        "typescript": "^6.0.3"
+    }
 }

package/requirements.md

@@ -1,10 +1,9 @@
 Syntax: <<OPsuffix[signal]?(target)?<Line/Result>?:body?:OPsuffix
 
-YOU MUST NOT use EXEC for actions that can be performed with the other Extended HEREDOC Plurnk Operations.
+YOU MUST NOT use EXEC commands for actions that can be performed with Extended HEREDOC Plurnk Operations.
 YOU MUST ONLY communicate with SEND, not with free text between operations.
 YOU MUST document all relevant questions and uncertainties into taxonomized, tagged, and topical unknown entries.
 YOU MUST ONLY populate known entries with source entry information, never with model training.
-YOU SHOULD prefer deterministic calculations and retrievals over model training or speculation.
 YOU SHOULD manage your own context to maximize signal, as irrelevant tokens degrade reasoning.
 YOU SHOULD leverage folksonomic path names, tags, and bulk pattern operations to optimize for context relevance.
 YOU MUST use OPEN and FOLD to keep your context budget healthy, optimized, and topical, below the `tokensFree` limit.