oh-my-second-brain 0.1.8 → 0.2.0

package/dist/engine/graph/community.js

@@ -1,122 +0,0 @@
-// ---------------------------------------------------------------------------
-// detectCommunities
-// ---------------------------------------------------------------------------
-/**
- * Detect communities in the document graph via weighted label propagation.
- *
- * **Algorithm (current M1 implementation):**
- * Synchronous greedy label propagation.  Each node starts with a unique label.
- * On each iteration, every node (in a deterministic shuffled order) adopts the
- * label with the highest total incident-edge weight among its neighbours; ties
- * are broken by choosing the lexicographically smallest label.  Iteration
- * stops when no label changes or `maxIterations` is reached.
- *
- * **Stability contract (for future Leiden/Louvain replacement):**
- * This function's signature and the `Community` / `CommunityOptions` types are
- * the stable public interface.  A full Leiden algorithm (Traag et al., 2019)
- * is deferred to a later milestone; the function body can be replaced without
- * changing any caller.
- *
- * Absorbed interface pattern: graphify (MIT) — label-propagation structure.
- * No verbatim code copied.
- *
- * NOTE: Full Leiden algorithm is deferred — current implementation is greedy
- * label propagation sufficient for M1.
- */
-export function detectCommunities(edges, opts = {}) {
-    const maxIterations = opts.maxIterations ?? 50;
-    const minSize = opts.minSize ?? 1;
-    // Collect all nodes (both endpoints of every edge).
-    const nodes = new Set();
-    for (const e of edges) {
-        nodes.add(e.from);
-        nodes.add(e.to);
-    }
-    if (nodes.size === 0)
-        return [];
-    // Build weighted symmetric adjacency: adjMap[u][v] = total weight.
-    const adjMap = new Map();
-    for (const node of nodes)
-        adjMap.set(node, new Map());
-    for (const e of edges) {
-        if (e.weight <= 0)
-            continue;
-        const fromAdj = adjMap.get(e.from);
-        if (fromAdj !== undefined)
-            fromAdj.set(e.to, (fromAdj.get(e.to) ?? 0) + e.weight);
-        const toAdj = adjMap.get(e.to);
-        if (toAdj !== undefined)
-            toAdj.set(e.from, (toAdj.get(e.from) ?? 0) + e.weight);
-    }
-    // Initialise: each node holds its own path as its community label.
-    const labels = new Map();
-    for (const node of nodes)
-        labels.set(node, node);
-    const nodeArr = Array.from(nodes);
-    // ── Label propagation iterations ─────────────────────────────────────────
-    for (let iter = 0; iter < maxIterations; iter++) {
-        // Deterministic per-iteration shuffle avoids ordering bias.
-        shuffleArray(nodeArr, iter);
-        let changed = false;
-        for (const node of nodeArr) {
-            const neighbours = adjMap.get(node);
-            if (!neighbours || neighbours.size === 0)
-                continue;
-            // Tally total weight per label across neighbours.
-            const tally = new Map();
-            for (const [neighbour, weight] of neighbours) {
-                const label = labels.get(neighbour);
-                if (label === undefined)
-                    continue;
-                tally.set(label, (tally.get(label) ?? 0) + weight);
-            }
-            // Select best label: highest total weight; ties broken lexicographically.
-            const currentLabel = labels.get(node) ?? node;
-            let bestLabel = currentLabel;
-            let bestWeight = tally.get(currentLabel) ?? 0;
-            for (const [label, weight] of tally) {
-                if (weight > bestWeight || (weight === bestWeight && label < bestLabel)) {
-                    bestLabel = label;
-                    bestWeight = weight;
-                }
-            }
-            if (bestLabel !== currentLabel) {
-                labels.set(node, bestLabel);
-                changed = true;
-            }
-        }
-        if (!changed)
-            break;
-    }
-    // ── Group by final label and emit Community[] ─────────────────────────────
-    const groups = new Map();
-    for (const node of nodes) {
-        const label = labels.get(node) ?? node;
-        const group = groups.get(label) ?? [];
-        group.push(node);
-        groups.set(label, group);
-    }
-    return Array.from(groups.values())
-        .filter((members) => members.length >= minSize)
-        .sort((a, b) => b.length - a.length || (a[0] ?? "").localeCompare(b[0] ?? ""))
-        .map((members, idx) => ({ id: idx, members: members.slice().sort() }));
-}
-// ---------------------------------------------------------------------------
-// Internal: deterministic per-iteration shuffle (Linear Congruential Generator)
-// ---------------------------------------------------------------------------
-/**
- * In-place Fisher-Yates shuffle with a deterministic LCG seed so that each
- * iteration uses a different but reproducible traversal order.
- */
-function shuffleArray(arr, seed) {
-    // LCG parameters (Numerical Recipes)
-    let s = (seed + 1) | 0;
-    for (let i = arr.length - 1; i > 0; i--) {
-        s = Math.imul(s, 1664525) + 1013904223;
-        const j = Math.abs(s) % (i + 1);
-        const tmp = arr[i];
-        arr[i] = arr[j];
-        arr[j] = tmp;
-    }
-}
-//# sourceMappingURL=community.js.map

