oh-my-second-brain 0.1.8 → 0.2.0

package/dist/engine/compile/cot.js

@@ -1,153 +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.
- */
-// ---------------------------------------------------------------------------
-// Prompt builders
-// ---------------------------------------------------------------------------
-function buildStep1Prompt(concept, formattedMaterials) {
-    return `You are a knowledge-graph analyst. Analyze the following source materials about the concept "${concept}".
-
-MATERIALS:
-${formattedMaterials}
-
-Produce a structured analysis with EXACTLY these labeled sections (no extra text before ENTITIES):
-ENTITIES: (comma-separated list of named entities mentioned)
-CONCEPTS: (comma-separated list of related concepts)
-ARGUMENTS:
-- (each key claim on its own line prefixed with "- ")
-CONTRADICTIONS:
-- (each conflicting claim on its own line, or a single line "- none")
-STRUCTURE: (one paragraph describing how "${concept}" relates to the above entities/concepts)`;
-}
-function buildStep2Prompt(concept, formattedMaterials, step1) {
-    const contradictionText = step1.contradictions.length > 0
-        ? step1.contradictions.join(" | ")
-        : "none";
-    return `You are a wiki synthesis engine. Create a comprehensive concept page for "${concept}".
-
-ANALYSIS CONTEXT (from Step 1):
-Entities: ${step1.entities.join(", ")}
-Concepts: ${step1.concepts.join(", ")}
-Key Arguments: ${step1.arguments.join(" | ")}
-Contradictions: ${contradictionText}
-Structure: ${step1.structure}
-
-SOURCE MATERIALS:
-${formattedMaterials}
-
-Write a Markdown concept page. Requirements:
-1. Begin with a 2-3 sentence summary of ${concept}.
-2. Use ## headings for major sections.
-3. Insert [[wikilinks]] for all related concepts, entities, and referenced topics.
-4. Where sources contradict, note the conflict inline: > **Conflict:** Source A claims X; Source B claims Y. Unresolved.
-5. End with a ## See Also section listing related concept wikilinks.
-Output ONLY the Markdown body (no YAML frontmatter, no preamble).`;
-}
-// ---------------------------------------------------------------------------
-// Step 1 response parser
-// ---------------------------------------------------------------------------
-function parseStep1(raw) {
-    /** Extract the content of a labeled section, stopping at the next ALL-CAPS label. */
-    const extractSection = (label) => {
-        const match = raw.match(new RegExp(`${label}:[\\s\\S]*?\\n([\\s\\S]*?)(?=\\n[A-Z]+:|$)`, "i"));
-        return match?.[1]?.trim() ?? "";
-    };
-    const extractInline = (label) => {
-        const match = raw.match(new RegExp(`${label}:\\s*(.+)`, "i"));
-        return match?.[1]?.trim() ?? "";
-    };
-    const splitList = (s) => s
-        .split(/\n|,/)
-        .map((x) => x.replace(/^[-•*]\s*/, "").trim())
-        .filter(Boolean);
-    return {
-        entities: splitList(extractInline("ENTITIES")),
-        concepts: splitList(extractInline("CONCEPTS")),
-        arguments: splitList(extractSection("ARGUMENTS")),
-        contradictions: splitList(extractSection("CONTRADICTIONS")).filter((s) => s.toLowerCase() !== "none"),
-        structure: extractInline("STRUCTURE"),
-    };
-}
-// ---------------------------------------------------------------------------
-// Public API
-// ---------------------------------------------------------------------------
-/**
- * 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 async function runCoT(concept, formattedMaterials, provider) {
-    // Step 1: analysis — must complete before Step 2
-    const step1Raw = await provider.complete(buildStep1Prompt(concept, formattedMaterials));
-    const step1 = parseStep1(step1Raw);
-    // Step 2: synthesis — uses Step 1 as context
-    const body = await provider.complete(buildStep2Prompt(concept, formattedMaterials, step1));
-    return { step1, body };
-}
-// ---------------------------------------------------------------------------
-// Deterministic stub provider (for tests and offline environments)
-// ---------------------------------------------------------------------------
-/**
- * A deterministic LLMProvider stub that produces predictable CoT output.
- * Does NOT make network calls.  Safe for vitest.
- */
-export function createDeterministicStub() {
-    return {
-        async complete(prompt) {
-            // Detect Step 1 by the presence of the ENTITIES section label
-            if (prompt.includes("ENTITIES:") && prompt.includes("ARGUMENTS:")) {
-                const conceptMatch = /concept "([^"]+)"/.exec(prompt);
-                const concept = conceptMatch?.[1] ?? "unknown";
-                return [
-                    `ENTITIES: ${concept}, entity-A, entity-B`,
-                    `CONCEPTS: ${concept}-theory, ${concept}-practice, meta-${concept}`,
-                    `ARGUMENTS:`,
-                    `- ${concept} is fundamental to knowledge organization`,
-                    `- Multiple sources confirm ${concept} utility`,
-                    `CONTRADICTIONS:`,
-                    `- none`,
-                    `STRUCTURE: ${concept} connects entity-A and entity-B into a structured knowledge graph`,
-                ].join("\n");
-            }
-            // Step 2: synthesis response
-            const conceptMatch = /concept page for "([^"]+)"/.exec(prompt);
-            const concept = conceptMatch?.[1] ?? "unknown";
-            return [
-                `## ${concept}`,
-                ``,
-                `${concept} is a foundational concept in knowledge management. It connects related ideas and provides structure to information.`,
-                ``,
-                `## Key Properties`,
-                ``,
-                `- Relates to [[entity-A]] and [[entity-B]]`,
-                `- Supports [[${concept}-theory]] and [[${concept}-practice]]`,
-                ``,
-                `## Applications`,
-                ``,
-                `${concept} is applied in knowledge graphs and [[meta-${concept}]] contexts.`,
-                ``,
-                `## See Also`,
-                ``,
-                `- [[${concept}-theory]]`,
-                `- [[${concept}-practice]]`,
-                `- [[meta-${concept}]]`,
-            ].join("\n");
-        },
-    };
-}
-//# sourceMappingURL=cot.js.map

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

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

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

