@north-light/cli 0.3.529 → 0.3.531

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

@@ -1,9 +1,7 @@
-/** 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 { ReceiverName } from '../receivers.js';
 import type { CanvasEvent, Level, ObjectRow, Reader } from '../types.js';
+import type { CanvasDb } from '../../canvas/db.js';
 /** A superseding event's attrs: built from the superseded pending delivery's attrs (null when it
  *  supersedes nothing) and the new event. */
 export type SupersedeMerge = (prior: Record<string, unknown> | null, ev: CanvasEvent) => Record<string, unknown>;
@@ -52,18 +50,18 @@ export interface ObjectKind {
     /** How a watcher of this kind receives events (a key of `receivers.ts`). Absent: it cannot watch. */
     receiver?: ReceiverName;
     /** Resolve a receiver from this particular object, when it is configured per instance. */
-    receiverFor?(db: DatabaseSync, object: ObjectRow): ReceiverName | undefined;
+    receiverFor?(db: CanvasDb, object: ObjectRow): Promise<ReceiverName | undefined>;
     /** A kind may fence claimed deliveries when a superseding event replaces them. Return true
      *  only if the claimed delivery was replaced; model handoffs are not retractable. */
-    supersedeClaimed?(db: DatabaseSync, deliveryId: string): boolean;
+    supersedeClaimed?(db: CanvasDb, deliveryId: string): Promise<boolean>;
     /** Records the read (a watch and a `read` event) and renders the object. */
-    read(db: DatabaseSync, reader: Reader, object: ObjectRow, opts: ReadOpts): KindRead;
+    read(db: CanvasDb, reader: Reader, object: ObjectRow, opts: ReadOpts): Promise<KindRead>;
     /** Extra fields a list or search row carries. */
-    listItem?(db: DatabaseSync, object: ObjectRow): Record<string, unknown>;
+    listItem?(db: CanvasDb, object: ObjectRow): Promise<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;
+export declare function recordLiveRead(db: CanvasDb, reader: Reader, object: ObjectRow, reposFn: ReposFn): Promise<void>;

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

@@ -1 +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};
+var d=Object.defineProperty;var a=(e,r)=>d(e,"name",{value:r,configurable:!0});import{actorOf as l}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 u(e={}){return{...f,...e}}a(u,"withBase");async function w(e,r,t,i){const o=l(r);o.rowid!==t.rowid&&(await n(e,o,t,"read"),await c(e,{event:"read",object:t,actor:o,attrs:{}},i))}a(w,"recordLiveRead");export{f as BASE_EVENTS,w as recordLiveRead,u as withBase};

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

