oh-my-second-brain 0.1.8 → 0.2.0

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

@@ -1,71 +0,0 @@
-/**
- * Local compile types for M2.
- *
- * PARALLEL-SAFETY: These types are LOCAL to src/engine/compile/.
- * Do NOT import from the shared src/engine/types.ts (read-only per plan).
- * Do NOT touch the shared types.ts.
- */
-/** Provenance grade classifying the curation level of a material relative to the vault owner. */
-export type ProvenanceGrade = "authored" | "curated" | "external-raw";
-/** A single material item (source document) prepared for compilation. */
-export interface Material {
-    /** Vault-relative path to the source document. */
-    path: string;
-    /** Raw text content of the material. */
-    text: string;
-    /** Provenance grade, resolved from folder->grade map at setup time (not hardcoded). */
-    grade: ProvenanceGrade;
-}
-/**
- * Minimal graph view needed by the compile layer.
- * Provides backlink lookup without coupling to the full engine graph type.
- */
-export interface CompileGraph {
-    /** Return all vault-relative paths whose wiki pages link TO `docPath`. */
-    getBacklinks(docPath: string): string[];
-}
-/**
- * LLM provider injection seam.
- * Inject a real provider at runtime; use deterministicStubProvider in tests.
- * Mirrors the EmbeddingProvider injection pattern from src/engine/embed/provider.ts.
- */
-export interface LLMProvider {
-    complete(prompt: string): Promise<string>;
-}
-/** Step 1 output of nashsu 2-step CoT: analysis pass results. */
-export interface CoTStep1Result {
-    entities: string[];
-    concepts: string[];
-    arguments: string[];
-    contradictions: string[];
-    structure: string;
-}
-/** Full output of the 2-step CoT pipeline (step1 + step2 body). */
-export interface CoTResult {
-    step1: CoTStep1Result;
-    /** Synthesized Markdown body with [[wikilinks]] (from Step 2). */
-    body: string;
-}
-/** Core result produced by the stateless compile worker. */
-export interface CompileResult {
-    /** Synthesized page body (Markdown with [[wikilinks]]). Empty string signals a cache-hit skip. */
-    body: string;
-    /** SHA-256 hex digest of the input-material fingerprint. */
-    sha: string;
-    /** Provenance grades of the materials that contributed to this compile run. */
-    provenance: ProvenanceGrade[];
-}
-/** Extended compile result that includes lucasastorian cascade backlink information. */
-export interface CascadeResult extends CompileResult {
-    /** Vault paths of wiki pages that link TO the compiled concept page. */
-    affected_backlinks: string[];
-}
-/**
- * Maps a vault folder prefix (or exact path) to a provenance grade.
- * Resolved at setup time — never hardcoded with vault-specific values.
- */
-export type FolderGradeMap = Record<string, ProvenanceGrade>;
-/** Output of Phase A (extract-all-without-writing). */
-export interface PhaseAResult {
-    materials: Material[];
-}

package/dist/engine/compile/types.js

@@ -1,9 +0,0 @@
-/**
- * Local compile types for M2.
- *
- * PARALLEL-SAFETY: These types are LOCAL to src/engine/compile/.
- * Do NOT import from the shared src/engine/types.ts (read-only per plan).
- * Do NOT touch the shared types.ts.
- */
-export {};
-//# sourceMappingURL=types.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/engine/compile/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

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

@@ -1,47 +0,0 @@
-/**
- * Stateless compile worker — M2 core entry point.
- *
- * compile(opts) → CascadeResult
- *
- * Fully stateless: the only side effect is the SHA cache write to disk.
- * No daemon, no watcher, no persistent process (R2).
- *
- * Flow:
- *   1. Compute input-material fingerprint SHA.
- *   2. Load SHA cache; diff against stored SHA.
- *   3. Unchanged SHA → return skip sentinel (body = "").
- *   4. Changed / new SHA → run nashsu 2-step CoT via cot.ts.
- *   5. Enrich with lucasastorian cascade backlinks.
- *   6. Persist updated SHA to cache.
- *
- * SHA-incremental pattern: bstack `terminology` skill (self-authored, Steps 2-4).
- */
-import type { CascadeResult, CompileGraph, LLMProvider, Material } from "./types.js";
-/** Options for a single compile run. */
-export interface CompileOptions {
-    /** Human-readable concept name (used in LLM prompts). */
-    concept: string;
-    /** Pre-graded material items.  Use phaseA + applyGrades before calling compile(). */
-    materials: Material[];
-    /** Graph for cascade backlink resolution.  Use createNullGraph() when unavailable. */
-    graph: CompileGraph;
-    /** Injected LLM provider.  Use createDeterministicStub() in tests. */
-    llm: LLMProvider;
-    /** Absolute path to the .llmwiki/ dotfolder (SHA cache location). */
-    dotLlmwiki: string;
-    /** Stable concept identifier used as SHA cache key (vault-relative path recommended). */
-    conceptId: string;
-}
-/**
- * Stateless compile worker.
- *
- * Returns a CascadeResult.  If the material fingerprint SHA is unchanged
- * since the last compile, returns a skip sentinel: body === "" and
- * wasSkipped(result) === true.
- */
-export declare function compile(opts: CompileOptions): Promise<CascadeResult>;
-/**
- * Returns true if the compile output is a cache-hit skip sentinel
- * (i.e., no recompile was performed because the SHA was unchanged).
- */
-export declare function wasSkipped(output: CascadeResult): boolean;

