gitsheets 0.22.5 → 1.0.3

package/dist/errors.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export * from './errors.js';
+export { Repository, openRepo } from './repository.js';
+export type { OpenRepoOptions, OpenSheetOptions, OpenSheetsOptions, } from './repository.js';
+export { Sheet, RECORD_PATH_KEY, RECORD_SHEET_KEY } from './sheet.js';
+export type { SheetConfig, SheetFieldConfig, SortRule, UpsertResult, SheetConstructorOptions, IndexKeyFn, DefineIndexOptions, QueryFilter, } from './sheet.js';
+export { mergePatch } from './patch.js';
+export { openStore } from './store.js';
+export type { OpenStoreOptions, Store, StoreTx, StoreTransactFn, ValidatorMap, InferRecord, } from './store.js';
+export { PushDaemon } from './push-daemon.js';
+export type { PushDaemonOptions, PushDaemonStatus, BackoffConfig, } from './push-daemon.js';
+export { Transaction } from './transaction.js';
+export type { Author, TransactionOptions, TransactionResult, TransactionHandler, } from './transaction.js';
+export { Template } from './path-template/index.js';
+export type { RecordLike, PathTemplateBlob, PathTemplateTree, PathTemplateQueryResult, } from './path-template/index.js';
+export { validateRecord } from './validation.js';
+export type { JSONSchema, StandardSchemaV1, StandardSchemaIssue, StandardSchemaResult, StandardSchemaFailure, StandardSchemaSuccess, StandardSchemaPathSegment, } from './validation.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACvD,YAAY,EACV,eAAe,EACf,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACtE,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,QAAQ,EACR,YAAY,EACZ,uBAAuB,EACvB,UAAU,EACV,kBAAkB,EAClB,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,YAAY,EACV,gBAAgB,EAChB,KAAK,EACL,OAAO,EACP,eAAe,EACf,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EACV,MAAM,EACN,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,GACnB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,uBAAuB,GACxB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AACjD,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,EACpB,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,GAC1B,MAAM,iBAAiB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+// Public exports for gitsheets.
+// See specs/api/ for the full contract.
+export * from './errors.js';
+export { Repository, openRepo } from './repository.js';
+export { Sheet, RECORD_PATH_KEY, RECORD_SHEET_KEY } from './sheet.js';
+export { mergePatch } from './patch.js';
+export { openStore } from './store.js';
+export { PushDaemon } from './push-daemon.js';
+export { Transaction } from './transaction.js';
+export { Template } from './path-template/index.js';
+export { validateRecord } from './validation.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,wCAAwC;AAExC,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAOvD,OAAO,EAAE,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAYtE,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAUvC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAO9C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAQ/C,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAQpD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/patch.d.ts

@@ -0,0 +1,2 @@
+export declare function mergePatch(target: unknown, patch: unknown): unknown;
+//# sourceMappingURL=patch.d.ts.map

package/dist/patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../src/patch.ts"],"names":[],"mappings":"AAsBA,wBAAgB,UAAU,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAenE"}

package/dist/patch.js

