@protoboxai/codeloop 0.3.0

package/dist/lib/board.js

@@ -0,0 +1,86 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync, renameSync } from 'fs';
+import { join, dirname } from 'path';
+const DEFAULT_COLUMNS = ['backlog', 'planned', 'in_progress', 'review', 'done'];
+export function createBoard() {
+    return {
+        version: 1,
+        columns: [...DEFAULT_COLUMNS],
+        tasks: [],
+    };
+}
+export function nextId(board) {
+    if (board.tasks.length === 0)
+        return 't-001';
+    const maxNum = board.tasks.reduce((max, t) => {
+        const num = parseInt(t.id.replace('t-', ''), 10);
+        return num > max ? num : max;
+    }, 0);
+    return `t-${String(maxNum + 1).padStart(3, '0')}`;
+}
+export function addTask(board, input) {
+    const now = new Date().toISOString();
+    const task = {
+        id: nextId(board),
+        title: input.title,
+        description: input.description,
+        status: input.status ?? 'backlog',
+        labels: input.labels ?? [],
+        steps: input.steps ? [...input.steps] : [],
+        commits: [],
+        acceptanceCriteria: input.acceptanceCriteria,
+        createdAt: now,
+        updatedAt: now,
+    };
+    return {
+        ...board,
+        tasks: [...board.tasks, task],
+    };
+}
+export function updateTask(board, id, patch) {
+    const index = board.tasks.findIndex(t => t.id === id);
+    if (index === -1)
+        throw new Error(`Task ${id} not found`);
+    const now = new Date().toISOString();
+    const updated = {
+        ...board.tasks[index],
+        ...patch,
+        updatedAt: now,
+    };
+    const tasks = [...board.tasks];
+    tasks[index] = updated;
+    return { ...board, tasks };
+}
+export function moveTask(board, id, newStatus) {
+    return updateTask(board, id, { status: newStatus });
+}
+export function deleteTask(board, id) {
+    const index = board.tasks.findIndex(t => t.id === id);
+    if (index === -1)
+        throw new Error(`Task ${id} not found`);
+    return {
+        ...board,
+        tasks: board.tasks.filter(t => t.id !== id),
+    };
+}
+export function getTask(board, id) {
+    return board.tasks.find(t => t.id === id);
+}
+const BOARD_PATH = '.codeloop/board.json';
+export function loadBoard(dir) {
+    const filePath = join(dir, BOARD_PATH);
+    if (!existsSync(filePath))
+        return createBoard();
+    const content = readFileSync(filePath, 'utf-8');
+    return JSON.parse(content);
+}
+export function saveBoard(dir, board) {
+    const filePath = join(dir, BOARD_PATH);
+    const dirPath = dirname(filePath);
+    if (!existsSync(dirPath)) {
+        mkdirSync(dirPath, { recursive: true });
+    }
+    const tmpPath = filePath + '.tmp';
+    writeFileSync(tmpPath, JSON.stringify(board, null, 2) + '\n', 'utf-8');
+    renameSync(tmpPath, filePath);
+}
+//# sourceMappingURL=board.js.map