package/dist/engine/graph/community.js.map

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

package/dist/engine/index.d.ts

@@ -1,5 +0,0 @@
-/**
- * Engine barrel — re-exports shared contracts now; component implementations
- * will be added incrementally (embed in M2, graph in M3, retrieval in M4).
- */
-export type { EngineConfig, ChunkerOptions, Chunk, EmbeddingProvider, ScoredHit, VectorStore, GraphEdge, GphQuery, Provenance, TypedSubQuery, RetrievalResult, } from "./types.js";

package/dist/engine/index.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=index.js.map

package/dist/engine/index.js.map

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

package/dist/engine/mcp/index.d.ts

@@ -1,15 +0,0 @@
-/**
- * Engine MCP adapter layer barrel.
- *
- * Public surface for the integrate-phase assemble step:
- *   - McpEngineAdapter    — the adapter facade (takes DispatcherDeps, never builds them)
- *   - queryOptionsToSubQueries / retrievalResultsToQueryResult — centerpiece mappers
- *   - Per-op mapper functions (sync, status, collections, contexts, cleanup, graph)
- *   - Axis-retrieve mapper functions
- *   - All mirrored MCP types (Mcp*) and engine-seam types (Engine*)
- */
-export type { McpSemanticStorage, McpSemanticSearchMode, McpSemanticSearchFormat, McpSemanticTypedSearchType, McpSemanticTypedSearch, McpStatusOptions, McpSemanticQueryOptions, McpSemanticHitEvidence, McpSemanticSearchHit, McpSemanticQueryResult, McpSemanticEmbeddingSyncOptions, McpSemanticSyncStep, McpSemanticEmbeddingSyncResult, McpSemanticModels, McpSemanticIndexDocuments, McpSemanticIndexStatus, McpSemanticProviderStatus, McpSemanticCollectionSummary, McpSemanticCollectionResult, McpSemanticStoredContext, McpSemanticContextResult, McpSemanticCleanupResult, McpGraphBuildOptions, McpGraphBuildResult, McpGraphStatusResult, McpAxisFilters, McpRetrieveContextOptions, EngineSyncArgs, EngineSyncResult, EngineStatusArgs, EngineStatusResult, EngineGraphBuildArgs, EngineGraphBuildResult, } from "./types.js";
-export { queryOptionsToSubQueries, retrievalResultsToQueryResult, queryResultUnavailable, } from "./query-mapper.js";
-export { syncOptionsToEngineArgs, engineSyncResultToMcp, syncResultUnavailable, statusOptionsToEngineArgs, capsToEngineStatusResult, engineStatusResultToMcp, statusResultUnavailable, engineStatusToCollectionResult, engineStatusToContextResult, engineSyncResultToCleanupResult, cleanupResultUnavailable, graphBuildOptionsToEngineArgs, engineGraphBuildResultToMcp, engineGraphBuildToStatusResult, } from "./op-mappers.js";
-export { axisFiltersToSubQueries, retrieveContextToSubQueries, retrievalResultsToAxisResult, } from "./retrieve-mapper.js";
-export { McpEngineAdapter } from "./facade.js";

package/dist/engine/mcp/index.js

