onto-mcp 0.3.2 → 0.4.0

package/dist/core-runtime/readers/lexicon-citation-check.test.js

@@ -1,77 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { checkFileCitations, checkMultipleFiles, hasRejectViolations, } from "./lexicon-citation-check.js";
-const TERMS = [
-    { term_id: "governance_pipeline", lifecycle_status: "seed" },
-    { term_id: "drift_detector", lifecycle_status: "candidate" },
-    { term_id: "approval_queue", lifecycle_status: "provisional" },
-    { term_id: "review_record", lifecycle_status: "promoted" },
-];
-describe("lexicon-citation-check", () => {
-    // ─── Case 1: warn ───
-    it("seed/candidate/provisional term 인용 시 warn 위반을 보고한다", () => {
-        const content = [
-            "# Design Document",
-            "",
-            "이 설계는 governance_pipeline 을 기반으로 한다.",
-            "drift_detector 가 변경을 감지하면 approval_queue 에 등록된다.",
-        ].join("\n");
-        const violations = checkFileCitations(".onto/principles/example.md", content, TERMS, { severity: "warn" });
-        expect(violations).toHaveLength(3);
-        expect(violations.every((v) => v.severity === "warn")).toBe(true);
-        const termIds = violations.map((v) => v.term_id).sort();
-        expect(termIds).toEqual(["approval_queue", "drift_detector", "governance_pipeline"]);
-        // line 번호 확인
-        const seedViolation = violations.find((v) => v.term_id === "governance_pipeline");
-        expect(seedViolation.line).toBe(3);
-    });
-    // ─── Case 2: reject ───
-    it("reject severity 설정 시 reject 위반을 보고한다", () => {
-        const content = "drift_detector 를 사용합니다.";
-        const violations = checkFileCitations(".onto/processes/reconstruct.md", content, TERMS, { severity: "reject" });
-        expect(violations).toHaveLength(1);
-        expect(violations[0].severity).toBe("reject");
-        expect(hasRejectViolations(violations)).toBe(true);
-    });
-    // ─── Case 3: authority file bypass ───
-    it("authority file (core-lexicon.yaml) 내 참조는 위반으로 보고하지 않는다", () => {
-        const content = [
-            "provisional_terms:",
-            "  governance_pipeline:",
-            "    lifecycle_status: seed",
-            "  drift_detector:",
-            "    lifecycle_status: candidate",
-        ].join("\n");
-        const violations = checkFileCitations(".onto/authority/core-lexicon.yaml", content, TERMS);
-        expect(violations).toEqual([]);
-    });
-    // ─── promoted term 은 위반이 아님 ───
-    it("promoted term 인용은 위반으로 보고하지 않는다", () => {
-        const content = "review_record 를 참조한다.";
-        const violations = checkFileCitations(".onto/processes/review.md", content, TERMS);
-        expect(violations).toEqual([]);
-    });
-    // ─── 단어 경계 (부분 매칭 방지) ───
-    it("term_id 의 부분 매칭은 위반으로 보고하지 않는다", () => {
-        // "governance_pipeline_v2" 는 "governance_pipeline" 과 다른 토큰
-        const content = "governance_pipeline_v2 는 별개 식별자이다.";
-        const violations = checkFileCitations("docs/example.md", content, TERMS);
-        expect(violations).toEqual([]);
-    });
-    // ─── 복수 파일 검사 ───
-    it("checkMultipleFiles 로 복수 파일을 한번에 검사한다", () => {
-        const files = [
-            { path: "a.md", content: "governance_pipeline 사용" },
-            { path: ".onto/authority/core-lexicon.yaml", content: "governance_pipeline 정의" },
-            { path: "b.ts", content: "drift_detector 참조" },
-        ];
-        const violations = checkMultipleFiles(files, TERMS);
-        // a.md + b.ts = 2건 (core-lexicon.yaml 은 bypass)
-        expect(violations).toHaveLength(2);
-        expect(violations.map((v) => v.file).sort()).toEqual(["a.md", "b.ts"]);
-    });
-    // ─── hasRejectViolations ───
-    it("warn 만 있으면 hasRejectViolations 는 false", () => {
-        const violations = checkFileCitations("docs/test.md", "governance_pipeline 사용", TERMS, { severity: "warn" });
-        expect(hasRejectViolations(violations)).toBe(false);
-    });
-});

