@luisarg/memory-auto 0.1.0 → 0.1.1

package/vault/README.md

@@ -0,0 +1,38 @@
+# memory-vault (starter)
+
+OKF (Obsidian Knowledge Format) memory vault for the DSH memory plugins.
+
+This directory is the **public skeleton** of the vault: templates, type registry
+and tag vocabulary. Runtime data (`projects/`, `raw/`, `logs/`, `memory.db`,
+`index.md`, `log.md`) is generated locally and excluded from git (`.gitignore`).
+
+## Structure
+
+```
+memory-vault/
+├── templates/          # OKF templates per entry type
+├── type-registry.yaml  # type registry (source of truth)
+├── tag-vocabulary.json # tag normalization
+├── projects/           # per-project entries (created on first use)
+├── raw/                # loose Source entries (created on first use)
+├── logs/               # digest logs (created on first use)
+└── memory.db           # SQLite index (FTS5), rebuildable from markdown
+```
+
+`projects/`, `raw/`, `logs/` and `memory.db` are created automatically by
+`memory-vault-server` on first use (`MemoryStore.__init__`).
+
+## Usage
+
+Point the server (or the `memory-mcp` / `memory-auto` plugins) at this directory
+with the `MEMORY_PATH` env var (or `DSH_MEMORY_PATH` for the DSH plugins):
+
+```sh
+MEMORY_PATH=./memory-vault uv run --directory ./memory-vault-server python server.py
+```
+
+## Rebuilding the index
+
+The SQLite index is derived from the markdown; if it is missing or corrupted it
+can be rebuilt with the server's `store_*` write tools, which upsert each entry
+from its file.

package/vault/tag-vocabulary.json

@@ -0,0 +1,175 @@
+{
+  "canonical": {
+    "architecture": {
+      "aliases": [
+        "arch",
+        "design",
+        "system-design"
+      ]
+    },
+    "python": {
+      "aliases": [
+        "py",
+        "python3"
+      ]
+    },
+    "typescript": {
+      "aliases": [
+        "ts",
+        "typescript"
+      ]
+    },
+    "testing": {
+      "aliases": [
+        "test",
+        "tests",
+        "testing"
+      ]
+    },
+    "ci-cd": {
+      "aliases": [
+        "ci",
+        "cd",
+        "github-actions",
+        "actions"
+      ]
+    },
+    "docker": {
+      "aliases": [
+        "docker",
+        "container"
+      ]
+    },
+    "database": {
+      "aliases": [
+        "db",
+        "sqlite",
+        "sql"
+      ]
+    },
+    "cli": {
+      "aliases": [
+        "command-line",
+        "terminal"
+      ]
+    },
+    "performance": {
+      "aliases": [
+        "perf",
+        "optimization"
+      ]
+    },
+    "security": {
+      "aliases": [
+        "security",
+        "auth"
+      ]
+    },
+    "ui-ux": {
+      "aliases": [
+        "ui",
+        "ux",
+        "frontend",
+        "interface"
+      ]
+    },
+    "refactoring": {
+      "aliases": [
+        "refactor",
+        "cleanup"
+      ]
+    },
+    "llm": {
+      "aliases": [
+        "ai",
+        "openrouter",
+        "model"
+      ]
+    },
+    "documentation": {
+      "aliases": [
+        "docs",
+        "readme"
+      ]
+    },
+    "automation": {
+      "aliases": [
+        "auto",
+        "script",
+        "makefile"
+      ]
+    },
+    "travel": {
+      "aliases": [
+        "japan",
+        "trip"
+      ]
+    },
+    "cv": {
+      "aliases": [
+        "curriculum",
+        "resume"
+      ]
+    },
+    "debugging": {
+      "aliases": [
+        "debug",
+        "fix",
+        "bug"
+      ]
+    },
+    "env-config": {
+      "aliases": [
+        "env",
+        "config",
+        "secrets",
+        "environment"
+      ]
+    },
+    "migration": {
+      "aliases": [
+        "migrate",
+        "data-migration"
+      ]
+    },
+    "decision": {
+      "aliases": []
+    },
+    "fact": {
+      "aliases": []
+    },
+    "rate-limit": {
+      "aliases": []
+    },
+    "pipeline": {
+      "aliases": ["etl", "data-pipeline"]
+    },
+    "athena": {
+      "aliases": ["aws-athena", "s3"]
+    },
+    "lightgbm": {
+      "aliases": ["lgbm", "model-training"]
+    },
+    "idea": {
+      "aliases": ["proposal", "hypothesis"]
+    },
+    "context": {
+      "aliases": ["situation", "constraint"]
+    },
+    "spike": {
+      "aliases": ["prototype", "poc"]
+    },
+    "feature-engineering": {
+      "aliases": ["features", "variables"]
+    },
+    "dsh": {
+      "aliases": ["deepseek-harness", "cordis"]
+    },
+    "opencode": {
+      "aliases": ["second-brain"]
+    },
+    "obsidian": {
+      "aliases": ["vault", "okf"]
+    }
+  }
+}

