@co-engram/core 0.1.0

package/dist/types/engram.d.ts

@@ -0,0 +1,203 @@
+/**
+ * Engram 基础类型定义
+ *
+ * @module @co-engram/core/types
+ */
+/** Engram 唯一标识符（路径形式，如 testing/adb/android-14-wireless-adb） */
+export type EngramId = string;
+/** Synapse 唯一标识符 */
+export type SynapseId = string;
+/** Skill 唯一标识符 */
+export type SkillId = string;
+/** Intention 唯一标识符 */
+export type IntentionId = string;
+/** Scene 唯一标识符 */
+export type SceneId = string;
+/**
+ * Engram kind 单标签
+ *
+ * 5 种基础类别，支持进化升级（observation → fact → pattern → procedure → hypothesis）
+ */
+export type EngramKind = "observation" | "fact" | "pattern" | "procedure" | "hypothesis";
+/** Engram 多标签（允许一条记忆同时属于多个类别） */
+export type EngramKinds = readonly EngramKind[];
+/**
+ * Engram 生命周期状态
+ *
+ * 神经科学依据：多级存储模型（海马 → 皮层 → 归档）
+ */
+export type EngramStatus = "draft" | "active" | "archived" | "forgotten";
+/**
+ * Engram 新鲜度（系统计算，不可手动设置）
+ *
+ * 基于 lastEffectiveAt + decayHalfLifeDays 计算
+ */
+export type EngramFreshness = "fresh" | "aging" | "stale" | "forgotten";
+/**
+ * 情绪效价
+ *
+ * 神经科学依据：杏仁核-海马交互。正性/负性事件通过不同回路处理。
+ */
+export type EmotionalValence = "positive" | "negative" | "neutral";
+/**
+ * 来源类型
+ *
+ * 默认 confidence：
+ *   firsthand: 0.85
+ *   secondhand: 0.65
+ *   inferred: 0.50
+ */
+export type EngramSourceType = "firsthand" | "secondhand" | "inferred";
+/**
+ * 可见性（访问控制）
+ *
+ * - public: 全团队可见
+ * - team: 特定团队可见
+ * - private: 仅创建者可见
+ * - restricted: 仅特定角色可见（如安全策略）
+ */
+export type EngramVisibility = "public" | "team" | "private" | "restricted";
+/**
+ * 认知模式（Scene Layer 1，神经科学固定的 5 种）
+ */
+export type CognitiveMode = "exploration" | "execution" | "reflection" | "emergency" | "learning";
+/**
+ * Engram 验证状态
+ *
+ * 状态机：unverified → plausible → probable → verified → refuted
+ */
+export type VerificationStatus = "unverified" | "plausible" | "probable" | "verified" | "refuted";
+/**
+ * 多维重要性向量（spec §8 字段表）
+ *
+ * personal/team/project 手动维护；network/temporal 派生；composite 加权聚合。
+ * 详见 src/importance/vector.ts。
+ */
+export interface ImportanceVector {
+    readonly personal: number;
+    readonly team: number;
+    readonly project: number;
+    readonly network: number;
+    readonly temporal: number;
+    readonly composite: number;
+}
+/**
+ * Catalog Entry（Tier 0，最小开销）
+ *
+ * 用于检索结果列表的最小展示单元
+ */
+export interface EngramCatalogEntry {
+    readonly id: EngramId;
+    readonly title: string;
+    readonly kind: EngramKind;
+    readonly domainTags: readonly string[];
+}
+/**
+ * Digest（Tier 1，再认）
+ *
+ * 用于检索结果展示，附加价值指标
+ */
+export interface EngramDigest extends EngramCatalogEntry {
+    readonly summary: string;
+    readonly importance: number;
+    readonly emotionalValence: EmotionalValence;
+    readonly freshness: EngramFreshness;
+    readonly updatedAt: string;
+    readonly contentSize: number;
+}
+/**
+ * Engram 完整对象（Tier 2/3/4 的聚合视图）
+ *
+ * 实际存储拆为三个文件：content.md / meta.yaml / synapses.yaml
+ * 本接口是读取后的合并视图
+ */
+export interface Engram {
+    readonly id: EngramId;
+    readonly title: string;
+    readonly contentHash: string;
+    readonly kind: EngramKind;
+    readonly kinds: EngramKinds;
+    readonly domainTags: readonly string[];
+    readonly content: string;
+    readonly summary: string;
+    readonly contentSize: number;
+    readonly createdBy: string;
+    readonly createdAt: string;
+    readonly updatedBy: string;
+    readonly updatedAt: string;
+    readonly encodingContext?: string;
+    readonly version: number;
+    readonly importance: number;
+    readonly confidence: number;
+    readonly emotionalValence: EmotionalValence;
+    readonly sourceType: EngramSourceType;
+    readonly evidenceCount: number;
+    readonly importanceVector?: ImportanceVector;
+    readonly retrievalCount: number;
+    readonly effectiveRetrievals: number;
+    readonly failedUses: number;
+    readonly lastRetrievedAt?: string;
+    readonly lastEffectiveAt?: string;
+    readonly reinforcementScore: number;
+    readonly decayHalfLifeDays: number | null;
+    /**
+     * 最近一次检索时计算出的相关性分数 [0,1]（P4 自动维护用）。
+     *
+     * 作为 RPE 公式的"预期值"基准：actual_signal - lastRetrievalScore。
+     * 老数据缺省为 0.5（中性）。
+     */
+    readonly lastRetrievalScore?: number;
+    readonly outgoingSynapseCount: number;
+    readonly incomingSynapseCount: number;
+    readonly activeContradictionCount: number;
+    readonly freshness: EngramFreshness;
+    readonly status: EngramStatus;
+    readonly contextTags: readonly string[];
+    readonly visibility: EngramVisibility;
+    readonly verificationStatus?: VerificationStatus;
+    /** 视角标识（spec §5.3 机制 3，多视角保留） */
+    readonly perspective?: string;
+}
+/**
+ * 创建 Engram 的输入参数（不包含系统计算字段）
+ */
+export interface EngramCreateInput {
+    readonly title: string;
+    readonly content: string;
+    readonly summary?: string;
+    readonly kind: EngramKind;
+    readonly kinds?: readonly EngramKind[];
+    readonly domainTags: readonly string[];
+    readonly contextTags?: readonly string[];
+    readonly encodingContext?: string;
+    readonly createdBy: string;
+    readonly emotionalValence?: EmotionalValence;
+    readonly sourceType?: EngramSourceType;
+    readonly importance?: number;
+    readonly confidence?: number;
+    readonly decayHalfLifeDays?: number | null;
+    readonly visibility?: EngramVisibility;
+    readonly importanceVector?: ImportanceVector;
+    readonly perspective?: string;
+}
+/**
+ * 更新 Engram 的输入参数（部分字段可变）
+ */
+export interface EngramUpdateInput {
+    readonly title?: string;
+    readonly content?: string;
+    readonly summary?: string;
+    readonly kinds?: readonly EngramKind[];
+    readonly domainTags?: readonly string[];
+    readonly contextTags?: readonly string[];
+    readonly encodingContext?: string;
+    readonly updatedBy: string;
+    readonly emotionalValence?: EmotionalValence;
+    readonly importance?: number;
+    readonly confidence?: number;
+    readonly decayHalfLifeDays?: number | null;
+    readonly visibility?: EngramVisibility;
+    readonly importanceVector?: ImportanceVector;
+    readonly perspective?: string;
+}
+//# sourceMappingURL=engram.d.ts.map

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

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

