mindlore 0.6.8 → 0.7.0

package/package.json

@@ -1,75 +1,77 @@
-{
-  "name": "mindlore",
-  "version": "0.6.8",
-  "description": "AI-native knowledge system for Claude Code",
-  "type": "commonjs",
-  "bin": {
-    "mindlore": "dist/scripts/init.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "prebuild": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
-    "test": "jest --config jest.config.cjs",
-    "lint": "eslint -c eslint.config.cjs scripts/ hooks/ tests/",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "npm run build",
-    "health": "node dist/scripts/mindlore-health-check.js",
-    "index": "node dist/scripts/mindlore-fts5-index.js",
-    "search": "node dist/scripts/mindlore-fts5-search.js",
-    "quality": "node dist/scripts/quality-populate.js",
-    "fetch-raw": "node dist/scripts/fetch-raw.js",
-    "cc-sync": "node dist/scripts/cc-memory-bulk-sync.js",
-    "cleanup": "node dist/scripts/maintain-cleanup.js",
-    "perf": "node dist/scripts/mindlore-perf.js",
-    "doctor": "node dist/scripts/mindlore-doctor.js",
-    "audit": "npm audit --audit-level=moderate"
-  },
-  "keywords": [
-    "claude-code",
-    "knowledge-base",
-    "second-brain",
-    "ai-native",
-    "fts5",
-    "karpathy",
-    "llm",
-    "wiki"
-  ],
-  "author": "omrfc",
-  "license": "AGPL-3.0-only",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/mindlore/mindlore.git"
-  },
-  "bugs": {
-    "url": "https://github.com/mindlore/mindlore/issues"
-  },
-  "homepage": "https://github.com/mindlore/mindlore#readme",
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "dependencies": {
-    "better-sqlite3": "^12.9.0",
-    "zod": "^4.3.6"
-  },
-  "devDependencies": {
-    "@types/better-sqlite3": "^7.6.13",
-    "@types/jest": "^30.0.0",
-    "@types/node": "^25.6.0",
-    "@typescript-eslint/eslint-plugin": "^8.59.0",
-    "@typescript-eslint/parser": "^8.58.1",
-    "eslint": "^10.2.0",
-    "globals": "^17.5.0",
-    "jest": "^30.3.0",
-    "ts-jest": "^29.4.9",
-    "typescript": "^6.0.2"
-  },
-  "files": [
-    "agents/",
-    "dist/",
-    "hooks/",
-    "skills/",
-    "templates/",
-    "SCHEMA.md",
-    "plugin.json"
-  ]
-}
+{
+  "name": "mindlore",
+  "version": "0.7.0",
+  "description": "AI-native knowledge system for Claude Code",
+  "type": "commonjs",
+  "bin": {
+    "mindlore": "dist/scripts/init.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "prebuild": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "test": "jest --config jest.config.cjs",
+    "lint": "eslint -c eslint.config.cjs scripts/ hooks/ tests/",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "health": "node dist/scripts/mindlore-health-check.js",
+    "index": "node dist/scripts/mindlore-fts5-index.js",
+    "search": "node dist/scripts/mindlore-fts5-search.js",
+    "quality": "node dist/scripts/quality-populate.js",
+    "fetch-raw": "node dist/scripts/fetch-raw.js",
+    "cc-sync": "node dist/scripts/cc-memory-bulk-sync.js",
+    "cleanup": "node dist/scripts/maintain-cleanup.js",
+    "perf": "node dist/scripts/mindlore-perf.js",
+    "doctor": "node dist/scripts/mindlore-doctor.js",
+    "audit": "npm audit --audit-level=moderate",
+    "validate-manifest": "node dist/scripts/validate-manifest-cli.js"
+  },
+  "keywords": [
+    "claude-code",
+    "knowledge-base",
+    "second-brain",
+    "ai-native",
+    "fts5",
+    "karpathy",
+    "llm",
+    "wiki"
+  ],
+  "author": "omrfc",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mindlore/mindlore.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mindlore/mindlore/issues"
+  },
+  "homepage": "https://github.com/mindlore/mindlore#readme",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "better-sqlite3": "^12.9.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.13",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.6.0",
+    "@typescript-eslint/eslint-plugin": "^8.59.0",
+    "@typescript-eslint/parser": "^8.58.1",
+    "eslint": "^10.2.0",
+    "globals": "^17.5.0",
+    "jest": "^30.3.0",
+    "ts-jest": "^29.4.9",
+    "typescript": "^6.0.2"
+  },
+  "files": [
+    "agents/",
+    "dist/",
+    "hooks/",
+    "skills/",
+    "templates/",
+    "SCHEMA.md",
+    "plugin.json"
+  ]
+}

