@hearsay-tools/squawk 0.17.0-pr3285.5787 → 0.18.0-dev.5793

package/dist/legacy-runs.d.ts

@@ -1,56 +0,0 @@
-import { z } from 'zod';
-/**
- * Tasks whose own files stay in `.ai/cezar/` after a project move (owner decision A,
- * hearsay-tools/cezarion#2778). A move carries the run store and everything else to `.ai/squawk/`,
- * but a task that can still resume at the move (live, or not archived: a human can Continue a
- * finished task) keeps its own items where its agent knows them: its worktree, its handoff file
- * and other `runs/<id>…` files, its scratch directories. The moved store keeps their absolute
- * paths. The move writes the ids of those tasks to `<root>/.ai/squawk/legacy-runs.json`; a later
- * move carries their items once the task is archived or deleted, and removes the file when no
- * task is left.
- *
- * Every path helper of a run's own items resolves its directory with `runDataDir`, so the cockpit
- * reads and writes a leftover task's items in `.ai/cezar/`, and the read-only rule of the fallback
- * directory (`fallbackProjectWriteError`) exempts them.
- */
-export declare const LEGACY_RUNS_FILE = "legacy-runs.json";
-export declare const legacyRunsSchema: z.ZodObject<{
-    version: z.ZodLiteral<1>;
-    runs: z.ZodArray<z.ZodString>;
-}, z.core.$strict>;
-/**
- * `legacy-runs.json` exists but cannot be read or validated. Which tasks keep their items in
- * `.ai/cezar/` is then unknown: a reader that guessed `.ai/squawk/` could miss a kept task's
- * history and write a second copy beside it, so every per-run path refuses until the project's
- * next move rewrites the file from the run store.
- */
-export declare class LegacyRunsUnreadableError extends Error {
-    readonly file: string;
-    constructor(file: string, cause: unknown);
-}
-/**
- * The ids of the tasks that keep their own items in `.ai/cezar/` beside the moved directory
- * `movedDir`. Only an absent file means none; a file that is present but unreadable or invalid
- * throws `LegacyRunsUnreadableError`, and is read again on the next call.
- */
-export declare function legacyRunIds(movedDir: string): ReadonlySet<string>;
-/** Forget what was read for `movedDir`: the move that rewrites the file calls it. */
-export declare function forgetLegacyRunIds(movedDir: string): void;
-/** The tasks whose own items stay in `.ai/cezar/` beside `dataDir`; none unless it is a moved project directory. */
-export declare function legacyRunsBeside(dataDir: string): string[];
-/**
- * The data directory that holds run `runId`'s own items: `.ai/cezar/` beside a moved project's
- * `dataDir` for a task the move left there, else `dataDir` itself.
- */
-export declare function runDataDir(dataDir: string, runId: string): string;
-/**
- * The run among `ids` that owns the item at `parts`, a path relative to a project data directory:
- * `worktrees/<id>`, `tmp/<id>`, `preview/<id>`, `t/<first 8 of id>` and every `runs/<id>…` entry,
- * and anything inside them. Undefined for every other path.
- */
-export declare function legacyItemOwner(parts: readonly string[], ids: ReadonlySet<string>): string | undefined;
-/**
- * Whether `path` lies inside an item of a task that kept its files in the legacy directory of
- * the project at `root`: writes there stay allowed although `.ai/cezar/` is the fallback.
- */
-export declare function legacyRunItem(root: string, path: string): boolean;

package/dist/legacy-runs.js

