omnimemory-cli 0.1.0

package/scripts/uninstall.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_HOME="${OMNIMEMORY_HOME:-$HOME/.omnimemory}"
+CONFIG_FILE="$TARGET_HOME/omnimemory.config.json"
+
+if [[ ! -f "$CONFIG_FILE" ]]; then
+  echo "No OmniMemory install found at: $TARGET_HOME"
+  exit 0
+fi
+
+rm -rf "$TARGET_HOME"
+echo "Removed OmniMemory install at: $TARGET_HOME"

package/scripts/verify_phase_a.sh

@@ -0,0 +1,52 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+required_files=(
+  "README.md"
+  "docs/architecture.md"
+  "docs/decisions.md"
+  "docs/integration-spec.md"
+  "docs/sync-and-adapters.md"
+  "docs/phase-workflow.md"
+  "docs/install-uninstall.md"
+  "docs/webui-plan.md"
+  "spec/protocol.md"
+  "spec/memory-envelope.schema.json"
+  "spec/memory-event.schema.json"
+  "db/schema.sql"
+  "scripts/install.sh"
+  "scripts/uninstall.sh"
+  "scripts/attach_project.sh"
+  "scripts/detach_project.sh"
+  "templates/project-minimal/.omni-memory.json"
+)
+
+missing=0
+for f in "${required_files[@]}"; do
+  if [[ ! -f "$ROOT_DIR/$f" ]]; then
+    echo "[FAIL] missing $f"
+    missing=1
+  fi
+done
+
+if [[ $missing -ne 0 ]]; then
+  exit 1
+fi
+
+echo "[OK] required files present"
+
+if command -v sqlite3 >/dev/null 2>&1; then
+  tmpdb="$(mktemp "${TMPDIR:-/tmp}/omnimemory.verify.XXXXXX.db")"
+  sqlite3 "$tmpdb" < "$ROOT_DIR/db/schema.sql"
+  table_count="$(sqlite3 "$tmpdb" "SELECT count(*) FROM sqlite_master WHERE type IN ('table','view');")"
+  signal_col_count="$(sqlite3 "$tmpdb" "SELECT count(*) FROM pragma_table_info('memories') WHERE name IN ('importance_score','confidence_score','stability_score','reuse_count','volatility_score');")"
+  rm -f "$tmpdb"
+  echo "[OK] sqlite schema applies, table/view count=$table_count"
+  echo "[OK] memory signals columns count=$signal_col_count"
+else
+  echo "[WARN] sqlite3 not found; schema apply check skipped"
+fi
+
+echo "[OK] Phase A verification completed"

package/scripts/verify_phase_b.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+required_files=(
+  "omnimemory/cli.py"
+  "omnimemory/core.py"
+  "bin/omnimemory"
+  "tests/test_cli_mvp.sh"
+)
+
+for f in "${required_files[@]}"; do
+  [[ -f "$ROOT_DIR/$f" ]] || { echo "[FAIL] missing $f"; exit 1; }
+done
+
+echo "[OK] phase-b files present"
+
+bash "$ROOT_DIR/tests/test_cli_mvp.sh"
+
+echo "[OK] Phase B verification completed"

package/scripts/verify_phase_c.sh

@@ -0,0 +1,19 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+required_files=(
+  "omnimemory/adapters.py"
+  "tests/test_phase_c_adapters.sh"
+)
+
+for f in "${required_files[@]}"; do
+  [[ -f "$ROOT_DIR/$f" ]] || { echo "[FAIL] missing $f"; exit 1; }
+done
+
+echo "[OK] phase-c files present"
+
+bash "$ROOT_DIR/tests/test_phase_c_adapters.sh"
+
+echo "[OK] Phase C verification completed"

package/scripts/verify_phase_d.sh

@@ -0,0 +1,28 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+
+required_files=(
+  "omnimemory/webui.py"
+  "tests/test_phase_d_webui.sh"
+  "scripts/bootstrap.sh"
+  "tests/test_bootstrap.sh"
+  "tests/test_bootstrap_cli_cmd.sh"
+  "tests/test_uninstall_cli.sh"
+)
+
+for f in "${required_files[@]}"; do
+  [[ -f "$ROOT_DIR/$f" ]] || { echo "[FAIL] missing $f"; exit 1; }
+done
+
+echo "[OK] phase-d files present"
+
+python3 -m py_compile "$ROOT_DIR/omnimemory/webui.py"
+
+bash "$ROOT_DIR/tests/test_phase_d_webui.sh"
+bash "$ROOT_DIR/tests/test_bootstrap.sh"
+bash "$ROOT_DIR/tests/test_bootstrap_cli_cmd.sh"
+bash "$ROOT_DIR/tests/test_uninstall_cli.sh"
+
+echo "[OK] Phase D verification completed"

