omnimem 0.1.0

package/scripts/attach_project.sh

@@ -0,0 +1,25 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 2 ]]; then
+  echo "Usage: bash scripts/attach_project.sh <project_path> <project_id>"
+  exit 1
+fi
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+PROJECT_PATH="$1"
+PROJECT_ID="$2"
+
+if [[ ! -d "$PROJECT_PATH" ]]; then
+  echo "Project path not found: $PROJECT_PATH"
+  exit 1
+fi
+
+cp -f "$ROOT_DIR/templates/project-minimal/.omnimem.json" "$PROJECT_PATH/.omnimem.json"
+cp -f "$ROOT_DIR/templates/project-minimal/.omnimem-session.md" "$PROJECT_PATH/.omnimem-session.md"
+cp -f "$ROOT_DIR/templates/project-minimal/.omnimem-ignore" "$PROJECT_PATH/.omnimem-ignore"
+
+sed -i.bak "s/replace-with-project-id/$PROJECT_ID/g" "$PROJECT_PATH/.omnimem.json"
+rm -f "$PROJECT_PATH/.omnimem.json.bak"
+
+echo "Attached OmniMem to: $PROJECT_PATH (project_id=$PROJECT_ID)"

package/scripts/bootstrap.sh

@@ -0,0 +1,77 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+# One-command bootstrap for new device / new account.
+# Example:
+#   bash scripts/bootstrap.sh --repo git@github.com:YOUR_USER/omnimem.git
+#   bash scripts/bootstrap.sh --repo https://github.com/YOUR_USER/omnimem.git --attach ~/code/myproj --project-id myproj
+
+TARGET_HOME="${OMNIMEM_HOME:-$HOME/.omnimem}"
+APP_DIR="$TARGET_HOME/app"
+REPO_URL=""
+BRANCH="main"
+REMOTE_NAME="origin"
+REMOTE_URL=""
+ATTACH_PATH=""
+PROJECT_ID=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --repo)
+      REPO_URL="$2"
+      shift 2
+      ;;
+    --branch)
+      BRANCH="$2"
+      shift 2
+      ;;
+    --remote-name)
+      REMOTE_NAME="$2"
+      shift 2
+      ;;
+    --remote-url)
+      REMOTE_URL="$2"
+      shift 2
+      ;;
+    --attach)
+      ATTACH_PATH="$2"
+      shift 2
+      ;;
+    --project-id)
+      PROJECT_ID="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown arg: $1"
+      exit 1
+      ;;
+  esac
+done
+
+if [[ -z "$REPO_URL" ]]; then
+  echo "Usage: bash scripts/bootstrap.sh --repo <git_repo_url> [--branch main] [--remote-url <memory_git_url>] [--attach <project_path> --project-id <id>]"
+  exit 1
+fi
+
+mkdir -p "$TARGET_HOME"
+
+if [[ -d "$APP_DIR/.git" ]]; then
+  git -C "$APP_DIR" fetch --all --prune
+  git -C "$APP_DIR" checkout "$BRANCH"
+  git -C "$APP_DIR" pull --rebase
+else
+  git clone --branch "$BRANCH" "$REPO_URL" "$APP_DIR"
+fi
+
+cd "$APP_DIR"
+bash scripts/install.sh --remote-name "$REMOTE_NAME" --branch "$BRANCH" ${REMOTE_URL:+--remote-url "$REMOTE_URL"}
+
+if [[ -n "$ATTACH_PATH" ]]; then
+  if [[ -z "$PROJECT_ID" ]]; then
+    PROJECT_ID="$(basename "$ATTACH_PATH")"
+  fi
+  bash scripts/attach_project.sh "$ATTACH_PATH" "$PROJECT_ID"
+fi
+
+echo "Bootstrap done."
+echo "Run: $TARGET_HOME/bin/omnimem start --host 127.0.0.1 --port 8765"

package/scripts/detach_project.sh

