@co-engram/core 0.1.0

package/dist/types/skill.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Skill 类型定义（程序性记忆）
+ *
+ * 与业界 Skill 的本质差异：业界把 Skill 当"工具"（静态、无记忆、无进化），
+ * Co-Engram 把 Skill 当"神经通路"（活的、可进化、会衰退）。
+ *
+ * @module @co-engram/core/types
+ */
+import type { EngramId, IntentionId, SceneId, SkillId } from "./engram.js";
+/** Skill 触发器 */
+export interface SkillTrigger {
+    readonly pattern: string;
+    readonly keywords: readonly string[];
+    readonly taskType: TaskType;
+}
+/** 任务类型 */
+export type TaskType = "debug" | "test" | "deploy" | "document" | "refactor" | "review" | "explore" | "other";
+/** Skill 模板类型 */
+export type SkillTemplateType = "tool-sequence" | "prompt-template" | "code-snippet" | "workflow";
+/** Skill 模板 */
+export interface SkillTemplate {
+    readonly type: SkillTemplateType;
+    readonly content: string;
+    readonly variables: readonly SkillVariable[];
+}
+/** Skill 变量 */
+export interface SkillVariable {
+    readonly name: string;
+    readonly description: string;
+    readonly required: boolean;
+    readonly defaultValue?: string;
+}
+/** Skill 自动化级别 */
+export type SkillAutomationLevel = "suggest" | "auto-execute" | "deprecated";
+/** Skill 自动化元数据 */
+export interface SkillAutomation {
+    readonly level: SkillAutomationLevel;
+    readonly confidence: number;
+}
+/** Skill 衰退阶段 */
+export type SkillDecayStage = "active" | "aging" | "stale" | "forgotten";
+/** Skill 衰退状态 */
+export interface SkillDecay {
+    readonly halfLifeDays: number | null;
+    readonly currentStrength: number;
+    readonly stage: SkillDecayStage;
+}
+/** Skill 使用统计 */
+export interface SkillStats {
+    readonly successCount: number;
+    readonly failureCount: number;
+    readonly avgEffectiveness: number;
+    readonly lastUsedAt?: string;
+}
+/**
+ * Skill 完整对象
+ *
+ * 与 Engram 一样有完整生命周期（含衰退机制）
+ */
+export interface Skill {
+    readonly id: SkillId;
+    readonly title: string;
+    readonly trigger: SkillTrigger;
+    readonly template: SkillTemplate;
+    readonly evolvedFrom: EngramId | IntentionId | null;
+    readonly applicableContext: string;
+    readonly boundaryConditions: readonly string[];
+    readonly automation: SkillAutomation;
+    readonly activeInScenes: readonly SceneId[];
+    readonly inhibitedInScenes: readonly SceneId[];
+    readonly composes: readonly SkillId[];
+    readonly decay: SkillDecay;
+    readonly stats: SkillStats;
+    readonly reflectAfterConsecutiveFailures: number;
+    readonly relatedEngrams: readonly EngramId[];
+    readonly visibility: "public" | "team" | "private";
+    readonly createdBy: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+/** Skill 执行结果 */
+export interface SkillResult {
+    readonly skillId: SkillId;
+    readonly success: boolean;
+    readonly output: string;
+    readonly effectiveness?: number;
+    readonly error?: string;
+    readonly executedAt: string;
+}
+/** 创建 Skill 的输入 */
+export interface SkillCreateInput {
+    readonly title: string;
+    readonly trigger: SkillTrigger;
+    readonly template: SkillTemplate;
+    readonly evolvedFrom?: EngramId | IntentionId;
+    readonly applicableContext: string;
+    readonly boundaryConditions?: readonly string[];
+    readonly automation?: SkillAutomation;
+    readonly activeInScenes?: readonly SceneId[];
+    readonly inhibitedInScenes?: readonly SceneId[];
+    readonly composes?: readonly SkillId[];
+    readonly decayHalfLifeDays?: number | null;
+    readonly relatedEngrams?: readonly EngramId[];
+    readonly visibility?: "public" | "team" | "private";
+    readonly createdBy: string;
+}
+//# sourceMappingURL=skill.d.ts.map

package/dist/types/skill.d.ts.map

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

package/dist/types/skill.js

@@ -0,0 +1,10 @@
+/**
+ * Skill 类型定义（程序性记忆）
+ *
+ * 与业界 Skill 的本质差异：业界把 Skill 当"工具"（静态、无记忆、无进化），
+ * Co-Engram 把 Skill 当"神经通路"（活的、可进化、会衰退）。
+ *
+ * @module @co-engram/core/types
+ */
+export {};
+//# sourceMappingURL=skill.js.map

package/dist/types/skill.js.map

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

package/dist/types/slugify.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Slug 与 domainTags 推断
+ *
+ * 设计:
+ * - slug: 保留 unicode(中文等非 ASCII),ASCII 转小写,非法路径字符替换为 `-`,
+ *   连续空格合并为一个 `-`,首尾 `-` 裁剪,空时回退 `untitled`。
+ * - inferDomainTagsFromPath: 从相对路径的所有目录层推断 domainTags。
+ *
+ * @module @co-engram/core/types
+ */
+/**
+ * 把 title 转成人类可读的 slug(同时是文件名)。
+ *
+ * 示例:
+ *   "React Hooks 最佳实践" → "react-hooks-最佳实践"
+ *   "A/B:C?"                → "a-b-c"
+ *   "  多余  空格  "         → "多余-空格"
+ *   ""                       → "untitled"
+ *
+ * 特性:NFC 标准化、保留路径非法字符之外的所有 unicode,不强制 ASCII-only。
+ */
+export declare function slugify(title: string): string;
+/**
+ * 从相对路径的所有目录层推断 domainTags。
+ *
+ * 例:`项目管理/需求管理/操作系统内存优化.md` → `["项目管理", "需求管理"]`
+ *
+ * 规则:
+ * - 取 path 的 dirname
+ * - 用 `/` 分隔后过滤空段
+ * - 不含文件名,不 normalize unicode(保留人类原始拼写)
+ */
+export declare function inferDomainTagsFromPath(relativePath: string): string[];
+//# sourceMappingURL=slugify.d.ts.map

package/dist/types/slugify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.d.ts","sourceRoot":"","sources":["../../src/types/slugify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH;;;;;;;;;;GAUG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAU7C;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CAMtE"}

package/dist/types/slugify.js

@@ -0,0 +1,55 @@
+/**
+ * Slug 与 domainTags 推断
+ *
+ * 设计:
+ * - slug: 保留 unicode(中文等非 ASCII),ASCII 转小写,非法路径字符替换为 `-`,
+ *   连续空格合并为一个 `-`,首尾 `-` 裁剪,空时回退 `untitled`。
+ * - inferDomainTagsFromPath: 从相对路径的所有目录层推断 domainTags。
+ *
+ * @module @co-engram/core/types
+ */
+/** 非法路径字符(在所有主流文件系统上有特殊含义) */
+const ILLEGAL_PATH_CHARS = /[\/\\:*?"<>|]/g;
+/** 连续空白(空格、tab)合并为单个分隔符 */
+const WHITESPACE_RUN = /[\s]+/g;
+/**
+ * 把 title 转成人类可读的 slug(同时是文件名)。
+ *
+ * 示例:
+ *   "React Hooks 最佳实践" → "react-hooks-最佳实践"
+ *   "A/B:C?"                → "a-b-c"
+ *   "  多余  空格  "         → "多余-空格"
+ *   ""                       → "untitled"
+ *
+ * 特性:NFC 标准化、保留路径非法字符之外的所有 unicode,不强制 ASCII-only。
+ */
+export function slugify(title) {
+    const normalized = title.normalize("NFC").trim();
+    if (normalized.length === 0)
+        return "untitled";
+    const replaced = normalized
+        .replace(ILLEGAL_PATH_CHARS, "-")
+        .replace(WHITESPACE_RUN, "-");
+    const lower = replaced.toLowerCase();
+    const trimmed = lower.replace(/^-+|-+$/g, "");
+    return trimmed.length === 0 ? "untitled" : trimmed;
+}
+/**
+ * 从相对路径的所有目录层推断 domainTags。
+ *
+ * 例:`项目管理/需求管理/操作系统内存优化.md` → `["项目管理", "需求管理"]`
+ *
+ * 规则:
+ * - 取 path 的 dirname
+ * - 用 `/` 分隔后过滤空段
+ * - 不含文件名,不 normalize unicode(保留人类原始拼写)
+ */
+export function inferDomainTagsFromPath(relativePath) {
+    const normalized = relativePath.replaceAll("\\", "/");
+    const lastSlash = normalized.lastIndexOf("/");
+    if (lastSlash < 0)
+        return [];
+    const dirPart = normalized.slice(0, lastSlash);
+    return dirPart.split("/").filter((segment) => segment.length > 0);
+}
+//# sourceMappingURL=slugify.js.map

package/dist/types/slugify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"slugify.js","sourceRoot":"","sources":["../../src/types/slugify.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,8BAA8B;AAC9B,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAE5C,2BAA2B;AAC3B,MAAM,cAAc,GAAG,QAAQ,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;IACjD,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IAE/C,MAAM,QAAQ,GAAG,UAAU;SACxB,OAAO,CAAC,kBAAkB,EAAE,GAAG,CAAC;SAChC,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC9C,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC;AACrD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,uBAAuB,CAAC,YAAoB;IAC1D,MAAM,UAAU,GAAG,YAAY,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,UAAU,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,SAAS,GAAG,CAAC;QAAE,OAAO,EAAE,CAAC;IAC7B,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/types/synapse-id.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Synapse 确定性 ID 计算
+ *
+ * 同 (from, to, kind) 组合必产生同 id,使 per-edge 存储天然幂等。
+ *
+ * @module @co-engram/core/types
+ */
+import type { EngramId } from "./engram.js";
+import type { SynapseId } from "./engram.js";
+import type { SynapseKind } from "./synapse.js";
+/**
+ * 计算确定性 SynapseId。
+ *
+ * 公式:`syn-` + sha256(`${from}|${to}|${kind}`).slice(0, 16)
+ *
+ * 规范化:对 from/to 排序保证 (A, B, kind) 和 (B, A, kind) 在 bidirectional 时
+ * 生成同 id。directional 严格保留顺序。
+ */
+export declare function computeSynapseId(from: EngramId, to: EngramId, kind: SynapseKind, direction?: "directional" | "bidirectional"): SynapseId;
+/** 校验字符串是否符合 SynapseId 格式(syn- + 16 位 hex) */
+export declare function isSynapseId(value: string): value is SynapseId;
+//# sourceMappingURL=synapse-id.d.ts.map

package/dist/types/synapse-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"synapse-id.d.ts","sourceRoot":"","sources":["../../src/types/synapse-id.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,QAAQ,EACd,EAAE,EAAE,QAAQ,EACZ,IAAI,EAAE,WAAW,EACjB,SAAS,GAAE,aAAa,GAAG,eAA+B,GACzD,SAAS,CAaX;AAED,8CAA8C;AAC9C,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,SAAS,CAE7D"}

package/dist/types/synapse-id.js

@@ -0,0 +1,34 @@
+/**
+ * Synapse 确定性 ID 计算
+ *
+ * 同 (from, to, kind) 组合必产生同 id,使 per-edge 存储天然幂等。
+ *
+ * @module @co-engram/core/types
+ */
+import { createHash } from "node:crypto";
+/**
+ * 计算确定性 SynapseId。
+ *
+ * 公式:`syn-` + sha256(`${from}|${to}|${kind}`).slice(0, 16)
+ *
+ * 规范化:对 from/to 排序保证 (A, B, kind) 和 (B, A, kind) 在 bidirectional 时
+ * 生成同 id。directional 严格保留顺序。
+ */
+export function computeSynapseId(from, to, kind, direction = "directional") {
+    const [a, b] = direction === "bidirectional"
+        ? from <= to
+            ? [from, to]
+            : [to, from]
+        : [from, to];
+    const composite = `${a}|${b}|${kind}`;
+    const hash = createHash("sha256")
+        .update(composite)
+        .digest("hex")
+        .slice(0, 16);
+    return `syn-${hash}`;
+}
+/** 校验字符串是否符合 SynapseId 格式(syn- + 16 位 hex) */
+export function isSynapseId(value) {
+    return /^syn-[0-9a-f]{16}$/.test(value);
+}
+//# sourceMappingURL=synapse-id.js.map

package/dist/types/synapse-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"synapse-id.js","sourceRoot":"","sources":["../../src/types/synapse-id.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAMzC;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAC9B,IAAc,EACd,EAAY,EACZ,IAAiB,EACjB,YAA6C,aAAa;IAE1D,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GACV,SAAS,KAAK,eAAe;QAC3B,CAAC,CAAC,IAAI,IAAI,EAAE;YACV,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;YACZ,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC;QACd,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACjB,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC;SAC9B,MAAM,CAAC,SAAS,CAAC;SACjB,MAAM,CAAC,KAAK,CAAC;SACb,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChB,OAAO,OAAO,IAAI,EAAe,CAAC;AACpC,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,OAAO,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC"}

package/dist/types/synapse.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Synapse 类型定义
+ *
+ * 5 族 12 种连接类型，从神经科学严格推导，覆盖知识组织的核心维度。
+ *
+ * @module @co-engram/core/types
+ */
+import type { EngramId, SynapseId } from "./engram.js";
+/**
+ * Synapse kind（12 种，5 族）
+ *
+ * 中文 label 在 registry 中定义
+ */
+export type SynapseKind = "extends" | "part_of" | "similar_to" | "depends_on" | "causes" | "follows" | "derives_from" | "contradicts" | "exemplifies" | "supersedes" | "consolidates" | "contextualizes";
+/** Synapse 5 族分类 */
+export type SynapseFamily = "structural" | "causal" | "evidential" | "temporal" | "modulatory";
+/** Synapse 方向 */
+export type SynapseDirection = "directional" | "bidirectional";
+/**
+ * Synapse 完整对象
+ *
+ * 存储在每个 engram 的 `synapses/{id}.yaml` 文件中（出边连接）
+ */
+export interface Synapse {
+    readonly id: SynapseId;
+    readonly from: EngramId;
+    readonly to: EngramId;
+    readonly kind: SynapseKind;
+    /** 权重 [0.0, 1.0]，默认 0.5 */
+    readonly weight: number;
+    /** 方向，默认 directional */
+    readonly direction: SynapseDirection;
+    /** 证据数组（支持此连接的来源） */
+    readonly evidence: readonly SynapseEvidence[];
+    readonly createdBy: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+    /** 检索权重（系统计算，用于检索时排序） */
+    readonly retrievalWeight: number;
+    /** 语义标签（source/target 的语义快照） */
+    readonly sourceSemantic?: string;
+    readonly targetSemantic?: string;
+    /** 裁决状态（仅 contradicts synapse 使用，spec §3.9） */
+    readonly resolutionState?: SynapseResolutionState;
+}
+/** Synapse 证据 */
+export interface SynapseEvidence {
+    readonly description: string;
+    readonly source?: string;
+    readonly confidence?: number;
+    readonly addedAt: string;
+    readonly addedBy: string;
+}
+/**
+ * Contradiction Resolution 状态（spec §3.9）
+ *
+ * 仅当 synapse.kind === 'contradicts' 时使用。
+ * 三阶段流程：pending → auto_resolved / escalated → contested / resolved
+ */
+export type SynapseResolutionStatus = "pending" | "auto_resolved" | "escalated" | "contested" | "resolved";
+/** 裁决选项（spec §3.9 阶段 1） */
+export type ContradictionVerdict = "keep_new" | "keep_old" | "merge" | "archive";
+/** Synapse 裁决状态（用于 contradicts synapse） */
+export interface SynapseResolutionState {
+    readonly status: SynapseResolutionStatus;
+    /** 1=LLM 自动 / 2=升级归属人 / 3=超时降级 */
+    readonly phase: 1 | 2 | 3;
+    readonly verdict?: ContradictionVerdict;
+    readonly rationale?: string;
+    readonly confidence?: number;
+    readonly escalatedTo?: string;
+    readonly escalatedAt?: string;
+    /** 阶段 2 超时时间（ISO） */
+    readonly expiresAt?: string;
+    readonly resolvedAt?: string;
+    readonly resolvedBy?: string;
+}
+/** 创建 Synapse 的输入参数 */
+export interface SynapseCreateInput {
+    readonly from: EngramId;
+    readonly to: EngramId;
+    readonly kind: SynapseKind;
+    readonly weight?: number;
+    readonly direction?: SynapseDirection;
+    readonly evidence?: readonly Omit<SynapseEvidence, "addedAt">[];
+    readonly createdBy: string;
+    readonly sourceSemantic?: string;
+    readonly targetSemantic?: string;
+}
+/** 更新 Synapse 的输入(权重 / 方向 / 类型 / 证据) */
+export interface SynapseUpdateInput {
+    readonly weight?: number;
+    readonly direction?: SynapseDirection;
+    /** 变更类型(kind 变化会导致 synapse id 重新计算,内部走删除+重建) */
+    readonly kind?: SynapseKind;
+    readonly evidence?: readonly Omit<SynapseEvidence, "addedAt">[];
+    readonly updatedBy: string;
+}
+//# sourceMappingURL=synapse.d.ts.map

package/dist/types/synapse.d.ts.map

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

package/dist/types/synapse.js

@@ -0,0 +1,9 @@
+/**
+ * Synapse 类型定义
+ *
+ * 5 族 12 种连接类型，从神经科学严格推导，覆盖知识组织的核心维度。
+ *
+ * @module @co-engram/core/types
+ */
+export {};
+//# sourceMappingURL=synapse.js.map

package/dist/types/synapse.js.map

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

package/dist/verification/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Verification 模块 barrel（P3 4.5 + P4 C.1）
+ *
+ * 验证状态机 + 升级条件 + 升级工具入口 + 元认知评分
+ *
+ * @module @co-engram/core/verification
+ */
+export * from "./state-machine.js";
+export * from "./upgrade.js";
+export * from "./metacognition.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/verification/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/verification/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/dist/verification/index.js

@@ -0,0 +1,11 @@
+/**
+ * Verification 模块 barrel（P3 4.5 + P4 C.1）
+ *
+ * 验证状态机 + 升级条件 + 升级工具入口 + 元认知评分
+ *
+ * @module @co-engram/core/verification
+ */
+export * from "./state-machine.js";
+export * from "./upgrade.js";
+export * from "./metacognition.js";
+//# sourceMappingURL=index.js.map

package/dist/verification/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/verification/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC"}

package/dist/verification/metacognition.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Metacognition 五维度真值评分（P4 C.1）
+ *
+ * 人类"元认知"机制的工程化映射：根据结构化证据自动判定 engram 真实性。
+ *
+ * 五维度（权重）：
+ *   crossContext      0.30  跨情境稳定性（不同 domainTag 出现次数）
+ *   timeStable        0.25  时间稳定性（ageDays,30 天饱和）
+ *   mutuallySupported 0.25  互相支持（extends+consolidates 占比）
+ *   sourceReliable    0.20  来源可靠性（createdBy 的可靠性分数）
+ *   executable        门槛  procedure kind 的可执行性（默认 0.5,不参与加权）
+ *
+ * 综合 score + thresholds → recommendation:
+ *   - upgrade_verified   :overall ≥ 0.85 且 ageDays ≥ 7
+ *   - upgrade_one_level  :overall ≥ 0.70
+ *   - refute             :overall < 0.30 且有 contradicts
+ *   - hold               :其他
+ *
+ * applyMetacognition 把 recommendation 落库（调 verification/upgrade.ts）。
+ *
+ * 设计原则：纯结构化,不调 LLM。每条 engram 评分 O(1)。
+ *
+ * @module @co-engram/core/verification
+ */
+import type { Engram, EngramId, VerificationStatus } from "../types/engram.js";
+import type { EngramRepository } from "../storage/repository.js";
+/** 元认知输入 */
+export interface TruthInput {
+    readonly engram: Engram;
+    /** synapse 统计（按 kind 分组计数） */
+    readonly synapseStats: {
+        readonly extends: number;
+        readonly consolidates: number;
+        readonly contradicts: number;
+        readonly derivesFrom: number;
+    };
+    /** engram 存在的天数 */
+    readonly ageDays: number;
+    /** 创建者可靠性分数 [0,1]（可选,默认 0.5） */
+    readonly createdByReliability?: number;
+}
+/** 五维度评分 */
+export interface TruthScore {
+    /** 综合分 [0,1] */
+    readonly overall: number;
+    /** 各维度原始分 */
+    readonly dimensions: Readonly<Record<TruthDimension, number>>;
+    /** 推荐动作 */
+    readonly recommendation: TruthRecommendation;
+    /** 人类可读的推理过程 */
+    readonly reasoning: string;
+}
+/** 五个维度名 */
+export type TruthDimension = "crossContext" | "timeStable" | "mutuallySupported" | "sourceReliable" | "executable";
+/** 推荐动作 */
+export type TruthRecommendation = "upgrade_verified" | "upgrade_one_level" | "refute" | "hold";
+/** 维度权重（executable 不参与加权,仅作门槛） */
+export declare const TRUTH_WEIGHTS: {
+    readonly crossContext: 0.3;
+    readonly timeStable: 0.25;
+    readonly mutuallySupported: 0.25;
+    readonly sourceReliable: 0.2;
+    readonly executable: 0;
+};
+/** 阈值 */
+export declare const TRUTH_THRESHOLDS: {
+    readonly upgradeVerifiedOverall: 0.85;
+    readonly upgradeVerifiedMinAgeDays: 7;
+    readonly upgradeOneLevelOverall: 0.7;
+    readonly refuteOverall: 0.3;
+};
+/** 时间稳定性饱和天数（30 天） */
+export declare const TIME_STABLE_SATURATION_DAYS = 30;
+/** 跨情境稳定性的 domainTag 饱和数（≥2 个 domain 视为跨情境） */
+export declare const CROSS_CONTEXT_SATURATION_DOMAINS = 2;
+/**
+ * 计算五维度真值评分（纯函数,不写库）
+ */
+export declare function computeTruthScore(input: TruthInput): TruthScore;
+/**
+ * 应用元认知评分到 engram（写库）
+ *
+ * 根据 recommendation：
+ *   - upgrade_verified   → 升级到 verified
+ *   - upgrade_one_level  → 升级一级（unverified → plausible → probable）
+ *   - refute             → refuteEngram（任意状态 → refuted）
+ *   - hold               → 不动
+ *
+ * 可选参数：
+ *   - ageDays: 覆盖自动计算的年龄（测试 / 强制重新评分用）
+ *   - createdByReliability: 创建者可靠性分数
+ */
+export declare function applyMetacognition(repo: EngramRepository, engramId: EngramId, input?: Partial<TruthInput>): Promise<TruthApplicationResult>;
+/** 应用结果 */
+export interface TruthApplicationResult {
+    readonly engramId: EngramId;
+    readonly score: TruthScore;
+    readonly applied: boolean;
+    readonly newStatus: VerificationStatus | undefined;
+    readonly reason: string;
+}
+//# sourceMappingURL=metacognition.d.ts.map

package/dist/verification/metacognition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metacognition.d.ts","sourceRoot":"","sources":["../../src/verification/metacognition.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAIjE,YAAY;AACZ,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,QAAQ,CAAC,YAAY,EAAE;QACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;QAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,mBAAmB;IACnB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,gCAAgC;IAChC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,MAAM,CAAC;CACxC;AAED,YAAY;AACZ,MAAM,WAAW,UAAU;IACzB,gBAAgB;IAChB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,aAAa;IACb,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;IAC9D,WAAW;IACX,QAAQ,CAAC,cAAc,EAAE,mBAAmB,CAAC;IAC7C,gBAAgB;IAChB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,YAAY;AACZ,MAAM,MAAM,cAAc,GACtB,cAAc,GACd,YAAY,GACZ,mBAAmB,GACnB,gBAAgB,GAChB,YAAY,CAAC;AAEjB,WAAW;AACX,MAAM,MAAM,mBAAmB,GAC3B,kBAAkB,GAClB,mBAAmB,GACnB,QAAQ,GACR,MAAM,CAAC;AAEX,kCAAkC;AAClC,eAAO,MAAM,aAAa;;;;;;CAMhB,CAAC;AAEX,SAAS;AACT,eAAO,MAAM,gBAAgB;;;;;CAKnB,CAAC;AAEX,sBAAsB;AACtB,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,+CAA+C;AAC/C,eAAO,MAAM,gCAAgC,IAAI,CAAC;AAElD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,UAAU,CAM/D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,gBAAgB,EACtB,QAAQ,EAAE,QAAQ,EAClB,KAAK,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAC1B,OAAO,CAAC,sBAAsB,CAAC,CAwEjC;AAED,WAAW;AACX,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB"}