package/dist/core-runtime/readers/mcp-figma.js

@@ -1,30 +0,0 @@
-import { sourceKey, emptyScanResult } from "./types.js";
-export function figmaSourceHashKey(source) {
-    return sourceKey(source);
-}
-export function figmaSourceHash(source, lastModified) {
-    return { key: sourceKey(source), value: lastModified };
-}
-export function scanFigmaMcp(source) {
-    return emptyScanResult(source);
-}
-export function recordFigmaGrounding(source, payload) {
-    const base = emptyScanResult(source);
-    const key = sourceKey(source);
-    return {
-        ...base,
-        content_hashes: { [key]: payload.lastModified },
-        doc_structure: [
-            {
-                file: key,
-                format: "json",
-                frontmatter: {
-                    lastModified: payload.lastModified,
-                    ...(payload.fileName !== undefined ? { fileName: payload.fileName } : {}),
-                    ...(payload.nodeCount !== undefined ? { nodeCount: payload.nodeCount } : {}),
-                    ...(payload.pageCount !== undefined ? { pageCount: payload.pageCount } : {}),
-                },
-            },
-        ],
-    };
-}

package/dist/core-runtime/readers/mcp-figma.test.js

@@ -1,82 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { figmaSourceHashKey, figmaSourceHash, scanFigmaMcp, recordFigmaGrounding, } from "./mcp-figma.js";
-function makeSource(fileKey) {
-    return { type: "figma-mcp", file_key: fileKey };
-}
-describe("figmaSourceHashKey", () => {
-    it("returns key in 'figma-mcp:{file_key}' format", () => {
-        expect(figmaSourceHashKey(makeSource("abc123"))).toBe("figma-mcp:abc123");
-    });
-    it("handles file_key with special characters", () => {
-        expect(figmaSourceHashKey(makeSource("XyZ_0-9"))).toBe("figma-mcp:XyZ_0-9");
-    });
-    it("handles empty file_key", () => {
-        expect(figmaSourceHashKey(makeSource(""))).toBe("figma-mcp:");
-    });
-    it("produces consistent keys across multiple calls", () => {
-        const source = makeSource("consistent-key");
-        expect(figmaSourceHashKey(source)).toBe(figmaSourceHashKey(source));
-    });
-});
-describe("figmaSourceHash", () => {
-    it("returns correct { key, value } pair", () => {
-        expect(figmaSourceHash(makeSource("file123"), "2024-01-15T10:30:00Z")).toEqual({
-            key: "figma-mcp:file123",
-            value: "2024-01-15T10:30:00Z",
-        });
-    });
-    it("key matches figmaSourceHashKey output", () => {
-        const source = makeSource("match-test");
-        expect(figmaSourceHash(source, "2024-06-01T00:00:00Z").key).toBe(figmaSourceHashKey(source));
-    });
-    it("preserves lastModified value exactly", () => {
-        const timestamp = "2025-12-31T23:59:59.999Z";
-        expect(figmaSourceHash(makeSource("ts-test"), timestamp).value).toBe(timestamp);
-    });
-});
-describe("scanFigmaMcp", () => {
-    it("returns an empty ScanResult bound to the source", () => {
-        const source = makeSource("empty-scan");
-        const result = scanFigmaMcp(source);
-        expect(result.source).toEqual(source);
-        expect(result.files).toEqual([]);
-        expect(result.content_hashes).toEqual({});
-        expect(result.dependency_graph).toEqual([]);
-        expect(result.doc_structure).toEqual([]);
-        expect(typeof result.scanned_at).toBe("string");
-    });
-});
-describe("recordFigmaGrounding", () => {
-    it("populates content_hashes with lastModified under the source key", () => {
-        const source = makeSource("grounding-1");
-        const result = recordFigmaGrounding(source, { lastModified: "2026-04-14T00:00:00Z" });
-        expect(result.content_hashes).toEqual({
-            "figma-mcp:grounding-1": "2026-04-14T00:00:00Z",
-        });
-    });
-    it("records optional metadata into doc_structure frontmatter", () => {
-        const source = makeSource("meta");
-        const result = recordFigmaGrounding(source, {
-            lastModified: "2026-04-14T00:00:00Z",
-            fileName: "Design System",
-            nodeCount: 42,
-            pageCount: 3,
-        });
-        expect(result.doc_structure).toHaveLength(1);
-        const entry = result.doc_structure[0];
-        expect(entry.file).toBe("figma-mcp:meta");
-        expect(entry.format).toBe("json");
-        expect(entry.frontmatter).toEqual({
-            lastModified: "2026-04-14T00:00:00Z",
-            fileName: "Design System",
-            nodeCount: 42,
-            pageCount: 3,
-        });
-    });
-    it("omits undefined optional fields from frontmatter", () => {
-        const source = makeSource("minimal");
-        const result = recordFigmaGrounding(source, { lastModified: "2026-04-14T00:00:00Z" });
-        const entry = result.doc_structure[0];
-        expect(entry.frontmatter).toEqual({ lastModified: "2026-04-14T00:00:00Z" });
-    });
-});