@@ -1,19 +0,0 @@
-/**
- * Engine MCP adapter layer barrel.
- *
- * Public surface for the integrate-phase assemble step:
- *   - McpEngineAdapter    — the adapter facade (takes DispatcherDeps, never builds them)
- *   - queryOptionsToSubQueries / retrievalResultsToQueryResult — centerpiece mappers
- *   - Per-op mapper functions (sync, status, collections, contexts, cleanup, graph)
- *   - Axis-retrieve mapper functions
- *   - All mirrored MCP types (Mcp*) and engine-seam types (Engine*)
- */
-// Centerpiece: oms_semantic_query mappers
-export { queryOptionsToSubQueries, retrievalResultsToQueryResult, queryResultUnavailable, } from "./query-mapper.js";
-// Per-op mappers (sync, status, collections, contexts, cleanup, graph)
-export { syncOptionsToEngineArgs, engineSyncResultToMcp, syncResultUnavailable, statusOptionsToEngineArgs, capsToEngineStatusResult, engineStatusResultToMcp, statusResultUnavailable, engineStatusToCollectionResult, engineStatusToContextResult, engineSyncResultToCleanupResult, cleanupResultUnavailable, graphBuildOptionsToEngineArgs, engineGraphBuildResultToMcp, engineGraphBuildToStatusResult, } from "./op-mappers.js";
-// Axis-retrieve mappers
-export { axisFiltersToSubQueries, retrieveContextToSubQueries, retrievalResultsToAxisResult, } from "./retrieve-mapper.js";
-// Adapter facade
-export { McpEngineAdapter } from "./facade.js";
-//# sourceMappingURL=index.js.map

package/dist/engine/mcp/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAuCH,0CAA0C;AAC1C,OAAO,EACL,wBAAwB,EACxB,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,uEAAuE;AACvE,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,qBAAqB,EACrB,yBAAyB,EACzB,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,8BAA8B,EAC9B,2BAA2B,EAC3B,+BAA+B,EAC/B,wBAAwB,EACxB,6BAA6B,EAC7B,2BAA2B,EAC3B,8BAA8B,GAC/B,MAAM,iBAAiB,CAAC;AAEzB,wBAAwB;AACxB,OAAO,EACL,uBAAuB,EACvB,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,sBAAsB,CAAC;AAE9B,iBAAiB;AACjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/engine/mcp/retrieve-mapper.d.ts

@@ -1,38 +0,0 @@
-/**
- * Request/response mappers for axis-based retrieval ops:
- *   oms_retrieve_by_axis  — axis-first narrowing with optional lex query.
- *   oms_retrieve_context  — axis narrowing + semantic fan-out.
- *
- * Both ops reduce to TypedSubQuery[] fan-outs:
- *   - Axis fields (concept/folder/wikilink/property+value) → "lex" sub-query.
- *   - Optional free-text `query` → "vec" sub-query.
- *   - Optional `semanticSearches` (oms_retrieve_context only) → typed sub-queries.
- *
- * The facade calls dispatch() on the combined list and maps results back through
- * retrievalResultsToAxisResult.
- *
- * R18: NO import from src/search.
- */
-import type { TypedSubQuery, RetrievalResult } from "../types.js";
-import type { McpAxisFilters, McpRetrieveContextOptions, McpSemanticQueryResult } from "./types.js";
-/**
- * Map McpAxisFilters (oms_retrieve_by_axis) → TypedSubQuery[].
- *
- * Axis filters are composed into a single "lex" query string; the optional
- * free-text `query` adds a "vec" sub-query for semantic ranking.
- */
-export declare function axisFiltersToSubQueries(filters: McpAxisFilters): TypedSubQuery[];
-/**
- * Map McpRetrieveContextOptions (oms_retrieve_context) → TypedSubQuery[].
- *
- * Extends axisFiltersToSubQueries with optional semanticSearches fan-out.
- * Deduplicates by keeping the order: axis-lex → axis-vec → semantic.
- */
-export declare function retrieveContextToSubQueries(opts: McpRetrieveContextOptions): TypedSubQuery[];
-/**
- * Map engine RetrievalResult[] → McpSemanticQueryResult for axis retrieve ops.
- *
- * Shares the same shape as the query-mapper response, but limit is applied
- * directly (no minScore on axis ops — axis narrowing already constrains set).
- */
-export declare function retrievalResultsToAxisResult(results: readonly RetrievalResult[], limit?: number): McpSemanticQueryResult;

