oh-my-second-brain 0.1.8 → 0.2.0

package/adapters/claude-code/skills/capture/SKILL.md

@@ -1,50 +0,0 @@
----
-name: oms-capture
-description: Capture knowledge into the vault under the Oh My Second Brain convention using gated MCP prepare/commit tools.
----
-
-# Skill: oms-capture (Claude Code)
-
-Place a piece of knowledge into the vault with correct frontmatter and folder placement.
-
-## Invocation
-
-```
-/oms-capture
-```
-
-## What this skill does
-
-Uses MCP `oms_capture_prepare` first. Only call MCP `oms_capture_commit`
-after prepare returns `ready` or the user has supplied missing fields.
-
-## Agent-guided steps (v0)
-
-1. Identify the **concept** that fits the incoming knowledge (check `vault/.oms/concepts/`).
-2. Resolve the **target folder** from `vault/.oms/taxonomy.yaml`.
-3. Generate a filename: `YYYY-MM-DD-<slug>.md`.
-4. Construct frontmatter — fill `required: true` fields; preserve any extra fields.
-5. If required fields are missing, ask for them; do not write.
-6. If placement is ambiguous, route to inbox.
-7. Commit only through `oms_capture_commit` (`create` or `append`).
-8. Shell out: `oms doctor` (non-blocking, exits 0) to confirm the note is clean.
-
-## Example
-
-```
-Input: "Attention Is All You Need", https://arxiv.org/abs/1706.03762
-
-→ concept:  literature
-→ folder:   vault/references/
-→ file:     vault/references/2017-06-12-attention-is-all-you-need.md
-→ frontmatter:
-    title: "Attention Is All You Need"
-    source-url: "https://arxiv.org/abs/1706.03762"
-    captured-at: "2026-05-31"
-```
-
-## Runtime
-
-`oms_capture_prepare` preserves route-to-inbox and ask-missing-fields behavior.
-`oms_capture_commit` refuses unsafe paths, `.oms/` internals, non-markdown
-targets, and frontmatter that violates the resolved concept contract.

package/adapters/codex/skills/oms-capture/SKILL.md

@@ -1,16 +0,0 @@
----
-name: oms-capture
-description: Capture knowledge into the vault through Oh My Second Brain's folder/frontmatter contract.
----
-
-# oms-capture
-
-Use MCP `oms_capture_prepare` before writing. Commit only with `oms_capture_commit` after the plan is `ready` or the user provides missing fields.
-
-Rules:
-
-1. Resolve concept from the user-owned ontology.
-2. Resolve folder from `vault/.oms/taxonomy.yaml`.
-3. Fill required frontmatter; preserve additional properties.
-4. Route ambiguity to inbox.
-5. Keep writes inside the vault and Markdown-only.

package/adapters/hermes/skills/capture/SKILL.md

@@ -1,16 +0,0 @@
----
-name: capture
-description: Capture knowledge into the vault through Oh My Second Brain's folder/frontmatter contract.
----
-
-# oms-capture
-
-Use MCP `oms_capture_prepare` before writing. Commit only with `oms_capture_commit` after the plan is `ready` or the user provides missing fields.
-
-Rules:
-
-1. Resolve concept from the user-owned ontology.
-2. Resolve folder from `vault/.oms/taxonomy.yaml`.
-3. Fill required frontmatter; preserve additional properties.
-4. Route ambiguity to inbox.
-5. Keep writes inside the vault and Markdown-only.

package/core/skills/capture/SKILL.md

