@fractalsynapse/dsh-chapters 0.0.0-stage → 0.2.21

package/lib/store.js

@@ -0,0 +1,368 @@
+/**
+ * The storage-domain adapter: zod schemas, the durable spec, and the ports
+ * that connect the pure registry (registry.ts) and pure archive writer
+ * (archive.ts) to host persistence and the filesystem. This is glue next to
+ * `src/index.ts` — thin by policy; every decision lives in the pure layer.
+ *
+ * Keying: one record per SESSION id (`sessions` table), because chapters are
+ * keyed by creating session, not a linear chain id — siblings branching from
+ * one ancestor cannot collide, and the flat TOC is built by walking links
+ * (registry.ancestorPath), never by a directory scan.
+ *
+ * Concurrency, honestly: read-modify-write per key. Same-session archive
+ * flows are serialized by their own reserve-before-write ordering, and a
+ * session has exactly one write handle (the kernel refuses a second, measured
+ * r3). Cross-process same-key writes are last-writer-wins on the JSON
+ * backend — acceptable for MVP, worth revisiting before multi-host chains.
+ */
+import { z } from 'zod';
+import { ruleRecordSchema } from "./rules.js";
+import { defineDomain, domainTable } from '@deepseek-ai/dsh-storage-domain';
+import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { dirname, isAbsolute } from 'node:path';
+import { appendChapters, freshSession, releaseReservation, reserve, reservePlan as reservePlanNumber } from "./registry.js";
+// ---------------------------------------------------------------- schemas + spec
+const chapterRecordSchema = z.object({
+    number: z.number().int().positive(),
+    path: z.string().min(1),
+    title: z.string(),
+    summary: z.string(),
+    startSeq: z.number().int().nonnegative(),
+    endSeq: z.number().int().nonnegative(),
+    topics: z.array(z.string()).default([]),
+    messages: z.number().int().nonnegative().optional(),
+    shadowedSeqs: z.array(z.number().int().nonnegative()).optional(),
+    sha256: z.string().min(16),
+    /** P2 §2.4 provenance chains, newest-first per field (absent = everything
+     * still deterministic; enrichment only ever grows these). */
+    generated: z.record(z.string(), z.array(z.object({
+        by: z.string(), model: z.string().optional(), at: z.string().optional(),
+    }))).optional(),
+    estimatedTokens: z.number().int().nonnegative(),
+    artifacts: z.array(z.object({
+        path: z.string().min(1),
+        sha256: z.string().min(16),
+        bytes: z.number().int().nonnegative(),
+    })),
+    // Plans this chapter carries (docs/plans-carriage.md § 2). Optional: a stored row
+    // from before the feature simply has no field, which reads as "no plans here".
+    plans: z.array(z.object({
+        seq: z.number().int().nonnegative(),
+        status: z.enum(['approved', 'rejected', 'dismissed', 'pending', 'superseded', 'failed']),
+        title: z.string(),
+        sha256: z.string().min(16),
+        artifactPath: z.string().min(1),
+        bytes: z.number().int().nonnegative(),
+        estTokens: z.number().int().nonnegative(),
+        resultSeq: z.number().int().nonnegative().nullable(),
+    })).optional(),
+    planMode: z.enum(['active', 'inactive', 'unknown']).optional(),
+    // Where each plan's own `kind: plan` document landed.
+    planDocs: z.array(z.object({
+        seq: z.number().int().nonnegative(),
+        path: z.string().min(1),
+        sha256: z.string().min(16),
+    })).optional(),
+    // Tombstone status (#60 supersede, #255 operator removal) and its bookkeeping. Optional so rows
+    // written before these fields parse unchanged — and WITHOUT them here, zod STRIPS them on parse:
+    // the removed-stub round-trip test in registry.test.ts is the guard that the watermark-carrying
+    // fields survive every schema seam (repair's `repairs:` provenance rode the same hole).
+    status: z.enum(['superseded', 'removed']).optional(),
+    supersededBy: z.number().int().positive().optional(),
+    removedAt: z.string().min(10).optional(),
+    repairs: z.array(z.object({ class: z.string(), over: z.number().int(), at: z.number().int() })).optional(),
+});
+const collectionSchema = z.object({
+    seqs: z.array(z.number().int().nonnegative()).min(1),
+    paths: z.array(z.string()),
+    commands: z.array(z.string()),
+    terms: z.array(z.string()),
+    size: z.number().int().nonnegative(),
+    by: z.literal('deterministic'),
+});
+const sessionStateSchema = z.object({
+    rev: z.number().int().nonnegative().default(0),
+    parentSession: z.string().nullable(),
+    rootSession: z.string().min(1),
+    nextChapterNumber: z.number().int().positive(),
+    // Plan-document numbering (plans-carriage § 11). Optional with a default so a
+    // stored row from before the feature parses unchanged.
+    nextPlanNumber: z.number().int().positive().default(1),
+    chapters: z.array(chapterRecordSchema),
+    reservations: z.record(z.string(), z.array(z.number().int().positive())).default({}),
+    // #113: the Suggested Next Step bar's durable facts. Optional-with-default (the `nextPlanNumber`
+    // precedent) so a stored row from before the feature parses unchanged and no chapter bytes move.
+    promptSuggestion: z.object({
+        status: z.enum(['off', 'analyzing', 'ready', 'failed']),
+        text: z.string(),
+        turnSeq: z.number().int().nullable(),
+        error: z.string(),
+        at: z.string(),
+        intent: z.enum(['worker-step', 'goal-edit']).default('worker-step'),
+        goalRevision: z.number().int().nullable().default(null),
+    }).default({ status: 'off', text: '', turnSeq: null, error: '', at: '', intent: 'worker-step', goalRevision: null }),
+    plans: z.record(z.string(), z.object({
+        number: z.number().int().positive(),
+        path: z.string().min(1),
+        title: z.string(),
+        summary: z.string(),
+        chapters: z.array(z.object({
+            number: z.number().int().positive(),
+            path: z.string().min(1),
+            title: z.string(),
+            summary: z.string(),
+            startSeq: z.number().int().nonnegative(),
+            endSeq: z.number().int().nonnegative(),
+        })).optional(),
+    })).default({}),
+    finalized: z.record(z.string(), z.array(z.number().int().positive())).default({}),
+    collections: z.array(collectionSchema).default([]),
+});
+/** Parse (and backfill defaults for) one raw registry record — the seam
+ * migrations and tests use; the domain open path uses the same schema. */
+export const parseSessionState = (raw) => sessionStateSchema.parse(raw);
+const projectRecordSchema = z.object({
+    projectKey: z.string().min(1),
+    slug: z.string(),
+    remote: z.string().min(1),
+    harnessId: z.string().min(1),
+    linkedAt: z.string(),
+    cwd: z.string(),
+    /** Transport kind (§15 amendment); absent on stored rows = 'git'. */
+    kind: z.enum(['git', 'treedx']).default('git'),
+    /** TreeDX: server-assigned repository id, resolved at link time. */
+    repoId: z.string().optional(),
+});
+/** Parse (and default-fill) one stored project row — the migration seam tests
+ * and any future provider-kind backfill use; same shape as parseSessionState. */
+export const parseProjectRecord = (raw) => projectRecordSchema.parse(raw);
+/** Durable declaration of the dsh_chapters registry domain. */ export const chapterDomainSpec = defineDomain({
+    name: 'dsh_chapters',
+    // v1: + settings table (enrichment model overrides, P2). Existing v0 media
+    // load under compatibleVersions; absent tables materialize empty.
+    // v2: + rules table (P3 §7.1 records; status rides per-machine curation facts,
+    // never this table).
+    // v3: + projects.kind / projects.repoId (§15 amendment: transport is
+    // pluggable). Stored v2 rows parse with kind defaulting to 'git' — old data
+    // keeps working with zero migration, and the git path is untouched.
+    version: 3,
+    compatibleVersions: [0, 1, 2],
+    tables: {
+        sessions: domainTable(sessionStateSchema),
+        projects: domainTable(projectRecordSchema),
+        settings: domainTable(z.object({ value: z.string() })),
+        rules: domainTable(ruleRecordSchema),
+    },
+});
+export function makeDomainStore(domain) {
+    const table = domain.table('sessions');
+    const projects = domain.table('projects');
+    const settings = domain.table('settings');
+    const rules = domain.table('rules');
+    // One serialized section per session (#59). The row is a single whole value and five doors plus the
+    // turn/end signature listener write it; the wide sites hold a read across a model call or hundreds
+    // of filesystem writes, and an unguarded whole-row put then silently ERASES whatever another door
+    // committed in between (measured in the field: a compaction's manifest, reservation, `finalized`
+    // entry and chapter record all vanished while its 960 KB file stayed on disk, and the chapter number
+    // was re-spent). Serialization plus a rev check turns that into a refusal with numbers.
+    const sections = new Map();
+    const inside = new Set();
+    const runExclusive = async (sessionId, job) => {
+        if (inside.has(sessionId)) {
+            // Nested sections would deadlock (the inner waits on the outer's gate). Refusing is honest and
+            // cheap; a caller that needs to compose two mutations does it inside ONE fn.
+            throw new Error(`mutate: re-entered the registry section for ${sessionId} — compose the mutations in one fn`);
+        }
+        const prev = sections.get(sessionId) ?? Promise.resolve();
+        let release;
+        const gate = new Promise((r) => { release = r; });
+        // Chain: this session's next waiter must also wait for OUR completion, not just our predecessor.
+        const mine = prev.then(() => gate);
+        sections.set(sessionId, mine);
+        await prev.catch(() => undefined);
+        inside.add(sessionId);
+        try {
+            return await job();
+        }
+        finally {
+            inside.delete(sessionId);
+            release();
+            if (sections.get(sessionId) === mine)
+                sections.delete(sessionId);
+        }
+    };
+    const readRow = (sessionId) => table.get(sessionId) ?? freshSession(sessionId);
+    /** Bump the write counter and store. Only ever called from INSIDE a section. */
+    const writeInside = async (sessionId, state, currentRev) => {
+        await table.put(sessionId, { ...state, rev: currentRev + 1 });
+    };
+    return {
+        async get(sessionId) {
+            return readRow(sessionId);
+        },
+        async put(sessionId, state, expectedRev) {
+            return runExclusive(sessionId, async () => {
+                const current = readRow(sessionId);
+                if (expectedRev !== undefined && (current.rev ?? 0) !== expectedRev) {
+                    throw new Error(`registry put refused: session ${sessionId} moved under this write (expected rev ${expectedRev}, `
+                        + `found ${current.rev ?? 0}). Another door committed since the read — re-read and re-apply, `
+                        + 'do not clobber it (store.mutate).');
+                }
+                await writeInside(sessionId, state, current.rev ?? 0);
+            });
+        },
+        async mutate(sessionId, fn) {
+            return runExclusive(sessionId, async () => {
+                const before = readRow(sessionId);
+                const draft = structuredClone(before);
+                const next = await fn(draft);
+                // Returning the very object handed in means "no change" — the same idiom commitChapters used
+                // (`if (next !== state)`) so an idempotent retry costs no write and no rev bump.
+                if (next === draft)
+                    return before;
+                await writeInside(sessionId, next, before.rev ?? 0);
+                return next;
+            });
+        },
+        projects() {
+            return projects.entries();
+        },
+        sessions() {
+            return table.entries();
+        },
+        getSetting(key) {
+            return settings.get(key)?.value;
+        },
+        async putSetting(key, value) {
+            await settings.put(key, { value });
+        },
+        async deleteSetting(key) {
+            const del = settings.delete;
+            if (typeof del !== 'function') {
+                throw new Error('settings table lacks delete — cannot restore the config default (host too old)');
+            }
+            await del.call(settings, key);
+        },
+        rules() {
+            return rules.entries();
+        },
+        getRule(id) {
+            return rules.get(id);
+        },
+        async putRule(id, value) {
+            await rules.put(id, value);
+        },
+    };
+}
+/**
+ * The NumberAllocator archive.ts asks for, bound to one author session.
+ * Reserve-before-write per docs/architecture.md § Atomicity; retries reuse
+ * numbers through registry.reserve's attempt-keyed idempotence.
+ */
+export function makeAllocator(store, sessionId) {
+    return {
+        // Allocation is the operation that MUST NOT interleave: two doors that both read
+        // `nextChapterNumber: 15` write two different `015-*.md` files into one tree, which is the exact
+        // damage #59 measured. `mutate` makes read-allocate-write one section, so the number a door is
+        // handed is already durable by the time the call returns.
+        async reserve(attemptId, count) {
+            let numbers = [];
+            await store.mutate(sessionId, (state) => {
+                const next = reserve(state, attemptId, count);
+                numbers = next.numbers;
+                return next.state;
+            });
+            return numbers;
+        },
+        async reservePlan(attemptId, count) {
+            let numbers = [];
+            await store.mutate(sessionId, (state) => {
+                const next = reservePlanNumber(state, attemptId, count);
+                numbers = next.numbers;
+                return next.state;
+            });
+            return numbers;
+        },
+        async release(attemptId) {
+            await store.mutate(sessionId, (state) => releaseReservation(state, attemptId));
+        },
+    };
+}
+/** The commit-point write: verified chapter records into the session state. */
+export async function commitChapters(store, sessionId, records) {
+    // One section, fresh read inside it (#59): the old get→append→put held the snapshot across an
+    // await, which is how another door's committed state got erased.
+    await store.mutate(sessionId, (state) => appendChapters(state, records));
+}
+export async function acquireChapterStore(storageDomain) {
+    try {
+        const domain = await storageDomain.open(chapterDomainSpec);
+        return { store: makeDomainStore(domain), domain, owner: true };
+    }
+    catch (error) {
+        if (!/already[- ]open/i.test(String(error?.message ?? error)))
+            throw error;
+        const existing = storageDomain.get?.(chapterDomainSpec.name);
+        if (existing === undefined)
+            throw error;
+        return { store: makeDomainStore(existing), domain: existing, owner: false };
+    }
+}
+// ---------------------------------------------------------------- filesystem port
+const join = (...parts) => parts.filter(Boolean).join('/').replace(/\/{2,}/g, '/');
+/**
+ * ArchiveFs over node:fs, anchored at one base dir (the session workspace).
+ * Plugins are trusted same-process code — the sandbox governs TOOLS, not
+ * this path — so node:fs is legitimate here; `ctx.fs` stays untouched.
+ * `read` maps ENOENT to undefined; anything else propagates: a permission
+ * error must not look like a missing file.
+ */
+/** Resolve a configured store root against the session cwd. An ABSOLUTE root
+ * wins verbatim — the hosted profiles (#33) pin `/workspace/.dsh-chapters` so
+ * archives land on a persisted volume no matter which subdirectory a session
+ * runs in; relative roots keep the historical per-workspace meaning. */
+export function resolveStoreRoot(cwd, storeRoot) {
+    return isAbsolute(storeRoot) ? storeRoot : join(cwd, storeRoot);
+}
+export function makeArchiveFs(baseDir) {
+    // absolute paths pass through (resolveStoreRoot may hand writeArchive an
+    // absolute storeRoot); relative ones stay workspace-rooted as always.
+    const abs = (p) => (isAbsolute(p) ? p : join(baseDir, p));
+    return {
+        async write(p, content) {
+            const target = abs(p);
+            await mkdir(dirname(target), { recursive: true });
+            await writeFile(target, content, 'utf8');
+        },
+        async read(p) {
+            try {
+                return await readFile(abs(p), 'utf8');
+            }
+            catch (error) {
+                if (error.code === 'ENOENT')
+                    return undefined;
+                throw error;
+            }
+        },
+        async exists(p) {
+            return (await this.read(p)) !== undefined;
+        },
+    };
+}
+/**
+ * "Add <store-root>/ to .gitignore on first write and say so" — silently
+ * polluting a user's tree is its own small bug (docs/architecture.md §
+ * Storage). Returns a human line for the tool result's warnings.
+ */
+export async function ensureStoreGitignore(fs, storeRoot) {
+    const current = await fs.read('.gitignore');
+    const entry = `${storeRoot.replace(/\/+$/, '')}/`;
+    if (current !== undefined && current.split('\n').some((line) => line.trim() === entry)) {
+        return `${entry} already in .gitignore`;
+    }
+    const updated = (current ?? '') + (current !== undefined && !current.endsWith('\n') ? '\n' : '') +
+        `\n# dsh-chapters archive (verbatim chapter store; see README)\n${entry}\n`;
+    await fs.write('.gitignore', updated);
+    return `added ${entry} to .gitignore — say so: the plugin wrote into the repo root`;
+}
+//# sourceMappingURL=store.js.map