package/dist/engine/compile/worker.js

@@ -1,75 +0,0 @@
-/**
- * Stateless compile worker — M2 core entry point.
- *
- * compile(opts) → CascadeResult
- *
- * Fully stateless: the only side effect is the SHA cache write to disk.
- * No daemon, no watcher, no persistent process (R2).
- *
- * Flow:
- *   1. Compute input-material fingerprint SHA.
- *   2. Load SHA cache; diff against stored SHA.
- *   3. Unchanged SHA → return skip sentinel (body = "").
- *   4. Changed / new SHA → run nashsu 2-step CoT via cot.ts.
- *   5. Enrich with lucasastorian cascade backlinks.
- *   6. Persist updated SHA to cache.
- *
- * SHA-incremental pattern: bstack `terminology` skill (self-authored, Steps 2-4).
- */
-import { diffSHA, fingerprint, loadSHACache, saveSHACache } from "./sha-cache.js";
-import { formatForSynthesis } from "./provenance.js";
-import { runCoT } from "./cot.js";
-import { withCascade } from "./cascade.js";
-// ---------------------------------------------------------------------------
-// Compile worker
-// ---------------------------------------------------------------------------
-/**
- * Stateless compile worker.
- *
- * Returns a CascadeResult.  If the material fingerprint SHA is unchanged
- * since the last compile, returns a skip sentinel: body === "" and
- * wasSkipped(result) === true.
- */
-export async function compile(opts) {
-    const { concept, materials, graph, llm, dotLlmwiki, conceptId } = opts;
-    // Step 1: fingerprint the input materials
-    const inputSHA = fingerprint(materials);
-    // Step 2: load cache and check for changes (R12 incremental)
-    const cache = await loadSHACache(dotLlmwiki);
-    const status = diffSHA(cache, conceptId, inputSHA);
-    if (status === "unchanged") {
-        // Skip: material is identical to the last compile; no recompile needed.
-        const skipResult = {
-            body: "",
-            sha: inputSHA,
-            provenance: materials.map((m) => m.grade),
-        };
-        // Still return cascade info so callers can inspect backlinks
-        return withCascade(skipResult, conceptId, graph);
-    }
-    // Step 3: run nashsu 2-step CoT (analysis → synthesis)
-    const formattedMaterials = formatForSynthesis(materials);
-    const cotResult = await runCoT(concept, formattedMaterials, llm);
-    const provenance = materials.map((m) => m.grade);
-    const result = {
-        body: cotResult.body,
-        sha: inputSHA,
-        provenance,
-    };
-    // Step 4: persist updated SHA before returning
-    cache[conceptId] = inputSHA;
-    await saveSHACache(dotLlmwiki, cache);
-    // Step 5: enrich with lucasastorian cascade backlinks
-    return withCascade(result, conceptId, graph);
-}
-// ---------------------------------------------------------------------------
-// Skip sentinel helper
-// ---------------------------------------------------------------------------
-/**
- * Returns true if the compile output is a cache-hit skip sentinel
- * (i.e., no recompile was performed because the SHA was unchanged).
- */
-export function wasSkipped(output) {
-    return output.body === "";
-}
-//# sourceMappingURL=worker.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../../src/engine/compile/worker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAWH,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAClF,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAsB3C,8EAA8E;AAC9E,iBAAiB;AACjB,8EAA8E;AAE9E;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAoB;IAChD,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;IAEvE,0CAA0C;IAC1C,MAAM,QAAQ,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC;IAExC,6DAA6D;IAC7D,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEnD,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAC3B,wEAAwE;QACxE,MAAM,UAAU,GAAkB;YAChC,IAAI,EAAE,EAAE;YACR,GAAG,EAAE,QAAQ;YACb,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;SAC1C,CAAC;QACF,6DAA6D;QAC7D,OAAO,WAAW,CAAC,UAAU,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACnD,CAAC;IAED,uDAAuD;IACvD,MAAM,kBAAkB,GAAG,kBAAkB,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,OAAO,EAAE,kBAAkB,EAAE,GAAG,CAAC,CAAC;IAEjE,MAAM,UAAU,GAAsB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IACpE,MAAM,MAAM,GAAkB;QAC5B,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,GAAG,EAAE,QAAQ;QACb,UAAU;KACX,CAAC;IAEF,+CAA+C;IAC/C,KAAK,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC;IAC5B,MAAM,YAAY,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IAEtC,sDAAsD;IACtD,OAAO,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;AAC/C,CAAC;AAED,8EAA8E;AAC9E,uBAAuB;AACvB,8EAA8E;AAE9E;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,MAAqB;IAC9C,OAAO,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;AAC5B,CAAC"}