@@ -1,122 +0,0 @@
-import { readFileSync } from 'node:fs';
-import { basename, dirname, join, resolve, sep } from 'node:path';
-import { z } from 'zod';
-import { runIdParamSchema } from './contract/index.js';
-/**
- * Tasks whose own files stay in `.ai/cezar/` after a project move (owner decision A,
- * hearsay-tools/cezarion#2778). A move carries the run store and everything else to `.ai/squawk/`,
- * but a task that can still resume at the move (live, or not archived: a human can Continue a
- * finished task) keeps its own items where its agent knows them: its worktree, its handoff file
- * and other `runs/<id>…` files, its scratch directories. The moved store keeps their absolute
- * paths. The move writes the ids of those tasks to `<root>/.ai/squawk/legacy-runs.json`; a later
- * move carries their items once the task is archived or deleted, and removes the file when no
- * task is left.
- *
- * Every path helper of a run's own items resolves its directory with `runDataDir`, so the cockpit
- * reads and writes a leftover task's items in `.ai/cezar/`, and the read-only rule of the fallback
- * directory (`fallbackProjectWriteError`) exempts them.
- */
-export const LEGACY_RUNS_FILE = 'legacy-runs.json';
-export const legacyRunsSchema = z.object({ version: z.literal(1), runs: z.array(runIdParamSchema.shape.id) }).strict();
-const cache = new Map();
-/**
- * `legacy-runs.json` exists but cannot be read or validated. Which tasks keep their items in
- * `.ai/cezar/` is then unknown: a reader that guessed `.ai/squawk/` could miss a kept task's
- * history and write a second copy beside it, so every per-run path refuses until the project's
- * next move rewrites the file from the run store.
- */
-export class LegacyRunsUnreadableError extends Error {
-    file;
-    constructor(file, cause) {
-        super(`Cannot read ${file}: ${cause instanceof Error ? cause.message : String(cause)}. `
-            + 'It names the tasks whose files stayed in .ai/cezar/; the next cockpit start or migrate-project rewrites it', { cause });
-        this.file = file;
-    }
-}
-/** Whether `dataDir` is a project's moved directory, `<root>/.ai/squawk`. */
-function movedDirectory(dataDir) {
-    return basename(dataDir) === 'squawk' && basename(dirname(dataDir)) === '.ai';
-}
-/**
- * The ids of the tasks that keep their own items in `.ai/cezar/` beside the moved directory
- * `movedDir`. Only an absent file means none; a file that is present but unreadable or invalid
- * throws `LegacyRunsUnreadableError`, and is read again on the next call.
- */
-export function legacyRunIds(movedDir) {
-    const key = resolve(movedDir);
-    const cached = cache.get(key);
-    if (cached)
-        return cached;
-    const file = join(key, LEGACY_RUNS_FILE);
-    let ids;
-    try {
-        ids = new Set(legacyRunsSchema.parse(JSON.parse(readFileSync(file, 'utf8'))).runs);
-    }
-    catch (error) {
-        if (error.code !== 'ENOENT')
-            throw new LegacyRunsUnreadableError(file, error);
-        ids = new Set();
-    }
-    cache.set(key, ids);
-    return ids;
-}
-/** Forget what was read for `movedDir`: the move that rewrites the file calls it. */
-export function forgetLegacyRunIds(movedDir) {
-    cache.delete(resolve(movedDir));
-}
-/** The tasks whose own items stay in `.ai/cezar/` beside `dataDir`; none unless it is a moved project directory. */
-export function legacyRunsBeside(dataDir) {
-    return movedDirectory(dataDir) ? [...legacyRunIds(dataDir)] : [];
-}
-/**
- * The data directory that holds run `runId`'s own items: `.ai/cezar/` beside a moved project's
- * `dataDir` for a task the move left there, else `dataDir` itself.
- */
-export function runDataDir(dataDir, runId) {
-    if (!movedDirectory(dataDir) || !legacyRunIds(dataDir).has(runId))
-        return dataDir;
-    return join(dirname(dataDir), 'cezar');
-}
-const RUN_FILE = /^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})(?:$|[.-])/i;
-const SHORT_SCRATCH = /^[0-9a-f]{8}$/i;
-/**
- * The run among `ids` that owns the item at `parts`, a path relative to a project data directory:
- * `worktrees/<id>`, `tmp/<id>`, `preview/<id>`, `t/<first 8 of id>` and every `runs/<id>…` entry,
- * and anything inside them. Undefined for every other path.
- */
-export function legacyItemOwner(parts, ids) {
-    const [top, name] = parts;
-    if (!name || parts.includes('..') || parts.includes('.'))
-        return undefined;
-    if (top === 'worktrees' || top === 'tmp' || top === 'preview')
-        return ids.has(name) ? name : undefined;
-    if (top === 't')
-        return SHORT_SCRATCH.test(name) ? [...ids].find(id => id.slice(0, 8) === name) : undefined;
-    if (top === 'runs') {
-        const id = RUN_FILE.exec(name)?.[1];
-        return id && ids.has(id) ? id : undefined;
-    }
-    return undefined;
-}
-/**
- * Whether `path` lies inside an item of a task that kept its files in the legacy directory of
- * the project at `root`: writes there stay allowed although `.ai/cezar/` is the fallback.
- */
-export function legacyRunItem(root, path) {
-    const legacy = resolve(root, '.ai', 'cezar');
-    const target = resolve(path);
-    if (!target.startsWith(legacy + sep))
-        return false;
-    let ids;
-    // A write guard fails closed: with the list unreadable, no item counts as a kept task's.
-    try {
-        ids = legacyRunIds(resolve(root, '.ai', 'squawk'));
-    }
-    catch (error) {
-        if (error instanceof LegacyRunsUnreadableError)
-            return false;
-        throw error;
-    }
-    return legacyItemOwner(target.slice(legacy.length + 1).split(sep), ids) !== undefined;
-}
-//# sourceMappingURL=legacy-runs.js.map

package/dist/legacy-runs.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"legacy-runs.js","sourceRoot":"","sources":["../src/legacy-runs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAEvE;;;;;;;;;;;;;GAaG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,kBAAkB,CAAC;AAEnD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAEvH,MAAM,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;AAErD;;;;;GAKG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAC7B,IAAI;IAAzB,YAAqB,IAAY,EAAE,KAAc;QAC/C,KAAK,CAAC,eAAe,IAAI,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI;cACpF,4GAA4G,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;oBAF1G,IAAI;IAGzB,CAAC;CACF;AAED,6EAA6E;AAC7E,SAAS,cAAc,CAAC,OAAe;IACrC,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,KAAK,CAAC;AAChF,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB;IAC3C,MAAM,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC9B,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAC1B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IACzC,IAAI,GAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,GAAG,GAAG,IAAI,GAAG,CAAC,gBAAgB,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACrF,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,IAAI,yBAAyB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QACzG,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;IAClB,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IACpB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,qFAAqF;AACrF,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;AAClC,CAAC;AAED,oHAAoH;AACpH,MAAM,UAAU,gBAAgB,CAAC,OAAe;IAC9C,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACnE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,KAAa;IACvD,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAClF,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;AACzC,CAAC;AAED,MAAM,QAAQ,GAAG,4EAA4E,CAAC;AAC9F,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAEvC;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,KAAwB,EAAE,GAAwB;IAChF,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC;IAC1B,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3E,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;IACvG,IAAI,GAAG,KAAK,GAAG;QAAE,OAAO,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5G,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QACnB,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QACpC,OAAO,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5C,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,IAAY;IACtD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7B,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACnD,IAAI,GAAwB,CAAC;IAC7B,yFAAyF;IACzF,IAAI,CAAC;QAAC,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC;IAAC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACzE,IAAI,KAAK,YAAY,yBAAyB;YAAE,OAAO,KAAK,CAAC;QAC7D,MAAM,KAAK,CAAC;IACd,CAAC;IACD,OAAO,eAAe,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,KAAK,SAAS,CAAC;AACxF,CAAC"}