@@ -1,47 +0,0 @@
-/**
- * Atomicstrata 2-phase separation for compile execution.
- *
- * CONCEPT-ONLY: The 2-phase approach (extract-all-without-writing → generate)
- * is absorbed from atomicstrata as a conceptual pattern.  No verbatim code.
- *
- * Phase A = extract-all-without-writing
- *   Pure read: load all material files from disk.  Zero vault mutation.
- *
- * Phase B = generate
- *   LLM synthesis writes to the processed/ tier ONLY.  Never writes to wiki/
- *   directly.  Promotion from processed/ → wiki/ is the collection owner's
- *   responsibility (M3).
- *
- * Hard constraint: Phase A and Phase B NEVER overlap in the same execution
- * context.  Enforced by a module-level phase lock.
- */
-import type { FolderGradeMap, PhaseAResult } from "./types.js";
-/**
- * Reset the phase lock.  For testing only — allows sequential phase tests
- * without process restart.
- */
-export declare function resetPhaseLock(): void;
-/**
- * Phase A: load all material files from disk and apply provenance grades.
- *
- * Pure read — no vault mutation.  The phase lock prevents Phase B from
- * starting while Phase A is running.
- *
- * @param materialPaths - Vault-relative paths to load.
- * @param vaultPath     - Absolute path to vault root.
- * @param gradeMap      - Folder->grade map resolved at setup time.
- */
-export declare function phaseA(materialPaths: ReadonlyArray<string>, vaultPath: string, gradeMap: FolderGradeMap): Promise<PhaseAResult>;
-/**
- * Phase B: write synthesized output to the processed/ tier.
- *
- * NEVER writes to wiki/ directly.  The path guard enforces the tier boundary:
- * if `processedDir` contains "/wiki/" or ends with "/wiki", an error is thrown.
- *
- * @param conceptId    - Concept identifier used as the output filename (no extension).
- * @param body         - Synthesized Markdown body from the CoT pipeline.
- * @param processedDir - Absolute path to the processed/ output directory.
- * @param writeFn      - Injected write function; defaults replaced in tests for isolation.
- * @returns Absolute path to the written file.
- */
-export declare function phaseB(conceptId: string, body: string, processedDir: string, writeFn: (filePath: string, content: string) => Promise<void>): Promise<string>;

