@wanshi-kg/wanshi 0.1.0

package/dist/core/knowledge/contradiction/LlmContradictionChecker.js

@@ -0,0 +1,52 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LlmContradictionChecker = void 0;
+const zod_1 = require("zod");
+const HeuristicContradictionChecker_1 = require("./HeuristicContradictionChecker");
+const Schema = zod_1.z.object({
+    contradicts: zod_1.z.boolean().describe("true iff the two statements cannot both be true"),
+});
+/**
+ * LLM-backed contradiction detector (KG-10), the Graphiti-style check: asks the
+ * generation model whether two facts about one entity contradict. Falls back to
+ * the heuristic when the call errors, so a flaky model never crashes the merge.
+ */
+class LlmContradictionChecker {
+    constructor(llm, logger) {
+        this.llm = llm;
+        this.logger = logger;
+        this.fallback = new HeuristicContradictionChecker_1.HeuristicContradictionChecker();
+    }
+    check(a, b) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const res = yield this.llm.generateStructured([
+                    {
+                        role: "system",
+                        content: "You decide whether two statements about the SAME entity contradict — " +
+                            "i.e. they cannot both be true at the same time. Differences in detail or " +
+                            "elaboration are NOT contradictions. Respond only with the JSON schema.",
+                    },
+                    { role: "user", content: `Statement A: ${a}\nStatement B: ${b}` },
+                ], Schema, 2);
+                return { contradicts: !!res.contradicts, checker: "llm" };
+            }
+            catch (error) {
+                const message = error instanceof Error ? error.message : String(error);
+                this.logger.warn(`LLM contradiction check failed (${message}); falling back to heuristic`);
+                return this.fallback.check(a, b);
+            }
+        });
+    }
+}
+exports.LlmContradictionChecker = LlmContradictionChecker;
+//# sourceMappingURL=LlmContradictionChecker.js.map

package/dist/core/knowledge/contradiction/LlmContradictionChecker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LlmContradictionChecker.js","sourceRoot":"","sources":["../../../../src/core/knowledge/contradiction/LlmContradictionChecker.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,6BAAwB;AAGxB,mFAAgF;AAEhF,MAAM,MAAM,GAAG,OAAC,CAAC,MAAM,CAAC;IACtB,WAAW,EAAE,OAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,CAAC,iDAAiD,CAAC;CACrF,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAa,uBAAuB;IAGlC,YACmB,GAAiB,EACjB,MAAc;QADd,QAAG,GAAH,GAAG,CAAc;QACjB,WAAM,GAAN,MAAM,CAAQ;QAJhB,aAAQ,GAAG,IAAI,6DAA6B,EAAE,CAAC;IAK7D,CAAC;IAEE,KAAK,CAAC,CAAS,EAAE,CAAS;;YAC9B,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,kBAAkB,CAC3C;oBACE;wBACE,IAAI,EAAE,QAAQ;wBACd,OAAO,EACL,uEAAuE;4BACvE,2EAA2E;4BAC3E,wEAAwE;qBAC3E;oBACD,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB,CAAC,kBAAkB,CAAC,EAAE,EAAE;iBAClE,EACD,MAAM,EACN,CAAC,CACF,CAAC;gBACF,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YAC5D,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvE,IAAI,CAAC,MAAM,CAAC,IAAI,CACd,mCAAmC,OAAO,8BAA8B,CACzE,CAAC;gBACF,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACnC,CAAC;QACH,CAAC;KAAA;CACF;AAjCD,0DAiCC"}

