things-api 0.9.0 → 0.11.0

package/dist/write/heading.js.map

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

package/dist/write/lock.d.ts

@@ -1,10 +1,48 @@
+/**
+ * Advisory mutation lockfile: serializes mutations across concurrent CLI
+ * invocations so create-probe verification is never ambiguous (design §4).
+ * Stale locks (dead pid) are stolen; live locks are awaited with backoff.
+ *
+ * The steal is atomic: a stealer `rename`s the stale lockfile to a private
+ * temp name (rename succeeds for exactly one racer; every other racer gets
+ * ENOENT and falls back to the wait/retry loop), then re-reads the renamed
+ * file to confirm the holder is still dead before discarding it. This closes
+ * the TOCTOU window an unconditional unlink+recreate would leave open, where
+ * two processes could both observe a dead holder and both end up believing
+ * they hold the lock.
+ */
+import { mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
 export declare class MutationLockError extends Error {
     constructor(message: string);
 }
 export interface MutationLock {
     release(): void;
 }
-export declare function acquireMutationLock(path: string, options?: {
+/**
+ * Injectable filesystem + environment seam. Production uses the real node:fs
+ * calls; unit tests substitute this to drive the concurrent steal paths
+ * deterministically. Not part of the public contract — callers pass only the
+ * documented options below.
+ * @internal
+ */
+export interface LockDeps {
+    mkdirSync: typeof mkdirSync;
+    readFileSync: typeof readFileSync;
+    writeFileSync: typeof writeFileSync;
+    renameSync: typeof renameSync;
+    unlinkSync: typeof unlinkSync;
+    pidAlive: (pid: number) => boolean;
+    pid: number;
+    now: () => string;
+    uniqueSuffix: () => string;
+    /** Test-only barrier, awaited after a dead holder is observed and before
+     * the steal `rename`. Inert (absent) in production. */
+    onBeforeSteal?: () => Promise<void> | void;
+}
+export interface AcquireMutationLockOptions {
     waitMs?: number;
     sleep?: (ms: number) => Promise<void>;
-}): Promise<MutationLock>;
+    /** @internal test seam — see {@link LockDeps}. */
+    deps?: LockDeps;
+}
+export declare function acquireMutationLock(path: string, options?: AcquireMutationLockOptions): Promise<MutationLock>;

package/dist/write/lock.js

@@ -2,8 +2,16 @@
  * Advisory mutation lockfile: serializes mutations across concurrent CLI
  * invocations so create-probe verification is never ambiguous (design §4).
  * Stale locks (dead pid) are stolen; live locks are awaited with backoff.
+ *
+ * The steal is atomic: a stealer `rename`s the stale lockfile to a private
+ * temp name (rename succeeds for exactly one racer; every other racer gets
+ * ENOENT and falls back to the wait/retry loop), then re-reads the renamed
+ * file to confirm the holder is still dead before discarding it. This closes
+ * the TOCTOU window an unconditional unlink+recreate would leave open, where
+ * two processes could both observe a dead holder and both end up believing
+ * they hold the lock.
  */
-import { mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
+import { mkdirSync, readFileSync, renameSync, unlinkSync, writeFileSync } from "node:fs";
 import { dirname } from "node:path";
 export class MutationLockError extends Error {
     constructor(message) {
@@ -20,19 +28,37 @@ function pidAlive(pid) {
         return false;
     }
 }
+let stealCounter = 0;
+function realDeps() {
+    return {
+        mkdirSync,
+        readFileSync,
+        writeFileSync,
+        renameSync,
+        unlinkSync,
+        pidAlive,
+        pid: process.pid,
+        now: () => new Date().toISOString(),
+        uniqueSuffix: () => `${Date.now().toString(36)}-${(stealCounter++).toString(36)}-${Math.random().toString(36).slice(2, 8)}`,
+    };
+}
+function errCode(err) {
+    return err.code;
+}
 export async function acquireMutationLock(path, options = {}) {
     const waitMs = options.waitMs ?? 30_000;
     const sleep = options.sleep ?? ((ms) => new Promise((r) => setTimeout(r, ms)));
+    const deps = options.deps ?? realDeps();
     const deadline = Date.now() + waitMs;
-    mkdirSync(dirname(path), { recursive: true });
+    deps.mkdirSync(dirname(path), { recursive: true });
     for (;;) {
         try {
-            const payload = { pid: process.pid, ts: new Date().toISOString() };
-            writeFileSync(path, JSON.stringify(payload), { flag: "wx" });
+            const payload = { pid: deps.pid, ts: deps.now() };
+            deps.writeFileSync(path, JSON.stringify(payload), { flag: "wx" });
             return {
                 release() {
                     try {
-                        unlinkSync(path);
+                        deps.unlinkSync(path);
                     }
                     catch {
                         // already gone — fine
@@ -41,30 +67,81 @@ export async function acquireMutationLock(path, options = {}) {
             };
         }
         catch (err) {
-            if (err.code !== "EEXIST")
+            if (errCode(err) !== "EEXIST")
                 throw err;
             let holder = null;
             try {
-                holder = JSON.parse(readFileSync(path, "utf8"));
+                holder = JSON.parse(deps.readFileSync(path, "utf8"));
             }
             catch {
                 holder = null; // torn write — treat as stale
             }
-            if (holder === null || !pidAlive(holder.pid)) {
-                try {
-                    unlinkSync(path); // stale: holder is dead
-                }
-                catch {
-                    // raced another steal — loop and retry
-                }
+            if (holder === null || !deps.pidAlive(holder.pid)) {
+                await stealStale(path, deps);
+                // Whatever the steal outcome, re-loop: an empty slot lets us create a
+                // fresh lock via `wx`; a slot re-taken by another process sends us
+                // back through the holder check (and, for a live holder, the wait).
                 continue;
             }
             if (Date.now() >= deadline) {
                 throw new MutationLockError(`another mutation is in progress (pid ${holder.pid} since ${holder.ts}); ` +
                     `waited ${waitMs}ms for ${path}`);
             }
+            // lock-acquisition retries are inherently sequential polling against the same lockfile
             await sleep(150);
         }
     }
 }
+/**
+ * Atomically claim and discard a lockfile whose holder appears dead. Exactly
+ * one concurrent stealer wins the `rename`; the rest get ENOENT and return to
+ * retry. After winning, the renamed file is re-read: if a live lock had been
+ * installed at `path` in the meantime (so the file we just moved is actually
+ * live), it is restored to `path` — via `wx`, so a lock re-created by a third
+ * process is never clobbered — and we back off instead of stealing it.
+ */
+async function stealStale(path, deps) {
+    const temp = `${path}.steal-${deps.pid}-${deps.uniqueSuffix()}`;
+    if (deps.onBeforeSteal)
+        await deps.onBeforeSteal();
+    try {
+        deps.renameSync(path, temp);
+    }
+    catch (err) {
+        if (errCode(err) === "ENOENT")
+            return; // lost the rename race — retry
+        throw err;
+    }
+    // We won the rename and now own `temp`. Confirm the holder is still dead.
+    let stolen = null;
+    try {
+        stolen = JSON.parse(deps.readFileSync(temp, "utf8"));
+    }
+    catch {
+        stolen = null; // torn write — genuinely stale
+    }
+    if (stolen !== null && deps.pidAlive(stolen.pid)) {
+        // A live lock slipped in between our read and our rename: this file is not
+        // stale after all. Put it back for its holder (only if the slot is free)
+        // and back off.
+        try {
+            deps.writeFileSync(path, JSON.stringify(stolen), { flag: "wx" });
+        }
+        catch {
+            // slot already re-taken — leave the newcomer's lock intact
+        }
+        tryUnlink(deps, temp);
+        return;
+    }
+    // Confirmed stale — drop it so the next loop turn can create a fresh lock.
+    tryUnlink(deps, temp);
+}
+function tryUnlink(deps, path) {
+    try {
+        deps.unlinkSync(path);
+    }
+    catch {
+        // already gone — fine
+    }
+}
 //# sourceMappingURL=lock.js.map

package/dist/write/lock.js.map

@@ -1 +1 @@
-{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/write/lock.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IAC1C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAOD,SAAS,QAAQ,CAAC,GAAW;IAC3B,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAMD,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAY,EACZ,UAAsE,EAAE;IAExE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC;IACxC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IAC/E,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC;IACrC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE9C,SAAS,CAAC;QACR,IAAI,CAAC;YACH,MAAM,OAAO,GAAgB,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;YAChF,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7D,OAAO;gBACL,OAAO;oBACL,IAAI,CAAC;wBACH,UAAU,CAAC,IAAI,CAAC,CAAC;oBACnB,CAAC;oBAAC,MAAM,CAAC;wBACP,sBAAsB;oBACxB,CAAC;gBACH,CAAC;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAK,GAA6B,CAAC,IAAI,KAAK,QAAQ;gBAAE,MAAM,GAAG,CAAC;YAChE,IAAI,MAAM,GAAuB,IAAI,CAAC;YACtC,IAAI,CAAC;gBACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAgB,CAAC;YACjE,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,GAAG,IAAI,CAAC,CAAC,8BAA8B;YAC/C,CAAC;YACD,IAAI,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7C,IAAI,CAAC;oBACH,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,wBAAwB;gBAC5C,CAAC;gBAAC,MAAM,CAAC;oBACP,uCAAuC;gBACzC,CAAC;gBACD,SAAS;YACX,CAAC;YACD,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC3B,MAAM,IAAI,iBAAiB,CACzB,wCAAwC,MAAM,CAAC,GAAG,UAAU,MAAM,CAAC,EAAE,KAAK;oBACxE,UAAU,MAAM,UAAU,IAAI,EAAE,CACnC,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;AACH,CAAC"}
+{"version":3,"file":"lock.js","sourceRoot":"","sources":["../../src/write/lock.ts"],"names":[],"mappings":"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"}

package/dist/write/make-repeating-project.d.ts

@@ -0,0 +1,4 @@
+import type { ProjectCreateRepeatingParams, RepeatRuleParams } from "./operations.ts";
+import { type MutationResult, type WriteDeps, type WriteOptions } from "./pipeline.ts";
+export declare function runMakeRepeatingProject(deps: WriteDeps, params: RepeatRuleParams, options?: WriteOptions): Promise<MutationResult>;
+export declare function runCreateRepeatingProject(deps: WriteDeps, params: ProjectCreateRepeatingParams, options?: WriteOptions): Promise<MutationResult>;

package/dist/write/make-repeating-project.js

@@ -0,0 +1,253 @@
+import { resolveProjectWriteTarget } from "../read/queries.js";
+import { assertRepeatRule } from "./commands.js";
+import { classifyProjectRepeat, loadTarget } from "./pre-state.js";
+import { fingerprintLabel, runMutation, } from "./pipeline.js";
+/** The two-key GUI-drive block, shared by both orchestrators (mirrors H-UI-DRIVE). */
+function blockedUiDrive(op) {
+    return {
+        kind: "blocked",
+        op,
+        reason: "hazard",
+        hazard: "H-UI-DRIVE",
+        detail: "this operation drives the local Things app through the Accessibility API — the project " +
+            "row-selection, menu press, and Repeat dialog all run through the Accessibility tree",
+        remediation: "pass dangerouslyDriveGui (--dangerously-drive-gui) to proceed; the vector also requires " +
+            "`things config set ui-enabled true` and Accessibility granted to this process (see docs/setup.md)",
+    };
+}
+/** Translate a refusal taxonomy into a blocked result (the guard's user-facing shape). */
+function blockedRefusal(tax) {
+    if (tax.refusal === "not-a-project") {
+        return {
+            kind: "blocked",
+            op: "project.make-repeating",
+            reason: "hazard",
+            hazard: "H-UNKNOWN-DESTINATION",
+            detail: `${tax.detail} — project.make-repeating needs an existing project`,
+            remediation: "verify the uuid with `things projects`, or use `things todo make-repeating` for a to-do",
+        };
+    }
+    const remediation = tax.refusal === "ambiguous-row"
+        ? "rename one of the same-titled projects so the target's row is unambiguous"
+        : tax.refusal === "already-repeating"
+            ? "the project already repeats — use `things project reschedule-repeat` to change its rule"
+            : "target an open, un-trashed project";
+    return {
+        kind: "blocked",
+        op: "project.make-repeating",
+        reason: "hazard",
+        hazard: "H-PROJECT-REPEAT",
+        detail: tax.detail,
+        remediation,
+    };
+}
+/** A per-run txn id (matches the pipeline's leg/summary grouping). */
+function newTxnId(now) {
+    return `txn-${now.getTime().toString(36)}-${process.pid.toString(36)}`;
+}
+/** Forward the caller's audit/timeout knobs onto a delegated leg. */
+function legOptions(base, txn, vector) {
+    const out = { txn };
+    if (vector !== undefined)
+        out.vector = vector;
+    if (base.actor !== undefined)
+        out.actor = base.actor;
+    if (base.verifyTimeoutMs !== undefined)
+        out.verifyTimeoutMs = base.verifyTimeoutMs;
+    if (base.maxDisruption !== undefined)
+        out.maxDisruption = base.maxDisruption;
+    if (base.dangerouslyDriveGui !== undefined)
+        out.dangerouslyDriveGui = base.dangerouslyDriveGui;
+    return out;
+}
+export async function runMakeRepeatingProject(deps, params, options = {}) {
+    const uuid = resolveProjectWriteTarget(deps.db, params.uuid);
+    // Validate the rule BEFORE any coercion — a bad rule must never leave a
+    // coerced-to-someday project stranded.
+    assertRepeatRule(params);
+    const target = loadTarget(deps.db, uuid);
+    const tax = classifyProjectRepeat(deps.db, target);
+    if (tax.kind === "refuse")
+        return blockedRefusal(tax);
+    // The GUI-drive ack gates the coercion decision too: block before touching
+    // anything if it is missing (the delegated drive would block anyway, but the
+    // anytime path must not coerce first only to be blocked at the drive).
+    if (options.dangerouslyDriveGui !== true && options.dryRun !== true) {
+        return blockedUiDrive("project.make-repeating");
+    }
+    const driveParams = {
+        uuid,
+        frequency: params.frequency,
+        interval: params.interval,
+        ...(params.afterCompletion !== undefined && { afterCompletion: params.afterCompletion }),
+        ...(params.weekdays !== undefined && { weekdays: params.weekdays }),
+        ...(params.monthly !== undefined && { monthly: params.monthly }),
+        ...(params.yearly !== undefined && { yearly: params.yearly }),
+        ...(params.ends !== undefined && { ends: params.ends }),
+        ...(params.reminder !== undefined && { reminder: params.reminder }),
+        ...(params.deadline !== undefined && { deadline: params.deadline }),
+        ...(params.startDaysEarlier !== undefined && { startDaysEarlier: params.startDaysEarlier }),
+    };
+    if (options.dryRun === true) {
+        const coercion = tax.kind === "anytime"
+            ? `coerce to Someday (update-project?id=${uuid}&when=someday) → verified → `
+            : "";
+        const view = tax.kind === "area" ? `area ${tax.containerReveal}` : "Someday";
+        return {
+            kind: "dry-run",
+            op: "project.make-repeating",
+            plan: {
+                op: "project.make-repeating",
+                vector: "ui",
+                tier: 3,
+                invocation: `${coercion}reveal ${view} → select the project row (AXSelectedRows) → Items ▸ Repeat… → ` +
+                    `frequency=${params.frequency}, interval=${params.interval} → OK`,
+                expectedDelta: {
+                    mode: "create",
+                    probe: { title: tax.title, type: "project", sinceEpoch: 0 },
+                    assert: [{ field: "repeating.isTemplate", equals: true }],
+                },
+                hazardsChecked: ["H-UNKNOWN-DESTINATION", "H-PROJECT-REPEAT", "H-UI-DRIVE"],
+            },
+        };
+    }
+    // area / someday: no coercion — the single pure-AX drive IS the mutation.
+    if (tax.kind === "area" || tax.kind === "someday") {
+        return runMutation(deps, "project.make-repeating", driveParams, { ...options, vector: "ui" });
+    }
+    // area-less anytime: coerce to Someday (cleanup-free, UIC4-c/d) then drive,
+    // grouped as one txn with a single undoable SUMMARY record.
+    const startedAt = deps.now?.() ?? new Date();
+    const txnId = newTxnId(startedAt);
+    const coerce = await runMutation(deps, "project.update", { uuid, when: "someday" }, legOptions(options, { id: txnId, role: "leg" }, "url-scheme"));
+    if (coerce.kind !== "ok") {
+        // Nothing was promoted; the coercion itself failed or was blocked — surface it.
+        return coerce.kind === "blocked"
+            ? coerce
+            : {
+                kind: "verify-failed",
+                op: "project.make-repeating",
+                reason: coerce.kind === "verify-failed" ? coerce.reason : "mismatch",
+                expected: coerce.kind === "verify-failed"
+                    ? coerce.expected
+                    : { mode: "update", uuid, assert: [] },
+                observed: coerce.kind === "verify-failed" ? coerce.observed : null,
+                detail: "the Someday coercion (the intermediate step for an area-less Anytime project) failed — " +
+                    "the project was NOT made repeating and its schedule is unchanged",
+            };
+    }
+    const drive = await runMutation(deps, "project.make-repeating", driveParams, legOptions(options, { id: txnId, role: "leg" }, "ui"));
+    if (drive.kind !== "ok") {
+        // Non-atomic residue: the project IS now in Someday but was not promoted.
+        // make-repeating normalizes start to someday anyway (UIC4-c), so this is not
+        // a corruption — just an incomplete op. Report it honestly.
+        return drive;
+    }
+    appendSummary(deps, {
+        startedAt,
+        uuid: drive.uuid,
+        txnId,
+        invocation: `make-repeating(project, coerced from anytime) id=${uuid} → template ${drive.uuid ?? "?"}`,
+    });
+    return { ...drive, ...(drive.warnings !== undefined && { warnings: drive.warnings }) };
+}
+export async function runCreateRepeatingProject(deps, params, options = {}) {
+    // create-repeating carries only the base rule vocabulary (the promote can be
+    // followed by a reschedule for a richer rule); validate just that.
+    assertRepeatRule({ frequency: params.frequency, interval: params.interval });
+    // The promote drives the GUI — block before creating anything if the ack is missing.
+    if (options.dangerouslyDriveGui !== true && options.dryRun !== true) {
+        return blockedUiDrive("project.create-repeating");
+    }
+    // Seed a pure-AX taxonomy: an area lands a selectable AREA-view row; otherwise
+    // create in Someday (UIC4-f) so the promote skips the anytime-header problem.
+    const seedWhen = params.area === undefined ? "someday" : undefined;
+    if (options.dryRun === true) {
+        const where = params.area !== undefined ? "the target area (Anytime)" : "Someday";
+        return {
+            kind: "dry-run",
+            op: "project.create-repeating",
+            plan: {
+                op: "project.create-repeating",
+                vector: "ui",
+                tier: 3,
+                invocation: `create project "${params.title}" in ${where} (persists on its own) → then make-repeating ` +
+                    `(select row → Items ▸ Repeat… → frequency=${params.frequency}, interval=${params.interval})`,
+                expectedDelta: {
+                    mode: "create",
+                    probe: { title: params.title, type: "project", sinceEpoch: 0 },
+                    assert: [{ field: "repeating.isTemplate", equals: true }],
+                },
+                hazardsChecked: ["H-UI-DRIVE"],
+            },
+        };
+    }
+    const startedAt = deps.now?.() ?? new Date();
+    const txnId = newTxnId(startedAt);
+    const add = await runMutation(deps, "project.add", {
+        title: params.title,
+        ...(params.notes !== undefined && { notes: params.notes }),
+        ...(params.area !== undefined && { area: params.area }),
+        ...(seedWhen !== undefined && { when: seedWhen }),
+        ...(params.deadline !== undefined && { deadline: params.deadline }),
+        ...(params.todos !== undefined && { todos: params.todos }),
+    }, legOptions(options, { id: txnId, role: "leg" }, "url-scheme"));
+    if (add.kind !== "ok" || add.uuid === null) {
+        return add.kind === "ok"
+            ? {
+                kind: "verify-failed",
+                op: "project.create-repeating",
+                reason: "mismatch",
+                expected: {
+                    mode: "create",
+                    probe: { title: params.title, type: "project", sinceEpoch: 0 },
+                    assert: [],
+                },
+                observed: null,
+                detail: "the project was created but its uuid was not discovered — cannot promote it to repeating",
+            }
+            : add;
+    }
+    const promote = await runMakeRepeatingProject(deps, { uuid: add.uuid, frequency: params.frequency, interval: params.interval }, legOptions(options, { id: txnId, role: "leg" }, "ui"));
+    if (promote.kind !== "ok") {
+        // Honest: the project was created (and persists) but the promote did not land.
+        return promote;
+    }
+    appendSummary(deps, {
+        startedAt,
+        uuid: promote.uuid,
+        txnId,
+        op: "project.create-repeating",
+        invocation: `create-repeating project "${params.title}" → template ${promote.uuid ?? "?"}`,
+    });
+    return { ...promote, op: "project.create-repeating" };
+}
+// --------------------------------------------------------------------- audit
+function appendSummary(deps, args) {
+    const fp = deps.fingerprint();
+    const record = {
+        v: 1,
+        ts: args.startedAt.toISOString(),
+        actor: deps.config.actor,
+        host: deps.config.host,
+        op: args.op ?? "project.make-repeating",
+        uuid: args.uuid,
+        vector: "ui",
+        disruption: 3,
+        invocation: args.invocation,
+        requested: {},
+        txn: { id: args.txnId, role: "summary" },
+        pre: null,
+        observed: args.uuid !== null ? { uuid: args.uuid } : null,
+        result: "ok",
+        verify: null,
+        durationMs: (deps.now?.() ?? new Date()).getTime() - args.startedAt.getTime(),
+        env: {
+            pkg: deps.pkgVersion ?? "0.0.1",
+            dbVersion: fp.observation.databaseVersion,
+            fingerprint: fingerprintLabel(fp, deps.config),
+        },
+    };
+    deps.audit.append(record);
+}
+//# sourceMappingURL=make-repeating-project.js.map

package/dist/write/make-repeating-project.js.map

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