package/dist/engine/compile/phases.js

@@ -1,101 +0,0 @@
-/**
- * Atomicstrata 2-phase separation for compile execution.
- *
- * CONCEPT-ONLY: The 2-phase approach (extract-all-without-writing → generate)
- * is absorbed from atomicstrata as a conceptual pattern.  No verbatim code.
- *
- * Phase A = extract-all-without-writing
- *   Pure read: load all material files from disk.  Zero vault mutation.
- *
- * Phase B = generate
- *   LLM synthesis writes to the processed/ tier ONLY.  Never writes to wiki/
- *   directly.  Promotion from processed/ → wiki/ is the collection owner's
- *   responsibility (M3).
- *
- * Hard constraint: Phase A and Phase B NEVER overlap in the same execution
- * context.  Enforced by a module-level phase lock.
- */
-import { readFile } from "node:fs/promises";
-import path from "node:path";
-import { applyGrades } from "./provenance.js";
-let _activePhase = "none";
-function acquirePhase(phase) {
-    if (_activePhase !== "none") {
-        throw new Error(`Phase ${phase} cannot start while Phase ${_activePhase} is active. ` +
-            `Phase A and Phase B must never overlap in the same execution context.`);
-    }
-    _activePhase = phase;
-}
-function releasePhase() {
-    _activePhase = "none";
-}
-/**
- * Reset the phase lock.  For testing only — allows sequential phase tests
- * without process restart.
- */
-export function resetPhaseLock() {
-    _activePhase = "none";
-}
-// ---------------------------------------------------------------------------
-// Phase A — extract-all-without-writing (pure read)
-// ---------------------------------------------------------------------------
-/**
- * Phase A: load all material files from disk and apply provenance grades.
- *
- * Pure read — no vault mutation.  The phase lock prevents Phase B from
- * starting while Phase A is running.
- *
- * @param materialPaths - Vault-relative paths to load.
- * @param vaultPath     - Absolute path to vault root.
- * @param gradeMap      - Folder->grade map resolved at setup time.
- */
-export async function phaseA(materialPaths, vaultPath, gradeMap) {
-    acquirePhase("A");
-    try {
-        const rawMaterials = await Promise.all(materialPaths.map(async (relPath) => {
-            const abs = path.join(vaultPath, relPath);
-            const text = await readFile(abs, "utf8");
-            return { path: relPath, text };
-        }));
-        const materials = applyGrades(rawMaterials, gradeMap);
-        return { materials };
-    }
-    finally {
-        releasePhase();
-    }
-}
-// ---------------------------------------------------------------------------
-// Phase B — generate (writes to processed/ tier only)
-// ---------------------------------------------------------------------------
-/**
- * Phase B: write synthesized output to the processed/ tier.
- *
- * NEVER writes to wiki/ directly.  The path guard enforces the tier boundary:
- * if `processedDir` contains "/wiki/" or ends with "/wiki", an error is thrown.
- *
- * @param conceptId    - Concept identifier used as the output filename (no extension).
- * @param body         - Synthesized Markdown body from the CoT pipeline.
- * @param processedDir - Absolute path to the processed/ output directory.
- * @param writeFn      - Injected write function; defaults replaced in tests for isolation.
- * @returns Absolute path to the written file.
- */
-export async function phaseB(conceptId, body, processedDir, writeFn) {
-    acquirePhase("B");
-    try {
-        // Tier boundary guard: processed/ must not resolve to wiki/
-        const normalised = processedDir.replace(/\\/g, "/");
-        if (normalised.includes("/wiki/") ||
-            normalised.endsWith("/wiki")) {
-            throw new Error(`Phase B: processedDir "${processedDir}" resolves to the wiki/ tier. ` +
-                `Phase B must write ONLY to the processed/ tier. ` +
-                `Promotion from processed/ to wiki/ is the collection owner's responsibility.`);
-        }
-        const outputPath = path.join(processedDir, `${conceptId}.md`);
-        await writeFn(outputPath, body);
-        return outputPath;
-    }
-    finally {
-        releasePhase();
-    }
-}
-//# sourceMappingURL=phases.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"phases.js","sourceRoot":"","sources":["../../../src/engine/compile/phases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAO9C,IAAI,YAAY,GAAgB,MAAM,CAAC;AAEvC,SAAS,YAAY,CAAC,KAAgB;IACpC,IAAI,YAAY,KAAK,MAAM,EAAE,CAAC;QAC5B,MAAM,IAAI,KAAK,CACb,SAAS,KAAK,6BAA6B,YAAY,cAAc;YACnE,uEAAuE,CAC1E,CAAC;IACJ,CAAC;IACD,YAAY,GAAG,KAAK,CAAC;AACvB,CAAC;AAED,SAAS,YAAY;IACnB,YAAY,GAAG,MAAM,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,YAAY,GAAG,MAAM,CAAC;AACxB,CAAC;AAED,8EAA8E;AAC9E,oDAAoD;AACpD,8EAA8E;AAE9E;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,aAAoC,EACpC,SAAiB,EACjB,QAAwB;IAExB,YAAY,CAAC,GAAG,CAAC,CAAC;IAClB,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,aAAa,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;YAClC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;YAC1C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;YACzC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACjC,CAAC,CAAC,CACH,CAAC;QACF,MAAM,SAAS,GAAG,WAAW,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;QACtD,OAAO,EAAE,SAAS,EAAE,CAAC;IACvB,CAAC;YAAS,CAAC;QACT,YAAY,EAAE,CAAC;IACjB,CAAC;AACH,CAAC;AAED,8EAA8E;AAC9E,sDAAsD;AACtD,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,SAAiB,EACjB,IAAY,EACZ,YAAoB,EACpB,OAA6D;IAE7D,YAAY,CAAC,GAAG,CAAC,CAAC;IAClB,IAAI,CAAC;QACH,4DAA4D;QAC5D,MAAM,UAAU,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QACpD,IACE,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC7B,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,EAC5B,CAAC;YACD,MAAM,IAAI,KAAK,CACb,0BAA0B,YAAY,gCAAgC;gBACpE,kDAAkD;gBAClD,8EAA8E,CACjF,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,SAAS,KAAK,CAAC,CAAC;QAC9D,MAAM,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAChC,OAAO,UAAU,CAAC;IACpB,CAAC;YAAS,CAAC;QACT,YAAY,EAAE,CAAC;IACjB,CAAC;AACH,CAAC"}

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