@@ -1,5 +1,5 @@
-var y=Object.defineProperty;var s=(r,t)=>y(r,"name",{value:t,configurable:!0});import{prepared as c}from"../../sqlite-statements.js";import{cancelCronsOnWake as T}from"../../canvas/crons.js";import{settleMatchingControllerWait as b}from"../../canvas/waits.js";import{effectiveTier as R,listenDeliveryTier as I,newId as N}from"../../feed/messages.js";import{readGoal as S}from"../../runtime/kickoff.js";import{canRead as h}from"../access.js";import{objectDTO as w}from"./dto.js";import{recordLiveRead as L,withBase as O}from"./kind.js";import{attr as D,header as j,section as f}from"./render.js";const m=[3,5,7];function C(r){return r?.split(`
-`).map(t=>t.trim()).find(t=>t!=="")??""}s(C,"firstLine");const K={bodyOwner:s(r=>r[0]?.id??null,"bodyOwner"),enqueue(r,t,n){const a=Date.now(),l=t.senderNodeId,i=n.map(e=>e.id),u=`(${i.map(()=>"?").join(",")})`,p=l===null?new Set:new Set(r.prepare(`SELECT DISTINCT node_id FROM waits WHERE kind = 'controller' AND target_id = ? AND satisfied_at IS NULL AND node_id IN ${u}`).all(l,...i).map(e=>e.node_id)),o=new Set(r.prepare(`SELECT DISTINCT anchor_node FROM crons WHERE cancel_on_wake = 1 AND anchor_node IN ${u}`).all(...i).map(e=>e.anchor_node)),v=c(r,`INSERT INTO deliveries (delivery_id, message_id, destination_id, urgency, wake, state, created_at, updated_at, idempotency_key)
-       VALUES (?, ?, ?, ?, ?, 'pending', ?, ?, ?)`);for(const e of n){const d=I(e.delivery),E=e.reception===2?d.wake:0,_=t.elevatesTier?R(e.id,d.urgency):d.urgency;v.run(N(),t.messageId,e.id,_,E,a,a,t.idempotencyKey===void 0?null:`${t.idempotencyKey}:${e.id}`),p.has(e.id)&&b(e.id,l,a,r),E===1&&_!=="deferred"&&o.has(e.id)&&T(e.id)}}},U={name:"node",addressable:"id",receiver:"inbox",receiverFor:s((r,t)=>c(r,"SELECT 1 FROM peer_stubs WHERE object = ?").get(t.rowid)===void 0?"inbox":"peer","receiverFor"),events:O({configured:{level:1,durable:!0},messaged:{level:2,durable:!0},sent:{level:1,durable:!0},"report.update":{level:5,levels:m,durable:!0,carriesBody:!0,elevatesTier:!0},"report.final":{level:7,durable:!0,carriesBody:!0,elevatesTier:!0,inboxKind:"final"},outcome:{level:1,durable:!0,supersedes:!0,carriesBody:!0},"report.result":{level:5,durable:!0,carriesBody:!0,elevatesTier:!0,inboxKind:"completed"},"notice.crash":{level:5,levels:m,durable:!0,carriesBody:!0,elevatesTier:!0},"notice.deadline":{level:5,levels:m,durable:!0,carriesBody:!0,elevatesTier:!0},"notice.close":{level:5,levels:m,durable:!0,carriesBody:!0,elevatesTier:!0}}),read(r,t,n,a){const l=c(r,"SELECT status FROM nodes WHERE node_id = ?").get(n.id),i=s(e=>e.filter(d=>h(r,t,d)).map(d=>w(r,d)),"visible"),u=c(r,`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(n.id),p=c(r,"SELECT * FROM objects WHERE owner = ? AND deleted_at IS NULL ORDER BY rowid").all(n.rowid);L(r,t,n,a.reposFn);const o={status:l?.status??"deleted",mandate_first_line:C(S(n.id)),children:i(u),owned:i(p.filter(e=>e.type!=="job")),jobs:i(p.filter(e=>e.type==="job"))},v=[j("object",w(r,n),D("status",o.status)),`Mandate: ${o.mandate_first_line}`,...f("Children",o.children),...f("Owns",o.owned),...f("Jobs",o.jobs)].join(`
-`);return{data:o,text:v}}};export{K as nodeInbox,U as nodeKind};
+var E=Object.defineProperty;var l=(t,r)=>E(t,"name",{value:r,configurable:!0});import{cancelCronsOnWake as _}from"../../canvas/crons.js";import{settleMatchingControllerWait as T}from"../../canvas/waits.js";import{effectiveTier as b,listenDeliveryTier as R,newId as I}from"../../feed/messages.js";import{readGoal as N}from"../../runtime/kickoff.js";import{canRead as h}from"../access.js";import{objectDTO as f}from"./dto.js";import{recordLiveRead as S,withBase as L}from"./kind.js";import{attr as O,header as D,section as m}from"./render.js";import{filterAsync as j,mapAsync as C}from"../../async-array.js";const p=[3,5,7];function g(t){return t?.split(`
+`).map(r=>r.trim()).find(r=>r!=="")??""}l(g,"firstLine");const K={bodyOwner:l(t=>t[0]?.id??null,"bodyOwner"),async enqueue(t,r,a){const d=Date.now(),s=r.senderNodeId,n=a.map(e=>e.id),c=`(${n.map(()=>"?").join(",")})`,u=s===null?new Set:new Set((await t.prepareUncached(`SELECT DISTINCT node_id FROM waits WHERE kind = 'controller' AND target_id = ? AND satisfied_at IS NULL AND node_id IN ${c}`).all(s,...n)).map(e=>e.node_id)),i=new Set((await t.prepareUncached(`SELECT DISTINCT anchor_node FROM crons WHERE cancel_on_wake = 1 AND anchor_node IN ${c}`).all(...n)).map(e=>e.anchor_node)),w=t.prepare(`INSERT INTO deliveries (delivery_id, message_id, destination_id, urgency, wake, state, created_at, updated_at, idempotency_key)
+       VALUES (?, ?, ?, ?, ?, 'pending', ?, ?, ?)`);for(const e of a){const o=R(e.delivery),v=e.reception===2?o.wake:0,y=r.elevatesTier?await b(e.id,o.urgency):o.urgency;await w.run(I(),r.messageId,e.id,y,v,d,d,r.idempotencyKey===void 0?null:`${r.idempotencyKey}:${e.id}`),u.has(e.id)&&await T(e.id,s,d,t),v===1&&y!=="deferred"&&i.has(e.id)&&await _(e.id)}}},J={name:"node",addressable:"id",receiver:"inbox",receiverFor:l(async(t,r)=>await t.prepare("SELECT 1 FROM peer_stubs WHERE object = ?").get(r.rowid)===void 0?"inbox":"peer","receiverFor"),events:L({configured:{level:1,durable:!0},messaged:{level:2,durable:!0},sent:{level:1,durable:!0},"report.update":{level:5,levels:p,durable:!0,carriesBody:!0,elevatesTier:!0},"report.final":{level:7,durable:!0,carriesBody:!0,elevatesTier:!0,inboxKind:"final"},outcome:{level:1,durable:!0,supersedes:!0,carriesBody:!0},"report.result":{level:5,durable:!0,carriesBody:!0,elevatesTier:!0,inboxKind:"completed"},"notice.crash":{level:5,levels:p,durable:!0,carriesBody:!0,elevatesTier:!0},"notice.deadline":{level:5,levels:p,durable:!0,carriesBody:!0,elevatesTier:!0},"notice.close":{level:5,levels:p,durable:!0,carriesBody:!0,elevatesTier:!0}}),async read(t,r,a,d){const s=await t.prepare("SELECT status FROM nodes WHERE node_id = ?").get(a.id),n=l(async e=>await C(await j(e,async o=>await h(t,r,o)),async o=>await f(t,o)),"visible"),c=await t.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(a.id),u=await t.prepare("SELECT * FROM objects WHERE owner = ? AND deleted_at IS NULL ORDER BY rowid").all(a.rowid);await S(t,r,a,d.reposFn);const i={status:s?.status??"deleted",mandate_first_line:g(await N(a.id)),children:await n(c),owned:await n(u.filter(e=>e.type!=="job")),jobs:await n(u.filter(e=>e.type==="job"))},w=[D("object",await f(t,a),O("status",i.status)),`Mandate: ${i.mandate_first_line}`,...m("Children",i.children),...m("Owns",i.owned),...m("Jobs",i.jobs)].join(`
+`);return{data:i,text:w}}};export{K as nodeInbox,J as nodeKind};

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

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

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

@@ -1,13 +1,10 @@
-/** The kind registry: kind name → its `ObjectKind`, and each kind's declared events.
- *  `createObject` and `publish` go through it, so an undeclared kind cannot be written and an
- *  undeclared event cannot be published. It decides no access, fan-out or delivery. */
-import type { DatabaseSync } from 'node:sqlite';
 import type { EventSpec, ObjectKind } from './kind.js';
+import type { CanvasDb } from '../../canvas/db.js';
 /** A registration write invalidates the in-process copy before its next lookup. */
-export declare function invalidateCustomKind(db: DatabaseSync, name: string): void;
-export declare function kindNames(db: DatabaseSync): string[];
-export declare function isKind(db: DatabaseSync, name: string): boolean;
+export declare function invalidateCustomKind(db: CanvasDb, name: string): void;
+export declare function kindNames(db: CanvasDb): Promise<string[]>;
+export declare function isKind(db: CanvasDb, name: string): Promise<boolean>;
 /** The kind named `name`, or throws `unknown_kind`. */
-export declare function kindOf(db: DatabaseSync, name: string): ObjectKind;
+export declare function kindOf(db: CanvasDb, name: string): Promise<ObjectKind>;
 /** The declared spec of `event` on `kind`, or throws `unknown_event` naming the declared events. */
-export declare function eventSpec(db: DatabaseSync, kind: string, event: string): EventSpec;
+export declare function eventSpec(db: CanvasDb, kind: string, event: string): Promise<EventSpec>;

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

@@ -1 +1 @@
-var l=Object.defineProperty;var o=(e,n)=>l(e,"name",{value:n,configurable:!0});import{prepared as u}from"../../sqlite-statements.js";import{CrtrError as f}from"../../errors.js";import{ExitCode as m}from"../../../types.js";import{documentKind as k}from"./document.js";import{jobKind as w}from"./job.js";import{nodeKind as O}from"./node.js";import{actionKind as j}from"./action.js";import{ownerKinds as E}from"./owner.js";import{customKind as S}from"./custom.js";let a=null;function s(){return a??=new Map([k,O,j,w,...E].map(e=>[e.name,e])),a}o(s,"kinds");const c=new WeakMap;function N(e,n){c.get(e)?.delete(n)}o(N,"invalidateCustomKind");function g(e){return[...s().keys(),...u(e,"SELECT name FROM object_kinds ORDER BY name").all().map(n=>n.name)]}o(g,"kindNames");function J(e,n){return s().has(n)||p(e,n)!==null}o(J,"isKind");function p(e,n){let t=c.get(e);t||(t=new Map,c.set(e,t));const r=t.get(n);if(r)return r;const i=u(e,"SELECT events_json FROM object_kinds WHERE name = ?").get(n);if(!i)return null;const d=S(n,JSON.parse(i.events_json));return t.set(n,d),d}o(p,"kindOfCustom");function h(e,n){const t=s().get(n)??p(e,n);if(t==null)throw new f("unknown_kind",`no object kind named ${JSON.stringify(n)}; the kinds are ${g(e).join(", ")}`,m.USAGE,{kind:n});return t}o(h,"kindOf");function A(e,n,t){const r=h(e,n).events,i=Object.hasOwn(r,t)?r[t]:void 0;if(i===void 0)throw new f("unknown_event",`${n} declares no event ${JSON.stringify(t)}; it declares ${Object.keys(r).join(", ")}`,m.USAGE,{kind:n,event:t,declared:Object.keys(r)});return i}o(A,"eventSpec");export{A as eventSpec,N as invalidateCustomKind,J as isKind,g as kindNames,h as kindOf};
+var m=Object.defineProperty;var o=(t,n)=>m(t,"name",{value:n,configurable:!0});import{CrtrError as d}from"../../errors.js";import{ExitCode as u}from"../../../types.js";import{documentKind as l}from"./document.js";import{jobKind as w}from"./job.js";import{nodeKind as k}from"./node.js";import{actionKind as O}from"./action.js";import{ownerKinds as j}from"./owner.js";import{customKind as E}from"./custom.js";let f=null;function s(){return f??=new Map([l,k,O,w,...j].map(t=>[t.name,t])),f}o(s,"kinds");const a=new WeakMap;function $(t,n){a.get(t)?.delete(n)}o($,"invalidateCustomKind");async function y(t){return[...s().keys(),...(await t.prepare("SELECT name FROM object_kinds ORDER BY name").all()).map(n=>n.name)]}o(y,"kindNames");async function v(t,n){return s().has(n)||await p(t,n)!==null}o(v,"isKind");async function p(t,n){let e=a.get(t);e||(e=new Map,a.set(t,e));const i=e.get(n);if(i)return i;const r=await t.prepare("SELECT events_json FROM object_kinds WHERE name = ?").get(n);if(!r)return null;const c=E(n,JSON.parse(r.events_json));return e.set(n,c),c}o(p,"kindOfCustom");async function g(t,n){const e=s().get(n)??await p(t,n);if(e==null)throw new d("unknown_kind",`no object kind named ${JSON.stringify(n)}; the kinds are ${(await y(t)).join(", ")}`,u.USAGE,{kind:n});return e}o(g,"kindOf");async function N(t,n,e){const i=(await g(t,n)).events,r=Object.hasOwn(i,e)?i[e]:void 0;if(r===void 0)throw new d("unknown_event",`${n} declares no event ${JSON.stringify(e)}; it declares ${Object.keys(i).join(", ")}`,u.USAGE,{kind:n,event:e,declared:Object.keys(i)});return r}o(N,"eventSpec");export{N as eventSpec,$ as invalidateCustomKind,v as isKind,y as kindNames,g as kindOf};

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

@@ -1,5 +1,5 @@
-import type { DatabaseSync } from 'node:sqlite';
 import type { ObjectRow, Reader } from './types.js';
+import type { CanvasDb } from '../canvas/db.js';
 export type Resolution = {
     object: ObjectRow;
 } | {
@@ -14,7 +14,7 @@ export type Resolution = {
 /** The owners a bare name is looked up under, in order: own node, repos nearest
  *  first, the profile's project repos, profile, app, you, then the apps whose tools the run may use (installed
  *  plugins) with `crtr` last. */
-export declare function viewOf(db: DatabaseSync, reader: Reader): ObjectRow[];
+export declare function viewOf(db: CanvasDb, reader: Reader): Promise<ObjectRow[]>;
 /** The owner types that carry a handle; `<type>:<handle>/<name>` names one exactly. */
 export declare const HANDLE_TYPES: readonly ["person", "app", "repo", "profile"];
 /** A ref without its `[[ ]]` wrapper. */
@@ -23,7 +23,7 @@ export declare const unwrapRef: (raw: string) => string;
  *  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[];
+export declare function ownersByHandle(db: CanvasDb, handle: string, type?: string): Promise<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
  *  several owner types share, owners in the reader's view come first in view
@@ -32,11 +32,11 @@ export declare function ownersByHandle(db: DatabaseSync, handle: string, type?:
 /** Precomputed for one reader across many resolutions (a corpus names every document). */
 export interface ResolveContext {
     view: ObjectRow[];
-    readable: (o: ObjectRow) => boolean;
+    readable: (o: ObjectRow) => Promise<boolean>;
 }
-export declare function resolveName(db: DatabaseSync, reader: Reader, raw: string, context?: ResolveContext): Resolution;
+export declare function resolveName(db: CanvasDb, reader: Reader, raw: string, context?: ResolveContext): Promise<Resolution>;
 /** Every readable stub of another machine's object that `raw` (`<owner handle>/<name>`, `<type>:<owner handle>/<name>` or a bare name) names:
  *  empty when none does, more than one when the name is ambiguous. `resolveName` never answers a stub, so a stub cannot shadow a local
  *  object; this is the lookup a forwarding handler makes only after `resolveName` found no local object, to learn that the name belongs
  *  to an object another machine homes. */
-export declare function stubsNamed(db: DatabaseSync, reader: Reader, raw: string): ObjectRow[];
+export declare function stubsNamed(db: CanvasDb, reader: Reader, raw: string): Promise<ObjectRow[]>;

package/dist/core/graph/names.js

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

package/dist/core/graph/object-waits.d.ts

@@ -1,12 +1,9 @@
-/** A node's wait on a watched object: armed when a node starts watching an object whose kind declares an
- *  event with `endsWait` (a workflow run until `completed`), settled by `publish` when that event lands,
- *  by the node stopping its watch, or by the node ending. The rows live in `waits` (kind `object`). */
-import type { DatabaseSync } from 'node:sqlite';
 import type { ObjectRow } from './types.js';
+import type { CanvasDb } from '../canvas/db.js';
 /** Whether an object of this kind is something a node waits on: one of its events ends a wait. */
-export declare function kindEndsWait(db: DatabaseSync, type: string): boolean;
+export declare function kindEndsWait(db: CanvasDb, type: string): Promise<boolean>;
 /** `watcher` (a node) started watching `object`: arm its wait when the object's kind has an ending event.
  *  A node of another machine has no `nodes` row here; its home arms the wait when peer ingest records the watch there. */
-export declare function armObjectWaitForWatch(db: DatabaseSync, watcher: ObjectRow, object: ObjectRow): void;
+export declare function armObjectWaitForWatch(db: CanvasDb, watcher: ObjectRow, object: ObjectRow): Promise<void>;
 /** `watcher` stopped watching `object` entirely: its wait on it is over. */
-export declare function settleObjectWaitForUnwatch(db: DatabaseSync, watcher: ObjectRow, object: ObjectRow): void;
+export declare function settleObjectWaitForUnwatch(db: CanvasDb, watcher: ObjectRow, object: ObjectRow): Promise<void>;

package/dist/core/graph/object-waits.js

@@ -1 +1 @@
-var r=Object.defineProperty;var n=(e,t)=>r(e,"name",{value:t,configurable:!0});import{armObjectWait as o,settleObjectWaits as f}from"../canvas/waits.js";import{kindOf as u}from"./kinds/registry.js";import{stubOf as m}from"../peer/stubs.js";function p(e,t){return Object.values(u(e,t).events).some(i=>i.endsWait===!0)}n(p,"kindEndsWait");function W(e,t,i){t.type!=="node"||m(e,t)!==null||!p(e,i.type)||o(e,t.id,i.id)}n(W,"armObjectWaitForWatch");function c(e,t,i){t.type==="node"&&f(e,i.id,t.id)}n(c,"settleObjectWaitForUnwatch");export{W as armObjectWaitForWatch,p as kindEndsWait,c as settleObjectWaitForUnwatch};
+var n=Object.defineProperty;var a=(i,t)=>n(i,"name",{value:t,configurable:!0});import{armObjectWait as r,settleObjectWaits as o}from"../canvas/waits.js";import{kindOf as s}from"./kinds/registry.js";import{stubOf as f}from"../peer/stubs.js";async function u(i,t){return Object.values((await s(i,t)).events).some(e=>e.endsWait===!0)}a(u,"kindEndsWait");async function O(i,t,e){t.type!=="node"||await f(i,t)!==null||!await u(i,e.type)||await r(i,t.id,e.id)}a(O,"armObjectWaitForWatch");async function W(i,t,e){t.type==="node"&&await o(i,e.id,t.id)}a(W,"settleObjectWaitForUnwatch");export{O as armObjectWaitForWatch,u as kindEndsWait,W as settleObjectWaitForUnwatch};

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

@@ -1,9 +1,9 @@
-import type { DatabaseSync } from 'node:sqlite';
 import type { ObjectRow, Privacy, Reader } from './types.js';
+import type { CanvasDb } from '../canvas/db.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: {
+export declare function getById(db: CanvasDb, id: string): Promise<ObjectRow | null>;
+export declare function getByRowid(db: CanvasDb, rowid: number): Promise<ObjectRow | null>;
+export declare function createObject(db: CanvasDb, spec: {
     id?: string;
     type: string;
     kind: string | null;
@@ -13,25 +13,25 @@ export declare function createObject(db: DatabaseSync, spec: {
     preview: string;
     /** Set for a stub, in the insert itself: the name indexes cover only rows without it. */
     home_machine?: string;
-}): ObjectRow;
+}): Promise<ObjectRow>;
 /** The owner object for an identity, created on first sight. Idempotent on
  *  (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: OwnerType, scheme: string, externalId: string, handle: string, owner?: ObjectRow): ObjectRow;
+export declare function ensureOwner(db: CanvasDb, type: OwnerType, scheme: string, externalId: string, handle: string, owner?: ObjectRow): Promise<ObjectRow>;
 /** Give the live profile object of `profileId` the handle `handle`, so `[[handle/x]]` links,
  *  `owner=` listings and `--owner profile:<handle>` follow a profile rename. Refuses with
  *  `conflict` — before changing anything — when another live profile object holds the handle.
  *  A profile with no object yet has nothing to rename (its object is created from the manifest name
  *  on first use). Returns whether an object was renamed. Links are edges to ids, so they keep resolving. */
-export declare function renameProfileObject(db: DatabaseSync, profileId: string, handle: string): boolean;
+export declare function renameProfileObject(db: CanvasDb, profileId: string, handle: string): Promise<boolean>;
 /** The owner object of a node grantee: `user:local` → person `user`; `app:<x>` → app `<x>`. */
-export declare function ownerForGrantee(db: DatabaseSync, grantee: string): ObjectRow;
+export declare function ownerForGrantee(db: CanvasDb, grantee: string): Promise<ObjectRow>;
 /** The owner's live document named `name`, or null. */
-export declare function liveDocumentNamed(db: DatabaseSync, owner: number, name: string): ObjectRow | null;
-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 declare function liveDocumentNamed(db: CanvasDb, owner: number, name: string): Promise<ObjectRow | null>;
+export declare function nodeObject(db: CanvasDb, nodeId: string): Promise<ObjectRow>;
+export declare function setObjectName(db: CanvasDb, object: ObjectRow, name: string): Promise<void>;
+export declare function setObjectKind(db: CanvasDb, object: ObjectRow, kind: string | null): Promise<void>;
 export interface ObjectFilter {
     type?: string;
     kind?: string;
@@ -45,7 +45,7 @@ export interface Page {
     after_rowid?: number;
 }
 /** Objects the reader can read, in rowid order. Records nothing. `limit` ≤ 100. */
-export declare function listObjects(db: DatabaseSync, reader: Reader, filter: ObjectFilter, page?: Page): ObjectRow[];
+export declare function listObjects(db: CanvasDb, reader: Reader, filter: ObjectFilter, page?: Page): Promise<ObjectRow[]>;
 export interface SearchQuery {
     text: string;
     body?: boolean;
@@ -61,4 +61,4 @@ export interface SearchHit {
  *  matches name, preview and document summary as a substring; `body` also scans
  *  each document's head bodies for the substring, and `grep` scans them for `text`
  *  as a regular expression. Body search reads every readable body: linear, no index. */
-export declare function searchObjects(db: DatabaseSync, reader: Reader, query: SearchQuery): SearchHit[];
+export declare function searchObjects(db: CanvasDb, reader: Reader, query: SearchQuery): Promise<SearchHit[]>;

package/dist/core/graph/objects.js

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

package/dist/core/graph/package-docs.d.ts

@@ -1,10 +1,5 @@
-/** Package documents: builtin (`crtr`) and plugin documents stay files in their package; this
- *  converges their `objects`/`documents` rows, their one revision and their rules onto those
- *  files (contract §6.6). Bodies are read from `documents.source_path`, never the body store.
- *  A plugin is an app: its documents belong to the app `<plugin>` (identity `app:<plugin>`,
- *  the one `ownerForGrantee` gives), and a document with a `source_path` is shipped. */
-import type { DatabaseSync } from 'node:sqlite';
 import { type QuarantinedPlugin } from '../plugin-quarantine.js';
+import type { CanvasDb } from '../canvas/db.js';
 export interface PackageSource {
     plugin: string;
     dir: string;
@@ -32,4 +27,4 @@ export interface PackageReconcileReport {
  *  each document's link edges, which land the same). A changed body replaces the
  *  document's single revision and publishes `edited`; a vanished file (or plugin) marks its
  *  document deleted and publishes `deleted`. */
-export declare function reconcilePackageDocuments(db: DatabaseSync, explicitSources?: readonly PackageSource[]): PackageReconcileReport;
+export declare function reconcilePackageDocuments(db: CanvasDb, explicitSources?: readonly PackageSource[]): Promise<PackageReconcileReport>;

package/dist/core/graph/package-docs.js

@@ -1,5 +1,5 @@
-var O=Object.defineProperty;var u=(e,s)=>O(e,"name",{value:s,configurable:!0});import{prepared as p}from"../sqlite-statements.js";import{createHash as _,randomUUID as D}from"node:crypto";import{CrtrError as N}from"../errors.js";import{emitEvent as I}from"../events/emit.js";import{quarantineBrokenPlugins as A}from"../plugin-quarantine.js";import{listInstalledPlugins as k}from"../resolver.js";import{builtinMemoryRoot as L,pluginMemoryDir as T}from"../scope.js";import{documentFields as j}from"../../migrations/004-canvas-documents/fields.js";import{applyDocumentFields as R,deleteDocument as x,documentRecord as U,heads as F,importDocument as b,linksIn as J,moveDocument as C}from"./documents.js";import{isShipped as H}from"./access.js";import{setLinks as W}from"./edges.js";import{publish as M}from"./events.js";import{resolveName as P}from"./names.js";import{packageFiles as q}from"./package-files.js";import{ensureOwner as B,getByRowid as E,setObjectKind as K}from"./objects.js";import{checkoutsForCwd as $}from"./repo-sync/repos.js";import{rulesOf as z}from"./rules.js";function G(){return[{plugin:"crtr",dir:L()},...k("user").filter(e=>e.enabled).map(e=>({plugin:e.name,dir:T(e)}))]}u(G,"packageSources");const Q=u(e=>_("sha256").update(e,"utf8").digest("hex"),"sha256");function ge(e,s){const n={created:0,updated:0,deleted:0,conflicts:[],invalid:[],quarantined:[]};if(s===void 0){n.quarantined=A();for(const t of n.quarantined)I({level:"error",event:"daemon.plugins.quarantined",fields:{plugin:t.name,file:t.file,reason:t.reason,...t.movedTo!==void 0?{moved_to:t.movedTo}:{}}})}const f=s??G(),m=u(t=>$(e,t),"reposFn"),r=new Set,i=[],w=new Set;for(const t of f){let a;try{if(w.has(t.plugin))throw new N("conflict",`plugin "${t.plugin}" is already provided by another package`);w.add(t.plugin),a=B(e,"app","app",`app:${t.plugin}`,t.plugin)}catch(d){if(!(d instanceof N)||d.code!=="conflict")throw d;n.conflicts.push({plugin:t.plugin,message:d.message});continue}r.add(a.rowid);const{files:l,invalid:g}=q(t.dir);n.invalid.push(...g);const h=new Set;for(const d of l){const c=X(e,a,d,n,m);h.add(c),i.push({owner:a,rowid:c,body:d.body})}v(e,a,h,n,m)}const o=p(e,`SELECT DISTINCT o.owner AS rowid FROM objects o JOIN documents d ON d.object = o.rowid
-    WHERE o.type = 'document' AND o.deleted_at IS NULL AND d.source_path IS NOT NULL`).all();for(const{rowid:t}of o)r.has(t)||v(e,E(e,t),new Set,n,m);for(const{owner:t,rowid:a,body:l}of i)V(e,t,E(e,a),l);return n}u(ge,"reconcilePackageDocuments");function V(e,s,n,f){if(n.deleted_at!==null)return;const m={class:"app",app:s,scopes:[]},r=[];for(const o of J(f)){const t=P(e,m,o);"object"in t&&t.object.rowid!==n.rowid&&H(e,t.object)&&r.push({written_as:o,dst:t.object})}const i=u(o=>JSON.stringify(o.map(t=>[t.dst,t.written_as]).sort()),"key"),w=p(e,"SELECT dst, written_as FROM edges WHERE type = 'links-to' AND src = ?").all(n.rowid);i(w)!==i(r.map(o=>({dst:o.dst.rowid,written_as:o.written_as})))&&W(e,n,r)}u(V,"deriveLinks");function X(e,s,n,f,m){const r=j(n.frontmatter,n.body,{missingPrivacy:"public"}),i={preview:r.preview.trim()===""?n.name:r.preview,summary:r.summary,whyItExists:r.whyItExists,unlisted:r.unlisted,rules:r.rules,lintIgnore:Array.isArray(r.lintIgnore)?r.lintIgnore.filter(c=>typeof c=="string"):null,extensions:r.extensions!==null&&typeof r.extensions=="object"&&!Array.isArray(r.extensions)?r.extensions:null},w=Q(n.body);let o=p(e,`SELECT o.* FROM objects o JOIN documents d ON d.object = o.rowid
-    WHERE o.type = 'document' AND o.owner = ? AND o.deleted_at IS NULL AND d.source_path = ?`).get(s.rowid,n.path);if(o||(o=p(e,`SELECT o.* FROM objects o JOIN documents d ON d.object = o.rowid
-      WHERE o.type = 'document' AND o.owner = ? AND o.deleted_at IS NULL AND o.name = ? AND d.source_path IS NOT NULL`).get(s.rowid,n.name),o&&p(e,"UPDATE documents SET source_path = ? WHERE object = ?").run(n.path,o.rowid)),!o){const c=b(e,{owner:s,name:n.name,kind:r.kind,privacy:"public",...i,revisions:[{body_hash:w,author:s,rationale:null,created_at:new Date().toISOString()}]});return p(e,"UPDATE documents SET source_path = ? WHERE object = ?").run(n.path,c.rowid),f.created+=1,c.rowid}const t=o.name!==n.name||o.kind!==r.kind;o.name!==n.name&&(o=C(e,null,o,{name:n.name})),o.kind!==r.kind&&(K(e,o,r.kind),o=E(e,o.rowid));const a=U(e,o),[l]=F(e,o),g=l?.body_hash!==w,h=o.preview!==i.preview||a.summary!==i.summary||a.why_it_exists!==i.whyItExists||a.unlisted!==i.unlisted||JSON.stringify(a.lint_ignore)!==JSON.stringify(i.lintIgnore)||JSON.stringify(a.extensions)!==JSON.stringify(i.extensions)||JSON.stringify(z(e,o).map(S))!==JSON.stringify(i.rules.map(S));if(!g&&!h&&!t)return o.rowid;const d=R(e,o,i);if(g&&l){const c=D(),y=l.number+1;p(e,"UPDATE revisions SET rev_id = ?, number = ?, body_hash = ?, created_at = ? WHERE rowid = ?").run(c,y,w,new Date().toISOString(),l.rowid),p(e,"UPDATE documents SET heads_key = ?, revision = ? WHERE object = ?").run(c,y,d.rowid),M(e,{event:"edited",object:d,actor:s,pointer:c,attrs:{revision:y,from_revision:l.number,rationale:"package file changed"}},m)}return f.updated+=1,d.rowid}u(X,"convergeFile");function S(e){return[e.on,e.deliver,e.match??null,e.matchFrontmatter??null,e.if??null]}u(S,"ruleKey");function v(e,s,n,f,m){const r=p(e,`SELECT o.* FROM objects o JOIN documents d ON d.object = o.rowid
-    WHERE o.type = 'document' AND o.owner = ? AND o.deleted_at IS NULL AND d.source_path IS NOT NULL`).all(s.rowid);for(const i of r)n.has(i.rowid)||(x(e,null,i,m),f.deleted+=1)}u(v,"deleteMissing");export{G as packageSources,ge as reconcilePackageDocuments};
+var v=Object.defineProperty;var u=(e,a)=>v(e,"name",{value:a,configurable:!0});import{createHash as O,randomUUID as _}from"node:crypto";import{CrtrError as E}from"../errors.js";import{emitEvent as D}from"../events/emit.js";import{quarantineBrokenPlugins as I}from"../plugin-quarantine.js";import{listInstalledPlugins as A}from"../resolver.js";import{builtinMemoryRoot as k,pluginMemoryDir as L}from"../scope.js";import{documentFields as T}from"../../migrations/004-canvas-documents/fields.js";import{applyDocumentFields as j,deleteDocument as R,documentRecord as x,heads as U,importDocument as F,linksIn as b,moveDocument as J}from"./documents.js";import{isShipped as C}from"./access.js";import{setLinks as H}from"./edges.js";import{publish as W}from"./events.js";import{resolveName as M}from"./names.js";import{packageFiles as P}from"./package-files.js";import{ensureOwner as q,getByRowid as h,setObjectKind as B}from"./objects.js";import{checkoutsForCwd as K}from"./repo-sync/repos.js";import{rulesOf as $}from"./rules.js";function z(){return[{plugin:"crtr",dir:k()},...A("user").filter(e=>e.enabled).map(e=>({plugin:e.name,dir:L(e)}))]}u(z,"packageSources");const G=u(e=>O("sha256").update(e,"utf8").digest("hex"),"sha256");async function we(e,a){const n={created:0,updated:0,deleted:0,conflicts:[],invalid:[],quarantined:[]};if(a===void 0){n.quarantined=I();for(const o of n.quarantined)D({level:"error",event:"daemon.plugins.quarantined",fields:{plugin:o.name,file:o.file,reason:o.reason,...o.movedTo!==void 0?{moved_to:o.movedTo}:{}}})}const l=a??z(),p=u(async o=>await K(e,o),"reposFn"),i=new Set,r=[],w=new Set;for(const o of l){let s;try{if(w.has(o.plugin))throw new E("conflict",`plugin "${o.plugin}" is already provided by another package`);w.add(o.plugin),s=await q(e,"app","app",`app:${o.plugin}`,o.plugin)}catch(c){if(!(c instanceof E)||c.code!=="conflict")throw c;n.conflicts.push({plugin:o.plugin,message:c.message});continue}i.add(s.rowid);const{files:m,invalid:f}=P(o.dir);n.invalid.push(...f);const y=new Set;for(const c of m){const d=await V(e,s,c,n,p);y.add(d),r.push({owner:s,rowid:d,body:c.body})}await S(e,s,y,n,p)}const t=await e.prepare(`SELECT DISTINCT o.owner AS rowid FROM objects o JOIN documents d ON d.object = o.rowid
+    WHERE o.type = 'document' AND o.deleted_at IS NULL AND d.source_path IS NOT NULL`).all();for(const{rowid:o}of t)i.has(o)||await S(e,await h(e,o),new Set,n,p);for(const{owner:o,rowid:s,body:m}of r)await Q(e,o,await h(e,s),m);return n}u(we,"reconcilePackageDocuments");async function Q(e,a,n,l){if(n.deleted_at!==null)return;const p={class:"app",app:a,scopes:[]},i=[];for(const t of b(l)){const o=await M(e,p,t);"object"in o&&o.object.rowid!==n.rowid&&await C(e,o.object)&&i.push({written_as:t,dst:o.object})}const r=u(t=>JSON.stringify(t.map(o=>[o.dst,o.written_as]).sort()),"key"),w=await e.prepare("SELECT dst, written_as FROM edges WHERE type = 'links-to' AND src = ?").all(n.rowid);r(w)!==r(i.map(t=>({dst:t.dst.rowid,written_as:t.written_as})))&&await H(e,n,i)}u(Q,"deriveLinks");async function V(e,a,n,l,p){const i=T(n.frontmatter,n.body,{missingPrivacy:"public"}),r={preview:i.preview.trim()===""?n.name:i.preview,summary:i.summary,whyItExists:i.whyItExists,unlisted:i.unlisted,rules:i.rules,lintIgnore:Array.isArray(i.lintIgnore)?i.lintIgnore.filter(d=>typeof d=="string"):null,extensions:i.extensions!==null&&typeof i.extensions=="object"&&!Array.isArray(i.extensions)?i.extensions:null},w=G(n.body);let t=await e.prepare(`SELECT o.* FROM objects o JOIN documents d ON d.object = o.rowid
+    WHERE o.type = 'document' AND o.owner = ? AND o.deleted_at IS NULL AND d.source_path = ?`).get(a.rowid,n.path);if(t||(t=await e.prepare(`SELECT o.* FROM objects o JOIN documents d ON d.object = o.rowid
+      WHERE o.type = 'document' AND o.owner = ? AND o.deleted_at IS NULL AND o.name = ? AND d.source_path IS NOT NULL`).get(a.rowid,n.name),t&&await e.prepare("UPDATE documents SET source_path = ? WHERE object = ?").run(n.path,t.rowid)),!t){const d=await F(e,{owner:a,name:n.name,kind:i.kind,privacy:"public",...r,revisions:[{body_hash:w,author:a,rationale:null,created_at:new Date().toISOString()}]});return await e.prepare("UPDATE documents SET source_path = ? WHERE object = ?").run(n.path,d.rowid),l.created+=1,d.rowid}const o=t.name!==n.name||t.kind!==i.kind;t.name!==n.name&&(t=await J(e,null,t,{name:n.name})),t.kind!==i.kind&&(await B(e,t,i.kind),t=await h(e,t.rowid));const s=await x(e,t),[m]=await U(e,t),f=m?.body_hash!==w,y=t.preview!==r.preview||s.summary!==r.summary||s.why_it_exists!==r.whyItExists||s.unlisted!==r.unlisted||JSON.stringify(s.lint_ignore)!==JSON.stringify(r.lintIgnore)||JSON.stringify(s.extensions)!==JSON.stringify(r.extensions)||JSON.stringify((await $(e,t)).map(N))!==JSON.stringify(r.rules.map(N));if(!f&&!y&&!o)return t.rowid;const c=await j(e,t,r);if(f&&m){const d=_(),g=m.number+1;await e.prepare("UPDATE revisions SET rev_id = ?, number = ?, body_hash = ?, created_at = ? WHERE rowid = ?").run(d,g,w,new Date().toISOString(),m.rowid),await e.prepare("UPDATE documents SET heads_key = ?, revision = ? WHERE object = ?").run(d,g,c.rowid),await W(e,{event:"edited",object:c,actor:a,pointer:d,attrs:{revision:g,from_revision:m.number,rationale:"package file changed"}},p)}return l.updated+=1,c.rowid}u(V,"convergeFile");function N(e){return[e.on,e.deliver,e.match??null,e.matchFrontmatter??null,e.if??null]}u(N,"ruleKey");async function S(e,a,n,l,p){const i=await e.prepare(`SELECT o.* FROM objects o JOIN documents d ON d.object = o.rowid
+    WHERE o.type = 'document' AND o.owner = ? AND o.deleted_at IS NULL AND d.source_path IS NOT NULL`).all(a.rowid);for(const r of i)n.has(r.rowid)||(await R(e,null,r,p),l.deleted+=1)}u(S,"deleteMissing");export{z as packageSources,we as reconcilePackageDocuments};

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

@@ -1,7 +1,4 @@
-/** Installed plugins' `object_kinds` blocks → `object_kinds` rows. Runs in the caller's write transaction.
- *  A kind is never deleted and its catalog is never altered when undeclared: only `declared` flips, so the
- *  instances of a dropped kind go inert instead of vanishing. */
-import type { DatabaseSync } from 'node:sqlite';
+import type { CanvasDb } from '../canvas/db.js';
 export interface KindsReport {
     /** every kind a valid plugin declares that now has its row, and what upserting it did */
     applied: Array<{
@@ -22,4 +19,4 @@ export interface KindsReport {
         error: string;
     }>;
 }
-export declare function reconcilePackageKinds(db: DatabaseSync): KindsReport;
+export declare function reconcilePackageKinds(db: CanvasDb): Promise<KindsReport>;

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

@@ -1 +1 @@
-var f=Object.defineProperty;var d=(o,i)=>f(o,"name",{value:i,configurable:!0});import{CrtrError as p}from"../errors.js";import{invalidAppPlugins as l,kindPlugins as g}from"../plugin-app.js";import{prepared as m}from"../sqlite-statements.js";import{upsertKind as h}from"./custom.js";import{ensureOwner as k}from"./objects.js";function S(o){const i={applied:[],refused:[],invalid:l().map(e=>({plugin:e.plugin.name,error:e.error}))},a=new Set;for(const e of g()){const c=Object.entries(e.manifest.object_kinds??{});if(c.length===0)continue;let s;try{s=k(o,"app","app",`app:${e.name}`,e.name)}catch(n){if(!(n instanceof p)||n.code!=="conflict")throw n;i.invalid.push({plugin:e.name,error:n.message});continue}for(const[n,t]of c)try{const r=h(o,{name:n,owner:s,description:t.description,events:t.events,read:t.read===void 0?null:{command:t.read.command},source:"manifest"});if(r.outcome==="skipped")continue;a.add(n),i.applied.push({plugin:e.name,kind:n,outcome:r.outcome})}catch(r){if(!(r instanceof p)||r.code!=="kind_owned")throw r;i.refused.push({plugin:e.name,kind:n,code:"kind_owned",message:r.message})}}const u=m(o,"SELECT name FROM object_kinds WHERE source = 'manifest' AND declared = 1").all();for(const{name:e}of u)a.has(e)||m(o,"UPDATE object_kinds SET declared = 0 WHERE name = ?").run(e);return i}d(S,"reconcilePackageKinds");export{S as reconcilePackageKinds};
+var u=Object.defineProperty;var d=(o,i)=>u(o,"name",{value:i,configurable:!0});import{CrtrError as p}from"../errors.js";import{invalidAppPlugins as l,kindPlugins as f}from"../plugin-app.js";import{upsertKind as g}from"./custom.js";import{ensureOwner as w}from"./objects.js";async function j(o){const i={applied:[],refused:[],invalid:l().map(e=>({plugin:e.plugin.name,error:e.error}))},t=new Set;for(const e of f()){const s=Object.entries(e.manifest.object_kinds??{});if(s.length===0)continue;let c;try{c=await w(o,"app","app",`app:${e.name}`,e.name)}catch(n){if(!(n instanceof p)||n.code!=="conflict")throw n;i.invalid.push({plugin:e.name,error:n.message});continue}for(const[n,a]of s)try{const r=await g(o,{name:n,owner:c,description:a.description,events:a.events,read:a.read===void 0?null:{command:a.read.command},source:"manifest"});if(r.outcome==="skipped")continue;t.add(n),i.applied.push({plugin:e.name,kind:n,outcome:r.outcome})}catch(r){if(!(r instanceof p)||r.code!=="kind_owned")throw r;i.refused.push({plugin:e.name,kind:n,code:"kind_owned",message:r.message})}}const m=await o.prepare("SELECT name FROM object_kinds WHERE source = 'manifest' AND declared = 1").all();for(const{name:e}of m)t.has(e)||await o.prepare("UPDATE object_kinds SET declared = 0 WHERE name = ?").run(e);return i}d(j,"reconcilePackageKinds");export{j as reconcilePackageKinds};

package/dist/core/graph/package-reconcile.d.ts

@@ -1,9 +1,6 @@
-/** The one package reconcile pass: documents, then kinds, then plugin app tokens. Runs in the caller's write
- *  transaction. The token writes go to the secrets store and are idempotent, so a rolled-back pass re-converges
- *  on the next one. */
-import type { DatabaseSync } from 'node:sqlite';
 import { type KindsReport } from './package-kinds.js';
 import { type PackageReconcileReport } from './package-docs.js';
+import type { CanvasDb } from '../canvas/db.js';
 export interface TokensReport {
     /** plugins holding a `crtr_app_` token, with the manifest scopes it carries */
     granted: Array<{
@@ -17,4 +14,4 @@ export interface PackagesReport extends PackageReconcileReport {
     kinds: KindsReport;
     tokens: TokensReport;
 }
-export declare function reconcilePackages(db: DatabaseSync): PackagesReport;
+export declare function reconcilePackages(db: CanvasDb): Promise<PackagesReport>;

package/dist/core/graph/package-reconcile.js

@@ -1 +1 @@
-var a=Object.defineProperty;var p=(o,t)=>a(o,"name",{value:t,configurable:!0});import{appPlugins as u}from"../plugin-app.js";import{ensurePluginAppToken as f,listScopedApiTokens as g,revokePluginAppTokens as l}from"../secrets.js";import{reconcilePackageKinds as m}from"./package-kinds.js";import{reconcilePackageDocuments as d}from"./package-docs.js";function S(o){const t=d(o),i=m(o),s={granted:[],revoked:[]},r=new Set;for(const e of u()){const n=e.manifest.scopes??[];f(e.name,n),r.add(e.name),s.granted.push({plugin:e.name,scopes:[...n]})}const c=new Set;for(const e of g("user")){if(!e.token.startsWith("crtr_app_")||!e.grantee.startsWith("app:"))continue;const n=e.grantee.slice(4);r.has(n)||c.add(n)}for(const e of c)l(e)&&s.revoked.push(e);return{...t,kinds:i,tokens:s}}p(S,"reconcilePackages");export{S as reconcilePackages};
+var p=Object.defineProperty;var a=(o,t)=>p(o,"name",{value:t,configurable:!0});import{appPlugins as u}from"../plugin-app.js";import{ensurePluginAppToken as f,listScopedApiTokens as g,revokePluginAppTokens as l}from"../secrets.js";import{reconcilePackageKinds as m}from"./package-kinds.js";import{reconcilePackageDocuments as d}from"./package-docs.js";async function A(o){const t=await d(o),i=await m(o),s={granted:[],revoked:[]},r=new Set;for(const e of u()){const n=e.manifest.scopes??[];f(e.name,n),r.add(e.name),s.granted.push({plugin:e.name,scopes:[...n]})}const c=new Set;for(const e of g("user")){if(!e.token.startsWith("crtr_app_")||!e.grantee.startsWith("app:"))continue;const n=e.grantee.slice(4);r.has(n)||c.add(n)}for(const e of c)l(e)&&s.revoked.push(e);return{...t,kinds:i,tokens:s}}a(A,"reconcilePackages");export{A as reconcilePackages};

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

@@ -1,43 +1,43 @@
-import type { DatabaseSync } from 'node:sqlite';
 import type { RequestPrincipal } from '../../daemon/api/router.js';
 import { type ActiveGrant } from '../grants/mirror.js';
+import { type CanvasDb } from '../canvas/db.js';
 import type { Checkout, ObjectRow, Reader } from './types.js';
 /** The repos enclosing a directory, with their checkout roots, nearest first. */
-export type ReposFn = (cwd: string) => Checkout[];
+export type ReposFn = (cwd: string) => Promise<Checkout[]>;
 /** A node's view of repos: the ones enclosing its cwd, then those of each project path of its profile
  *  (manifest order), each repo once. A project path that no longer exists, is not in a repo, or has no
  *  work tree (a bare repository) contributes nothing. */
-export declare function viewRepos(cwd: string, profileId: string | null, reposFn: ReposFn, lookups: Pick<ReaderLookups, 'projectPaths'>): Pick<Extract<Reader, {
+export declare function viewRepos(cwd: string, profileId: string | null, reposFn: ReposFn, lookups: Pick<ReaderLookups, 'projectPaths'>): Promise<Pick<Extract<Reader, {
     class: 'node';
-}>, 'repos' | 'checkouts' | 'projectRepos' | 'projectCheckouts'>;
-export declare function readerFor(db: DatabaseSync, principal: RequestPrincipal, reposFn: ReposFn): Exclude<Reader, {
+}>, 'repos' | 'checkouts' | 'projectRepos' | 'projectCheckouts'>>;
+export declare function readerFor(db: CanvasDb, principal: RequestPrincipal, reposFn: ReposFn): Promise<Exclude<Reader, {
     class: 'object';
-}>;
-export declare function readerForNode(db: DatabaseSync, nodeId: string, reposFn: ReposFn, lookups?: ReaderLookups, allowRevoked?: boolean): Extract<Reader, {
+}>>;
+export declare function readerForNode(db: CanvasDb, nodeId: string, reposFn: ReposFn, lookups?: ReaderLookups, allowRevoked?: boolean): Promise<Extract<Reader, {
     class: 'node';
-}>;
+}>>;
 /** A receiving object reads using its owner's app grant, not its registering caller's rights. */
-export declare function readerForObject(db: DatabaseSync, watcher: ObjectRow, reposFn?: ReposFn, lookups?: ReaderLookups): Extract<Reader, {
+export declare function readerForObject(db: CanvasDb, watcher: ObjectRow, reposFn?: ReposFn, lookups?: ReaderLookups): Promise<Extract<Reader, {
     class: 'node' | 'object';
-}>;
+}>>;
 /** The scopes `app` (an app object) holds now: its one active grant's always-scopes, or a local plugin's `crtr_app_` token scopes when it has no
  *  grant; null for several grants or none that applies. The same rule as an app-owned object's reader (`readerForObject`). */
-export declare function appScopesNow(db: DatabaseSync, app: ObjectRow, lookups: ReaderLookups): readonly string[] | null;
+export declare function appScopesNow(db: CanvasDb, app: ObjectRow, lookups: ReaderLookups): Promise<readonly string[] | null>;
 /** What building a node reader looks up besides the node's own row. `liveLookups` reads each
  *  one per call; `publishLookups` memoizes them for one publish inside its transaction, so the
  *  readers of one event share a single config read and one lookup per grant, owner and
  *  profile. Never keep a memoized one past that transaction. */
 export interface ReaderLookups {
-    grantById(grantId: string): ActiveGrant | null;
-    grantFor(app: string, sub: string): ActiveGrant | null;
+    grantById(grantId: string): Promise<ActiveGrant | null>;
+    grantFor(app: string, sub: string): Promise<ActiveGrant | null>;
     terminalHasIssuer(): boolean;
     /** The scopes of the `crtr_app_` token a local plugin's app (`app:<plugin>`) holds, or null when it holds none. */
     pluginScopes(grantee: string): readonly string[] | null;
-    object(rowid: number): ObjectRow | null;
-    profile(profileId: string, app: ObjectRow): ObjectRow;
+    object(rowid: number): Promise<ObjectRow | null>;
+    profile(profileId: string, app: ObjectRow): Promise<ObjectRow>;
     /** The profile's project paths in manifest order; none in a sandboxed node, whose profile store is unreadable. */
     projectPaths(profileId: string): readonly string[];
 }
-export declare function liveLookups(db: DatabaseSync): ReaderLookups;
-export declare function publishLookups(db: DatabaseSync): ReaderLookups;
-export declare function profileObject(db: DatabaseSync, profileId: string, app: ObjectRow): ObjectRow;
+export declare function liveLookups(db: CanvasDb): ReaderLookups;
+export declare function publishLookups(db: CanvasDb): ReaderLookups;
+export declare function profileObject(db: CanvasDb, profileId: string, app: ObjectRow): Promise<ObjectRow>;