package/vault/templates/context.md

@@ -0,0 +1,20 @@
+---
+type: Context
+title: <% tp.file.title %>
+description: <fill me>
+resource: ""
+tags: []
+timestamp: <% tp.date.now("YYYY-MM-DDTHH:mm:ssZ") %>
+project: <% tp.user.config.project_name ?? "" %>
+confidence: 0.8
+---
+
+# <% tp.file.title %>
+
+## Situation
+
+Estado y constraints en el momento.
+
+## Constraints
+
+Qué límites temporales / entorno.

package/vault/templates/convention.md

@@ -0,0 +1,13 @@
+---
+type: Convention
+title: <% tp.file.title %>
+description: <fill me>
+resource: ""
+tags: []
+timestamp: <% tp.date.now("YYYY-MM-DDTHH:mm:ssZ") %>
+project: <% tp.user.config.project_name ?? "" %>
+---
+
+# <% tp.file.title %>
+
+The convention. State the rule, when it applies, and where it is enforced.

package/vault/templates/decision.md

@@ -0,0 +1,23 @@
+---
+type: Decision
+title: <% tp.file.title %>
+description: <fill me>
+resource: ""
+tags: []
+timestamp: <% tp.date.now("YYYY-MM-DDTHH:mm:ssZ") %>
+project: <% tp.user.config.project_name ?? "" %>
+---
+
+# <% tp.file.title %>
+
+## Context
+
+What was the situation that required a decision?
+
+## Decision
+
+What was decided?
+
+## Consequences
+
+What are the trade-offs, follow-ups, or reversibility notes?

package/vault/templates/fact.md

@@ -0,0 +1,14 @@
+---
+type: Fact
+title: <% tp.file.title %>
+description: <fill me>
+resource: ""
+tags: []
+timestamp: <% tp.date.now("YYYY-MM-DDTHH:mm:ssZ") %>
+project: <% tp.user.config.project_name ?? "" %>
+confidence: 1.0
+---
+
+# <% tp.file.title %>
+
+The fact.

package/vault/templates/idea.md

@@ -0,0 +1,28 @@
+---
+type: Idea
+title: <% tp.file.title %>
+description: <fill me>
+resource: ""
+tags: []
+timestamp: <% tp.date.now("YYYY-MM-DDTHH:mm:ssZ") %>
+project: <% tp.user.config.project_name ?? "" %>
+confidence: 0.6
+---
+
+# <% tp.file.title %>
+
+## Idea
+
+Propuesta / hipótesis no validada.
+
+## Context
+
+Situación que motivó la idea.
+
+## Alternatives
+
+¿ qué otras opciones se consideraron?
+
+## Next
+
+Cómo validar.

package/vault/templates/learning.md

