@bassfish/cli 0.1.0

package/dist/note.js

@@ -0,0 +1,181 @@
+import { increment, requireThat } from './domain.js';
+export const normalizeLabels = (labels) => {
+    const sorted = [...labels].sort();
+    requireThat(new Set(sorted).size === sorted.length, 'INVALID_ARGUMENT', 'Note labels must be unique.');
+    return sorted;
+};
+export const normalizeLinks = (links) => {
+    const sorted = [...links].sort((a, b) => `${a.targetType}:${a.targetId}`.localeCompare(`${b.targetType}:${b.targetId}`));
+    requireThat(new Set(sorted.map(link => `${link.targetType}:${link.targetId}`)).size === sorted.length, 'INVALID_ARGUMENT', 'Resource links must be unique.');
+    return sorted;
+};
+function applyUnifiedPatch(body, patch) {
+    const rows = patch.replaceAll('\r\n', '\n').split('\n');
+    requireThat(rows.filter(row => row.startsWith('--- ')).length <= 1 && rows.filter(row => row.startsWith('+++ ')).length <= 1, 'PATCH_REJECTED', 'A patch may contain only one file section.');
+    requireThat(!rows.some(row => /^(rename (from|to)|new file mode|deleted file mode)/.test(row)), 'PATCH_REJECTED', 'File creation, deletion, and rename patches are not supported.');
+    const source = body.split('\n');
+    const output = [];
+    let sourceIndex = 0;
+    let index = 0;
+    while (index < rows.length && !rows[index].startsWith('@@ '))
+        index++;
+    requireThat(index < rows.length, 'PATCH_REJECTED', 'The unified patch contains no hunks.');
+    while (index < rows.length) {
+        const header = rows[index++];
+        const match = /^@@ -(\d+)(?:,(\d+))? \+(\d+)(?:,(\d+))? @@/.exec(header);
+        requireThat(match, 'PATCH_REJECTED', 'A patch hunk header is invalid.');
+        const oldStart = Number(match[1]) - 1;
+        requireThat(oldStart >= sourceIndex && oldStart <= source.length, 'PATCH_REJECTED', 'A patch hunk is out of order or out of range.');
+        output.push(...source.slice(sourceIndex, oldStart));
+        sourceIndex = oldStart;
+        let removed = 0;
+        let added = 0;
+        while (index < rows.length && !rows[index].startsWith('@@ ')) {
+            const row = rows[index++];
+            if (row === '\' || (index === rows.length && row === ''))
+                continue;
+            const marker = row[0];
+            const text = row.slice(1);
+            requireThat(marker === ' ' || marker === '+' || marker === '-', 'PATCH_REJECTED', 'A patch hunk line is invalid.');
+            if (marker === ' ' || marker === '-') {
+                requireThat(source[sourceIndex] === text, 'PATCH_REJECTED', 'Patch context does not exactly match the claimed revision.');
+                if (marker === ' ')
+                    output.push(text);
+                sourceIndex++;
+                removed++;
+            }
+            if (marker === '+') {
+                output.push(text);
+                added++;
+            }
+        }
+        requireThat(removed === Number(match[2] ?? 1) && added === Number(match[4] ?? 1), 'PATCH_REJECTED', 'Patch hunk counts do not match its header.');
+    }
+    output.push(...source.slice(sourceIndex));
+    return output.join('\n');
+}
+function applyOne(note, mutation) {
+    const next = structuredClone(note);
+    const contentEdit = ['replaceNoteBody', 'patchNoteBody', 'appendNoteBody', 'prependNoteBody', 'replaceNoteText', 'upsertNoteSection', 'moveNote', 'setNoteMetadata', 'setLinks'].includes(mutation.kind);
+    requireThat(!contentEdit || note.state === 'active', 'RESOURCE_ARCHIVED', 'Restore the note before editing it.');
+    switch (mutation.kind) {
+        case 'replaceNoteBody':
+            next.body = mutation.body;
+            break;
+        case 'patchNoteBody':
+            next.body = applyUnifiedPatch(note.body, mutation.patch);
+            break;
+        case 'appendNoteBody':
+            next.body += mutation.body;
+            break;
+        case 'prependNoteBody':
+            next.body = mutation.body + next.body;
+            break;
+        case 'moveNote':
+            next.path = mutation.path;
+            break;
+        case 'setNoteMetadata':
+            requireThat(mutation.title !== undefined || mutation.labels !== undefined || mutation.noteKind !== undefined, 'INVALID_ARGUMENT', 'Set at least one metadata field.');
+            if (mutation.title !== undefined)
+                next.title = mutation.title;
+            if (mutation.labels !== undefined)
+                next.labels = normalizeLabels(mutation.labels);
+            if (mutation.noteKind !== undefined)
+                next.kind = mutation.noteKind;
+            break;
+        case 'setLinks':
+            next.links = normalizeLinks(mutation.links);
+            break;
+        case 'archiveNote':
+            requireThat(note.state === 'active', 'NO_CHANGE', 'Only an active note can be archived.');
+            next.state = 'archived';
+            break;
+        case 'deleteNote':
+            requireThat(note.state !== 'deleted', 'NO_CHANGE', 'The note is already deleted.');
+            next.state = 'deleted';
+            break;
+        case 'activateNote':
+            requireThat(note.state !== 'active', 'NO_CHANGE', 'The note is already active.');
+            next.state = 'active';
+            break;
+        case 'replaceNoteText': {
+            const count = note.body.split(mutation.find).length - 1;
+            requireThat(count === mutation.expectedOccurrences, 'OCCURRENCE_MISMATCH', 'The expected occurrence count does not match the claimed body.');
+            next.body = note.body.split(mutation.find).join(mutation.replace);
+            break;
+        }
+        case 'upsertNoteSection': {
+            const headings = outline(note.body);
+            const matches = headings.filter(item => item.path.join('\u0000') === mutation.headingPath.join('\u0000'));
+            if (!matches.length) {
+                requireThat(mutation.createIfMissing, 'SECTION_NOT_FOUND', 'The requested Markdown section does not exist.');
+                const suffix = `${note.body && !note.body.endsWith('\n') ? '\n' : ''}\n${mutation.headingPath.map((heading, index) => `${'#'.repeat(index + 1)} ${heading}`).join('\n\n')}\n\n${mutation.body}`;
+                next.body += suffix;
+            }
+            else {
+                requireThat(matches.length === 1 || mutation.occurrence !== undefined, 'SECTION_AMBIGUOUS', 'The heading path is ambiguous; provide an occurrence.');
+                const match = matches[(mutation.occurrence ?? 1) - 1];
+                requireThat(match, 'SECTION_NOT_FOUND', 'The heading occurrence does not exist.');
+                const lines = note.body.split('\n');
+                const heading = lines[match.startLine - 1];
+                lines.splice(match.startLine - 1, match.endLine - match.startLine + 1, heading, mutation.body);
+                next.body = lines.join('\n');
+            }
+            break;
+        }
+    }
+    requireThat(Buffer.byteLength(next.body, 'utf8') <= 256 * 1024, 'CONTENT_TOO_LARGE', 'The resulting note exceeds 256 KiB.');
+    return next;
+}
+export function outline(body) {
+    const lines = body.split('\n');
+    const items = [];
+    const stack = [];
+    let fence;
+    for (let index = 0; index < lines.length; index++) {
+        const line = lines[index];
+        const marker = /^ {0,3}(```+|~~~+)/.exec(line)?.[1];
+        if (marker) {
+            if (!fence)
+                fence = marker[0];
+            else if (marker[0] === fence)
+                fence = undefined;
+            continue;
+        }
+        if (fence)
+            continue;
+        const atx = /^ {0,3}(#{1,6})\s+(.+?)\s*#*\s*$/.exec(line);
+        const setext = index + 1 < lines.length ? /^ {0,3}(=+|-+)\s*$/.exec(lines[index + 1]) : null;
+        const level = atx ? atx[1].length : setext && line.trim() ? (setext[1][0] === '=' ? 1 : 2) : 0;
+        if (!level)
+            continue;
+        const heading = (atx ? atx[2] : line.trim());
+        stack.length = level - 1;
+        stack[level - 1] = heading;
+        items.push({ level, heading, path: [...stack], startLine: index + 1, endLine: lines.length });
+        if (!atx)
+            index++;
+    }
+    for (let index = 0; index < items.length; index++) {
+        const next = items.slice(index + 1).find(item => item.level <= items[index].level);
+        if (next)
+            items[index].endLine = next.startLine - 1;
+    }
+    return items;
+}
+export function prepareNote(note, mutation, actor, at) {
+    let next = structuredClone(note);
+    if (mutation.kind === 'batchNote')
+        for (const item of mutation.mutations)
+            next = applyOne(next, item);
+    else
+        next = applyOne(next, mutation);
+    const comparable = (value) => JSON.stringify({ ...value, revision: 'x', lastEditor: 'x', lastEditorName: 'x', updatedAt: 'x' });
+    requireThat(comparable(next) !== comparable(note), 'NO_CHANGE', 'The note mutation makes no change.');
+    next.revision = increment(note.revision);
+    next.lastEditor = actor.identityId;
+    next.lastEditorName = actor.name;
+    next.updatedAt = at;
+    return next;
+}
+//# sourceMappingURL=note.js.map

package/dist/note.js.map

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

package/dist/repository.d.ts

@@ -0,0 +1 @@
+export declare function resolveRepository(workspace: string): Promise<string>;

package/dist/repository.js

@@ -0,0 +1,21 @@
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { realpath } from 'node:fs/promises';
+import { BassfishError } from './domain.js';
+const exec = promisify(execFile);
+export async function resolveRepository(workspace) {
+    try {
+        const root = await realpath(workspace);
+        const env = { ...process.env };
+        // An enclosing shell's Git overrides must not redirect a workspace's project identity.
+        for (const key of Object.keys(env))
+            if (key.startsWith('GIT_'))
+                delete env[key];
+        const { stdout } = await exec('git', ['-C', root, 'rev-parse', '--path-format=absolute', '--git-common-dir'], { env, timeout: 5000 });
+        return await realpath(stdout.trim());
+    }
+    catch {
+        throw new BassfishError('NOT_A_REPOSITORY', 'The configured workspace must be a local Git repository.');
+    }
+}
+//# sourceMappingURL=repository.js.map

package/dist/repository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.js","sourceRoot":"","sources":["../src/repository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,IAAI,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AACjC,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,SAAiB;IACvD,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;QAC/B,uFAAuF;QACvF,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;YAAE,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC;gBAAE,OAAO,GAAG,CAAC,GAAG,CAAC,CAAC;QAChF,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,wBAAwB,EAAE,kBAAkB,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QACtI,OAAO,MAAM,QAAQ,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QAAC,MAAM,IAAI,aAAa,CAAC,kBAAkB,EAAE,0DAA0D,CAAC,CAAC;IAAC,CAAC;AACtH,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,12 @@
+import type { Clock } from './domain.js';
+export declare class SystemClock implements Clock {
+    private readonly origin;
+    private offset;
+    now(): number;
+    wallNow(): number;
+    discontinuity(): boolean;
+}
+export declare class KeyedMutex {
+    private readonly tails;
+    run<T>(key: string, fn: () => Promise<T>): Promise<T>;
+}

package/dist/runtime.js

@@ -0,0 +1,32 @@
+import { performance } from 'node:perf_hooks';
+export class SystemClock {
+    origin = Date.now() - performance.now();
+    offset = Date.now() - performance.now();
+    now() { return this.origin + performance.now(); }
+    wallNow() { return Date.now(); }
+    discontinuity() {
+        const offset = Date.now() - performance.now();
+        const changed = Math.abs(offset - this.offset) > 2_000;
+        this.offset = offset;
+        return changed;
+    }
+}
+export class KeyedMutex {
+    tails = new Map();
+    async run(key, fn) {
+        const previous = this.tails.get(key) ?? Promise.resolve();
+        let release;
+        const next = new Promise(resolve => { release = resolve; });
+        this.tails.set(key, next);
+        await previous;
+        try {
+            return await fn();
+        }
+        finally {
+            release();
+            if (this.tails.get(key) === next)
+                this.tails.delete(key);
+        }
+    }
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG9C,MAAM,OAAO,WAAW;IACL,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IACjD,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IAChD,GAAG,KAAa,OAAO,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACzD,OAAO,KAAa,OAAO,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IACxC,aAAa;QACX,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,KAAK,CAAC;QACvD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAED,MAAM,OAAO,UAAU;IACJ,KAAK,GAAG,IAAI,GAAG,EAAyB,CAAC;IAC1D,KAAK,CAAC,GAAG,CAAI,GAAW,EAAE,EAAoB;QAC5C,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1D,IAAI,OAAoB,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE,GAAG,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,MAAM,QAAQ,CAAC;QACf,IAAI,CAAC;YAAC,OAAO,MAAM,EAAE,EAAE,CAAC;QAAC,CAAC;gBAClB,CAAC;YAAC,OAAO,EAAE,CAAC;YAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI;gBAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAAC,CAAC;IAClF,CAAC;CACF"}

package/dist/service.d.ts

@@ -0,0 +1,106 @@
+import type { Clock, ContentStore, ControlStore, FloorRequest, Mutation, MutationResult, ProjectRestoreResult, ResourceType } from './domain.js';
+import { NoteSearchIndex } from './storage/search.js';
+export interface Limits {
+    offerMs: number;
+    leaseMs: number;
+    reconnectMs: number;
+    instanceMs: number;
+    queueMs: number;
+    retentionMs: number;
+    waitMs: number;
+}
+export declare const defaultLimits: Limits;
+/** Application service: all coordination is persisted by ControlStore; all content uses ContentStore. */
+export declare class Bassfish {
+    readonly control: ControlStore;
+    readonly content: ContentStore;
+    readonly clock: Clock;
+    private readonly searchIndex?;
+    private readonly dataDir?;
+    readonly epoch: `${string}-${string}-${string}-${string}-${string}`;
+    readonly limits: Limits;
+    private readonly writers;
+    private readonly restoreSecret;
+    constructor(control: ControlStore, content: ContentStore, clock: Clock, limits?: Partial<Limits>, searchIndex?: NoteSearchIndex | undefined, dataDir?: string | undefined);
+    initialize(): Promise<void>;
+    open(commonDir: string, preferredName?: string): Promise<{
+        agentHandle: string;
+        session: unknown;
+    }>;
+    private actor;
+    private ready;
+    private creationAllowed;
+    private finish;
+    private disconnectIn;
+    disconnect(handle: string, clean?: boolean): void;
+    heartbeat(handle: string): void;
+    sweep(): void;
+    private promote;
+    private makeAvailable;
+    private materializeOffer;
+    private rebind;
+    info(handle: string): unknown;
+    requestName(handle: string, name: string): unknown;
+    private statusIn;
+    private ownRequest;
+    private ownTask;
+    private taskView;
+    getTask(handle: string, taskId: string, materialize?: boolean): Record<string, unknown>;
+    cancelTask(handle: string, taskId: string): Record<string, unknown>;
+    waitTask(handle: string, taskId: string, updatedAfter: number, timeout: number, signal?: AbortSignal): Promise<Record<string, unknown>>;
+    status(handle: string, ticketId: string): Record<string, unknown>;
+    private held;
+    requestResourceFloor(handle: string, resourceTypeOrId: ResourceType | string, maybeResourceId?: string, deliveryMode?: 'ticket' | 'task'): Promise<Record<string, unknown>>;
+    requestProjectFloor(handle: string, purpose: FloorRequest['purpose'], deliveryMode?: 'ticket' | 'task'): Promise<Record<string, unknown>>;
+    claimFloor(handle: string, offerId: string, limit: number, noteCursor?: string): Promise<unknown>;
+    read(handle: string, floorId: string, fence: string, limit: number, before?: string): Promise<unknown>;
+    readNote(handle: string, floorId: string, fence: string, cursor?: string): Promise<unknown>;
+    readFloor(handle: string, floorId: string, fence: string, cursor?: string): Promise<unknown>;
+    noteOutline(handle: string, floorId: string, fence: string): Promise<unknown>;
+    findNote(handle: string, floorId: string, fence: string, query: string, mode: 'literal' | 'regex', limit: number): Promise<unknown>;
+    releaseFloor(handle: string, floorId: string, fence: string): unknown;
+    cancelFloorRequest(handle: string, ticketId: string): unknown;
+    waitForFloor(handle: string, ticketId: string, timeout: number, signal?: AbortSignal): Promise<unknown>;
+    createThread(handle: string, title: string, description: string): Promise<unknown>;
+    private noteMetadata;
+    private validateLinks;
+    createNote(handle: string, input: {
+        path: string;
+        title: string;
+        body: string;
+        labels: string[];
+        noteKind: string | null;
+        links: {
+            targetType: 'note' | 'thread' | 'message';
+            targetId: string;
+        }[];
+    }): Promise<unknown>;
+    private signRestore;
+    private verifyRestore;
+    resourceHistory(handle: string, floorId: string, fence: string, offset: number, limit: number): Promise<unknown>;
+    resourceAt(handle: string, floorId: string, fence: string, revision: string, limit: number, cursor?: string): Promise<unknown>;
+    diffResource(handle: string, floorId: string, fence: string, revision: string): Promise<unknown>;
+    previewRestore(handle: string, floorId: string, fence: string, revision: string): Promise<unknown>;
+    restoreRevision(handle: string, floorId: string, fence: string, token: string): Promise<MutationResult>;
+    private projectHeld;
+    projectSnapshotInfo(handle: string, floorId: string, fence: string): Promise<unknown>;
+    private cursorOffset;
+    private nextCursor;
+    projectSearch(handle: string, floorId: string, fence: string, query: string, states: string[], limit: number, cursor?: string): Promise<unknown>;
+    projectHistorySearch(handle: string, floorId: string, fence: string, query: string, noteId: string | undefined, states: string[], limit: number, cursor?: string): Promise<unknown>;
+    projectHistoryList(handle: string, floorId: string, fence: string, limit: number, cursor?: string): Promise<unknown>;
+    private buildProjectRestore;
+    previewProjectRestore(handle: string, floorId: string, fence: string, targetCommit: string, limit: number, cursor?: string): Promise<unknown>;
+    restoreProject(handle: string, floorId: string, fence: string, token: string): Promise<ProjectRestoreResult>;
+    exportProject(handle: string, floorId: string, fence: string): Promise<unknown>;
+    commitFloor(handle: string, floorId: string, fence: string, base: string, mutation: Mutation): Promise<MutationResult>;
+    private finalize;
+    private persist;
+    recover(projectId: string): Promise<void>;
+    inspect(): unknown;
+    hasPendingWork(): boolean;
+    forceRelease(floorId: string): void;
+    call(handle: string, name: string, input: unknown, signal?: AbortSignal, options?: {
+        taskCapable?: boolean;
+    }): Promise<unknown>;
+}