@plurnk/plurnk-service 0.7.0 → 0.9.0

package/dist/core/PluginLoader.js

@@ -14,87 +14,91 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
 };
 import { readdir, readFile } from "node:fs/promises";
 import { resolve } from "node:path";
-const isValidKind = (kind) => kind === "provider" || kind === "scheme" || kind === "mimetype";
-export const discoverPlugins = async (nodeModulesDir) => {
-    const plurnkDir = resolve(nodeModulesDir, "@plurnk");
-    let entries;
-    try {
-        entries = await readdir(plurnkDir, { withFileTypes: true });
+export default class PluginLoader {
+    static #isValidKind(kind) {
+        return kind === "provider" || kind === "scheme" || kind === "mimetype";
     }
-    catch {
-        return [];
-    }
-    const discovered = [];
-    for (const entry of entries) {
-        if (!entry.isDirectory())
-            continue;
-        const packagePath = resolve(plurnkDir, entry.name);
-        const packageJsonPath = resolve(packagePath, "package.json");
-        let pkg;
+    static async discoverPlugins(nodeModulesDir) {
+        const plurnkDir = resolve(nodeModulesDir, "@plurnk");
+        let entries;
         try {
-            const content = await readFile(packageJsonPath, "utf8");
-            pkg = JSON.parse(content);
+            entries = await readdir(plurnkDir, { withFileTypes: true });
         }
         catch {
-            continue;
+            return [];
         }
-        if (typeof pkg.name !== "string")
-            continue;
-        if (pkg.plurnk === undefined || pkg.plurnk === null || typeof pkg.plurnk !== "object")
-            continue;
-        const candidate = pkg.plurnk;
-        if (!isValidKind(candidate.kind))
-            continue;
-        if (typeof candidate.name !== "string" || candidate.name.length === 0)
-            continue;
-        discovered.push({
-            packageName: pkg.name,
-            packagePath,
-            manifest: { kind: candidate.kind, name: candidate.name },
-        });
-    }
-    return discovered.toSorted((a, b) => a.packageName.localeCompare(b.packageName));
-};
-// Dynamic-import a discovered plugin's default export and instantiate it.
-// Default export MUST be a constructable class with a zero-arg constructor.
-// Identity-match enforcement per plurnk-mimetypes / plurnk-schemes manifests:
-// the instance's claimed identity MUST match the package manifest's `plurnk.name`.
-// Providers skip this check — manifest.name is a vendor identifier; the
-// instance's `model` is per-config (plurnk-providers#1, identity getters).
-export const loadPlugin = async (plugin) => {
-    const mod = await import(__rewriteRelativeImportExtension(plugin.packageName));
-    const PluginClass = mod.default;
-    if (typeof PluginClass !== "function") {
-        throw new Error(`${plugin.packageName}: default export is not a constructor`);
-    }
-    const instance = new PluginClass();
-    assertIdentityMatch(plugin, instance);
-    return instance;
-};
-export const assertIdentityMatch = (plugin, instance) => {
-    if (plugin.manifest.kind === "mimetype") {
-        const declared = instance.mimetype;
-        if (typeof declared !== "string") {
-            throw new Error(`${plugin.packageName}: mimetype handler instance must declare a string \`mimetype\` field`);
+        const discovered = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            const packagePath = resolve(plurnkDir, entry.name);
+            const packageJsonPath = resolve(packagePath, "package.json");
+            let pkg;
+            try {
+                const content = await readFile(packageJsonPath, "utf8");
+                pkg = JSON.parse(content);
+            }
+            catch {
+                continue;
+            }
+            if (typeof pkg.name !== "string")
+                continue;
+            if (pkg.plurnk === undefined || pkg.plurnk === null || typeof pkg.plurnk !== "object")
+                continue;
+            const candidate = pkg.plurnk;
+            if (!PluginLoader.#isValidKind(candidate.kind))
+                continue;
+            if (typeof candidate.name !== "string" || candidate.name.length === 0)
+                continue;
+            discovered.push({
+                packageName: pkg.name,
+                packagePath,
+                manifest: { kind: candidate.kind, name: candidate.name },
+            });
         }
-        if (declared !== plugin.manifest.name) {
-            throw new Error(`${plugin.packageName}: identity mismatch — package manifest declares mimetype '${plugin.manifest.name}', instance declares '${declared}'`);
+        return discovered.toSorted((a, b) => a.packageName.localeCompare(b.packageName));
+    }
+    // Dynamic-import a discovered plugin's default export and instantiate it.
+    // Default export MUST be a constructable class with a zero-arg constructor.
+    // Identity-match enforcement per plurnk-mimetypes / plurnk-schemes manifests:
+    // the instance's claimed identity MUST match the package manifest's `plurnk.name`.
+    // Providers skip this check — manifest.name is a vendor identifier; the
+    // instance's `model` is per-config (plurnk-providers#1, identity getters).
+    static async loadPlugin(plugin) {
+        const mod = await import(__rewriteRelativeImportExtension(plugin.packageName));
+        const PluginClass = mod.default;
+        if (typeof PluginClass !== "function") {
+            throw new Error(`${plugin.packageName}: default export is not a constructor`);
         }
-        return;
+        const instance = new PluginClass();
+        PluginLoader.assertIdentityMatch(plugin, instance);
+        return instance;
     }
-    if (plugin.manifest.kind === "scheme") {
-        // Schemes carry a static `manifest` on the class (plurnk-schemes contract).
-        // Transitional: bundled schemes don't yet have it (task #32 wires
-        // manifest registration). When the static manifest is absent, accept
-        // the package manifest name as the source of truth and trust the caller.
-        const classManifest = instance.constructor;
-        const declared = classManifest?.manifest?.name;
-        if (declared !== undefined && declared !== plugin.manifest.name) {
-            throw new Error(`${plugin.packageName}: identity mismatch — package manifest declares scheme '${plugin.manifest.name}', class manifest declares '${String(declared)}'`);
+    static assertIdentityMatch(plugin, instance) {
+        if (plugin.manifest.kind === "mimetype") {
+            const declared = instance.mimetype;
+            if (typeof declared !== "string") {
+                throw new Error(`${plugin.packageName}: mimetype handler instance must declare a string \`mimetype\` field`);
+            }
+            if (declared !== plugin.manifest.name) {
+                throw new Error(`${plugin.packageName}: identity mismatch — package manifest declares mimetype '${plugin.manifest.name}', instance declares '${declared}'`);
+            }
+            return;
         }
-        return;
+        if (plugin.manifest.kind === "scheme") {
+            // Schemes carry a static `manifest` on the class (plurnk-schemes contract).
+            // Transitional: bundled schemes don't yet have it (task #32 wires
+            // manifest registration). When the static manifest is absent, accept
+            // the package manifest name as the source of truth and trust the caller.
+            const classManifest = instance.constructor;
+            const declared = classManifest?.manifest?.name;
+            if (declared !== undefined && declared !== plugin.manifest.name) {
+                throw new Error(`${plugin.packageName}: identity mismatch — package manifest declares scheme '${plugin.manifest.name}', class manifest declares '${String(declared)}'`);
+            }
+            return;
+        }
+        // Providers: no identity-match at this layer. Package manifest `name` is
+        // the vendor family; instance `model` is per-config (plurnk-providers#1).
     }
-    // Providers: no identity-match at this layer. Package manifest `name` is
-    // the vendor family; instance `model` is per-config (plurnk-providers#1).
-};
+}
 //# sourceMappingURL=PluginLoader.js.map

package/dist/core/PluginLoader.js.map

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

package/dist/core/ProviderInstantiate.d.ts

@@ -1,4 +1,6 @@
 import type { Provider, ProviderAlias } from "@plurnk/plurnk-providers";
-export declare const instantiateProvider: (alias: ProviderAlias, env?: NodeJS.ProcessEnv) => Promise<Provider>;
-export declare const loadActiveProvider: (env?: NodeJS.ProcessEnv) => Promise<Provider | null>;
+export default class ProviderInstantiate {
+    static instantiateProvider(alias: ProviderAlias, env?: NodeJS.ProcessEnv): Promise<Provider>;
+    static loadActiveProvider(env?: NodeJS.ProcessEnv): Promise<Provider | null>;
+}
 //# sourceMappingURL=ProviderInstantiate.d.ts.map

package/dist/core/ProviderInstantiate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ProviderInstantiate.d.ts","sourceRoot":"","sources":["../../src/core/ProviderInstantiate.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAmB,MAAM,0BAA0B,CAAC;AAEzF,eAAO,MAAM,mBAAmB,GAAU,OAAO,aAAa,EAAE,MAAK,MAAM,CAAC,UAAwB,KAAG,OAAO,CAAC,QAAQ,CAkBtH,CAAC;AAIF,eAAO,MAAM,kBAAkB,GAAU,MAAK,MAAM,CAAC,UAAwB,KAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAItG,CAAC"}
+{"version":3,"file":"ProviderInstantiate.d.ts","sourceRoot":"","sources":["../../src/core/ProviderInstantiate.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,QAAQ,EAAE,aAAa,EAAmB,MAAM,0BAA0B,CAAC;AAEzF,MAAM,CAAC,OAAO,OAAO,mBAAmB;WACvB,mBAAmB,CAAC,KAAK,EAAE,aAAa,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,QAAQ,CAAC;WAmBlG,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;CAKlG"}

package/dist/core/ProviderInstantiate.js

@@ -14,28 +14,29 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
     return path;
 };
 import { resolveActiveAlias } from "@plurnk/plurnk-providers";
-export const instantiateProvider = async (alias, env = process.env) => {
-    const packageName = `@plurnk/plurnk-providers-${alias.provider}`;
-    let mod;
-    try {
-        mod = await import(__rewriteRelativeImportExtension(packageName));
+export default class ProviderInstantiate {
+    static async instantiateProvider(alias, env = process.env) {
+        const packageName = `@plurnk/plurnk-providers-${alias.provider}`;
+        let mod;
+        try {
+            mod = await import(__rewriteRelativeImportExtension(packageName));
+        }
+        catch (cause) {
+            throw new Error(`provider package ${packageName} not installed (alias '${alias.alias}' requires it)`, { cause });
+        }
+        const factory = mod.default;
+        if (typeof factory?.fromEnv !== "function") {
+            throw new Error(`${packageName}: default export must have a static \`fromEnv(env, model)\` factory`);
+        }
+        return await factory.fromEnv(env, alias.model);
     }
-    catch (cause) {
-        throw new Error(`provider package ${packageName} not installed (alias '${alias.alias}' requires it): ` +
-            (cause instanceof Error ? cause.message : String(cause)));
+    // Convenience: resolve + instantiate in one call. Returns null when no
+    // PLURNK_MODEL is set (caller decides what 'no provider' means).
+    static async loadActiveProvider(env = process.env) {
+        const alias = resolveActiveAlias(env);
+        if (alias === null)
+            return null;
+        return ProviderInstantiate.instantiateProvider(alias, env);
     }
-    const factory = mod.default;
-    if (typeof factory?.fromEnv !== "function") {
-        throw new Error(`${packageName}: default export must have a static \`fromEnv(env, model)\` factory`);
-    }
-    return await factory.fromEnv(env, alias.model);
-};
-// Convenience: resolve + instantiate in one call. Returns null when no
-// PLURNK_MODEL is set (caller decides what 'no provider' means).
-export const loadActiveProvider = async (env = process.env) => {
-    const alias = resolveActiveAlias(env);
-    if (alias === null)
-        return null;
-    return instantiateProvider(alias, env);
-};
+}
 //# sourceMappingURL=ProviderInstantiate.js.map

package/dist/core/ProviderInstantiate.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProviderInstantiate.js","sourceRoot":"","sources":["../../src/core/ProviderInstantiate.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,wEAAwE;AACxE,uEAAuE;AACvE,uEAAuE;AACvE,EAAE;AACF,qEAAqE;AACrE,2DAA2D;;;;;;;;;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAE,KAAoB,EAAE,MAAyB,OAAO,CAAC,GAAG,EAAqB,EAAE;IACvH,MAAM,WAAW,GAAG,4BAA4B,KAAK,CAAC,QAAQ,EAAE,CAAC;IACjE,IAAI,GAAiC,CAAC;IACtC,IAAI,CAAC;QACD,GAAG,GAAG,MAAM,MAAM,kCAAC,WAAW,EAAC,CAAC;IACpC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACX,oBAAoB,WAAW,0BAA0B,KAAK,CAAC,KAAK,kBAAkB;YACtF,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC3D,CAAC;IACN,CAAC;IACD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;IAC5B,IAAI,OAAO,OAAO,EAAE,OAAO,KAAK,UAAU,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACX,GAAG,WAAW,qEAAqE,CACtF,CAAC;IACN,CAAC;IACD,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;AACnD,CAAC,CAAC;AAEF,uEAAuE;AACvE,iEAAiE;AACjE,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,MAAyB,OAAO,CAAC,GAAG,EAA4B,EAAE;IACvG,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACtC,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC3C,CAAC,CAAC"}
+{"version":3,"file":"ProviderInstantiate.js","sourceRoot":"","sources":["../../src/core/ProviderInstantiate.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,wEAAwE;AACxE,uEAAuE;AACvE,uEAAuE;AACvE,EAAE;AACF,qEAAqE;AACrE,2DAA2D;;;;;;;;;AAE3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAG9D,MAAM,CAAC,OAAO,OAAO,mBAAmB;IACpC,MAAM,CAAC,KAAK,CAAC,mBAAmB,CAAC,KAAoB,EAAE,MAAyB,OAAO,CAAC,GAAG;QACvF,MAAM,WAAW,GAAG,4BAA4B,KAAK,CAAC,QAAQ,EAAE,CAAC;QACjE,IAAI,GAAiC,CAAC;QACtC,IAAI,CAAC;YACD,GAAG,GAAG,MAAM,MAAM,kCAAC,WAAW,EAAC,CAAC;QACpC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,oBAAoB,WAAW,0BAA0B,KAAK,CAAC,KAAK,gBAAgB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACrH,CAAC;QACD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;QAC5B,IAAI,OAAO,OAAO,EAAE,OAAO,KAAK,UAAU,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CACX,GAAG,WAAW,qEAAqE,CACtF,CAAC;QACN,CAAC;QACD,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC;IAED,uEAAuE;IACvE,iEAAiE;IACjE,MAAM,CAAC,KAAK,CAAC,kBAAkB,CAAC,MAAyB,OAAO,CAAC,GAAG;QAChE,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,KAAK,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAChC,OAAO,mBAAmB,CAAC,mBAAmB,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAC/D,CAAC;CACJ"}

package/dist/core/SchemeRegistry.d.ts

@@ -1,4 +1,4 @@
-import type { LoopFlags } from "@plurnk/plurnk-schemes";
+import type { LoopFlags } from "./types.ts";
 type SchemeHandler = object;
 export default class SchemeRegistry {
     #private;

package/dist/core/SchemeRegistry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SchemeRegistry.d.ts","sourceRoot":"","sources":["../../src/core/SchemeRegistry.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,KAAK,aAAa,GAAG,MAAM,CAAC;AAE5B,MAAM,CAAC,OAAO,OAAO,cAAc;;;IAa/B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAKpD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAE5C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAE1B,IAAI,IAAI,MAAM,EAAE;IAIhB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC;CAGhD"}
+{"version":3,"file":"SchemeRegistry.d.ts","sourceRoot":"","sources":["../../src/core/SchemeRegistry.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,KAAK,aAAa,GAAG,MAAM,CAAC;AAE5B,MAAM,CAAC,OAAO,OAAO,cAAc;;;IAa/B,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,IAAI;IAKpD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAE5C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAE1B,IAAI,IAAI,MAAM,EAAE;IAIhB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC;CAGhD"}

package/dist/core/SchemeRegistry.js

@@ -5,7 +5,7 @@ import Known from "../schemes/Known.js";
 import Unknown from "../schemes/Unknown.js";
 import Skill from "../schemes/Skill.js";
 import File from "../schemes/File.js";
-import { resolveForLoop } from "@plurnk/plurnk-schemes";
+import ResolveForLoop from "./resolveForLoop.js";
 export default class SchemeRegistry {
     #handlers = new Map();
     constructor() {
@@ -26,9 +26,9 @@ export default class SchemeRegistry {
     has(name) { return this.#handlers.has(name); }
     list() { return [...this.#handlers.keys()].toSorted(); }
     // Active set under the given loop flags (SPEC §0.5). Delegates to
-    // plurnk-schemes' resolveForLoop utility.
+    // the in-tree ResolveForLoop utility.
     resolveForLoop(flags) {
-        return resolveForLoop(this.#handlers, flags);
+        return ResolveForLoop.resolveForLoop(this.#handlers, flags);
     }
 }
 //# sourceMappingURL=SchemeRegistry.js.map

package/dist/core/SchemeRegistry.js.map

@@ -1 +1 @@
-{"version":3,"file":"SchemeRegistry.js","sourceRoot":"","sources":["../../src/core/SchemeRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,sBAAsB,CAAC;AAC1C,OAAO,GAAG,MAAM,mBAAmB,CAAC;AACpC,OAAO,IAAI,MAAM,oBAAoB,CAAC;AACtC,OAAO,KAAK,MAAM,qBAAqB,CAAC;AACxC,OAAO,OAAO,MAAM,uBAAuB,CAAC;AAC5C,OAAO,KAAK,MAAM,qBAAqB,CAAC;AACxC,OAAO,IAAI,MAAM,oBAAoB,CAAC;AACtC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAKxD,MAAM,CAAC,OAAO,OAAO,cAAc;IAC/B,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE7C;QACI,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAG,IAAI,MAAM,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAM,IAAI,GAAG,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAK,IAAI,IAAI,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAI,IAAI,KAAK,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,OAAO,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAI,IAAI,KAAK,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAK,IAAI,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,OAAsB;QACzC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,yBAAyB,CAAC,CAAC;QACxF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,GAAG,CAAC,IAAY,IAA+B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEjF,GAAG,CAAC,IAAY,IAAa,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE/D,IAAI,KAAe,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAElE,kEAAkE;IAClE,0CAA0C;IAC1C,cAAc,CAAC,KAAgB;QAC3B,OAAO,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;CACJ"}
+{"version":3,"file":"SchemeRegistry.js","sourceRoot":"","sources":["../../src/core/SchemeRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,sBAAsB,CAAC;AAC1C,OAAO,GAAG,MAAM,mBAAmB,CAAC;AACpC,OAAO,IAAI,MAAM,oBAAoB,CAAC;AACtC,OAAO,KAAK,MAAM,qBAAqB,CAAC;AACxC,OAAO,OAAO,MAAM,uBAAuB,CAAC;AAC5C,OAAO,KAAK,MAAM,qBAAqB,CAAC;AACxC,OAAO,IAAI,MAAM,oBAAoB,CAAC;AACtC,OAAO,cAAc,MAAM,qBAAqB,CAAC;AAKjD,MAAM,CAAC,OAAO,OAAO,cAAc;IAC/B,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE7C;QACI,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAG,IAAI,MAAM,EAAE,CAAC,CAAC;QACvC,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAM,IAAI,GAAG,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAK,IAAI,IAAI,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAI,IAAI,KAAK,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,IAAI,OAAO,EAAE,CAAC,CAAC;QACxC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAI,IAAI,KAAK,EAAE,CAAC,CAAC;QACtC,IAAI,CAAC,QAAQ,CAAC,MAAM,EAAK,IAAI,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,QAAQ,CAAC,IAAY,EAAE,OAAsB;QACzC,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,yBAAyB,CAAC,CAAC;QACxF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IAED,GAAG,CAAC,IAAY,IAA+B,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEjF,GAAG,CAAC,IAAY,IAAa,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAE/D,IAAI,KAAe,OAAO,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAElE,kEAAkE;IAClE,sCAAsC;IACtC,cAAc,CAAC,KAAgB;QAC3B,OAAO,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IAChE,CAAC;CACJ"}

package/dist/core/git-membership.d.ts

@@ -0,0 +1,8 @@
+import type { Db } from "./Db.ts";
+import type { PlurnkSchemeContext } from "./scheme-types.ts";
+export default class GitMembership {
+    #private;
+    static resolveGitMembership(db: Db, sessionId: number, signal: AbortSignal | undefined): Promise<string[]>;
+    static indexGitMembership(ctx: PlurnkSchemeContext): Promise<void>;
+}
+//# sourceMappingURL=git-membership.d.ts.map

package/dist/core/git-membership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-membership.d.ts","sourceRoot":"","sources":["../../src/core/git-membership.ts"],"names":[],"mappings":"AA6BA,OAAO,KAAK,EAAE,EAAE,EAAc,MAAM,SAAS,CAAC;AAC9C,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAG7D,MAAM,CAAC,OAAO,OAAO,aAAa;;WAiDjB,oBAAoB,CAC7B,EAAE,EAAE,EAAE,EACN,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,GAAG,SAAS,GAChC,OAAO,CAAC,MAAM,EAAE,CAAC;WA2CP,kBAAkB,CAAC,GAAG,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;CAQ3E"}

package/dist/core/git-membership.js

@@ -0,0 +1,125 @@
+// SPEC §14.3 D4 — git-ls-files workspace membership.
+//
+// When a session's `project_root` is a git working tree, the git-tracked
+// files (`git ls-files`) are workspace MEMBERS without any explicit client
+// `add`. This module resolves that membership and (when token accounting is
+// available) materializes active members' disk content into a body channel +
+// visibility so they surface in packet.system.index.
+//
+// Decisions realized here:
+//   D1 — workspace identity lives on the session (project_root).
+//   D3 — disk co-location: members are channel-less markers until materialized;
+//        disk stays the truth.
+//   D4 — git present → ls-files membership. git absent → no fs-walk (this
+//        module no-ops on a non-git project_root, leaving headless / non-git
+//        sessions completely unaffected). The add/ignore/read-only constraint
+//        overlay (session_constraints) is a documented follow-up — not built
+//        here; bare git-ls-files membership is the whole of this phase.
+//   D5 — EMI is eager + relevance-bounded: materialize is re-read from disk at
+//        resolution time so a divergent member reflects current disk content.
+//
+// git resolution shells out via node:child_process (the same surface the
+// File scheme's tests and the demo fixture use) and respects AbortSignal.
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { MimetypeBinary } from "../content/index.js";
+import EntryCrud from "../schemes/_entry-crud.js";
+export default class GitMembership {
+    static #execFileP = promisify(execFile);
+    // project_root for a session. NULL = headless (no membership). Read once per
+    // resolution; the File scheme reads the same column for its own root.
+    static async #loadSessionRoot(db, sessionId) {
+        const row = await db.envelope_get_session.get({ id: sessionId });
+        return row?.project_root ?? null;
+    }
+    // Is `root` the top of a git working tree? `git rev-parse --is-inside-work-tree`
+    // exits non-zero (throws here) when `root` is not under git — the gate that
+    // keeps non-git / headless sessions out of any git path (D4: "git absent → no
+    // fs-walk"). Conservative: any git failure means "not a git workspace."
+    static async #isGitWorkTree(root, signal) {
+        try {
+            const { stdout } = await GitMembership.#execFileP("git", ["rev-parse", "--is-inside-work-tree"], { cwd: root, signal });
+            return stdout.trim() === "true";
+        }
+        catch {
+            return false;
+        }
+    }
+    // Tracked files, workspace-relative, via `git ls-files -z`. NUL-delimited so
+    // paths with spaces/newlines survive. Empty repo → [].
+    static async #gitTrackedFiles(root, signal) {
+        const { stdout } = await GitMembership.#execFileP("git", ["ls-files", "-z"], { cwd: root, signal, maxBuffer: 64 * 1024 * 1024 });
+        return stdout.split("\0").filter((p) => p.length > 0);
+    }
+    // Detect a tracked file's mimetype (mirrors File.detectFileMimetype): route
+    // through the Mimetypes service when present, normalizing the auto-text result
+    // to the text primitive (plurnk-service never auto-derives text/plain). No
+    // service → text primitive.
+    static async #detectMimetype(canonical, mimetypes) {
+        if (mimetypes !== undefined) {
+            const detected = await mimetypes.detect({ path: canonical });
+            return MimetypeBinary.normalizeAutoTextMimetype(detected);
+        }
+        return MimetypeBinary.TEXT_PRIMITIVE_MIMETYPE;
+    }
+    // Register every git-tracked file as a bare session member (scheme=null),
+    // idempotently. Channel-less — disk is the truth (D3); the row is the
+    // membership marker File.read gates on. Returns the tracked pathnames so the
+    // caller can materialize them through writeEntry.
+    //
+    // signal-respecting: the git shell-outs honor `signal`; on a non-git or
+    // headless root nothing is touched.
+    static async resolveGitMembership(db, sessionId, signal) {
+        const root = await GitMembership.#loadSessionRoot(db, sessionId);
+        if (root === null)
+            return [];
+        if (!await GitMembership.#isGitWorkTree(root, signal))
+            return [];
+        const tracked = await GitMembership.#gitTrackedFiles(root, signal);
+        for (const pathname of tracked) {
+            await db.crud_register_session_member.get({ session_id: sessionId, scheme: null, pathname });
+        }
+        return tracked;
+    }
+    // Materialize a member's disk content into a body channel + visibility for the
+    // run via writeEntry (the entry-write paradigm) — so it surfaces in
+    // packet.system.index (D4/D5). Re-reads disk each call (eager + relevance-
+    // bounded). Binary files are members but never materialized into a text
+    // channel. Missing-on-disk (tracked but deleted in the working tree) is
+    // skipped — membership stands, no channel.
+    static async #materializeMember(pathname, root, ctx) {
+        const canonical = resolve(root, pathname);
+        const mimetype = await GitMembership.#detectMimetype(canonical, ctx.mimetypes);
+        if (MimetypeBinary.isBinaryMimetype(mimetype))
+            return;
+        let content;
+        try {
+            content = await readFile(canonical, "utf8");
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                return;
+            throw err;
+        }
+        // writeEntry finds the registered member (scheme=null) and refreshes its
+        // body channel each turn, so a member edited out-of-band reflects current
+        // disk content (D5) — tokenization + visibility flow through the paradigm.
+        await EntryCrud.writeEntry(pathname, { channels: { body: { content, mimetype } }, tags: [] }, ctx, null);
+    }
+    // Full membership + materialization pass for a run. Registers git members,
+    // then materializes each active (on-disk, non-binary) member into the index
+    // through writeEntry. Called at packet-composition time (Engine.runTurn) per
+    // D5. No-ops on headless / non-git sessions.
+    static async indexGitMembership(ctx) {
+        const root = await GitMembership.#loadSessionRoot(ctx.db, ctx.sessionId);
+        if (root === null)
+            return;
+        const tracked = await GitMembership.resolveGitMembership(ctx.db, ctx.sessionId, ctx.signal);
+        for (const pathname of tracked) {
+            await GitMembership.#materializeMember(pathname, root, ctx);
+        }
+    }
+}
+//# sourceMappingURL=git-membership.js.map

package/dist/core/git-membership.js.map

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

package/dist/core/packet-wire.d.ts

@@ -1,7 +1,48 @@
-export function renderSystemContent(system: any): string;
-export function renderUserContent(user: any): string;
-export function packetToWireMessages(packet: any): {
-    role: string;
-    content: string;
-}[];
+interface SystemSection {
+    system_definition: string;
+    persona?: unknown;
+    index?: unknown;
+    log?: unknown;
+    tokens?: number;
+}
+interface UserSection {
+    prompt?: unknown;
+    telemetry?: {
+        budget?: unknown;
+        errors?: unknown;
+    };
+    system_requirements?: unknown;
+    tokens?: number;
+}
+interface Packet {
+    system: SystemSection;
+    user: UserSection;
+}
+type CountTokens = (text: string) => number;
+export default class PacketWire {
+    #private;
+    static renderSystemContent(system: SystemSection): string;
+    static renderUserContent(user: UserSection): string;
+    static packetToWireMessages(packet: Packet): Array<{
+        role: string;
+        content: string;
+    }>;
+    static measureBudgetSections(packet: Packet, countTokens: CountTokens): {
+        index: {
+            channels: number;
+            tokens: number;
+        };
+        log: {
+            entries: number;
+            tokens: number;
+            byScheme: Array<{
+                scheme: string;
+                entries: number;
+                tokens: number;
+            }>;
+        };
+        total: number;
+    };
+}
+export {};
 //# sourceMappingURL=packet-wire.d.ts.map

package/dist/core/packet-wire.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"packet-wire.d.ts","sourceRoot":"","sources":["../../src/core/packet-wire.js"],"names":[],"mappings":"AAsBO,yDAYN;AASM,qDAgBN;AAIM;;;IAGN"}
+{"version":3,"file":"packet-wire.d.ts","sourceRoot":"","sources":["../../src/core/packet-wire.ts"],"names":[],"mappings":"AAmDA,UAAU,aAAa;IACnB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AACD,UAAU,WAAW;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,SAAS,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACnD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AACD,UAAU,MAAM;IAAG,MAAM,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,WAAW,CAAA;CAAE;AAC7D,KAAK,WAAW,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAE5C,MAAM,CAAC,OAAO,OAAO,UAAU;;IAM3B,MAAM,CAAC,mBAAmB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM;IAqBzD,MAAM,CAAC,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM;IAoBnD,MAAM,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAcrF,MAAM,CAAC,qBAAqB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG;QACpE,KAAK,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC5C,GAAG,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,KAAK,CAAC;gBAAE,MAAM,EAAE,MAAM,CAAC;gBAAC,OAAO,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAA;aAAE,CAAC,CAAA;SAAE,CAAC;QAC/G,KAAK,EAAE,MAAM,CAAC;KACjB;CA6TJ"}