package/lib/store.js.map

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

package/lib/sync.d.ts

@@ -0,0 +1,220 @@
+import { type ProviderKind, type SyncProvider } from './provider.ts';
+import { type VocabOpts } from './vocabulary.ts';
+/** A linked knowledge project (record §2.1, §8): one record per linked
+ * workspace cwd; deepest-cwd match resolves the active project. */
+export interface ProjectRecord {
+    projectKey: string;
+    slug: string;
+    remote: string;
+    harnessId: string;
+    linkedAt: string;
+    /** Workspace cwd this record was linked from (deepest-prefix match, record §8). */
+    cwd: string;
+    /** Transport kind (§15 amendment); absent = 'git' (pre-provider records). */
+    kind?: ProviderKind;
+    /** TreeDX: the server-assigned repository id (resolved at link time). */
+    repoId?: string | undefined;
+}
+export interface SyncResult {
+    ok: boolean;
+    /** What actually happened, for the status command and tests. */
+    steps: string[];
+    detail: string;
+    /** 'synced' only when the remote accepted the push; 'local-only' when the
+     * mirror is current but the remote did not take it (record §5.3). */
+    mode: 'synced' | 'local-only';
+}
+/**
+ * Per-project credentials — stored under the DSH HOME, never the workspace
+ * (user directive 2026-09-18: the project tree is the agent's reading room;
+ * the plugin is the only accessor). 0600 file per projectKey. Note honestly:
+ * same-uid files are a hygiene boundary, not a cryptographic one — the real
+ * guarantee is that the plugin never echoes the token anywhere an agent sees.
+ */
+export declare const tokenPath: (projectKey: string) => string;
+export declare function readToken(cwd: string, storeRoot: string, projectKey: string): string | undefined;
+export declare function writeToken(projectKey: string, token: string): void;
+export interface SyncOpts {
+    /** Workspace root — the store and the mirror both live under it. */
+    cwd: string;
+    /** Store root relative to cwd (`.dsh-chapters`). */
+    storeRoot: string;
+    /** Mirror directory relative to cwd (`.dsh-knowledge`). */
+    cloneDir: string;
+    project: ProjectRecord;
+    /** Per-harness token for this project (record §2.1); undefined for file remotes. */
+    token?: string;
+    /** Collection files to (re)publish: one JSONL file per session's signatures. */
+    collections?: {
+        sessionId: string;
+        lines: string[];
+    }[];
+    /** P2 §6.3 vocabulary pass over the mirror's chapters (undefined = off). */
+    vocab?: VocabPassOpts;
+    /** Force a run even when the lock is held (tests). Default false. */
+    force?: boolean;
+    /** Transport provider (tests inject a fake; default resolves from the
+     * project record's kind via src/provider.ts — 'git' when absent). */
+    provider?: SyncProvider;
+    /** #255: names the operator removed from THIS project's store. Rehydration skips them;
+     * the count lands in the steps. Absent ⇒ guard inert (the pre-#255 behavior). */
+    removed?: RemovedGuard;
+}
+/**
+ * Deepest-cwd match (record §8): the active knowledge project for a
+ * workspace path. Shared by the notice line, the scheduler, and the commands.
+ */
+export declare function projectForCwd(records: Iterable<[string, ProjectRecord]>, cwd: string): ProjectRecord | undefined;
+/** The mirror directory, relative to the workspace (record §3.1). */
+export declare const DEFAULT_CLONE_DIR = ".dsh-knowledge";
+/**
+ * File lock around store transactions and clone ops (§5.2): the host-plane
+ * plugin and the realm engine may be different module instances in the same
+ * process, so an in-process mutex is not safe — a file is the honest lock.
+ * Stale locks (>10 min) are stolen; live ones make runSync skip, not block.
+ */
+export declare function syncLockPath(storeDir: string): string;
+/**
+ * Map workspace-store files to repo paths (record §2.2):
+ *   <storeRoot>/<rootSession>/chapters/x.md  → chapters/<projectKey>/<rootSession>/x.md
+ *   <storeRoot>/<rootSession>/artifacts/ab/ab….txt → artifacts/<projectKey>/ab/ab….txt
+ * Artifacts are content-addressed and shared across sessions, so their
+ * per-session prefix is dropped; chapters keep it.
+ */
+export declare function planStoreToRepo(storeDir: string, projectKey: string): {
+    abs: string;
+    rel: string;
+}[];
+export declare const statusFilePath: (cwd: string, storeRoot: string) => string;
+/**
+ * Build the Layer-2 index inside the clone (record §10.2): entries from every
+ * chapter/rule file (frontmatter), curation facts from every harness's
+ * curation.jsonl, the manifest from the clone's index/manifest.json. Returns
+ * true when shards or the manifest changed (the commit step then ships them).
+ * Deterministic: the index is a pure function of the clone's corpus, so any
+ * machine can rebuild it identically (the recovery path, record §10.2).
+ */
+export declare function buildIndexInClone(cloneDir: string): boolean;
+export interface VocabPassOpts extends VocabOpts {
+    /** write applied aliases? false (shadow) = report only — the default */
+    apply: boolean;
+}
+/**
+ * One sync pass (record §5): lock → ensure clone (offline init fallback) →
+ * publish → commit → pull → push. Failure semantics §5.3: EVERY remote-path
+ * failure (clone, pull, push) degrades to local-only mode — the mirror stays
+ * current for search and the status file says so with detail; only a local
+ * commit failure or lock loss returns without a current mirror. A diverged
+ * pull rebuilds the mirror from the remote (safe: the mirror is transport,
+ * the store is truth, §3.1). ok=true means the remote accepted the push.
+ */
+/**
+ * Store rehydration (0.1.5 — treeseed workspace-wipe incident, 2026-10-08):
+ * the pool is not only a downstream copy. When a workspace store loses files
+ * (accidental rm of dot-dirs, cleanup, fresh checkout) the registry rows and
+ * continuation TOCs still cite the store paths — `read` dangles silently.
+ * The freshly cloned/pulled mirror is usually the ONLY surviving copy of
+ * those exact bytes, so every sync restores before it publishes:
+ *   mirror chapters/<projectKey>/<session>/<file>.md → <storeRoot>/<session>/chapters/<file>
+ *   mirror artifacts/<projectKey>/<path>             → <storeRoot>/artifacts/<path>
+ * Only ABSENT files are filled (the store stays ground truth for anything it
+ * still holds — rehydration fills gaps, it never arbitrates drift); other
+ * projects' prefixes are out of scope; counts land in the sync steps so the
+ * recovery is never silent.
+ *
+ * #255: an operator REMOVAL deletes the store file with intent. Without a guard, the next pass
+ * would copy the still-present mirror file straight back over the operator's decision — the
+ * deletion resurrecting itself between unlink and push. `removed` names those files (session#file
+ * for chapters and plan docs, blob basename for artifacts) and rehydration skips them, counting
+ * every skip so the pass says what it refused.
+ */
+export interface RemovedGuard {
+    /** `<sessionDir>#<file>` — the mirror walk's identity for a chapter or plan document. */
+    chapterKeys: ReadonlySet<string>;
+    /** Artifact basenames (`<sha>.txt`) — content-addressed, unique by construction. */
+    blobKeys: ReadonlySet<string>;
+}
+export declare function rehydrateStoreFromMirror(cloneDir: string, storeDir: string, projectKey: string, removed?: RemovedGuard): {
+    restored: number;
+    skippedRemoved: number;
+};
+export declare function runSync(opts: SyncOpts): Promise<SyncResult>;
+/**
+ * Pull-only pass for the pre-fork refresh point (record §5.1): ensure the
+ * mirror exists (clone, offline-init fallback) and ff-pull it. Never throws,
+ * never pushes, never commits — a read-side refresh.
+ */
+export declare function runPull(opts: Omit<SyncOpts, 'force'>): Promise<{
+    ok: boolean;
+    detail: string;
+}>;
+/**
+ * A workspace-scoped collections reader for the scheduler (§5): only session
+ * trees whose store directory lives in THIS workspace publish. Shared by the
+ * host plugin and the realm engine (the two schedulers are the same code over
+ * different module copies — the file lock keeps them honest).
+ */
+export declare function makeCollectionsReader(sessions: () => IterableIterator<[string, import('./registry.ts').SessionState]>, storeRoot: string): (cwd: string) => {
+    sessionId: string;
+    lines: string[];
+}[];
+/**
+ * The debounced scheduler (§5.2: "consecutive archive events within the
+ * configured window coalesce into one push"). Pure wiring — the plane that
+ * owns it (host plugin or realm engine) injects how to find the project, the
+ * token, and the collection files. Never throws; a failed pass lands in the
+ * status file like any other.
+ */
+export interface SyncSchedulerDeps {
+    storeRoot: string;
+    cloneDir?: string;
+    debounceMs: number;
+    resolveProject(cwd: string): ProjectRecord | undefined;
+    tokenFor(cwd: string, projectKey: string): string | undefined;
+    /** Collection JSONL lines per session, read from the registry (may be empty). */
+    collectionsFor(cwd: string): {
+        sessionId: string;
+        lines: string[];
+    }[];
+    /** #255: the removed-stub guard for this cwd's project, read from the registry rows.
+     * The planes that own a store handle supply it; a scheduler without one simply never
+     * guards, and the pass says so nowhere it cannot know. */
+    removedFor?(cwd: string): RemovedGuard | undefined;
+    /** P2 §6.3 vocabulary pass options for every scheduled pass (undefined = off). */
+    vocab?: VocabPassOpts;
+    /** Injectable timer (tests). Defaults to setTimeout/clearTimeout. */
+    setTimer?: (fn: () => void, ms: number) => {
+        cancel(): void;
+    };
+    provider?: SyncProvider;
+    /** P2: fired after a REAL sync pass completes (success or degraded) — the
+     * enrichment queue's natural idle point. Not fired for 'no project
+     * linked' early-outs (nothing was published, nothing to enrich). */
+    onSyncDone?: (cwd: string, ok: boolean) => void;
+}
+export interface SyncScheduler {
+    /** Debounced push after an archive event (compaction/fork). */
+    schedule(cwd: string, why: string): void;
+    /** Immediate pass (a link, an explicit sync). An explicit project wins
+     * over the cwd lookup — a re-link must sync the NEW record, not whichever
+     * record the cwd tie-break happens to pick. */
+    run(cwd: string, why: string, project?: ProjectRecord): Promise<SyncResult>;
+    /** Pre-fork refresh (§5.1): pull-only, bounded, never blocks long. */
+    pullFor(cwd: string): Promise<{
+        ok: boolean;
+        detail: string;
+    }>;
+    hasPending(cwd: string): boolean;
+    /** Await any in-flight/scheduled pass (tests + shutdown). */
+    drain(): Promise<void>;
+}
+export declare function createSyncScheduler(deps: SyncSchedulerDeps): SyncScheduler;
+/** Read the last sync status (for /chapters-status). Null when never run. */
+export declare function readSyncStatus(cwd: string, storeRoot: string): {
+    at: string;
+    projectKey: string;
+    lastOk: boolean;
+    mode?: string;
+    detail: string;
+    steps: string[];
+} | null;