package/dist/types/engram.js

@@ -0,0 +1,7 @@
+/**
+ * Engram 基础类型定义
+ *
+ * @module @co-engram/core/types
+ */
+export {};
+//# sourceMappingURL=engram.js.map

package/dist/types/engram.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * 核心类型 barrel
+ *
+ * @module @co-engram/core/types
+ */
+export * from "./engram.js";
+export * from "./synapse.js";
+export * from "./skill.js";
+export * from "./intention.js";
+export * from "./scene.js";
+export * from "./disclosure.js";
+export * from "./repository-types.js";
+export * from "./synapse-id.js";
+export * from "./slugify.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,15 @@
+/**
+ * 核心类型 barrel
+ *
+ * @module @co-engram/core/types
+ */
+export * from "./engram.js";
+export * from "./synapse.js";
+export * from "./skill.js";
+export * from "./intention.js";
+export * from "./scene.js";
+export * from "./disclosure.js";
+export * from "./repository-types.js";
+export * from "./synapse-id.js";
+export * from "./slugify.js";
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC"}

package/dist/types/intention.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Intention 类型定义（前瞻记忆）
+ *
+ * 补全"未来"维度。
+ *
+ * @module @co-engram/core/types
+ */
+import type { EngramId, IntentionId, SceneId, SkillId } from "./engram.js";
+/** 时间触发 */
+export interface TimeBasedTrigger {
+    readonly kind: "time-based";
+    readonly at: string;
+    readonly recurrence?: string;
+}
+/** 事件触发 */
+export interface EventBasedTrigger {
+    readonly kind: "event-based";
+    readonly condition: string;
+    readonly detector: DetectorSpec;
+}
+/** 活动触发 */
+export interface ActivityBasedTrigger {
+    readonly kind: "activity-based";
+    readonly afterTask: TaskPattern;
+    readonly sceneAffinity?: SceneId;
+}
+/** 触发器联合类型 */
+export type IntentionTrigger = TimeBasedTrigger | EventBasedTrigger | ActivityBasedTrigger;
+/** 事件检测器规格 */
+export interface DetectorSpec {
+    readonly type: "logcat" | "file-change" | "http" | "process" | "custom";
+    readonly pattern: string;
+    readonly args?: Record<string, string>;
+}
+/** 任务模式 */
+export interface TaskPattern {
+    readonly taskType: string;
+    readonly args?: Record<string, string>;
+}
+/** 提醒动作 */
+export interface RemindAction {
+    readonly kind: "remind";
+    readonly message: string;
+}
+/** 验证动作 */
+export interface VerifyAction {
+    readonly kind: "verify";
+    readonly engramId: EngramId;
+    readonly check: string;
+}
+/** 执行动作 */
+export interface ExecuteAction {
+    readonly kind: "execute";
+    readonly skillId: SkillId;
+}
+/** 提议动作 */
+export interface ProposeAction {
+    readonly kind: "propose";
+    readonly hypothesisTemplate: string;
+}
+/** 动作联合类型 */
+export type IntentionAction = RemindAction | VerifyAction | ExecuteAction | ProposeAction;
+/** Intention 状态 */
+export type IntentionStatus = "pending" | "fired" | "snoozed" | "completed" | "cancelled";
+/** Intention 触发统计 */
+export interface IntentionStats {
+    readonly firedCount: number;
+    readonly effectivenessAfterFire: number;
+}
+/**
+ * Intention 完整对象
+ */
+export interface Intention {
+    readonly id: IntentionId;
+    readonly trigger: IntentionTrigger;
+    readonly action: IntentionAction;
+    readonly createdAt: string;
+    readonly createdBy: string;
+    readonly updatedAt: string;
+    readonly status: IntentionStatus;
+    readonly priority: number;
+    readonly stats: IntentionStats;
+}
+/** 创建 Intention 的输入 */
+export interface IntentionCreateInput {
+    readonly trigger: IntentionTrigger;
+    readonly action: IntentionAction;
+    readonly createdBy: string;
+    readonly priority?: number;
+}
+//# sourceMappingURL=intention.d.ts.map

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

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