@@ -1,45 +0,0 @@
-/**
- * Provenance grade resolution and synthesis context weighting.
- *
- * Grade derives from a folder->grade map resolved at setup-time (never hardcoded).
- * In synthesis context: authored weight is raised to preserve individual voice.
- * Priority: authored > curated > external-raw.
- *
- * Self-authored pattern from bstack `terminology` skill.
- */
-import type { FolderGradeMap, Material, ProvenanceGrade } from "./types.js";
-/**
- * Resolve the provenance grade of a vault-relative document path using
- * the folder->grade map.  Longest-prefix match wins.
- *
- * Falls back to "external-raw" when no prefix matches.
- */
-export declare function resolveGrade(docPath: string, map: FolderGradeMap): ProvenanceGrade;
-/**
- * Apply a grade map to a list of raw materials, returning Material[] with
- * the `grade` field populated.
- */
-export declare function applyGrades(materials: ReadonlyArray<{
-    path: string;
-    text: string;
-}>, map: FolderGradeMap): Material[];
-/**
- * Numeric weight per grade for synthesis context ordering.
- * Authored is weighted highest (3) to preserve individual voice.
- */
-export declare const GRADE_WEIGHTS: Readonly<Record<ProvenanceGrade, number>>;
-/**
- * Sort materials so authored items appear first in the synthesis context,
- * followed by curated, then external-raw.  Stable sort within each grade.
- */
-export declare function sortByProvenance(materials: ReadonlyArray<Material>): Material[];
-/**
- * Return the dominant (highest-priority) grade among the given materials.
- * Returns "external-raw" for an empty array.
- */
-export declare function dominantGrade(materials: ReadonlyArray<Material>): ProvenanceGrade;
-/**
- * Format materials for the synthesis LLM prompt, ordered by provenance weight.
- * Authored items are labelled to signal individual-voice preservation.
- */
-export declare function formatForSynthesis(materials: ReadonlyArray<Material>): string;