package/dist/core-runtime/readers/mcp-generic.js

@@ -1,31 +0,0 @@
-import { sourceKey, emptyScanResult } from "./types.js";
-export function genericMcpSourceHashKey(source) {
-    return sourceKey(source);
-}
-export function genericMcpSourceHash(source, responseDigest) {
-    return { key: sourceKey(source), value: responseDigest };
-}
-export function scanGenericMcp(source) {
-    return emptyScanResult(source);
-}
-export function recordGenericMcpGrounding(source, payload) {
-    const base = emptyScanResult(source);
-    const key = sourceKey(source);
-    return {
-        ...base,
-        content_hashes: { [key]: payload.responseDigest },
-        doc_structure: [
-            {
-                file: key,
-                format: "json",
-                frontmatter: {
-                    provider: source.provider,
-                    responseDigest: payload.responseDigest,
-                    ...(payload.toolsSeen !== undefined ? { toolsSeen: payload.toolsSeen } : {}),
-                    ...(payload.sampleCount !== undefined ? { sampleCount: payload.sampleCount } : {}),
-                    ...(payload.retrievedAt !== undefined ? { retrievedAt: payload.retrievedAt } : {}),
-                },
-            },
-        ],
-    };
-}

package/dist/core-runtime/readers/mcp-generic.test.js

