amalfa 1.0.14 → 1.0.16

package/README.md

@@ -196,29 +196,7 @@ amalfa/
 
 AMALFA follows a **Brief → Work → Debrief → Playbook** cycle:
 
-```dot
-digraph workflow {
-  rankdir=LR;
-  node [shape=box, style=filled];
-  
-  // Nodes
-  brief [label="Brief\n(Task Spec)", fillcolor=lightyellow];
-  work [label="Work\n(Implementation)", fillcolor=lightblue];
-  debrief [label="Debrief\n(Lessons Learned)", fillcolor=lightgreen];
-  playbook [label="Playbook\n(Codified Pattern)", fillcolor=orange];
-  db [label="AMALFA\nKnowledge Graph", shape=cylinder, fillcolor=lightgray];
-  
-  // Flow
-  brief -> work [label="guides"];
-  work -> debrief [label="captures"];
-  debrief -> playbook [label="abstracts to"];
-  playbook -> db [label="indexed as"];
-  db -> brief [label="informs\nnext task", style=dashed];
-  
-  // Semantic layer
-  db -> db [label="semantic search\nvector embeddings\ngraph traversal", style=dotted];
-}
-```
+![AMALFA Workflow](https://raw.githubusercontent.com/pjsvis/amalfa/main/docs/workflow.png)
 
 **Example:**
 
@@ -251,34 +229,47 @@ Agents generate knowledge through structured reflection. Amalfa provides semanti
 
 ## Implementation Status
 
-### Phase 1: Basic Auto-Augmentation (In Progress)
+### ✅ Core Functionality (v1.0 - Released)
+
+- ✅ **MCP Server** - stdio transport, tools, resources
+- ✅ **Vector Search** - FastEmbed embeddings (384-dim), semantic search
+- ✅ **Database** - SQLite with hollow nodes, FAFCAS protocol
+- ✅ **Ingestion Pipeline** - Markdown → nodes + embeddings
+- ✅ **CLI** - init, serve, stats, doctor, servers, daemon, vector
+- ✅ **Service Management** - Vector daemon, file watcher, lifecycle
+- ✅ **Pre-flight Validation** - Check markdown before ingestion
+
+### 🚧 Phase 1: Auto-Augmentation (In Progress)
 
-- [ ] Entity extraction
-- [ ] Auto-linking (wiki-style)
-- [ ] Tag extraction
-- [ ] Embedding generation
-- [ ] Git integration
+- [ ] Entity extraction from markdown
+- [ ] Auto-linking (wiki-style [[links]])
+- [ ] Tag extraction and indexing
+- [ ] Git-based auditing for augmentations
+- [ ] Automated file watcher updates
 
-### Phase 2: Latent Space Tagging (Planned)
+### 📋 Phase 2: Latent Space Organization (Planned)
 
 - [ ] Document clustering (HDBSCAN)
 - [ ] Cluster label generation
 - [ ] Confidence-based tagging
 - [ ] Topic modeling (BERTopic)
+- [ ] Self-organizing taxonomy
 
-### Phase 3: Semantic Relationships (Planned)
+### 🔗 Phase 3: Graph Intelligence (Planned)
 
-- [ ] K-nearest neighbor search
+- [ ] K-nearest neighbor recommendations
 - [ ] Suggested reading lists
-- [ ] Temporal sequences
+- [ ] Temporal sequence tracking
 - [ ] Backlink maintenance
+- [ ] Graph traversal tools
 
-### Phase 4: Learning from Corrections (Future)
+### 🎯 Phase 4: Learning from Feedback (Future)
 
-- [ ] Track human edits
+- [ ] Track human edits to augmentations
 - [ ] Adjust confidence thresholds
-- [ ] Improve extraction
-- [ ] Weekly digest
+- [ ] Improve extraction heuristics
+- [ ] Weekly knowledge digest
+- [ ] Multi-agent coordination
 
 ---
 
@@ -354,12 +345,14 @@ bun run format           # Biome format
 
 ## Contributing
 
-Amalfa is in early development. Contributions welcome once v1.0 is released.
+Amalfa is in active development. Contributions are welcome!
 
-**For now:**
-- ⭐ Star the repo if interested
-- 👀 Watch for release announcements
-- 💬 Open issues for feedback
+**How to contribute:**
+- ⭐ Star the repo if you find it useful
+- 🐛 Report bugs or request features via issues
+- 📝 Improve documentation
+- 🚀 Submit PRs for new features or fixes
+- 💬 Join discussions about the vision and roadmap
 
 ---
 

package/amalfa.svg

@@ -0,0 +1,87 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" width="304pt" height="443pt" viewBox="0.00 0.00 304.00 443.00">
+<g id="graph0" class="graph" transform="scale(1 1) rotate(0) translate(4 438.8)">
+<title>workflow</title>
+<polygon fill="white" stroke="none" points="-4,4 -4,-438.8 299.54,-438.8 299.54,4 -4,4"/>
+<!-- brief -->
+<g id="node1" class="node">
+<title>brief</title>
+<polygon fill="lightyellow" stroke="black" points="155.52,-434.8 72.27,-434.8 72.27,-393.2 155.52,-393.2 155.52,-434.8"/>
+<text xml:space="preserve" text-anchor="middle" x="113.9" y="-418.2" font-family="Times,serif" font-size="14.00">Brief</text>
+<text xml:space="preserve" text-anchor="middle" x="113.9" y="-401.4" font-family="Times,serif" font-size="14.00">(Task Spec)</text>
+</g>
+<!-- work -->
+<g id="node2" class="node">
+<title>work</title>
+<polygon fill="lightblue" stroke="black" points="124.88,-340.4 10.91,-340.4 10.91,-298.8 124.88,-298.8 124.88,-340.4"/>
+<text xml:space="preserve" text-anchor="middle" x="67.9" y="-323.8" font-family="Times,serif" font-size="14.00">Work</text>
+<text xml:space="preserve" text-anchor="middle" x="67.9" y="-307" font-family="Times,serif" font-size="14.00">(Implementation)</text>
+</g>
+<!-- brief&#45;&gt;work -->
+<g id="edge1" class="edge">
+<title>brief-&gt;work</title>
+<path fill="none" stroke="black" d="M103.91,-392.95C97.77,-380.6 89.77,-364.53 82.87,-350.68"/>
+<polygon fill="black" stroke="black" points="86.12,-349.36 78.53,-341.97 79.85,-352.48 86.12,-349.36"/>
+<text xml:space="preserve" text-anchor="middle" x="113.29" y="-362.6" font-family="Times,serif" font-size="14.00">guides</text>
+</g>
+<!-- debrief -->
+<g id="node3" class="node">
+<title>debrief</title>
+<polygon fill="lightgreen" stroke="black" points="119.79,-246 0,-246 0,-204.4 119.79,-204.4 119.79,-246"/>
+<text xml:space="preserve" text-anchor="middle" x="59.9" y="-229.4" font-family="Times,serif" font-size="14.00">Debrief</text>
+<text xml:space="preserve" text-anchor="middle" x="59.9" y="-212.6" font-family="Times,serif" font-size="14.00">(Lessons Learned)</text>
+</g>
+<!-- work&#45;&gt;debrief -->
+<g id="edge2" class="edge">
+<title>work-&gt;debrief</title>
+<path fill="none" stroke="black" d="M66.16,-298.55C65.12,-286.56 63.78,-271.07 62.61,-257.5"/>
+<polygon fill="black" stroke="black" points="66.11,-257.38 61.76,-247.72 59.13,-257.98 66.11,-257.38"/>
+<text xml:space="preserve" text-anchor="middle" x="87.93" y="-268.2" font-family="Times,serif" font-size="14.00">captures</text>
+</g>
+<!-- playbook -->
+<g id="node4" class="node">
+<title>playbook</title>
+<polygon fill="orange" stroke="black" points="125.63,-151.6 8.16,-151.6 8.16,-110 125.63,-110 125.63,-151.6"/>
+<text xml:space="preserve" text-anchor="middle" x="66.9" y="-135" font-family="Times,serif" font-size="14.00">Playbook</text>
+<text xml:space="preserve" text-anchor="middle" x="66.9" y="-118.2" font-family="Times,serif" font-size="14.00">(Codified Pattern)</text>
+</g>
+<!-- debrief&#45;&gt;playbook -->
+<g id="edge3" class="edge">
+<title>debrief-&gt;playbook</title>
+<path fill="none" stroke="black" d="M61.41,-204.15C62.32,-192.16 63.5,-176.67 64.52,-163.1"/>
+<polygon fill="black" stroke="black" points="68,-163.56 65.26,-153.32 61.02,-163.03 68,-163.56"/>
+<text xml:space="preserve" text-anchor="middle" x="95.71" y="-173.8" font-family="Times,serif" font-size="14.00">abstracts to</text>
+</g>
+<!-- db -->
+<g id="node5" class="node">
+<title>db</title>
+<path fill="lightgray" stroke="black" d="M171.41,-52C171.41,-54.87 144.73,-57.2 111.9,-57.2 79.06,-57.2 52.38,-54.87 52.38,-52 52.38,-52 52.38,-5.2 52.38,-5.2 52.38,-2.33 79.06,0 111.9,0 144.73,0 171.41,-2.33 171.41,-5.2 171.41,-5.2 171.41,-52 171.41,-52"/>
+<path fill="none" stroke="black" d="M171.41,-52C171.41,-49.13 144.73,-46.8 111.9,-46.8 79.06,-46.8 52.38,-49.13 52.38,-52"/>
+<text xml:space="preserve" text-anchor="middle" x="111.9" y="-32.8" font-family="Times,serif" font-size="14.00">AMALFA</text>
+<text xml:space="preserve" text-anchor="middle" x="111.9" y="-16" font-family="Times,serif" font-size="14.00">Knowledge Graph</text>
+</g>
+<!-- playbook&#45;&gt;db -->
+<g id="edge4" class="edge">
+<title>playbook-&gt;db</title>
+<path fill="none" stroke="black" d="M71.12,-109.58C73.7,-99.06 77.45,-86.15 82.42,-75.2 83.65,-72.48 85.03,-69.73 86.5,-67"/>
+<polygon fill="black" stroke="black" points="89.37,-69.03 91.37,-58.63 83.32,-65.51 89.37,-69.03"/>
+<text xml:space="preserve" text-anchor="middle" x="112.16" y="-79.4" font-family="Times,serif" font-size="14.00">indexed as</text>
+</g>
+<!-- db&#45;&gt;brief -->
+<g id="edge5" class="edge">
+<title>db-&gt;brief</title>
+<path fill="none" stroke="black" stroke-dasharray="5,2" d="M132.14,-57.23C135.75,-62.98 139.21,-69.13 141.9,-75.2 152.03,-98.11 155.9,-104.75 155.9,-129.8 155.9,-320.6 155.9,-320.6 155.9,-320.6 155.9,-342.99 145.55,-365.92 135.13,-383.33"/>
+<polygon fill="black" stroke="black" points="132.27,-381.3 129.87,-391.62 138.18,-385.05 132.27,-381.3"/>
+<text xml:space="preserve" text-anchor="middle" x="180.97" y="-229.4" font-family="Times,serif" font-size="14.00">informs</text>
+<text xml:space="preserve" text-anchor="middle" x="180.97" y="-212.6" font-family="Times,serif" font-size="14.00">next task</text>
+</g>
+<!-- db&#45;&gt;db -->
+<g id="edge6" class="edge">
+<title>db-&gt;db</title>
+<path fill="none" stroke="black" stroke-dasharray="1,5" d="M171.69,-38.27C182.14,-36.98 189.41,-33.76 189.41,-28.6 189.41,-25.54 186.85,-23.16 182.58,-21.46"/>
+<polygon fill="black" stroke="black" points="183.7,-18.13 173.17,-19.27 182.12,-24.95 183.7,-18.13"/>
+<text xml:space="preserve" text-anchor="middle" x="242.47" y="-41.2" font-family="Times,serif" font-size="14.00">semantic search</text>
+<text xml:space="preserve" text-anchor="middle" x="242.47" y="-24.4" font-family="Times,serif" font-size="14.00">vector embeddings</text>
+<text xml:space="preserve" text-anchor="middle" x="242.47" y="-7.6" font-family="Times,serif" font-size="14.00">graph traversal</text>
+</g>
+</g>
+</svg>

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "amalfa",
-	"version": "1.0.14",
+	"version": "1.0.16",
 	"description": "Local-first knowledge graph engine for AI agents. Transforms markdown into searchable memory with MCP protocol.",
 	"license": "MIT",
 	"homepage": "https://github.com/pjsvis/amalfa#readme",

package/src/cli.ts

@@ -3,7 +3,7 @@ import { existsSync, statSync } from "node:fs";
 import { join } from "node:path";
 import { spawn } from "node:child_process";
 
-const VERSION = "1.0.14";
+const VERSION = "1.0.16";
 
 // Database path loaded from config (lazy loaded per command)
 let DB_PATH: string | null = null;