package/dist/engine/compile/provenance.js

@@ -1,103 +0,0 @@
-/**
- * Provenance grade resolution and synthesis context weighting.
- *
- * Grade derives from a folder->grade map resolved at setup-time (never hardcoded).
- * In synthesis context: authored weight is raised to preserve individual voice.
- * Priority: authored > curated > external-raw.
- *
- * Self-authored pattern from bstack `terminology` skill.
- */
-// ---------------------------------------------------------------------------
-// Grade order (index = priority; lower index = higher priority)
-// ---------------------------------------------------------------------------
-const GRADE_ORDER = [
-    "authored",
-    "curated",
-    "external-raw",
-];
-// ---------------------------------------------------------------------------
-// Grade resolution
-// ---------------------------------------------------------------------------
-/**
- * Resolve the provenance grade of a vault-relative document path using
- * the folder->grade map.  Longest-prefix match wins.
- *
- * Falls back to "external-raw" when no prefix matches.
- */
-export function resolveGrade(docPath, map) {
-    let bestMatch = "";
-    let bestGrade = "external-raw";
-    for (const [folder, grade] of Object.entries(map)) {
-        // Normalize: treat "notes/" and "notes" identically
-        const prefix = folder.endsWith("/") ? folder : `${folder}/`;
-        const matches = docPath.startsWith(prefix) || docPath === folder;
-        if (matches && folder.length > bestMatch.length) {
-            bestMatch = folder;
-            bestGrade = grade;
-        }
-    }
-    return bestGrade;
-}
-/**
- * Apply a grade map to a list of raw materials, returning Material[] with
- * the `grade` field populated.
- */
-export function applyGrades(materials, map) {
-    return materials.map((m) => ({
-        path: m.path,
-        text: m.text,
-        grade: resolveGrade(m.path, map),
-    }));
-}
-// ---------------------------------------------------------------------------
-// Synthesis context weighting
-// ---------------------------------------------------------------------------
-/**
- * Numeric weight per grade for synthesis context ordering.
- * Authored is weighted highest (3) to preserve individual voice.
- */
-export const GRADE_WEIGHTS = {
-    authored: 3,
-    curated: 2,
-    "external-raw": 1,
-};
-/**
- * Sort materials so authored items appear first in the synthesis context,
- * followed by curated, then external-raw.  Stable sort within each grade.
- */
-export function sortByProvenance(materials) {
-    return [...materials].sort((a, b) => GRADE_WEIGHTS[b.grade] - GRADE_WEIGHTS[a.grade]);
-}
-/**
- * Return the dominant (highest-priority) grade among the given materials.
- * Returns "external-raw" for an empty array.
- */
-export function dominantGrade(materials) {
-    if (materials.length === 0)
-        return "external-raw";
-    let best = "external-raw";
-    for (const m of materials) {
-        if (GRADE_ORDER.indexOf(m.grade) < GRADE_ORDER.indexOf(best)) {
-            best = m.grade;
-        }
-    }
-    return best;
-}
-/**
- * Format materials for the synthesis LLM prompt, ordered by provenance weight.
- * Authored items are labelled to signal individual-voice preservation.
- */
-export function formatForSynthesis(materials) {
-    const sorted = sortByProvenance(materials);
-    return sorted
-        .map((m) => {
-        const label = m.grade === "authored"
-            ? "[AUTHORED — preserve individual voice]"
-            : m.grade === "curated"
-                ? "[CURATED]"
-                : "[EXTERNAL]";
-        return `${label}\nSource: ${m.path}\n${m.text}`;
-    })
-        .join("\n\n---\n\n");
-}
-//# sourceMappingURL=provenance.js.map

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

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

