ori-memory 0.2.0

package/dist/providers/anthropic.js

@@ -0,0 +1,90 @@
+const SYSTEM_PROMPT = `You are a knowledge management assistant for Ori Mnemos, a markdown-native memory system.
+Your job is to enhance a note that is being promoted from inbox to permanent storage.
+
+Given a note's title, body, and frontmatter, plus context about the vault's existing notes:
+1. Suggest a better description (one sentence, max 200 chars, no trailing period)
+2. Classify the type: idea, decision, learning, insight, blocker, or opportunity
+3. Suggest wiki-links to existing notes that are relevant
+4. Suggest project tags if applicable
+5. Explain your reasoning briefly
+
+Respond with valid JSON matching this schema:
+{
+  "type": "string (one of: idea, decision, learning, insight, blocker, opportunity)",
+  "description": "string (one sentence, max 200 chars)",
+  "links": ["string array of existing note titles to link to"],
+  "project": ["string array of project tags"],
+  "reasoning": "string (brief explanation)"
+}
+
+Only include fields where you have a confident suggestion. Omit fields you're unsure about.`;
+export class AnthropicProvider {
+    apiKey;
+    model;
+    constructor(apiKey, model) {
+        this.apiKey = apiKey;
+        this.model = model;
+    }
+    async enhance(note, context) {
+        const userMessage = [
+            `## Note to enhance`,
+            `Title: ${note.title}`,
+            `Body: ${note.body.slice(0, 2000)}`,
+            `Current frontmatter: ${JSON.stringify(note.frontmatter)}`,
+            ``,
+            `## Vault context`,
+            `Existing notes: ${context.existingTitles.slice(0, 50).join(", ")}`,
+            `Recent notes: ${context.recentNotes
+                .slice(0, 10)
+                .map((n) => `${n.title} (${n.type})`)
+                .join(", ")}`,
+            `Known projects: ${context.projectTags.join(", ")}`,
+        ].join("\n");
+        try {
+            const response = await fetch("https://api.anthropic.com/v1/messages", {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "x-api-key": this.apiKey,
+                    "anthropic-version": "2023-06-01",
+                },
+                body: JSON.stringify({
+                    model: this.model,
+                    max_tokens: 1024,
+                    system: SYSTEM_PROMPT,
+                    messages: [{ role: "user", content: userMessage }],
+                }),
+            });
+            if (!response.ok) {
+                return {};
+            }
+            const data = (await response.json());
+            const text = data.content?.[0]?.text;
+            if (!text)
+                return {};
+            // Extract JSON from response (may be wrapped in markdown code block)
+            const jsonMatch = text.match(/\{[\s\S]*\}/);
+            if (!jsonMatch)
+                return {};
+            const parsed = JSON.parse(jsonMatch[0]);
+            // Validate and sanitize
+            const result = {};
+            if (typeof parsed.type === "string")
+                result.type = parsed.type;
+            if (typeof parsed.description === "string")
+                result.description = parsed.description.slice(0, 200);
+            if (Array.isArray(parsed.links))
+                result.links = parsed.links;
+            if (Array.isArray(parsed.project))
+                result.project = parsed.project;
+            if (typeof parsed.reasoning === "string")
+                result.reasoning = parsed.reasoning;
+            return result;
+        }
+        catch {
+            // LLM failures should never block promotion
+            return {};
+        }
+    }
+}
+//# sourceMappingURL=anthropic.js.map