package/dist/engine/mcp/retrieve-mapper.js

@@ -1,96 +0,0 @@
-/**
- * Request/response mappers for axis-based retrieval ops:
- *   oms_retrieve_by_axis  — axis-first narrowing with optional lex query.
- *   oms_retrieve_context  — axis narrowing + semantic fan-out.
- *
- * Both ops reduce to TypedSubQuery[] fan-outs:
- *   - Axis fields (concept/folder/wikilink/property+value) → "lex" sub-query.
- *   - Optional free-text `query` → "vec" sub-query.
- *   - Optional `semanticSearches` (oms_retrieve_context only) → typed sub-queries.
- *
- * The facade calls dispatch() on the combined list and maps results back through
- * retrievalResultsToAxisResult.
- *
- * R18: NO import from src/search.
- */
-// ---------------------------------------------------------------------------
-// Request mappers
-// ---------------------------------------------------------------------------
-/**
- * Map McpAxisFilters (oms_retrieve_by_axis) → TypedSubQuery[].
- *
- * Axis filters are composed into a single "lex" query string; the optional
- * free-text `query` adds a "vec" sub-query for semantic ranking.
- */
-export function axisFiltersToSubQueries(filters) {
-    const parts = [];
-    if (filters.concept !== undefined && filters.concept.length > 0) {
-        parts.push(`concept:${filters.concept}`);
-    }
-    if (filters.folder !== undefined && filters.folder.length > 0) {
-        parts.push(`folder:${filters.folder}`);
-    }
-    if (filters.wikilink !== undefined && filters.wikilink.length > 0) {
-        parts.push(`wikilink:${filters.wikilink}`);
-    }
-    if (filters.property !== undefined &&
-        filters.property.length > 0 &&
-        filters.value !== undefined &&
-        filters.value.length > 0) {
-        parts.push(`${filters.property}:${filters.value}`);
-    }
-    const subQueries = [];
-    if (parts.length > 0) {
-        subQueries.push({ type: "lex", query: parts.join(" ") });
-    }
-    if (filters.query !== undefined && filters.query.length > 0) {
-        subQueries.push({ type: "vec", query: filters.query });
-    }
-    // Fallback: if no axis parts but a free-text query exists, lex-search on it.
-    if (subQueries.length === 0 && filters.query !== undefined && filters.query.length > 0) {
-        subQueries.push({ type: "lex", query: filters.query });
-    }
-    return subQueries;
-}
-/**
- * Map McpRetrieveContextOptions (oms_retrieve_context) → TypedSubQuery[].
- *
- * Extends axisFiltersToSubQueries with optional semanticSearches fan-out.
- * Deduplicates by keeping the order: axis-lex → axis-vec → semantic.
- */
-export function retrieveContextToSubQueries(opts) {
-    const base = axisFiltersToSubQueries(opts);
-    if (opts.semanticSearches === undefined || opts.semanticSearches.length === 0) {
-        return base;
-    }
-    const semantic = opts.semanticSearches.map((s) => ({
-        type: s.type,
-        query: s.query,
-    }));
-    return [...base, ...semantic];
-}
-// ---------------------------------------------------------------------------
-// Response mapper
-// ---------------------------------------------------------------------------
-/**
- * Map engine RetrievalResult[] → McpSemanticQueryResult for axis retrieve ops.
- *
- * Shares the same shape as the query-mapper response, but limit is applied
- * directly (no minScore on axis ops — axis narrowing already constrains set).
- */
-export function retrievalResultsToAxisResult(results, limit) {
-    const hits = limit !== undefined ? results.slice(0, limit) : results;
-    const searchHits = hits.map((r) => ({
-        docid: r.docPath,
-        score: r.score,
-        uri: `vault://${r.docPath}`,
-        path: r.docPath,
-        snippet: "",
-        evidence: {
-            lexical: (r.perTypeScores?.["lex"] ?? 0) > 0,
-            vector: (r.perTypeScores?.["vec"] ?? 0) > 0 || (r.perTypeScores?.["hyde"] ?? 0) > 0,
-        },
-    }));
-    return { available: true, hits: searchHits };
-}
-//# sourceMappingURL=retrieve-mapper.js.map