@@ -1,76 +0,0 @@
-import { describe, it, expect } from "vitest";
-import { genericMcpSourceHashKey, genericMcpSourceHash, scanGenericMcp, recordGenericMcpGrounding, } from "./mcp-generic.js";
-function makeSource(provider) {
-    return { type: "mcp", provider };
-}
-describe("genericMcpSourceHashKey", () => {
-    it("returns key in 'mcp:{provider}' format", () => {
-        expect(genericMcpSourceHashKey(makeSource("linear"))).toBe("mcp:linear");
-    });
-    it("handles provider with hyphens and numbers", () => {
-        expect(genericMcpSourceHashKey(makeSource("slack-v2"))).toBe("mcp:slack-v2");
-    });
-    it("produces consistent keys across calls", () => {
-        const source = makeSource("github");
-        expect(genericMcpSourceHashKey(source)).toBe(genericMcpSourceHashKey(source));
-    });
-});
-describe("genericMcpSourceHash", () => {
-    it("returns { key, value } with provider key and response digest", () => {
-        expect(genericMcpSourceHash(makeSource("linear"), "sha256:deadbeef")).toEqual({
-            key: "mcp:linear",
-            value: "sha256:deadbeef",
-        });
-    });
-    it("key matches genericMcpSourceHashKey output", () => {
-        const source = makeSource("notion");
-        expect(genericMcpSourceHash(source, "digest").key).toBe(genericMcpSourceHashKey(source));
-    });
-});
-describe("scanGenericMcp", () => {
-    it("returns empty ScanResult bound to the source", () => {
-        const source = makeSource("empty-provider");
-        const result = scanGenericMcp(source);
-        expect(result.source).toEqual(source);
-        expect(result.files).toEqual([]);
-        expect(result.content_hashes).toEqual({});
-        expect(result.dependency_graph).toEqual([]);
-        expect(result.doc_structure).toEqual([]);
-    });
-});
-describe("recordGenericMcpGrounding", () => {
-    it("records responseDigest into content_hashes", () => {
-        const source = makeSource("linear");
-        const result = recordGenericMcpGrounding(source, { responseDigest: "abc123" });
-        expect(result.content_hashes).toEqual({ "mcp:linear": "abc123" });
-    });
-    it("records optional metadata into doc_structure frontmatter", () => {
-        const source = makeSource("slack");
-        const result = recordGenericMcpGrounding(source, {
-            responseDigest: "d1",
-            toolsSeen: ["list_channels", "search_messages"],
-            sampleCount: 17,
-            retrievedAt: "2026-04-14T01:00:00Z",
-        });
-        expect(result.doc_structure).toHaveLength(1);
-        const entry = result.doc_structure[0];
-        expect(entry.file).toBe("mcp:slack");
-        expect(entry.format).toBe("json");
-        expect(entry.frontmatter).toEqual({
-            provider: "slack",
-            responseDigest: "d1",
-            toolsSeen: ["list_channels", "search_messages"],
-            sampleCount: 17,
-            retrievedAt: "2026-04-14T01:00:00Z",
-        });
-    });
-    it("omits undefined optional fields but always includes provider + digest", () => {
-        const source = makeSource("minimal");
-        const result = recordGenericMcpGrounding(source, { responseDigest: "d2" });
-        const entry = result.doc_structure[0];
-        expect(entry.frontmatter).toEqual({
-            provider: "minimal",
-            responseDigest: "d2",
-        });
-    });
-});

package/dist/core-runtime/readers/ontology-index.js