package/dist/engine/distill/analyzer.d.ts

@@ -1,51 +0,0 @@
-/**
- * Red-team adversarial analyzer for distill (M4 — C6).
- *
- * Architecture mirrors M1's EmbeddingProvider injection pattern:
- * - AnalyzerProvider interface — the seam for LLM injection.
- * - createStubAnalyzerProvider() — deterministic stub for tests (no network).
- * - runAnalysis() — orchestration: prompt construction → provider call → validation.
- *
- * No hardcoded network calls. Inject a real LLM client in production;
- * inject the stub in tests and dry-run mode.
- */
-import type { CleanRoomSpec, AnalyzerResult } from "./types.js";
-/**
- * LLM provider seam for the red-team analyzer.
- *
- * Inject a stub via createStubAnalyzerProvider() for tests.
- * Inject a real LLM client (e.g. wrapping Claude API) for production.
- *
- * The provider receives a CleanRoomSpec (system prompt + user content)
- * and returns a structured AnalyzerResult.
- */
-export interface AnalyzerProvider {
-    /** Human-readable identifier for the provider (e.g. "stub" or "claude-sonnet-4"). */
-    readonly model: string;
-    /**
-     * Run adversarial analysis inside the clean-room context.
-     *
-     * The provider must:
-     * - Send systemPrompt as the system message and userContent as the user message.
-     * - Parse the LLM response as AnalyzerResult JSON.
-     * - Never mutate external state as a side-effect of this call.
-     */
-    analyze(spec: CleanRoomSpec): Promise<AnalyzerResult>;
-}
-/**
- * Run adversarial analysis using the given provider.
- *
- * Orchestrates: CleanRoomSpec → provider.analyze() → schema validation.
- * Throws if the provider returns a structurally invalid result.
- */
-export declare function runAnalysis(spec: CleanRoomSpec, provider: AnalyzerProvider): Promise<AnalyzerResult>;
-/**
- * Create a deterministic stub AnalyzerProvider for use in tests and dry-runs.
- *
- * The stub:
- * - Scans target content for known pattern keywords from the absorption ledger.
- * - Returns a structured AnalyzerResult without any network calls.
- * - Is fully deterministic: same input → same output.
- * - Never mutates external state.
- */
-export declare function createStubAnalyzerProvider(): AnalyzerProvider;

package/dist/engine/distill/analyzer.js