package/dist/engine/mcp/retrieve-mapper.js.map

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

package/dist/engine/setup/ambiguity.d.ts

@@ -1,39 +0,0 @@
-/**
- * Ambiguity scoring for the Socratic setup interview.
- *
- * Self-reimplementation of the omc deep-interview methodology — method only, no code copied.
- * Formula: ambiguity = 1 − mean(goal, constraint, criteria, context)
- */
-import type { DimensionScore, InterviewConfig } from "./types.js";
-/**
- * Compute ambiguity from a set of scoring sub-dimensions.
- *
- * ambiguity = 1 − mean(goal, constraint, criteria, context)
- *
- * Returns a value in [0, 1]:
- *   0 — fully resolved (no ambiguity)
- *   1 — completely ambiguous (no sub-dimension scored)
- *
- * Returns 1 if scores is empty (worst-case: treat unknown as maximally ambiguous).
- */
-export declare function computeAmbiguity(scores: DimensionScore): number;
-/**
- * Returns true when a dimension's ambiguity is at or below the configured threshold —
- * i.e. the dimension is resolved enough to proceed to the challenge phase.
- */
-export declare function meetsThreshold(scores: DimensionScore, config: Pick<InterviewConfig, "ambiguityThreshold">): boolean;
-/** Validation error for a single sub-dimension. */
-export interface ScoreValidationError {
-    subDimension: string;
-    message: string;
-}
-/** Result of validating a DimensionScore. */
-export interface ScoreValidationResult {
-    valid: boolean;
-    errors: ScoreValidationError[];
-}
-/**
- * Validate that all four scoring sub-dimensions are present and in [0, 1].
- * Returns a typed validation result (never throws).
- */
-export declare function validateScores(scores: DimensionScore): ScoreValidationResult;

package/dist/engine/setup/ambiguity.js

@@ -1,50 +0,0 @@
-/**
- * Ambiguity scoring for the Socratic setup interview.
- *
- * Self-reimplementation of the omc deep-interview methodology — method only, no code copied.
- * Formula: ambiguity = 1 − mean(goal, constraint, criteria, context)
- */
-/**
- * Compute ambiguity from a set of scoring sub-dimensions.
- *
- * ambiguity = 1 − mean(goal, constraint, criteria, context)
- *
- * Returns a value in [0, 1]:
- *   0 — fully resolved (no ambiguity)
- *   1 — completely ambiguous (no sub-dimension scored)
- *
- * Returns 1 if scores is empty (worst-case: treat unknown as maximally ambiguous).
- */
-export function computeAmbiguity(scores) {
-    const values = Object.values(scores);
-    if (values.length === 0)
-        return 1;
-    const mean = values.reduce((sum, v) => sum + v, 0) / values.length;
-    return 1 - mean;
-}
-/**
- * Returns true when a dimension's ambiguity is at or below the configured threshold —
- * i.e. the dimension is resolved enough to proceed to the challenge phase.
- */
-export function meetsThreshold(scores, config) {
-    return computeAmbiguity(scores) <= config.ambiguityThreshold;
-}
-/**
- * Validate that all four scoring sub-dimensions are present and in [0, 1].
- * Returns a typed validation result (never throws).
- */
-export function validateScores(scores) {
-    const required = ["goal", "constraint", "criteria", "context"];
-    const errors = [];
-    for (const key of required) {
-        const val = scores[key];
-        if (typeof val !== "number" || Number.isNaN(val) || val < 0 || val > 1) {
-            errors.push({
-                subDimension: key,
-                message: `must be a finite number in [0, 1], got ${val}`,
-            });
-        }
-    }
-    return { valid: errors.length === 0, errors };
-}
-//# sourceMappingURL=ambiguity.js.map

