@plurnk/plurnk-service 1.3.12 → 1.5.0

package/dist/schemes/_entry-crud.js

@@ -1,26 +1,36 @@
-// Shared CRUD primitives for entry-bearing schemes (Known, Unknown, Skill).
-// Per SPEC §crud — uniform read/write/delete that the engine drives for
+// Shared CRUD primitives for entry-bearing schemes.
+// Per SPEC {§crud} — uniform read/write/delete that the engine drives for
 // cross-scheme orchestration of COPY/MOVE/SEND[410].
 import { contentHash } from "../core/content-hash.js";
 import Owner from "../core/Owner.js";
+import { renderAddress } from "../core/plurnk-uri.js";
+import Results from "../core/results.js";
 export default class EntryCrud {
-    // {§entry-identity-no-null} — the identity scheme a manifest persists under. Explicit
-    // null is ILLEGAL: a NULL identity component voids the entries UNIQUE index (run59/#545).
+    // {§entry-identity-no-null} — the non-null identity scheme persisted by a manifest.
     static identityScheme(manifest) {
-        if (manifest.storedScheme === null)
-            throw new Error(manifest.name + ": storedScheme null is illegal — a NULL identity component voids the entries identity index ({§entry-identity-no-null})");
         return manifest.storedScheme ?? manifest.name;
     }
     static async readEntry(pathname, ctx, scheme, ownerId) {
         const { db, workspaceId } = ctx;
         const owner_id = ownerId ?? await Owner.commonsId(db, workspaceId);
         const entry = await db.crud_find_workspace_entry.get({ workspace_id: workspaceId, owner_id, scheme, pathname });
-        if (entry === undefined)
-            return { status: 404, entry: null };
+        if (entry === undefined) {
+            const target = renderAddress(scheme, pathname);
+            return Results.failure(`scheme:${scheme}`, "entry-not-found", 404, `No entry exists at ${target}.`, { entry: null }, { target });
+        }
         const channelRows = await db.crud_read_channels.all({ entry_id: entry.id });
         const channels = {};
         for (const row of channelRows) {
-            channels[row.name] = { content: row.content, mimetype: row.mimetype };
+            channels[row.name] = {
+                content: row.content,
+                mimetype: row.mimetype,
+                state: row.state,
+                ...(row.producer_result === null
+                    ? {}
+                    : {
+                        producerResult: Results.assertChannelProducerResult(JSON.parse(row.producer_result)),
+                    }),
+            };
         }
         const tagRows = await db.crud_read_tags.all({ entry_id: entry.id });
         const tags = tagRows.map((r) => r.tag);
@@ -35,7 +45,15 @@ export default class EntryCrud {
         let entryId;
         let created;
         if (existing === undefined) {
-            const row = await db.crud_insert_workspace_entry.get({ workspace_id: workspaceId, owner_id, scheme, pathname });
+            const row = entry.attributes === undefined
+                ? await db.crud_insert_workspace_entry.get({ workspace_id: workspaceId, owner_id, scheme, pathname })
+                : await db.crud_insert_workspace_entry_with_attributes.get({
+                    workspace_id: workspaceId,
+                    owner_id,
+                    scheme,
+                    pathname,
+                    attributes: JSON.stringify(entry.attributes),
+                });
             if (row === undefined)
                 throw new Error("writeEntry: insert returned no row");
             entryId = row.id;
@@ -44,6 +62,12 @@ export default class EntryCrud {
         else {
             entryId = existing.id;
             created = false;
+            if (entry.attributes !== undefined) {
+                await db.crud_set_entry_attributes.run({
+                    entry_id: entryId,
+                    attributes: JSON.stringify(entry.attributes),
+                });
+            }
             await db.crud_delete_channels.run({ entry_id: entryId });
             await db.crud_delete_tags.run({ entry_id: entryId });
         }
@@ -52,11 +76,15 @@ export default class EntryCrud {
         // (the exec sink), NOT here: an authored/workspace html file is DATA whose attributes are the
         // payload (a `<user email=…>` roster), and a reader-view projection would strip it.
         for (const [channelName, channelData] of Object.entries(entry.channels)) {
+            const producerResult = channelData.producerResult === undefined
+                ? null
+                : JSON.stringify(Results.assertChannelProducerResult(channelData.producerResult));
             await db.crud_write_channel.run({
                 entry_id: entryId, name: channelName, content: channelData.content, mimetype: channelData.mimetype,
-                tokens: tokenize(channelData.content), // the model-agnostic ruler stamp (§tokenomics-agnostic-ruler, §tokenomics-tokens-stored-at-write)
+                tokens: tokenize(channelData.content), // the model-agnostic ruler stamp ({§tokenomics-agnostic-ruler}, {§tokenomics-tokens-stored-at-write})
                 content_hash: contentHash(channelData.content),
                 state: channelData.state ?? "static",
+                producer_result: producerResult,
             });
         }
         for (const tag of entry.tags) {
@@ -68,11 +96,42 @@ export default class EntryCrud {
         const { db, workspaceId } = ctx;
         const owner_id = ownerId ?? await Owner.commonsId(db, workspaceId);
         const existing = await db.crud_find_workspace_entry.get({ workspace_id: workspaceId, owner_id, scheme, pathname });
-        if (existing === undefined)
-            return { status: 404 };
+        if (existing === undefined) {
+            const target = renderAddress(scheme, pathname);
+            return Results.failure(`scheme:${scheme}`, "entry-not-found", 404, `No entry exists at ${target}.`, {}, { target });
+        }
         await db.crud_delete_entry.run({ entry_id: existing.id });
         // CASCADE on entry_channels, entry_tags per FK constraints.
         return { status: 200 };
     }
+    static async deleteChannel(pathname, channel, ctx, scheme, ownerId) {
+        const { db, workspaceId } = ctx;
+        const owner_id = ownerId ?? await Owner.commonsId(db, workspaceId);
+        const existing = await db.crud_find_workspace_entry.get({
+            workspace_id: workspaceId,
+            owner_id,
+            scheme,
+            pathname,
+        });
+        if (existing === undefined) {
+            const target = renderAddress(scheme, pathname);
+            return Results.failure(`scheme:${scheme}`, "entry-not-found", 404, `No entry exists at ${target}.`, {}, { target });
+        }
+        const deleted = await db.crud_delete_channel.get({
+            entry_id: existing.id,
+            name: channel,
+        });
+        if (deleted === undefined) {
+            const target = renderAddress(scheme, pathname);
+            return Results.failure(`scheme:${scheme}`, "channel-not-found", 404, `No channel named #${channel} exists at ${target}.`, {}, {
+                target,
+                channel,
+            });
+        }
+        const remaining = await db.crud_read_channels.all({ entry_id: existing.id });
+        if (remaining.length === 0)
+            await db.crud_delete_entry.run({ entry_id: existing.id });
+        return { status: 200 };
+    }
 }
 //# sourceMappingURL=_entry-crud.js.map

package/dist/schemes/_entry-crud.js.map

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

package/dist/schemes/_entry-crud.sql

@@ -1,5 +1,5 @@
--- Entry CRUD primitives (SPEC §crud). Used by entry-bearing schemes
--- (known/unknown/skill) and the engine for cross-scheme COPY/MOVE/SEND[410].
+-- Entry CRUD primitives (SPEC {§crud}). Used by entry-bearing schemes and
+-- the engine for cross-scheme COPY/MOVE/SEND[410].
 
 -- PREP: crud_find_workspace_entry
 -- {§entry-identity-no-null} — every identity component is NOT NULL (bare/absolute paths
@@ -8,7 +8,7 @@ SELECT id FROM entries
 WHERE workspace_id = $workspace_id AND owner_id = $owner_id AND scheme = $scheme AND pathname = $pathname;
 
 -- PREP: crud_read_channels
-SELECT name, content, mimetype FROM entry_channels WHERE entry_id = $entry_id;
+SELECT name, content, mimetype, state, producer_result FROM entry_channels WHERE entry_id = $entry_id;
 
 -- PREP: crud_read_tags
 SELECT tag FROM entry_tags WHERE entry_id = $entry_id ORDER BY tag;
@@ -18,8 +18,20 @@ INSERT INTO entries (workspace_id, owner_id, scheme, pathname)
 VALUES ($workspace_id, $owner_id, $scheme, $pathname)
 RETURNING id;
 
+-- PREP: crud_insert_workspace_entry_with_attributes
+-- Core-private metadata is present at identity creation, before any channel
+-- makes the entry visible to a reader.
+INSERT INTO entries (workspace_id, owner_id, scheme, pathname, attributes)
+VALUES ($workspace_id, $owner_id, $scheme, $pathname, $attributes)
+RETURNING id;
+
+-- PREP: crud_set_entry_attributes
+-- Core-private entry metadata. Omission at the EntryCrud seam preserves the
+-- existing value; an explicit bag replaces it before channels become visible.
+UPDATE entries SET attributes = $attributes WHERE id = $entry_id;
+
 -- PREP: crud_register_workspace_member
--- Idempotent bare-membership insert (SPEC §membership D4 — git ls-files membership).
+-- Idempotent bare-membership insert (SPEC {§membership} D4 — git ls-files membership).
 -- A git-tracked file is a workspace member by virtue of being tracked; the row
 -- is the membership marker the File read-gate checks and FIND globs by path.
 -- Channel-less by design — disk stays the truth (D3). ON CONFLICT no-ops so
@@ -31,10 +43,10 @@ DO NOTHING
 RETURNING id;
 
 -- PREP: crud_get_member_sig
--- SPEC §membership-change-gated-sync — the member's last-synced disk signature
+-- SPEC {§membership-change-gated-sync} — the member's last-synced disk signature
 -- (mtime:size), read before materializing so an unchanged file short-circuits
 -- before any content read. File members store scheme='file' ({§entry-identity-no-null}).
-SELECT id, synced_sig, membership_origin FROM entries
+SELECT id, synced_sig, membership_origin, attributes FROM entries
 WHERE workspace_id = $workspace_id AND owner_id = $owner_id AND scheme = $scheme AND pathname = $pathname;
 
 -- PREP: crud_set_synced_sig
@@ -42,6 +54,12 @@ WHERE workspace_id = $workspace_id AND owner_id = $owner_id AND scheme = $scheme
 -- pass compares against it to skip an unchanged member.
 UPDATE entries SET synced_sig = $synced_sig WHERE id = $entry_id;
 
+-- PREP: crud_mark_member_absent
+-- An observed deletion keeps the Git membership marker but removes its stale
+-- readable/derived representation. `absent` distinguishes that observed state
+-- from a member that has never been synchronized.
+UPDATE entries SET synced_sig = 'absent', deep_hash = NULL WHERE id = $entry_id;
+
 -- PREP: crud_delete_channels
 DELETE FROM entry_channels WHERE entry_id = $entry_id;
 
@@ -53,9 +71,9 @@ RETURNING name;
 DELETE FROM entry_tags WHERE entry_id = $entry_id;
 
 -- PREP: crud_write_channel
--- #312 — content_hash stamped at every static write: the join key into token_counts.
-INSERT INTO entry_channels (entry_id, name, content, mimetype, tokens, content_hash, state)
-VALUES ($entry_id, $name, $content, $mimetype, $tokens, $content_hash, $state);
+-- {§tokenomics-content-hash-identity}: every static write stamps stable content identity.
+INSERT INTO entry_channels (entry_id, name, content, mimetype, tokens, content_hash, state, producer_result)
+VALUES ($entry_id, $name, $content, $mimetype, $tokens, $content_hash, $state, $producer_result);
 
 -- PREP: crud_write_tag
 INSERT OR IGNORE INTO entry_tags (entry_id, tag) VALUES ($entry_id, $tag);
@@ -75,7 +93,7 @@ SELECT id, pathname FROM entries
 WHERE workspace_id = $workspace_id AND scheme = 'file' AND membership_origin IN ('git', 'constraint');
 
 -- PREP: crud_insert_workspace_constraint
--- SPEC §membership constraint overlay — the client supersede. Idempotent per
+-- SPEC {§membership} constraint overlay — the client supersede. Idempotent per
 -- (workspace, effect, glob); effect ∈ {add, ignore, read-only}.
 INSERT OR IGNORE INTO workspace_constraints (workspace_id, effect, glob)
 VALUES ($workspace_id, $effect, $glob);

package/dist/schemes/_entry-find.d.ts

@@ -1,33 +1,64 @@
-import type { FindStatement } from "@plurnk/plurnk-grammar";
+import { type FindStatement, type RangeExtent } from "@plurnk/plurnk-contracts";
 import type { PlurnkSchemeContext, SchemeManifest } from "../core/scheme-types.ts";
 import { type CatalogEntry } from "./_entry-manifest.ts";
-export interface MatchSpan {
-    lineStart: number;
-    lineEnd: number;
-    rowStart: number;
-    rowEnd: number;
-}
+import { type SchemeResultBase } from "../core/results.ts";
+import type { MatchEvidence } from "@plurnk/plurnk-schemes";
+import { type PathScope } from "./_path-scope.ts";
 export interface Match {
     pathname: string;
-    span: MatchSpan | null;
-    path?: string;
+    matches: MatchEvidence[];
 }
-export type MatchItem = CatalogEntry & {
-    matchSpan?: MatchSpan;
-    matchPath?: string;
+export type CatalogScope = {
+    path: string;
+    items: number;
+    tokens: number;
+    channels?: never;
+    matchLocationCount?: never;
+    locator?: never;
+    region?: never;
+};
+export type CatalogMatch = CatalogEntry & {
+    matchLocationCount?: number;
+    items?: never;
+    tokens?: never;
+    locator?: never;
+    region?: never;
+};
+export type MatchLocation = MatchEvidence & {
+    path?: never;
+    channels?: never;
+    items?: never;
+    tokens?: never;
+    matchLocationCount?: never;
 };
-export interface FindResult {
-    status: number;
+export type MatchItem = CatalogMatch | CatalogScope | MatchLocation;
+export declare const findItemTokens: (item: CatalogMatch | CatalogScope) => number;
+export interface FindFields {
+    readonly [field: string]: unknown;
     content: string | null;
     mimetype: string | null;
     results: MatchItem[];
     itemsTokenTotal: number;
-    pathnames: string[];
-    matches: Match[];
-    overflow?: number;
+    returnedItemsTokenTotal: number;
+    matchingPathCount: number;
+    matchLocationCount: number;
+    range?: RangeExtent;
+}
+export interface FindResult extends SchemeResultBase, FindFields {
+}
+export interface FindProjectionResource {
+    readonly item: CatalogMatch;
+    readonly match: Match;
+}
+interface FindAddress {
+    readonly ownerId?: number;
+    readonly pathname?: string;
 }
+export declare const emptyFindFields: () => FindFields;
+export declare const projectFindResult: (statement: FindStatement, scope: PathScope, resources: readonly FindProjectionResource[], scopes?: readonly CatalogScope[]) => FindResult;
 export default class EntryFind {
     #private;
-    static findWorkspaceEntries(statement: FindStatement, ctx: PlurnkSchemeContext, manifest: SchemeManifest, explicitOwnerId?: number): Promise<FindResult>;
+    static findWorkspaceEntries(statement: FindStatement, ctx: PlurnkSchemeContext, manifest: SchemeManifest, address?: FindAddress): Promise<FindResult>;
 }
+export {};
 //# sourceMappingURL=_entry-find.d.ts.map

package/dist/schemes/_entry-find.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"_entry-find.d.ts","sourceRoot":"","sources":["../../src/schemes/_entry-find.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAKnF,OAAsB,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAWxE,MAAM,WAAW,SAAS;IAAG,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;CAAE;AAGpG,MAAM,WAAW,KAAK;IAAG,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,GAAG,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CAAE;AAEnF,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG;IAAE,SAAS,CAAC,EAAE,SAAS,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAErF,MAAM,WAAW,UAAU;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,OAAO,EAAE,KAAK,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,CAAC,OAAO,OAAO,SAAS;;IAwN1B,OAAa,oBAAoB,CAAC,SAAS,EAAE,aAAa,EAAE,GAAG,EAAE,mBAAmB,EAAE,QAAQ,EAAE,cAAc,EAAE,eAAe,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAmD7J;CACJ"}
+{"version":3,"file":"_entry-find.d.ts","sourceRoot":"","sources":["../../src/schemes/_entry-find.ts"],"names":[],"mappings":"AAcA,OAAO,EAA6C,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE3H,OAAO,KAAK,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAMnF,OAAsB,EAAE,KAAK,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAGxE,OAAgB,EAAuB,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACzF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAE5D,OAAO,EAAoD,KAAK,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAEpG,MAAM,WAAW,KAAK;IAAG,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,aAAa,EAAE,CAAC;CAAE;AACtE,MAAM,MAAM,YAAY,GAAG;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,kBAAkB,CAAC,EAAE,KAAK,CAAC;IAC3B,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,MAAM,CAAC,EAAE,KAAK,CAAC;CAClB,CAAC;AACF,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG;IACtC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,OAAO,CAAC,EAAE,KAAK,CAAC;IAChB,MAAM,CAAC,EAAE,KAAK,CAAC;CAClB,CAAC;AACF,MAAM,MAAM,aAAa,GAAG,aAAa,GAAG;IACxC,IAAI,CAAC,EAAE,KAAK,CAAC;IACb,QAAQ,CAAC,EAAE,KAAK,CAAC;IACjB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,MAAM,CAAC,EAAE,KAAK,CAAC;IACf,kBAAkB,CAAC,EAAE,KAAK,CAAC;CAC9B,CAAC;AACF,MAAM,MAAM,SAAS,GAAG,YAAY,GAAG,YAAY,GAAG,aAAa,CAAC;AAEpE,eAAO,MAAM,cAAc,SAAU,YAAY,GAAG,YAAY,KAAG,MAElD,CAAC;AAElB,MAAM,WAAW,UAAU;IACvB,QAAQ,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAClC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,uBAAuB,EAAE,MAAM,CAAC;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,WAAW,CAAC;CACvB;AAED,MAAM,WAAW,UAAW,SAAQ,gBAAgB,EAAE,UAAU;CAAG;AAEnE,MAAM,WAAW,sBAAsB;IACnC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;CACzB;AAED,UAAU,WAAW;IACjB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,eAAO,MAAM,eAAe,QAAO,UAQjC,CAAC;AAiBH,eAAO,MAAM,iBAAiB,cACf,aAAa,SACjB,SAAS,aACL,SAAS,sBAAsB,EAAE,WACpC,SAAS,YAAY,EAAE,KAChC,UAwEF,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,SAAS;;IA2S1B,OAAa,oBAAoB,CAC7B,SAAS,EAAE,aAAa,EACxB,GAAG,EAAE,mBAAmB,EACxB,QAAQ,EAAE,cAAc,EACxB,OAAO,GAAE,WAAgB,GAC1B,OAAO,CAAC,UAAU,CAAC,CAkFrB;CACJ"}