package/dist/types/intention.js

@@ -0,0 +1,9 @@
+/**
+ * Intention 类型定义（前瞻记忆）
+ *
+ * 补全"未来"维度。
+ *
+ * @module @co-engram/core/types
+ */
+export {};
+//# sourceMappingURL=intention.js.map

package/dist/types/intention.js.map

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

package/dist/types/repository-types.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Co-Engram 仓库类型定义
+ *
+ * 核心概念:
+ * - `StableEngramId`: ULID 形式的 engram 标识,与文件路径解耦
+ * - `EngramIndex`: 派生缓存 {stableId → 文件元数据}
+ * - `DoctorReport`: 自愈扫描报告
+ * - `PathTreeNode`: 人类目录树
+ *
+ * @module @co-engram/core/types
+ */
+import type { EngramId } from "./engram.js";
+import type { EngramKind, VerificationStatus } from "./engram.js";
+/**
+ * Stable Engram ID(ULID,26 字符 Crockford Base32)
+ *
+ * 与物理路径解耦:文件移动/重命名不影响 id,所有 synapse 引用稳定。
+ *
+ * 仍以 string 表示以兼容旧调用者,但语义是 ULID。
+ */
+export type StableEngramId = EngramId & {
+    readonly __brand?: "StableEngramId";
+};
+/** ULID 正则(Crockford Base32, 26 字符) */
+export declare const ULID_REGEX: RegExp;
+/** 校验字符串是否为合法 ULID */
+export declare function isStableEngramId(value: string): value is StableEngramId;
+/**
+ * Engram 索引项(派生缓存)
+ *
+ * 单条 engram 在 `.co-engram/engram-index.json` 中的记录。
+ */
+export interface EngramIndexEntry {
+    /** Stable engram id (ULID) */
+    readonly id: StableEngramId;
+    /** 相对 dataRoot 的路径(可能因人类操作而变化) */
+    readonly path: string;
+    /** 文件标题(可能因人类编辑 frontmatter 而变化) */
+    readonly title: string;
+    /** 当前 slug(来自 frontmatter 显式 slug 或从 title 派生) */
+    readonly slug: string;
+    /** frontmatter 显式锁定 slug? */
+    readonly slugLocked: boolean;
+    /** domainTags(锁定或从路径推断) */
+    readonly domainTags: readonly string[];
+    /** frontmatter 锁定 domainTags? */
+    readonly domainTagsLocked: boolean;
+    /** 人类可读 tags */
+    readonly tags: readonly string[];
+    /** Engram kind */
+    readonly kind: EngramKind;
+    /** 验证状态 */
+    readonly verificationStatus?: VerificationStatus;
+    /** 创建时间 */
+    readonly createdAt: string;
+    /** 最后更新时间 */
+    readonly updatedAt: string;
+    /** 文件 mtime (epoch ms) - doctor 增量扫描用 */
+    readonly mtime: number;
+    /** 内容 sha256 - 触发搜索索引重建的依据 */
+    readonly contentHash: string;
+}
+/**
+ * engram-index.json 派生缓存文件
+ *
+ * 完整结构,见设计文档 §engram-index.json。
+ */
+export interface EngramIndex {
+    readonly version: 1;
+    readonly engrams: ReadonlyMap<StableEngramId, EngramIndexEntry> | Record<string, EngramIndexEntry>;
+    readonly lastRebuiltAt: string;
+}
+/**
+ * Doctor 扫描发现的问题
+ */
+export interface DoctorIssue {
+    readonly kind: "moved_file" | "title_changed" | "slug_conflict" | "missing_file" | "orphan_markdown" | "dangling_synapse" | "duplicate_id" | "duplicate_engram";
+    readonly stableId?: StableEngramId;
+    readonly path?: string;
+    readonly message: string;
+    /** doctor 是否已自动修复 */
+    readonly autoFixed: boolean;
+}
+/**
+ * Doctor 扫描报告
+ */
+export interface DoctorReport {
+    readonly startedAt: string;
+    readonly finishedAt: string;
+    readonly totalEngrams: number;
+    readonly totalSynapses: number;
+    readonly issues: readonly DoctorIssue[];
+    readonly fixes: readonly DoctorIssue[];
+    readonly pendingManualReview: readonly DoctorIssue[];
+}
+/**
+ * 目录树节点(渐进式披露 - 人类浏览层)
+ *
+ * 用于 viewer 和 engram_list_paths 工具。
+ */
+export interface PathTreeNode {
+    /** 相对 dataRoot 的目录路径(`""` 表示根) */
+    readonly path: string;
+    /** 当前目录直接包含的 engram 数 */
+    readonly engramCount: number;
+    /** 子目录 */
+    readonly children: readonly PathTreeNode[];
+    /** 累积检索次数(用于 activePaths signals) */
+    readonly retrievalCount?: number;
+    /** 最后活动时间(ISO) */
+    readonly lastActivity?: string;
+}
+//# sourceMappingURL=repository-types.d.ts.map