@@ -0,0 +1,23 @@
+---
+type: Learning
+title: <% tp.file.title %>
+description: <fill me>
+resource: ""
+tags: []
+timestamp: <% tp.date.now("YYYY-MM-DDTHH:mm:ssZ") %>
+project: <% tp.user.config.project_name ?? "" %>
+---
+
+# <% tp.file.title %>
+
+## Problem
+
+What was the symptom or problem?
+
+## Root cause
+
+What actually caused it?
+
+## Solution
+
+What fixed it, or what would have fixed it sooner?

package/vault/templates/profile.md

@@ -0,0 +1,13 @@
+---
+type: Profile
+title: <% tp.file.title %>
+description: <fill me>
+resource: ""
+tags: []
+timestamp: <% tp.date.now("YYYY-MM-DDTHH:mm:ssZ") %>
+project: <% tp.user.config.project_name ?? "" %>
+---
+
+# <% tp.file.title %>
+
+Synthesized profile for this project. Capture tech stack, architectural patterns, environment, workflow preferences, and known constraints. Profile entries deduplicate by `(project, type)` — saving a new profile overwrites the previous one.

package/vault/templates/source.md

@@ -0,0 +1,21 @@
+---
+type: Source
+title: <% tp.file.title %>
+description: <fill me>
+resource: ""
+tags: []
+timestamp: <% tp.date.now("YYYY-MM-DDTHH:mm:ssZ") %>
+source_url: <url>
+source_kind: article
+captured_at: <% tp.date.now("YYYY-MM-DDTHH:mm:ssZ") %>
+---
+
+# <% tp.file.title %>
+
+## Summary
+
+Brief summary of the source material.
+
+## Captured content
+
+Paste or describe the source content here (for offline or paywalled sources).

package/vault/type-registry.yaml

@@ -0,0 +1,75 @@
+# Type Registry — single source of truth for all entry types.
+# See openspec/changes/vault-foundation/specs/type-registry/spec.md
+
+types:
+  - name: Decision
+    directory: decisions
+    singular: decision
+    tool: store_decision
+    template: templates/decision.md
+    extraction_hint: "Architectural or design choices that were made."
+    immutable: false
+    project_attached: true
+
+  - name: Fact
+    directory: facts
+    singular: fact
+    tool: store_fact
+    template: templates/fact.md
+    extraction_hint: "Stable, verifiable statements about the project (versions, conventions, constraints)."
+    immutable: false
+    project_attached: true
+
+  - name: Learning
+    directory: learnings
+    singular: learning
+    tool: store_learning
+    template: templates/learning.md
+    extraction_hint: "Non-obvious lessons, debugging insights, or solutions found."
+    immutable: false
+    project_attached: true
+
+  - name: Convention
+    directory: conventions
+    singular: convention
+    tool: store_convention
+    template: templates/convention.md
+    extraction_hint: "Style rules, naming patterns, and coding conventions."
+    immutable: false
+    project_attached: true
+
+  - name: Profile
+    directory: profiles
+    singular: profile
+    tool: store_profile
+    template: templates/profile.md
+    extraction_hint: "User profile or tech stack information for a project."
+    immutable: false
+    project_attached: true
+
+  - name: Idea
+    directory: ideas
+    singular: idea
+    tool: store_idea
+    template: templates/idea.md
+    extraction_hint: "Propuesta no validada, hipótesis o alternativa considerada (no implementada aún)."
+    immutable: false
+    project_attached: true
+
+  - name: Context
+    directory: contexts
+    singular: context
+    tool: store_context
+    template: templates/context.md
+    extraction_hint: "Estado situacional, constraints temporales, entorno o presunciones en el momento."
+    immutable: false
+    project_attached: true
+
+  - name: Source
+    directory: raw
+    singular: source
+    tool: store_source
+    template: templates/source.md
+    extraction_hint: null
+    immutable: true
+    project_attached: false