@@ -1,279 +0,0 @@
-/**
- * Red-team adversarial analyzer for distill (M4 — C6).
- *
- * Architecture mirrors M1's EmbeddingProvider injection pattern:
- * - AnalyzerProvider interface — the seam for LLM injection.
- * - createStubAnalyzerProvider() — deterministic stub for tests (no network).
- * - runAnalysis() — orchestration: prompt construction → provider call → validation.
- *
- * No hardcoded network calls. Inject a real LLM client in production;
- * inject the stub in tests and dry-run mode.
- */
-// ---------------------------------------------------------------------------
-// Orchestration entry-point
-// ---------------------------------------------------------------------------
-/**
- * Run adversarial analysis using the given provider.
- *
- * Orchestrates: CleanRoomSpec → provider.analyze() → schema validation.
- * Throws if the provider returns a structurally invalid result.
- */
-export async function runAnalysis(spec, provider) {
-    const raw = await provider.analyze(spec);
-    return validateResult(raw);
-}
-// ---------------------------------------------------------------------------
-// Schema validation
-// ---------------------------------------------------------------------------
-function validateResult(raw) {
-    if (!Array.isArray(raw.patterns)) {
-        throw new Error("AnalyzerResult.patterns must be an array");
-    }
-    if (!Array.isArray(raw.risks)) {
-        throw new Error("AnalyzerResult.risks must be an array");
-    }
-    if (!raw.attribution || typeof raw.attribution !== "object") {
-        throw new Error("AnalyzerResult.attribution must be an object");
-    }
-    if (typeof raw.attribution.repo !== "string") {
-        throw new Error("AnalyzerResult.attribution.repo must be a string");
-    }
-    if (typeof raw.attribution.url !== "string") {
-        throw new Error("AnalyzerResult.attribution.url must be a string");
-    }
-    if (typeof raw.attribution.license_note !== "string") {
-        throw new Error("AnalyzerResult.attribution.license_note must be a string");
-    }
-    for (const p of raw.patterns) {
-        if (typeof p.file !== "string") {
-            throw new Error("Pattern.file must be a string");
-        }
-        if (typeof p.line !== "number") {
-            throw new Error("Pattern.line must be a number");
-        }
-        if (typeof p.description !== "string") {
-            throw new Error("Pattern.description must be a string");
-        }
-        if (typeof p.absorb_confidence !== "number" ||
-            p.absorb_confidence < 0 ||
-            p.absorb_confidence > 1) {
-            throw new Error(`Pattern.absorb_confidence must be 0.0–1.0; got ${p.absorb_confidence}`);
-        }
-    }
-    for (const r of raw.risks) {
-        if (typeof r.description !== "string") {
-            throw new Error("Risk.description must be a string");
-        }
-        if (!["low", "medium", "high", "critical"].includes(r.severity)) {
-            throw new Error(`Risk.severity must be low|medium|high|critical; got ${r.severity}`);
-        }
-    }
-    return raw;
-}
-// ---------------------------------------------------------------------------
-// Deterministic stub provider
-// ---------------------------------------------------------------------------
-/**
- * Known-pattern signatures used by the stub to detect patterns without LLM.
- * Each entry carries the keyword triggers, a human description, and confidence.
- *
- * Derived from docs/research/embedding-pipeline-patterns-mining.md and
- * docs/research/graphify-graph-implementation-mining.md (absorption ledger).
- */
-const KNOWN_PATTERN_SIGNATURES = [
-    // qmd patterns (from embedding-pipeline-patterns-mining.md)
-    {
-        keywords: ["embedBatch", "Promise.all", "parallel"],
-        description: "Hardware-adaptive parallel embedding context pool (P-01) — distributes embed work across parallel LLM contexts via Promise.all",
-        absorb_confidence: 0.95,
-    },
-    {
-        keywords: ["sha256", "SHA-256", "SHA256", "sha-256", "fingerprint", "file_hash"],
-        description: "SHA-256 incremental fingerprint for change detection — skip re-embed on unchanged content",
-        absorb_confidence: 0.92,
-    },
-    {
-        keywords: ["sqlite-vec", "vec0", "sqlite_vec", "sqliteVec", "better-sqlite3"],
-        description: "sqlite-vec vec0 content-addressable store with lazy-load + 5-min unload guard",
-        absorb_confidence: 0.90,
-    },
-    {
-        keywords: ["chunkDocumentByTokens", "chunk", "token", "overlap"],
-        description: "Token-aware chunker with configurable overlap — respects heading boundaries and code-fence protection",
-        absorb_confidence: 0.88,
-    },
-    {
-        keywords: ["retryFailedChunks", "retry", "success-counter"],
-        description: "64-success-counter deferred retry pass — accumulates failures during batch, retries after threshold",
-        absorb_confidence: 0.75,
-    },
-    {
-        keywords: ["RRF", "k=60", "reciprocal rank", "rank fusion", "Reciprocal Rank"],
-        description: "RRF k=60 rank fusion — gbrain/MS-GraphRAG-parity fusion across lex/vec/hyde/graph sub-types",
-        absorb_confidence: 0.90,
-    },
-    {
-        keywords: ["lex", "vec", "hyde", "typed sub-query", "TypedSubQuery", "sub-query"],
-        description: "Typed sub-query dispatcher interface: lex | vec | hyde | graph — mirrors qmd surface",
-        absorb_confidence: 0.92,
-    },
-    // graphify patterns (from graphify-graph-implementation-mining.md)
-    {
-        keywords: ["deduplicate_entities", "dedup", "MinHash", "Jaro-Winkler", "JaroWinkler", "JW"],
-        description: "4-pass entity deduplication pipeline: exact → entropy → MinHash → Jaro-Winkler",
-        absorb_confidence: 0.88,
-    },
-    {
-        keywords: ["Leiden", "Louvain", "community", "cluster", "cohesion"],
-        description: "Leiden-first / Louvain-fallback community detection with cohesion-split escape hatch",
-        absorb_confidence: 0.85,
-    },
-    {
-        keywords: ["build_merge", "grow-only", "build_graph", "incremental"],
-        description: "Grow-only build_merge strategy — avoids re-extracting unchanged files; incremental graph update",
-        absorb_confidence: 0.82,
-    },
-    {
-        keywords: ["EXTRACTED", "INFERRED", "AMBIGUOUS", "confidence_score"],
-        description: "3-tier edge confidence classification: EXTRACTED | INFERRED | AMBIGUOUS — with numeric score",
-        absorb_confidence: 0.80,
-    },
-    {
-        keywords: [
-            "ARCHITECTURE.md",
-            "detect.py",
-            "extract.py",
-            "build.py",
-            "cluster.py",
-            "dedup.py",
-        ],
-        description: "Pipeline-as-independent-modules pattern — each stage is a single-function module with no shared mutable state",
-        absorb_confidence: 0.78,
-    },
-    {
-        keywords: ["tree-sitter", "AST", "semantic", "2-pass", "extract"],
-        description: "2-pass extraction: tree-sitter AST (structural) + LLM semantic — used for entity/relation extraction",
-        absorb_confidence: 0.76,
-    },
-    {
-        keywords: ["2-step CoT", "CoT", "step1", "step2", "analysis pass", "synthesis pass"],
-        description: "2-step Chain-of-Thought: Step 1 analysis pass (entities/concepts/contradictions) → Step 2 synthesis pass (page + wikilinks)",
-        absorb_confidence: 0.88,
-    },
-];
-/**
- * Create a deterministic stub AnalyzerProvider for use in tests and dry-runs.
- *
- * The stub:
- * - Scans target content for known pattern keywords from the absorption ledger.
- * - Returns a structured AnalyzerResult without any network calls.
- * - Is fully deterministic: same input → same output.
- * - Never mutates external state.
- */
-export function createStubAnalyzerProvider() {
-    return {
-        model: "stub",
-        async analyze(spec) {
-            return stubAnalyze(spec);
-        },
-    };
-}
-// ---------------------------------------------------------------------------
-// Stub analysis implementation
-// ---------------------------------------------------------------------------
-function stubAnalyze(spec) {
-    const content = spec.targetContent;
-    const lines = content.split("\n");
-    const patterns = detectPatterns(lines, spec.targetName);
-    const risks = detectRisks(content);
-    const attribution = extractAttribution(spec.targetName, content);
-    // Sort descending by absorb_confidence (§1 report ranking requirement)
-    patterns.sort((a, b) => b.absorb_confidence - a.absorb_confidence);
-    return { patterns, risks, attribution };
-}
-function detectPatterns(lines, targetName) {
-    const found = [];
-    const seenDescriptions = new Set();
-    for (const sig of KNOWN_PATTERN_SIGNATURES) {
-        for (const keyword of sig.keywords) {
-            const matchIdx = lines.findIndex((l) => l.includes(keyword));
-            if (matchIdx !== -1 && !seenDescriptions.has(sig.description)) {
-                seenDescriptions.add(sig.description);
-                found.push({
-                    file: guessFile(lines, matchIdx, targetName),
-                    line: matchIdx + 1,
-                    description: sig.description,
-                    absorb_confidence: sig.absorb_confidence,
-                });
-                break;
-            }
-        }
-    }
-    return found;
-}
-/** Heuristically determine a file context from surrounding lines. */
-function guessFile(lines, matchLine, targetName) {
-    // Look backwards up to 20 lines for a backtick filename or code-fence header
-    for (let i = matchLine; i >= Math.max(0, matchLine - 20); i--) {
-        const line = lines[i] ?? "";
-        const m = line.match(/`([^`]+\.[a-zA-Z]+)`/) ?? line.match(/^```(\S+)/);
-        if (m?.[1]) {
-            return m[1];
-        }
-    }
-    return targetName;
-}
-function detectRisks(content) {
-    const risks = [];
-    if (/GPL-?3\.0|GPL-3/i.test(content)) {
-        risks.push({
-            description: "GPL-3.0 licensed source — idea-only absorption required; no verbatim code copy permitted",
-            severity: "high",
-        });
-    }
-    if (/license unconfirmed|license:\s*TBD|license TBD/i.test(content)) {
-        risks.push({
-            description: "License status unconfirmed for at least one source — flag for ACKNOWLEDGMENTS and legal review before absorption",
-            severity: "medium",
-        });
-    }
-    if (/\[OPEN-BUG\]|\[OPEN-RFC\]/i.test(content)) {
-        risks.push({
-            description: "Open bugs or RFCs referenced — verify the absorbed patterns are from [SHIPPED-IN-CODE] or [MERGED] entries only",
-            severity: "medium",
-        });
-    }
-    if (/\[UNVERIFIED\]/i.test(content)) {
-        risks.push({
-            description: "[UNVERIFIED] items present in source — these must NOT be absorbed per standing rule",
-            severity: "high",
-        });
-    }
-    if (/setInterval|setTimeout|daemon|watcher|fs\.watch|chokidar/i.test(content)) {
-        risks.push({
-            description: "Stateful/persistent pattern detected (daemon/watcher/setInterval) — violates R2 stateless constraint if absorbed verbatim",
-            severity: "high",
-        });
-    }
-    if (/hardcoded|hard-coded|HARDCODED/i.test(content)) {
-        risks.push({
-            description: "Hardcoded values present — violates Non-Sticky/Vault-Agnostic principle (R16) if absorbed without parameterization",
-            severity: "medium",
-        });
-    }
-    return risks;
-}
-function extractAttribution(targetName, content) {
-    const repoMatch = content.match(/source_repo:\s*([^\n]+)/);
-    const urlMatch = content.match(/https?:\/\/[^\s\)\]]+/);
-    const licenseMatch = content.match(/^license[:\s]+([^\n]+)/im) ??
-        content.match(/MIT|Apache 2\.0|GPL-?3\.0|Apache-2|BSD/);
-    return {
-        repo: repoMatch ? repoMatch[1].trim() : targetName,
-        url: urlMatch ? urlMatch[0].replace(/[,)]+$/, "") : "",
-        license_note: licenseMatch
-            ? (licenseMatch[1] ?? licenseMatch[0]).trim()
-            : "unconfirmed — review before code absorption",
-    };
-}
-//# sourceMappingURL=analyzer.js.map