@@ -0,0 +1,21 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [[ $# -lt 1 ]]; then
+  echo "Usage: bash scripts/detach_project.sh <project_path>"
+  exit 1
+fi
+
+PROJECT_PATH="$1"
+
+if [[ ! -d "$PROJECT_PATH" ]]; then
+  echo "Project path not found: $PROJECT_PATH"
+  exit 1
+fi
+
+rm -f "$PROJECT_PATH/.omnimem.json" \
+      "$PROJECT_PATH/.omnimem-session.md" \
+      "$PROJECT_PATH/.omnimem-ignore" \
+      "$PROJECT_PATH/.omnimem-hooks.sh"
+
+echo "Detached OmniMem from: $PROJECT_PATH"

package/scripts/install.sh

@@ -0,0 +1,94 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+ROOT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+TARGET_HOME="${OMNIMEM_HOME:-$HOME/.omnimem}"
+
+WIZARD=0
+REMOTE_NAME="origin"
+BRANCH="main"
+REMOTE_URL=""
+
+while [[ $# -gt 0 ]]; do
+  case "$1" in
+    --wizard)
+      WIZARD=1
+      shift
+      ;;
+    --remote-name)
+      REMOTE_NAME="$2"
+      shift 2
+      ;;
+    --branch)
+      BRANCH="$2"
+      shift 2
+      ;;
+    --remote-url)
+      REMOTE_URL="$2"
+      shift 2
+      ;;
+    *)
+      echo "Unknown arg: $1"
+      exit 1
+      ;;
+  esac
+done
+
+if [[ "$WIZARD" -eq 1 ]]; then
+  echo "[OmniMem Install Wizard]"
+  read -r -p "Install home [$TARGET_HOME]: " input_home
+  TARGET_HOME="${input_home:-$TARGET_HOME}"
+
+  read -r -p "Git remote name [$REMOTE_NAME]: " input_remote_name
+  REMOTE_NAME="${input_remote_name:-$REMOTE_NAME}"
+
+  read -r -p "Git branch [$BRANCH]: " input_branch
+  BRANCH="${input_branch:-$BRANCH}"
+
+  read -r -p "Git remote url (optional, e.g. git@github.com:user/repo.git): " input_remote_url
+  REMOTE_URL="${input_remote_url:-$REMOTE_URL}"
+fi
+
+mkdir -p "$TARGET_HOME"
+mkdir -p "$TARGET_HOME/data/markdown"/{instant,short,long,archive}
+mkdir -p "$TARGET_HOME/data/jsonl"
+mkdir -p "$TARGET_HOME/spec" "$TARGET_HOME/db" "$TARGET_HOME/docs"
+mkdir -p "$TARGET_HOME/bin" "$TARGET_HOME/lib"
+
+cp -f "$ROOT_DIR/spec/"*.json "$TARGET_HOME/spec/"
+cp -f "$ROOT_DIR/db/schema.sql" "$TARGET_HOME/db/schema.sql"
+cp -f "$ROOT_DIR/docs/architecture.md" "$TARGET_HOME/docs/architecture.md"
+rm -rf "$TARGET_HOME/lib/omnimem"
+cp -R "$ROOT_DIR/omnimem" "$TARGET_HOME/lib/omnimem"
+
+cat > "$TARGET_HOME/bin/omnimem" <<SH
+#!/usr/bin/env bash
+set -euo pipefail
+export OMNIMEM_HOME="$TARGET_HOME"
+PYTHONPATH="$TARGET_HOME/lib\${PYTHONPATH:+:\$PYTHONPATH}" exec python3 -m omnimem.cli "\$@"
+SH
+chmod +x "$TARGET_HOME/bin/omnimem"
+
+cat > "$TARGET_HOME/omnimem.config.json" <<JSON
+{
+  "version": "0.1.0",
+  "home": "$TARGET_HOME",
+  "storage": {
+    "markdown": "$TARGET_HOME/data/markdown",
+    "jsonl": "$TARGET_HOME/data/jsonl",
+    "sqlite": "$TARGET_HOME/data/omnimem.db"
+  },
+  "sync": {
+    "github": {
+      "remote_name": "$REMOTE_NAME",
+      "remote_url": "$REMOTE_URL",
+      "branch": "$BRANCH"
+    }
+  }
+}
+JSON
+
+echo "Installed OmniMem skeleton at: $TARGET_HOME"
+echo "CLI path: $TARGET_HOME/bin/omnimem"
+echo "Config path: $TARGET_HOME/omnimem.config.json"
+echo "Start App: $TARGET_HOME/bin/omnimem start --host 127.0.0.1 --port 8765"