package/dist/lib/board.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"board.js","sourceRoot":"","sources":["../../src/lib/board.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AACpF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AA0BrC,MAAM,eAAe,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;AAEhF,MAAM,UAAU,WAAW;IACzB,OAAO;QACL,OAAO,EAAE,CAAC;QACV,OAAO,EAAE,CAAC,GAAG,eAAe,CAAC;QAC7B,KAAK,EAAE,EAAE;KACV,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,KAAY;IACjC,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IAE7C,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE;QAC3C,MAAM,GAAG,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QACjD,OAAO,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAC/B,CAAC,EAAE,CAAC,CAAC,CAAC;IAEN,OAAO,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;AACpD,CAAC;AAWD,MAAM,UAAU,OAAO,CAAC,KAAY,EAAE,KAAmB;IACvD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,IAAI,GAAS;QACjB,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC;QACjB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,SAAS;QACjC,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;QAC1B,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;QAC1C,OAAO,EAAE,EAAE;QACX,kBAAkB,EAAE,KAAK,CAAC,kBAAkB;QAC5C,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;KACf,CAAC;IAEF,OAAO;QACL,GAAG,KAAK;QACR,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC;KAC9B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAY,EAAE,EAAU,EAAE,KAA8C;IACjG,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAE1D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,OAAO,GAAS;QACpB,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC;QACrB,GAAG,KAAK;QACR,SAAS,EAAE,GAAG;KACf,CAAC;IAEF,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IAC/B,KAAK,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;IAEvB,OAAO,EAAE,GAAG,KAAK,EAAE,KAAK,EAAE,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,KAAY,EAAE,EAAU,EAAE,SAAyB;IAC1E,OAAO,UAAU,CAAC,KAAK,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,KAAY,EAAE,EAAU;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACtD,IAAI,KAAK,KAAK,CAAC,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IAE1D,OAAO;QACL,GAAG,KAAK;QACR,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAY,EAAE,EAAU;IAC9C,OAAO,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,GAAG,sBAAsB,CAAC;AAE1C,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACvC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,WAAW,EAAE,CAAC;IAEhD,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAChD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAU,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,GAAW,EAAE,KAAY;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IAElC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACzB,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC;IAClC,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC;IACvE,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AAChC,CAAC"}

package/dist/lib/cards.d.ts

@@ -0,0 +1,82 @@
+export interface CardEvent {
+    at: string;
+    actor: string;
+    human: boolean;
+    action: string;
+    stage?: string;
+    note?: string;
+    /** On an approval: what the stage's output and check were when it was given. */
+    fingerprint?: string;
+    /** Reserved for an approval recorded by an authenticated store. Local approvals have none. */
+    approvalId?: string;
+    /** On agent-start and agent-run: the configured agent, its exit code (null when killed), and where its output went. */
+    agent?: string;
+    exit?: number | null;
+    durationMs?: number;
+    log?: string;
+}
+export interface Card {
+    id: string;
+    title: string;
+    lane: string;
+    laneVersion: number;
+    stage: string;
+    /** Folder key when another card already has this number (CL-001 and c-001): the lowercased id. */
+    key?: string;
+    spec?: string;
+    /** On a proposal: what was seen and where, for the owner deciding whether to promote it. */
+    description?: string;
+    source?: string;
+    /** Names what a proposal was made from, so the same finding is never proposed twice. */
+    dedupe?: string;
+    gate?: string;
+    awaiting?: string;
+    retries: Record<string, number>;
+    /** Per stage: fingerprint of the work at its last failed check, so an unattended run can tell nothing changed. */
+    failures?: Record<string, string>;
+    evidence: string[];
+    events: CardEvent[];
+    createdAt: string;
+    updatedAt: string;
+}
+export interface CardFile {
+    version: number;
+    cards: Card[];
+}
+export declare const CARDS_PATH = ".codeloop/cards.json";
+export declare const DONE = "done";
+/** A card someone proposed and the owner has not promoted. It waits at gate `proposal` and holds no place in its lane. */
+export declare const PROPOSED = "proposed";
+export declare const PROPOSAL_GATE = "proposal";
+/** A proposal the owner turned down. */
+export declare const DROPPED = "dropped";
+/** In its lane and not finished. A proposal, promoted or not yet, is neither started nor counted until the owner promotes it. */
+export declare const inLane: (card: {
+    stage: string;
+}) => boolean;
+/** A check, gate or permission said no. The CLI maps this to exit code 2. */
+export declare class RefusalError extends Error {
+    constructor(message: string);
+}
+/** The name a card's spec, use-case and evidence folders are keyed by: its number, unless that number is shared. */
+export declare function cardKey(card: {
+    id: string;
+    key?: string;
+}): string;
+/** `findCard`, but undefined when no card has that id or number. An ambiguous number still throws. */
+export declare function findCardOrNone(cards: Card[], ref: string): Card | undefined;
+export declare const CARD_ID: RegExp;
+/** For anything that becomes a file or folder name: one path component, nothing that climbs out. */
+export declare function safeName(value: string, what: string): string;
+/** Accepts the full id in any case, or its number alone: `1`, `001`, `c-001` and `CL-001` can all name one card. */
+export declare function findCard(cards: Card[], ref: string): Card;
+export declare class ConflictError extends Error {
+    constructor(message: string);
+}
+export declare function readCards(projectDir: string): CardFile;
+/**
+ * Compare-and-swap: `read` is the file as the caller read it. The write is refused when the
+ * version on disk has moved, so two agents working from the same read cannot both land.
+ */
+export declare function writeCards(projectDir: string, read: CardFile, cards: Card[]): CardFile;
+export declare function nextCardId(cards: Card[]): string;