package/dist/engine/setup/ambiguity.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"ambiguity.js","sourceRoot":"","sources":["../../../src/engine/setup/ambiguity.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAsB;IACrD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAa,CAAC;IACjD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACnE,OAAO,CAAC,GAAG,IAAI,CAAC;AAClB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,MAAsB,EACtB,MAAmD;IAEnD,OAAO,gBAAgB,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,kBAAkB,CAAC;AAC/D,CAAC;AAcD;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAsB;IACnD,MAAM,QAAQ,GAAgC,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,CAAC,CAAC;IAC5F,MAAM,MAAM,GAA2B,EAAE,CAAC;IAE1C,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QACxB,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,EAAE,CAAC;YACvE,MAAM,CAAC,IAAI,CAAC;gBACV,YAAY,EAAE,GAAG;gBACjB,OAAO,EAAE,0CAA0C,GAAG,EAAE;aACzD,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC"}

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

@@ -1,71 +0,0 @@
-/**
- * Local setup types for M5 Socratic setup interview.
- *
- * PARALLEL-SAFETY: These types are LOCAL to src/engine/setup/.
- * Do NOT import from src/engine/types.ts (read-only per plan).
- * Do NOT import from src/engine/{embed,graph,retrieval,index,compile,distill,wiki}/ (read-only per R18).
- */
-/**
- * The four Socratic scoring sub-dimensions.
- * Self-reimplemented from the omc deep-interview methodology — method only, no code copied.
- */
-export type ScoringSubDimension = "goal" | "constraint" | "criteria" | "context";
-/**
- * Score map across all four scoring sub-dimensions.
- * Each value is in [0, 1] — 1 means fully resolved, 0 means completely ambiguous.
- */
-export type DimensionScore = Record<ScoringSubDimension, number>;
-/** The exactly 6 binding dimensions resolved by the setup interview. */
-export type BindingDimension = "tier_folder_mapping" | "provenance_grade_mapping" | "lint_schema_ssot" | "embedder_selection" | "ignore_for_external_apis" | "agent_writable_zone";
-/** All 6 binding dimensions in canonical order (D1–D6). */
-export declare const BINDING_DIMENSIONS: readonly BindingDimension[];
-/** Configuration for the Socratic interview loop. */
-export interface InterviewConfig {
-    /**
-     * Ambiguity threshold below which a dimension is considered resolved.
-     * Default: 0.20 (5% below this = confidently resolved).
-     */
-    ambiguityThreshold: number;
-    /** Maximum Socratic exchange rounds per binding dimension. Default: 5. */
-    maxRoundsPerDimension: number;
-}
-/** Default interview configuration. Threshold and max rounds are configurable. */
-export declare const DEFAULT_INTERVIEW_CONFIG: InterviewConfig;
-/** Canonical tier for a vault folder (D1). */
-export type Tier = "raw" | "processed" | "wiki";
-/** Provenance grade for a vault folder (D2). */
-export type ProvenanceGrade = "authored" | "curated" | "external-raw";
-/** Resolved folder entry combining D1 (tier) and D2 (provenance). */
-export interface FolderMapping {
-    intent: string;
-    tier: Tier;
-    provenance: ProvenanceGrade;
-    concept: string | null;
-}
-/** Lint schema SSOT location (D3). */
-export type LintSchemaSSOT = "engine_default" | "vault_override";
-/** Embedder provider options (D4). */
-export type EmbedderProvider = "local" | "openai" | "stub";
-/** Write routing law for agent-writable zone (D6). */
-export type WriteRoutingLaw = "append_only" | "overwrite_allowed" | "create_only";
-/**
- * The fully-resolved taxonomy output of the setup interview.
- *
- * Non-Sticky Guard (HARD): this value is written ONLY to vault/.oms/taxonomy.yaml.
- * NEVER written to core/ontology/taxonomy.yaml or any engine path.
- * See src/engine/setup/writer.ts for enforcement.
- */
-export interface TaxonomyOutput {
-    version: 1;
-    folders: Record<string, FolderMapping>;
-    lint: {
-        schema_ssot: LintSchemaSSOT;
-    };
-    embedder: {
-        provider: EmbedderProvider;
-        model: string;
-    };
-    ignore_for_external_apis: string[];
-    agent_writable_zone: string[];
-    write_routing_law: WriteRoutingLaw;
-}

package/dist/engine/setup/types.js