package/dist/core/knowledge/contradiction/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./HeuristicContradictionChecker"), exports);
+__exportStar(require("./LlmContradictionChecker"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/knowledge/contradiction/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/knowledge/contradiction/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kEAAgD;AAChD,4DAA0C"}

package/dist/core/knowledge/grounding/KeywordGroundingChecker.js

@@ -0,0 +1,33 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeywordGroundingChecker = void 0;
+const FactualMetrics_1 = require("../../../quality/FactualMetrics");
+/**
+ * The original grounding heuristic, now behind {@link IGroundingChecker}: the
+ * fraction of a claim's content words found verbatim in the source. Cheap and
+ * network-free — used both as the default checker and as the pre-filter inside
+ * {@link MiniCheckGroundingChecker}. Punishes paraphrase and verbatim-name
+ * absence (KG-08); that's exactly what MiniCheck escalation is for.
+ */
+class KeywordGroundingChecker {
+    constructor(min) {
+        this.min = min;
+    }
+    check(claim, source) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const score = FactualMetrics_1.FactualEvaluator.observationGroundingScore(claim, source);
+            return { score, supported: score >= this.min, checker: "keyword" };
+        });
+    }
+}
+exports.KeywordGroundingChecker = KeywordGroundingChecker;
+//# sourceMappingURL=KeywordGroundingChecker.js.map

package/dist/core/knowledge/grounding/KeywordGroundingChecker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeywordGroundingChecker.js","sourceRoot":"","sources":["../../../../src/core/knowledge/grounding/KeywordGroundingChecker.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,oEAAmE;AAEnE;;;;;;GAMG;AACH,MAAa,uBAAuB;IAClC,YAA6B,GAAW;QAAX,QAAG,GAAH,GAAG,CAAQ;IAAG,CAAC;IAEtC,KAAK,CAAC,KAAa,EAAE,MAAc;;YACvC,MAAM,KAAK,GAAG,iCAAgB,CAAC,yBAAyB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;YACxE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC;QACrE,CAAC;KAAA;CACF;AAPD,0DAOC"}

package/dist/core/knowledge/grounding/MiniCheckGroundingChecker.js

@@ -0,0 +1,82 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MiniCheckGroundingChecker = void 0;
+const ollama_1 = require("ollama");
+const FactualMetrics_1 = require("../../../quality/FactualMetrics");
+const verbalize_1 = require("./verbalize");
+/**
+ * Grounding via MiniCheck (bespoke-minicheck:7b) — a purpose-built
+ * `(document, claim) → Yes/No` fact-checker (arXiv:2404.10774). Unlike keyword
+ * overlap it rewards paraphrase and doesn't require the verbatim entity name,
+ * so snake_case canonical names stop auto-failing (KG-08).
+ *
+ * Cost control: keyword overlap stays as a cheap pre-filter — a claim with high
+ * verbatim overlap (`>= escalateAbove`) is accepted without an NLI call, so only
+ * the *uncertain* claims reach MiniCheck. Multi-sentence claims are split to
+ * sentences (MiniCheck checks atomic claims); the claim is supported iff every
+ * sentence is. A checker failure degrades to the keyword verdict rather than
+ * crashing the run.
+ */
+class MiniCheckGroundingChecker {
+    constructor(opts, logger, client) {
+        this.opts = opts;
+        this.logger = logger;
+        this.ollama = client !== null && client !== void 0 ? client : new ollama_1.Ollama({ host: opts.host });
+    }
+    check(claim, source) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const ks = FactualMetrics_1.FactualEvaluator.observationGroundingScore(claim, source);
+            // Pre-filter: obvious verbatim grounding skips the NLI call.
+            if (ks >= this.opts.escalateAbove) {
+                return { score: ks, supported: true, checker: "keyword" };
+            }
+            const sentences = (0, verbalize_1.splitSentences)(claim);
+            if (sentences.length === 0) {
+                return { score: 1, supported: true, checker: "minicheck" };
+            }
+            try {
+                let supported = 0;
+                for (const sentence of sentences) {
+                    if (yield this.miniCheck(source, sentence))
+                        supported++;
+                }
+                const score = supported / sentences.length;
+                return { score, supported: supported === sentences.length, checker: "minicheck" };
+            }
+            catch (error) {
+                // Grounding is an enhancement — never let a checker failure crash the run.
+                const message = error instanceof Error ? error.message : String(error);
+                this.logger.warn(`MiniCheck unavailable (${message}); falling back to keyword overlap for this claim`);
+                return { score: ks, supported: ks >= this.opts.min, checker: "keyword" };
+            }
+        });
+    }
+    /** One `(document, claim) → boolean` MiniCheck call. */
+    miniCheck(document, claim) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const res = yield this.ollama.generate({
+                model: this.opts.model,
+                prompt: `Document: ${document}\nClaim: ${claim}`,
+                stream: false,
+                options: { temperature: 0, num_predict: 4 },
+            });
+            return this.parseVerdict(res.response);
+        });
+    }
+    /** Lenient parse: the model emits `Yes`/`No`; tolerate `1`/`true` variants. */
+    parseVerdict(raw) {
+        const t = (raw !== null && raw !== void 0 ? raw : "").trim().toLowerCase();
+        return t.startsWith("yes") || t.startsWith("1") || t.startsWith("true");
+    }
+}
+exports.MiniCheckGroundingChecker = MiniCheckGroundingChecker;
+//# sourceMappingURL=MiniCheckGroundingChecker.js.map

