@north-light/crouter 0.3.318 → 0.3.320

package/dist/core/feed/messages.js

@@ -1,217 +1,11 @@
-import { existsSync, mkdirSync, renameSync, writeFileSync } from 'node:fs';
-import { randomBytes, randomUUID } from 'node:crypto';
-import { join } from 'node:path';
-import { cancelCronsOnWake } from '../canvas/crons.js';
-import { withCanvasWrite } from '../canvas/db.js';
-import { getRow } from '../canvas/canvas.js';
-import { messagesDir } from '../canvas/paths.js';
-import { syncDirectory, syncFile } from '../fs-utils.js';
-import { settleDeadControllerWait, settleMatchingControllerWait } from '../canvas/waits.js';
-import { generateOperationId, operationIdContext, validateOperationId } from '../events/operation-id.js';
-import { clipBody } from './inbox.js';
-function newId() {
-    let id;
-    do
-        id = randomBytes(16).toString('hex');
-    while (id === '00000000000000000000000000000000');
-    return id;
-}
-function stringify(value, name) {
-    const json = JSON.stringify(value);
-    if (json === undefined)
-        throw new TypeError(`${name} must be JSON-serializable`);
-    return json;
-}
-function effectiveTier(nodeId, urgency) {
-    if (urgency !== 'normal' && urgency !== 'deferred')
-        return urgency;
-    return getRow(nodeId)?.lifecycle === 'terminal' ? 'urgent' : urgency;
-}
-function writeMessageBody(nodeId, createdAt, body) {
-    const dir = messagesDir(nodeId);
-    if (!existsSync(dir))
-        mkdirSync(dir, { recursive: true });
-    const stamp = createdAt.replace(/[^0-9]/g, '');
-    const finalPath = join(dir, `${stamp}-${randomUUID().slice(0, 6)}.md`);
-    const temporaryPath = `${finalPath}.tmp`;
-    writeFileSync(temporaryPath, body, 'utf8');
-    syncFile(temporaryPath);
-    renameSync(temporaryPath, finalPath);
-    syncDirectory(dir);
-    return finalPath;
-}
-function inlineBody(bodyJson) {
-    if (typeof bodyJson !== 'object' || bodyJson === null)
-        return '';
-    const body = bodyJson['body'];
-    return typeof body === 'string' ? body.trim() : '';
-}
-function insertMessage(db, input) {
-    const messageId = input.messageId ?? newId();
-    const seq = Number(db.prepare('SELECT COALESCE(MAX(seq), 0) AS seq FROM messages').get().seq) + 1;
-    db.prepare(`INSERT INTO messages
+var v=Object.defineProperty;var s=(n,e)=>v(n,"name",{value:e,configurable:!0});import{existsSync as S,mkdirSync as k,renameSync as O,writeFileSync as A}from"node:fs";import{randomBytes as R,randomUUID as D}from"node:crypto";import{join as h}from"node:path";import{cancelCronsOnWake as _}from"../canvas/crons.js";import{withCanvasWrite as c}from"../canvas/db.js";import{getRow as T}from"../canvas/canvas.js";import{messagesDir as L}from"../canvas/paths.js";import{syncDirectory as b,syncFile as x}from"../fs-utils.js";import{settleDeadControllerWait as C,settleMatchingControllerWait as f}from"../canvas/waits.js";import{generateOperationId as g,operationIdContext as p,validateOperationId as J}from"../events/operation-id.js";import{clipBody as M}from"./inbox.js";function m(){let n;do n=R(16).toString("hex");while(n==="00000000000000000000000000000000");return n}s(m,"newId");function u(n,e){const d=JSON.stringify(n);if(d===void 0)throw new TypeError(`${e} must be JSON-serializable`);return d}s(u,"stringify");function I(n,e){return e!=="normal"&&e!=="deferred"?e:T(n)?.lifecycle==="terminal"?"urgent":e}s(I,"effectiveTier");function W(n,e,d){const r=L(n);S(r)||k(r,{recursive:!0});const o=e.replace(/[^0-9]/g,""),t=h(r,`${o}-${D().slice(0,6)}.md`),i=`${t}.tmp`;return A(i,d,"utf8"),x(i),O(i,t),b(r),t}s(W,"writeMessageBody");function U(n){if(typeof n!="object"||n===null)return"";const e=n.body;return typeof e=="string"?e.trim():""}s(U,"inlineBody");function y(n,e){const d=e.messageId??m(),r=Number(n.prepare("SELECT COALESCE(MAX(seq), 0) AS seq FROM messages").get().seq)+1;return n.prepare(`INSERT INTO messages
        (message_id, seq, operation_id, created_at, sender_node_id, sender_name, kind, label, body_ref, body_json, disposition)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(messageId, seq, input.operationId, input.createdAt, input.senderNodeId, input.senderName, input.kind, input.label, input.bodyRef, input.bodyJson === undefined ? null : stringify(input.bodyJson, 'message body'), input.disposition);
-    return messageId;
-}
-function insertNodeDelivery(db, messageId, destinationId, urgency, wake, now, idempotencyKey) {
-    const deliveryId = newId();
-    db.prepare(`INSERT INTO deliveries
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`).run(d,r,e.operationId,e.createdAt,e.senderNodeId,e.senderName,e.kind,e.label,e.bodyRef,e.bodyJson===void 0?null:u(e.bodyJson,"message body"),e.disposition),d}s(y,"insertMessage");function N(n,e,d,r,o,t,i){const a=m();return n.prepare(`INSERT INTO deliveries
        (delivery_id, message_id, destination_kind, destination_id, urgency, wake, state, idempotency_key, created_at, updated_at)
-     VALUES (?, ?, 'node_inbox', ?, ?, ?, 'pending', ?, ?, ?)`).run(deliveryId, messageId, destinationId, urgency, wake, idempotencyKey ?? null, now, now);
-    return deliveryId;
-}
-function finalizeNodeMail(input, destinationNodeId) {
-    const createdAt = new Date().toISOString();
-    const operationId = input.operationId === undefined
-        ? operationIdContext.current() ?? generateOperationId()
-        : validateOperationId(input.operationId);
-    let bodyRef = input.bodyRef ?? null;
-    let bodyJson = input.bodyJson;
-    if (bodyRef === null) {
-        const body = inlineBody(bodyJson);
-        const clipped = clipBody(body);
-        if (clipped.clipped) {
-            // The destination owns the referenced body. Publish the file before its reference enters the transaction.
-            bodyRef = writeMessageBody(destinationNodeId, createdAt, body);
-            bodyJson = { ...bodyJson, body: clipped.text };
-        }
-    }
-    return { createdAt, operationId, bodyRef, bodyJson };
-}
-/** Insert one immutable message and one node-inbox obligation into the caller's write transaction. */
-export function enqueueNodeMail(destinationNodeId, input) {
-    const prepared = finalizeNodeMail(input, destinationNodeId);
-    return withCanvasWrite((db) => {
-        if (input.idempotencyKey !== undefined) {
-            const existing = db.prepare(`SELECT d.delivery_id, d.message_id, d.urgency, m.created_at
-        FROM deliveries d JOIN messages m ON m.message_id = d.message_id WHERE d.idempotency_key = ?`).get(input.idempotencyKey);
-            if (existing !== undefined)
-                return { messageId: existing.message_id, deliveryId: existing.delivery_id, urgency: existing.urgency, createdAt: existing.created_at };
-        }
-        const now = Date.now();
-        const urgency = effectiveTier(destinationNodeId, input.urgency);
-        const messageId = insertMessage(db, {
-            operationId: prepared.operationId,
-            createdAt: prepared.createdAt,
-            senderNodeId: input.senderNodeId ?? null,
-            senderName: input.senderName ?? null,
-            kind: input.kind,
-            label: input.label,
-            bodyRef: prepared.bodyRef,
-            bodyJson: prepared.bodyJson,
-            disposition: input.disposition ?? null,
-        });
-        const deliveryId = insertNodeDelivery(db, messageId, destinationNodeId, urgency, input.wake, now, input.idempotencyKey);
-        settleMatchingControllerWait(destinationNodeId, input.senderNodeId ?? null, now, db);
-        if (input.wake === 1 && urgency !== 'deferred')
-            cancelCronsOnWake(destinationNodeId);
-        return { messageId, deliveryId, urgency, createdAt: prepared.createdAt };
-    });
-}
-/** Fan out one immutable report message to the supplied subscriber snapshot. */
-export function enqueueSubscriberMail(subscribers, input) {
-    if (subscribers.length === 0)
-        return [];
-    const prepared = finalizeNodeMail(input, subscribers[0].node_id);
-    return withCanvasWrite((db) => {
-        const now = Date.now();
-        const messageId = insertMessage(db, {
-            operationId: prepared.operationId,
-            createdAt: prepared.createdAt,
-            senderNodeId: input.senderNodeId ?? null,
-            senderName: input.senderName ?? null,
-            kind: input.kind,
-            label: input.label,
-            bodyRef: prepared.bodyRef,
-            bodyJson: prepared.bodyJson,
-            disposition: input.disposition ?? null,
-        });
-        return subscribers.map((subscriber) => {
-            const urgency = effectiveTier(subscriber.node_id, input.urgency);
-            const wake = subscriber.active ? 1 : 0;
-            const deliveryId = insertNodeDelivery(db, messageId, subscriber.node_id, urgency, wake, now);
-            settleMatchingControllerWait(subscriber.node_id, input.senderNodeId ?? null, now, db);
-            if (wake === 1 && urgency !== 'deferred')
-                cancelCronsOnWake(subscriber.node_id);
-            return { destinationNodeId: subscriber.node_id, messageId, deliveryId, urgency, createdAt: prepared.createdAt };
-        });
-    });
-}
-/** Insert one frozen external-action obligation. A duplicate idempotency key returns its original identity. */
-export function enqueueExternalAction(input) {
-    return withCanvasWrite((db) => {
-        const existing = db.prepare('SELECT delivery_id, message_id FROM deliveries WHERE idempotency_key = ?').get(input.idempotencyKey);
-        if (existing !== undefined)
-            return { messageId: existing.message_id, deliveryId: existing.delivery_id };
-        const now = Date.now();
-        const messageId = insertMessage(db, {
-            operationId: operationIdContext.current() ?? generateOperationId(),
-            createdAt: new Date(now).toISOString(),
-            senderNodeId: null,
-            senderName: null,
-            kind: input.kind ?? 'completed',
-            label: input.label ?? input.destinationId,
-            bodyRef: null,
-            bodyJson: input.bodyJson,
-            disposition: null,
-        });
-        const deliveryId = newId();
-        const inserted = db.prepare(`INSERT INTO deliveries
+     VALUES (?, ?, 'node_inbox', ?, ?, ?, 'pending', ?, ?, ?)`).run(a,e,d,r,o,i??null,t,t),a}s(N,"insertNodeDelivery");function E(n,e){const d=new Date().toISOString(),r=n.operationId===void 0?p.current()??g():J(n.operationId);let o=n.bodyRef??null,t=n.bodyJson;if(o===null){const i=U(t),a=M(i);a.clipped&&(o=W(e,d,i),t={...t,body:a.text})}return{createdAt:d,operationId:r,bodyRef:o,bodyJson:t}}s(E,"finalizeNodeMail");function F(n,e){const d=E(e,n);return c(r=>{if(e.idempotencyKey!==void 0){const l=r.prepare(`SELECT d.delivery_id, d.message_id, d.urgency, m.created_at
+        FROM deliveries d JOIN messages m ON m.message_id = d.message_id WHERE d.idempotency_key = ?`).get(e.idempotencyKey);if(l!==void 0)return{messageId:l.message_id,deliveryId:l.delivery_id,urgency:l.urgency,createdAt:l.created_at}}const o=Date.now(),t=I(n,e.urgency),i=y(r,{operationId:d.operationId,createdAt:d.createdAt,senderNodeId:e.senderNodeId??null,senderName:e.senderName??null,kind:e.kind,label:e.label,bodyRef:d.bodyRef,bodyJson:d.bodyJson,disposition:e.disposition??null}),a=N(r,i,n,t,e.wake,o,e.idempotencyKey);return f(n,e.senderNodeId??null,o,r),e.wake===1&&t!=="deferred"&&_(n),{messageId:i,deliveryId:a,urgency:t,createdAt:d.createdAt}})}s(F,"enqueueNodeMail");function Y(n,e){if(n.length===0)return[];const d=E(e,n[0].node_id);return c(r=>{const o=Date.now(),t=y(r,{operationId:d.operationId,createdAt:d.createdAt,senderNodeId:e.senderNodeId??null,senderName:e.senderName??null,kind:e.kind,label:e.label,bodyRef:d.bodyRef,bodyJson:d.bodyJson,disposition:e.disposition??null});return n.map(i=>{const a=I(i.node_id,e.urgency),l=i.active?1:0,w=N(r,t,i.node_id,a,l,o);return f(i.node_id,e.senderNodeId??null,o,r),l===1&&a!=="deferred"&&_(i.node_id),{destinationNodeId:i.node_id,messageId:t,deliveryId:w,urgency:a,createdAt:d.createdAt}})})}s(Y,"enqueueSubscriberMail");function Z(n){return c(e=>{const d=e.prepare("SELECT delivery_id, message_id FROM deliveries WHERE idempotency_key = ?").get(n.idempotencyKey);if(d!==void 0)return{messageId:d.message_id,deliveryId:d.delivery_id};const r=Date.now(),o=y(e,{operationId:p.current()??g(),createdAt:new Date(r).toISOString(),senderNodeId:null,senderName:null,kind:n.kind??"completed",label:n.label??n.destinationId,bodyRef:null,bodyJson:n.bodyJson,disposition:null}),t=m(),i=e.prepare(`INSERT INTO deliveries
          (delivery_id, message_id, destination_kind, destination_id, urgency, wake, state, next_attempt_at,
           adapter_json, idempotency_key, created_at, updated_at)
        VALUES (?, ?, 'external_action', ?, 'normal', 0, 'pending', ?, ?, ?, ?, ?)
-       ON CONFLICT(idempotency_key) WHERE idempotency_key IS NOT NULL DO NOTHING`).run(deliveryId, messageId, input.destinationId, now, stringify(input.adapter, 'external action adapter'), input.idempotencyKey, now, now);
-        if (Number(inserted.changes) === 1)
-            return { messageId, deliveryId };
-        const winner = db.prepare('SELECT delivery_id, message_id FROM deliveries WHERE idempotency_key = ?').get(input.idempotencyKey);
-        if (winner === undefined)
-            throw new Error(`external action idempotency winner disappeared: ${input.idempotencyKey}`);
-        return { messageId: winner.message_id, deliveryId: winner.delivery_id };
-    });
-}
-/** Retract an obligation without fabricating a terminal receipt. */
-export function cancelDelivery(deliveryId, now = Date.now()) {
-    return withCanvasWrite((db) => Number(db.prepare('UPDATE deliveries SET canceled_at = ?, updated_at = ? WHERE delivery_id = ? AND canceled_at IS NULL').run(now, now, deliveryId).changes) === 1);
-}
-export function cancelPendingNodeMail(nodeId, select = {}) {
-    return withCanvasWrite((db) => {
-        const clauses = ["d.destination_kind = 'node_inbox'", 'd.destination_id = ?', 'd.canceled_at IS NULL', "d.state IN ('pending', 'handed_off')"];
-        const params = [nodeId];
-        if (select.senderNodeId !== undefined) {
-            clauses.push('m.sender_node_id IS ?');
-            params.push(select.senderNodeId);
-        }
-        if (select.kind !== undefined) {
-            clauses.push('m.kind = ?');
-            params.push(select.kind);
-        }
-        const rows = db.prepare(`SELECT d.delivery_id FROM deliveries d JOIN messages m ON m.message_id = d.message_id WHERE ${clauses.join(' AND ')}`).all(...params);
-        if (rows.length === 0)
-            return [];
-        const now = Date.now();
-        db.prepare(`UPDATE deliveries SET canceled_at = ?, updated_at = ? WHERE delivery_id IN (${rows.map(() => '?').join(',')})`)
-            .run(now, now, ...rows.map((row) => row.delivery_id));
-        return rows.map((row) => row.delivery_id);
-    });
-}
-/** Enqueue the one notice only if the same live controller wait is still dead. */
-export function enqueueControllerDeathNotice(nodeId, controllerId) {
-    return withCanvasWrite((db) => {
-        const now = Date.now();
-        const row = db.prepare(`SELECT target.status AS controller_status FROM waits w LEFT JOIN nodes target ON target.node_id = w.target_id
-        WHERE w.node_id = ? AND w.kind = 'controller' AND w.target_id = ? AND w.satisfied_at IS NULL`).get(nodeId, controllerId);
-        if (row === undefined || row.controller_status === 'active' || row.controller_status === 'idle')
-            return null;
-        const result = enqueueNodeMail(nodeId, {
-            kind: 'urgent',
-            label: 'declared controller is no longer live',
-            bodyJson: { body: `Controller ${controllerId} is no longer live; the declared message wait was cleared.` },
-            urgency: 'urgent',
-            wake: 1,
-        });
-        if (!settleDeadControllerWait(nodeId, controllerId, now, db))
-            throw new Error(`controller wait changed while notifying ${nodeId}`);
-        return result;
-    });
-}
+       ON CONFLICT(idempotency_key) WHERE idempotency_key IS NOT NULL DO NOTHING`).run(t,o,n.destinationId,r,u(n.adapter,"external action adapter"),n.idempotencyKey,r,r);if(Number(i.changes)===1)return{messageId:o,deliveryId:t};const a=e.prepare("SELECT delivery_id, message_id FROM deliveries WHERE idempotency_key = ?").get(n.idempotencyKey);if(a===void 0)throw new Error(`external action idempotency winner disappeared: ${n.idempotencyKey}`);return{messageId:a.message_id,deliveryId:a.delivery_id}})}s(Z,"enqueueExternalAction");function ee(n,e=Date.now()){return c(d=>Number(d.prepare("UPDATE deliveries SET canceled_at = ?, updated_at = ? WHERE delivery_id = ? AND canceled_at IS NULL").run(e,e,n).changes)===1)}s(ee,"cancelDelivery");function ne(n,e={}){return c(d=>{const r=["d.destination_kind = 'node_inbox'","d.destination_id = ?","d.canceled_at IS NULL","d.state IN ('pending', 'handed_off')"],o=[n];e.senderNodeId!==void 0&&(r.push("m.sender_node_id IS ?"),o.push(e.senderNodeId)),e.kind!==void 0&&(r.push("m.kind = ?"),o.push(e.kind));const t=d.prepare(`SELECT d.delivery_id FROM deliveries d JOIN messages m ON m.message_id = d.message_id WHERE ${r.join(" AND ")}`).all(...o);if(t.length===0)return[];const i=Date.now();return d.prepare(`UPDATE deliveries SET canceled_at = ?, updated_at = ? WHERE delivery_id IN (${t.map(()=>"?").join(",")})`).run(i,i,...t.map(a=>a.delivery_id)),t.map(a=>a.delivery_id)})}s(ne,"cancelPendingNodeMail");function de(n,e){return c(d=>{const r=Date.now(),o=d.prepare(`SELECT target.status AS controller_status FROM waits w LEFT JOIN nodes target ON target.node_id = w.target_id
+        WHERE w.node_id = ? AND w.kind = 'controller' AND w.target_id = ? AND w.satisfied_at IS NULL`).get(n,e);if(o===void 0||o.controller_status==="active"||o.controller_status==="idle")return null;const t=F(n,{kind:"urgent",label:"declared controller is no longer live",bodyJson:{body:`Controller ${e} is no longer live; the declared message wait was cleared.`},urgency:"urgent",wake:1});if(!C(n,e,r,d))throw new Error(`controller wait changed while notifying ${n}`);return t})}s(de,"enqueueControllerDeathNotice");export{ee as cancelDelivery,ne as cancelPendingNodeMail,de as enqueueControllerDeathNotice,Z as enqueueExternalAction,F as enqueueNodeMail,Y as enqueueSubscriberMail};

package/dist/core/frontmatter.js

@@ -1,35 +1 @@
-import { parse as parseYaml } from 'yaml';
-const FRONTMATTER_RE = /^---\s*\r?\n([\s\S]*?)\r?\n---\s*\r?\n?/;
-/** Parse a frontmatter block as a raw key/value record. */
-export function parseFrontmatterGeneric(source) {
-    const match = source.match(FRONTMATTER_RE);
-    if (!match) {
-        return { data: null, body: source, raw: '' };
-    }
-    const raw = match[1];
-    const body = source.slice(match[0].length);
-    return { data: parseYamlBlock(raw), body, raw };
-}
-/** Parse the inner YAML of a frontmatter block into a key/value record.
- *
- *  ONE strict parser, no fallback. The frontmatter contract IS "valid YAML":
- *  the single `yaml`-package path handles the substrate's nested `gate:` maps,
- *  inline `{…}` objects, and native scalar typing — and a doc whose frontmatter
- *  is NOT valid YAML THROWS, by design. There is deliberately no second lenient
- *  parser; a dual parsing strategy is the hedge we reject. Callers that iterate
- *  MANY docs isolate a per-doc throw at the COLLECTION layer (a clear scoped
- *  notice naming the bad file, then continue); single-doc callers let the error
- *  surface so the user learns their one requested doc is malformed.
- *
- *  A VALID non-object document (a bare scalar, a top-level list, or an empty
- *  block) normalizes to an empty record, preserving the contract that callers
- *  always receive a Record for well-formed-but-non-mapping frontmatter. */
-function parseYamlBlock(raw) {
-    return normalizeToRecord(parseYaml(raw));
-}
-function normalizeToRecord(parsed) {
-    if (parsed !== null && typeof parsed === 'object' && !Array.isArray(parsed)) {
-        return parsed;
-    }
-    return {};
-}
+var e=Object.defineProperty;var t=(r,n)=>e(r,"name",{value:n,configurable:!0});import{parse as c}from"yaml";const i=/^---\s*\r?\n([\s\S]*?)\r?\n---\s*\r?\n?/;function f(r){const n=r.match(i);if(!n)return{data:null,body:r,raw:""};const o=n[1],a=r.slice(n[0].length);return{data:l(o),body:a,raw:o}}t(f,"parseFrontmatterGeneric");function l(r){return s(c(r))}t(l,"parseYamlBlock");function s(r){return r!==null&&typeof r=="object"&&!Array.isArray(r)?r:{}}t(s,"normalizeToRecord");export{f as parseFrontmatterGeneric};

package/dist/core/fs-utils.js

@@ -1,202 +1,3 @@
-import { existsSync, lstatSync, mkdirSync, readdirSync, readFileSync, rmSync, statSync, symlinkSync, writeFileSync, cpSync, readlinkSync, renameSync, chmodSync, realpathSync, closeSync, fsyncSync, openSync, } from 'node:fs';
-import { dirname, join, relative, sep } from 'node:path';
-import { homedir, platform } from 'node:os';
-/** `realpathSync`, tolerant of a path that doesn't exist or can't be resolved. */
-export function realpathOrSelf(p) {
-    try {
-        return realpathSync(p);
-    }
-    catch {
-        return p;
-    }
-}
-/** Expand a leading `~` against `homeDir` (pi's own convention). Other forms
- *  — absolute, relative, `~user` — pass through as pi leaves them. */
-export function expandTilde(p, homeDir = homedir()) {
-    if (p === '~')
-        return homeDir;
-    if (p.startsWith('~/') || (platform() === 'win32' && p.startsWith('~\\')))
-        return join(homeDir, p.slice(2));
-    return p;
-}
-/** Collapse the home prefix to `~` so a path reads short. The inverse of
- *  `expandTilde`, and the ONE collapse every surface prints paths through. */
-export function tildify(p, homeDir = homedir()) {
-    if (p === homeDir)
-        return '~';
-    if (p.startsWith(homeDir + sep))
-        return '~' + p.slice(homeDir.length);
-    return p;
-}
-export function ensureDir(dir) {
-    mkdirSync(dir, { recursive: true });
-}
-export function writeJson(path, data) {
-    ensureDir(dirname(path));
-    writeFileSync(path, JSON.stringify(data, null, 2) + '\n', 'utf8');
-}
-export function atomicWriteJson(path, data, opts) {
-    atomicWriteText(path, JSON.stringify(data, null, 2) + '\n', opts);
-}
-/** Force a file's written bytes to stable storage. */
-export function syncFile(path) {
-    const fd = openSync(path, 'r');
-    try {
-        fsyncSync(fd);
-    }
-    finally {
-        closeSync(fd);
-    }
-}
-/** Force a directory's entry changes to stable storage. */
-export function syncDirectory(path) {
-    const fd = openSync(path, 'r');
-    try {
-        fsyncSync(fd);
-    }
-    finally {
-        closeSync(fd);
-    }
-}
-/** Replace one file's contents in a single rename, so a concurrent reader — the
- *  tmux inbox watcher, or crtrd serving a ticket read — sees either the old
- *  bytes or the new ones and never a truncated file mid-write. */
-export function atomicWriteText(path, content, opts) {
-    ensureDir(dirname(path));
-    const temp = `${path}.${process.pid}.${Date.now()}.${Math.random().toString(16).slice(2)}.tmp`;
-    const mode = opts?.mode ?? (existsSync(path) ? statSync(path).mode & 0o777 : 0o600);
-    try {
-        writeFileSync(temp, content, { mode });
-        chmodSync(temp, mode);
-        renameSync(temp, path);
-    }
-    finally {
-        if (existsSync(temp))
-            rmSync(temp, { force: true });
-    }
-}
-export function readJson(path) {
-    return JSON.parse(readFileSync(path, 'utf8'));
-}
-export function readJsonIfExists(path) {
-    if (!existsSync(path))
-        return null;
-    return readJson(path);
-}
-/** Missing or corrupt reads as absent, so a crash artifact never throws. */
-export function readJsonOrNull(path) {
-    try {
-        return JSON.parse(readFileSync(path, 'utf8'));
-    }
-    catch {
-        return null;
-    }
-}
-export function readTextIfExists(path) {
-    if (!existsSync(path))
-        return null;
-    return readFileSync(path, 'utf8');
-}
-export function readText(path) {
-    return readFileSync(path, 'utf8');
-}
-export function writeText(path, content) {
-    ensureDir(dirname(path));
-    writeFileSync(path, content, 'utf8');
-}
-export function isDir(path) {
-    try {
-        return statSync(path).isDirectory();
-    }
-    catch {
-        return false;
-    }
-}
-export function isSymlink(path) {
-    try {
-        return lstatSync(path).isSymbolicLink();
-    }
-    catch {
-        return false;
-    }
-}
-export function pathExists(path) {
-    return existsSync(path);
-}
-export function listDirs(path) {
-    if (!existsSync(path))
-        return [];
-    return readdirSync(path, { withFileTypes: true })
-        .filter((d) => d.isDirectory() || d.isSymbolicLink())
-        .map((d) => d.name);
-}
-export function listEntries(path) {
-    if (!existsSync(path))
-        return [];
-    return readdirSync(path);
-}
-export function removePath(path) {
-    if (!existsSync(path) && !isSymlink(path))
-        return;
-    rmSync(path, { recursive: true, force: true });
-}
-export function linkOrCopy(target, linkPath, opts = {}) {
-    ensureDir(dirname(linkPath));
-    removePath(linkPath);
-    const isWindows = platform() === 'win32';
-    if (!opts.noSymlink && !isWindows) {
-        // The kernel resolves a relative link against the link's *physical*
-        // directory, so both ends must be realpaths: computing `..` hops from a
-        // lexical path whose ancestor is itself a symlink (macOS /tmp →
-        // /private/tmp) walks up the wrong chain and silently creates a dangling
-        // link, since symlinkSync never checks the target.
-        const rel = relative(realpathOrSelf(dirname(linkPath)), realpathOrSelf(target));
-        try {
-            symlinkSync(rel, linkPath, isDir(target) ? 'dir' : 'file');
-            return 'symlink';
-        }
-        catch {
-            cpSync(target, linkPath, { recursive: true });
-            return 'copy';
-        }
-    }
-    cpSync(target, linkPath, { recursive: true });
-    return 'copy';
-}
-export function readSymlinkTarget(path) {
-    try {
-        return readlinkSync(path);
-    }
-    catch {
-        return null;
-    }
-}
-export function walkFiles(root, predicate = () => true, skipDir = () => false) {
-    const out = [];
-    if (!existsSync(root))
-        return out;
-    const stack = [root];
-    while (stack.length) {
-        const dir = stack.pop();
-        let entries;
-        try {
-            entries = readdirSync(dir, { withFileTypes: true });
-        }
-        catch {
-            continue;
-        }
-        for (const e of entries) {
-            const full = join(dir, e.name);
-            if (e.isDirectory()) {
-                if (!skipDir(e.name))
-                    stack.push(full);
-            }
-            else if (e.isFile() && predicate(e.name))
-                out.push(full);
-        }
-    }
-    return out;
-}
-export function nowIso() {
-    return new Date().toISOString();
-}
+var W=Object.defineProperty;var n=(r,t)=>W(r,"name",{value:t,configurable:!0});import{existsSync as i,lstatSync as N,mkdirSync as g,readdirSync as y,readFileSync as f,rmSync as S,statSync as d,symlinkSync as h,writeFileSync as a,cpSync as w,readlinkSync as E,renameSync as I,chmodSync as $,realpathSync as b,closeSync as J,fsyncSync as O,openSync as T}from"node:fs";import{dirname as s,join as k,relative as L,sep as j}from"node:path";import{homedir as F,platform as v}from"node:os";function D(r){try{return b(r)}catch{return r}}n(D,"realpathOrSelf");function Q(r,t=F()){return r==="~"?t:r.startsWith("~/")||v()==="win32"&&r.startsWith("~\\")?k(t,r.slice(2)):r}n(Q,"expandTilde");function R(r,t=F()){return r===t?"~":r.startsWith(t+j)?"~"+r.slice(t.length):r}n(R,"tildify");function l(r){g(r,{recursive:!0})}n(l,"ensureDir");function U(r,t){l(s(r)),a(r,JSON.stringify(t,null,2)+`
+`,"utf8")}n(U,"writeJson");function V(r,t,c){C(r,JSON.stringify(t,null,2)+`
+`,c)}n(V,"atomicWriteJson");function X(r){const t=T(r,"r");try{O(t)}finally{J(t)}}n(X,"syncFile");function Y(r){const t=T(r,"r");try{O(t)}finally{J(t)}}n(Y,"syncDirectory");function C(r,t,c){l(s(r));const e=`${r}.${process.pid}.${Date.now()}.${Math.random().toString(16).slice(2)}.tmp`,o=c?.mode??(i(r)?d(r).mode&511:384);try{a(e,t,{mode:o}),$(e,o),I(e,r)}finally{i(e)&&S(e,{force:!0})}}n(C,"atomicWriteText");function M(r){return JSON.parse(f(r,"utf8"))}n(M,"readJson");function Z(r){return i(r)?M(r):null}n(Z,"readJsonIfExists");function _(r){try{return JSON.parse(f(r,"utf8"))}catch{return null}}n(_,"readJsonOrNull");function P(r){return i(r)?f(r,"utf8"):null}n(P,"readTextIfExists");function rr(r){return f(r,"utf8")}n(rr,"readText");function tr(r,t){l(s(r)),a(r,t,"utf8")}n(tr,"writeText");function q(r){try{return d(r).isDirectory()}catch{return!1}}n(q,"isDir");function z(r){try{return N(r).isSymbolicLink()}catch{return!1}}n(z,"isSymlink");function nr(r){return i(r)}n(nr,"pathExists");function er(r){return i(r)?y(r,{withFileTypes:!0}).filter(t=>t.isDirectory()||t.isSymbolicLink()).map(t=>t.name):[]}n(er,"listDirs");function ir(r){return i(r)?y(r):[]}n(ir,"listEntries");function A(r){!i(r)&&!z(r)||S(r,{recursive:!0,force:!0})}n(A,"removePath");function or(r,t,c={}){l(s(t)),A(t);const e=v()==="win32";if(!c.noSymlink&&!e){const o=L(D(s(t)),D(r));try{return h(o,t,q(r)?"dir":"file"),"symlink"}catch{return w(r,t,{recursive:!0}),"copy"}}return w(r,t,{recursive:!0}),"copy"}n(or,"linkOrCopy");function cr(r){try{return E(r)}catch{return null}}n(cr,"readSymlinkTarget");function ur(r,t=()=>!0,c=()=>!1){const e=[];if(!i(r))return e;const o=[r];for(;o.length;){const x=o.pop();let p;try{p=y(x,{withFileTypes:!0})}catch{continue}for(const u of p){const m=k(x,u.name);u.isDirectory()?c(u.name)||o.push(m):u.isFile()&&t(u.name)&&e.push(m)}}return e}n(ur,"walkFiles");function sr(){return new Date().toISOString()}n(sr,"nowIso");export{V as atomicWriteJson,C as atomicWriteText,l as ensureDir,Q as expandTilde,q as isDir,z as isSymlink,or as linkOrCopy,er as listDirs,ir as listEntries,sr as nowIso,nr as pathExists,M as readJson,Z as readJsonIfExists,_ as readJsonOrNull,cr as readSymlinkTarget,rr as readText,P as readTextIfExists,D as realpathOrSelf,A as removePath,Y as syncDirectory,X as syncFile,R as tildify,ur as walkFiles,U as writeJson,tr as writeText};

package/dist/core/git.js

@@ -1,103 +1,2 @@
-import { spawn, spawnSync } from 'node:child_process';
-import { network } from './errors.js';
-/** Git takes `.git/index.lock` to refresh the index stat cache even during
- *  otherwise read-only commands — `status` is the common one. Killed between
- *  creating that lock and renaming it over the index, the lock orphans and
- *  blocks every later writer in the checkout with no owning process left to
- *  name. Agent processes are killed mid-command routinely (a closed node, a
- *  cancelled daemon tick, a timed-out shell), so the residue accumulates.
- *
- *  `GIT_OPTIONAL_LOCKS=0` suppresses exactly those optional locks and nothing
- *  else: a commit, rebase, or `add` still takes the lock it requires, and
- *  command output is byte-identical. Built per call rather than snapshotted at
- *  module load, so a later change to the ambient environment still reaches git. */
-function gitEnv(base = process.env) {
-    return { ...base, GIT_OPTIONAL_LOCKS: '0' };
-}
-export function gitSync(args, cwd, input, options = {}) {
-    const res = spawnSync('git', args, { cwd, encoding: 'utf8', input, env: gitEnv(), timeout: options.timeoutMs });
-    const status = typeof res.status === 'number' ? res.status : 1;
-    const completed = typeof res.status === 'number';
-    const stdout = typeof res.stdout === 'string' ? res.stdout : '';
-    const stderr = typeof res.stderr === 'string' ? res.stderr : '';
-    const processError = res.error === undefined ? undefined : String(res.error);
-    const timedOut = res.error?.code === 'ETIMEDOUT';
-    return { status, stdout, stderr, ...(completed ? {} : { executionFailed: true }), ...(processError === undefined ? {} : { processError }), ...(timedOut ? { timedOut: true } : {}) };
-}
-export async function gitAsync(args, cwd, input, options = {}) {
-    return new Promise((resolve) => {
-        const child = spawn('git', args, { cwd, env: gitEnv(options.env) });
-        if (input === undefined)
-            child.stdin.end();
-        else
-            child.stdin.end(input);
-        let stdout = '';
-        let stderr = '';
-        let timedOut = false;
-        let settled = false;
-        const timer = options.timeoutMs === undefined ? undefined : setTimeout(() => {
-            timedOut = true;
-            child.kill('SIGTERM');
-        }, options.timeoutMs);
-        const settle = (result) => {
-            if (settled)
-                return;
-            settled = true;
-            if (timer !== undefined)
-                clearTimeout(timer);
-            resolve(result);
-        };
-        child.stdout.on('data', (d) => (stdout += d.toString()));
-        child.stderr.on('data', (d) => (stderr += d.toString()));
-        child.on('close', (status) => {
-            const code = typeof status === 'number' ? status : 1;
-            settle({ status: code, stdout, stderr, ...(timedOut ? { timedOut: true, executionFailed: true } : {}) });
-        });
-        child.on('error', (e) => settle({ status: 1, stdout: '', stderr: String(e), executionFailed: true, processError: String(e) }));
-    });
-}
-export function clone(url, dest, opts = {}) {
-    const args = ['clone'];
-    if (opts.depth)
-        args.push('--depth', String(opts.depth));
-    if (opts.ref)
-        args.push('--branch', opts.ref);
-    args.push(url, dest);
-    const res = gitSync(args);
-    if (res.status !== 0) {
-        throw network(`git clone failed: ${url}\n${res.stderr.trim()}`);
-    }
-    return res;
-}
-export function fetch(cwd, ref) {
-    const args = ['fetch', 'origin'];
-    if (ref)
-        args.push(ref);
-    return gitSync(args, cwd);
-}
-export function lsRemote(url) {
-    return gitSync(['ls-remote', url]);
-}
-export function currentSha(cwd) {
-    const res = gitSync(['rev-parse', 'HEAD'], cwd);
-    if (res.status !== 0)
-        return null;
-    return res.stdout.trim();
-}
-export function remoteSha(cwd, ref) {
-    const res = gitSync(['rev-parse', `origin/${ref}`], cwd);
-    if (res.status !== 0)
-        return null;
-    return res.stdout.trim();
-}
-export function isGitRepo(cwd) {
-    const res = gitSync(['rev-parse', '--is-inside-work-tree'], cwd);
-    return res.status === 0 && res.stdout.trim() === 'true';
-}
-export function deriveNameFromUrl(url) {
-    const trimmed = url.replace(/\.git\/?$/, '').replace(/\/$/, '');
-    const last = trimmed.split('/').pop();
-    if (!last)
-        return url;
-    return last;
-}
+var h=Object.defineProperty;var o=(t,e)=>h(t,"name",{value:e,configurable:!0});import{spawn as x,spawnSync as S}from"node:child_process";import{network as v}from"./errors.js";function g(t=process.env){return{...t,GIT_OPTIONAL_LOCKS:"0"}}o(g,"gitEnv");function d(t,e,r,i={}){const n=S("git",t,{cwd:e,encoding:"utf8",input:r,env:g(),timeout:i.timeoutMs}),u=typeof n.status=="number"?n.status:1,f=typeof n.status=="number",a=typeof n.stdout=="string"?n.stdout:"",m=typeof n.stderr=="string"?n.stderr:"",c=n.error===void 0?void 0:String(n.error),p=n.error?.code==="ETIMEDOUT";return{status:u,stdout:a,stderr:m,...f?{}:{executionFailed:!0},...c===void 0?{}:{processError:c},...p?{timedOut:!0}:{}}}o(d,"gitSync");async function w(t,e,r,i={}){return new Promise(n=>{const u=x("git",t,{cwd:e,env:g(i.env)});r===void 0?u.stdin.end():u.stdin.end(r);let f="",a="",m=!1,c=!1;const p=i.timeoutMs===void 0?void 0:setTimeout(()=>{m=!0,u.kill("SIGTERM")},i.timeoutMs),l=o(s=>{c||(c=!0,p!==void 0&&clearTimeout(p),n(s))},"settle");u.stdout.on("data",s=>f+=s.toString()),u.stderr.on("data",s=>a+=s.toString()),u.on("close",s=>{l({status:typeof s=="number"?s:1,stdout:f,stderr:a,...m?{timedOut:!0,executionFailed:!0}:{}})}),u.on("error",s=>l({status:1,stdout:"",stderr:String(s),executionFailed:!0,processError:String(s)}))})}o(w,"gitAsync");function M(t,e,r={}){const i=["clone"];r.depth&&i.push("--depth",String(r.depth)),r.ref&&i.push("--branch",r.ref),i.push(t,e);const n=d(i);if(n.status!==0)throw v(`git clone failed: ${t}
+${n.stderr.trim()}`);return n}o(M,"clone");function $(t,e){const r=["fetch","origin"];return e&&r.push(e),d(r,t)}o($,"fetch");function b(t){return d(["ls-remote",t])}o(b,"lsRemote");function F(t){const e=d(["rev-parse","HEAD"],t);return e.status!==0?null:e.stdout.trim()}o(F,"currentSha");function I(t,e){const r=d(["rev-parse",`origin/${e}`],t);return r.status!==0?null:r.stdout.trim()}o(I,"remoteSha");function k(t){const e=d(["rev-parse","--is-inside-work-tree"],t);return e.status===0&&e.stdout.trim()==="true"}o(k,"isGitRepo");function A(t){const r=t.replace(/\.git\/?$/,"").replace(/\/$/,"").split("/").pop();return r||t}o(A,"deriveNameFromUrl");export{M as clone,F as currentSha,A as deriveNameFromUrl,$ as fetch,w as gitAsync,d as gitSync,k as isGitRepo,b as lsRemote,I as remoteSha};