@@ -1,22 +0,0 @@
-/**
- * Local setup types for M5 Socratic setup interview.
- *
- * PARALLEL-SAFETY: These types are LOCAL to src/engine/setup/.
- * Do NOT import from src/engine/types.ts (read-only per plan).
- * Do NOT import from src/engine/{embed,graph,retrieval,index,compile,distill,wiki}/ (read-only per R18).
- */
-/** All 6 binding dimensions in canonical order (D1–D6). */
-export const BINDING_DIMENSIONS = [
-    "tier_folder_mapping",
-    "provenance_grade_mapping",
-    "lint_schema_ssot",
-    "embedder_selection",
-    "ignore_for_external_apis",
-    "agent_writable_zone",
-];
-/** Default interview configuration. Threshold and max rounds are configurable. */
-export const DEFAULT_INTERVIEW_CONFIG = {
-    ambiguityThreshold: 0.2,
-    maxRoundsPerDimension: 5,
-};
-//# sourceMappingURL=types.js.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/engine/setup/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuBH,2DAA2D;AAC3D,MAAM,CAAC,MAAM,kBAAkB,GAAgC;IAC7D,qBAAqB;IACrB,0BAA0B;IAC1B,kBAAkB;IAClB,oBAAoB;IACpB,0BAA0B;IAC1B,qBAAqB;CACb,CAAC;AAaX,kFAAkF;AAClF,MAAM,CAAC,MAAM,wBAAwB,GAAoB;IACvD,kBAAkB,EAAE,GAAG;IACvB,qBAAqB,EAAE,CAAC;CAChB,CAAC"}

package/dist/engine/setup/writer.d.ts

@@ -1,32 +0,0 @@
-/**
- * Non-Sticky Guard: taxonomy output writer.
- *
- * HARD CONSTRAINT: writes ONLY to vault/.oms/taxonomy.yaml.
- * Writing to core/ontology/taxonomy.yaml or any engine path is FORBIDDEN.
- * This constraint is enforced by construction — the path is always derived
- * from vaultRoot and validated before any disk I/O.
- *
- * Self-reimplementation of the omc deep-interview methodology — no code copied.
- */
-import type { TaxonomyOutput } from "./types.js";
-/**
- * Resolve the canonical vault override path: `{vaultRoot}/.oms/taxonomy.yaml`.
- *
- * Enforces path confinement: the resolved path must start with the `.oms` dir
- * inside vaultRoot. Throws if path traversal is detected.
- */
-export declare function resolveVaultOverridePath(vaultRoot: string): string;
-/**
- * Write the resolved taxonomy output to `{vaultRoot}/.oms/taxonomy.yaml`.
- *
- * Non-Sticky Guard is enforced by construction:
- *   1. resolveVaultOverridePath() confines the target to {vaultRoot}/.oms/.
- *   2. guardAgainstEngineDefault() rejects any path matching the engine default.
- *   3. Only after both checks pass does disk I/O proceed.
- *
- * Merges with any existing file — keys not present in `data` are preserved.
- * Always sets `version: 1`.
- *
- * Returns the absolute path that was written.
- */
-export declare function writeTaxonomyToVaultOverride(vaultRoot: string, data: TaxonomyOutput): Promise<string>;

package/dist/engine/setup/writer.js