package/dist/lib/cards.js

@@ -0,0 +1,107 @@
+import { existsSync, readFileSync, renameSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { CloudConflictError, writeCloudBoard } from './cloud.js';
+import { withLock } from './lock.js';
+export const CARDS_PATH = '.codeloop/cards.json';
+export const DONE = 'done';
+/** A card someone proposed and the owner has not promoted. It waits at gate `proposal` and holds no place in its lane. */
+export const PROPOSED = 'proposed';
+export const PROPOSAL_GATE = 'proposal';
+/** A proposal the owner turned down. */
+export const DROPPED = 'dropped';
+/** In its lane and not finished. A proposal, promoted or not yet, is neither started nor counted until the owner promotes it. */
+export const inLane = (card) => card.stage !== DONE && card.stage !== PROPOSED && card.stage !== DROPPED;
+/** A check, gate or permission said no. The CLI maps this to exit code 2. */
+export class RefusalError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'RefusalError';
+    }
+}
+/** The name a card's spec, use-case and evidence folders are keyed by: its number, unless that number is shared. */
+export function cardKey(card) {
+    return card.key ?? card.id.replace(/\D/g, '').padStart(3, '0');
+}
+/** `findCard`, but undefined when no card has that id or number. An ambiguous number still throws. */
+export function findCardOrNone(cards, ref) {
+    try {
+        return findCard(cards, ref);
+    }
+    catch (e) {
+        if (e instanceof RefusalError && e.message.includes('not found'))
+            return undefined;
+        throw e;
+    }
+}
+export const CARD_ID = /^[A-Za-z]{1,10}-\d{1,6}$/;
+/** For anything that becomes a file or folder name: one path component, nothing that climbs out. */
+export function safeName(value, what) {
+    if (typeof value !== 'string' || !/^[A-Za-z0-9][A-Za-z0-9._-]*$/.test(value) || value.includes('..')) {
+        throw new RefusalError(`${what} "${value}" is not a plain name (letters, digits, dot, dash, underscore)`);
+    }
+    return value;
+}
+/** Accepts the full id in any case, or its number alone: `1`, `001`, `c-001` and `CL-001` can all name one card. */
+export function findCard(cards, ref) {
+    const exact = cards.find(c => c.id === ref) ?? cards.find(c => c.id.toLowerCase() === ref.toLowerCase());
+    if (exact)
+        return exact;
+    const digits = ref.replace(/\D/g, '');
+    const matches = digits ? cards.filter(c => parseInt(c.id.replace(/\D/g, '') || '-1', 10) === parseInt(digits, 10)) : [];
+    // A prefixed ref (c-1) must agree with the card's prefix; a bare number matches any prefix.
+    const prefix = ref.replace(/[\d-]+$/, '').toLowerCase();
+    const fits = prefix ? matches.filter(c => c.id.replace(/[\d-]+$/, '').toLowerCase() === prefix) : matches;
+    if (fits.length === 1)
+        return fits[0];
+    if (fits.length > 1)
+        throw new RefusalError(`"${ref}" matches ${fits.map(c => c.id).join(', ')}; use the full id`);
+    throw new RefusalError(`card "${ref}" not found`);
+}
+export class ConflictError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ConflictError';
+    }
+}
+export function readCards(projectDir) {
+    const file = join(projectDir, CARDS_PATH);
+    if (!existsSync(file))
+        return { version: 0, cards: [] };
+    return JSON.parse(readFileSync(file, 'utf-8'));
+}
+/**
+ * Compare-and-swap: `read` is the file as the caller read it. The write is refused when the
+ * version on disk has moved, so two agents working from the same read cannot both land.
+ */
+export function writeCards(projectDir, read, cards) {
+    const file = join(projectDir, CARDS_PATH);
+    // The lock covers the re-read, the version check and the rename as one step. A connected cloud
+    // store is written inside it too, so its revision record cannot be interleaved either.
+    return withLock(file, () => {
+        const current = readCards(projectDir);
+        if (current.version !== read.version) {
+            throw new ConflictError(`cards.json changed since it was read (read version ${read.version}, now ${current.version}); re-read and retry`);
+        }
+        const next = { version: read.version + 1, cards };
+        const content = JSON.stringify(next, null, 2) + '\n';
+        // The cloud is written first, so a board that moved on elsewhere refuses this write before
+        // the local file changes.
+        try {
+            writeCloudBoard(projectDir, content);
+        }
+        catch (e) {
+            if (e instanceof CloudConflictError)
+                throw new ConflictError(`the cloud board changed since this checkout last saw it (${e.message}); run \`codeloop cloud pull\` and retry`);
+            throw e;
+        }
+        const tmp = `${file}.${process.pid}.tmp`;
+        writeFileSync(tmp, content);
+        renameSync(tmp, file);
+        return next;
+    });
+}
+export function nextCardId(cards) {
+    const max = cards.reduce((m, c) => Math.max(m, parseInt(c.id.replace(/\D/g, '') || '0', 10)), 0);
+    return `c-${String(max + 1).padStart(3, '0')}`;
+}
+//# sourceMappingURL=cards.js.map