package/dist/core/knowledge/grounding/MiniCheckGroundingChecker.js.map

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

package/dist/core/knowledge/grounding/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./verbalize"), exports);
+__exportStar(require("./KeywordGroundingChecker"), exports);
+__exportStar(require("./MiniCheckGroundingChecker"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/knowledge/grounding/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/core/knowledge/grounding/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,8CAA4B;AAC5B,4DAA0C;AAC1C,8DAA4C"}

package/dist/core/knowledge/grounding/verbalize.js

@@ -0,0 +1,38 @@
+"use strict";
+/**
+ * Claim verbalization + decomposition for the grounding gate.
+ *
+ * MiniCheck checks atomic `(document, claim)` pairs, so a multi-sentence
+ * observation is split to sentences and a relation triple is rendered as one
+ * natural-language claim before checking.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitSentences = splitSentences;
+exports.verbalizeRelation = verbalizeRelation;
+/**
+ * Split a claim into sentences for atomic fact-checking. Boundaries are
+ * `.`/`!`/`?` (optionally followed by quotes/brackets) and newlines. A claim
+ * with no terminator stays a single sentence; abbreviation-level precision
+ * isn't needed — over-splitting only makes MiniCheck judge smaller spans.
+ */
+function splitSentences(text) {
+    return text
+        .split(/(?<=[.!?]["')\]]?)\s+|\n+/)
+        .map((s) => s.trim())
+        .filter((s) => s.length > 0);
+}
+/**
+ * Render a relation triple as one claim. The predicate (`relationType`) is an
+ * array of snake_case tokens; join them and turn underscores into spaces, so
+ * `("EmbeddingService", ["part_of"], "wanshi")` → "EmbeddingService part of wanshi".
+ */
+function verbalizeRelation(from, predicate, to) {
+    const preds = Array.isArray(predicate) ? predicate : [predicate];
+    const phrase = preds
+        .filter(Boolean)
+        .map((p) => p.replace(/_/g, " ").trim())
+        .join(" and ")
+        .trim();
+    return `${from} ${phrase || "related to"} ${to}`.replace(/\s+/g, " ").trim();
+}
+//# sourceMappingURL=verbalize.js.map

package/dist/core/knowledge/grounding/verbalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verbalize.js","sourceRoot":"","sources":["../../../../src/core/knowledge/grounding/verbalize.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;AAQH,wCAKC;AAOD,8CAYC;AA9BD;;;;;GAKG;AACH,SAAgB,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI;SACR,KAAK,CAAC,2BAA2B,CAAC;SAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;SACpB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,SAAgB,iBAAiB,CAC/B,IAAY,EACZ,SAA4B,EAC5B,EAAU;IAEV,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACjE,MAAM,MAAM,GAAG,KAAK;SACjB,MAAM,CAAC,OAAO,CAAC;SACf,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;SACvC,IAAI,CAAC,OAAO,CAAC;SACb,IAAI,EAAE,CAAC;IACV,OAAO,GAAG,IAAI,IAAI,MAAM,IAAI,YAAY,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC/E,CAAC"}

package/dist/core/knowledge/images/imageMetaGraph.js

@@ -0,0 +1,136 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildImageMetaGraph = buildImageMetaGraph;
+const relPath_1 = require("../../corpus/relPath");
+/**
+ * Turn an image's deterministic metadata (`metadata.exif`, `metadata.c2pa`) into a
+ * `KnowledgeGraph` fragment that AUGMENTS the VLM's read of the image rather than
+ * replacing it. Mirrors `buildReferenceGraph`: a pure per-file module whose
+ * fragment `DirectoryProcessor` unions into the per-file `graphs[]` (alongside the
+ * LLM extraction + AST seed + reference graph), so it flows through merge/canon
+ * like any other fragment.
+ *
+ * The image file itself is an entity keyed by corpus-relative path (`toRelPathId`,
+ * the buildReferenceGraph convention) and is always emitted, so EXIF/C2PA edges
+ * never dangle. Facts are stamped `sourceAdapter:"exif"`/`"c2pa"` + a `confidence`
+ * (read-reliability, not a truth verdict). Capture time → bitemporal `validAt`.
+ * C2PA stores a fact, never a verdict — a valid credential proves signed
+ * provenance, not truth; a missing one proves nothing.
+ */
+const IMAGE = "image";
+// EXIF is a deterministic read but the tags are editable/strippable, so it is
+// high- but not perfect-confidence; the cryptographic C2PA read scores higher.
+const EXIF_CONFIDENCE = 0.9;
+const C2PA_CONFIDENCE = 0.95;
+function buildImageMetaGraph(processedFile, inputRoot) {
+    var _a, _b, _c;
+    const exif = (_a = processedFile.metadata) === null || _a === void 0 ? void 0 : _a.exif;
+    const c2pa = (_b = processedFile.metadata) === null || _b === void 0 ? void 0 : _b.c2pa;
+    const cvDetection = (_c = processedFile.metadata) === null || _c === void 0 ? void 0 : _c.cvDetection;
+    if (!exif && !c2pa && !(cvDetection && cvDetection.objects.length))
+        return null;
+    const imageName = (0, relPath_1.toRelPathId)(inputRoot, processedFile.path);
+    const createdAt = new Date().toISOString();
+    const entities = new Map();
+    const relations = [];
+    const ensure = (name, entityType, observations = []) => {
+        const existing = entities.get(name);
+        if (existing) {
+            if (observations.length)
+                existing.observations.push(...observations);
+            return existing;
+        }
+        const e = { name, entityType, files: [], observations };
+        entities.set(name, e);
+        return e;
+    };
+    const obs = (text, adapter, confidence, extra = {}) => (Object.assign({ text, source: processedFile.path, createdAt, sourceAdapter: adapter, confidence }, extra));
+    const edge = (to, type, validAt) => {
+        if (!to || to === imageName)
+            return; // no self-loops
+        relations.push(Object.assign({ from: imageName, to, relationType: [type], source: imageName }, (validAt ? { validAt } : {})));
+    };
+    // The image file as an entity (edge endpoint + holder of attribute observations).
+    const image = ensure(imageName, IMAGE);
+    image.files.push(processedFile.path);
+    // EXIF — graph-native structured tags.
+    if (exif) {
+        const exifObs = (text, extra = {}) => obs(text, "exif", EXIF_CONFIDENCE, extra);
+        const validAt = exif.dateTaken;
+        if (exif.dateTaken)
+            image.observations.push(exifObs(`Captured: ${exif.dateTaken}`, { validAt }));
+        if (exif.author)
+            image.observations.push(exifObs(`Author: ${exif.author}`));
+        if (exif.software)
+            image.observations.push(exifObs(`Software: ${exif.software}`));
+        // GPS → a location entity (deterministic, deduped to ~1 m by the rounded name).
+        if (exif.gps) {
+            const loc = `Location(${exif.gps.lat.toFixed(5)}, ${exif.gps.lng.toFixed(5)})`;
+            ensure(loc, "location", [
+                exifObs(`Latitude: ${exif.gps.lat}`, { locator: "gps" }),
+                exifObs(`Longitude: ${exif.gps.lng}`, { locator: "gps" }),
+            ]);
+            edge(loc, "taken_at", validAt);
+        }
+        // Camera make/model → a device entity (reused across photos from one camera).
+        if (exif.camera && (exif.camera.make || exif.camera.model)) {
+            const cam = [exif.camera.make, exif.camera.model].filter(Boolean).join(" ").trim();
+            if (cam) {
+                ensure(cam, "camera", [
+                    ...(exif.camera.make ? [exifObs(`Make: ${exif.camera.make}`)] : []),
+                    ...(exif.camera.model ? [exifObs(`Model: ${exif.camera.model}`)] : []),
+                ]);
+                edge(cam, "captured_with", validAt);
+            }
+        }
+    }
+    // C2PA — a trust observation on the image source (a fact, never a verdict).
+    // `unavailable` (couldn't read provenance) emits nothing — no signal to hedge.
+    if (c2pa && !c2pa.unavailable) {
+        if (c2pa.present) {
+            const parts = [
+                c2pa.valid === false
+                    ? "C2PA Content Credential present but failed validation"
+                    : "C2PA Content Credential present and valid",
+            ];
+            if (c2pa.signer)
+                parts.push(`signed by ${c2pa.signer}`);
+            if (c2pa.aiGenerated)
+                parts.push("the credential asserts AI-generated content");
+            image.observations.push(obs(`${parts.join("; ")}. A credential proves signed provenance, not truth.`, "c2pa", C2PA_CONFIDENCE));
+        }
+        else {
+            image.observations.push(obs("No C2PA Content Credential found. Absence is not evidence of manipulation.", "c2pa", C2PA_CONFIDENCE));
+        }
+    }
+    // CV object detection — each detected class → an `object` entity + a `depicts`
+    // edge; confidence is the detector's own score (2a "may be stated plainly").
+    if (cvDetection && cvDetection.objects.length) {
+        const byLabel = new Map();
+        for (const o of cvDetection.objects) {
+            const cur = byLabel.get(o.label);
+            if (cur) {
+                cur.count++;
+                cur.score = Math.max(cur.score, o.score);
+            }
+            else {
+                byLabel.set(o.label, { count: 1, score: o.score });
+            }
+        }
+        const ranked = [...byLabel.entries()].sort((a, b) => b[1].count - a[1].count);
+        const summary = ranked.map(([l, v]) => (v.count > 1 ? `${l} ×${v.count}` : l)).join(", ");
+        const topScore = Math.max(...cvDetection.objects.map((o) => o.score));
+        image.observations.push(obs(`CV object detection: ${summary}`, "cv-detection", topScore));
+        for (const [label, v] of ranked) {
+            ensure(label, "object", [
+                obs(`Detected in image via cv-detection (count ${v.count}, top score ${v.score.toFixed(2)})`, "cv-detection", v.score),
+            ]);
+            edge(label, "depicts");
+        }
+    }
+    const hasObservations = Array.from(entities.values()).some((e) => e.observations.length > 0);
+    if (!relations.length && !hasObservations)
+        return null;
+    return { entities: Array.from(entities.values()), relations };
+}
+//# sourceMappingURL=imageMetaGraph.js.map

package/dist/core/knowledge/images/imageMetaGraph.js.map

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

package/dist/core/knowledge/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./KnowledgeGraphBuilder"), exports);
+__exportStar(require("./merging/KnowledgeMerger"), exports);
+__exportStar(require("./search/KnowledgeGraphSearch"), exports);
+//# sourceMappingURL=index.js.map

package/dist/core/knowledge/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/knowledge/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,4DAA0C;AAC1C,gEAA8C"}