@@ -1,50 +0,0 @@
----
-name: capture
-description: Capture knowledge into the vault under the declared Oh My Second Brain convention.
----
-
-# Skill: capture
-
-Place a piece of knowledge into the vault according to the Oh My Second Brain convention.
-The librarian persona governs this action.
-
-## What this skill does
-
-1. Determine the **concept** that best fits the incoming knowledge (literature, inbox, note, etc.).
-2. Resolve the **target folder** from `vault/.oms/taxonomy.yaml` — the folder whose declared `intent` matches this knowledge type.
-3. Generate a filename that follows the concept's naming rules (default: `YYYY-MM-DD-<slugified-title>.md`).
-4. Construct frontmatter from the concept's declared fields:
-   - Fill every `required: true` field.
-   - Fill optional fields where values are known.
-   - Leave undeclared (extra) frontmatter fields untouched (`additionalProperties: preserve`).
-5. Write the note body after the frontmatter block.
-6. Run `oms doctor` (non-blocking, exits 0) to confirm the new note passes field validation.
-
-## Engine
-
-The capture engine is implemented in `src/capture/safe.ts` and exposed via two MCP tools:
-
-- **`oms_capture_prepare`** — resolves the target path and constructs the proposed frontmatter/body without writing anything. Call this first to let the agent review the proposed note before committing.
-- **`oms_capture_commit`** — writes the file to disk. Gated by vault confinement: rejects writes that are outside the vault, to non-`.md` files, or into the `.oms/` config directory. Frontmatter violations are warn-only and do not block the commit.
-
-The recommended agent flow is to call `oms_capture_prepare`, review the result, then call `oms_capture_commit` to finalize.
-
-## Example agent steps
-
-```
-User: "Save this paper: 'Attention Is All You Need', arxiv.org/abs/1706.03762"
-
-1. concept = literature  (matches folder: references/)
-2. folder  = vault/references/
-3. file    = vault/references/2017-06-12-attention-is-all-you-need.md
-4. frontmatter:
-     title: "Attention Is All You Need"
-     source-url: "https://arxiv.org/abs/1706.03762"
-     captured-at: "2026-05-31"
-5. write note body
-6. oms doctor  ← verify (exits 0, non-blocking)
-```
-
-## Persona
-
-Use the **librarian** agent persona for this skill (`core/agents/librarian.md`).

package/dist/adapt/HostAdapter.d.ts

@@ -1,21 +0,0 @@
-/**
- * HostAdapter — per-host integration interface.
- *
- * Each host (Claude Code, Codex, Hermes) has structurally asymmetric installation
- * paths, convention file names, and capability sets. This asymmetry is intentional
- * and documented in adapters/README.md. The interface is deliberately minimal:
- * resist the urge to unify what is genuinely different per host.
- */
-export type HostId = "claude-code" | "codex" | "hermes";
-export interface HostCapabilities {
-    mcp: boolean;
-    skills: boolean;
-    /** Name of the host's top-level convention file (e.g. "CLAUDE.md"). */
-    conventionFile: string;
-}
-export interface HostAdapter {
-    readonly host: HostId;
-    capabilities(): HostCapabilities;
-    installManifest(vaultRoot: string): Promise<void>;
-    installConventionFile(vaultRoot: string): Promise<void>;
-}

package/dist/adapt/HostAdapter.js

@@ -1,10 +0,0 @@
-/**
- * HostAdapter — per-host integration interface.
- *
- * Each host (Claude Code, Codex, Hermes) has structurally asymmetric installation
- * paths, convention file names, and capability sets. This asymmetry is intentional
- * and documented in adapters/README.md. The interface is deliberately minimal:
- * resist the urge to unify what is genuinely different per host.
- */
-export {};
-//# sourceMappingURL=HostAdapter.js.map