package/dist/types/repository-types.d.ts.map

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

package/dist/types/repository-types.js

@@ -0,0 +1,18 @@
+/**
+ * Co-Engram 仓库类型定义
+ *
+ * 核心概念:
+ * - `StableEngramId`: ULID 形式的 engram 标识,与文件路径解耦
+ * - `EngramIndex`: 派生缓存 {stableId → 文件元数据}
+ * - `DoctorReport`: 自愈扫描报告
+ * - `PathTreeNode`: 人类目录树
+ *
+ * @module @co-engram/core/types
+ */
+/** ULID 正则(Crockford Base32, 26 字符) */
+export const ULID_REGEX = /^[0-7][0-9A-HJKMNP-TV-Z]{25}$/;
+/** 校验字符串是否为合法 ULID */
+export function isStableEngramId(value) {
+    return ULID_REGEX.test(value);
+}
+//# sourceMappingURL=repository-types.js.map

package/dist/types/repository-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository-types.js","sourceRoot":"","sources":["../../src/types/repository-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAcH,uCAAuC;AACvC,MAAM,CAAC,MAAM,UAAU,GAAG,+BAA+B,CAAC;AAE1D,sBAAsB;AACtB,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC"}

package/dist/types/scene.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Scene 类型定义（状态依赖检索）
+ *
+ * 三层场景架构：
+ *   Layer 1 认知模式（5 种预设，神经科学固定）
+ *   Layer 2 领域场景（数据驱动进化）
+ *   Layer 3 当前情境（运行时）
+ *
+ * @module @co-engram/core/types
+ */
+import type { CognitiveMode, EngramId, SceneId } from "./engram.js";
+/** Layer 2 领域场景 */
+export interface Scene {
+    readonly id: SceneId;
+    readonly name: string;
+    readonly description: string;
+    readonly discoveredFrom: "manual" | "auto-clustered";
+    readonly affinityEngrams: readonly EngramId[];
+    readonly preferredCognitiveModes: readonly CognitiveMode[];
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+/** Layer 3 当前情境（运行时，隐式） */
+export interface CurrentContext {
+    readonly recentlyRetrieved: readonly {
+        readonly engramId: EngramId;
+        readonly retrievedAt: string;
+        readonly effectiveness?: number;
+    }[];
+    readonly activeTags: readonly string[];
+    readonly activeDomains: readonly string[];
+    readonly cognitiveMode: CognitiveMode;
+    readonly activeScene?: SceneId;
+}
+/** PrimingContext（启动效应） */
+export interface PrimingContext {
+    readonly recentlyRetrieved: readonly {
+        readonly engramId: EngramId;
+        readonly retrievedAt: string;
+        readonly effectiveness?: number;
+    }[];
+    readonly activeTags: readonly string[];
+    readonly activeDomains: readonly string[];
+    readonly halfLife: number;
+}
+/** 场景亲和度统计（派生缓存） */
+export interface SceneAffinity {
+    readonly sceneId: SceneId;
+    readonly engramCounts: Record<string, number>;
+    readonly lastActivatedAt: string;
+}
+//# sourceMappingURL=scene.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scene.d.ts","sourceRoot":"","sources":["../../src/types/scene.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEpE,mBAAmB;AACnB,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,EAAE,EAAE,OAAO,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,QAAQ,GAAG,gBAAgB,CAAC;IACrD,QAAQ,CAAC,eAAe,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC9C,QAAQ,CAAC,uBAAuB,EAAE,SAAS,aAAa,EAAE,CAAC;IAC3D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,2BAA2B;AAC3B,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,SAAS;QACnC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;KACjC,EAAE,CAAC;IACJ,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;CAChC;AAED,2BAA2B;AAC3B,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,iBAAiB,EAAE,SAAS;QACnC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;QAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;QAC7B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;KACjC,EAAE,CAAC;IACJ,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,oBAAoB;AACpB,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC"}

package/dist/types/scene.js

@@ -0,0 +1,12 @@
+/**
+ * Scene 类型定义（状态依赖检索）
+ *
+ * 三层场景架构：
+ *   Layer 1 认知模式（5 种预设，神经科学固定）
+ *   Layer 2 领域场景（数据驱动进化）
+ *   Layer 3 当前情境（运行时）
+ *
+ * @module @co-engram/core/types
+ */
+export {};
+//# sourceMappingURL=scene.js.map

package/dist/types/scene.js.map

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