@co-engram/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yang Yang
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,167 @@
+# Co-Engram
+
+**Team memory with neuroscience-inspired plasticity.**
+English | [中文](./README.zh-CN.md)
+
+Co-Engram is a self-evolving memory system for AI agents and teams. Unlike traditional vector stores that only retrieve, Co-Engram models memory after the brain: engrams strengthen with use, weaken when they fail, consolidate during sleep, and verify themselves through metacognition.
+
+Works with **Claude Code** (via MCP) and **OpenClaw** (via plugin SDK), with a host-agnostic TypeScript core you can embed anywhere.
+
+## Why Co-Engram
+
+| Differentiator            | What it means                                                                                                                                                                    |
+| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Three-file separation** | Every memory is split into `content.md` / `meta.yaml` / `synapses.yaml` so content diffs stay clean in Git while metadata evolves independently.                                 |
+| **Self-maintaining**      | A maintenance engine runs `light` (RPE-based reinforcement), `deep` (consolidation), and `rem` (metacognition upgrade/refute) stages automatically — no manual tagging required. |
+| **Host-agnostic core**    | `@co-engram/core` has zero host dependencies. Same memory, same tools, whether you use Claude Code, OpenClaw, or your own agent.                                                 |
+
+## Quickstart
+
+Three commands to get Co-Engram working inside Claude Code:
+
+```bash
+# 1. Install the MCP server globally
+npm install -g @co-engram/claude-code
+
+# 2. Initialize the data repo (a separate Git repo, not inside this project)
+mkdir -p ~/team-memory && cd ~/team-memory && git init
+
+# 3. Wire into Claude Code
+claude mcp add co-engram \
+  -e CO_ENGRAM_DATA_ROOT=$HOME/team-memory \
+  -e CO_ENGRAM_MAINTENANCE=1 \
+  --scope user \
+  -- co-engram-mcp
+```
+
+Restart Claude Code, run `/mcp` in a new session, and you should see 25 `co-engram` tools loaded.
+
+**Zero-install alternative** (skip step 1): replace `co-engram-mcp` in step 3 with `npx -y @co-engram/claude-code`.
+
+For OpenClaw integration, see [docs/host-openclaw.md](./docs/host-openclaw.md).
+
+## Architecture
+
+```mermaid
+flowchart TB
+  subgraph Host["Host layer"]
+    CC["Claude Code"]
+    OC["OpenClaw"]
+  end
+
+  subgraph Adapter["Adapter layer"]
+    A1["@co-engram/claude-code<br/>(MCP server, stdio)"]
+    A2["@co-engram/openclaw<br/>(plugin SDK)"]
+  end
+
+  subgraph Core["@co-engram/core<br/>(host-agnostic)"]
+    Tools["25 tools<br/>engrams · synapses · skills"]
+    Engine["Maintenance engine<br/>light · deep · rem"]
+    Retrieval["FTS + graph retrieval"]
+  end
+
+  subgraph Data["Data layer (separate Git repo)"]
+    Engrams["engrams/{content,meta,synapses}"]
+    Skills["skills/"]
+  end
+
+  subgraph Cache["Cache layer (gitignored)"]
+    Derived[".co-engram/<br/>FTS index · vectors"]
+  end
+
+  CC --> A1
+  OC --> A2
+  A1 --> Tools
+  A2 --> Tools
+  Tools --> Engine
+  Tools --> Retrieval
+  Retrieval --> Derived
+  Engine --> Data
+  Tools --> Data
+```
+
+## Packages
+
+| Package                                                | What it does                                                | Install                              |
+| ------------------------------------------------------ | ----------------------------------------------------------- | ------------------------------------ |
+| [`@co-engram/core`](./packages/core)                   | Host-agnostic memory engine + 25 tools + maintenance engine | `npm install @co-engram/core`        |
+| [`@co-engram/claude-code`](./packages/claude-code-mcp) | MCP server adapter for Claude Code                          | `npm install @co-engram/claude-code` |
+| [`@co-engram/openclaw`](./packages/openclaw-plugin)    | Plugin SDK adapter for OpenClaw                             | `npm install @co-engram/openclaw`    |
+| [`@co-engram/e2e`](./packages/e2e)                     | Cross-host end-to-end tests (private, not published)        | workspace only                       |
+
+## Tool Catalog
+
+Co-Engram exposes **25 native tools** grouped into five concerns, plus 2 OpenClaw-compatible `memory_*` wrappers (registered only under `@co-engram/openclaw`).
+
+**Engrams** (12) — the core memory units
+`engram_create` · `engram_get` · `engram_update` · `engram_delete` · `engram_search` · `engram_list` · `engram_reinforce` · `engram_report_failure` · `engram_archive` · `engram_restore` · `engram_forget` · `engram_recompute_importance`
+
+**Synapses** (4) — typed connections between engrams
+`synapse_create` · `synapse_get` · `synapse_list` · `synapse_delete`
+
+**Skills** (2) — procedural memory
+`skill_get` · `skill_invoke`
+
+**Learning loop** (4) — verification, contradiction, evolution
+`close_learning_loop` · `contradiction_resolve` · `upgrade_verification` · `get_evolution_lineage`
+
+**Memory proposals** (3) — implicit capture from conversations
+`engram_list_proposals` · `engram_accept_proposal` · `engram_dismiss_proposal`
+
+**OpenClaw memory protocol** (2) — host-compatible wrappers, registered only under `@co-engram/openclaw`
+`memory_search` · `memory_get`
+
+> The `memory_*` tools declare `kind: "memory"` in `openclaw.plugin.json` so OpenClaw treats Co-Engram as the primary memory plugin (mutually exclusive with `memory-core`). They are thin adapters over `engram_search` / `engram_get` that hide Co-Engram internal terminology and inject a self-evolving prompt section via `registerMemoryCapability.promptBuilder`.
+
+For full signatures, inputs, and examples, see [docs/tool-reference.md](./docs/tool-reference.md).
+
+## Configuration
+
+### Environment variables (Claude Code MCP server)
+
+All optional. Set them in `claude mcp add -e KEY=value` or your shell.
+
+| Variable                                  | Default              | Purpose                                                                                                                             |
+| ----------------------------------------- | -------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
+| `CO_ENGRAM_DATA_ROOT`                     | `$HOME/team-memory`  | Absolute path to the data Git repo                                                                                                  |
+| `CO_ENGRAM_DEFAULT_CREATED_BY`            | `unknown`            | Default author for new engrams                                                                                                      |
+| `CO_ENGRAM_LANGUAGE`                      | `en`                 | Language for tool descriptions / viewer UI / prompts (`en` \| `zh`). Falls back to `~/team-memory/.co-engram/config.json` if unset. |
+| `CO_ENGRAM_MAINTENANCE`                   | `0`                  | Set to `1` to start the maintenance engine                                                                                          |
+| `CO_ENGRAM_MAINTENANCE_ENABLED_STAGES`    | `light,deep,rem`     | Comma-separated stage list                                                                                                          |
+| `CO_ENGRAM_MAINTENANCE_LIGHT_INTERVAL_MS` | `300000` (5 min)     | Light stage interval                                                                                                                |
+| `CO_ENGRAM_MAINTENANCE_DEEP_INTERVAL_MS`  | `3600000` (1 hour)   | Deep stage interval                                                                                                                 |
+| `CO_ENGRAM_MAINTENANCE_REM_INTERVAL_MS`   | `604800000` (7 days) | REM stage interval                                                                                                                  |
+| `CO_ENGRAM_MAINTENANCE_LEARNING_RATE`     | `0.1`                | RPE learning rate                                                                                                                   |
+
+### OpenClaw manifest config
+
+For OpenClaw, configuration goes in the plugin manifest. See [docs/host-openclaw.md](./docs/host-openclaw.md) for the full schema.
+
+## Comparisons
+
+| Feature              | Co-Engram                 | mem0               | Letta            | LangChain Memory   |
+| -------------------- | ------------------------- | ------------------ | ---------------- | ------------------ |
+| Storage model        | 3-file Git-friendly       | Vector + graph     | Vector + state   | Vector / key-value |
+| Plasticity (LTP/LTD) | Yes (RPE-driven)          | Manual API         | Manual API       | Manual API         |
+| Auto maintenance     | Yes (light/deep/rem)      | No                 | No               | No                 |
+| Metacognition        | Yes (5-dim truth score)   | No                 | No               | No                 |
+| Host coupling        | None (host-agnostic core) | Tight (Python SDK) | Tight (REST API) | Tight (Python SDK) |
+| License              | MIT                       | Apache-2.0         | Apache-2.0       | MIT                |
+
+## Roadmap
+
+See [GitHub Issues](https://github.com/co-engram/co-engram/issues) for the live roadmap. Highlights:
+
+- **TypeDoc-generated tool reference** — replace hand-written `docs/tool-reference.md` with auto-generated API docs
+- **Provider-backed abstraction layer** — LLM-driven REM stage for narrative abstraction
+- **Web UI** — browse engrams, inspect synapse graph, trigger maintenance manually
+- **More host adapters** — Continue.dev, Cursor, Aider
+- **1.0 release** — once API is stable and we have real production users
+
+## Contributing
+
+Contributions are welcome. See [CONTRIBUTING.md](./CONTRIBUTING.md) for development setup, test commands, and PR conventions. For security reports, see [SECURITY.md](./SECURITY.md).
+
+## License
+
+[MIT](./LICENSE) — © 2026 Yang Yang

package/dist/config/defaults.d.ts

@@ -0,0 +1,45 @@
+/**
+ * 配置默认值
+ *
+ * @module @co-engram/core/config
+ */
+import type { AuditSectionConfig, EffectivenessSectionConfig, MaintenanceSectionConfig, ProposalsSectionConfig, ServerSectionConfig, ViewerSectionConfig } from "./types.js";
+import type { TrashMaintenanceConfig } from "../maintenance/types.js";
+/**
+ * Maintenance 默认值
+ *
+ * 间隔对齐 dreaming scheduler 的三阶段:light=5min, deep=1h, rem=7d。
+ * 学习率 0.1 来自 RPE 经验值。
+ *
+ * `enabled` 默认 true:遵循 low-friction-defaults(开箱即用)。
+ *   - 新仓库或 maintenance 段完全缺失时,自动启用。
+ *   - 老仓库若 config.json 已显式写 `enabled: false`,normalize 阶段尊重不动。
+ *   - 想禁用:在 config.json 写 `maintenance.enabled: false`。
+ */
+export declare const DEFAULT_MAINTENANCE_CONFIG: Readonly<Required<Omit<MaintenanceSectionConfig, "enabled" | "enabledStages" | "rules" | "trash">>> & {
+    readonly enabled: boolean;
+    readonly enabledStages: readonly ("light" | "deep" | "rem")[];
+};
+/** Proposals 默认值 */
+export declare const DEFAULT_PROPOSALS_CONFIG: Readonly<Required<ProposalsSectionConfig>>;
+/** Audit 默认值 */
+export declare const DEFAULT_AUDIT_CONFIG: Readonly<Required<AuditSectionConfig>>;
+/** Effectiveness 默认值 */
+export declare const DEFAULT_EFFECTIVENESS_CONFIG: Readonly<Required<EffectivenessSectionConfig>>;
+/** Viewer 默认值 */
+export declare const DEFAULT_VIEWER_CONFIG: Readonly<Required<Omit<ViewerSectionConfig, "url">>>;
+/** Server 默认值 */
+export declare const DEFAULT_SERVER_CONFIG: Readonly<Required<ServerSectionConfig>>;
+/**
+ * Trash 默认值
+ *
+ * `enabled` 默认 true:遵循 low-friction-defaults。
+ *   - 新仓库或 trash 段缺失时,自动启用 trash sweep。
+ *   - 老仓库若 config.json 已显式写 `trash.enabled: false`,normalize 阶段尊重不动。
+ *   - 想禁用:在 config.json 写 `maintenance.trash.enabled: false`。
+ *
+ * trash sweep 是非破坏:遗忘后 30 天才进 trash,365 天后才物理删除,
+ * 期间可 restore,安全边界足够默认开启。
+ */
+export declare const DEFAULT_TRASH_CONFIG: Readonly<Required<TrashMaintenanceConfig>>;
+//# sourceMappingURL=defaults.d.ts.map

package/dist/config/defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.d.ts","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAEtE;;;;;;;;;;GAUG;AACH,eAAO,MAAM,0BAA0B,EAAE,QAAQ,CAC/C,QAAQ,CACN,IAAI,CACF,wBAAwB,EACxB,SAAS,GAAG,eAAe,GAAG,OAAO,GAAG,OAAO,CAChD,CACF,CACF,GAAG;IACF,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,SAAS,CAAC,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC,EAAE,CAAC;CAU/D,CAAC;AAEF,oBAAoB;AACpB,eAAO,MAAM,wBAAwB,EAAE,QAAQ,CAC7C,QAAQ,CAAC,sBAAsB,CAAC,CAQjC,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAEvE,CAAC;AAEF,wBAAwB;AACxB,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CACjD,QAAQ,CAAC,0BAA0B,CAAC,CAGrC,CAAC;AAEF,iBAAiB;AACjB,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAC1C,QAAQ,CAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC,CAI3C,CAAC;AAEF,iBAAiB;AACjB,eAAO,MAAM,qBAAqB,EAAE,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAGzE,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CAAC,QAAQ,CAAC,sBAAsB,CAAC,CAKzE,CAAC"}

package/dist/config/defaults.js

@@ -0,0 +1,70 @@
+/**
+ * 配置默认值
+ *
+ * @module @co-engram/core/config
+ */
+/**
+ * Maintenance 默认值
+ *
+ * 间隔对齐 dreaming scheduler 的三阶段:light=5min, deep=1h, rem=7d。
+ * 学习率 0.1 来自 RPE 经验值。
+ *
+ * `enabled` 默认 true:遵循 low-friction-defaults(开箱即用)。
+ *   - 新仓库或 maintenance 段完全缺失时,自动启用。
+ *   - 老仓库若 config.json 已显式写 `enabled: false`,normalize 阶段尊重不动。
+ *   - 想禁用:在 config.json 写 `maintenance.enabled: false`。
+ */
+export const DEFAULT_MAINTENANCE_CONFIG = {
+    enabled: true,
+    enabledStages: ["light", "deep", "rem"],
+    lightIntervalMs: 5 * 60 * 1000,
+    deepIntervalMs: 60 * 60 * 1000,
+    remIntervalMs: 7 * 24 * 60 * 60 * 1000,
+    signalPruneAgeMs: 7 * 24 * 60 * 60 * 1000,
+    learningRate: 0.1,
+    windowSize: 10,
+};
+/** Proposals 默认值 */
+export const DEFAULT_PROPOSALS_CONFIG = {
+    enabled: true,
+    threshold: 3,
+    similarityThreshold: 0.65,
+    maxSamples: 8,
+    minMessageLength: 16,
+    defaultDismissDays: 7,
+};
+/** Audit 默认值 */
+export const DEFAULT_AUDIT_CONFIG = {
+    enabled: true,
+};
+/** Effectiveness 默认值 */
+export const DEFAULT_EFFECTIVENESS_CONFIG = {
+    enabled: true,
+};
+/** Viewer 默认值 */
+export const DEFAULT_VIEWER_CONFIG = {
+    enabled: true,
+    port: 18799,
+};
+/** Server 默认值 */
+export const DEFAULT_SERVER_CONFIG = {
+    name: "co-engram",
+    version: "0.0.0",
+};
+/**
+ * Trash 默认值
+ *
+ * `enabled` 默认 true:遵循 low-friction-defaults。
+ *   - 新仓库或 trash 段缺失时,自动启用 trash sweep。
+ *   - 老仓库若 config.json 已显式写 `trash.enabled: false`,normalize 阶段尊重不动。
+ *   - 想禁用:在 config.json 写 `maintenance.trash.enabled: false`。
+ *
+ * trash sweep 是非破坏:遗忘后 30 天才进 trash,365 天后才物理删除,
+ * 期间可 restore,安全边界足够默认开启。
+ */
+export const DEFAULT_TRASH_CONFIG = {
+    enabled: true,
+    afterDays: 30,
+    purgeAfterDays: 365,
+};
+//# sourceMappingURL=defaults.js.map

package/dist/config/defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defaults.js","sourceRoot":"","sources":["../../src/config/defaults.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAUnC;IACF,OAAO,EAAE,IAAI;IACb,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC;IACvC,eAAe,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI;IAC9B,cAAc,EAAE,EAAE,GAAG,EAAE,GAAG,IAAI;IAC9B,aAAa,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;IACtC,gBAAgB,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI;IACzC,YAAY,EAAE,GAAG;IACjB,UAAU,EAAE,EAAE;CACf,CAAC;AAEF,oBAAoB;AACpB,MAAM,CAAC,MAAM,wBAAwB,GAEjC;IACF,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,CAAC;IACZ,mBAAmB,EAAE,IAAI;IACzB,UAAU,EAAE,CAAC;IACb,gBAAgB,EAAE,EAAE;IACpB,kBAAkB,EAAE,CAAC;CACtB,CAAC;AAEF,gBAAgB;AAChB,MAAM,CAAC,MAAM,oBAAoB,GAA2C;IAC1E,OAAO,EAAE,IAAI;CACd,CAAC;AAEF,wBAAwB;AACxB,MAAM,CAAC,MAAM,4BAA4B,GAErC;IACF,OAAO,EAAE,IAAI;CACd,CAAC;AAEF,iBAAiB;AACjB,MAAM,CAAC,MAAM,qBAAqB,GAE9B;IACF,OAAO,EAAE,IAAI;IACb,IAAI,EAAE,KAAK;CACZ,CAAC;AAEF,iBAAiB;AACjB,MAAM,CAAC,MAAM,qBAAqB,GAA4C;IAC5E,IAAI,EAAE,WAAW;IACjB,OAAO,EAAE,OAAO;CACjB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAC/B;IACE,OAAO,EAAE,IAAI;IACb,SAAS,EAAE,EAAE;IACb,cAAc,EAAE,GAAG;CACpB,CAAC"}

package/dist/config/index.d.ts

@@ -0,0 +1,84 @@
+/**
+ * 配置加载与自愈
+ *
+ * 本模块是 co-engram 配置的**单一权威入口**。
+ *
+ * 设计:
+ *   - dataRoot 内 `.co-engram/config.json` 是配置的权威来源
+ *   - env 仅保留 `CO_ENGRAM_DATA_ROOT`(bootstrap 引导,无法自举)和 `CO_ENGRAM_VIEWER_TOKEN`(敏感)
+ *   - 字段缺失时用默认值补齐并立即写回(自愈)
+ *   - 旧字段(`desiredAuditEnabled` 等)在加载时迁移到嵌套字段
+ *   - JSON 损坏时备份原文件后写默认配置,绝不静默覆盖用户数据
+ *
+ * @module @co-engram/core/config
+ */
+import type { TeamMemoryConfig } from "./types.js";
+export type { TeamMemoryConfig, MaintenanceSectionConfig, ProposalsSectionConfig, AuditSectionConfig, EffectivenessSectionConfig, ViewerSectionConfig, ServerSectionConfig, } from "./types.js";
+export type { MaintenanceConfig, MaintenanceStage, TrashMaintenanceConfig, } from "../maintenance/types.js";
+export type { ProposalEngineConfig } from "../observability/proposal-engine.js";
+/** config 文件名(放在 dataRoot/.co-engram/ 下) */
+export declare const TEAM_MEMORY_CONFIG_FILENAME = "config.json";
+/**
+ * 自愈默认 config(用于首次创建 / 文件损坏时重建)
+ *
+ * 注意:`createdAt` 留空,由调用方按当前时间填入。
+ */
+export declare function createDefaultConfig(): TeamMemoryConfig;
+/**
+ * 规范化 config:补默认值
+ *
+ * 输入是 readTeamMemoryConfig 的原始解析结果(可能缺字段),
+ * 输出保证完整:所有子系统字段齐全。
+ *
+ * 幂等:对已规范化的 config 调用此函数,返回值结构等价。
+ */
+export declare function normalizeConfig(raw: Readonly<TeamMemoryConfig> | undefined): TeamMemoryConfig;
+/**
+ * config.json 在 dataRoot 内的完整路径
+ */
+export declare function resolveConfigPath(dataRoot: string): string;
+/**
+ * 读取 config(原始,不做迁移)
+ *
+ * 文件不存在或 JSON 解析失败时返回 undefined。
+ * 想要"自愈 + 完整 config"请用 {@link loadAndSelfHealConfig}。
+ */
+export declare function readTeamMemoryConfig(dataRoot: string, fsRead?: (path: string) => Promise<string>): Promise<TeamMemoryConfig | undefined>;
+/**
+ * 写入 config(完整覆盖)
+ */
+export declare function writeTeamMemoryConfig(dataRoot: string, config: TeamMemoryConfig, fsWrite?: (path: string, content: string) => Promise<void>): Promise<void>;
+/**
+ * 加载结果:包含最终 config 以及加载过程中发生的事件(供调用方决策日志)
+ */
+export interface LoadResult {
+    /** 规范化后的完整 config(子系统字段齐全) */
+    readonly config: TeamMemoryConfig;
+    /**
+     * 加载事件:
+     *   - `created`:文件不存在,新建了默认 config
+     *   - `normalized`:文件存在但字段缺失或有旧字段,迁移后写回
+     *   - `repaired`:文件存在但 JSON 损坏,备份后重建默认 config
+     *   - `loaded`:文件存在且完整,未触发写回
+     */
+    readonly event: "created" | "normalized" | "repaired" | "loaded";
+    /** 损坏时的备份路径(仅 event='repaired' 时存在) */
+    readonly backupPath?: string;
+}
+/**
+ * 加载 config 并自愈
+ *
+ * 行为:
+ *   1. 文件不存在 → 写入默认 config,返回 `{ event: 'created' }`
+ *   2. 文件存在但 JSON 损坏 → 备份为 `config.json.broken.<ts>` 后写默认,返回 `{ event: 'repaired', backupPath }`
+ *   3. 文件存在且合法但字段缺失/有旧字段 → 规范化后写回,返回 `{ event: 'normalized' }`
+ *   4. 文件存在且完整 → 直接返回,返回 `{ event: 'loaded' }`
+ */
+export declare function loadAndSelfHealConfig(dataRoot: string): Promise<LoadResult>;
+/**
+ * 仅把 `desiredDataRoot` 一个字段写入 config.json(用于 viewer redirect hint)
+ *
+ * 不修改其他字段(viewer 切 dataRoot 时不破坏现有 config)。
+ */
+export declare function setDesiredDataRoot(dataRoot: string, desiredDataRoot: string | undefined): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/config/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAWnD,YAAY,EACV,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACtB,kBAAkB,EAClB,0BAA0B,EAC1B,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AACpB,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,sBAAsB,GACvB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAEhF,4CAA4C;AAC5C,eAAO,MAAM,2BAA2B,gBAAgB,CAAC;AAEzD;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,gBAAgB,CActD;AA2CD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GAAG,SAAS,GAC1C,gBAAgB,CAGlB;AAsCD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,GACzC,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAYvC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GACzD,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,8BAA8B;IAC9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC;;;;;;OAMG;IACH,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,YAAY,GAAG,UAAU,GAAG,QAAQ,CAAC;IACjE,uCAAuC;IACvC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,UAAU,CAAC,CA4CrB;AAED;;;;GAIG;AACH,wBAAsB,kBAAkB,CACtC,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,MAAM,GAAG,SAAS,GAClC,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/config/index.js

@@ -0,0 +1,230 @@
+/**
+ * 配置加载与自愈
+ *
+ * 本模块是 co-engram 配置的**单一权威入口**。
+ *
+ * 设计:
+ *   - dataRoot 内 `.co-engram/config.json` 是配置的权威来源
+ *   - env 仅保留 `CO_ENGRAM_DATA_ROOT`(bootstrap 引导,无法自举)和 `CO_ENGRAM_VIEWER_TOKEN`(敏感)
+ *   - 字段缺失时用默认值补齐并立即写回(自愈)
+ *   - 旧字段(`desiredAuditEnabled` 等)在加载时迁移到嵌套字段
+ *   - JSON 损坏时备份原文件后写默认配置,绝不静默覆盖用户数据
+ *
+ * @module @co-engram/core/config
+ */
+import { DEFAULT_AUDIT_CONFIG, DEFAULT_EFFECTIVENESS_CONFIG, DEFAULT_MAINTENANCE_CONFIG, DEFAULT_PROPOSALS_CONFIG, DEFAULT_SERVER_CONFIG, DEFAULT_TRASH_CONFIG, DEFAULT_VIEWER_CONFIG, } from "./defaults.js";
+/** config 文件名(放在 dataRoot/.co-engram/ 下) */
+export const TEAM_MEMORY_CONFIG_FILENAME = "config.json";
+/**
+ * 自愈默认 config(用于首次创建 / 文件损坏时重建)
+ *
+ * 注意:`createdAt` 留空,由调用方按当前时间填入。
+ */
+export function createDefaultConfig() {
+    return {
+        version: 1,
+        language: "zh",
+        maintenance: {
+            ...DEFAULT_MAINTENANCE_CONFIG,
+            trash: { ...DEFAULT_TRASH_CONFIG },
+        },
+        proposals: { ...DEFAULT_PROPOSALS_CONFIG },
+        audit: { ...DEFAULT_AUDIT_CONFIG },
+        effectiveness: { ...DEFAULT_EFFECTIVENESS_CONFIG },
+        viewer: { ...DEFAULT_VIEWER_CONFIG },
+        server: { ...DEFAULT_SERVER_CONFIG },
+    };
+}
+/**
+ * 用默认值补齐缺失的子系统字段
+ */
+function fillDefaults(raw) {
+    const maintenance = {
+        ...DEFAULT_MAINTENANCE_CONFIG,
+        ...(raw.maintenance ?? {}),
+        trash: {
+            ...DEFAULT_TRASH_CONFIG,
+            ...(raw.maintenance?.trash ?? {}),
+        },
+    };
+    return {
+        ...raw,
+        maintenance,
+        audit: { ...DEFAULT_AUDIT_CONFIG, ...(raw.audit ?? {}) },
+        proposals: { ...DEFAULT_PROPOSALS_CONFIG, ...(raw.proposals ?? {}) },
+        effectiveness: {
+            ...DEFAULT_EFFECTIVENESS_CONFIG,
+            ...(raw.effectiveness ?? {}),
+        },
+        viewer: { ...DEFAULT_VIEWER_CONFIG, ...(raw.viewer ?? {}) },
+        server: { ...DEFAULT_SERVER_CONFIG, ...(raw.server ?? {}) },
+    };
+}
+/**
+ * 检测 raw config 是否需要规范化(字段缺失)
+ */
+function needsNormalize(raw) {
+    if (raw.maintenance === undefined)
+        return true;
+    if (raw.proposals === undefined)
+        return true;
+    if (raw.audit === undefined)
+        return true;
+    if (raw.effectiveness === undefined)
+        return true;
+    if (raw.viewer === undefined)
+        return true;
+    if (raw.server === undefined)
+        return true;
+    if (raw.maintenance?.trash === undefined)
+        return true;
+    return false;
+}
+/**
+ * 规范化 config:补默认值
+ *
+ * 输入是 readTeamMemoryConfig 的原始解析结果(可能缺字段),
+ * 输出保证完整:所有子系统字段齐全。
+ *
+ * 幂等:对已规范化的 config 调用此函数,返回值结构等价。
+ */
+export function normalizeConfig(raw) {
+    const base = raw ?? createDefaultConfig();
+    return fillDefaults(base);
+}
+// --- 读写原语 ---
+async function defaultReadFile(path) {
+    const { readFile } = await import("node:fs/promises");
+    return await readFile(path, "utf-8");
+}
+async function defaultWriteFile(path, content) {
+    const { writeFile, mkdir } = await import("node:fs/promises");
+    const { dirname } = await import("node:path");
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, content, "utf-8");
+}
+async function defaultBackupFile(path, backupPath) {
+    const { rename } = await import("node:fs/promises");
+    await rename(path, backupPath);
+}
+async function fileExists(path) {
+    const { stat } = await import("node:fs/promises");
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function joinPath(...segments) {
+    return segments.filter(Boolean).join("/").replace(/\/+/g, "/");
+}
+/**
+ * config.json 在 dataRoot 内的完整路径
+ */
+export function resolveConfigPath(dataRoot) {
+    return joinPath(dataRoot, ".co-engram", TEAM_MEMORY_CONFIG_FILENAME);
+}
+/**
+ * 读取 config(原始,不做迁移)
+ *
+ * 文件不存在或 JSON 解析失败时返回 undefined。
+ * 想要"自愈 + 完整 config"请用 {@link loadAndSelfHealConfig}。
+ */
+export async function readTeamMemoryConfig(dataRoot, fsRead) {
+    const path = resolveConfigPath(dataRoot);
+    try {
+        const content = fsRead ? await fsRead(path) : await defaultReadFile(path);
+        const parsed = JSON.parse(content);
+        if (parsed && typeof parsed === "object" && parsed.version === 1) {
+            return parsed;
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * 写入 config(完整覆盖)
+ */
+export async function writeTeamMemoryConfig(dataRoot, config, fsWrite) {
+    const path = resolveConfigPath(dataRoot);
+    const content = JSON.stringify(config, null, 2) + "\n";
+    if (fsWrite) {
+        await fsWrite(path, content);
+        return;
+    }
+    await defaultWriteFile(path, content);
+}
+/**
+ * 加载 config 并自愈
+ *
+ * 行为:
+ *   1. 文件不存在 → 写入默认 config,返回 `{ event: 'created' }`
+ *   2. 文件存在但 JSON 损坏 → 备份为 `config.json.broken.<ts>` 后写默认,返回 `{ event: 'repaired', backupPath }`
+ *   3. 文件存在且合法但字段缺失/有旧字段 → 规范化后写回,返回 `{ event: 'normalized' }`
+ *   4. 文件存在且完整 → 直接返回,返回 `{ event: 'loaded' }`
+ */
+export async function loadAndSelfHealConfig(dataRoot) {
+    const path = resolveConfigPath(dataRoot);
+    const exists = await fileExists(path);
+    if (!exists) {
+        const config = createDefaultConfig();
+        await writeTeamMemoryConfig(dataRoot, config);
+        return { config, event: "created" };
+    }
+    let raw;
+    let parseFailed = false;
+    try {
+        const content = await defaultReadFile(path);
+        const parsed = JSON.parse(content);
+        if (parsed && typeof parsed === "object" && parsed.version === 1) {
+            raw = parsed;
+        }
+        else {
+            parseFailed = true;
+        }
+    }
+    catch {
+        parseFailed = true;
+    }
+    if (parseFailed || raw === undefined) {
+        const ts = new Date().toISOString().replace(/[:.]/g, "-");
+        const backupPath = `${path}.broken.${ts}`;
+        try {
+            await defaultBackupFile(path, backupPath);
+        }
+        catch {
+            // 备份失败不阻塞,继续写默认
+        }
+        const config = createDefaultConfig();
+        await writeTeamMemoryConfig(dataRoot, config);
+        return { config, event: "repaired", backupPath };
+    }
+    if (!needsNormalize(raw)) {
+        return { config: raw, event: "loaded" };
+    }
+    const normalized = normalizeConfig(raw);
+    await writeTeamMemoryConfig(dataRoot, normalized);
+    return { config: normalized, event: "normalized" };
+}
+/**
+ * 仅把 `desiredDataRoot` 一个字段写入 config.json(用于 viewer redirect hint)
+ *
+ * 不修改其他字段(viewer 切 dataRoot 时不破坏现有 config)。
+ */
+export async function setDesiredDataRoot(dataRoot, desiredDataRoot) {
+    const current = await readTeamMemoryConfig(dataRoot);
+    const base = current ?? createDefaultConfig();
+    const next = desiredDataRoot
+        ? { ...base, desiredDataRoot }
+        : (() => {
+            const { desiredDataRoot: _drop, ...rest } = base;
+            void _drop;
+            return rest;
+        })();
+    await writeTeamMemoryConfig(dataRoot, next);
+}
+//# sourceMappingURL=index.js.map

package/dist/config/index.js.map

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