@aisystemresources/emdee 0.2.2 → 0.3.0

package/.claude/commands/describe-image.md

@@ -0,0 +1,17 @@
+---
+name: describe-image
+description: Describe an EMDEE vault image doc and rename it from timestamp to semantic title.
+argument-hint: <vault-path>
+---
+
+Take the vault doc path from `$ARGUMENTS`. Run the emdee-describe-image skill workflow:
+
+1. `emdee get-image --doc-path $ARGUMENTS --remote --out /tmp/emdee-describe.jpg` — save the image locally
+2. Read the image visually and compose:
+   - A semantic title, 3-6 words, UPPERCASE-with-HYPHENS (e.g. `HANDSTAND-BALANCE-DRILL`)
+   - A one-line summary, 15-30 words
+3. `emdee rename-doc --old-path $ARGUMENTS --new-title <TITLE> --remote`
+4. Get the fresh preamble hash: `emdee get-doc --path <new-path> --remote --json`
+5. `emdee patch-preamble --path <new-path> --body "> <summary>" --expected-hash <hash> --remote`
+
+Report the before/after path + title + summary as a punch list at the end.

package/.claude/commands/summarise.md

@@ -0,0 +1,24 @@
+---
+name: summarise
+description: Refresh drifting doc summaries. Optional path prefix argument narrows the batch.
+argument-hint: [path-prefix]
+---
+
+Run the emdee-summariser skill's batch flow:
+
+1. `emdee list-summary-drift --remote --limit 20 --format text` (append `--prefix $ARGUMENTS` if the user provided one) → get up to 20 candidate paths
+2. For each path, `emdee get-doc --path <path> --remote --full --format text` → read the body
+3. Compose a fresh summary (15-40 words) that answers "what is this and why does it exist"
+4. Present all proposals as a punch list — do NOT patch yet:
+
+```
+<path>
+  Current: <old blockquote>
+  Proposed: <new blockquote>
+```
+
+5. Wait for the user's approval (per-doc or bulk). On approval:
+   - `emdee get-doc --path <path> --remote --json` → fetch preamble.content_hash
+   - `emdee patch-preamble --path <path> --body "> <new>" --expected-hash <hash> --remote`
+
+Never batch-patch without human review — image content is high-signal but the model can misread ambiguous shots.

package/.claude/commands/vault-status.md

@@ -0,0 +1,21 @@
+---
+name: vault-status
+description: Show a mini dashboard of the user's EMDEE vault — total docs + top 3 drifting summaries.
+---
+
+Run these commands via the Bash tool and present the results as a compact dashboard:
+
+1. `emdee list --remote | wc -l` → total doc count
+2. `emdee list-summary-drift --remote --limit 3 --format text` → top 3 drifting paths
+
+Format the output as:
+
+```
+Vault: <N> docs total, <M> with drifting summaries
+Top drift candidates:
+  - <path 1>
+  - <path 2>
+  - <path 3>
+```
+
+If `emdee list --remote` errors with "run login", tell the user to run `emdee login` first and stop.

package/.claude-plugin/plugin.json

@@ -0,0 +1,21 @@
+{
+  "name": "emdee",
+  "displayName": "Emdee — Local-first knowledge graph",
+  "description": "Local-first knowledge graph backed by plain markdown. Bundles the emdee.tech MCP server, the emdee CLI, and 4 Claude Code skills that teach vault conventions + workflows.",
+  "version": "0.2.2",
+  "author": {
+    "name": "AI System Resources",
+    "url": "https://emdee.tech"
+  },
+  "homepage": "https://emdee.tech",
+  "repository": "https://github.com/AISystemResources/emdee",
+  "license": "MIT",
+  "keywords": ["knowledge-graph", "markdown", "vault", "mcp", "claude"],
+  "mcpServers": {
+    "emdee": {
+      "type": "http",
+      "url": "https://emdee.tech/api/mcp"
+    }
+  },
+  "skills": "./skills"
+}

package/README.md

@@ -8,6 +8,23 @@ LLM agents need a stable, human-readable substrate to read and write their own c
 
 ## Install
 
+**Claude Code plugin (recommended — MCP + CLI + skills in one shot):**
+
+```bash
+claude plugin install @aisystemresources/emdee
+```
+
+This installs the CLI, wires up the emdee.tech MCP server, and drops in 4 auto-loading skills. Then:
+
+```bash
+emdee login                          # PKCE flow, opens browser
+emdee whoami                         # confirms your namespace
+```
+
+Slash commands available after install: `/vault-status`, `/describe-image <path>`, `/summarise [prefix]`.
+
+**CLI-only (no plugin, for scripting or non-Claude-Code use):**
+
 ```bash
 npm install -g @aisystemresources/emdee
 cd ~/my-vault
@@ -16,6 +33,8 @@ emdee list                           # your owner + 5 virtual system nodes
 emdee mcp                            # stdio MCP server — point Claude Code at it
 ```
 
+**claude.ai users:** the plugin doesn't apply (different install model). Use the connect panel on emdee.tech to add the HTTP MCP server directly.
+
 ## The 5-node OS layer
 
 Every Emdee vault has exactly 5 canonical top-level nodes, plus your owner node:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aisystemresources/emdee",
-  "version": "0.2.2",
+  "version": "0.3.0",
   "description": "Local-first document management with markdown rendering, knowledge graph, and MCP server.",
   "type": "module",
   "bin": {
@@ -36,6 +36,8 @@
     "src/mcp/",
     "skills/",
     "templates/",
+    ".claude-plugin/",
+    ".claude/commands/",
     "README.md"
   ],
   "dependencies": {