package/scripts/uninstall.sh

@@ -0,0 +1,13 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+TARGET_HOME="${OMNIMEM_HOME:-$HOME/.omnimem}"
+CONFIG_FILE="$TARGET_HOME/omnimem.config.json"
+
+if [[ ! -f "$CONFIG_FILE" ]]; then
+  echo "No OmniMem install found at: $TARGET_HOME"
+  exit 0
+fi
+
+rm -rf "$TARGET_HOME"
+echo "Removed OmniMem 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/.omnimem.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}/omnimem.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=(
+  "omnimem/cli.py"
+  "omnimem/core.py"
+  "bin/omnimem"
+  "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=(
+  "omnimem/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=(
+  "omnimem/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/omnimem/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)
+
+- Initial `MemoryEnvelope` and `MemoryEvent` schemas.
+- Layered memory model and event taxonomy.
+- Credential reference constraints (no plaintext secrets).
+- Added `signals` fields:
+  - `importance_score`
+  - `confidence_score`
+  - `stability_score`
+  - `reuse_count`
+  - `volatility_score`
+- Added corresponding signal columns and indexes in SQLite `memories` table.

package/spec/memory-envelope.schema.json

@@ -0,0 +1,111 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://omnimem.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://omnimem.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,77 @@
+# OmniMem Protocol v0.1.0
+
+## 1. Versioning
+
+- Protocol version: `0.1.0`
+- Semantic versioning rules:
+  - `MAJOR`: breaking model changes
+  - `MINOR`: backward-compatible additions
+  - `PATCH`: fixes and clarifications
+
+## 2. Memory Envelope
+
+Required fields:
+
+- `id`
+- `schema_version`
+- `created_at`
+- `updated_at`
+- `layer` (`instant|short|long|archive`)
+- `kind` (`note|decision|task|checkpoint|summary|evidence`)
+- `summary`
+- `body_md_path`
+- `tags`
+- `refs`
+- `signals`
+- `cred_refs`
+- `source`
+- `scope`
+- `integrity`
+
+`signals` fields:
+
+- `importance_score` [0,1]
+- `confidence_score` [0,1]
+- `stability_score` [0,1]
+- `reuse_count` >= 0
+- `volatility_score` [0,1]
+
+Constraints:
+
+- `cred_refs` must never contain plaintext secrets.
+- `body_md_path` must be repo-relative.
+- `integrity.content_sha256` must match markdown body hash.
+
+## 3. JSONL Event Model
+
+One event per line. Event types:
+
+- `memory.write`
+- `memory.update`
+- `memory.checkpoint`
+- `memory.promote`
+- `memory.verify`
+- `memory.sync`
+
+Required fields:
+
+- `event_id`
+- `event_type`
+- `event_time`
+- `memory_id`
+- `payload`
+
+## 4. SQLite Model
+
+- `memories`: envelope metadata and signals
+- `memory_refs`: reference graph
+- `memory_events`: event log
+- `memories_fts`: FTS5 for summary/body text
+
+SQLite is rebuildable from Markdown + JSONL.
+
+## 5. Audit and Migration
+
+- Track schema changes in `spec/changelog.md`.
+- Keep event logs append-only.
+- Provide migration tooling for future protocol updates.

package/templates/project-minimal/.omnimem-ignore

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

package/templates/project-minimal/.omnimem-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/.omnimem.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"
+  }
+}