package/plugin.json

@@ -1,7 +1,8 @@
 {
+  "manifestVersion": 2,
   "name": "mindlore",
   "description": "AI-native knowledge system for Claude Code. Persistent, searchable, evolving knowledge base with FTS5.",
-  "version": "0.6.8",
+  "version": "0.7.0",
   "skills": [
     {
       "name": "mindlore-ingest",
@@ -76,6 +77,12 @@
       "description": "Periodic maintenance, stale detection, health trends"
     }
   ],
+  "mcpServers": {
+    "mindlore": {
+      "command": "npx",
+      "args": ["mindlore", "mcp"]
+    }
+  },
   "hooks": [
     {
       "event": "SessionStart",

package/skills/mindlore-diary/SKILL.md

@@ -1,85 +1,85 @@
----
-name: mindlore-diary
-description: LLM-powered session analysis — decisions, discoveries, frictions, learnings. Promotes episodes to semantic knowledge.
-context: fork
----
-
-## Script Resolution
-
-Resolve `MINDLORE_PKG` (package root) using one of these methods, in order:
-1. If CC injected "Base directory for this skill: /path/to/skills/mindlore-diary" → `MINDLORE_PKG = {base_directory}/../..`
-2. Fallback: run `node -e "console.log(require('path').join(require('child_process').execSync('npm root -g',{encoding:'utf8'}).trim(),'mindlore')))"`
-
-Use: `node "$MINDLORE_PKG/dist/scripts/..."` for all script commands.
-
-# /mindlore-diary
-
-## Scope
-
-Determine target using `getActiveMindloreDir()` logic:
-- If CWD has `.mindlore/` -> project scope
-- Otherwise -> global `~/.mindlore/`
-
-## Trigger
-
-`/mindlore-diary` or `/mindlore-log diary`
-
-## On Start — Read skill_memory
-
-```bash
-node "$MINDLORE_PKG/dist/scripts/lib/skill-memory.js" get mindlore-diary last_diary_date
-```
-If last_diary_date is today, warn: "Diary already ran today. Continue anyway?"
-
-## Flow
-
-1. Read active episodes: `WHERE status = 'active' AND source IN ('hook', 'diary')`
-2. Filter by time: default last 24h, or `--days N` flag
-3. Present summary: "Found N episodes spanning DATE1 to DATE2"
-4. LLM analyzes episodes for semantic patterns:
-   - **Decisions:** choices made, alternatives considered
-   - **Discoveries:** new insights, broken assumptions
-   - **Frictions:** recurring blockers, errors, slowdowns
-   - **Learnings:** techniques that worked, patterns validated
-   - **Preferences:** user workflow preferences detected
-   - **Events:** notable milestones, completions
-
-5. For each detected item, create enriched episode:
-   ```sql
-   INSERT INTO episodes (summary, body, kind, source, status, project, created_at)
-   VALUES (?, ?, ?, 'diary', 'active', ?, ?)
-   ```
-   Where kind = 'decision' | 'discovery' | 'friction' | 'learning' | 'preference' | 'event'
-
-6. Output structured report:
-   ```
-   -- Diary Raporu ({date}, {N} episode analiz edildi) --
-
-   Decisions ({count}):
-     - {summary}
-
-   Discoveries ({count}):
-     - {summary}
-
-   Frictions ({count}):
-     - {summary}
-
-   Learnings ({count}):
-     - {summary}
-
-   {M} yeni episode olusturuldu.
-   ```
-
-## On End — Write skill_memory
-
-```bash
-node "$MINDLORE_PKG/dist/scripts/lib/skill-memory.js" set mindlore-diary last_diary_date "$(date -I)"
-node "$MINDLORE_PKG/dist/scripts/lib/skill-memory.js" set mindlore-diary last_episode_count "{N}"
-```
-
-## Rules
-
-- NEVER create episodes without user seeing the analysis first
-- Each episode must have proper `kind` field — don't default everything to 'event'
-- Group related items — don't create 5 episodes for the same friction
-- Append to `log.md`: `| {date} | diary | {N} episodes created |`
+---
+name: mindlore-diary
+description: LLM-powered session analysis — decisions, discoveries, frictions, learnings. Promotes episodes to semantic knowledge.
+context: fork
+---
+
+## Script Resolution
+
+Resolve `MINDLORE_PKG` (package root) using one of these methods, in order:
+1. If CC injected "Base directory for this skill: /path/to/skills/mindlore-diary" → `MINDLORE_PKG = {base_directory}/../..`
+2. Fallback: run `node -e "console.log(require('path').join(require('child_process').execSync('npm root -g',{encoding:'utf8'}).trim(),'mindlore')))"`
+
+Use: `node "$MINDLORE_PKG/dist/scripts/..."` for all script commands.
+
+# /mindlore-diary
+
+## Scope
+
+Determine target using `getActiveMindloreDir()` logic:
+- If CWD has `.mindlore/` -> project scope
+- Otherwise -> global `~/.mindlore/`
+
+## Trigger
+
+`/mindlore-diary` or `/mindlore-log diary`
+
+## On Start — Read skill_memory
+
+```bash
+node "$MINDLORE_PKG/dist/scripts/lib/skill-memory.js" get mindlore-diary last_diary_date
+```
+If last_diary_date is today, warn: "Diary already ran today. Continue anyway?"
+
+## Flow
+
+1. Read active episodes: `WHERE status = 'active' AND source IN ('hook', 'diary')`
+2. Filter by time: default last 24h, or `--days N` flag
+3. Present summary: "Found N episodes spanning DATE1 to DATE2"
+4. LLM analyzes episodes for semantic patterns:
+   - **Decisions:** choices made, alternatives considered
+   - **Discoveries:** new insights, broken assumptions
+   - **Frictions:** recurring blockers, errors, slowdowns
+   - **Learnings:** techniques that worked, patterns validated
+   - **Preferences:** user workflow preferences detected
+   - **Events:** notable milestones, completions
+
+5. For each detected item, create enriched episode:
+   ```sql
+   INSERT INTO episodes (summary, body, kind, source, status, project, created_at)
+   VALUES (?, ?, ?, 'diary', 'active', ?, ?)
+   ```
+   Where kind = 'decision' | 'discovery' | 'friction' | 'learning' | 'preference' | 'event'
+
+6. Output structured report:
+   ```
+   -- Diary Raporu ({date}, {N} episode analiz edildi) --
+
+   Decisions ({count}):
+     - {summary}
+
+   Discoveries ({count}):
+     - {summary}
+
+   Frictions ({count}):
+     - {summary}
+
+   Learnings ({count}):
+     - {summary}
+
+   {M} yeni episode olusturuldu.
+   ```
+
+## On End — Write skill_memory
+
+```bash
+node "$MINDLORE_PKG/dist/scripts/lib/skill-memory.js" set mindlore-diary last_diary_date "$(date -I)"
+node "$MINDLORE_PKG/dist/scripts/lib/skill-memory.js" set mindlore-diary last_episode_count "{N}"
+```
+
+## Rules
+
+- NEVER create episodes without user seeing the analysis first
+- Each episode must have proper `kind` field — don't default everything to 'event'
+- Group related items — don't create 5 episodes for the same friction
+- Append to `log.md`: `| {date} | diary | {N} episodes created |`

package/skills/mindlore-evolve/SKILL.md

@@ -1,126 +1,126 @@
----
-name: mindlore-evolve
-description: Knowledge schema co-evolution — scan domains+sources, detect inconsistencies, suggest updates
-effort: medium
-context: fork
-allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent]
----
-
-## Script Resolution
-
-Resolve `MINDLORE_PKG` (package root) using one of these methods, in order:
-1. If CC injected "Base directory for this skill: /path/to/skills/mindlore-evolve" → `MINDLORE_PKG = {base_directory}/../..`
-2. Fallback: run `node -e "console.log(require('path').join(require('child_process').execSync('npm root -g',{encoding:'utf8'}).trim(),'mindlore')))"`
-
-Use: `node "$MINDLORE_PKG/dist/scripts/..."` for all script commands.
-
-# /mindlore-evolve
-
-Knowledge schema co-evolution. Karpathy's 4th operation (ingest/query/health/**evolve**).
-
-## Scope
-
-Default: `--scope all` (project + global birlikte taranır).
-Options: `--scope project` | `--scope global` | `--scope all`
-
-1. Determine scope from argument (default: all)
-2. If `all`: scan both project `.mindlore/` and global `~/.mindlore/`
-3. If `project`: scan only project-scoped content (current CWD's `.mindlore/`)
-4. If `global`: scan only global `~/.mindlore/` content
-- Never hardcode `.mindlore/` path — always resolve dynamically via `getActiveMindloreDir()`
-
-## Trigger
-
-User says `/mindlore-evolve`, "knowledge evolve", "bilgi sistemi evrimle", "sema guncelle".
-
-## Modes
-
-### scan (default)
-
-Scan all domains and sources for inconsistencies.
-
-**Pre-check (before scan):**
-
-Before spawning the agent, check KB maturity:
-```bash
-# Count domains and sources
-DOMAIN_COUNT=$(ls ~/.mindlore/domains/ 2>/dev/null | grep -c '.md$' || echo 0)
-SOURCE_COUNT=$(ls ~/.mindlore/sources/ 2>/dev/null | grep -c '.md$' || echo 0)
-```
-
-If `DOMAIN_COUNT == 0`:
-- Show: "Fresh KB detected (0 domains, N sources). Evolve works best with at least 1 domain. Run `/mindlore-ingest` to add sources, then manually create domain files to organize them."
-- If `SOURCE_COUNT < 3`: Show "Too few sources for meaningful evolution scan. Add more knowledge first." and STOP.
-- If `SOURCE_COUNT >= 3` but 0 domains: Show warning but continue scan — findings will be limited to orphan/tag checks.
-
-**Agent Delegation:** Tarama işini subagent'a delege et (context koruma).
-
-**Flow:**
-1. Spawn an Agent for scanning:
-   ```
-   Agent({
-     description: "mindlore evolve: scan",
-     subagent_type: "Explore",
-     prompt: "[mindlore:evolve] Scan .mindlore/ for inconsistencies. <aşağıdaki talimatları buraya koy>"
-   })
-   ```
-
-   Agent talimatları:
-   a. Read INDEX.md to get domain and source file lists
-   b. Read all domain files (from `domains/`)
-   c. Read all source files (from `sources/`)
-   d. Detect issues (see list below)
-   e. Return findings as structured table
-
-2. After agent returns — review findings
-3. Show findings table to user
-4. Detect issues:
-   - **Orphan files:** .md files in content directories not listed in INDEX.md
-   - **Missing references:** Source exists but no domain mentions it
-   - **Stale domains:** Source updated more recently than referencing domain
-   - **Tag inconsistencies:** Tags in frontmatter don't match content
-   - **Missing cross-references:** Related sources not linked
-5. Report findings as a table:
-
-```
-| # | Type | File | Issue | Suggested Fix |
-|---|------|------|-------|---------------|
-| 1 | orphan | sources/old.md | Not in INDEX.md | Add to INDEX or delete |
-| 2 | missing-ref | sources/react-hooks.md | No domain reference | Add to domains/frontend.md |
-```
-
-6. If `--dry-run`: stop here, no change suggestions
-
-### apply
-
-Apply suggested changes with user approval.
-
-**Flow:**
-1. Run scan first (reuse findings)
-2. For each finding, show proposed change (diff format)
-3. Wait for user approval before each change
-4. Apply approved changes
-5. Update INDEX.md with new entries
-6. Append EVOLVE entry to log.md
-7. Max 2 domain updates per run (prevent scope creep)
-
-**Rules:**
-- NEVER make automatic changes — always require user approval
-- Show diff preview before applying
-- After changes, run `node "$MINDLORE_PKG/dist/scripts/mindlore-fts5-index.js"` for FTS5 sync
-- Log every change to log.md with timestamp
-- The `[mindlore:evolve]` marker in the Agent prompt is required — it triggers the model-router hook to use the cost-optimized model (sonnet by default)
-
-## Output Format
-
-```
-Mindlore Evolve — Scan Results
-
-Scope: project (.mindlore/)
-Files scanned: 12 sources, 5 domains
-Issues found: 3
-
-[table of findings]
-
-Run `/mindlore-evolve apply` to fix with approval.
-```
+---
+name: mindlore-evolve
+description: Knowledge schema co-evolution — scan domains+sources, detect inconsistencies, suggest updates
+effort: medium
+context: fork
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent]
+---
+
+## Script Resolution
+
+Resolve `MINDLORE_PKG` (package root) using one of these methods, in order:
+1. If CC injected "Base directory for this skill: /path/to/skills/mindlore-evolve" → `MINDLORE_PKG = {base_directory}/../..`
+2. Fallback: run `node -e "console.log(require('path').join(require('child_process').execSync('npm root -g',{encoding:'utf8'}).trim(),'mindlore')))"`
+
+Use: `node "$MINDLORE_PKG/dist/scripts/..."` for all script commands.
+
+# /mindlore-evolve
+
+Knowledge schema co-evolution. Karpathy's 4th operation (ingest/query/health/**evolve**).
+
+## Scope
+
+Default: `--scope all` (project + global birlikte taranır).
+Options: `--scope project` | `--scope global` | `--scope all`
+
+1. Determine scope from argument (default: all)
+2. If `all`: scan both project `.mindlore/` and global `~/.mindlore/`
+3. If `project`: scan only project-scoped content (current CWD's `.mindlore/`)
+4. If `global`: scan only global `~/.mindlore/` content
+- Never hardcode `.mindlore/` path — always resolve dynamically via `getActiveMindloreDir()`
+
+## Trigger
+
+User says `/mindlore-evolve`, "knowledge evolve", "bilgi sistemi evrimle", "sema guncelle".
+
+## Modes
+
+### scan (default)
+
+Scan all domains and sources for inconsistencies.
+
+**Pre-check (before scan):**
+
+Before spawning the agent, check KB maturity:
+```bash
+# Count domains and sources
+DOMAIN_COUNT=$(ls ~/.mindlore/domains/ 2>/dev/null | grep -c '.md$' || echo 0)
+SOURCE_COUNT=$(ls ~/.mindlore/sources/ 2>/dev/null | grep -c '.md$' || echo 0)
+```
+
+If `DOMAIN_COUNT == 0`:
+- Show: "Fresh KB detected (0 domains, N sources). Evolve works best with at least 1 domain. Run `/mindlore-ingest` to add sources, then manually create domain files to organize them."
+- If `SOURCE_COUNT < 3`: Show "Too few sources for meaningful evolution scan. Add more knowledge first." and STOP.
+- If `SOURCE_COUNT >= 3` but 0 domains: Show warning but continue scan — findings will be limited to orphan/tag checks.
+
+**Agent Delegation:** Tarama işini subagent'a delege et (context koruma).
+
+**Flow:**
+1. Spawn an Agent for scanning:
+   ```
+   Agent({
+     description: "mindlore evolve: scan",
+     subagent_type: "Explore",
+     prompt: "[mindlore:evolve] Scan .mindlore/ for inconsistencies. <aşağıdaki talimatları buraya koy>"
+   })
+   ```
+
+   Agent talimatları:
+   a. Read INDEX.md to get domain and source file lists
+   b. Read all domain files (from `domains/`)
+   c. Read all source files (from `sources/`)
+   d. Detect issues (see list below)
+   e. Return findings as structured table
+
+2. After agent returns — review findings
+3. Show findings table to user
+4. Detect issues:
+   - **Orphan files:** .md files in content directories not listed in INDEX.md
+   - **Missing references:** Source exists but no domain mentions it
+   - **Stale domains:** Source updated more recently than referencing domain
+   - **Tag inconsistencies:** Tags in frontmatter don't match content
+   - **Missing cross-references:** Related sources not linked
+5. Report findings as a table:
+
+```
+| # | Type | File | Issue | Suggested Fix |
+|---|------|------|-------|---------------|
+| 1 | orphan | sources/old.md | Not in INDEX.md | Add to INDEX or delete |
+| 2 | missing-ref | sources/react-hooks.md | No domain reference | Add to domains/frontend.md |
+```
+
+6. If `--dry-run`: stop here, no change suggestions
+
+### apply
+
+Apply suggested changes with user approval.
+
+**Flow:**
+1. Run scan first (reuse findings)
+2. For each finding, show proposed change (diff format)
+3. Wait for user approval before each change
+4. Apply approved changes
+5. Update INDEX.md with new entries
+6. Append EVOLVE entry to log.md
+7. Max 2 domain updates per run (prevent scope creep)
+
+**Rules:**
+- NEVER make automatic changes — always require user approval
+- Show diff preview before applying
+- After changes, run `node "$MINDLORE_PKG/dist/scripts/mindlore-fts5-index.js"` for FTS5 sync
+- Log every change to log.md with timestamp
+- The `[mindlore:evolve]` marker in the Agent prompt is required — it triggers the model-router hook to use the cost-optimized model (sonnet by default)
+
+## Output Format
+
+```
+Mindlore Evolve — Scan Results
+
+Scope: project (.mindlore/)
+Files scanned: 12 sources, 5 domains
+Issues found: 3
+
+[table of findings]
+
+Run `/mindlore-evolve apply` to fix with approval.
+```