package/spec/changelog.md

@@ -0,0 +1,14 @@
+# Schema Changelog
+
+## v0.1.0 (2026-02-08)
+
+- 初始化 `MemoryEnvelope` 与 `MemoryEvent` schema。
+- 定义四层记忆模型与事件类型。
+- 约束凭据引用格式，禁止明文密钥。
+- 新增 `signals` 字段：
+  - `importance_score`
+  - `confidence_score`
+  - `stability_score`
+  - `reuse_count`
+  - `volatility_score`
+- SQLite `memories` 表新增上述信号列与索引，用于分层提升/降级决策。

package/spec/memory-envelope.schema.json

@@ -0,0 +1,111 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://omnimemory.dev/schema/memory-envelope.schema.json",
+  "title": "MemoryEnvelope",
+  "type": "object",
+  "required": [
+    "id",
+    "schema_version",
+    "created_at",
+    "updated_at",
+    "layer",
+    "kind",
+    "summary",
+    "body_md_path",
+    "tags",
+    "refs",
+    "signals",
+    "cred_refs",
+    "source",
+    "scope",
+    "integrity"
+  ],
+  "properties": {
+    "id": { "type": "string", "minLength": 8 },
+    "schema_version": { "type": "string" },
+    "created_at": { "type": "string", "format": "date-time" },
+    "updated_at": { "type": "string", "format": "date-time" },
+    "layer": {
+      "type": "string",
+      "enum": ["instant", "short", "long", "archive"]
+    },
+    "kind": {
+      "type": "string",
+      "enum": ["note", "decision", "task", "checkpoint", "summary", "evidence"]
+    },
+    "summary": { "type": "string", "minLength": 1 },
+    "body_md_path": { "type": "string", "minLength": 1 },
+    "tags": {
+      "type": "array",
+      "items": { "type": "string" },
+      "default": []
+    },
+    "refs": {
+      "type": "array",
+      "items": {
+        "type": "object",
+        "required": ["type", "target"],
+        "properties": {
+          "type": { "type": "string", "enum": ["memory", "file", "url", "notion", "r2"] },
+          "target": { "type": "string" },
+          "note": { "type": "string" }
+        },
+        "additionalProperties": false
+      },
+      "default": []
+    },
+    "signals": {
+      "type": "object",
+      "required": [
+        "importance_score",
+        "confidence_score",
+        "stability_score",
+        "reuse_count",
+        "volatility_score"
+      ],
+      "properties": {
+        "importance_score": { "type": "number", "minimum": 0, "maximum": 1 },
+        "confidence_score": { "type": "number", "minimum": 0, "maximum": 1 },
+        "stability_score": { "type": "number", "minimum": 0, "maximum": 1 },
+        "reuse_count": { "type": "integer", "minimum": 0 },
+        "volatility_score": { "type": "number", "minimum": 0, "maximum": 1 }
+      },
+      "additionalProperties": false
+    },
+    "cred_refs": {
+      "type": "array",
+      "items": { "type": "string", "pattern": "^(op|env|aws-sm|gcp-sm)://.+" },
+      "default": []
+    },
+    "source": {
+      "type": "object",
+      "required": ["tool", "session_id"],
+      "properties": {
+        "tool": { "type": "string" },
+        "account": { "type": "string" },
+        "device": { "type": "string" },
+        "session_id": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "scope": {
+      "type": "object",
+      "required": ["project_id"],
+      "properties": {
+        "project_id": { "type": "string" },
+        "workspace": { "type": "string" }
+      },
+      "additionalProperties": false
+    },
+    "integrity": {
+      "type": "object",
+      "required": ["content_sha256", "envelope_version"],
+      "properties": {
+        "content_sha256": { "type": "string", "pattern": "^[a-f0-9]{64}$" },
+        "envelope_version": { "type": "integer", "minimum": 1 }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false
+}

package/spec/memory-event.schema.json

@@ -0,0 +1,31 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://omnimemory.dev/schema/memory-event.schema.json",
+  "title": "MemoryEvent",
+  "type": "object",
+  "required": [
+    "event_id",
+    "event_type",
+    "event_time",
+    "memory_id",
+    "payload"
+  ],
+  "properties": {
+    "event_id": { "type": "string", "minLength": 8 },
+    "event_type": {
+      "type": "string",
+      "enum": [
+        "memory.write",
+        "memory.update",
+        "memory.checkpoint",
+        "memory.promote",
+        "memory.verify",
+        "memory.sync"
+      ]
+    },
+    "event_time": { "type": "string", "format": "date-time" },
+    "memory_id": { "type": "string", "minLength": 8 },
+    "payload": { "type": "object" }
+  },
+  "additionalProperties": false
+}

package/spec/protocol.md

@@ -0,0 +1,78 @@
+# OmniMemory 协议规范 v0.1.0
+
+## 1. 版本与兼容
+
+- 协议版本：`0.1.0`
+- 语义化版本：
+  - `MAJOR`：不兼容结构变更
+  - `MINOR`：向后兼容新增字段
+  - `PATCH`：文档/实现修复
+
+## 2. 统一记录模型（Memory Envelope）
+
+字段（必填）：
+
+- `id` string
+- `schema_version` string
+- `created_at` string(ISO8601)
+- `updated_at` string(ISO8601)
+- `layer` enum: `instant|short|long|archive`
+- `kind` enum: `note|decision|task|checkpoint|summary|evidence`
+- `summary` string
+- `body_md_path` string
+- `tags` array[string]
+- `refs` array[object]
+- `signals` object
+- `cred_refs` array[string]
+- `source` object
+- `scope` object
+- `integrity` object
+
+`signals` 字段：
+
+- `importance_score` number [0,1]
+- `confidence_score` number [0,1]
+- `stability_score` number [0,1]
+- `reuse_count` integer >= 0
+- `volatility_score` number [0,1]
+
+约束：
+
+- `cred_refs` 不能包含密钥明文。
+- `body_md_path` 必须是仓库内相对路径。
+- `integrity.content_sha256` 对应 Markdown 正文哈希。
+
+## 3. JSONL 事件模型
+
+每行一个事件对象，事件类型：
+
+- `memory.write`
+- `memory.update`
+- `memory.checkpoint`
+- `memory.promote`
+- `memory.verify`
+- `memory.sync`
+
+字段（必填）：
+
+- `event_id`
+- `event_type`
+- `event_time`
+- `memory_id`
+- `payload`
+
+## 4. SQLite 模式约束
+
+- `memories`：主表，存 envelope 元数据与 signals。
+- `memory_refs`：引用关系。
+- `memory_events`：事件流水。
+- `memories_fts`：FTS5 检索 `summary` + `body_text`。
+
+SQLite 可重建原则：
+- 删除 SQLite 文件后，系统可从 Markdown + JSONL 重建索引。
+
+## 5. 审计与迁移
+
+- 每次 schema 升级都记录 `spec/changelog.md`。
+- 提供迁移脚本（Phase B+）。
+- 事件日志不可覆盖，仅追加。

package/templates/project-minimal/.omni-memory-ignore

@@ -0,0 +1,8 @@
+# Paths to ignore during memory extraction/indexing
+node_modules/
+dist/
+build/
+.cache/
+*.log
+.env
+.env.*

package/templates/project-minimal/.omni-memory-session.md

@@ -0,0 +1,13 @@
+# OmniMemory Session Entry
+
+- Current phase:
+- Current objective:
+- Last checkpoint ID:
+- Open risks:
+- Next action:
+
+## Quick start
+
+1. Run `omnimemory brief --project <project_id>`
+2. Review top 3 recent checkpoints
+3. Continue task or start a new session

package/templates/project-minimal/.omni-memory.json

@@ -0,0 +1,10 @@
+{
+  "version": "0.1.0",
+  "project_id": "replace-with-project-id",
+  "memory_home": "~/.omnimemory",
+  "default_tags": ["project:replace-with-project-id"],
+  "collect": {
+    "enabled": true,
+    "respect_ignore_file": ".omni-memory-ignore"
+  }
+}