@treeseed/dsh-chapters 0.1.0

package/lib/index.d.ts

@@ -0,0 +1,81 @@
+import Schema from '@deepseek-ai/schemastery';
+import { type SyncScheduler } from './sync.ts';
+/** The cordis surface this entry touches; widened in later stages. */
+interface HostCtx {
+    logger?: {
+        info?: (message: string) => void;
+        warn?: (message: string) => void;
+    };
+    get?: (name: string) => unknown;
+    effect?: (fn: () => void, label?: string) => void;
+    agents?: unknown;
+    tools?: {
+        register(def: unknown): () => void;
+    };
+    sessionProjections?: {
+        stateOf(session: unknown, key: string): unknown;
+    };
+    llm?: {
+        resolveModelInfo(provider: string, model: string, signal?: AbortSignal): Promise<{
+            context?: {
+                contextWindow?: number;
+            };
+        } | undefined>;
+        stream?: (opts: unknown) => AsyncIterable<unknown>;
+    };
+}
+export interface Config {
+    installChaptersPreset: boolean;
+    artifactStoreRoot: string;
+    chapterTokenTarget: number;
+    toolResultDeferFloorTokens: number;
+    continuationBudgetRatio: number;
+    fallbackPreset: string;
+    mergeThreshold: number;
+    chapterLimit: number;
+    harnessId: string;
+    /** §12: the project's knowledge repo URL ('' = rely on /chapters-link). */
+    knowledgeRemote: string;
+    /** §12: wins over the §2.3 derivation. */
+    projectKeyOverride: string;
+    /** §12: coalesce window for post-archive pushes. */
+    syncDebounceMs: number;
+    /** §12: default pack size for chapters_search. */
+    searchDefaultMaxTokens: number;
+    /** P2 §12: enrichment kill switch (auto triggers live on the realm plane;
+     * the host plane's queue is manual-only so nothing ever double-runs). */
+    enrichmentEnabled: boolean;
+    /** 'provider/model' or '' = conversation/stored route (record §6). */
+    enrichmentModel: string;
+    enrichmentIdleMs: number;
+    enrichmentBatchCap: number;
+    /** P2 §6.3 vocabulary pass (shadow by default). */
+    vocabApply: boolean;
+    vocabCoMin: number;
+    vocabOverlapMin: number;
+    /** P3 §7.3: budget for the notice's core-rules section (refuse, never clip). */
+    coreRulesBudgetTokens: number;
+    /** P3 §8: search bonus for effective-core rules (per-machine status). */
+    rulesCoreBonus: number;
+    /** §15 amendment: transport policy — 'auto' dispatches on the remote
+     * scheme (treedx+ → TreeDX, anything else → git); an explicit value must
+     * match the scheme or the link refuses (never a silent fallback). */
+    knowledgeProvider: 'auto' | 'git' | 'treedx';
+    /** TreeDX transport tunables (record §12 register: no hardcoded numbers). */
+    treedxFetchTimeoutMs: number;
+    treedxWorkspaceTtlSeconds: number;
+    treedxLeaseRetries: number;
+    treedxLeaseRetryDelayMs: number;
+}
+export declare const Config: Schema<Config>;
+export declare const name = "@treeseed/dsh-chapters";
+export declare const inject: string[];
+export declare function apply(ctx: HostCtx, config: Config): Promise<void>;
+/**
+ * The §5 sync loop for the host plane. Auto-link (when `knowledgeRemote` is
+ * configured) happens lazily inside resolveProject: a workspace's first
+ * archive event finds a project record, so nothing network-shaped runs
+ * before anything archives.
+ */
+export declare function createScheduler(store: import('./store.ts').RegistryStore, domain: import('./store.ts').DomainLike, config: Config, debounceOverride?: number, onSyncDone?: (cwd: string, ok: boolean) => void, warn?: (m: string) => void): SyncScheduler;
+export {};

package/lib/index.js