package/dist/engine/distill/analyzer.js.map

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

package/dist/engine/distill/clean-room.d.ts

@@ -1,46 +0,0 @@
-/**
- * Clean-room mechanism for distill (M4 — C6).
- *
- * Produces a CleanRoomSpec — a pure data structure describing how to invoke
- * a throwaway subagent with the target loaded as inert read-only text.
- * The actual subagent spawn is the CALLER'S responsibility.
- *
- * Design principles:
- * - Pure functions; zero side-effects on main system state (R2/R6).
- * - Target content is embedded as verbatim text; it is never executed.
- * - Mutation-detector helper: SHA snapshot before/after == no mutation.
- */
-import type { CleanRoomSpec, DistillTarget } from "./types.js";
-/**
- * Returns a SHA-256 hex digest of `content`.
- *
- * Snapshot a piece of state before a distill run with this function,
- * snapshot it again after, then call detectMutation() to confirm nothing
- * changed.
- */
-export declare function snapshotSha(content: string): string;
-/**
- * Returns true if mutation is detected (before SHA ≠ after SHA).
- * Returns false if content is unchanged — clean run, no mutation.
- *
- * Usage:
- *   const before = snapshotSha(someState);
- *   await runDistill(...);
- *   const after = snapshotSha(someState);
- *   if (detectMutation(before, after)) throw new Error("state mutated!");
- */
-export declare function detectMutation(before: string, after: string): boolean;
-/**
- * Prepare a clean-room invocation spec for the given target.
- *
- * The target content is embedded as inert read-only text — no execution,
- * no live tool calls against the target.  Main system state is never mutated.
- *
- * The returned CleanRoomSpec is a pure data structure.  Pass it to a
- * throwaway subagent to perform the actual analysis; the result comes back
- * as an AnalyzerResult JSON blob.
- *
- * @param target - The distill target to analyze.
- * @returns CleanRoomSpec — immutable, safe to inspect or log.
- */
-export declare function prepareCleanRoom(target: DistillTarget): CleanRoomSpec;