package/dist/adapt/HostAdapter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"HostAdapter.js","sourceRoot":"","sources":["../../src/adapt/HostAdapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/dist/adapt/claudeCode.d.ts

@@ -1,9 +0,0 @@
-import type { HostAdapter, HostCapabilities, HostId } from "./HostAdapter.js";
-export declare class ClaudeCodeAdapter implements HostAdapter {
-    readonly host: HostId;
-    capabilities(): HostCapabilities;
-    /** TODO: v1 — write .claude/manifest.json into vaultRoot */
-    installManifest(_vaultRoot: string): Promise<void>;
-    /** TODO: v1 — scaffold CLAUDE.md into vaultRoot */
-    installConventionFile(_vaultRoot: string): Promise<void>;
-}

package/dist/adapt/claudeCode.js

@@ -1,15 +0,0 @@
-export class ClaudeCodeAdapter {
-    host = "claude-code";
-    capabilities() {
-        return { mcp: true, skills: true, conventionFile: "CLAUDE.md" };
-    }
-    /** TODO: v1 — write .claude/manifest.json into vaultRoot */
-    async installManifest(_vaultRoot) {
-        throw new Error("not implemented in v0");
-    }
-    /** TODO: v1 — scaffold CLAUDE.md into vaultRoot */
-    async installConventionFile(_vaultRoot) {
-        throw new Error("not implemented in v0");
-    }
-}
-//# sourceMappingURL=claudeCode.js.map

package/dist/adapt/claudeCode.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"claudeCode.js","sourceRoot":"","sources":["../../src/adapt/claudeCode.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,iBAAiB;IACnB,IAAI,GAAW,aAAa,CAAC;IAEtC,YAAY;QACV,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;IAClE,CAAC;IAED,4DAA4D;IAC5D,KAAK,CAAC,eAAe,CAAC,UAAkB;QACtC,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,mDAAmD;IACnD,KAAK,CAAC,qBAAqB,CAAC,UAAkB;QAC5C,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/adapt/codex.d.ts

@@ -1,9 +0,0 @@
-import type { HostAdapter, HostCapabilities, HostId } from "./HostAdapter.js";
-export declare class CodexAdapter implements HostAdapter {
-    readonly host: HostId;
-    capabilities(): HostCapabilities;
-    /** TODO: v1 — write Codex manifest into vaultRoot */
-    installManifest(_vaultRoot: string): Promise<void>;
-    /** TODO: v1 — scaffold AGENTS.md into vaultRoot */
-    installConventionFile(_vaultRoot: string): Promise<void>;
-}

package/dist/adapt/codex.js

@@ -1,15 +0,0 @@
-export class CodexAdapter {
-    host = "codex";
-    capabilities() {
-        return { mcp: true, skills: true, conventionFile: "AGENTS.md" };
-    }
-    /** TODO: v1 — write Codex manifest into vaultRoot */
-    async installManifest(_vaultRoot) {
-        throw new Error("not implemented in v0");
-    }
-    /** TODO: v1 — scaffold AGENTS.md into vaultRoot */
-    async installConventionFile(_vaultRoot) {
-        throw new Error("not implemented in v0");
-    }
-}
-//# sourceMappingURL=codex.js.map

package/dist/adapt/codex.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"codex.js","sourceRoot":"","sources":["../../src/adapt/codex.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,YAAY;IACd,IAAI,GAAW,OAAO,CAAC;IAEhC,YAAY;QACV,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,WAAW,EAAE,CAAC;IAClE,CAAC;IAED,qDAAqD;IACrD,KAAK,CAAC,eAAe,CAAC,UAAkB;QACtC,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,mDAAmD;IACnD,KAAK,CAAC,qBAAqB,CAAC,UAAkB;QAC5C,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/adapt/hermes.d.ts

@@ -1,9 +0,0 @@
-import type { HostAdapter, HostCapabilities, HostId } from "./HostAdapter.js";
-export declare class HermesAdapter implements HostAdapter {
-    readonly host: HostId;
-    capabilities(): HostCapabilities;
-    /** TODO: v1 — write Hermes manifest into vaultRoot */
-    installManifest(_vaultRoot: string): Promise<void>;
-    /** TODO: v1 — scaffold SOUL.md into vaultRoot */
-    installConventionFile(_vaultRoot: string): Promise<void>;
-}

package/dist/adapt/hermes.js

@@ -1,15 +0,0 @@
-export class HermesAdapter {
-    host = "hermes";
-    capabilities() {
-        return { mcp: true, skills: true, conventionFile: "SOUL.md" };
-    }
-    /** TODO: v1 — write Hermes manifest into vaultRoot */
-    async installManifest(_vaultRoot) {
-        throw new Error("not implemented in v0");
-    }
-    /** TODO: v1 — scaffold SOUL.md into vaultRoot */
-    async installConventionFile(_vaultRoot) {
-        throw new Error("not implemented in v0");
-    }
-}
-//# sourceMappingURL=hermes.js.map

package/dist/adapt/hermes.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"hermes.js","sourceRoot":"","sources":["../../src/adapt/hermes.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,aAAa;IACf,IAAI,GAAW,QAAQ,CAAC;IAEjC,YAAY;QACV,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,SAAS,EAAE,CAAC;IAChE,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,eAAe,CAAC,UAAkB;QACtC,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,iDAAiD;IACjD,KAAK,CAAC,qBAAqB,CAAC,UAAkB;QAC5C,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;CACF"}

package/dist/cli/semantic-metadata-commands.d.ts

@@ -1,3 +0,0 @@
-import { type ParsedSemanticArgs } from "./semantic-args.js";
-export declare function runCollectionCommand(action: string | undefined, collectionPath: string | undefined, args: ParsedSemanticArgs, vault: string, write: (message: string) => void, writeError: (message: string) => void): Promise<number>;
-export declare function runContextCommand(action: string | undefined, rest: readonly string[], args: ParsedSemanticArgs, vault: string, write: (message: string) => void, writeError: (message: string) => void): Promise<number>;

package/dist/cli/semantic-metadata-commands.js

@@ -1,115 +0,0 @@
-import { addSemanticContext, listSemanticCollections, listSemanticContexts, removeSemanticCollection, removeSemanticContext, syncSemanticEmbeddingStore, updateSemanticCollection, renameSemanticCollection, } from "../search/semantic.js";
-import { booleanOption, printJson, semanticStorageOption, stringListOption, stringOption, } from "./semantic-args.js";
-import { semanticUsageText } from "./semantic-usage.js";
-export async function runCollectionCommand(action, collectionPath, args, vault, write, writeError) {
-    if (action === "add") {
-        const result = await syncSemanticEmbeddingStore({
-            vault,
-            collection: stringOption(args, "collection"),
-            collectionPath,
-            pattern: stringOption(args, "pattern"),
-            ignore: stringListOption(args, "ignore"),
-            includeByDefault: booleanOption(args, "includeDefault"),
-            updateCommand: stringOption(args, "updateCommand"),
-            index: stringOption(args, "index"),
-            storage: semanticStorageOption(args),
-            modelPath: stringOption(args, "modelPath"),
-            chunkStrategy: stringOption(args, "chunkStrategy"),
-        });
-        printJson(write, result);
-        return result.available ? 0 : 1;
-    }
-    if (action === "list" || action === "show") {
-        const result = await listSemanticCollections({ vault, index: stringOption(args, "index"), storage: semanticStorageOption(args) });
-        if (!result.available) {
-            printJson(write, result);
-            return 1;
-        }
-        const name = action === "show" ? collectionPath : undefined;
-        const collections = name ? result.collections.filter((collection) => collection.name === name) : result.collections;
-        printJson(write, { collections });
-        return 0;
-    }
-    if (action === "remove") {
-        const result = await removeSemanticCollection({
-            vault,
-            index: stringOption(args, "index"),
-            storage: semanticStorageOption(args),
-            collection: collectionPath ?? "",
-        });
-        printJson(write, result);
-        return result.available ? 0 : 1;
-    }
-    if (action === "rename") {
-        const index = args.positional.indexOf(collectionPath ?? "");
-        const result = await renameSemanticCollection({
-            vault,
-            index: stringOption(args, "index"),
-            storage: semanticStorageOption(args),
-            from: collectionPath ?? "",
-            to: args.positional[index + 1] ?? "",
-        });
-        printJson(write, result);
-        return result.available ? 0 : 1;
-    }
-    if (action === "update-cmd" || action === "include" || action === "exclude") {
-        const index = args.positional.indexOf(collectionPath ?? "");
-        const result = await updateSemanticCollection({
-            vault,
-            index: stringOption(args, "index"),
-            storage: semanticStorageOption(args),
-            collection: collectionPath ?? "",
-            updateCommand: action === "update-cmd" ? args.positional.slice(index + 1).join(" ") : undefined,
-            includeByDefault: action === "include" ? true : action === "exclude" ? false : undefined,
-        });
-        printJson(write, result);
-        return result.available ? 0 : 1;
-    }
-    writeError(semanticUsageText());
-    return 1;
-}
-function contextTarget(target) {
-    if (!target || target === "global")
-        return { pathPrefix: "." };
-    const slash = target.indexOf("/");
-    if (slash < 0)
-        return { collection: target, pathPrefix: "." };
-    return { collection: target.slice(0, slash), pathPrefix: target.slice(slash + 1) || "." };
-}
-export async function runContextCommand(action, rest, args, vault, write, writeError) {
-    if (action === "list" || !action) {
-        const result = await listSemanticContexts({ vault, index: stringOption(args, "index"), storage: semanticStorageOption(args) });
-        printJson(write, result);
-        return result.available ? 0 : 1;
-    }
-    const target = contextTarget(rest[1]);
-    if (action === "add") {
-        const context = rest.slice(2).join(" ").trim();
-        if (!context) {
-            writeError("Usage: oms semantic context add [collection[/path]] <text>");
-            return 1;
-        }
-        const result = await addSemanticContext({
-            vault,
-            index: stringOption(args, "index"),
-            storage: semanticStorageOption(args),
-            ...target,
-            context,
-        });
-        printJson(write, result);
-        return result.available ? 0 : 1;
-    }
-    if (action === "rm" || action === "remove") {
-        const result = await removeSemanticContext({
-            vault,
-            index: stringOption(args, "index"),
-            storage: semanticStorageOption(args),
-            ...target,
-        });
-        printJson(write, result);
-        return result.available ? 0 : 1;
-    }
-    writeError(semanticUsageText());
-    return 1;
-}
-//# sourceMappingURL=semantic-metadata-commands.js.map

package/dist/cli/semantic-metadata-commands.js.map

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

package/dist/engine/compile/cascade.d.ts

@@ -1,35 +0,0 @@
-/**
- * Lucasastorian cascade return.
- *
- * Terminology absorbed from lucasastorian/llmwiki (concept-only, see
- * ACKNOWLEDGMENTS.partial.md).
- *
- * Every compile write returns { affected_backlinks: string[] } — the list of
- * wiki pages that link TO the compiled concept page.  The M3 caller uses this
- * to schedule staleness updates: affected pages are marked DIRTY in the
- * staleness ledger and queued for the next compile run.
- */
-import type { CascadeResult, CompileGraph, CompileResult } from "./types.js";
-/**
- * Enrich a CompileResult with the set of wiki pages linking to `conceptId`.
- *
- * The backlink list is resolved via `graph.getBacklinks(conceptId)`.  If the
- * graph is unavailable, use `createNullGraph()` which returns [].
- *
- * @param result    - Raw compile result (body, sha, provenance).
- * @param conceptId - Vault-relative path of the concept page just compiled.
- * @param graph     - CompileGraph implementation providing backlink lookup.
- */
-export declare function withCascade(result: CompileResult, conceptId: string, graph: CompileGraph): CascadeResult;
-/**
- * A no-op CompileGraph that always returns an empty backlink list.
- * Use in tests or when the engine graph is not available.
- */
-export declare function createNullGraph(): CompileGraph;
-/**
- * An in-memory CompileGraph stub for testing cascade behavior.
- * Seed it with known backlink relationships.
- *
- * @param backlinks - Map of concept path → list of paths that link to it.
- */
-export declare function createStubGraph(backlinks: Readonly<Record<string, string[]>>): CompileGraph;

package/dist/engine/compile/cascade.js

@@ -1,59 +0,0 @@
-/**
- * Lucasastorian cascade return.
- *
- * Terminology absorbed from lucasastorian/llmwiki (concept-only, see
- * ACKNOWLEDGMENTS.partial.md).
- *
- * Every compile write returns { affected_backlinks: string[] } — the list of
- * wiki pages that link TO the compiled concept page.  The M3 caller uses this
- * to schedule staleness updates: affected pages are marked DIRTY in the
- * staleness ledger and queued for the next compile run.
- */
-// ---------------------------------------------------------------------------
-// Cascade enrichment
-// ---------------------------------------------------------------------------
-/**
- * Enrich a CompileResult with the set of wiki pages linking to `conceptId`.
- *
- * The backlink list is resolved via `graph.getBacklinks(conceptId)`.  If the
- * graph is unavailable, use `createNullGraph()` which returns [].
- *
- * @param result    - Raw compile result (body, sha, provenance).
- * @param conceptId - Vault-relative path of the concept page just compiled.
- * @param graph     - CompileGraph implementation providing backlink lookup.
- */
-export function withCascade(result, conceptId, graph) {
-    const affected_backlinks = graph.getBacklinks(conceptId);
-    return {
-        ...result,
-        affected_backlinks,
-    };
-}
-// ---------------------------------------------------------------------------
-// Graph stubs (for tests / contexts without a live engine graph)
-// ---------------------------------------------------------------------------
-/**
- * A no-op CompileGraph that always returns an empty backlink list.
- * Use in tests or when the engine graph is not available.
- */
-export function createNullGraph() {
-    return {
-        getBacklinks(_docPath) {
-            return [];
-        },
-    };
-}
-/**
- * An in-memory CompileGraph stub for testing cascade behavior.
- * Seed it with known backlink relationships.
- *
- * @param backlinks - Map of concept path → list of paths that link to it.
- */
-export function createStubGraph(backlinks) {
-    return {
-        getBacklinks(docPath) {
-            return backlinks[docPath] ?? [];
-        },
-    };
-}
-//# sourceMappingURL=cascade.js.map

package/dist/engine/compile/cascade.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"cascade.js","sourceRoot":"","sources":["../../../src/engine/compile/cascade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,8EAA8E;AAC9E,qBAAqB;AACrB,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,UAAU,WAAW,CACzB,MAAqB,EACrB,SAAiB,EACjB,KAAmB;IAEnB,MAAM,kBAAkB,GAAG,KAAK,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;IACzD,OAAO;QACL,GAAG,MAAM;QACT,kBAAkB;KACnB,CAAC;AACJ,CAAC;AAED,8EAA8E;AAC9E,iEAAiE;AACjE,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO;QACL,YAAY,CAAC,QAAgB;YAC3B,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,SAA6C;IAE7C,OAAO;QACL,YAAY,CAAC,OAAe;YAC1B,OAAO,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;QAClC,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/engine/compile/cot.d.ts

@@ -1,30 +0,0 @@
-/**
- * Nashsu 2-step Chain-of-Thought compile pipeline.
- *
- * GPL-3.0 IDEA-ONLY: The 2-step CoT approach (analysis → synthesis with
- * [[wikilink]] insertion) is absorbed from nashsu/llm_wiki as an algorithm
- * description only.  No verbatim code from nashsu is used here.
- * Reimplemented from scratch.
- *
- * Step 1 — analysis pass: extract entities / concepts / arguments /
- *           contradictions / structure from source materials.
- * Step 2 — synthesis pass: produce source summary + concept page +
- *           [[wikilink]] insertion.  Step 1 output is the context for Step 2.
- *
- * Always sequential: Step 1 must complete before Step 2 begins.
- */
-import type { CoTResult, LLMProvider } from "./types.js";
-/**
- * Run the nashsu 2-step CoT pipeline.  Always sequential: Step 1 completes
- * before Step 2 begins.
- *
- * @param concept            - Concept name being compiled (used in prompts).
- * @param formattedMaterials - Pre-formatted material string from provenance.formatForSynthesis.
- * @param provider           - Injected LLM provider (use createDeterministicStub in tests).
- */
-export declare function runCoT(concept: string, formattedMaterials: string, provider: LLMProvider): Promise<CoTResult>;
-/**
- * A deterministic LLMProvider stub that produces predictable CoT output.
- * Does NOT make network calls.  Safe for vitest.
- */
-export declare function createDeterministicStub(): LLMProvider;