@@ -1,148 +0,0 @@
-import { parse } from "yaml";
-import { getLogger } from "../logger.js";
-// ─── Builder ───
-/**
- * 3개 YAML 문자열을 받아 인메모리 인덱스를 구성합니다.
- *
- * - 빈 문자열이면 해당 섹션만 빈 Map으로 처리합니다.
- * - YAML 파싱 에러 시 에러를 throw합니다 (빈 결과와 구분).
- */
-export function buildOntologyIndex(ontologyYaml, actionsYaml, transitionsYaml) {
-    const glossary = parseGlossary(ontologyYaml);
-    const actions = parseActions(actionsYaml);
-    const transitions = parseTransitions(transitionsYaml);
-    return { glossary, actions, transitions };
-}
-// ─── Internal Parsers ───
-function parseGlossary(yaml_str) {
-    const map = new Map();
-    if (yaml_str.trim() === "")
-        return map;
-    const doc = parse(yaml_str);
-    if (!doc || !Array.isArray(doc.glossary))
-        return map;
-    for (const item of doc.glossary) {
-        const canonical = item.canonical ?? "";
-        const key = canonical.toLowerCase();
-        if (map.has(key)) {
-            getLogger().warn(`[ontology] Duplicate glossary key: "${key}" (canonical: "${canonical}")`);
-        }
-        map.set(key, {
-            canonical,
-            meaning: item.meaning ?? "",
-            legacy_aliases: Array.isArray(item.legacy_aliases) ? item.legacy_aliases : [],
-            code_entity: item.code_entity ?? undefined,
-            db_table: item.db_table ?? undefined,
-            fk_variants: Array.isArray(item.fk_variants) ? item.fk_variants : [],
-            value_filters: Array.isArray(item.value_filters)
-                ? item.value_filters.map((vf) => ({
-                    column: String(vf.column ?? ""),
-                    value: String(vf.value ?? ""),
-                    description: String(vf.description ?? ""),
-                }))
-                : undefined,
-        });
-    }
-    return map;
-}
-function parseActions(yaml_str) {
-    const map = new Map();
-    if (yaml_str.trim() === "")
-        return map;
-    const doc = parse(yaml_str);
-    if (!doc)
-        return map;
-    const actionLists = [];
-    // v1: write_actions/read_actions 분리
-    if (Array.isArray(doc.write_actions))
-        actionLists.push(doc.write_actions);
-    if (Array.isArray(doc.read_actions))
-        actionLists.push(doc.read_actions);
-    // v3: 단일 actions 배열
-    if (Array.isArray(doc.actions))
-        actionLists.push(doc.actions);
-    for (const list of actionLists) {
-        for (const raw of list) {
-            const item = raw;
-            const id = item.id ?? "";
-            const targetEntities = Array.isArray(item.target_entities)
-                ? item.target_entities.map(String)
-                : [];
-            map.set(id, {
-                id,
-                name: item.name ?? "",
-                display_name: item.display_name ?? "",
-                domain: item.domain ?? "",
-                actor: item.actor ?? undefined,
-                target_entities: targetEntities,
-                source_code: item.source_code ?? "",
-                guard_note: item.guard_note ?? undefined,
-                // v3 확장 필드
-                preconditions: Array.isArray(item.preconditions)
-                    ? item.preconditions.map((p) => ({
-                        check: String(p.check ?? ""),
-                        policy_ref: p.policy_ref ? String(p.policy_ref) : undefined,
-                    }))
-                    : undefined,
-                results: Array.isArray(item.results) ? item.results.map(String) : undefined,
-                state_transitions: Array.isArray(item.state_transitions) ? item.state_transitions.map(String) : undefined,
-                side_effects: Array.isArray(item.side_effects) ? item.side_effects.map(String) : undefined,
-            });
-        }
-    }
-    return map;
-}
-function parseTransitions(yaml_str) {
-    const map = new Map();
-    if (yaml_str.trim() === "")
-        return map;
-    const doc = parse(yaml_str);
-    if (!doc || !Array.isArray(doc.entities))
-        return map;
-    for (const entity of doc.entities) {
-        const entityName = entity.name ?? "";
-        const key = entityName.toLowerCase();
-        // v1: state_fields[].transitions, v3: state_machine[].transitions
-        const stateFields = Array.isArray(entity.state_fields) ? entity.state_fields
-            : Array.isArray(entity.state_machine) ? entity.state_machine
-                : null;
-        if (!stateFields)
-            continue;
-        const entries = [];
-        for (const field of stateFields) {
-            // v1: field_name, v3: field
-            const fieldName = field.field_name ?? field.field ?? "";
-            if (!Array.isArray(field.transitions))
-                continue;
-            for (const t of field.transitions) {
-                // v3: from can be array (multi-source transition) — take first or join
-                const rawFrom = t.from;
-                const fromValue = rawFrom === null || rawFrom === undefined ? "(none)"
-                    : Array.isArray(rawFrom) ? rawFrom.join("|")
-                        : String(rawFrom);
-                const transitionId = t.id ? String(t.id) : undefined;
-                entries.push({
-                    id: transitionId,
-                    entity: entityName,
-                    field_name: fieldName,
-                    from: fromValue,
-                    to: String(t.to ?? ""),
-                    trigger: t.trigger ?? "",
-                    source_code: t.source_code ?? "",
-                    // v3 확장 필드
-                    guards: Array.isArray(t.guard)
-                        ? t.guard.map((g) => ({
-                            check: String(g.check ?? ""),
-                            policy_ref: g.policy_ref ? String(g.policy_ref) : undefined,
-                        }))
-                        : undefined,
-                });
-            }
-        }
-        if (entries.length > 0) {
-            const existing = map.get(key) ?? [];
-            map.set(key, [...existing, ...entries]);
-        }
-    }
-    return map;
-}