@@ -1,77 +0,0 @@
-/**
- * Non-Sticky Guard: taxonomy output writer.
- *
- * HARD CONSTRAINT: writes ONLY to vault/.oms/taxonomy.yaml.
- * Writing to core/ontology/taxonomy.yaml or any engine path is FORBIDDEN.
- * This constraint is enforced by construction — the path is always derived
- * from vaultRoot and validated before any disk I/O.
- *
- * Self-reimplementation of the omc deep-interview methodology — no code copied.
- */
-import { mkdir, readFile, writeFile } from "node:fs/promises";
-import path from "node:path";
-import { stringify as yamlStringify, parse as yamlParse } from "yaml";
-/** Relative path from vault root to the override file (always this, never engine default). */
-const VAULT_OVERRIDE_RELATIVE = path.join(".oms", "taxonomy.yaml");
-/**
- * Resolve the canonical vault override path: `{vaultRoot}/.oms/taxonomy.yaml`.
- *
- * Enforces path confinement: the resolved path must start with the `.oms` dir
- * inside vaultRoot. Throws if path traversal is detected.
- */
-export function resolveVaultOverridePath(vaultRoot) {
-    const omsDir = path.resolve(vaultRoot, ".oms");
-    const target = path.resolve(vaultRoot, VAULT_OVERRIDE_RELATIVE);
-    // Confinement check: target must be inside {vaultRoot}/.oms/
-    if (!target.startsWith(omsDir + path.sep) && target !== omsDir) {
-        throw new Error(`[Non-Sticky Guard] Resolved path "${target}" escapes the vault override zone "${omsDir}". Write refused.`);
-    }
-    return target;
-}
-/**
- * Guard: throw if targetPath matches the engine default fragment.
- * Called before any disk write.
- */
-function guardAgainstEngineDefault(targetPath) {
-    // Normalise to forward slashes for cross-platform fragment matching.
-    const normalised = targetPath.replace(/\\/g, "/");
-    if (normalised.includes("core/ontology/taxonomy.yaml")) {
-        throw new Error(`[Non-Sticky Guard] Writing to engine default "core/ontology/taxonomy.yaml" is FORBIDDEN. ` +
-            `Use vault/.oms/taxonomy.yaml instead.`);
-    }
-}
-/**
- * Write the resolved taxonomy output to `{vaultRoot}/.oms/taxonomy.yaml`.
- *
- * Non-Sticky Guard is enforced by construction:
- *   1. resolveVaultOverridePath() confines the target to {vaultRoot}/.oms/.
- *   2. guardAgainstEngineDefault() rejects any path matching the engine default.
- *   3. Only after both checks pass does disk I/O proceed.
- *
- * Merges with any existing file — keys not present in `data` are preserved.
- * Always sets `version: 1`.
- *
- * Returns the absolute path that was written.
- */
-export async function writeTaxonomyToVaultOverride(vaultRoot, data) {
-    const targetPath = resolveVaultOverridePath(vaultRoot);
-    guardAgainstEngineDefault(targetPath);
-    // Read existing file if present, then shallow-merge (data wins on conflict).
-    let merged = {};
-    try {
-        const existing = await readFile(targetPath, "utf8");
-        const parsed = yamlParse(existing);
-        if (parsed && typeof parsed === "object" && !Array.isArray(parsed)) {
-            merged = parsed;
-        }
-    }
-    catch {
-        // File does not exist yet — start from empty.
-    }
-    // Spread data over existing, always forcing version: 1.
-    const output = { ...merged, ...data, version: 1 };
-    await mkdir(path.dirname(targetPath), { recursive: true });
-    await writeFile(targetPath, yamlStringify(output, { lineWidth: 120 }), "utf8");
-    return targetPath;
-}
-//# sourceMappingURL=writer.js.map

package/dist/engine/setup/writer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"writer.js","sourceRoot":"","sources":["../../../src/engine/setup/writer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAGtE,8FAA8F;AAC9F,MAAM,uBAAuB,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;AAEnE;;;;;GAKG;AACH,MAAM,UAAU,wBAAwB,CAAC,SAAiB;IACxD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,uBAAuB,CAAC,CAAC;IAEhE,6DAA6D;IAC7D,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CACb,qCAAqC,MAAM,sCAAsC,MAAM,mBAAmB,CAC3G,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,SAAS,yBAAyB,CAAC,UAAkB;IACnD,qEAAqE;IACrE,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAClD,IAAI,UAAU,CAAC,QAAQ,CAAC,6BAA6B,CAAC,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CACb,2FAA2F;YACzF,uCAAuC,CAC1C,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,SAAiB,EACjB,IAAoB;IAEpB,MAAM,UAAU,GAAG,wBAAwB,CAAC,SAAS,CAAC,CAAC;IACvD,yBAAyB,CAAC,UAAU,CAAC,CAAC;IAEtC,6EAA6E;IAC7E,IAAI,MAAM,GAA4B,EAAE,CAAC;IACzC,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;QACpD,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QACnC,IAAI,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YACnE,MAAM,GAAG,MAAiC,CAAC;QAC7C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,8CAA8C;IAChD,CAAC;IAED,wDAAwD;IACxD,MAAM,MAAM,GAA4B,EAAE,GAAG,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAE3E,MAAM,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3D,MAAM,SAAS,CAAC,UAAU,EAAE,aAAa,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC;IAE/E,OAAO,UAAU,CAAC;AACpB,CAAC"}