@north-light/crouter 0.3.354 → 0.3.356

package/dist/core/graph/deletion.d.ts

@@ -1,9 +1,10 @@
 /** Deleting a node with what it owns (spec §6 "Deletion follows the owner", A9). Rows are kept
- *  with `deleted_at` so every pointer resolves to "deleted" with the last preview; a document
- *  that a kept document links to passes to the node's owner instead. */
+ *  with `deleted_at` so every pointer resolves to "deleted" with the last preview. A document a
+ *  live document outside the deletion links to is kept: it stays owned by the deleted node, under
+ *  its name and rules, and is collected when its last link goes (`collectUnlinked`). */
 import type { DatabaseSync } from 'node:sqlite';
 import type { ObjectRow } from './types.js';
-/** Mark the node and everything it owns deleted, move kept documents to the node's owner,
- *  drop the node's watches (both ends) and its `nodes` row. One savepoint, so it runs as one
+/** Mark the node and everything it owns deleted except kept documents, which stay owned by the
+ *  deleted node; drop the node's watches (both ends) and its `nodes` row. One savepoint, so it runs as one
  *  transaction or inside the caller's. Refuses a node whose managed worktree is unreconciled. */
 export declare function deleteNodeWithOwned(db: DatabaseSync, node: ObjectRow): void;

package/dist/core/graph/deletion.js

@@ -1,5 +1,5 @@
-var f=Object.defineProperty;var d=(e,o)=>f(e,"name",{value:o,configurable:!0});import{hasUnreconciledWorktree as R}from"../canvas/worktrees.js";import{deleteDocument as O}from"./documents.js";import{levelFor as a,publish as l}from"./events.js";import{getByRowid as w}from"./objects.js";import{setRulesOwner as m}from"./rules.js";let N=0;function I(e,o){if(o.type!=="node")throw new Error(`deleteNodeWithOwned: ${o.id} is a ${o.type}, not a node`);if(R(o.id))throw new Error(`refusing to delete node ${o.id}: its managed worktree is not reconciled`);const r=`graph_delete_${++N}`;e.exec(`SAVEPOINT ${r}`);try{S(e,o),e.exec(`RELEASE ${r}`)}catch(n){throw e.exec(`ROLLBACK TO ${r}`),e.exec(`RELEASE ${r}`),n}}d(I,"deleteNodeWithOwned");function S(e,o){const r=e.prepare(`WITH RECURSIVE sub(rowid) AS (
+var p=Object.defineProperty;var d=(e,o)=>p(e,"name",{value:o,configurable:!0});import{hasUnreconciledWorktree as u}from"../canvas/worktrees.js";import{deleteDocument as R}from"./documents.js";import{levelFor as s,publish as c}from"./events.js";import{getByRowid as w}from"./objects.js";let O=0;function T(e,o){if(o.type!=="node")throw new Error(`deleteNodeWithOwned: ${o.id} is a ${o.type}, not a node`);if(u(o.id))throw new Error(`refusing to delete node ${o.id}: its managed worktree is not reconciled`);const r=`graph_delete_${++O}`;e.exec(`SAVEPOINT ${r}`);try{f(e,o),e.exec(`RELEASE ${r}`)}catch(i){throw e.exec(`ROLLBACK TO ${r}`),e.exec(`RELEASE ${r}`),i}}d(T,"deleteNodeWithOwned");function f(e,o){const r=e.prepare(`WITH RECURSIVE sub(rowid) AS (
       SELECT rowid FROM objects WHERE owner = ?
       UNION SELECT o.rowid FROM objects o JOIN sub ON o.owner = sub.rowid)
-    SELECT o.* FROM objects o JOIN sub ON sub.rowid = o.rowid WHERE o.deleted_at IS NULL`).all(o.rowid),n=new Set(r.map(t=>t.rowid)),i=e.prepare(`SELECT e.src FROM edges e JOIN objects s ON s.rowid = e.src
-    WHERE e.type = 'links-to' AND e.dst = ? AND s.deleted_at IS NULL`),s=[];for(let t=!0;t;){t=!1;for(const E of r)E.type!=="document"||!n.has(E.rowid)||i.all(E.rowid).some(({src:u})=>!n.has(u))&&(n.delete(E.rowid),s.push(E),t=!0)}const p=w(e,o.owner);for(const t of s)h(e,t,p);const c=new Date().toISOString();for(const t of r)if(n.has(t.rowid)){if(t.type==="document"){O(e,null,t);continue}e.prepare("UPDATE objects SET deleted_at = ? WHERE rowid = ?").run(c,t.rowid),l(e,{event:"deleted",object:w(e,t.rowid),actor:null,level:a("deleted",void 0,t.type),attrs:{}}),e.prepare("DELETE FROM watches WHERE object = ? OR watcher = ?").run(t.rowid,t.rowid)}e.prepare("UPDATE objects SET deleted_at = ? WHERE rowid = ?").run(c,o.rowid),l(e,{event:"deleted",object:w(e,o.rowid),actor:null,level:a("deleted",void 0,"node"),attrs:{}}),e.prepare("DELETE FROM watches WHERE object = ? OR watcher = ?").run(o.rowid,o.rowid),e.prepare("DELETE FROM nodes WHERE node_id = ?").run(o.id)}d(S,"deleteInside");function h(e,o,r){const n=e.prepare("SELECT 1 FROM objects WHERE type = 'document' AND owner = ? AND name = ? AND deleted_at IS NULL");let i=o.name;for(let s=2;n.get(r.rowid,i)!==void 0;s++)i=`${o.name}-${s}`;e.prepare("UPDATE objects SET owner = ?, name = ? WHERE rowid = ?").run(r.rowid,i,o.rowid),m(e,w(e,o.rowid))}d(h,"moveToOwner");export{I as deleteNodeWithOwned};
+    SELECT o.* FROM objects o JOIN sub ON sub.rowid = o.rowid WHERE o.deleted_at IS NULL`).all(o.rowid),i=new Set(r.map(t=>t.rowid)),l=e.prepare(`SELECT e.src FROM edges e JOIN objects s ON s.rowid = e.src
+    WHERE e.type = 'links-to' AND e.dst = ? AND s.deleted_at IS NULL`);for(let t=!0;t;){t=!1;for(const n of r)n.type!=="document"||!i.has(n.rowid)||l.all(n.rowid).some(({src:a})=>!i.has(a))&&(i.delete(n.rowid),t=!0)}const E=new Date().toISOString();for(const t of r)if(i.has(t.rowid)){if(t.type==="document"){R(e,null,t);continue}e.prepare("UPDATE objects SET deleted_at = ? WHERE rowid = ?").run(E,t.rowid),c(e,{event:"deleted",object:w(e,t.rowid),actor:null,level:s("deleted",void 0,t.type),attrs:{}}),e.prepare("DELETE FROM watches WHERE object = ? OR watcher = ?").run(t.rowid,t.rowid)}e.prepare("UPDATE objects SET deleted_at = ? WHERE rowid = ?").run(E,o.rowid),c(e,{event:"deleted",object:w(e,o.rowid),actor:null,level:s("deleted",void 0,"node"),attrs:{}}),e.prepare("DELETE FROM watches WHERE object = ? OR watcher = ?").run(o.rowid,o.rowid),e.prepare("DELETE FROM nodes WHERE node_id = ?").run(o.id)}d(f,"deleteInside");export{T as deleteNodeWithOwned};

package/dist/core/graph/documents.d.ts

@@ -123,8 +123,15 @@ export declare function moveDocument(db: DatabaseSync, reader: Reader | null, do
     owner?: ObjectRow;
 }): ObjectRow;
 /** Mark the document deleted; the row stays with its last preview. Publishes `deleted`
- *  (level 8), then ends the watches on it and drops its rules. A null actor is repo sync. */
+ *  (level 8), then ends the watches on it and drops its rules. A null actor is repo sync or
+ *  node deletion. What it linked to is re-checked by {@link collectUnlinked}. */
 export declare function deleteDocument(db: DatabaseSync, reader: Reader | null, doc: ObjectRow, reposFn?: ReposFn): ObjectRow;