@@ -0,0 +1,39 @@
+// RFC 7396 JSON Merge Patch.
+//
+// Semantics (per RFC):
+//   - null in the patch deletes the corresponding member of the target
+//   - arrays in the patch replace the target's array entirely (no concat)
+//   - objects merge recursively
+//   - scalars in the patch replace the target's value
+//
+// Inline implementation (rather than a dependency) so @iarna/toml's custom
+// Date subclasses round-trip cleanly through the merge without classification.
+function isPlainObject(value) {
+    if (value === null || typeof value !== 'object')
+        return false;
+    if (Array.isArray(value))
+        return false;
+    if (value instanceof Date)
+        return false;
+    // Treat anything with a non-Object prototype as a class instance (BlobObject, etc.)
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+export function mergePatch(target, patch) {
+    if (!isPlainObject(patch)) {
+        // Scalars, arrays, null, Dates, class instances — replace wholesale.
+        return patch;
+    }
+    // Patch is an object — merge into a fresh plain object derived from target.
+    const base = isPlainObject(target) ? { ...target } : {};
+    for (const [key, value] of Object.entries(patch)) {
+        if (value === null) {
+            delete base[key];
+        }
+        else {
+            base[key] = mergePatch(base[key], value);
+        }
+    }
+    return base;
+}
+//# sourceMappingURL=patch.js.map

package/dist/patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patch.js","sourceRoot":"","sources":["../src/patch.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,EAAE;AACF,uBAAuB;AACvB,uEAAuE;AACvE,0EAA0E;AAC1E,gCAAgC;AAChC,sDAAsD;AACtD,EAAE;AACF,2EAA2E;AAC3E,+EAA+E;AAI/E,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,KAAK,YAAY,IAAI;QAAE,OAAO,KAAK,CAAC;IACxC,oFAAoF;IACpF,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,KAAK,KAAK,MAAM,CAAC,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,MAAe,EAAE,KAAc;IACxD,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,qEAAqE;QACrE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,4EAA4E;IAC5E,MAAM,IAAI,GAAa,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAClE,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACjD,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,GAAG,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QAC3C,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/path-template/index.d.ts

@@ -0,0 +1,42 @@
+export type RecordLike = Record<string, unknown>;
+export interface PathTemplateBlob {
+    readonly isBlob: boolean;
+}
+export interface PathTemplateTree {
+    readonly isTree: boolean;
+    getChild(name: string): Promise<PathTemplateTree | PathTemplateBlob | undefined>;
+    getChildren(): Promise<Record<string, PathTemplateTree | PathTemplateBlob>>;
+    getBlobMap(): Promise<Record<string, PathTemplateBlob>>;
+}
+export interface PathTemplateQueryResult {
+    readonly path: string;
+    readonly blob: PathTemplateBlob;
+}
+export declare class Template {
+    #private;
+    static fromString(templateString: string): Template;
+    /** Clear the global parse cache. Test-only escape hatch. */
+    static clearCache(): void;
+    readonly source: string;
+    private constructor();
+    get componentCount(): number;
+    /**
+     * Render the template against a full record.
+     *
+     * @throws PathTemplateError(`path_render_failed`) when any component is unrenderable.
+     * @throws PathTemplateError(`path_invalid_chars`) when a rendered segment contains
+     *         disallowed characters.
+     */
+    render(record: RecordLike): string;
+    /**
+     * Walk a tree yielding records that may match the query.
+     *
+     * Pruning: when the query supplies the inputs to render a component, the
+     * walk descends into only that subtree. When a component is unrenderable
+     * against the partial query, the walk expands across all subtrees at that
+     * level. The caller still applies the full equality filter on the yielded
+     * record contents.
+     */
+    queryTree(tree: PathTemplateTree | undefined, query: RecordLike, pathPrefix?: string, depth?: number): AsyncGenerator<PathTemplateQueryResult>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/path-template/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/path-template/index.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,gBAAgB,GAAG,SAAS,CAAC,CAAC;IACjF,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAAC,CAAC,CAAC;IAC5E,UAAU,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC;CACzD;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;CACjC;AAwPD,qBAAa,QAAQ;;IACnB,MAAM,CAAC,UAAU,CAAC,cAAc,EAAE,MAAM,GAAG,QAAQ;IAQnD,4DAA4D;IAC5D,MAAM,CAAC,UAAU,IAAI,IAAI;IAIzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAGxB,OAAO;IAKP,IAAI,cAAc,IAAI,MAAM,CAE3B;IAED;;;;;;OAMG;IACH,MAAM,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM;IAiBlC;;;;;;;;OAQG;IACI,SAAS,CACd,IAAI,EAAE,gBAAgB,GAAG,SAAS,EAClC,KAAK,EAAE,UAAU,EACjB,UAAU,SAAK,EACf,KAAK,SAAI,GACR,cAAc,CAAC,uBAAuB,CAAC;CAmE3C"}

package/dist/path-template/index.js

@@ -0,0 +1,288 @@
+// Path template parser + renderer + query-tree traversal.
+// See specs/behaviors/path-templates.md for the contract.
+import { runInNewContext } from 'node:vm';
+import { PathTemplateError } from '../errors.js';
+// --- Validation ---
+// Windows-disallowed chars per specs/behaviors/path-templates.md.
+const WINDOWS_INVALID = /[<>:"|?*\x00-\x1f]/;
+// Same set plus `/` — segments rendered for non-recursive components must not
+// contain `/`, since that would silently expand the rendered path's structure.
+const SEGMENT_INVALID = /[<>:"|?*\x00-\x1f/]/;
+function rejectInvalidChars(rendered, pattern, source, componentIndex) {
+    const match = pattern.exec(rendered);
+    if (match) {
+        throw new PathTemplateError('path_invalid_chars', `component ${componentIndex} of "${source}" rendered to ${JSON.stringify(rendered)}, ` +
+            `which contains disallowed character ${JSON.stringify(match[0])}`);
+    }
+}
+// --- Expression compilation ---
+const NOT_DEFINED_RE = / is not defined$/;
+function compileExpression(source) {
+    let compiled;
+    try {
+        compiled = runInNewContext(`(record) => { with (record) { return (${source}) } }`);
+    }
+    catch (err) {
+        throw new PathTemplateError('path_render_failed', `expression ${JSON.stringify(source)} failed to compile: ${err instanceof Error ? err.message : String(err)}`, { cause: err });
+    }
+    return (record) => {
+        try {
+            return compiled(record);
+        }
+        catch (err) {
+            // Per spec: missing identifiers are "un-renderable", not fatal —
+            // that lets queries with partial fields walk the tree fully.
+            if (err instanceof ReferenceError && NOT_DEFINED_RE.test(err.message)) {
+                return undefined;
+            }
+            throw err;
+        }
+    };
+}
+// --- Value rendering ---
+function stringifyValue(value) {
+    if (value === undefined || value === null)
+        return undefined;
+    if (typeof value === 'function')
+        return undefined;
+    if (typeof value === 'string')
+        return value;
+    if (typeof value === 'number' || typeof value === 'boolean' || typeof value === 'bigint') {
+        return String(value);
+    }
+    if (value instanceof Date)
+        return value.toString();
+    // Plain objects / arrays / Symbols: treat as un-renderable. Consumers
+    // wanting a custom serialization use an expression component.
+    return undefined;
+}
+function renderPart(part, record) {
+    switch (part.kind) {
+        case 'literal':
+            return part.text;
+        case 'field':
+            return stringifyValue(record[part.name]);
+        case 'expression':
+            return stringifyValue(part.evaluate(record));
+    }
+}
+function renderComponent(c, record) {
+    let out = '';
+    for (const part of c.parts) {
+        const piece = renderPart(part, record);
+        if (piece === undefined)
+            return undefined;
+        out += piece;
+    }
+    return out;
+}
+// --- Parser ---
+const FIELD_NAME_RE = /^[a-zA-Z0-9_-]+(\/\*\*)?$/;
+function parseTemplateString(source) {
+    const normalized = source.replace(/^\/+/, '').replace(/\/+$/, '');
+    if (normalized === '') {
+        throw new PathTemplateError('path_render_failed', 'path template is empty');
+    }
+    // Single-pass: structural `/` separates components, but `/` inside an
+    // expression (notably the `/**` recursive suffix) belongs to the expression
+    // and must not split segments.
+    const segments = [[]];
+    let pendingLiteral = '';
+    let i = 0;
+    const flushLiteral = () => {
+        if (pendingLiteral) {
+            segments[segments.length - 1].push({ kind: 'literal', text: pendingLiteral });
+            pendingLiteral = '';
+        }
+    };
+    while (i < normalized.length) {
+        if (normalized.startsWith('${{', i)) {
+            flushLiteral();
+            i += 3;
+            let exprSource = '';
+            while (!normalized.startsWith('}}', i)) {
+                if (i >= normalized.length) {
+                    throw new PathTemplateError('path_render_failed', `expression "\${{${exprSource}" in template "${source}" was not closed with }}`);
+                }
+                exprSource += normalized[i];
+                i++;
+            }
+            exprSource = exprSource.trim();
+            i += 2;
+            if (FIELD_NAME_RE.test(exprSource)) {
+                const recursive = exprSource.endsWith('/**');
+                const name = recursive ? exprSource.slice(0, -3) : exprSource;
+                segments[segments.length - 1].push({ kind: 'field', name, recursive });
+            }
+            else {
+                segments[segments.length - 1].push({
+                    kind: 'expression',
+                    source: exprSource,
+                    evaluate: compileExpression(exprSource),
+                });
+            }
+        }
+        else if (normalized[i] === '/') {
+            flushLiteral();
+            segments.push([]);
+            i++;
+        }
+        else {
+            pendingLiteral += normalized[i];
+            i++;
+        }
+    }
+    flushLiteral();
+    const components = segments.map((parts, idx) => buildComponent(parts, idx, source));
+    // Recursive (`/**`) must be the last component if present.
+    for (let i = 0; i < components.length - 1; i++) {
+        if (components[i].recursive) {
+            throw new PathTemplateError('path_render_failed', `recursive component (\${{ ... /** }}) must be the final component of the template`);
+        }
+    }
+    return components;
+}
+function buildComponent(parts, index, source) {
+    if (parts.length === 0) {
+        throw new PathTemplateError('path_render_failed', `empty component at index ${index} of "${source}" — consecutive slashes are not allowed`);
+    }
+    const onlyPart = parts.length === 1 ? parts[0] : null;
+    const componentRecursive = onlyPart !== null && onlyPart.kind === 'field' && onlyPart.recursive;
+    if (!componentRecursive) {
+        for (const part of parts) {
+            if (part.kind === 'field' && part.recursive) {
+                throw new PathTemplateError('path_render_failed', `recursive field reference (\${{ ${part.name}/** }}) must be the only part of its component`);
+            }
+        }
+    }
+    return { parts, recursive: componentRecursive };
+}
+// --- Tree helpers ---
+function isBlob(x) {
+    return x.isBlob === true;
+}
+function isTree(x) {
+    return x.isTree === true;
+}
+function joinPath(prefix, name) {
+    return prefix ? `${prefix}/${name}` : name;
+}
+// --- Template class ---
+const TEMPLATE_CACHE = new Map();
+export class Template {
+    static fromString(templateString) {
+        const cached = TEMPLATE_CACHE.get(templateString);
+        if (cached)
+            return cached;
+        const instance = new Template(templateString, parseTemplateString(templateString));
+        TEMPLATE_CACHE.set(templateString, instance);
+        return instance;
+    }
+    /** Clear the global parse cache. Test-only escape hatch. */
+    static clearCache() {
+        TEMPLATE_CACHE.clear();
+    }
+    source;
+    #components;
+    constructor(source, components) {
+        this.source = source;
+        this.#components = components;
+    }
+    get componentCount() {
+        return this.#components.length;
+    }
+    /**
+     * Render the template against a full record.
+     *
+     * @throws PathTemplateError(`path_render_failed`) when any component is unrenderable.
+     * @throws PathTemplateError(`path_invalid_chars`) when a rendered segment contains
+     *         disallowed characters.
+     */
+    render(record) {
+        const segments = [];
+        for (let i = 0; i < this.#components.length; i++) {
+            const c = this.#components[i];
+            const rendered = renderComponent(c, record);
+            if (rendered === undefined) {
+                throw new PathTemplateError('path_render_failed', `cannot render component ${i} of "${this.source}" — a required field or expression returned undefined`);
+            }
+            rejectInvalidChars(rendered, c.recursive ? WINDOWS_INVALID : SEGMENT_INVALID, this.source, i);
+            segments.push(rendered);
+        }
+        return segments.join('/');
+    }
+    /**
+     * Walk a tree yielding records that may match the query.
+     *
+     * Pruning: when the query supplies the inputs to render a component, the
+     * walk descends into only that subtree. When a component is unrenderable
+     * against the partial query, the walk expands across all subtrees at that
+     * level. The caller still applies the full equality filter on the yielded
+     * record contents.
+     */
+    async *queryTree(tree, query, pathPrefix = '', depth = 0) {
+        if (!tree)
+            return;
+        const numComponents = this.#components.length;
+        let currentTree = tree;
+        let currentPrefix = pathPrefix;
+        for (let i = depth; i < numComponents; i++) {
+            const isLast = i + 1 === numComponents;
+            const c = this.#components[i];
+            const rendered = renderComponent(c, query);
+            if (isLast) {
+                if (rendered !== undefined) {
+                    const child = await currentTree.getChild(`${rendered}.toml`);
+                    if (child && isBlob(child)) {
+                        yield { path: joinPath(currentPrefix, rendered), blob: child };
+                    }
+                    return;
+                }
+                const children = c.recursive
+                    ? await currentTree.getBlobMap()
+                    : await currentTree.getChildren();
+                let attachmentPrefix;
+                // `for...in` walks own + inherited enumerable keys. hologit's
+                // getChildren() exposes loaded entries on the object's prototype
+                // and only stages local mutations as own properties — Object.keys
+                // would miss the loaded entries.
+                const allKeys = [];
+                for (const k in children)
+                    allKeys.push(k);
+                const sortedKeys = allKeys.sort();
+                for (const childPath of sortedKeys) {
+                    if (!childPath.endsWith('.toml'))
+                        continue;
+                    if (attachmentPrefix && childPath.startsWith(attachmentPrefix))
+                        continue;
+                    const child = children[childPath];
+                    if (!child || !isBlob(child))
+                        continue;
+                    const childName = childPath.slice(0, -5);
+                    attachmentPrefix = `${childName}/`;
+                    yield { path: joinPath(currentPrefix, childName), blob: child };
+                }
+                return;
+            }
+            if (rendered !== undefined) {
+                const next = await currentTree.getChild(rendered);
+                if (!next || !isTree(next))
+                    return;
+                currentTree = next;
+                currentPrefix = joinPath(currentPrefix, rendered);
+                continue;
+            }
+            // Unrenderable intermediate component: expand across all subtree children.
+            const children = await currentTree.getChildren();
+            // for...in to include hologit's prototype-loaded entries (see comment above).
+            for (const name in children) {
+                const child = children[name];
+                if (!child || !isTree(child))
+                    continue;
+                yield* this.queryTree(child, query, joinPath(currentPrefix, name), i + 1);
+            }
+            return;
+        }
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/path-template/index.js.map

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

package/dist/push-daemon.d.ts

@@ -0,0 +1,53 @@
+import { EventEmitter } from 'node:events';
+export interface BackoffConfig {
+    /** Initial delay in ms; default 1000. */
+    readonly base: number;
+    /** Multiplier each attempt; default 2. */
+    readonly multiplier: number;
+    /** Max delay in ms; default 3_600_000 (1 hour). */
+    readonly cap: number;
+}
+export interface PushDaemonOptions {
+    /** Git remote name (e.g., 'origin'). Required. */
+    readonly remote: string;
+    /** Branch to push; default the repo's current HEAD branch. */
+    readonly branch?: string;
+    /** Retry backoff configuration; default exponential. */
+    readonly backoff?: 'exponential' | BackoffConfig;
+    /** Max retry attempts per commit batch; default Infinity. */
+    readonly maxRetries?: number;
+}
+export interface PushDaemonStatus {
+    readonly running: boolean;
+    readonly lastPushAt: string | null;
+    readonly lastError: {
+        message: string;
+        at: string;
+        attempt: number;
+    } | null;
+    readonly pendingCommits: number;
+    readonly currentBackoffMs: number | null;
+    readonly currentAttempt: number | null;
+}
+export declare class PushDaemon extends EventEmitter {
+    #private;
+    constructor(opts: {
+        gitDir: string;
+        remote: string;
+        branch: string;
+        backoff: BackoffConfig;
+        maxRetries: number;
+    });
+    /** Repository invokes this after each successful transact commit. */
+    notifyCommit(commitHash: string): void;
+    status(): PushDaemonStatus;
+    /**
+     * Stop accepting new commits, drain in-flight retries up to `timeoutMs`,
+     * resolve once idle. Idempotent.
+     */
+    stop(opts?: {
+        timeoutMs?: number;
+    }): Promise<void>;
+}
+export declare function resolveBackoff(opt: PushDaemonOptions['backoff']): BackoffConfig;
+//# sourceMappingURL=push-daemon.d.ts.map

package/dist/push-daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-daemon.d.ts","sourceRoot":"","sources":["../src/push-daemon.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0CAA0C;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,mDAAmD;IACnD,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,kDAAkD;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,QAAQ,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,aAAa,CAAC;IACjD,6DAA6D;IAC7D,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5E,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CACxC;AAED,qBAAa,UAAW,SAAQ,YAAY;;gBAmB9B,IAAI,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,aAAa,CAAC;QACvB,UAAU,EAAE,MAAM,CAAC;KACpB;IASD,qEAAqE;IACrE,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAOtC,MAAM,IAAI,gBAAgB;IAW1B;;;OAGG;IACG,IAAI,CAAC,IAAI,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;CAuF7D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,iBAAiB,CAAC,SAAS,CAAC,GAAG,aAAa,CAK/E"}

package/dist/push-daemon.js

@@ -0,0 +1,148 @@
+// Push daemon — async push-to-remote with retry/backoff.
+// See specs/behaviors/push-sync.md and specs/api/repository.md.
+import { execFile } from 'node:child_process';
+import { EventEmitter } from 'node:events';
+import { promisify } from 'node:util';
+const exec = promisify(execFile);
+export class PushDaemon extends EventEmitter {
+    #gitDir;
+    #remote;
+    #branch;
+    #backoff;
+    #maxRetries;
+    #running = true;
+    #stopResolve = null;
+    #pendingCounter = 0;
+    #lastPushedCounter = 0;
+    #lastCommit = null;
+    #lastPushAt = null;
+    #lastError = null;
+    #currentAttempt = null;
+    #currentBackoffMs = null;
+    #inFlight = false;
+    #pendingTimer = null;
+    constructor(opts) {
+        super();
+        this.#gitDir = opts.gitDir;
+        this.#remote = opts.remote;
+        this.#branch = opts.branch;
+        this.#backoff = opts.backoff;
+        this.#maxRetries = opts.maxRetries;
+    }
+    /** Repository invokes this after each successful transact commit. */
+    notifyCommit(commitHash) {
+        if (!this.#running)
+            return;
+        this.#pendingCounter++;
+        this.#lastCommit = commitHash;
+        void this.#drain();
+    }
+    status() {
+        return {
+            running: this.#running,
+            lastPushAt: this.#lastPushAt,
+            lastError: this.#lastError,
+            pendingCommits: Math.max(0, this.#pendingCounter - this.#lastPushedCounter),
+            currentBackoffMs: this.#currentBackoffMs,
+            currentAttempt: this.#currentAttempt,
+        };
+    }
+    /**
+     * Stop accepting new commits, drain in-flight retries up to `timeoutMs`,
+     * resolve once idle. Idempotent.
+     */
+    async stop(opts = {}) {
+        const timeoutMs = opts.timeoutMs ?? 30_000;
+        if (!this.#running)
+            return;
+        this.#running = false;
+        if (this.#pendingTimer) {
+            clearTimeout(this.#pendingTimer);
+            this.#pendingTimer = null;
+        }
+        if (this.#inFlight) {
+            await new Promise((resolve) => {
+                this.#stopResolve = resolve;
+                const t = setTimeout(() => {
+                    this.#stopResolve = null;
+                    resolve();
+                }, timeoutMs);
+                // Ensure we don't keep the process alive
+                t.unref?.();
+            });
+        }
+        this.emit('stopped');
+    }
+    async #drain() {
+        if (this.#inFlight || !this.#running)
+            return;
+        if (this.#pendingCounter <= this.#lastPushedCounter)
+            return;
+        this.#inFlight = true;
+        try {
+            await this.#pushWithBackoff();
+        }
+        finally {
+            this.#inFlight = false;
+            this.#currentAttempt = null;
+            this.#currentBackoffMs = null;
+            const stopResolve = this.#stopResolve;
+            if (stopResolve) {
+                this.#stopResolve = null;
+                stopResolve();
+            }
+            else if (this.#running && this.#pendingCounter > this.#lastPushedCounter) {
+                // More commits arrived during the push; chain another drain.
+                void this.#drain();
+            }
+        }
+    }
+    async #pushWithBackoff() {
+        let attempt = 0;
+        let delay = this.#backoff.base;
+        const counterAtStart = this.#pendingCounter;
+        const commit = this.#lastCommit;
+        while (this.#running) {
+            attempt++;
+            this.#currentAttempt = attempt;
+            this.#currentBackoffMs = null;
+            const started = Date.now();
+            try {
+                await exec('git', ['push', this.#remote, this.#branch], { cwd: this.#gitDir });
+                this.#lastPushedCounter = counterAtStart;
+                this.#lastPushAt = new Date().toISOString();
+                this.emit('push', { commit, durationMs: Date.now() - started });
+                return;
+            }
+            catch (err) {
+                const message = err instanceof Error ? err.message : String(err);
+                this.#lastError = { message, at: new Date().toISOString(), attempt };
+                this.emit('error', { commit, err, attempt });
+                if (attempt >= this.#maxRetries) {
+                    // Give up on this batch; drop the counter forward so we don't loop forever.
+                    this.#lastPushedCounter = counterAtStart;
+                    return;
+                }
+                const next = Math.min(delay, this.#backoff.cap);
+                this.#currentBackoffMs = next;
+                this.emit('retry', { commit, attempt, nextDelayMs: next });
+                await this.#sleep(next);
+                delay = Math.min(delay * this.#backoff.multiplier, this.#backoff.cap);
+            }
+        }
+    }
+    #sleep(ms) {
+        return new Promise((resolve) => {
+            const t = setTimeout(resolve, ms);
+            this.#pendingTimer = t;
+            t.unref?.();
+        });
+    }
+}
+export function resolveBackoff(opt) {
+    if (!opt || opt === 'exponential') {
+        return { base: 1000, multiplier: 2, cap: 3_600_000 };
+    }
+    return opt;
+}
+//# sourceMappingURL=push-daemon.js.map