package/dist/lib/cards.js.map

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

package/dist/lib/clock.d.ts

@@ -0,0 +1,5 @@
+/**
+ * The current time. CODELOOP_NOW replaces it, so a test or a demonstration can place a command on
+ * a chosen day and have every event it writes carry that time. `run --now` does the same for one run.
+ */
+export declare function clock(): Date;

package/dist/lib/clock.js

@@ -0,0 +1,14 @@
+/**
+ * The current time. CODELOOP_NOW replaces it, so a test or a demonstration can place a command on
+ * a chosen day and have every event it writes carry that time. `run --now` does the same for one run.
+ */
+export function clock() {
+    const set = process.env.CODELOOP_NOW;
+    if (!set)
+        return new Date();
+    const at = new Date(set);
+    if (Number.isNaN(at.getTime()))
+        throw new Error(`CODELOOP_NOW "${set}" is not a date`);
+    return at;
+}
+//# sourceMappingURL=clock.js.map

package/dist/lib/clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"clock.js","sourceRoot":"","sources":["../../src/lib/clock.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,KAAK;IACnB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACrC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,IAAI,EAAE,CAAC;IAC5B,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,iBAAiB,GAAG,iBAAiB,CAAC,CAAC;IACvF,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/dist/lib/cloud.d.ts

@@ -0,0 +1,122 @@
+export declare const CLOUD_FILE = ".codeloop/cloud.json";
+export declare const SYNC_FILE = ".codeloop/state/sync.json";
+/** A wiki page changed on both sides: the cloud version is written beside the local one under this suffix. */
+export declare const CLOUD_COPY = ".cloud.md";
+export type DocKind = 'board' | 'config' | 'lane' | 'wiki';
+export type DocState = 'in-sync' | 'local-ahead' | 'cloud-ahead' | 'both-changed';
+export interface SyncEntry {
+    kind: DocKind;
+    /** Empty until the first write reaches the cloud. */
+    pageId: string;
+    /** The page revision this checkout last saw. Every write to the page expects it. */
+    revision: number;
+    /** sha256 of the local file when it last matched the page at `revision`; null when it never has. */
+    hash: string | null;
+    /** A write that was kept locally because the cloud could not be reached. Pushed first by the next command. */
+    pending?: boolean;
+    /** Local and cloud differed when they first met and neither has been taken. */
+    diverged?: boolean;
+}
+export interface SyncFile {
+    /** Keyed by the path under .codeloop: cards.json, config.yaml, lanes/<lane>.yaml, wiki/<folder>/<page>.md. */
+    documents: Record<string, SyncEntry>;
+}
+export interface CloudConfig {
+    url: string;
+    key: string;
+    workspaceName?: string;
+    boardTitle: string;
+    /** Root folder in the workspace. Lanes go in `<folder>/<folder>-lanes`, wiki pages in `<folder>/<folder>-wiki`. */
+    folder?: string;
+}
+export declare class CloudError extends Error {
+}
+/** The page moved on since this project last saw it: someone else wrote first. */
+export declare class CloudConflictError extends CloudError {
+}
+export declare function loadCloud(projectDir: string): CloudConfig | null;
+export declare function loadSync(projectDir: string): SyncFile;
+type Call = {
+    name: string;
+    args: Record<string, unknown>;
+};
+/** Runs tool calls in order and returns each one's `data`. Throws CloudConflictError on VERSION_CONFLICT. */
+export declare function callTools(conn: {
+    url: string;
+    key: string;
+}, calls: Call[], timeoutMs?: number): any[];
+export interface ConnectResult {
+    adopted: boolean;
+    revision: number;
+    wikiPages: number;
+    /** Documents that differ from a page already in the workspace, one line each. */
+    notes: string[];
+}
+/**
+ * A board page that already exists under the same title is adopted as it is, never overwritten:
+ * another checkout may have written it. `cloud pull` takes it, `cloud push --force` replaces it.
+ * Config, lanes and wiki pages that are not in the workspace yet are uploaded.
+ */
+export declare function connect(projectDir: string, input: {
+    url: string;
+    key: string;
+    workspaceName?: string;
+    boardTitle?: string;
+    folder?: string;
+}): ConnectResult;
+/**
+ * Called by every card write before the local file changes. A stale revision throws
+ * CloudConflictError and the caller leaves the local file alone. If the cloud cannot be reached
+ * the write stays local and is marked pending in sync.json.
+ */
+export declare function writeCloudBoard(projectDir: string, content: string): void;
+export declare function writeCloudWikiPage(projectDir: string, path: string): void;
+/** Called by `lane promote` and `lane rollback` before the lane file is replaced: the only way a lane edit reaches the cloud. */
+export declare function writeCloudLane(projectDir: string, laneId: string, content: string): void;
+/**
+ * Run before a command: pending writes are pushed, files nobody edited here are updated from the
+ * cloud, and wiki pages and config edited here are pushed. Returns what it did, one line each.
+ * With the cloud unreachable the command still runs on the local files.
+ */
+export declare function syncBefore(projectDir: string): string[];
+export declare function push(projectDir: string, opts?: {
+    force?: boolean;
+}): {
+    revision: number;
+    wikiPages: number;
+    held: string[];
+};
+export declare function pull(projectDir: string, opts?: {
+    force?: boolean;
+}): {
+    revision: number;
+    wikiPages: number;
+    notes: string[];
+};
+export declare function status(projectDir: string): {
+    url: string;
+    workspaceName: string | undefined;
+    boardTitle: string;
+    pageRevision: number;
+    lastSeenRevision: number;
+    localVersion: number;
+    cards: number;
+    inSync: boolean;
+    wikiPages: number;
+    documents: {
+        pending?: boolean | undefined;
+        path: string;
+        kind: DocKind;
+        state: DocState;
+    }[];
+};
+/** Pushes what is pending, brings every document back into the repo files, then forgets the connection. */
+export declare function disconnect(projectDir: string): {
+    revision: number;
+    wikiPages: number;
+};
+export declare function search(projectDir: string, query: string, limit?: number): {
+    title: string;
+    id: string;
+}[];
+export {};