package/dist/engine/compile/sha-cache.d.ts

@@ -1,42 +0,0 @@
-/**
- * Disk-persisted SHA cache for the compile engine.
- *
- * Persists to .llmwiki/sha-cache.json inside the configured dotfolder.
- * .llmwiki is a never-synced dotfolder (not committed to git, not synced by Obsidian).
- *
- * SHA-incremental pattern: bstack `terminology` skill (self-authored, Steps 2-4).
- */
-/** Compute SHA-256 hex digest of the given content string. */
-export declare function sha256(content: string): string;
-/**
- * Compute a stable fingerprint SHA for a set of materials.
- *
- * Materials are sorted by path before hashing so order does not matter.
- * The fingerprint changes when any material's path or text changes, or
- * when materials are added or removed.
- */
-export declare function fingerprint(materials: ReadonlyArray<{
-    path: string;
-    text: string;
-}>): string;
-/** Maps concept ID (vault-relative path) → SHA-256 of last compiled material fingerprint. */
-export type SHACache = Record<string, string>;
-/**
- * Load the SHA cache from disk.
- * Returns an empty cache if the file is absent or unreadable.
- */
-export declare function loadSHACache(dotLlmwiki: string): Promise<SHACache>;
-/**
- * Persist the SHA cache to disk.
- * Creates the dotLlmwiki directory if it does not exist.
- */
-export declare function saveSHACache(dotLlmwiki: string, cache: SHACache): Promise<void>;
-/**
- * Compare a new material-fingerprint SHA against the cached value for `conceptId`.
- *
- * Returns:
- * - `"new"`       — concept not yet in cache (first compile)
- * - `"unchanged"` — SHA matches; skip recompile (R12 incremental)
- * - `"changed"`   — SHA differs; trigger recompile
- */
-export declare function diffSHA(cache: SHACache, conceptId: string, newSHA: string): "unchanged" | "changed" | "new";

package/dist/engine/compile/sha-cache.js