@@ -0,0 +1,305 @@
+/**
+ * dsh-chapters — cordis entry point (host plane). The ONLY host-facing function
+ * plugin; engine logic lives in engine.ts (mounted per preset realm), every
+ * decision in the pure modules (docs/development.md § L0).
+ *
+ * Responsibilities:
+ *  1. Install the `chapters` preset into `$DSH_HOME/.agent-presets/` on boot
+ *     (write-if-missing; user edits are never overwritten). Profile `!!js` has
+ *     no `require` (measured r20), so copying is the delivery mechanism.
+ *  2. Open the dsh_chapters storage domain and register chapters_segment /
+ *     chapters_continue (src/tools.ts adapts them to the pure core).
+ *  3. Witness/dev diagnostics.
+ *
+ * Protocol notes (each measured, docs/contract.md):
+ *  - function plugin: named exports `name` / `inject` / `Config` / `apply`;
+ *    NO default export (mixing forms makes the Loader discard the namespace).
+ *  - Config uses schemastery (default import) — plain specs are for tool
+ *    parameters, zod for domain records; never mix.
+ */
+import { writeFileSync, mkdirSync, existsSync, cpSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { hostname } from 'node:os';
+import { fileURLToPath } from 'node:url';
+import Schema from '@deepseek-ai/schemastery';
+import { dshHomePath } from '@deepseek-ai/dsh-home-paths';
+import { appendChapters, reserve } from "./registry.js";
+import { acquireChapterStore, makeDomainStore } from "./store.js";
+import { registerChaptersTools } from "./tools.js";
+import { registerHostCommands } from "./commands.js";
+import { createEnrichWiring } from "./enrich-wire.js";
+import { rulesCommand } from "./rules-commands.js";
+import { BlockAssembler, createUserMessage } from '@deepseek-ai/dsh-llm';
+import { createSyncScheduler, makeCollectionsReader, projectForCwd, readToken, DEFAULT_CLONE_DIR } from "./sync.js";
+import { parseKnowledgeRemote, projectKeyForTarget, resolveProject } from "./repo.js";
+import { providerKindFor, registerProvider } from "./provider.js";
+import { createTreedxProvider } from "./treedx/provider.js";
+export const Config = Schema.object({
+    // The preset is how the engine reaches real sessions (preset realm mount);
+    // turning this off means opting into manual preset authoring instead.
+    installChaptersPreset: Schema.boolean().default(true),
+    artifactStoreRoot: Schema.string().default('.dsh-chapters'),
+    chapterTokenTarget: Schema.number().default(8000),
+    toolResultDeferFloorTokens: Schema.number().default(200),
+    // Share of the window REMAINING after the header bound — never of the
+    // whole window (docs/architecture.md § Budgets).
+    continuationBudgetRatio: Schema.number().default(0.25),
+    fallbackPreset: Schema.string().default('chapters'),
+    // Topic-sequential composition (record §4.2) for the model-free fork path.
+    mergeThreshold: Schema.number().default(0.3),
+    chapterLimit: Schema.number().default(8000),
+    // Per-machine identity for the knowledge repo (commit author + per-harness
+    // token scoping, record §2.1). The hostname is the honest default; override
+    // per machine when two sessions on one box must be told apart.
+    harnessId: Schema.string().default(hostname()),
+    // Knowledge repo (record §12): '' leaves linking to /chapters-link; a URL
+    // auto-links every workspace on its first archive event.
+    knowledgeRemote: Schema.string().default(''),
+    projectKeyOverride: Schema.string().default(''),
+    syncDebounceMs: Schema.number().default(30000),
+    searchDefaultMaxTokens: Schema.number().default(400),
+    enrichmentEnabled: Schema.boolean().default(true),
+    enrichmentModel: Schema.string().default(''),
+    enrichmentIdleMs: Schema.number().default(60000),
+    enrichmentBatchCap: Schema.number().default(5),
+    vocabApply: Schema.boolean().default(false),
+    vocabCoMin: Schema.number().default(3),
+    vocabOverlapMin: Schema.number().default(0.5),
+    coreRulesBudgetTokens: Schema.number().default(1200),
+    rulesCoreBonus: Schema.number().default(0.15),
+    // enum-style string (same register as `fallbackPreset`): 'auto' | 'git' |
+    // 'treedx', validated at use — schemastery has no literal schema.
+    knowledgeProvider: Schema.string().default('auto'),
+    treedxFetchTimeoutMs: Schema.number().default(15000),
+    treedxWorkspaceTtlSeconds: Schema.number().default(900),
+    treedxLeaseRetries: Schema.number().default(3),
+    treedxLeaseRetryDelayMs: Schema.number().default(1000),
+});
+export const name = '@treeseed/dsh-chapters';
+export const inject = ['storageDomain', 'tools', 'agents', 'llm', 'sessionProjections'];
+const HERE = dirname(fileURLToPath(import.meta.url));
+const PKG_ROOT = join(HERE, '..');
+export async function apply(ctx, config) {
+    if (config.installChaptersPreset)
+        installChaptersPreset(ctx);
+    let domain;
+    try {
+        const storageDomain = ctx.get?.('storageDomain');
+        if (storageDomain === undefined)
+            throw new Error('storageDomain absent');
+        const handle = await acquireChapterStore(storageDomain);
+        domain = handle.domain;
+        const store = handle.store;
+        // No close effect here: the facility's own disposer closes domains still
+        // open at facility unmount (its documented teardown), and a close effect
+        // on the apply fiber fires when THAT fiber is disposed — mid-run, which
+        // closed the domain under later commands (r35 caught it). One opener, and
+        // the closer is the facility's unmount, not our fiber.
+        void handle.owner;
+        // §15 amendment: the TreeDX transport, configured and registered in THIS
+        // module instance (host plane). The realm engine registers its own copy
+        // (separate module instances under isolation) — same code, per-plane.
+        registerProvider(createTreedxProvider({
+            fetchTimeoutMs: config.treedxFetchTimeoutMs,
+            workspaceTtlSeconds: config.treedxWorkspaceTtlSeconds,
+            leaseRetries: config.treedxLeaseRetries,
+            leaseRetryDelayMs: config.treedxLeaseRetryDelayMs,
+        }));
+        // P2: host-plane enrichment wiring — command surface + status only
+        // (trigger forced manual; the realm engine owns auto drains).
+        // The routed model of the last real tool-carrying session on this plane:
+        // the host has no live agent, so without this a fork-only flow (never any
+        // in-place compaction => realm never captures lastRoute) leaves
+        // /chapters-enrich run with no route to call. Persisted immediately so
+        // the realm's resolver sees it via the shared settings table too.
+        let hostRoute = null;
+        const enrich = createEnrichWiring({
+            store,
+            cwd: () => undefined,
+            config: {
+                enabled: config.enrichmentEnabled,
+                model: config.enrichmentModel,
+                trigger: 'manual',
+                idleMs: config.enrichmentIdleMs,
+                batchCap: config.enrichmentBatchCap,
+            },
+            fetch: async (prompt, route) => {
+                if (route === null)
+                    throw new Error('no enrichment route resolvable (set /chapters-enrich model … or run a turn first)');
+                const llm = ctx.llm;
+                if (llm?.stream === undefined)
+                    throw new Error('llm.stream absent');
+                const assembler = new BlockAssembler();
+                for await (const chunk of llm.stream({
+                    provider: route.provider, model: route.model,
+                    messages: [createUserMessage({ content: [{ type: 'text', text: prompt }], source: { kind: 'plugin', plugin: 'dsh-chapters' } })],
+                    maxTokens: 900,
+                    purpose: 'compaction',
+                }))
+                    assembler.push(chunk);
+                return assembler.blocks().filter((b) => b.type === 'text').map((b) => b.text ?? '').join('');
+            },
+            conversationRoute: () => hostRoute,
+            log: (m) => ctx.logger?.info?.(`dsh-chapters: ${m}`),
+            warn: (m) => ctx.logger?.warn?.(`dsh-chapters: ${m}`),
+        });
+        const scheduler = createScheduler(store, domain, config, undefined, (cwd, ok) => {
+            enrich.rememberCwd(cwd);
+            if (ok)
+                enrich.queue.onSyncDone('afterPush');
+        }, (m) => ctx.logger?.warn?.(m));
+        registerChaptersTools(ctx, store, {
+            artifactStoreRoot: config.artifactStoreRoot,
+            chapterTokenTarget: config.chapterTokenTarget,
+            toolResultDeferFloorTokens: config.toolResultDeferFloorTokens,
+            continuationBudgetRatio: config.continuationBudgetRatio,
+            fallbackPreset: config.fallbackPreset,
+            mergeThreshold: config.mergeThreshold,
+            chapterLimit: config.chapterLimit,
+            searchMaxTokens: config.searchDefaultMaxTokens,
+            harnessId: config.harnessId,
+            coreRulesBudgetTokens: config.coreRulesBudgetTokens,
+            rulesCoreBonus: config.rulesCoreBonus,
+            scheduler,
+            noteRoute: (r) => {
+                hostRoute = r;
+                void store.putSetting('enrichment.route', `${r.provider}/${r.model}`).catch(() => undefined);
+            },
+        });
+        registerHostCommands(ctx, domain, {
+            artifactStoreRoot: config.artifactStoreRoot,
+            harnessId: config.harnessId,
+            scheduler,
+            enrich,
+            rules: (cwd, args) => rulesCommand({
+                cwd: () => cwd,
+                storeRoot: config.artifactStoreRoot,
+                harnessId: config.harnessId,
+                store,
+                projectFor: (c) => projectForCwd(store.projects(), c),
+                mirrorDir: (c) => join(c, DEFAULT_CLONE_DIR),
+                syncNow: async (c) => { try {
+                    await scheduler.run(c, 'rules');
+                }
+                catch { /* status file records it */ } },
+                now: () => new Date(),
+            }, args),
+        });
+    }
+    catch (error) {
+        // Tools are the whole user-facing surface short of the engine: a failure
+        // here is loud, never a silently missing tool. Loud means the operator
+        // actually sees it — the realm logger routes to boot stdout (r19/r35 twice
+        // burned by a warn nobody could read; the DSH_CHAPTERS_ERRORS sink env is
+        // the engine's precedent).
+        const message = `dsh-chapters: tool/command registration FAILED (${String(error)})`;
+        ctx.logger?.warn?.(message);
+        console.error(message);
+    }
+    ctx.logger?.info?.('dsh-chapters: mounted (preset install + tools registered)');
+    const marker = process.env.DSH_CHAPTERS_WITNESS;
+    if (marker === undefined)
+        return;
+    setTimeout(() => { witness(ctx, marker, domain); }, 500).unref?.();
+}
+/**
+ * The §5 sync loop for the host plane. Auto-link (when `knowledgeRemote` is
+ * configured) happens lazily inside resolveProject: a workspace's first
+ * archive event finds a project record, so nothing network-shaped runs
+ * before anything archives.
+ */
+export function createScheduler(store, domain, config, debounceOverride, onSyncDone, warn) {
+    return createSyncScheduler({
+        storeRoot: config.artifactStoreRoot,
+        cloneDir: DEFAULT_CLONE_DIR,
+        debounceMs: debounceOverride ?? config.syncDebounceMs,
+        vocab: { apply: config.vocabApply, coMin: config.vocabCoMin, overlapMin: config.vocabOverlapMin },
+        ...(onSyncDone !== undefined ? { onSyncDone } : {}),
+        resolveProject: (cwd) => {
+            const found = projectForCwd(store.projects(), cwd);
+            if (found !== undefined)
+                return found;
+            if (config.knowledgeRemote === '')
+                return undefined;
+            try {
+                const target = parseKnowledgeRemote(config.knowledgeRemote);
+                const kind = providerKindFor(target.kind, config.knowledgeProvider);
+                const resolved = resolveProject(cwd, config.projectKeyOverride !== '' ? config.projectKeyOverride : undefined, config.knowledgeRemote);
+                const rec = {
+                    // Identity via projectKeyForTarget: §2.3 canonicalization, plus the
+                    // treedx/ namespace for TreeDX targets (keyed per-machine-stable by
+                    // construction — that is the whole point of §2.3). The override wins
+                    // exactly as before.
+                    projectKey: config.projectKeyOverride !== '' ? resolved.projectKey : projectKeyForTarget(target),
+                    slug: target.treedx?.repoName ?? (resolved.remote ?? config.knowledgeRemote).split('/').pop().replace(/\.git$/, ''),
+                    remote: config.knowledgeRemote,
+                    kind,
+                    harnessId: config.harnessId,
+                    linkedAt: new Date().toISOString(),
+                    cwd,
+                };
+                domain.table('projects').put(rec.projectKey, rec);
+                return rec;
+            }
+            catch (error) {
+                // A policy contradiction (knowledgeProvider vs the remote scheme) is
+                // LOUD in the log but never throws into the archive path (§5.3 shape).
+                warn?.(`dsh-chapters: knowledgeRemote auto-link refused: ${String(error?.message ?? error)}`);
+                return undefined;
+            }
+        },
+        tokenFor: (cwd, projectKey) => readToken(cwd, config.artifactStoreRoot, projectKey),
+        collectionsFor: makeCollectionsReader(store.sessions.bind(store), config.artifactStoreRoot),
+    });
+}
+// ---------------------------------------------------------------- preset install
+const PRESET_ID = 'chapters';
+const USER_PRESET_DIR = '.agent-presets'; // kernel constant: presets/agent-presets/src/discovery.ts
+function installChaptersPreset(ctx) {
+    const srcDir = join(PKG_ROOT, 'presets', PRESET_ID);
+    if (!existsSync(srcDir))
+        return;
+    const dstDir = dshHomePath(USER_PRESET_DIR, PRESET_ID);
+    if (existsSync(join(dstDir, 'preset.yml')))
+        return; // user-owned from here on; never clobber
+    try {
+        mkdirSync(join(dshHomePath(), USER_PRESET_DIR), { recursive: true });
+        cpSync(srcDir, dstDir, { recursive: true });
+        ctx.logger?.info?.(`dsh-chapters: installed the "${PRESET_ID}" preset to ${dstDir} — pick it in the preset menu for chapter-form compaction (standard keeps LLM summaries)`);
+    }
+    catch (error) {
+        ctx.logger?.info?.(`dsh-chapters: preset install FAILED (${String(error)})`);
+    }
+}
+// ---------------------------------------------------------------- dev witness
+async function witness(ctx, marker, preopened) {
+    const WITNESS_SESSION = 'dsh-chapters-witness';
+    const out = { at: new Date().toISOString() };
+    try {
+        out.storageDomainPresent = ctx.get?.('storageDomain') !== undefined;
+        out.presetsInstalled = existsSync(dshHomePath(USER_PRESET_DIR, PRESET_ID, 'preset.yml'));
+        const storageDomain = ctx.get?.('storageDomain');
+        const store = preopened !== undefined ? makeDomainStore(preopened) : (await acquireChapterStore(storageDomain)).store;
+        const prior = await store.get(WITNESS_SESSION);
+        out.priorChapters = prior.chapters.length;
+        if (prior.chapters.length === 0) {
+            const reserved = reserve(prior, 'witness@1', 1);
+            const record = {
+                number: reserved.numbers[0] ?? 1,
+                path: `.dsh-chapters/${WITNESS_SESSION}/chapters/001-witness.md`,
+                title: 'witness', summary: `first boot ${new Date().toISOString()}`,
+                startSeq: 0, endSeq: 0, topics: [], messages: 0, sha256: '0'.repeat(64), estimatedTokens: 0, artifacts: [],
+            };
+            await store.put(WITNESS_SESSION, appendChapters(reserved.state, [record]));
+        }
+        else {
+            await store.put(WITNESS_SESSION, prior);
+        }
+        out.storedChapters = (await store.get(WITNESS_SESSION)).chapters.length;
+    }
+    catch (error) {
+        out.error = String(error);
+    }
+    writeFileSync(marker, JSON.stringify(out, null, 2));
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

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

package/lib/indexing.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Layer 2 of the two-layer index (knowledge-repo.md §10.2): the compressed,
+ * searchable, sharded index derived from chapter frontmatter + Layer-1
+ * curation facts. PURE + DETERMINISTIC: same inputs → same shards, and an
+ * empty manifest rebuilds the whole index identically (the recovery path).
+ *
+ * Shards are one file per canonical topic (alphabetical — bounded files,
+ * writes from different chapters usually touch different shards). Layer 1
+ * (`edits/<harness>/curation.jsonl`) is where humans and the plugin inject
+ * aliases, weights, pins, and group facts; this module applies them.
+ */
+export interface IndexEntry {
+    /** Repo-relative chapter path (chapters/<key>/<session>/<file>). */
+    path: string;
+    title: string;
+    topics: string[];
+    kind: 'chapter' | 'rule';
+    /** P3: rule category (chapters omit). */
+    category?: string;
+    /** Milliseconds; missing → sorts first within its topic shard. */
+    mtime?: number;
+    /** S5 stitch view: additional member paths (this entry's `path` is the
+     * canonical first member). Single-file entries omit it. */
+    paths?: string[];
+}
+export declare function stitchFragments(entries: readonly IndexEntry[]): IndexEntry[];
+export type CurationFact = {
+    type: 'topic-alias';
+    from: string;
+    to: string;
+    at: string;
+} | {
+    type: 'topic-pin';
+    topic: string;
+    at: string;
+} | {
+    type: 'topic-weight';
+    topic: string;
+    weight: number;
+    at: string;
+} | {
+    type: 'group';
+    topics: string[];
+    at: string;
+} | {
+    type: 'note';
+    topic: string;
+    text: string;
+    at: string;
+}
+/** P3 §15 amendment: per-machine rule status; index layers ignore it (only rules.ts + the scorer consume it) */
+ | {
+    type: 'rule-status';
+    rule: string;
+    status: string;
+    at: string;
+};
+export interface IndexManifest {
+    [inputPath: string]: {
+        hash: string;
+        at: string;
+    };
+}
+export interface IndexBuild {
+    /** topic → shard file content */
+    shards: Map<string, string>;
+    manifest: IndexManifest;
+    /** True when any shard content changed (commit only when true). */
+    changed: boolean;
+    topics: string[];
+}
+export declare const hashEntry: (e: IndexEntry) => string;
+/** Minimal frontmatter reader for the `key: value` lines render.ts writes. */
+export declare function parseFrontmatter(text: string): Record<string, string | string[]>;
+/** A chapter file's text → IndexEntry (topics from frontmatter, kind from `kind:`). */
+export declare function entryFromChapter(path: string, text: string, mtime?: number): IndexEntry;
+/** Layer-1 parse: one JSON fact per line; malformed lines are skipped (logged by the caller). */
+export declare function parseCuration(text: string): CurationFact[];
+/**
+ * Build the sharded index. Aliases canonicalize topics (from→to, transitive),
+ * pinned topics sort first inside their position, weights scale the sort
+ * within a topic, and the manifest tracks per-entry hashes for the
+ * incremental fast path (an empty manifest = full rebuild = identical output).
+ */
+export declare function buildIndexShards(entries: readonly IndexEntry[], curation: readonly CurationFact[], manifest?: IndexManifest): IndexBuild;