+/** Delete each of `targets` that is a kept document nothing links to any more: a live document
+ *  whose owner is deleted (node deletion kept it because a live document linked to it) and that
+ *  no other live document links to. Each one deleted re-checks what it linked to, so chains of
+ *  kept documents collapse; a cycle of kept documents keeps itself. Call it after a document
+ *  stops linking to `targets` — it was deleted, or an edit dropped the links. */
+export declare function collectUnlinked(db: DatabaseSync, targets: Iterable<number>, reposFn?: ReposFn): void;
 export interface ImportedRevision {
     rev_id?: string;
     body_hash: string;

package/dist/core/graph/documents.js

@@ -1,7 +1,10 @@
-var Q=Object.defineProperty;var a=(t,n)=>Q(t,"name",{value:n,configurable:!0});import{randomUUID as Z}from"node:crypto";import{CrtrError as j,notFound as y,usage as c}from"../errors.js";import{ExitCode as $}from"../../types.js";import{canChange as A,canRead as U,ownerChain as b}from"./access.js";import{bodyOf as ee,get as te,put as F}from"./bodies.js";import{recordActedOn as R,setLinks as ne}from"./edges.js";import{publish as S}from"./events.js";import{resolveName as re}from"./names.js";import{createObject as oe,getById as ie,getByRowid as f}from"./objects.js";import{replaceRules as B,setRulesOwner as se}from"./rules.js";import{recordWatch as k}from"./watches.js";function E(t){return t.class==="node"?t.node:t.class==="app"?t.app:t.person}a(E,"actorOf");let ae=0;function h(t,n){const e=`graph_doc_${++ae}`;t.exec(`SAVEPOINT ${e}`);try{const r=n();return t.exec(`RELEASE ${e}`),r}catch(r){throw t.exec(`ROLLBACK TO ${e}`),t.exec(`RELEASE ${e}`),r}}a(h,"atomic");function ue(t,n){return new j("conflict",t,$.GENERAL,n)}a(ue,"conflict");function _(t){if(t.type!=="document")throw c(`${t.type} ${t.id} is not a document`)}a(_,"assertDocument");function P(t,n){const e=b(t,n);return(e.length?e[e.length-1]:n).type}a(P,"spaceType");function I(t,n,e){if(e!=="public"&&P(t,n)==="repo")throw c(`a repo owns only public documents; ${n.name} cannot own a ${e} one`,{rule:"repo-public-only",next:"Write it as public, or give it another owner (your own documents can carry `if: {repo: <handle>}`)."})}a(I,"assertPublicInRepo");function J(t,n,e,r){if(e.trim()===""||e!==e.trim())throw c(`invalid document name ${JSON.stringify(e)}`);const o=t.prepare("SELECT id FROM objects WHERE type = 'document' AND owner = ? AND name = ? AND deleted_at IS NULL").get(n.rowid,e);if(o&&o.id!==r?.id)throw ue(`${n.name} already has a document named ${e}`,{name:e,holder:o.id})}a(J,"assertNameFree");function L(t,n,e){if(!U(t,n,e))throw y(`no document ${e.id}`)}a(L,"readable");function N(t,n,e){if(L(t,n,e),!A(t,n,e))throw new j("forbidden",`you cannot change ${e.name}`,$.GENERAL,{id:e.id})}a(N,"changeable");function K(t,n){const e=t.prepare(`SELECT p.rev_id FROM revision_parents rp JOIN revisions p ON p.rowid = rp.parent
-    WHERE rp.child = ? ORDER BY p.rev_id`).all(n.rowid);return{rowid:n.rowid,rev_id:n.rev_id,number:n.number,body_hash:n.body_hash,author:n.author===null?null:f(t,n.author)?.id??null,rationale:n.rationale,verbatim:n.verbatim===1,created_at:n.created_at,parents:e.map(r=>r.rev_id)}}a(K,"toRevision");function H(t,n){return t.prepare(`SELECT * FROM revisions r WHERE r.document = ?
-    AND NOT EXISTS (SELECT 1 FROM revision_parents p WHERE p.parent = r.rowid) ORDER BY r.number DESC, r.rev_id`).all(n.rowid).map(r=>K(t,r))}a(H,"heads");function ce(t){return t.map(n=>n.rev_id).sort().join(",")}a(ce,"headsKeyOf");function O(t,n){const e=t.prepare("SELECT * FROM documents WHERE object = ?").get(n.rowid);if(!e)throw y(`no document record for ${n.id}`);return{summary:e.summary,heads_key:e.heads_key,revision:e.revision,why_it_exists:e.why_it_exists,unlisted:e.unlisted===1,lint_ignore:e.lint_ignore_json===null?null:JSON.parse(e.lint_ignore_json),extensions:e.extensions_json===null?null:JSON.parse(e.extensions_json),source_path:e.source_path}}a(O,"documentRecord");function D(t,n,e){const r=t.prepare(`INSERT INTO revisions (document, rev_id, number, body_hash, author, rationale, verbatim, created_at)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?) RETURNING *`).get(n.rowid,e.rev_id??Z(),e.number,e.body_hash,e.author?.rowid??null,e.rationale,e.verbatim?1:0,e.created_at??new Date().toISOString()),o=t.prepare("INSERT INTO revision_parents (child, parent) VALUES (?, ?)");for(const i of e.parents)o.run(r.rowid,i);return r}a(D,"insertRevision");function pe(t){const n=new Set;for(const e of t.matchAll(/\[\[([^[\]\n]+?)\]\]/g))n.add(e[1].trim());return[...n]}a(pe,"linksIn");function G(t,n,e,r){const o=[],i=[];for(const u of pe(r)){const s=re(t,n,u);"object"in s?o.push({written_as:u,dst:s.object}):"deleted"in s?o.push({written_as:u,dst:s.deleted}):"remote"in s||i.push(u)}return ne(t,e,o),i}a(G,"setRevisionLinks");function le(t,n,e){return n.type==="node"?n.id:t.prepare(`SELECT 1 FROM objects o JOIN objects d ON d.owner = o.rowid
+var ee=Object.defineProperty;var a=(t,n)=>ee(t,"name",{value:n,configurable:!0});import{randomUUID as te}from"node:crypto";import{CrtrError as A,notFound as v,usage as c}from"../errors.js";import{ExitCode as j}from"../../types.js";import{canChange as L,canRead as U,ownerChain as ne}from"./access.js";import{bodyOf as re,get as oe,put as F}from"./bodies.js";import{recordActedOn as R,setLinks as ie}from"./edges.js";import{publish as S}from"./events.js";import{resolveName as se}from"./names.js";import{createObject as ae,getById as ue,getByRowid as w}from"./objects.js";import{replaceRules as J,setRulesOwner as ce}from"./rules.js";import{recordWatch as k}from"./watches.js";function E(t){return t.class==="node"?t.node:t.class==="app"?t.app:t.person}a(E,"actorOf");let pe=0;function h(t,n){const e=`graph_doc_${++pe}`;t.exec(`SAVEPOINT ${e}`);try{const r=n();return t.exec(`RELEASE ${e}`),r}catch(r){throw t.exec(`ROLLBACK TO ${e}`),t.exec(`RELEASE ${e}`),r}}a(h,"atomic");function le(t,n){return new A("conflict",t,j.GENERAL,n)}a(le,"conflict");function _(t){if(t.type!=="document")throw c(`${t.type} ${t.id} is not a document`)}a(_,"assertDocument");function B(t,n){const e=ne(t,n);return(e.length?e[e.length-1]:n).type}a(B,"spaceType");function I(t,n,e){if(e!=="public"&&B(t,n)==="repo")throw c(`a repo owns only public documents; ${n.name} cannot own a ${e} one`,{rule:"repo-public-only",next:"Write it as public, or give it another owner (your own documents can carry `if: {repo: <handle>}`)."})}a(I,"assertPublicInRepo");function P(t,n,e,r){if(e.trim()===""||e!==e.trim())throw c(`invalid document name ${JSON.stringify(e)}`);const o=t.prepare("SELECT id FROM objects WHERE type = 'document' AND owner = ? AND name = ? AND deleted_at IS NULL").get(n.rowid,e);if(o&&o.id!==r?.id)throw le(`${n.name} already has a document named ${e}`,{name:e,holder:o.id})}a(P,"assertNameFree");function $(t,n,e){if(!U(t,n,e))throw v(`no document ${e.id}`)}a($,"readable");function O(t,n,e){if($(t,n,e),!L(t,n,e))throw new A("forbidden",`you cannot change ${e.name}`,j.GENERAL,{id:e.id})}a(O,"changeable");function K(t,n){const e=t.prepare(`SELECT p.rev_id FROM revision_parents rp JOIN revisions p ON p.rowid = rp.parent
+    WHERE rp.child = ? ORDER BY p.rev_id`).all(n.rowid);return{rowid:n.rowid,rev_id:n.rev_id,number:n.number,body_hash:n.body_hash,author:n.author===null?null:w(t,n.author)?.id??null,rationale:n.rationale,verbatim:n.verbatim===1,created_at:n.created_at,parents:e.map(r=>r.rev_id)}}a(K,"toRevision");function H(t,n){return t.prepare(`SELECT * FROM revisions r WHERE r.document = ?
+    AND NOT EXISTS (SELECT 1 FROM revision_parents p WHERE p.parent = r.rowid) ORDER BY r.number DESC, r.rev_id`).all(n.rowid).map(r=>K(t,r))}a(H,"heads");function me(t){return t.map(n=>n.rev_id).sort().join(",")}a(me,"headsKeyOf");function D(t,n){const e=t.prepare("SELECT * FROM documents WHERE object = ?").get(n.rowid);if(!e)throw v(`no document record for ${n.id}`);return{summary:e.summary,heads_key:e.heads_key,revision:e.revision,why_it_exists:e.why_it_exists,unlisted:e.unlisted===1,lint_ignore:e.lint_ignore_json===null?null:JSON.parse(e.lint_ignore_json),extensions:e.extensions_json===null?null:JSON.parse(e.extensions_json),source_path:e.source_path}}a(D,"documentRecord");function x(t,n,e){const r=t.prepare(`INSERT INTO revisions (document, rev_id, number, body_hash, author, rationale, verbatim, created_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?) RETURNING *`).get(n.rowid,e.rev_id??te(),e.number,e.body_hash,e.author?.rowid??null,e.rationale,e.verbatim?1:0,e.created_at??new Date().toISOString()),o=t.prepare("INSERT INTO revision_parents (child, parent) VALUES (?, ?)");for(const i of e.parents)o.run(r.rowid,i);return r}a(x,"insertRevision");function de(t){const n=new Set;for(const e of t.matchAll(/\[\[([^[\]\n]+?)\]\]/g))n.add(e[1].trim());return[...n]}a(de,"linksIn");function G(t,n,e,r){const o=[],i=[];for(const u of de(r)){const s=se(t,n,u);"object"in s?o.push({written_as:u,dst:s.object}):"deleted"in s?o.push({written_as:u,dst:s.deleted}):"remote"in s||i.push(u)}return Q(t,ie(t,e,o)),i}a(G,"setRevisionLinks");function we(t,n,e){return n.type==="node"?n.id:t.prepare(`SELECT 1 FROM objects o JOIN objects d ON d.owner = o.rowid
     WHERE o.name = ? AND o.type <> ? AND o.type IN ('person','app','repo','profile')
-      AND d.type = 'document' AND d.name = ? AND d.deleted_at IS NULL LIMIT 1`).get(n.name,n.type,e)?`${n.type}:${n.name}`:n.name}a(le,"ownerPrefix");function V(t,n,e){const r=t.prepare(`SELECT e.written_as, o.* FROM edges e JOIN objects o ON o.rowid = e.dst
-    WHERE e.type = 'links-to' AND e.src = ? AND e.written_as IS NOT NULL`).all(n.rowid);if(r.length===0)return e;const o=new Map;for(const i of r){if(i.deleted_at||i.written_as===i.id)continue;const u=!i.written_as.includes("/");if(u&&i.name===i.written_as)continue;const s=i.owner===null?null:f(t,i.owner),p=s?`${le(t,s,i.name)}/${i.name}`:i.name,l=u&&i.owner===n.owner?i.name:p;l!==i.written_as&&o.set(i.written_as,l)}return o.size===0?e:e.replace(/\[\[([^[\]\n]+?)\]\]/g,(i,u)=>{const s=o.get(u.trim());return s===void 0?i:`[[${s}]]`})}a(V,"withCurrentNames");function C(t,n,e){if(e.preview!==void 0){if(e.preview.trim()==="")throw c("a document needs a preview",{field:"preview"});t.prepare("UPDATE objects SET preview = ? WHERE rowid = ?").run(e.preview,n.rowid)}e.privacy!==void 0&&(I(t,f(t,n.owner),e.privacy),t.prepare("UPDATE objects SET privacy = ? WHERE rowid = ?").run(e.privacy,n.rowid));const r=a((i,u)=>t.prepare(`UPDATE documents SET ${i} = ? WHERE object = ?`).run(u,n.rowid),"set");e.summary!==void 0&&r("summary",e.summary),e.whyItExists!==void 0&&r("why_it_exists",e.whyItExists),e.unlisted!==void 0&&r("unlisted",e.unlisted?1:0),e.lintIgnore!==void 0&&r("lint_ignore_json",e.lintIgnore===null?null:JSON.stringify(e.lintIgnore)),e.extensions!==void 0&&r("extensions_json",e.extensions===null?null:JSON.stringify(e.extensions));const o=f(t,n.rowid);return e.rules!==void 0&&B(t,o,e.rules),o}a(C,"applyDocumentFields");function Y(t,n){if(n.owner.deleted_at)throw c(`${n.owner.name} is deleted`);if(n.preview.trim()==="")throw c("a document needs a preview",{field:"preview"});I(t,n.owner,n.privacy),J(t,n.owner,n.name);const e=oe(t,{...n.id?{id:n.id}:{},type:"document",kind:n.kind,owner:n.owner.rowid,privacy:n.privacy,name:n.name,preview:n.preview});return t.prepare("INSERT INTO documents (object, heads_key, revision) VALUES (?, '', 0)").run(e.rowid),C(t,e,{...n,preview:void 0,privacy:void 0,rules:n.rules??[]})}a(Y,"createDocument");function W(t,n){const e=H(t,n),r=ce(e),o=Math.max(0,...e.map(i=>i.number));return t.prepare("UPDATE documents SET heads_key = ?, revision = ? WHERE object = ?").run(r,o,n.rowid),{heads_key:r,revision:o,headCount:e.length}}a(W,"setHeads");function Oe(t,n,e,r,o){const i=F(r);return h(t,()=>{const u=E(n),s=Y(t,e),p=D(t,s,{number:1,body_hash:i,author:u,rationale:null,parents:[]}),{heads_key:l}=W(t,s);if(!A(t,n,s))throw y(`no owner ${e.owner.name} you can write to`);const w=G(t,n,s,r);return R(t,u,s),k(t,u,s,"write",{readHeadsKey:l}),S(t,{event:"created",object:s,actor:u,level:4,attrs:{revision:1},pointer:p.rev_id},o),{object:s,revision:1,unresolved:w}})}a(Oe,"writeDocument");function De(t,n,e){return t.prepare("SELECT read_heads_key FROM watches WHERE watcher = ? AND object = ?").get(E(n).rowid,e.rowid)?.read_heads_key??null}a(De,"readBase");function me(t,n){let e=t;for(const{old:r,new:o}of n){if(r==="")throw c("a replacement needs non-empty old text",{field:"replace"});const i=e.indexOf(r);if(i<0)throw c(`old text not found: ${JSON.stringify(r.slice(0,120))}`,{field:"replace",old:r});if(e.indexOf(r,i+1)>=0)throw c(`old text occurs more than once: ${JSON.stringify(r.slice(0,120))}`,{field:"replace",old:r});e=e.slice(0,i)+o+e.slice(i+r.length)}return e}a(me,"applyReplacements");function Te(t,n,e,r,o,i,u={},s){if(_(e),N(t,n,e),e.deleted_at)throw c(`${e.name} is deleted`);if(i===null)throw new j("read_first",`read ${e.name} before editing it`,$.GENERAL,{id:e.id});if(o.trim()==="")throw c("an edit needs a rationale",{field:"rationale"});const p=O(t,e);if(p.heads_key!==i)return{stale:{heads_key:p.heads_key,revision:p.revision}};const l=H(t,e);let w;if("body"in r)w=r.body;else{if(l.length!==1)throw c(`${e.name} has ${l.length} heads and needs a merge; pass the whole merged body`,{heads:l.length});w=me(V(t,e,te(l[0].body_hash)),r.replace)}const m=F(w);try{return h(t,()=>{const d=E(n),g=1+Math.max(0,...l.map(v=>v.number)),M=D(t,e,{number:g,body_hash:m,author:d,rationale:o,verbatim:r.verbatim===!0,parents:l.map(v=>v.rowid)}),T=M.rev_id,X=t.prepare("UPDATE documents SET heads_key = ?, revision = ? WHERE object = ? AND heads_key = ?").run(T,g,e.rowid,i);if(Number(X.changes)===0){const v=O(t,e);throw new z(v.heads_key,v.revision)}const x=C(t,e,u),q=G(t,n,x,w);return R(t,d,x),k(t,d,x,"write",{readHeadsKey:T}),S(t,{event:"edited",object:x,actor:d,level:8,pointer:M.rev_id,attrs:{revision:g,from_revision:p.revision,rationale:o}},s),{revision:g,heads_key:T,unresolved:q}})}catch(d){if(d instanceof z)return{stale:{heads_key:d.heads_key,revision:d.revision}};throw d}}a(Te,"editDocument");class z extends Error{static{a(this,"StaleEdit")}heads_key;revision;constructor(n,e){super("stale"),this.heads_key=n,this.revision=e}}function je(t,n,e,r){return _(e),n&&N(t,n,e),h(t,()=>{const o=C(t,e,r);return n&&R(t,E(n),o),o})}a(je,"setDocumentRecord");function we(t,n,e,r){const o=E(n),{heads_key:i}=O(t,e);k(t,o,e,"read",{readHeadsKey:i}),S(t,{event:"read",object:e,actor:o,level:1,attrs:{}},r)}a(we,"recordRead");function $e(t,n,e,r){return _(e),L(t,n,e),h(t,()=>{const o=O(t,e),i=H(t,e).map(s=>({...s,body:V(t,e,ee(s.body_hash,o.source_path))})),u=t.prepare("SELECT dst, written_as FROM edges WHERE type = 'links-to' AND src = ? ORDER BY written_as").all(e.rowid).map(s=>({written_as:s.written_as??"",object:f(t,s.dst)})).filter(s=>s.object&&U(t,n,s.object)).map(s=>({...s,deleted:s.object.deleted_at!==null}));return e.deleted_at||we(t,n,e,r),{object:e,record:o,heads:i,needsMerge:i.length>1,links:u}})}a($e,"readDocument");function Ae(t,n,e){return _(e),L(t,n,e),t.prepare("SELECT * FROM revisions WHERE document = ? ORDER BY number DESC, created_at DESC, rowid DESC").all(e.rowid).map(o=>K(t,o))}a(Ae,"history");function ke(t,n,e,r){if(_(e),e.deleted_at)throw c(`${e.name} is deleted`);return n&&N(t,n,e),h(t,()=>{const o=r.owner??f(t,e.owner),i=r.name??e.name;J(t,o,i,e),I(t,o,e.privacy),t.prepare("UPDATE objects SET name = ?, owner = ? WHERE rowid = ?").run(i,o.rowid,e.rowid);const u=f(t,e.rowid);if(o.rowid!==e.owner&&(se(t,u),n&&!A(t,n,u)))throw y(`no owner ${o.name} you can move documents to`);return n&&R(t,E(n),u),u})}a(ke,"moveDocument");function Ie(t,n,e,r){return _(e),e.deleted_at?e:(n&&N(t,n,e),h(t,()=>{t.prepare("UPDATE objects SET deleted_at = ? WHERE rowid = ?").run(new Date().toISOString(),e.rowid);const o=f(t,e.rowid),i=n?E(n):null;return i&&R(t,i,o),S(t,{event:"deleted",object:o,actor:i,level:8,attrs:{}},r),t.prepare("DELETE FROM watches WHERE object = ?").run(e.rowid),B(t,o,[]),o}))}a(Ie,"deleteDocument");function Le(t,n){if(n.revisions.length===0)throw c(`import of ${n.name}: no revisions`);return h(t,()=>{const e=Y(t,n);t.prepare("UPDATE objects SET created_at = ? WHERE rowid = ?").run(n.revisions[0].created_at,e.rowid);let r=null;return n.revisions.forEach((o,i)=>{r=D(t,e,{...o,number:i+1,parents:r===null?[]:[r]}).rowid}),W(t,e),f(t,e.rowid)})}a(Le,"importDocument");function He(t,n,e){if(_(n),n.privacy!=="public"&&P(t,n)==="repo")throw c(`a repo owns only public documents; refusing revisions of ${n.name}`);return h(t,()=>{const r=t.prepare("SELECT rowid, number, document FROM revisions WHERE rev_id = ?");let o=e.filter(s=>!r.get(s.rev_id));for(;o.length>0;){const s=[];for(const p of o){const l=p.parents.map(m=>r.get(m));if(l.some(m=>m===void 0)){s.push(p);continue}const w=l;if(w.some(m=>m.document!==n.rowid))throw c(`revision ${p.rev_id} names a parent of another document`);D(t,n,{...p,author:null,number:1+Math.max(0,...w.map(m=>m.number)),parents:w.map(m=>m.rowid)})}if(s.length===o.length)throw c(`revisions of ${n.name} name unknown parents: ${s.map(p=>p.rev_id).join(", ")}`);o=s}const{heads_key:i,headCount:u}=W(t,n);return{heads_key:i,headCount:u}})}a(He,"insertImportedRevisions");function Ce(t,n){const e=ie(t,n);if(!e||e.type!=="document")throw y(`no document ${n}`);return e}a(Ce,"documentById");export{E as actorOf,C as applyDocumentFields,me as applyReplacements,Ie as deleteDocument,Ce as documentById,O as documentRecord,Te as editDocument,H as heads,Ae as history,Le as importDocument,He as insertImportedRevisions,pe as linksIn,ke as moveDocument,De as readBase,$e as readDocument,we as recordRead,je as setDocumentRecord,G as setRevisionLinks,V as withCurrentNames,Oe as writeDocument};
+      AND d.type = 'document' AND d.name = ? AND d.deleted_at IS NULL LIMIT 1`).get(n.name,n.type,e)?`${n.type}:${n.name}`:n.name}a(we,"ownerPrefix");function V(t,n,e){const r=t.prepare(`SELECT e.written_as, o.* FROM edges e JOIN objects o ON o.rowid = e.dst
+    WHERE e.type = 'links-to' AND e.src = ? AND e.written_as IS NOT NULL`).all(n.rowid);if(r.length===0)return e;const o=new Map;for(const i of r){if(i.deleted_at||i.written_as===i.id)continue;const u=!i.written_as.includes("/");if(u&&i.name===i.written_as)continue;const s=i.owner===null?null:w(t,i.owner),p=s?`${we(t,s,i.name)}/${i.name}`:i.name,l=u&&i.owner===n.owner?i.name:p;l!==i.written_as&&o.set(i.written_as,l)}return o.size===0?e:e.replace(/\[\[([^[\]\n]+?)\]\]/g,(i,u)=>{const s=o.get(u.trim());return s===void 0?i:`[[${s}]]`})}a(V,"withCurrentNames");function C(t,n,e){if(e.preview!==void 0){if(e.preview.trim()==="")throw c("a document needs a preview",{field:"preview"});t.prepare("UPDATE objects SET preview = ? WHERE rowid = ?").run(e.preview,n.rowid)}e.privacy!==void 0&&(I(t,w(t,n.owner),e.privacy),t.prepare("UPDATE objects SET privacy = ? WHERE rowid = ?").run(e.privacy,n.rowid));const r=a((i,u)=>t.prepare(`UPDATE documents SET ${i} = ? WHERE object = ?`).run(u,n.rowid),"set");e.summary!==void 0&&r("summary",e.summary),e.whyItExists!==void 0&&r("why_it_exists",e.whyItExists),e.unlisted!==void 0&&r("unlisted",e.unlisted?1:0),e.lintIgnore!==void 0&&r("lint_ignore_json",e.lintIgnore===null?null:JSON.stringify(e.lintIgnore)),e.extensions!==void 0&&r("extensions_json",e.extensions===null?null:JSON.stringify(e.extensions));const o=w(t,n.rowid);return e.rules!==void 0&&J(t,o,e.rules),o}a(C,"applyDocumentFields");function Y(t,n){if(n.owner.deleted_at)throw c(`${n.owner.name} is deleted`);if(n.preview.trim()==="")throw c("a document needs a preview",{field:"preview"});I(t,n.owner,n.privacy),P(t,n.owner,n.name);const e=ae(t,{...n.id?{id:n.id}:{},type:"document",kind:n.kind,owner:n.owner.rowid,privacy:n.privacy,name:n.name,preview:n.preview});return t.prepare("INSERT INTO documents (object, heads_key, revision) VALUES (?, '', 0)").run(e.rowid),C(t,e,{...n,preview:void 0,privacy:void 0,rules:n.rules??[]})}a(Y,"createDocument");function W(t,n){const e=H(t,n),r=me(e),o=Math.max(0,...e.map(i=>i.number));return t.prepare("UPDATE documents SET heads_key = ?, revision = ? WHERE object = ?").run(r,o,n.rowid),{heads_key:r,revision:o,headCount:e.length}}a(W,"setHeads");function Ae(t,n,e,r,o){const i=F(r);return h(t,()=>{const u=E(n),s=Y(t,e),p=x(t,s,{number:1,body_hash:i,author:u,rationale:null,parents:[]}),{heads_key:l}=W(t,s);if(!L(t,n,s))throw v(`no owner ${e.owner.name} you can write to`);const d=G(t,n,s,r);return R(t,u,s),k(t,u,s,"write",{readHeadsKey:l}),S(t,{event:"created",object:s,actor:u,level:4,attrs:{revision:1},pointer:p.rev_id},o),{object:s,revision:1,unresolved:d}})}a(Ae,"writeDocument");function je(t,n,e){return t.prepare("SELECT read_heads_key FROM watches WHERE watcher = ? AND object = ?").get(E(n).rowid,e.rowid)?.read_heads_key??null}a(je,"readBase");function fe(t,n){let e=t;for(const{old:r,new:o}of n){if(r==="")throw c("a replacement needs non-empty old text",{field:"replace"});const i=e.indexOf(r);if(i<0)throw c(`old text not found: ${JSON.stringify(r.slice(0,120))}`,{field:"replace",old:r});if(e.indexOf(r,i+1)>=0)throw c(`old text occurs more than once: ${JSON.stringify(r.slice(0,120))}`,{field:"replace",old:r});e=e.slice(0,i)+o+e.slice(i+r.length)}return e}a(fe,"applyReplacements");function Le(t,n,e,r,o,i,u={},s){if(_(e),O(t,n,e),e.deleted_at)throw c(`${e.name} is deleted`);if(i===null)throw new A("read_first",`read ${e.name} before editing it`,j.GENERAL,{id:e.id});if(o.trim()==="")throw c("an edit needs a rationale",{field:"rationale"});const p=D(t,e);if(p.heads_key!==i)return{stale:{heads_key:p.heads_key,revision:p.revision}};const l=H(t,e);let d;if("body"in r)d=r.body;else{if(l.length!==1)throw c(`${e.name} has ${l.length} heads and needs a merge; pass the whole merged body`,{heads:l.length});d=fe(V(t,e,oe(l[0].body_hash)),r.replace)}const m=F(d);try{return h(t,()=>{const f=E(n),N=1+Math.max(0,...l.map(y=>y.number)),M=x(t,e,{number:N,body_hash:m,author:f,rationale:o,verbatim:r.verbatim===!0,parents:l.map(y=>y.rowid)}),T=M.rev_id,Z=t.prepare("UPDATE documents SET heads_key = ?, revision = ? WHERE object = ? AND heads_key = ?").run(T,N,e.rowid,i);if(Number(Z.changes)===0){const y=D(t,e);throw new X(y.heads_key,y.revision)}const g=C(t,e,u),b=G(t,n,g,d);return R(t,f,g),k(t,f,g,"write",{readHeadsKey:T}),S(t,{event:"edited",object:g,actor:f,level:8,pointer:M.rev_id,attrs:{revision:N,from_revision:p.revision,rationale:o}},s),{revision:N,heads_key:T,unresolved:b}})}catch(f){if(f instanceof X)return{stale:{heads_key:f.heads_key,revision:f.revision}};throw f}}a(Le,"editDocument");class X extends Error{static{a(this,"StaleEdit")}heads_key;revision;constructor(n,e){super("stale"),this.heads_key=n,this.revision=e}}function ke(t,n,e,r){return _(e),n&&O(t,n,e),h(t,()=>{const o=C(t,e,r);return n&&R(t,E(n),o),o})}a(ke,"setDocumentRecord");function he(t,n,e,r){const o=E(n),{heads_key:i}=D(t,e);k(t,o,e,"read",{readHeadsKey:i}),S(t,{event:"read",object:e,actor:o,level:1,attrs:{}},r)}a(he,"recordRead");function Ie(t,n,e,r){return _(e),$(t,n,e),h(t,()=>{const o=D(t,e),i=H(t,e).map(s=>({...s,body:V(t,e,re(s.body_hash,o.source_path))})),u=t.prepare("SELECT dst, written_as FROM edges WHERE type = 'links-to' AND src = ? ORDER BY written_as").all(e.rowid).map(s=>({written_as:s.written_as??"",object:w(t,s.dst)})).filter(s=>s.object&&U(t,n,s.object)).map(s=>({...s,deleted:s.object.deleted_at!==null}));return e.deleted_at||he(t,n,e,r),{object:e,record:o,heads:i,needsMerge:i.length>1,links:u}})}a(Ie,"readDocument");function $e(t,n,e){return _(e),$(t,n,e),t.prepare("SELECT * FROM revisions WHERE document = ? ORDER BY number DESC, created_at DESC, rowid DESC").all(e.rowid).map(o=>K(t,o))}a($e,"history");function He(t,n,e,r){if(_(e),e.deleted_at)throw c(`${e.name} is deleted`);return n&&O(t,n,e),h(t,()=>{const o=r.owner??w(t,e.owner),i=r.name??e.name;P(t,o,i,e),I(t,o,e.privacy),t.prepare("UPDATE objects SET name = ?, owner = ? WHERE rowid = ?").run(i,o.rowid,e.rowid);const u=w(t,e.rowid);if(o.rowid!==e.owner&&(ce(t,u),n&&!L(t,n,u)))throw v(`no owner ${o.name} you can move documents to`);return n&&R(t,E(n),u),u})}a(He,"moveDocument");function Ce(t,n,e,r){return _(e),e.deleted_at?e:(n&&O(t,n,e),h(t,()=>{const o=q(t,n,e,r);return Q(t,z(t,e.rowid),r),o}))}a(Ce,"deleteDocument");function q(t,n,e,r){t.prepare("UPDATE objects SET deleted_at = ? WHERE rowid = ?").run(new Date().toISOString(),e.rowid);const o=w(t,e.rowid),i=n?E(n):null;return i&&R(t,i,o),S(t,{event:"deleted",object:o,actor:i,level:8,attrs:{}},r),t.prepare("DELETE FROM watches WHERE object = ?").run(e.rowid),J(t,o,[]),o}a(q,"markDeleted");function z(t,n){return t.prepare("SELECT dst FROM edges WHERE type = 'links-to' AND src = ?").all(n).map(({dst:e})=>e)}a(z,"linkTargets");function Q(t,n,e){const r=t.prepare(`SELECT 1 FROM objects d JOIN objects w ON w.rowid = d.owner
+    WHERE d.rowid = ? AND d.type = 'document' AND d.deleted_at IS NULL AND w.deleted_at IS NOT NULL
+      AND NOT EXISTS (SELECT 1 FROM edges e JOIN objects s ON s.rowid = e.src
+        WHERE e.type = 'links-to' AND e.dst = d.rowid AND e.src != d.rowid AND s.deleted_at IS NULL)`),o=[...n];for(;o.length>0;){const i=o.pop();r.get(i)!==void 0&&(q(t,null,w(t,i),e),o.push(...z(t,i)))}}a(Q,"collectUnlinked");function We(t,n){if(n.revisions.length===0)throw c(`import of ${n.name}: no revisions`);return h(t,()=>{const e=Y(t,n);t.prepare("UPDATE objects SET created_at = ? WHERE rowid = ?").run(n.revisions[0].created_at,e.rowid);let r=null;return n.revisions.forEach((o,i)=>{r=x(t,e,{...o,number:i+1,parents:r===null?[]:[r]}).rowid}),W(t,e),w(t,e.rowid)})}a(We,"importDocument");function Me(t,n,e){if(_(n),n.privacy!=="public"&&B(t,n)==="repo")throw c(`a repo owns only public documents; refusing revisions of ${n.name}`);return h(t,()=>{const r=t.prepare("SELECT rowid, number, document FROM revisions WHERE rev_id = ?");let o=e.filter(s=>!r.get(s.rev_id));for(;o.length>0;){const s=[];for(const p of o){const l=p.parents.map(m=>r.get(m));if(l.some(m=>m===void 0)){s.push(p);continue}const d=l;if(d.some(m=>m.document!==n.rowid))throw c(`revision ${p.rev_id} names a parent of another document`);x(t,n,{...p,author:null,number:1+Math.max(0,...d.map(m=>m.number)),parents:d.map(m=>m.rowid)})}if(s.length===o.length)throw c(`revisions of ${n.name} name unknown parents: ${s.map(p=>p.rev_id).join(", ")}`);o=s}const{heads_key:i,headCount:u}=W(t,n);return{heads_key:i,headCount:u}})}a(Me,"insertImportedRevisions");function Ue(t,n){const e=ue(t,n);if(!e||e.type!=="document")throw v(`no document ${n}`);return e}a(Ue,"documentById");export{E as actorOf,C as applyDocumentFields,fe as applyReplacements,Q as collectUnlinked,Ce as deleteDocument,Ue as documentById,D as documentRecord,Le as editDocument,H as heads,$e as history,We as importDocument,Me as insertImportedRevisions,de as linksIn,He as moveDocument,je as readBase,Ie as readDocument,he as recordRead,ke as setDocumentRecord,G as setRevisionLinks,V as withCurrentNames,Ae as writeDocument};

package/dist/core/graph/edges.d.ts

@@ -11,11 +11,12 @@ export interface Edge {
 }
 /** One row per actor and object however many times the actor acts. */
 export declare function recordActedOn(db: DatabaseSync, actor: ObjectRow, object: ObjectRow): void;
-/** Replace the document's `links-to` edges with the links of its current revision. */
+/** Replace the document's `links-to` edges with the links of its current revision. Answers the
+ *  rowids it no longer links to, so the caller can collect a kept document that lost its last link. */
 export declare function setLinks(db: DatabaseSync, doc: ObjectRow, links: ReadonlyArray<{
     written_as: string;
     dst: ObjectRow;
-}>): void;
+}>): number[];
 /** Documents whose body links to `object`. */
 export declare function backlinks(db: DatabaseSync, reader: Reader, object: ObjectRow): Edge[];
 export declare function edgesOf(db: DatabaseSync, reader: Reader, object: ObjectRow, opts?: {

package/dist/core/graph/edges.js

@@ -1 +1 @@
-var O=Object.defineProperty;var o=(t,n)=>O(t,"name",{value:n,configurable:!0});import{canRead as y}from"./access.js";import{getByRowid as R}from"./objects.js";function k(t,n,e){t.prepare("INSERT OR IGNORE INTO edges (type, src, dst, written_as, created_at) VALUES ('acted-on', ?, ?, NULL, ?)").run(n.rowid,e.rowid,new Date().toISOString())}o(k,"recordActedOn");function _(t,n,e){t.prepare("DELETE FROM edges WHERE type = 'links-to' AND src = ?").run(n.rowid);const s=t.prepare("INSERT OR IGNORE INTO edges (type, src, dst, written_as, created_at) VALUES ('links-to', ?, ?, ?, ?)"),i=new Date().toISOString();for(const c of e)s.run(n.rowid,c.dst.rowid,c.written_as,i)}o(_,"setLinks");function I(t,n,e){return S(t,n,e,{type:"links-to",direction:"in"})}o(I,"backlinks");function S(t,n,e,s={}){if(!y(t,n,e))return[];const i=s.direction??"both",c=s.type?[s.type]:["acted-on","links-to"],d=[];for(const r of c)i!=="in"&&d.push(...t.prepare("SELECT * FROM edges WHERE type = ? AND src = ?").all(r,e.rowid)),i!=="out"&&d.push(...t.prepare("SELECT * FROM edges WHERE type = ? AND dst = ?").all(r,e.rowid));const w=new Set,f=[];for(const r of d){const E=`${r.type}|${r.src}|${r.dst}`;if(w.has(E))continue;w.add(E);const a=r.src===e.rowid?e:R(t,r.src),p=r.dst===e.rowid?e:R(t,r.dst);if(!a||!p)continue;const u=a===e?p:a;u!==e&&!y(t,n,u)||f.push({type:r.type,src:a,dst:p,written_as:r.written_as,created_at:r.created_at})}return f}o(S,"edgesOf");export{I as backlinks,S as edgesOf,k as recordActedOn,_ as setLinks};
+var l=Object.defineProperty;var a=(t,n)=>l(t,"name",{value:n,configurable:!0});import{canRead as y}from"./access.js";import{getByRowid as R}from"./objects.js";function k(t,n,e){t.prepare("INSERT OR IGNORE INTO edges (type, src, dst, written_as, created_at) VALUES ('acted-on', ?, ?, NULL, ?)").run(n.rowid,e.rowid,new Date().toISOString())}a(k,"recordActedOn");function L(t,n,e){const o=t.prepare("SELECT dst FROM edges WHERE type = 'links-to' AND src = ?").all(n.rowid).map(({dst:s})=>s);t.prepare("DELETE FROM edges WHERE type = 'links-to' AND src = ?").run(n.rowid);const c=t.prepare("INSERT OR IGNORE INTO edges (type, src, dst, written_as, created_at) VALUES ('links-to', ?, ?, ?, ?)"),d=new Date().toISOString();for(const s of e)c.run(n.rowid,s.dst.rowid,s.written_as,d);const i=new Set(e.map(s=>s.dst.rowid));return o.filter(s=>!i.has(s))}a(L,"setLinks");function _(t,n,e){return O(t,n,e,{type:"links-to",direction:"in"})}a(_,"backlinks");function O(t,n,e,o={}){if(!y(t,n,e))return[];const c=o.direction??"both",d=o.type?[o.type]:["acted-on","links-to"],i=[];for(const r of d)c!=="in"&&i.push(...t.prepare("SELECT * FROM edges WHERE type = ? AND src = ?").all(r,e.rowid)),c!=="out"&&i.push(...t.prepare("SELECT * FROM edges WHERE type = ? AND dst = ?").all(r,e.rowid));const s=new Set,E=[];for(const r of i){const f=`${r.type}|${r.src}|${r.dst}`;if(s.has(f))continue;s.add(f);const p=r.src===e.rowid?e:R(t,r.src),w=r.dst===e.rowid?e:R(t,r.dst);if(!p||!w)continue;const u=p===e?w:p;u!==e&&!y(t,n,u)||E.push({type:r.type,src:p,dst:w,written_as:r.written_as,created_at:r.created_at})}return E}a(O,"edgesOf");export{_ as backlinks,O as edgesOf,k as recordActedOn,L as setLinks};

package/dist/core/graph/events.d.ts

@@ -3,9 +3,14 @@
 import type { DatabaseSync } from 'node:sqlite';
 import { type ReposFn } from './reader.js';
 import { type Subscription } from './watches.js';
-import { type CanvasEvent, type EventName, type Level, type ListenConfig, type ListenDelivery, type ObjectRow, type ObjectType } from './types.js';
-/** The event's default level, or the caller's. Notices have no default: they carry the caller's tier. */
-export declare function levelFor(event: EventName, override?: Level, objectType?: ObjectType): Level;
+import { type CanvasEvent, type Level, type ListenConfig, type ListenDelivery, type ObjectRow } from './types.js';
+/** The event's default level, or the caller's. Notices have no default: they carry the caller's tier.
+ *  Jobs no longer use it: their events publish at the level their kind declares. */
+export declare function levelFor(event: string, override?: Level, objectType?: string): Level;
+/** The level `ev` publishes at: the declared level when none is supplied; a supplied level
+ *  must equal it or be one of the event's declared `levels`. Throws `unknown_event` for an
+ *  event the object's kind does not declare, `invalid_level` for any other level. */
+export declare function resolveLevel(ev: Pick<CanvasEvent, 'event' | 'object' | 'level'>): Level;
 /** NATS-style match over dot-separated event names: `*` is one part, `>` the rest (at least one part). */
 export declare function matchSubject(pattern: string, event: string): boolean;
 /** Per config, the delivery of the highest threshold the level reaches; across configs, the
@@ -14,13 +19,13 @@ export declare function resolveDelivery(configs: readonly ListenConfig[], level:
 /** A subscription's own config, else the watcher node's default, else the global default. */
 export declare function listenConfigFor(db: DatabaseSync, subscription: Pick<Subscription, 'config'>, watcher: ObjectRow): ListenConfig;
 /**
- * Push `ev` to every node watching the object or a space or profile in its owner chain whose
- * subscriptions receive it, inside the caller's write transaction. Document and job events reach
+ * Validate the event against its object's kind (`resolveLevel`), then push it to every node watching the object itself whose subscriptions receive it — a watch on
+ * an owner hears that owner's own events, not those of the objects it owns — inside the caller's write transaction. Document and job events reach
  * only live (active|idle) watchers; node events also reach done ones without waking them. The
  * actor is never pushed its own act, access is re-checked per watcher, and apps, persons and
  * other non-node watchers get nothing. Writes a `messages` row only when a delivery results.
  * `reposFn` resolves a watcher's repos when the object lives in a repo space.
  */
-export declare function publish(db: DatabaseSync, ev: CanvasEvent, reposFn?: ReposFn): {
+export declare function publish(db: DatabaseSync, input: CanvasEvent, reposFn?: ReposFn): {
     delivered: number;
 };

package/dist/core/graph/events.js

@@ -1,6 +1,7 @@
-var k=Object.defineProperty;var i=(t,e)=>k(t,"name",{value:e,configurable:!0});import{evalCondition as W}from"../predicate.js";import{insertEventMail as N,listenDeliveryTier as M}from"../feed/messages.js";import{ownerChain as J,readCheck as x}from"./access.js";import{publishLookups as H,readerForNode as $}from"./reader.js";import{configFromJson as g}from"./watches.js";import{DEFAULT_LISTEN as b}from"./types.js";const B={created:4,read:1,watched:1,edited:8,messaged:2,sent:1,configured:1,"report.update":5,"report.final":7,"report.result":5,exited:7,killed:7};function oe(t,e,o){if(e!==void 0)return e;if(t==="deleted")return o==="document"?8:5;if(t.startsWith("notice."))throw new Error(`${t} has no default level; pass the notice's tier as a level`);return B[t]}i(oe,"levelFor");function U(t,e){const o=t.split("."),r=e.split(".");for(let s=0;s<o.length;s++){if(o[s]===">")return s===o.length-1&&r.length>s;if(s>=r.length||o[s]!=="*"&&o[s]!==r[s])return!1}return o.length===r.length}i(U,"matchSubject");const S={"next-turn":1,"after-turn":2,steer:3,interrupt:4};function P(t,e){let o=null;for(const r of t){let s=null;for(const c of r)c.threshold<=e&&(!s||c.threshold>s.threshold)&&(s=c);s&&(!o||S[s.delivery]>S[o])&&(o=s.delivery)}return o}i(P,"resolveDelivery");function re(t,e,o){if(e.config)return e.config;const r=t.prepare("SELECT listen_default_json FROM nodes WHERE node_id = ?").get(o.id);return r?.listen_default_json?g(r.listen_default_json):b}i(re,"listenConfigFor");const V=new Set(["messaged","sent","configured","report.update","report.final","report.result","notice.crash","notice.deadline","notice.close"]),G=new Set(["person","app","repo","profile"]);function K(t){return t.event==="report.final"?"final":t.event==="report.result"?"completed":t.level>=7?"urgent":"update"}i(K,"inboxKind");function X(t,e,o){const r=e.object.owner===null?null:t.prepare("SELECT id FROM objects WHERE rowid = ?").get(e.object.owner).id;return{event:e.event,level:e.level,object:{id:e.object.id,type:e.object.type,kind:e.object.kind,owner:r,name:e.object.name},actor:e.actor?.id??null,attrs:o,...e.pointer===void 0?{}:{pointer:e.pointer}}}i(X,"pushFields");function O(t,e,o){const r=X(t,e,o),s=e.messageBody!==void 0&&(e.event.startsWith("report.")||e.event.startsWith("notice.")),c=s?typeof e.messageBody=="object"&&e.messageBody!==null&&!Array.isArray(e.messageBody)?{...e.messageBody,push:r}:{body:e.messageBody,push:r}:{push:r},a=s&&e.event.startsWith("report.")?e.messageBody:null;return{kind:K(e),label:a?.label??`${e.event} ${e.object.type} ${e.object.name}`,...a?.bodyRef===void 0?{}:{bodyRef:a.bodyRef},...a?.disposition===void 0?{}:{disposition:a.disposition},senderNodeId:e.actor?.type==="node"?e.actor.id:null,senderName:e.actor?.name??null,bodyJson:c,event:e.event,objectId:e.object.id,level:e.level,actorId:e.actor?.id??null}}i(O,"mailInput");function Y(t){const e=t.attrs.revision,o=t.attrs.from_revision??(typeof e=="number"?e-1:null),r=t.attrs.rationale;return{...t.attrs,from_revision:o,revision:e,authors:t.actor?[t.actor.id]:[],rationales:typeof r=="string"?[r]:[]}}i(Y,"editAttrs");function q(t,e){const o=[...t.authors??[],...e.authors.filter(r=>!(t.authors??[]).includes(r))];return{...e,from_revision:t.from_revision??null,authors:o,rationales:[...t.rationales??[],...e.rationales]}}i(q,"mergeEdits");function se(t,e,o=()=>[]){const r=J(t,e.object),s=[e.object.rowid,...r.filter(n=>G.has(n.type)).map(n=>n.rowid)],c=V.has(e.event),a=`w.object IN (${s.map(()=>"?").join(",")}) AND w.watcher != ?`,m="w.watcher, o.id AS watcher_id, n.status, n.listen_default_json, s.pattern, s.filter_json, s.config_json",_=t.prepare(c?`SELECT ${m} FROM watches w JOIN watch_subscriptions s ON s.watch = w.rowid
-        JOIN objects o ON o.rowid = w.watcher AND o.type = 'node' JOIN nodes n ON n.node_id = o.id WHERE ${a}`:`SELECT ${m} FROM nodes n CROSS JOIN objects o CROSS JOIN watches w CROSS JOIN watch_subscriptions s
-        WHERE n.status IN ('active','idle') AND o.id = n.node_id AND w.watcher = o.rowid AND s.watch = w.rowid AND ${a}`).all(...s,e.actor?.rowid??-1);if(_.length===0)return{delivered:0};const R={event:e.event,level:e.level,id:e.object.id,type:e.object.type,kind:e.object.kind,actor:e.actor?.id??null,...e.attrs},f=new Map;for(const n of _){if(!U(n.pattern,e.event)||n.filter_json!==null&&!W(JSON.parse(n.filter_json),R))continue;const l=n.config_json?g(n.config_json):n.listen_default_json?g(n.listen_default_json):b,d=f.get(n.watcher)??{id:n.watcher_id,status:n.status,configs:[]};d.configs.push(l),f.set(n.watcher,d)}const D=(r.length?r[r.length-1]:e.object).type==="repo",A=i(()=>[],"noRepos"),I=x(t,e.object),T=H(t),u=[];for(const n of f.values()){const l=P(n.configs,e.level);if(l===null||!I($(t,n.id,D?o:A,T)))continue;const d=M(l),p=n.status==="active"||n.status==="idle";u.push({nodeId:n.id,urgency:d.urgency,wake:p?d.wake:0})}if(u.length===0)return{delivered:0};if(e.event!=="edited")return N(t,O(t,e,e.attrs),u),{delivered:u.length};const E=Y(e),L=t.prepare(`SELECT d.delivery_id, d.message_id, m.body_json FROM deliveries d
+var F=Object.defineProperty;var i=(t,e)=>F(t,"name",{value:e,configurable:!0});import{evalCondition as $}from"../predicate.js";import{insertEventMail as b,listenDeliveryTier as M}from"../feed/messages.js";import{ownerChain as W,readCheck as k}from"./access.js";import{publishLookups as x,readerForNode as H}from"./reader.js";import{configFromJson as m}from"./watches.js";import{CrtrError as J}from"../errors.js";import{ExitCode as B}from"../../types.js";import{eventSpec as U}from"./kinds/registry.js";import{DEFAULT_LISTEN as N}from"./types.js";const G={created:4,read:1,watched:1,edited:8,messaged:2,sent:1,configured:1,"report.update":5,"report.final":7,"report.result":5};function ce(t,e,o){if(e!==void 0)return e;if(t==="deleted")return o==="document"?8:5;if(t.startsWith("notice."))throw new Error(`${t} has no default level; pass the notice's tier as a level`);const n=G[t];if(n===void 0)throw new Error(`${t} has no default level`);return n}i(ce,"levelFor");function V(t){const e=U(t.object.type,t.event);if(t.level===void 0||t.level===e.level||e.levels?.includes(t.level))return t.level??e.level;const o=[e.level,...e.levels??[]].filter((n,r,l)=>l.indexOf(n)===r).sort((n,r)=>n-r);throw new J("invalid_level",`${t.object.type} ${t.event} publishes at level ${o.join(", ")}, not ${t.level}`,B.USAGE,{kind:t.object.type,event:t.event,level:t.level,allowed:o})}i(V,"resolveLevel");function K(t,e){const o=t.split("."),n=e.split(".");for(let r=0;r<o.length;r++){if(o[r]===">")return r===o.length-1&&n.length>r;if(r>=n.length||o[r]!=="*"&&o[r]!==n[r])return!1}return o.length===n.length}i(K,"matchSubject");const v={"next-turn":1,"after-turn":2,steer:3,interrupt:4};function X(t,e){let o=null;for(const n of t){let r=null;for(const l of n)l.threshold<=e&&(!r||l.threshold>r.threshold)&&(r=l);r&&(!o||v[r.delivery]>v[o])&&(o=r.delivery)}return o}i(X,"resolveDelivery");function ue(t,e,o){if(e.config)return e.config;const n=t.prepare("SELECT listen_default_json FROM nodes WHERE node_id = ?").get(o.id);return n?.listen_default_json?m(n.listen_default_json):N}i(ue,"listenConfigFor");const q=new Set(["messaged","sent","configured","report.update","report.final","report.result","notice.crash","notice.deadline","notice.close"]);function z(t){return t.event==="report.final"?"final":t.event==="report.result"?"completed":t.level>=7?"urgent":"update"}i(z,"inboxKind");function P(t,e){return e.type==="node"?e.id:t.prepare(`SELECT 1 FROM objects WHERE type IN ('person','app','repo','profile')
+    AND name = ? AND rowid != ? LIMIT 1`).get(e.name,e.rowid)?`${e.type}:${e.name}`:e.name}i(P,"ownerHandleOf");function Q(t,e,o){const n=e.object.owner===null?null:t.prepare("SELECT * FROM objects WHERE rowid = ?").get(e.object.owner),r=n?.id??null,l=n?P(t,n):null;return{event:e.event,level:e.level,object:{id:e.object.id,type:e.object.type,kind:e.object.kind,owner:r,owner_handle:l,name:e.object.name},actor:e.actor?.id??null,attrs:o,...e.pointer===void 0?{}:{pointer:e.pointer}}}i(Q,"pushFields");function O(t,e,o){const n=Q(t,e,o),r=e.messageBody!==void 0&&(e.event.startsWith("report.")||e.event.startsWith("notice.")),l=r?typeof e.messageBody=="object"&&e.messageBody!==null&&!Array.isArray(e.messageBody)?{...e.messageBody,push:n}:{body:e.messageBody,push:n}:{push:n},a=r&&e.event.startsWith("report.")?e.messageBody:null;return{kind:z(e),label:a?.label??`${e.event} ${e.object.type} ${e.object.name}`,...a?.bodyRef===void 0?{}:{bodyRef:a.bodyRef},...a?.disposition===void 0?{}:{disposition:a.disposition},senderNodeId:e.actor?.type==="node"?e.actor.id:null,senderName:e.actor?.name??null,bodyJson:l,event:e.event,objectId:e.object.id,level:e.level,actorId:e.actor?.id??null}}i(O,"mailInput");function Y(t){const e=t.attrs.revision,o=t.attrs.from_revision??(typeof e=="number"?e-1:null),n=t.attrs.rationale;return{...t.attrs,from_revision:o,revision:e,authors:t.actor?[t.actor.id]:[],rationales:typeof n=="string"?[n]:[]}}i(Y,"editAttrs");function Z(t,e){const o=[...t.authors??[],...e.authors.filter(n=>!(t.authors??[]).includes(n))];return{...e,from_revision:t.from_revision??null,authors:o,rationales:[...t.rationales??[],...e.rationales]}}i(Z,"mergeEdits");function fe(t,e,o=()=>[]){const n={...e,level:V(e)},r=W(t,n.object),l=q.has(n.event),a="w.object = ? AND w.watcher != ?",g="w.watcher, o.id AS watcher_id, n.status, n.listen_default_json, s.pattern, s.filter_json, s.config_json",E=t.prepare(l?`SELECT ${g} FROM watches w JOIN watch_subscriptions s ON s.watch = w.rowid
+        JOIN objects o ON o.rowid = w.watcher AND o.type = 'node' JOIN nodes n ON n.node_id = o.id WHERE ${a}`:`SELECT ${g} FROM nodes n CROSS JOIN objects o CROSS JOIN watches w CROSS JOIN watch_subscriptions s
+        WHERE n.status IN ('active','idle') AND o.id = n.node_id AND w.watcher = o.rowid AND s.watch = w.rowid AND ${a}`).all(n.object.rowid,n.actor?.rowid??-1);if(E.length===0)return{delivered:0};const S={event:n.event,level:n.level,id:n.object.id,type:n.object.type,kind:n.object.kind,actor:n.actor?.id??null,...n.attrs},p=new Map;for(const s of E){if(!K(s.pattern,n.event)||s.filter_json!==null&&!$(JSON.parse(s.filter_json),S))continue;const c=s.config_json?m(s.config_json):s.listen_default_json?m(s.listen_default_json):N,d=p.get(s.watcher)??{id:s.watcher_id,status:s.status,configs:[]};d.configs.push(c),p.set(s.watcher,d)}const R=(r.length?r[r.length-1]:n.object).type==="repo",D=i(()=>[],"noRepos"),A=k(t,n.object),I=x(t),u=[];for(const s of p.values()){const c=X(s.configs,n.level);if(c===null||!A(H(t,s.id,R?o:D,I)))continue;const d=M(c),f=s.status==="active"||s.status==="idle";u.push({nodeId:s.id,urgency:d.urgency,wake:f?d.wake:0})}if(u.length===0)return{delivered:0};if(n.event!=="edited")return b(t,O(t,n,n.attrs),u),{delivered:u.length};const _=Y(n),L=t.prepare(`SELECT d.delivery_id, d.message_id, m.body_json FROM deliveries d
     JOIN messages m ON m.message_id = d.message_id
     WHERE d.destination_kind = 'node_inbox' AND d.destination_id = ? AND d.state = 'pending' AND d.canceled_at IS NULL
-      AND m.event = 'edited' AND m.object_id = ?`),h=new Map,w=new Set,F=t.prepare("DELETE FROM deliveries WHERE delivery_id = ?");for(const n of u){const l=L.all(n.nodeId,e.object.id),d=l.at(-1);for(const j of l)F.run(j.delivery_id),w.add(j.message_id);const p=d?.message_id??null,y=h.get(p)??{prior:d?.body_json?JSON.parse(d.body_json).push?.attrs??null:null,destinations:[]};y.destinations.push(n),h.set(p,y)}for(const n of h.values())N(t,O(t,e,n.prior?q(n.prior,E):E),n.destinations);const C=t.prepare("DELETE FROM messages WHERE message_id = ? AND NOT EXISTS (SELECT 1 FROM deliveries WHERE message_id = ?)");for(const n of w)C.run(n,n);return{delivered:u.length}}i(se,"publish");export{oe as levelFor,re as listenConfigFor,U as matchSubject,se as publish,P as resolveDelivery};
+      AND m.event = 'edited' AND m.object_id = ?`),h=new Map,w=new Set,T=t.prepare("DELETE FROM deliveries WHERE delivery_id = ?");for(const s of u){const c=L.all(s.nodeId,n.object.id),d=c.at(-1);for(const j of c)T.run(j.delivery_id),w.add(j.message_id);const f=d?.message_id??null,y=h.get(f)??{prior:d?.body_json?JSON.parse(d.body_json).push?.attrs??null:null,destinations:[]};y.destinations.push(s),h.set(f,y)}for(const s of h.values())b(t,O(t,n,s.prior?Z(s.prior,_):_),s.destinations);const C=t.prepare("DELETE FROM messages WHERE message_id = ? AND NOT EXISTS (SELECT 1 FROM deliveries WHERE message_id = ?)");for(const s of w)C.run(s,s);return{delivered:u.length}}i(fe,"publish");export{ce as levelFor,ue as listenConfigFor,K as matchSubject,fe as publish,X as resolveDelivery,V as resolveLevel};

package/dist/core/graph/jobs.js

@@ -1,2 +1,2 @@
-var w=Object.defineProperty;var n=(t,r)=>w(t,"name",{value:r,configurable:!0});import{recordActedOn as s}from"./edges.js";import{levelFor as u,publish as d}from"./events.js";import{createObject as E,getByRowid as h}from"./objects.js";import{recordWatch as b}from"./watches.js";function p(t){return t.split(`
-`,1)[0].trim()}n(p,"firstLine");function m(t,r){return`${p(t)} (${r})`}n(m,"previewOf");function j(t,r){return t.prepare("SELECT * FROM jobs WHERE object = ?").get(r.rowid)??null}n(j,"jobRow");function R(t,r,o){if(r.type!=="node")throw new Error(`startJob: ${r.id} is a ${r.type}, not a node`);const e=E(t,{...o.id===void 0?{}:{id:o.id},type:"job",kind:"bash",owner:r.rowid,privacy:"public",name:p(o.command)||"bash",preview:m(o.command,"running")});return t.prepare("INSERT INTO jobs (object, command, status, exit_code, job_dir, log_path) VALUES (?, ?, 'running', NULL, ?, ?)").run(e.rowid,o.command,o.jobDir,o.logPath),s(t,r,e),b(t,r,e,"job-start"),d(t,{event:"created",object:e,actor:r,level:u("created"),attrs:{}}),e}n(R,"startJob");function T(t,r,o){const e=j(t,r);if(e===null)throw new Error(`finishJob: ${r.id} has no jobs row`);if(e.status!=="running")return r;const i="killedBy"in o,a=i?"killed":"exited",l=i?null:o.exitCode;t.prepare("UPDATE jobs SET status = ?, exit_code = ? WHERE object = ?").run(a,l,r.rowid);const f=i?"killed":`exited ${l}`;t.prepare("UPDATE objects SET preview = ? WHERE rowid = ?").run(m(e.command,f),r.rowid);const c=h(t,r.rowid);return i&&o.killedBy!==null&&s(t,o.killedBy,c),d(t,{event:a,object:c,actor:i?o.killedBy:null,level:u(a),attrs:i?{"log-path":e.log_path,...o.reason===void 0?{}:{reason:o.reason}}:{"exit-code":l,"log-path":e.log_path}}),c}n(T,"finishJob");export{T as finishJob,j as jobRow,R as startJob};
+var f=Object.defineProperty;var n=(t,r)=>f(t,"name",{value:r,configurable:!0});import{recordActedOn as s}from"./edges.js";import{publish as u}from"./events.js";import{createObject as w,getByRowid as E}from"./objects.js";import{recordWatch as h}from"./watches.js";function d(t){return t.split(`
+`,1)[0].trim()}n(d,"firstLine");function p(t,r){return`${d(t)} (${r})`}n(p,"previewOf");function b(t,r){return t.prepare("SELECT * FROM jobs WHERE object = ?").get(r.rowid)??null}n(b,"jobRow");function R(t,r,o){if(r.type!=="node")throw new Error(`startJob: ${r.id} is a ${r.type}, not a node`);const e=w(t,{...o.id===void 0?{}:{id:o.id},type:"job",kind:"bash",owner:r.rowid,privacy:"public",name:d(o.command)||"bash",preview:p(o.command,"running")});return t.prepare("INSERT INTO jobs (object, command, status, exit_code, job_dir, log_path) VALUES (?, ?, 'running', NULL, ?, ?)").run(e.rowid,o.command,o.jobDir,o.logPath),s(t,r,e),h(t,r,e,"job-start"),u(t,{event:"created",object:e,actor:r,attrs:{}}),e}n(R,"startJob");function T(t,r,o){const e=b(t,r);if(e===null)throw new Error(`finishJob: ${r.id} has no jobs row`);if(e.status!=="running")return r;const i="killedBy"in o,c=i?"killed":"exited",a=i?null:o.exitCode;t.prepare("UPDATE jobs SET status = ?, exit_code = ? WHERE object = ?").run(c,a,r.rowid);const m=i?"killed":`exited ${a}`;t.prepare("UPDATE objects SET preview = ? WHERE rowid = ?").run(p(e.command,m),r.rowid);const l=E(t,r.rowid);return i&&o.killedBy!==null&&s(t,o.killedBy,l),u(t,{event:c,object:l,actor:i?o.killedBy:null,attrs:i?{"log-path":e.log_path,...o.reason===void 0?{}:{reason:o.reason}}:{"exit-code":a,"log-path":e.log_path}}),l}n(T,"finishJob");export{T as finishJob,b as jobRow,R as startJob};

package/dist/core/graph/kinds/document.d.ts

@@ -0,0 +1,19 @@
+import type { DocFieldsDTO, ObjectDTO } from '../../../api/dto/objects.js';
+import { type ObjectKind } from './kind.js';
+export interface DocumentReadData {
+    summary: string | null;
+    revision: number;
+    heads: Array<{
+        rev_id: string;
+        number: number;
+        author_id: string | null;
+        created_at: string;
+    }>;
+    /** One body per head, in `heads` order. */
+    bodies: string[];
+    needs_merge: boolean;
+    listing?: ObjectDTO[];
+    attachments?: string;
+    fields?: DocFieldsDTO;
+}
+export declare const documentKind: ObjectKind;

package/dist/core/graph/kinds/document.js

@@ -0,0 +1,5 @@
+var y=Object.defineProperty;var m=(n,e)=>y(n,"name",{value:e,configurable:!0});import{recordMemoryReadsIn as v}from"../../canvas/memory-reads.js";import{deliveryDocOf as _,nodeSubject as x,ownerHandle as $}from"../../substrate/delivery/corpus.js";import{recordContentDelivery as R}from"../../substrate/delivery/deliver.js";import{renderExplicitRead as D}from"../../substrate/delivery/render-event.js";import{canRead as S}from"../access.js";import{documentRecord as j,readDocument as k}from"../documents.js";import{loadLedger as E,saveLedger as N}from"../exposures.js";import{getByRowid as O}from"../objects.js";import{rulesOf as f}from"../rules.js";import{objectDTO as d}from"./dto.js";import{withBase as M}from"./kind.js";import{attr as l,header as I,section as L}from"./render.js";function A(n,e,t){const i=`${t.name}/`;return n.prepare(`SELECT * FROM objects WHERE type = 'document' AND deleted_at IS NULL AND owner IS ?
+    AND substr(name, 1, ?) = ? ORDER BY name`).all(t.owner,i.length,i).filter(s=>!s.name.slice(i.length).includes("/")&&S(n,e,s)).map(s=>d(n,s))}m(A,"listingOf");function b(n,e,t){const i=e.class==="node",o=i?E(n,e.node.rowid):{node:0,preferenceSnapshot:null,objects:new Map,listed:new Map},s={db:n,reader:e,subject:i?x(n,e):null,ledger:o,channel:"transcript"},a=D(s,_(n,e,t));return i&&(R(n,e,a.delivered),N(n,o)),{attachments:a.attachments,linked:a.linked.map(u=>u.object)}}m(b,"explicitReadAttachments");function B(n,e,t){if(e.class!=="node"||t.kind!=="knowledge"&&t.kind!=="preference"||t.owner===null)return;const i=O(n,t.owner);i!==null&&v(n,e.node.id,[{name:t.name,scope:$(i),at:new Date().toISOString(),type:"read"}])}m(B,"recordExplicitMemoryRead");function T(n,e){const t=[];if(e.attachments&&t.push(e.attachments,""),t.push(I("object",n,l("privacy",n.privacy)+l("revision",e.revision))),t.push(`Preview: ${n.preview}`),e.summary&&t.push(`Summary: ${e.summary}`),e.fields!==void 0&&t.push(`<fields>
+${JSON.stringify(e.fields,null,2)}
+</fields>`),e.needs_merge?(e.heads.forEach((i,o)=>{t.push(`<head${l("rev",i.rev_id)}${l("number",i.number)}${l("author",i.author_id)}>`,e.bodies[o]??"","</head>")}),t.push(`This document has ${e.heads.length} heads. Your next \`crtr doc edit\` writes the merged body and joins them into one revision.`)):t.push("",e.bodies[0]??""),e.listing&&e.listing.length>0){const i=e.listing.some(a=>a.owner?.id===n.owner?.id&&a.name.startsWith(`${n.name}/`)),o=e.listing.some(a=>a.owner?.id!==n.owner?.id||!a.name.startsWith(`${n.name}/`)),s=i&&o?`Names under ${n.name}/ and documents it links to`:i?`Names under ${n.name}/`:"Documents it links to";t.push("",...L(s,e.listing))}return t.join(`
+`)}m(T,"render");const V={name:"document",addressable:"name",events:M({edited:{level:8},deleted:{level:8}}),listItem(n,e){return{summary:j(n,e).summary??null,rules:f(n,e).length}},read(n,e,t,i){const o=k(n,e,t,i.reposFn);B(n,e,t);const s=o.record,a=A(n,e,t),{attachments:u,linked:h}=b(n,e,t),g=new Set(a.map(r=>r.id)),p=[...a,...h.filter(r=>!g.has(r.id)).map(r=>d(n,r))],c={summary:s.summary??null,revision:s.revision,heads:o.heads.map(r=>({rev_id:r.rev_id,number:r.number,author_id:r.author,created_at:r.created_at})),bodies:o.heads.map(r=>r.body),needs_merge:o.needsMerge,...p.length>0?{listing:p}:{},...u===""?{}:{attachments:u}};return i.fields&&(c.fields={why_it_exists:s.why_it_exists??null,unlisted:s.unlisted,lint_ignore:s.lint_ignore??[],extensions:s.extensions??{},rules:f(n,t).map(({matchFrontmatter:r,...w})=>({...w,...r===void 0?{}:{match_frontmatter:r}}))}),{data:c,text:T(d(n,t),c)}}};export{V as documentKind};

package/dist/core/graph/kinds/dto.d.ts

@@ -0,0 +1,5 @@
+/** An object row as the `/v1/objects` wire shape. */
+import type { DatabaseSync } from 'node:sqlite';
+import type { ObjectDTO } from '../../../api/dto/objects.js';
+import type { ObjectRow } from '../types.js';
+export declare function objectDTO(db: DatabaseSync, o: ObjectRow): ObjectDTO;

package/dist/core/graph/kinds/dto.js

@@ -0,0 +1 @@
+var i=Object.defineProperty;var d=(n,e)=>i(n,"name",{value:e,configurable:!0});import{getByRowid as a}from"../objects.js";function c(n,e){const t=e.owner===null?null:a(n,e.owner),r=t?{id:t.id,type:t.type,handle:t.type==="node"?t.id:t.name}:null;return{id:e.id,type:e.type,kind:e.kind,owner:r,privacy:e.privacy,name:e.name,preview:e.preview??"",created_at:e.created_at,deleted_at:e.deleted_at}}d(c,"objectDTO");export{c as objectDTO};

package/dist/core/graph/kinds/job.d.ts

@@ -0,0 +1,2 @@
+import { type ObjectKind } from './kind.js';
+export declare const jobKind: ObjectKind;

package/dist/core/graph/kinds/job.js

@@ -0,0 +1,2 @@
+import{jobRow as m}from"../jobs.js";import{objectDTO as c}from"./dto.js";import{recordLiveRead as l,withBase as p}from"./kind.js";import{attr as a,header as h}from"./render.js";const f={name:"job",addressable:"id",events:p({exited:{level:7},killed:{level:7}}),read(r,s,e,d){const o=m(r,e);if(!o)throw new Error(`job object ${e.id} has no jobs row`);l(r,s,e,d.reposFn);const n=c(r,e),t={command:o.command,status:o.status,exit_code:o.exit_code,log_path:o.log_path},i=[h("object",n,a("status",t.status)+a("exit_code",t.exit_code)),`Command: ${t.command}`,`Log: ${t.log_path}`].join(`
+`);return{data:t,text:i}}};export{f as jobKind};

package/dist/core/graph/kinds/kind.d.ts

@@ -0,0 +1,39 @@
+/** The one interface every canvas object kind implements: its declared events, how it is
+ *  addressed, and how it reads. The kind name is what `objects.type` stores. */
+import type { DatabaseSync } from 'node:sqlite';
+import type { ReposFn } from '../reader.js';
+import type { Level, ObjectRow, Reader } from '../types.js';
+/** One declared event: its default level and, only where a sender may choose, the levels it may pick. */
+export interface EventSpec {
+    level: Level;
+    levels?: readonly Level[];
+}
+export type EventCatalog = Readonly<Record<string, EventSpec>>;
+/** What a read answers: the kind's structured fields and exactly the text `crtr canvas read` prints. */
+export interface KindRead {
+    data: Record<string, unknown>;
+    text: string;
+}
+export interface ReadOpts {
+    /** A document read also returns its optional fields. */
+    fields: boolean;
+    reposFn: ReposFn;
+}
+export interface ObjectKind {
+    /** Stored in `objects.type`. */
+    name: string;
+    /** The base events merged with the kind's own. */
+    events: EventCatalog;
+    /** `name`: found by `<owner>/<name>`; `id`: by id only; `handle`: an owner's handle. */
+    addressable: 'name' | 'id' | 'handle';
+    /** Records the read (a watch and a `read` event) and renders the object. */
+    read(db: DatabaseSync, reader: Reader, object: ObjectRow, opts: ReadOpts): KindRead;
+    /** Extra fields a list or search row carries. */
+    listItem?(db: DatabaseSync, object: ObjectRow): Record<string, unknown>;
+}
+/** Events every kind inherits. */
+export declare const BASE_EVENTS: EventCatalog;
+/** The base events with a kind's own merged over them. */
+export declare function withBase(own?: EventCatalog): EventCatalog;
+/** A live read of a non-document object: the reader watches it and its other watchers hear `read`. */
+export declare function recordLiveRead(db: DatabaseSync, reader: Reader, object: ObjectRow, reposFn: ReposFn): void;

package/dist/core/graph/kinds/kind.js

@@ -0,0 +1 @@
+var l=Object.defineProperty;var d=(e,r)=>l(e,"name",{value:r,configurable:!0});import{actorOf as a}from"../documents.js";import{publish as c}from"../events.js";import{recordWatch as n}from"../watches.js";const f={created:{level:4},read:{level:1},watched:{level:1},deleted:{level:5},configured:{level:1}};function s(e={}){return{...f,...e}}d(s,"withBase");function h(e,r,t,i){const o=a(r);o.rowid!==t.rowid&&(n(e,o,t,"read"),c(e,{event:"read",object:t,actor:o,attrs:{}},i))}d(h,"recordLiveRead");export{f as BASE_EVENTS,h as recordLiveRead,s as withBase};

package/dist/core/graph/kinds/node.d.ts

@@ -0,0 +1,2 @@
+import { type ObjectKind } from './kind.js';
+export declare const nodeKind: ObjectKind;

package/dist/core/graph/kinds/node.js

@@ -0,0 +1,4 @@
+var R=Object.defineProperty;var a=(e,t)=>R(e,"name",{value:t,configurable:!0});import{readGoal as u}from"../../runtime/kickoff.js";import{canRead as w}from"../access.js";import{objectDTO as p}from"./dto.js";import{recordLiveRead as j,withBase as L}from"./kind.js";import{attr as O,header as _,section as d}from"./render.js";const n=[3,5,7];function h(e){return e?.split(`
+`).map(t=>t.trim()).find(t=>t!=="")??""}a(h,"firstLine");const F={name:"node",addressable:"id",events:L({messaged:{level:2},sent:{level:1},"report.update":{level:5,levels:n},"report.final":{level:7},"report.result":{level:5},"notice.crash":{level:5,levels:n},"notice.deadline":{level:5,levels:n},"notice.close":{level:5,levels:n}}),read(e,t,o,m){const E=e.prepare("SELECT status FROM nodes WHERE node_id = ?").get(o.id),s=a(l=>l.filter(i=>w(e,t,i)).map(i=>p(e,i)),"visible"),v=e.prepare(`SELECT o.* FROM nodes n JOIN objects o ON o.id = n.node_id
+      WHERE n.parent = ? AND o.deleted_at IS NULL ORDER BY o.rowid`).all(o.id),c=e.prepare("SELECT * FROM objects WHERE owner = ? AND deleted_at IS NULL ORDER BY rowid").all(o.rowid);j(e,t,o,m.reposFn);const r={status:E?.status??"deleted",mandate_first_line:h(u(o.id)),children:s(v),owned:s(c.filter(l=>l.type!=="job")),jobs:s(c.filter(l=>l.type==="job"))},f=[_("object",p(e,o),O("status",r.status)),`Mandate: ${r.mandate_first_line}`,...d("Children",r.children),...d("Owns",r.owned),...d("Jobs",r.jobs)].join(`
+`);return{data:r,text:f}}};export{F as nodeKind};

package/dist/core/graph/kinds/owner.d.ts

@@ -0,0 +1,2 @@
+import { type ObjectKind } from './kind.js';
+export declare const ownerKinds: ObjectKind[];

package/dist/core/graph/kinds/owner.js

@@ -0,0 +1,2 @@
+var m=Object.defineProperty;var d=(a,t)=>m(a,"name",{value:t,configurable:!0});import{objectDTO as c}from"./dto.js";import{recordLiveRead as l,withBase as h}from"./kind.js";import{header as y}from"./render.js";function n(a){return{name:a,addressable:"handle",events:h(),read(t,o,e,s){const r=t.prepare("SELECT scheme, external_id FROM identities WHERE object = ?").get(e.rowid);l(t,o,e,s.reposFn);const i={handle:e.name,display_name:e.preview||e.name,identity:{scheme:r?.scheme??"",external_id:r?.external_id??""}},p=[y("object",c(t,e)),`Handle: ${i.handle}`,`Display name: ${i.display_name}`,`Identity: ${i.identity.scheme}:${i.identity.external_id}`].join(`
+`);return{data:i,text:p}}}}d(n,"ownerKind");const E=[n("person"),n("app"),n("repo"),n("profile")];export{E as ownerKinds};

package/dist/core/graph/kinds/registry.d.ts

@@ -0,0 +1,8 @@
+import type { EventSpec, ObjectKind } from './kind.js';
+/** The names of every declared kind. */
+export declare function kindNames(): string[];
+export declare function isKind(name: string): boolean;
+/** The kind named `name`, or throws `unknown_kind`. */
+export declare function kindOf(name: string): ObjectKind;
+/** The declared spec of `event` on `kind`, or throws `unknown_event` naming the declared events. */
+export declare function eventSpec(kind: string, event: string): EventSpec;

package/dist/core/graph/kinds/registry.js

@@ -0,0 +1 @@
+var s=Object.defineProperty;var t=(n,e)=>s(n,"name",{value:e,configurable:!0});import{CrtrError as d}from"../../errors.js";import{ExitCode as c}from"../../../types.js";import{documentKind as u}from"./document.js";import{jobKind as m}from"./job.js";import{nodeKind as p}from"./node.js";import{ownerKinds as a}from"./owner.js";let f=null;function r(){return f??=new Map([u,p,m,...a].map(n=>[n.name,n])),f}t(r,"kinds");function k(){return[...r().keys()]}t(k,"kindNames");function K(n){return r().has(n)}t(K,"isKind");function w(n){const e=r().get(n);if(e===void 0)throw new d("unknown_kind",`no object kind named ${JSON.stringify(n)}; the kinds are ${k().join(", ")}`,c.USAGE,{kind:n});return e}t(w,"kindOf");function S(n,e){const o=w(n).events,i=Object.hasOwn(o,e)?o[e]:void 0;if(i===void 0)throw new d("unknown_event",`${n} declares no event ${JSON.stringify(e)}; it declares ${Object.keys(o).join(", ")}`,c.USAGE,{kind:n,event:e,declared:Object.keys(o)});return i}t(S,"eventSpec");export{S as eventSpec,K as isKind,k as kindNames,w as kindOf};

package/dist/core/graph/kinds/render.d.ts

@@ -0,0 +1,9 @@
+/** Text helpers every kind's `read` renders with, and the CLI renders deleted answers with.
+ *  Pure: imports only DTO types, so the CLI can load it without the canvas. */
+import type { ObjectDTO } from '../../../api/dto/objects.js';
+export declare function attr(name: string, value: string | number | null | undefined): string;
+/** One line per object: id, name, type/kind, owner handle and preview. */
+export declare function objectRow(o: ObjectDTO): string;
+/** `<tag type kind id name owner …extra>` */
+export declare function header(tag: string, o: ObjectDTO, extra?: string): string;
+export declare function section(title: string, rows: ObjectDTO[]): string[];

package/dist/core/graph/kinds/render.js

@@ -0,0 +1 @@
+var i=Object.defineProperty;var t=(e,n)=>i(e,"name",{value:n,configurable:!0});function r(e,n){return n==null||n===""?"":` ${e}="${String(n).replace(/"/g,"&quot;")}"`}t(r,"attr");function p(e){const n=e.kind?`${e.type}/${e.kind}`:e.type,d=e.owner?` owner=${e.owner.handle}`:"",$=e.deleted_at?" (deleted)":"";return`- ${e.id} [[${e.name}]] ${n}${d}${$} \u2014 ${e.preview}`}t(p,"objectRow");function u(e,n,d=""){return`<${e}${r("type",n.type)}${r("kind",n.kind)}${r("id",n.id)}${r("name",n.name)}${r("owner",n.owner?.handle)}${d}>`}t(u,"header");function a(e,n){return n.length===0?[]:[`${e}:`,...n.map(p)]}t(a,"section");export{r as attr,u as header,p as objectRow,a as section};

package/dist/core/graph/names.d.ts

@@ -18,7 +18,9 @@ export declare function viewOf(db: DatabaseSync, reader: Reader): ObjectRow[];
 /** The owner types that carry a handle; `<type>:<handle>/<name>` names one exactly. */
 export declare const HANDLE_TYPES: readonly ["person", "app", "repo", "profile"];
 /** Every owner a handle names: a node by id, and each handle-carrying owner type
- *  holding that handle (handles are unique per type, not across types). */
+ *  holding that handle (handles are unique per type, not across types). Any owner
+ *  also answers to its object id, so `<owner object id>/<name>` names a document
+ *  whatever its owner's type. */
 export declare function ownersByHandle(db: DatabaseSync, handle: string, type?: string): ObjectRow[];
 /** `name` may be wrapped in `[[ ]]`, a raw object id, a bare document name,
  *  `<owner handle>/<name>`, or `<type>:<owner handle>/<name>`. Under a handle

package/dist/core/graph/names.js

@@ -1,3 +1,3 @@
-var L=Object.defineProperty;var a=(e,t)=>L(e,"name",{value:t,configurable:!0});import{isSafeNodeId as O}from"../canvas/paths.js";import{canRead as S,toolApps as j}from"./access.js";import{getById as x}from"./objects.js";function I(e,t){const r=e.prepare("SELECT * FROM objects WHERE type = 'person' AND name = 'user'").get(),o=j(e,t),u=t.class==="node"?[t.node,...t.repos,t.profile,t.app]:t.class==="app"?[t.app]:[],s=new Set;return[...u,r,...o].filter(i=>!!i&&!s.has(i.rowid)&&!!s.add(i.rowid))}a(I,"viewOf");function d(e,t,r,o){return e.prepare(`SELECT * FROM objects WHERE type = 'document' AND owner = ? AND name = ?
-    AND deleted_at IS ${o?"NOT NULL ORDER BY deleted_at DESC":"NULL"}`).all(t.rowid,r)}a(d,"documentsNamed");const C=["person","app","repo","profile"],g=/^(person|app|repo|profile|node):([^/]+)\/(.+)$/;function T(e,t,r){return r==="node"?e.prepare("SELECT * FROM objects WHERE type = 'node' AND id = ?").all(t):r?e.prepare("SELECT * FROM objects WHERE type = ? AND name = ?").all(r,t):e.prepare(`SELECT * FROM objects WHERE (type = 'node' AND id = ?)
-    OR (type IN ('person','app','repo','profile') AND name = ?)`).all(t,t)}a(T,"ownersByHandle");function F(e,t,r){let o=r.trim().replace(/^\[\[(.*)\]\]$/,"$1").trim();const u=/^([^:/]+):reports\/(.+?)(?:\.md)?$/.exec(o);u&&!g.test(o)&&(o=`${u[1]}/reports/${u[2]}`);const s=a(c=>S(e,t,c),"readable"),i=x(e,o);if(i&&s(i))return i.deleted_at?{deleted:i}:{object:i};const N=I(e,t);for(const c of N){const p=d(e,c,o,!1).find(s);if(p)return{object:p}}const f=g.exec(o),w=o.indexOf("/");if(f||w>0){const c=f?f[2]:o.slice(0,w),p=f?f[3]:o.slice(w+1),E=T(e,c,f?.[1]),R=a(n=>{const l=N.findIndex(A=>A.rowid===n.rowid);return l<0?1/0:l},"rank"),y=E.filter(n=>R(n)<1/0).sort((n,l)=>R(n)-R(l));for(const n of y){const l=d(e,n,p,!1).find(s);if(l)return{object:l}}const m=E.flatMap(n=>d(e,n,p,!1)).filter(s);if(m.length===1)return{object:m[0]};if(m.length>1)return{ambiguous:m};const D=E.flatMap(n=>d(e,n,p,!0)).find(s);return D?{deleted:D}:!f&&E.length===0&&O(c)?{remote:o}:{missing:!0}}for(const c of N){const p=d(e,c,o,!0).find(s);if(p)return{deleted:p}}return{missing:!0}}a(F,"resolveName");export{C as HANDLE_TYPES,T as ownersByHandle,F as resolveName,I as viewOf};
+var A=Object.defineProperty;var a=(t,e)=>A(t,"name",{value:e,configurable:!0});import{isSafeNodeId as L}from"../canvas/paths.js";import{canRead as S,toolApps as j}from"./access.js";import{getById as x}from"./objects.js";function I(t,e){const r=t.prepare("SELECT * FROM objects WHERE type = 'person' AND name = 'user'").get(),o=j(t,e),u=e.class==="node"?[e.node,...e.repos,e.profile,e.app]:e.class==="app"?[e.app]:[],s=new Set;return[...u,r,...o].filter(i=>!!i&&!s.has(i.rowid)&&!!s.add(i.rowid))}a(I,"viewOf");function d(t,e,r,o){return t.prepare(`SELECT * FROM objects WHERE type = 'document' AND owner = ? AND name = ?
+    AND deleted_at IS ${o?"NOT NULL ORDER BY deleted_at DESC":"NULL"}`).all(e.rowid,r)}a(d,"documentsNamed");const h=["person","app","repo","profile"],O=/^(person|app|repo|profile|node):([^/]+)\/(.+)$/;function T(t,e,r){return r==="node"?t.prepare("SELECT * FROM objects WHERE type = 'node' AND id = ?").all(e):r?t.prepare("SELECT * FROM objects WHERE type = ? AND (name = ? OR id = ?)").all(r,e,e):t.prepare(`SELECT * FROM objects WHERE (type = 'node' AND id = ?)
+    OR (type IN ('person','app','repo','profile') AND (name = ? OR id = ?))`).all(e,e,e)}a(T,"ownersByHandle");function F(t,e,r){let o=r.trim().replace(/^\[\[(.*)\]\]$/,"$1").trim();const u=/^([^:/]+):reports\/(.+?)(?:\.md)?$/.exec(o);u&&!O.test(o)&&(o=`${u[1]}/reports/${u[2]}`);const s=a(c=>S(t,e,c),"readable"),i=x(t,o);if(i&&s(i))return i.deleted_at?{deleted:i}:{object:i};const R=I(t,e);for(const c of R){const p=d(t,c,o,!1).find(s);if(p)return{object:p}}const f=O.exec(o),N=o.indexOf("/");if(f||N>0){const c=f?f[2]:o.slice(0,N),p=f?f[3]:o.slice(N+1),E=T(t,c,f?.[1]),w=a(n=>{const l=R.findIndex(y=>y.rowid===n.rowid);return l<0?1/0:l},"rank"),g=E.filter(n=>w(n)<1/0).sort((n,l)=>w(n)-w(l));for(const n of g){const l=d(t,n,p,!1).find(s);if(l)return{object:l}}const m=E.flatMap(n=>d(t,n,p,!1)).filter(s);if(m.length===1)return{object:m[0]};if(m.length>1)return{ambiguous:m};const D=E.flatMap(n=>d(t,n,p,!0)).find(s);return D?{deleted:D}:!f&&E.length===0&&L(c)?{remote:o}:{missing:!0}}for(const c of R){const p=d(t,c,o,!0).find(s);if(p)return{deleted:p}}return{missing:!0}}a(F,"resolveName");export{h as HANDLE_TYPES,T as ownersByHandle,F as resolveName,I as viewOf};

package/dist/core/graph/objects.d.ts

@@ -1,10 +1,11 @@
 import type { DatabaseSync } from 'node:sqlite';
-import type { ObjectRow, ObjectType, Privacy, Reader } from './types.js';
+import type { ObjectRow, Privacy, Reader } from './types.js';
+export type OwnerType = 'person' | 'app' | 'repo' | 'profile';
 export declare function getById(db: DatabaseSync, id: string): ObjectRow | null;
 export declare function getByRowid(db: DatabaseSync, rowid: number): ObjectRow | null;
 export declare function createObject(db: DatabaseSync, spec: {
     id?: string;
-    type: ObjectType;
+    type: string;
     kind: string | null;
     owner: number | null;
     privacy: Privacy;
@@ -15,7 +16,7 @@ export declare function createObject(db: DatabaseSync, spec: {
  *  (scheme, externalId). Handles are unique per owner type: a handle already held
  *  by a different identity of the same type throws `conflict` naming both; it is
  *  never renamed silently. */
-export declare function ensureOwner(db: DatabaseSync, type: ObjectType, scheme: string, externalId: string, handle: string, owner?: ObjectRow): ObjectRow;
+export declare function ensureOwner(db: DatabaseSync, type: OwnerType, scheme: string, externalId: string, handle: string, owner?: ObjectRow): ObjectRow;
 /** The owner object of a node grantee: `user:local` → person `user`; `app:<x>` → app `<x>`. */
 export declare function ownerForGrantee(db: DatabaseSync, grantee: string): ObjectRow;
 /** The owner's live document named `name`, or null. */
@@ -24,7 +25,7 @@ export declare function nodeObject(db: DatabaseSync, nodeId: string): ObjectRow;
 export declare function setObjectName(db: DatabaseSync, object: ObjectRow, name: string): void;
 export declare function setObjectKind(db: DatabaseSync, object: ObjectRow, kind: string | null): void;
 export interface ObjectFilter {
-    type?: ObjectType;
+    type?: string;
     kind?: string;
     owner?: ObjectRow;
     privacy?: Privacy;

package/dist/core/graph/objects.js

@@ -1,9 +1,9 @@
-var S=Object.defineProperty;var s=(o,e)=>S(o,"name",{value:e,configurable:!0});import{CrtrError as L,notFound as j}from"../errors.js";import{ExitCode as b}from"../../types.js";import{newNodeId as T}from"../runtime/nodes.js";import{canRead as l}from"./access.js";import{bodyOf as x}from"./bodies.js";const y=new Set(["person","app","repo","profile"]);function h(o){return o||null}s(h,"rowFrom");function I(o,e){return h(o.prepare("SELECT * FROM objects WHERE id = ?").get(e))}s(I,"getById");function W(o,e){return h(o.prepare("SELECT * FROM objects WHERE rowid = ?").get(e))}s(W,"getByRowid");function _(o,e){return o.prepare(`INSERT INTO objects (id, type, kind, owner, privacy, name, preview, created_at)
-    VALUES (?, ?, ?, ?, ?, ?, ?, ?) RETURNING *`).get(e.id??T(),e.type,e.kind,e.owner,e.privacy,e.name,e.preview,new Date().toISOString())}s(_,"createObject");function R(o,e,t,p,r,n){if(!y.has(e))throw new Error(`ensureOwner: ${e} is not an owner type`);const a=o.prepare(`SELECT o.* FROM identities i JOIN objects o ON o.rowid = i.object
+var S=Object.defineProperty;var s=(o,e)=>S(o,"name",{value:e,configurable:!0});import{CrtrError as L,notFound as j}from"../errors.js";import{ExitCode as b}from"../../types.js";import{newNodeId as T}from"../runtime/nodes.js";import{kindOf as x}from"./kinds/registry.js";import{canRead as l}from"./access.js";import{bodyOf as y}from"./bodies.js";const I=new Set(["person","app","repo","profile"]);function h(o){return o||null}s(h,"rowFrom");function _(o,e){return h(o.prepare("SELECT * FROM objects WHERE id = ?").get(e))}s(_,"getById");function M(o,e){return h(o.prepare("SELECT * FROM objects WHERE rowid = ?").get(e))}s(M,"getByRowid");function g(o,e){return x(e.type),o.prepare(`INSERT INTO objects (id, type, kind, owner, privacy, name, preview, created_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?) RETURNING *`).get(e.id??T(),e.type,e.kind,e.owner,e.privacy,e.name,e.preview,new Date().toISOString())}s(g,"createObject");function R(o,e,t,p,r,n){if(!I.has(e))throw new Error(`ensureOwner: ${e} is not an owner type`);const a=o.prepare(`SELECT o.* FROM identities i JOIN objects o ON o.rowid = i.object
     WHERE i.scheme = ? AND i.external_id = ?`).get(t,p);if(a)return a;const c=o.prepare(`SELECT o.id, o.type, i.scheme, i.external_id FROM objects o
     LEFT JOIN identities i ON i.object = o.rowid
-    WHERE o.name = ? AND o.type = ?`).get(r,e);if(c)throw new L("conflict",`handle "${r}" is held by ${c.type} ${c.id} (${c.scheme}:${c.external_id}); cannot give it to ${e} ${t}:${p}`,b.GENERAL,{handle:r,holder:c.id});const d=_(o,{type:e,kind:null,owner:e==="profile"?n?.rowid??null:null,privacy:"public",name:r,preview:""});return o.prepare("INSERT INTO identities (object, scheme, external_id) VALUES (?, ?, ?)").run(d.rowid,t,p),d}s(R,"ensureOwner");function H(o,e){if(e==="user:local")return R(o,"person","local-user",e,"user");if(/^app:[a-z0-9][a-z0-9._-]*$/.test(e))return R(o,"app","app",e,e.slice(4));throw new Error(`node grantee ${JSON.stringify(e)} is neither app:<name> nor user:local`)}s(H,"ownerForGrantee");function M(o,e,t){return h(o.prepare("SELECT * FROM objects WHERE type = 'document' AND owner = ? AND name = ? AND deleted_at IS NULL").get(e,t))}s(M,"liveDocumentNamed");function U(o,e){const t=I(o,e);if(!t||t.type!=="node")throw j(`no node object ${e}`);return t}s(U,"nodeObject");function k(o,e,t){o.prepare("UPDATE objects SET name = ? WHERE rowid = ?").run(t,e.rowid)}s(k,"setObjectName");function P(o,e,t){o.prepare("UPDATE objects SET kind = ? WHERE rowid = ?").run(t,e.rowid)}s(P,"setObjectKind");function B(o,e,t,p={}){const r=["rowid > ?"],n=[p.after_rowid??0];return t.type!==void 0&&(r.push("type = ?"),n.push(t.type)),t.kind!==void 0&&(r.push("kind = ?"),n.push(t.kind)),t.owner!==void 0&&(r.push("owner = ?"),n.push(t.owner.rowid)),t.privacy!==void 0&&(r.push("privacy = ?"),n.push(t.privacy)),t.name!==void 0&&(r.push("name = ?"),n.push(t.name)),r.push(t.deleted?"deleted_at IS NOT NULL":"deleted_at IS NULL"),g(o,e,`SELECT * FROM objects WHERE ${r.join(" AND ")}`,n,Math.min(p.limit??100,100))}s(B,"listObjects");function J(o,e,t){const r=[],n=`%${t.text.replace(/[\\%_]/g,i=>`\\${i}`)}%`;if(!t.grep){const i=o.prepare(`SELECT o.*, d.summary AS _summary FROM objects o LEFT JOIN documents d ON d.object = o.rowid
+    WHERE o.name = ? AND o.type = ?`).get(r,e);if(c)throw new L("conflict",`handle "${r}" is held by ${c.type} ${c.id} (${c.scheme}:${c.external_id}); cannot give it to ${e} ${t}:${p}`,b.GENERAL,{handle:r,holder:c.id});const d=g(o,{type:e,kind:null,owner:e==="profile"?n?.rowid??null:null,privacy:"public",name:r,preview:""});return o.prepare("INSERT INTO identities (object, scheme, external_id) VALUES (?, ?, ?)").run(d.rowid,t,p),d}s(R,"ensureOwner");function k(o,e){if(e==="user:local")return R(o,"person","local-user",e,"user");if(/^app:[a-z0-9][a-z0-9._-]*$/.test(e))return R(o,"app","app",e,e.slice(4));throw new Error(`node grantee ${JSON.stringify(e)} is neither app:<name> nor user:local`)}s(k,"ownerForGrantee");function U(o,e,t){return h(o.prepare("SELECT * FROM objects WHERE type = 'document' AND owner = ? AND name = ? AND deleted_at IS NULL").get(e,t))}s(U,"liveDocumentNamed");function P(o,e){const t=_(o,e);if(!t||t.type!=="node")throw j(`no node object ${e}`);return t}s(P,"nodeObject");function B(o,e,t){o.prepare("UPDATE objects SET name = ? WHERE rowid = ?").run(t,e.rowid)}s(B,"setObjectName");function J(o,e,t){o.prepare("UPDATE objects SET kind = ? WHERE rowid = ?").run(t,e.rowid)}s(J,"setObjectKind");function K(o,e,t,p={}){const r=["rowid > ?"],n=[p.after_rowid??0];return t.type!==void 0&&(r.push("type = ?"),n.push(t.type)),t.kind!==void 0&&(r.push("kind = ?"),n.push(t.kind)),t.owner!==void 0&&(r.push("owner = ?"),n.push(t.owner.rowid)),t.privacy!==void 0&&(r.push("privacy = ?"),n.push(t.privacy)),t.name!==void 0&&(r.push("name = ?"),n.push(t.name)),r.push(t.deleted?"deleted_at IS NOT NULL":"deleted_at IS NULL"),A(o,e,`SELECT * FROM objects WHERE ${r.join(" AND ")}`,n,Math.min(p.limit??100,100))}s(K,"listObjects");function Y(o,e,t){const r=[],n=`%${t.text.replace(/[\\%_]/g,i=>`\\${i}`)}%`;if(!t.grep){const i=o.prepare(`SELECT o.*, d.summary AS _summary FROM objects o LEFT JOIN documents d ON d.object = o.rowid
       WHERE o.deleted_at IS NULL AND (o.name LIKE ?1 ESCAPE '\\' OR o.preview LIKE ?1 ESCAPE '\\' OR d.summary LIKE ?1 ESCAPE '\\')
       ORDER BY o.rowid`).all(n),u=t.text.toLowerCase();for(const m of i){const{_summary:w,...E}=m,f=E;if(!l(o,e,f))continue;const O=f.name.toLowerCase().includes(u)?"name":f.preview.toLowerCase().includes(u)?"preview":"summary";if(r.push({object:f,field:O,...O==="summary"?{text:String(w)}:{}}),r.length>=100)return r}}if(!t.body&&!t.grep)return r;const a=new Set(r.map(i=>i.object.rowid)),c=t.grep?(i=>u=>i.test(u))(new RegExp(t.text)):i=>i.includes(t.text),d=o.prepare("SELECT * FROM objects WHERE type = 'document' AND deleted_at IS NULL ORDER BY rowid").all(),N=o.prepare(`SELECT r.body_hash, d.source_path FROM revisions r JOIN documents d ON d.object = r.document WHERE r.document = ?
-    AND NOT EXISTS (SELECT 1 FROM revision_parents p WHERE p.parent = r.rowid)`);for(const i of d)if(!(a.has(i.rowid)||!l(o,e,i)))for(const{body_hash:u,source_path:m}of N.all(i.rowid)){const w=x(u,m).split(`
-`),E=w.findIndex(c);if(!(E<0)){if(r.push({object:i,field:"body",line:E+1,text:w[E]}),r.length>=100)return r;break}}return r}s(J,"searchObjects");function g(o,e,t,p,r){const n=[],a=o.prepare(`${t} ORDER BY rowid LIMIT ${r*4}`);for(;;){const c=a.all(...p);for(const d of c)if(l(o,e,d)&&n.push(d),n.length===r)return n;if(c.length<r*4)return n;p[0]=c[c.length-1].rowid}}s(g,"readablePages");export{_ as createObject,R as ensureOwner,I as getById,W as getByRowid,B as listObjects,M as liveDocumentNamed,U as nodeObject,H as ownerForGrantee,J as searchObjects,P as setObjectKind,k as setObjectName};
+    AND NOT EXISTS (SELECT 1 FROM revision_parents p WHERE p.parent = r.rowid)`);for(const i of d)if(!(a.has(i.rowid)||!l(o,e,i)))for(const{body_hash:u,source_path:m}of N.all(i.rowid)){const w=y(u,m).split(`
+`),E=w.findIndex(c);if(!(E<0)){if(r.push({object:i,field:"body",line:E+1,text:w[E]}),r.length>=100)return r;break}}return r}s(Y,"searchObjects");function A(o,e,t,p,r){const n=[],a=o.prepare(`${t} ORDER BY rowid LIMIT ${r*4}`);for(;;){const c=a.all(...p);for(const d of c)if(l(o,e,d)&&n.push(d),n.length===r)return n;if(c.length<r*4)return n;p[0]=c[c.length-1].rowid}}s(A,"readablePages");export{g as createObject,R as ensureOwner,_ as getById,M as getByRowid,K as listObjects,U as liveDocumentNamed,P as nodeObject,k as ownerForGrantee,Y as searchObjects,J as setObjectKind,B as setObjectName};

package/dist/core/graph/repo-sync/exchange.js

@@ -1,2 +1,2 @@
-var A=Object.defineProperty;var f=(e,t)=>A(e,"name",{value:t,configurable:!0});import{get as B,put as T}from"../bodies.js";import{setLinks as j}from"../edges.js";import{deleteDocument as S,documentRecord as D,heads as M,importDocument as F,insertImportedRevisions as H,moveDocument as W,setDocumentRecord as J}from"../documents.js";import{publish as $}from"../events.js";import{getById as C,getByRowid as P,setObjectKind as Y}from"../objects.js";import{rulesOf as K}from"../rules.js";import{SPACES as z}from"../spaces/index.js";import{docPath as V,parseDoc as E,serializeDoc as b}from"./ref-format.js";function I(e){const t=z[e.type];if(e.owner!==null||!t||t.sync!=="repo-ref")throw new Error(`${e.type} ${e.id} is not a space that syncs through a repo ref`)}f(I,"assertRepoRefSpace");function q(e){const t=new Map;for(const[r,i]of e??[]){const l=E(r,i);l.ok&&t.set(l.doc.id,l.doc)}return t}f(q,"parseMap");function ce(e,t,r){I(t);const i=q(r),l=e.prepare("SELECT * FROM objects WHERE type = 'document' AND owner = ? AND privacy = 'public' ORDER BY rowid").all(t.rowid),u=e.prepare("SELECT rowid, rev_id, number, body_hash, author, rationale, created_at FROM revisions WHERE document = ? ORDER BY number, rev_id"),p=e.prepare("SELECT p.rev_id FROM revision_parents rp JOIN revisions p ON p.rowid = rp.parent WHERE rp.child = ?"),o=e.prepare(`SELECT e.written_as, o.id FROM edges e JOIN objects o ON o.rowid = e.dst
-    WHERE e.type = 'links-to' AND e.src = ? ORDER BY e.written_as, o.id`),d=new Map;for(const n of l){const m=D(e,n),y=new Map((i.get(n.id)?.revisions??[]).map(s=>[s.rev_id,s])),h=new Set(M(e,n).map(s=>s.rev_id)),g=o.all(n.rowid).map(s=>({written_as:s.written_as??"",dst:s.id})),v=u.all(n.rowid).map(s=>y.get(s.rev_id)??{rev_id:s.rev_id,number:s.number,parents:p.all(s.rowid).map(O=>O.rev_id),body:B(s.body_hash),body_hash:s.body_hash,author:s.author===null?null:P(e,s.author)?.id??null,rationale:s.rationale,created_at:s.created_at,links:h.has(s.rev_id)?g:[]});if(v.length===0)continue;const R=K(e,n).map(s=>({position:s.position,on:s.on,match:s.match??null,match_frontmatter:s.matchFrontmatter??null,if:s.if??null,deliver:s.deliver})),_={id:n.id,name:n.name,kind:n.kind??"document",privacy:"public",preview:n.preview,summary:m.summary,why_it_exists:m.why_it_exists,unlisted:m.unlisted,lint_ignore:m.lint_ignore,extensions:m.extensions,created_at:n.created_at,deleted_at:n.deleted_at,rules:R,revisions:v};d.set(V(n.id),b(_))}return d}f(ce,"exportRepo");function G(e){return[...e].sort((t,r)=>t.position-r.position).map(t=>({on:t.on,deliver:t.deliver,...t.match!==null&&t.match!==void 0?{match:t.match}:{},...t.match_frontmatter!==null&&t.match_frontmatter!==void 0?{matchFrontmatter:t.match_frontmatter}:{},...t.if!==null&&t.if!==void 0?{if:t.if}:{}}))}f(G,"toRuleSpecs");const Q=f((e,t)=>JSON.stringify(e??null)===JSON.stringify(t??null),"same");function N(e,t){const r={},i=f(l=>!e||!Q(e[l],t[l]),"differs");return i("preview")&&(r.preview=t.preview),i("summary")&&(r.summary=t.summary),i("why_it_exists")&&(r.whyItExists=t.why_it_exists),i("unlisted")&&(r.unlisted=t.unlisted),i("lint_ignore")&&(r.lintIgnore=t.lint_ignore),i("extensions")&&(r.extensions=t.extensions),i("rules")&&(r.rules=G(t.rules)),r}f(N,"changedFields");let U=0;function L(e,t){const r=`repo_sync_import_${++U}`;e.exec(`SAVEPOINT ${r}`);try{const i=t();return e.exec(`RELEASE ${r}`),i}catch(i){throw e.exec(`ROLLBACK TO ${r}`),e.exec(`RELEASE ${r}`),i}}f(L,"atomic");function de(e,t,r,i,l){I(t);const u={created:0,revisions:0,deleted:0,needsMerge:[],refused:[]},p=[];for(const[o,d]of i){if(r.get(o)===d)continue;const n=E(o,d);if(!n.ok){u.refused.push({path:o,reason:n.reason});continue}const m=r.has(o)?E(o,r.get(o)):null;p.push({path:o,prior:m?.ok?m.doc:null,doc:n.doc})}for(const[o,d]of r){if(i.has(o))continue;const n=E(o,d);n.ok&&p.push({path:o,prior:n.doc,doc:null,priorId:n.doc.id})}for(const o of p)for(const d of o.doc?.revisions??[])T(d.body);return L(e,()=>{for(const o of p)try{L(e,()=>X(e,t,o.prior,o.doc,o.priorId??o.doc.id,u,l))}catch(d){u.refused.push({path:o.path,reason:d.message})}}),u}f(de,"importTree");function X(e,t,r,i,l,u,p){const o=C(e,l);if(o&&(o.type!=="document"||o.owner!==t.rowid))throw new Error(`id ${l} is held by ${o.type} ${o.name} outside ${t.name}`);if(!i){o&&!o.deleted_at&&(S(e,null,o,p),u.deleted++);return}const d=e.prepare("SELECT count(*) AS n FROM revisions WHERE document = ?");let n,m=!1,y=0,h=0;if(o){n=o,y=D(e,n).revision;const a=i.kind;(r?r.kind!==a:n.kind!==a)&&Y(e,n,a);const c=N(r,i);Object.keys(c).length>0&&(n=J(e,null,n,c)),i.name!==n.name&&!n.deleted_at&&(n=W(e,null,n,{name:i.name}))}else{const c=i.revisions.filter(w=>w.parents.length===0).sort((w,x)=>w.number-x.number||w.rev_id.localeCompare(x.rev_id))[0];if(!c)throw new Error(`${i.name}: no root revision`);n=F(e,{id:i.id,owner:t,name:i.name,kind:i.kind,preview:i.preview,privacy:"public",...N(null,i),revisions:[{rev_id:c.rev_id,body_hash:c.body_hash,author:null,rationale:c.rationale,created_at:c.created_at}]}),m=!0,h=1}const g=d.get(n.rowid).n,{headCount:v}=H(e,n,i.revisions.map(a=>({rev_id:a.rev_id,parents:a.parents,body_hash:a.body_hash,rationale:a.rationale,created_at:a.created_at})));h+=d.get(n.rowid).n-g,u.revisions+=h;const _=M(e,n)[0],s=new Map(i.revisions.map(a=>[a.rev_id,a]));if(h>0){const a=(s.get(_.rev_id)?.links??[]).map(c=>({written_as:c.written_as,dst:C(e,c.dst)})).filter(c=>c.dst!==null);j(e,n,a)}if(v>1&&u.needsMerge.push(n.id),i.deleted_at&&!n.deleted_at){S(e,null,n,p),u.deleted++;return}if(m){u.created++,$(e,{event:"created",object:n,actor:null,level:4,attrs:{revision:_.number},pointer:_.rev_id},p);return}if(h===0)return;const k=i.revisions.filter(a=>!r?.revisions.some(c=>c.rev_id===a.rev_id)).sort((a,c)=>c.number-a.number||c.created_at.localeCompare(a.created_at))[0]??s.get(_.rev_id);$(e,{event:"edited",object:n,actor:null,level:8,pointer:_.rev_id,attrs:{revision:_.number,from_revision:y,rationale:k?.rationale??null,author:k?.author??null,heads:v,needs_merge:v>1}},p)}f(X,"importOne");export{ce as exportRepo,de as importTree};
+var A=Object.defineProperty;var f=(e,t)=>A(e,"name",{value:t,configurable:!0});import{get as B,put as T}from"../bodies.js";import{setLinks as j}from"../edges.js";import{collectUnlinked as H,deleteDocument as S,documentRecord as D,heads as M,importDocument as W,insertImportedRevisions as F,moveDocument as J,setDocumentRecord as P}from"../documents.js";import{publish as $}from"../events.js";import{getById as C,getByRowid as Y,setObjectKind as K}from"../objects.js";import{rulesOf as z}from"../rules.js";import{SPACES as U}from"../spaces/index.js";import{docPath as V,parseDoc as E,serializeDoc as q}from"./ref-format.js";function I(e){const t=U[e.type];if(e.owner!==null||!t||t.sync!=="repo-ref")throw new Error(`${e.type} ${e.id} is not a space that syncs through a repo ref`)}f(I,"assertRepoRefSpace");function G(e){const t=new Map;for(const[r,i]of e??[]){const l=E(r,i);l.ok&&t.set(l.doc.id,l.doc)}return t}f(G,"parseMap");function de(e,t,r){I(t);const i=G(r),l=e.prepare("SELECT * FROM objects WHERE type = 'document' AND owner = ? AND privacy = 'public' ORDER BY rowid").all(t.rowid),u=e.prepare("SELECT rowid, rev_id, number, body_hash, author, rationale, created_at FROM revisions WHERE document = ? ORDER BY number, rev_id"),p=e.prepare("SELECT p.rev_id FROM revision_parents rp JOIN revisions p ON p.rowid = rp.parent WHERE rp.child = ?"),o=e.prepare(`SELECT e.written_as, o.id FROM edges e JOIN objects o ON o.rowid = e.dst
+    WHERE e.type = 'links-to' AND e.src = ? ORDER BY e.written_as, o.id`),d=new Map;for(const n of l){const m=D(e,n),y=new Map((i.get(n.id)?.revisions??[]).map(s=>[s.rev_id,s])),h=new Set(M(e,n).map(s=>s.rev_id)),g=o.all(n.rowid).map(s=>({written_as:s.written_as??"",dst:s.id})),v=u.all(n.rowid).map(s=>y.get(s.rev_id)??{rev_id:s.rev_id,number:s.number,parents:p.all(s.rowid).map(O=>O.rev_id),body:B(s.body_hash),body_hash:s.body_hash,author:s.author===null?null:Y(e,s.author)?.id??null,rationale:s.rationale,created_at:s.created_at,links:h.has(s.rev_id)?g:[]});if(v.length===0)continue;const R=z(e,n).map(s=>({position:s.position,on:s.on,match:s.match??null,match_frontmatter:s.matchFrontmatter??null,if:s.if??null,deliver:s.deliver})),_={id:n.id,name:n.name,kind:n.kind??"document",privacy:"public",preview:n.preview,summary:m.summary,why_it_exists:m.why_it_exists,unlisted:m.unlisted,lint_ignore:m.lint_ignore,extensions:m.extensions,created_at:n.created_at,deleted_at:n.deleted_at,rules:R,revisions:v};d.set(V(n.id),q(_))}return d}f(de,"exportRepo");function Q(e){return[...e].sort((t,r)=>t.position-r.position).map(t=>({on:t.on,deliver:t.deliver,...t.match!==null&&t.match!==void 0?{match:t.match}:{},...t.match_frontmatter!==null&&t.match_frontmatter!==void 0?{matchFrontmatter:t.match_frontmatter}:{},...t.if!==null&&t.if!==void 0?{if:t.if}:{}}))}f(Q,"toRuleSpecs");const X=f((e,t)=>JSON.stringify(e??null)===JSON.stringify(t??null),"same");function N(e,t){const r={},i=f(l=>!e||!X(e[l],t[l]),"differs");return i("preview")&&(r.preview=t.preview),i("summary")&&(r.summary=t.summary),i("why_it_exists")&&(r.whyItExists=t.why_it_exists),i("unlisted")&&(r.unlisted=t.unlisted),i("lint_ignore")&&(r.lintIgnore=t.lint_ignore),i("extensions")&&(r.extensions=t.extensions),i("rules")&&(r.rules=Q(t.rules)),r}f(N,"changedFields");let Z=0;function L(e,t){const r=`repo_sync_import_${++Z}`;e.exec(`SAVEPOINT ${r}`);try{const i=t();return e.exec(`RELEASE ${r}`),i}catch(i){throw e.exec(`ROLLBACK TO ${r}`),e.exec(`RELEASE ${r}`),i}}f(L,"atomic");function le(e,t,r,i,l){I(t);const u={created:0,revisions:0,deleted:0,needsMerge:[],refused:[]},p=[];for(const[o,d]of i){if(r.get(o)===d)continue;const n=E(o,d);if(!n.ok){u.refused.push({path:o,reason:n.reason});continue}const m=r.has(o)?E(o,r.get(o)):null;p.push({path:o,prior:m?.ok?m.doc:null,doc:n.doc})}for(const[o,d]of r){if(i.has(o))continue;const n=E(o,d);n.ok&&p.push({path:o,prior:n.doc,doc:null,priorId:n.doc.id})}for(const o of p)for(const d of o.doc?.revisions??[])T(d.body);return L(e,()=>{for(const o of p)try{L(e,()=>b(e,t,o.prior,o.doc,o.priorId??o.doc.id,u,l))}catch(d){u.refused.push({path:o.path,reason:d.message})}}),u}f(le,"importTree");function b(e,t,r,i,l,u,p){const o=C(e,l);if(o&&(o.type!=="document"||o.owner!==t.rowid))throw new Error(`id ${l} is held by ${o.type} ${o.name} outside ${t.name}`);if(!i){o&&!o.deleted_at&&(S(e,null,o,p),u.deleted++);return}const d=e.prepare("SELECT count(*) AS n FROM revisions WHERE document = ?");let n,m=!1,y=0,h=0;if(o){n=o,y=D(e,n).revision;const a=i.kind;(r?r.kind!==a:n.kind!==a)&&K(e,n,a);const c=N(r,i);Object.keys(c).length>0&&(n=P(e,null,n,c)),i.name!==n.name&&!n.deleted_at&&(n=J(e,null,n,{name:i.name}))}else{const c=i.revisions.filter(w=>w.parents.length===0).sort((w,x)=>w.number-x.number||w.rev_id.localeCompare(x.rev_id))[0];if(!c)throw new Error(`${i.name}: no root revision`);n=W(e,{id:i.id,owner:t,name:i.name,kind:i.kind,preview:i.preview,privacy:"public",...N(null,i),revisions:[{rev_id:c.rev_id,body_hash:c.body_hash,author:null,rationale:c.rationale,created_at:c.created_at}]}),m=!0,h=1}const g=d.get(n.rowid).n,{headCount:v}=F(e,n,i.revisions.map(a=>({rev_id:a.rev_id,parents:a.parents,body_hash:a.body_hash,rationale:a.rationale,created_at:a.created_at})));h+=d.get(n.rowid).n-g,u.revisions+=h;const _=M(e,n)[0],s=new Map(i.revisions.map(a=>[a.rev_id,a]));if(h>0){const a=(s.get(_.rev_id)?.links??[]).map(c=>({written_as:c.written_as,dst:C(e,c.dst)})).filter(c=>c.dst!==null);H(e,j(e,n,a),p)}if(v>1&&u.needsMerge.push(n.id),i.deleted_at&&!n.deleted_at){S(e,null,n,p),u.deleted++;return}if(m){u.created++,$(e,{event:"created",object:n,actor:null,level:4,attrs:{revision:_.number},pointer:_.rev_id},p);return}if(h===0)return;const k=i.revisions.filter(a=>!r?.revisions.some(c=>c.rev_id===a.rev_id)).sort((a,c)=>c.number-a.number||c.created_at.localeCompare(a.created_at))[0]??s.get(_.rev_id);$(e,{event:"edited",object:n,actor:null,level:8,pointer:_.rev_id,attrs:{revision:_.number,from_revision:y,rationale:k?.rationale??null,author:k?.author??null,heads:v,needs_merge:v>1}},p)}f(b,"importOne");export{de as exportRepo,le as importTree};