@@ -1,86 +0,0 @@
-/**
- * Disk-persisted SHA cache for the compile engine.
- *
- * Persists to .llmwiki/sha-cache.json inside the configured dotfolder.
- * .llmwiki is a never-synced dotfolder (not committed to git, not synced by Obsidian).
- *
- * SHA-incremental pattern: bstack `terminology` skill (self-authored, Steps 2-4).
- */
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import { createHash } from "node:crypto";
-import path from "node:path";
-// ---------------------------------------------------------------------------
-// SHA utilities
-// ---------------------------------------------------------------------------
-/** Compute SHA-256 hex digest of the given content string. */
-export function sha256(content) {
-    return createHash("sha256").update(content, "utf8").digest("hex");
-}
-/**
- * Compute a stable fingerprint SHA for a set of materials.
- *
- * Materials are sorted by path before hashing so order does not matter.
- * The fingerprint changes when any material's path or text changes, or
- * when materials are added or removed.
- */
-export function fingerprint(materials) {
-    const sorted = [...materials].sort((a, b) => a.path.localeCompare(b.path));
-    const combined = sorted.map((m) => `${m.path}\x00${m.text}`).join("\x01");
-    return sha256(combined);
-}
-// ---------------------------------------------------------------------------
-// Cache file path
-// ---------------------------------------------------------------------------
-function cacheFilePath(dotLlmwiki) {
-    return path.join(dotLlmwiki, "sha-cache.json");
-}
-// ---------------------------------------------------------------------------
-// Persistence
-// ---------------------------------------------------------------------------
-/**
- * Load the SHA cache from disk.
- * Returns an empty cache if the file is absent or unreadable.
- */
-export async function loadSHACache(dotLlmwiki) {
-    try {
-        const raw = await readFile(cacheFilePath(dotLlmwiki), "utf8");
-        const parsed = JSON.parse(raw);
-        if (parsed !== null &&
-            typeof parsed === "object" &&
-            !Array.isArray(parsed)) {
-            return parsed;
-        }
-        return {};
-    }
-    catch {
-        return {};
-    }
-}
-/**
- * Persist the SHA cache to disk.
- * Creates the dotLlmwiki directory if it does not exist.
- */
-export async function saveSHACache(dotLlmwiki, cache) {
-    await mkdir(dotLlmwiki, { recursive: true });
-    await writeFile(cacheFilePath(dotLlmwiki), JSON.stringify(cache, null, 2), "utf8");
-}
-// ---------------------------------------------------------------------------
-// Diff
-// ---------------------------------------------------------------------------
-/**
- * Compare a new material-fingerprint SHA against the cached value for `conceptId`.
- *
- * Returns:
- * - `"new"`       — concept not yet in cache (first compile)
- * - `"unchanged"` — SHA matches; skip recompile (R12 incremental)
- * - `"changed"`   — SHA differs; trigger recompile
- */
-export function diffSHA(cache, conceptId, newSHA) {
-    const cached = cache[conceptId];
-    if (cached === undefined)
-        return "new";
-    if (cached === newSHA)
-        return "unchanged";
-    return "changed";
-}
-//# sourceMappingURL=sha-cache.js.map

package/dist/engine/compile/sha-cache.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"sha-cache.js","sourceRoot":"","sources":["../../../src/engine/compile/sha-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,8EAA8E;AAC9E,gBAAgB;AAChB,8EAA8E;AAE9E,8DAA8D;AAC9D,MAAM,UAAU,MAAM,CAAC,OAAe;IACpC,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACpE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,SAAwD;IAClF,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3E,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1E,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC;AAC1B,CAAC;AAED,8EAA8E;AAC9E,kBAAkB;AAClB,8EAA8E;AAE9E,SAAS,aAAa,CAAC,UAAkB;IACvC,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;AACjD,CAAC;AASD,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAkB;IACnD,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;QAC1C,IACE,MAAM,KAAK,IAAI;YACf,OAAO,MAAM,KAAK,QAAQ;YAC1B,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EACtB,CAAC;YACD,OAAO,MAAkB,CAAC;QAC5B,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,UAAkB,EAAE,KAAe;IACpE,MAAM,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,MAAM,SAAS,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACrF,CAAC;AAED,8EAA8E;AAC9E,OAAO;AACP,8EAA8E;AAE9E;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CACrB,KAAe,EACf,SAAiB,EACjB,MAAc;IAEd,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC;IAChC,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACvC,IAAI,MAAM,KAAK,MAAM;QAAE,OAAO,WAAW,CAAC;IAC1C,OAAO,SAAS,CAAC;AACnB,CAAC"}