package/dist/providers/anthropic.js.map

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "ori-memory",
+  "version": "0.2.0",
+  "description": "The Git of AI memory - open source, markdown-native framework for persistent, shared agent memory without a database",
+  "keywords": [
+    "ai",
+    "agent",
+    "memory",
+    "markdown",
+    "cli",
+    "knowledge-graph"
+  ],
+  "homepage": "https://github.com/aayoawoyemi/OriMnemos",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aayoawoyemi/OriMnemos.git"
+  },
+  "license": "Apache-2.0",
+  "author": "Aayo Awoyemi",
+  "type": "module",
+  "bin": {
+    "ori": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "scaffold",
+    "adapters"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run --environment node",
+    "test:watch": "vitest --environment node",
+    "lint": "tsc --noEmit",
+    "smoke:bin": "node dist/index.js --version",
+    "pack:check": "npm pack --dry-run --cache .npm-cache",
+    "check:v01:test": "npm run test",
+    "check:v01": "npm run lint && npm run build && npm run smoke:bin && npm run pack:check"
+  },
+  "dependencies": {
+    "@huggingface/transformers": "^3.8.1",
+    "@types/better-sqlite3": "^7.6.13",
+    "better-sqlite3": "^12.6.2",
+    "chalk": "^5.3.0",
+    "commander": "^12.1.0",
+    "glob": "^11.0.0",
+    "graphology": "^0.26.0",
+    "graphology-communities-louvain": "^2.0.2",
+    "graphology-metrics": "^2.4.0",
+    "yaml": "^2.4.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/scaffold/.ori

@@ -0,0 +1 @@
+

package/scaffold/inbox/.gitkeep

@@ -0,0 +1 @@
+

package/scaffold/notes/index.md

@@ -0,0 +1,19 @@
+---
+description: Entry point map for this vault
+type: moc
+---
+
+# index
+
+Use this map as the root entry point. Link all major project maps here.
+
+## Project Maps
+- [[project map]]
+
+## Recent Additions
+- [[new note]]
+
+---
+
+Areas:
+- [[index]]

package/scaffold/ops/observations/.gitkeep

@@ -0,0 +1 @@
+

package/scaffold/ops/reminders.md

@@ -0,0 +1,3 @@
+# Reminders
+
+- [ ] 2026-02-19 Example reminder

package/scaffold/ops/sessions/.gitkeep

@@ -0,0 +1 @@
+

package/scaffold/ori.config.yaml

@@ -0,0 +1,79 @@
+# ori.config.yaml - vault configuration for Ori Mnemos
+
+vault:
+  version: "0.1"
+
+templates:
+  default: templates/note.md
+  by_type:
+    map: templates/map.md
+    moc: templates/map.md
+    source: templates/source.md
+    observation: templates/observation.md
+
+vitality:
+  model: "actr"
+  actr_decay: 0.5
+  decay:
+    idea: 90
+    decision: 30
+    learning: 30
+    insight: 30
+    blocker: 14
+    opportunity: 30
+  base: 1.0
+  metabolic_rates:
+    self: 0.1
+    notes: 1.0
+    ops: 3.0
+  structural_boost_per_link: 0.1
+  structural_boost_cap: 10
+  revival_decay_rate: 0.2
+  revival_window_days: 14
+  access_saturation_k: 10
+
+promote:
+  auto: true               # ori add auto-promotes to notes/
+  require_llm: false       # true = only auto-promote when LLM available
+  min_confidence: 0.6      # below this, skip auto-promotion and warn
+  project_keywords: {}     # project_name: [keyword, keyword, ...]
+  project_map_routing: {}  # project_name: map_note_title
+  default_area: "index"    # fallback area when no project match
+
+llm:
+  provider: null           # null | "anthropic"
+  model: null
+  api_key_env: null        # env var name containing API key
+
+graph:
+  pagerank_alpha: 0.85
+  bridge_vitality_floor: 0.5
+  hub_degree_multiplier: 2.0
+
+engine:
+  embedding_model: "Xenova/all-MiniLM-L6-v2"
+  embedding_dims: 384
+  piecewise_bins: 8
+  community_dims: 16
+  db_path: ".ori/embeddings.db"
+
+retrieval:
+  default_limit: 10
+  candidate_multiplier: 5
+  rrf_k: 60
+  signal_weights:
+    composite: 2.0
+    keyword: 1.0
+    graph: 1.5
+  exploration_budget: 0.10
+
+bm25:
+  k1: 1.2
+  b: 0.75
+  title_boost: 3.0
+  description_boost: 2.0
+
+ips:
+  enabled: true
+  epsilon: 0.01
+  log_path: "ops/access.jsonl"

package/scaffold/templates/map.md

@@ -0,0 +1,36 @@
+---
+_schema:
+  entity_type: "map"
+  applies_to: "notes/*-map.md"
+  required:
+    - description
+    - type
+  optional:
+    - project
+  enums:
+    type:
+      - moc
+  constraints:
+    description:
+      max_length: 200
+      format: "One sentence describing what this map covers"
+
+# Template fields
+description: ""
+type: moc
+---
+
+# {map name}
+
+{Brief description of what this map covers and why it exists.}
+
+## Key Notes
+{Links to the most important notes in this area}
+
+## Recent Additions
+{Links to recently added notes - keeps the map fresh}
+
+---
+
+Areas:
+- [[index]]

package/scaffold/templates/note.md

@@ -0,0 +1,61 @@
+---
+_schema:
+  entity_type: "note"
+  applies_to: "notes/*.md"
+  required:
+    - description
+    - type
+    - project
+    - status
+    - created
+  optional:
+    - confidence
+    - alternatives
+    - rationale
+    - superseded_by
+    - next_step
+    - source
+  enums:
+    type:
+      - idea
+      - decision
+      - learning
+      - insight
+      - blocker
+      - opportunity
+    status:
+      - inbox
+      - active
+      - completed
+      - superseded
+      - archived
+    confidence:
+      - speculative
+      - promising
+      - validated
+  constraints:
+    description:
+      max_length: 200
+      format: "One sentence adding context beyond the title"
+    project:
+      format: "Array of project tags"
+
+# Template fields
+description: ""
+type: ""
+project: []
+status: active
+created: YYYY-MM-DD
+---
+
+# {prose-as-title: a complete thought that works as a statement}
+
+{Content - your reasoning, evidence, context. Transform the material, don't just summarize.}
+
+---
+
+Relevant Notes:
+- [[related note]] -- why this connection matters
+
+Areas:
+- [[relevant map]]

package/scaffold/templates/observation.md

@@ -0,0 +1,38 @@
+---
+_schema:
+  entity_type: "observation"
+  applies_to: "ops/observations/*.md"
+  required:
+    - description
+    - category
+    - observed
+    - status
+  optional: []
+  enums:
+    category:
+      - friction
+      - surprise
+      - process-gap
+      - methodology
+      - quality
+    status:
+      - pending
+      - promoted
+      - implemented
+      - archived
+
+# Template fields
+description: ""
+category: ""
+observed: YYYY-MM-DD
+status: pending
+---
+
+# {prose-sentence describing what was observed}
+
+{Context - what happened, what was expected, what actually occurred}
+
+---
+
+Topics:
+- [[methodology]]

package/scaffold/templates/source.md

@@ -0,0 +1,45 @@
+---
+_schema:
+  entity_type: "source"
+  applies_to: "inbox/*.md"
+  required:
+    - description
+    - source_type
+    - status
+    - created
+  optional:
+    - url
+    - author
+    - research_tool
+    - research_query
+  enums:
+    source_type:
+      - article
+      - voice-note
+      - conversation
+      - documentation
+      - video
+      - tweet
+      - raw-idea
+    status:
+      - unprocessed
+      - processing
+      - processed
+      - skipped
+
+# Template fields
+description: ""
+source_type: ""
+status: unprocessed
+created: YYYY-MM-DD
+---
+
+# {source title or description}
+
+{Raw content, transcript, or notes from the source}
+
+---
+
+Processing Notes:
+- Extracted: {count} notes
+- Key insights: {brief list}