mindlore 0.2.0 → 0.3.0

package/hooks/mindlore-session-focus.cjs

@@ -34,6 +34,20 @@ function main() {
     output.push(`[Mindlore Delta: ${deltaName}]\n${deltaContent}`);
   }
 
+  // Version check: compare .version (installed) vs .pkg-version (package)
+  // Both are flat strings written by init — no JSON parse needed on session start
+  const versionPath = path.join(baseDir, '.version');
+  const pkgVersionPath = path.join(baseDir, '.pkg-version');
+  try {
+    if (fs.existsSync(versionPath) && fs.existsSync(pkgVersionPath)) {
+      const installed = fs.readFileSync(versionPath, 'utf8').trim();
+      const pkgVersion = fs.readFileSync(pkgVersionPath, 'utf8').trim();
+      if (pkgVersion && pkgVersion !== installed) {
+        output.push(`[Mindlore: Guncelleme mevcut (${installed} → ${pkgVersion}). \`npx mindlore init\` calistirin.]`);
+      }
+    }
+  } catch (_err) { /* skip */ }
+
   if (output.length > 0) {
     process.stdout.write(output.join('\n\n') + '\n');
   }

package/package.json

@@ -1,17 +1,22 @@
 {
   "name": "mindlore",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "AI-native knowledge system for Claude Code",
   "type": "commonjs",
   "bin": {
-    "mindlore": "scripts/init.cjs"
+    "mindlore": "dist/scripts/init.js"
   },
   "scripts": {
+    "build": "tsc",
+    "prebuild": "node -e \"require('fs').rmSync('dist',{recursive:true,force:true})\"",
+    "pretest": "npm run build",
     "test": "jest --config jest.config.cjs",
     "lint": "eslint -c eslint.config.cjs scripts/ hooks/ tests/",
-    "health": "node scripts/mindlore-health-check.cjs",
-    "index": "node scripts/mindlore-fts5-index.cjs",
-    "search": "node scripts/mindlore-fts5-search.cjs"
+    "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"
   },
   "keywords": [
     "claude-code",
@@ -37,15 +42,23 @@
     "node": ">=20.0.0"
   },
   "dependencies": {
-    "better-sqlite3": "^11.0.0"
+    "better-sqlite3": "^11.0.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.58.1",
+    "@typescript-eslint/parser": "^8.58.1",
     "eslint": "^9.0.0",
+    "globals": "^15.0.0",
     "jest": "^29.7.0",
-    "globals": "^15.0.0"
+    "ts-jest": "^29.4.9",
+    "typescript": "^6.0.2"
   },
   "files": [
-    "scripts/",
+    "dist/",
     "hooks/",
     "skills/",
     "templates/",

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "mindlore",
   "description": "AI-native knowledge system for Claude Code. Persistent, searchable, evolving knowledge base with FTS5.",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "skills": [
     {
       "name": "mindlore-ingest",
@@ -27,6 +27,16 @@
       "name": "mindlore-decide",
       "path": "skills/mindlore-decide/SKILL.md",
       "description": "Record and list decisions with context, alternatives, rationale"
+    },
+    {
+      "name": "mindlore-evolve",
+      "path": "skills/mindlore-evolve/SKILL.md",
+      "description": "Knowledge schema co-evolution — scan domains+sources, suggest updates"
+    },
+    {
+      "name": "mindlore-explore",
+      "path": "skills/mindlore-explore/SKILL.md",
+      "description": "Discover unexpected connections between knowledge sources"
     }
   ],
   "hooks": [
@@ -66,6 +76,19 @@
       "event": "PreToolUse",
       "script": "hooks/mindlore-read-guard.cjs",
       "if": "Read"
+    },
+    {
+      "event": "CwdChanged",
+      "script": "hooks/mindlore-cwd-changed.cjs"
+    },
+    {
+      "event": "PostToolUse",
+      "script": "hooks/mindlore-post-read.cjs"
+    },
+    {
+      "event": "PreToolUse",
+      "script": "hooks/mindlore-dont-repeat.cjs",
+      "if": "Write|Edit"
     }
   ]
 }

package/skills/mindlore-decide/SKILL.md

@@ -2,6 +2,14 @@
 
 Record and list decisions in the `.mindlore/decisions/` directory.
 
+## Scope
+
+Determine target using `getActiveMindloreDir()` logic:
+- If CWD has `.mindlore/` → write to project scope
+- Otherwise → write to global `~/.mindlore/`
+- List mode: shows decisions from active scope (use `--all` for both)
+- Never hardcode `.mindlore/` path — always resolve dynamically
+
 ## Trigger
 
 User says `/mindlore-decide record` or `/mindlore-decide list`.

package/skills/mindlore-evolve/SKILL.md

@@ -0,0 +1,81 @@
+---
+name: mindlore-evolve
+description: Knowledge schema co-evolution — scan domains+sources, detect inconsistencies, suggest updates
+effort: medium
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob]
+---
+
+# /mindlore-evolve
+
+Knowledge schema co-evolution. Karpathy's 4th operation (ingest/query/health/**evolve**).
+
+## Scope
+
+Determine target using `getActiveMindloreDir()` logic:
+- Default (no flag): scan project `.mindlore/`
+- `--global`: scan `~/.mindlore/`
+- Never hardcode `.mindlore/` path — always resolve dynamically
+
+## Trigger
+
+User says `/mindlore-evolve`, "knowledge evolve", "bilgi sistemi evrimle", "sema guncelle".
+
+## Modes
+
+### scan (default)
+
+Scan all domains and sources for inconsistencies.
+
+**Flow:**
+1. Read INDEX.md to get domain and source file lists
+2. Read all domain files (from `domains/`)
+3. Read all source files (from `sources/`)
+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 dist/scripts/mindlore-fts5-index.js` for FTS5 sync
+- Log every change to log.md with timestamp
+
+## 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.
+```

package/skills/mindlore-explore/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: mindlore-explore
+description: Discover unexpected connections between sources — undirected knowledge exploration
+effort: medium
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob]
+---
+
+# /mindlore-explore
+
+Discover unexpected connections between knowledge sources. Undirected exploration — unlike query (directed search).
+
+## Scope
+
+Determine target using `getActiveMindloreDir()` logic:
+- Default (no flag): explore project `.mindlore/`
+- `--global`: explore `~/.mindlore/` + project cross-reference (most valuable mode)
+- Never hardcode `.mindlore/` path — always resolve dynamically
+
+## Trigger
+
+User says `/mindlore-explore`, "knowledge explore", "baglanti kesfet", "cross-reference bul".
+
+## Flow
+
+1. Read all source and domain files from active scope
+2. Cross-match by tag + content:
+   - Files sharing tags but not referencing each other
+   - Sources covering similar topics from different angles
+   - Sources that could bridge between domains
+3. Rank connections by strength:
+   - **high**: 3+ shared tags + content overlap
+   - **medium**: 2 shared tags or significant content similarity
+   - **low**: 1 shared tag + weak content match
+4. Show findings to user
+5. On approval, write to `connections/` directory
+
+## Connection File Format
+
+Written to `connections/` with frontmatter:
+
+```markdown
+---
+type: connection
+slug: connection-source-a-source-b
+date_created: 2026-04-12
+sources: [source-a.md, source-b.md]
+domains: [domain-x.md]
+strength: high
+tags: [shared-tag-1, shared-tag-2]
+---
+
+## Connection
+
+[Why these sources are related — LLM explanation]
+
+## Action Suggestion
+
+[What could be done — domain update, new analysis, etc.]
+```
+
+## Rules
+
+- Check for duplicate connections before writing (same source pair)
+- Show findings before writing — user approval required
+- Update INDEX.md with new connections entry
+- Append EXPLORE entry to log.md
+- Strength is LLM-assessed based on tag overlap + content similarity
+
+## Output Format
+
+```
+Mindlore Explore — Discovered Connections
+
+Scope: project (.mindlore/)
+Sources scanned: 12
+Connections found: 3 (2 new, 1 existing)
+
+| # | Sources | Strength | Why |
+|---|---------|----------|-----|
+| 1 | react-hooks.md + agent-orchestration.md | medium | Both discuss state management patterns |
+| 2 | karpathy-kb.md + search-retrieval.md | high | FTS5 + knowledge architecture overlap |
+
+Write connections? (y/n)
+```

package/skills/mindlore-health/SKILL.md

@@ -9,6 +9,14 @@ allowed-tools: [Bash, Read]
 
 Run the 16-point structural health check on the `.mindlore/` knowledge base.
 
+## Scope
+
+Determine target using `getActiveMindloreDir()` logic:
+- Default (no flag): check project `.mindlore/`, fall back to global
+- `--global`: check only `~/.mindlore/`
+- `--all`: check both project + global scopes, report each separately
+- Never hardcode `.mindlore/` path — always resolve dynamically
+
 ## Trigger
 
 User says "health check", "mindlore health", "bilgi sistemi kontrol", "saglik kontrolu".

package/skills/mindlore-ingest/SKILL.md

@@ -9,6 +9,14 @@ allowed-tools: [Read, Write, Edit, Bash, Grep, Glob, Agent, WebFetch]
 
 Add a new knowledge source to the `.mindlore/` knowledge base.
 
+## Scope
+
+Determine target directory using `getActiveMindloreDir()` logic:
+- If CWD has `.mindlore/` → write to project scope
+- Otherwise → write to global `~/.mindlore/`
+- `--global` flag: force write to `~/.mindlore/` even if project scope exists
+- Never hardcode `.mindlore/` path — always resolve dynamically
+
 ## Trigger
 
 User shares a URL, text, file, or says "kaynak ekle", "source ingest", "bu linki kaydet", "knowledge ingest".
@@ -17,8 +25,12 @@ User shares a URL, text, file, or says "kaynak ekle", "source ingest", "bu linki
 
 ### URL Mode
 1. Extract content from URL:
-   - If `markitdown` is available: `markitdown <url>` (best quality, zero tokens)
+   - If `markitdown` is available (`hasMarkitdown()`): `markitdown <url>` (best quality, zero tokens)
    - Else: use `WebFetch` or `ctx_fetch_and_index`
+   - **YouTube URL** detected (`youtube.com` or `youtu.be`):
+     1. markitdown installed → `markitdown <url>` (includes transcript)
+     2. Else youtube-transcript npm → `hasYoutubeTranscript()` check
+     3. Else → ask user to paste transcript manually
 2. Save raw capture to `.mindlore/raw/` with frontmatter:
    ```yaml
    ---
@@ -75,9 +87,12 @@ The sources/ file should contain:
 
 ## Quality Assessment
 
-- `high`: Primary source, authoritative, detailed, directly relevant
-- `medium`: Useful but secondary, partial coverage, or tangentially relevant
-- `low`: Reference only, outdated, or low signal-to-noise
+Assign quality automatically during ingest using this heuristic:
+- `high`: Official docs (anthropic, github docs, MDN), primary research, authoritative references
+- `medium`: Blog posts, tutorials, conference talks, X threads with substance
+- `low`: Raw notes, text pastes, quick captures, low signal-to-noise
+
+LLM may override the heuristic based on content analysis. Always set quality — never leave it null.
 
 ## Domain Update Rules
 

package/skills/mindlore-log/SKILL.md

@@ -2,6 +2,14 @@
 
 Session logging, pattern extraction, and wiki updates.
 
+## Scope
+
+Determine target using `getActiveMindloreDir()` logic:
+- If CWD has `.mindlore/` → write to project scope
+- Otherwise → write to global `~/.mindlore/`
+- Reflect mode: scans both project + global diary/ for patterns
+- Never hardcode `.mindlore/` path — always resolve dynamically
+
 ## Trigger
 
 `/mindlore-log <mode>` where mode is `log`, `reflect`, `status`, or `save`.
@@ -30,19 +38,28 @@ date: 2026-04-11
 
 ### reflect
 
-Scan old deltas, extract patterns, write to learnings/.
-
-**Flow (v0.2 — basic):**
-1. Read all non-archived delta files in `diary/` (no `archived: true` frontmatter)
-2. Present summary to user: "Found N unprocessed deltas spanning DATE1 to DATE2"
-3. For each delta, extract: repeated topics, recurring decisions, common file changes
-4. Propose learnings to user: "I found these patterns: ..."
-5. User approves → write to `learnings/{topic}.md` (append if exists, create if not)
-6. Format: `YAPMA:` / `BEST PRACTICE:` / `KRITIK:` prefixed rules
-7. Mark processed deltas: add `archived: true` to their frontmatter
-8. Append to `log.md`: `| {date} | reflect | {N} deltas processed, {M} learnings written |`
-
-**Important:** Do NOT auto-extract patterns. Present findings, user approves. This is v0.2 basic mode — automated pattern extraction deferred to v0.2.1.
+LLM-driven pattern extraction from diary deltas → persistent learnings.
+
+**Flow (v0.3 — LLM-driven):**
+1. Read last N non-archived delta files in `diary/` (no `archived: true` frontmatter)
+2. Present summary: "Found N unprocessed deltas spanning DATE1 to DATE2"
+3. LLM analyzes deltas for repeating patterns:
+   - Recurring topics/themes across sessions
+   - Repeated decisions (same choice made multiple times)
+   - Common mistakes or friction points
+   - Workflow patterns that worked well
+4. Categorize found patterns by topic (git, testing, architecture, etc.)
+5. Present findings to user with proposed learnings
+6. User approves → write to `learnings/{topic}.md` (append if exists, create if not)
+7. Format: `YAPMA:` / `BEST PRACTICE:` / `KRITIK:` prefixed rules
+8. Update relevant domain page if pattern relates to an existing domain
+9. Mark processed deltas: add `archived: true` to their frontmatter
+10. Append to `log.md`: `| {date} | reflect | {N} deltas processed, {M} learnings written |`
+
+**Rules:**
+- NEVER write learnings without user approval
+- Group related patterns into existing topic files (don't create one file per pattern)
+- Reflect scans both project + global diary/ in `--all` mode
 
 ### status
 

package/skills/mindlore-query/SKILL.md

@@ -2,6 +2,14 @@
 
 Search, ask, analyze, and retrieve knowledge from `.mindlore/`.
 
+## Scope
+
+Determine search scope using `getActiveMindloreDir()` / `getAllDbs()` logic:
+- Default (no flag): search project `.mindlore/` DB, fall back to global
+- `--global`: search only `~/.mindlore/` DB
+- `--all`: search both project + global DBs, project results first
+- Never hardcode `.mindlore/` path — always resolve dynamically
+
 ## Trigger
 
 `/mindlore-query <mode> [query]` where mode is `search`, `ask`, `stats`, or `brief`.

package/templates/SCHEMA.md

@@ -28,6 +28,18 @@ with YAML frontmatter. Search is powered by FTS5 (SQLite full-text search).
 └── mindlore.db     # FTS5 search database (SQLite)
 ```
 
+### Global Scope (v0.3)
+
+Mindlore supports two scopes:
+- **Project scope:** `.mindlore/` in the current working directory (project-specific knowledge)
+- **Global scope:** `~/.mindlore/` in the user's home directory (cross-project knowledge)
+
+Rules:
+- `getActiveMindloreDir()` resolves scope: project if exists, otherwise global
+- Search is layered: project results first, global results second
+- Skills accept `--global` (force global) and `--all` (both scopes) flags
+- `npx mindlore init --global` creates `~/.mindlore/` with git repo for auto-sync
+
 ### Directory Rules
 
 - Each directory corresponds to exactly one frontmatter `type` value
@@ -143,7 +155,7 @@ Discover unexpected connections between sources. Cross-reference analysis.
 - Max results: 3 per query (BM25 ranking)
 - Hook injects: file path + first 2 headings
 
-### FTS5 Columns (9-col schema, v0.2)
+### FTS5 Columns (10-col schema, v0.3)
 
 | Column | Indexed | Source |
 |--------|---------|--------|
@@ -155,7 +167,8 @@ Discover unexpected connections between sources. Cross-reference analysis.
 | `title` | Yes | Frontmatter title or first heading |
 | `content` | Yes | Markdown body (sans frontmatter) |
 | `tags` | Yes | Frontmatter tags (comma-separated) |
-| `quality` | UNINDEXED | Frontmatter quality (NULL until 50+ sources) |
+| `quality` | UNINDEXED | Frontmatter quality (high/medium/low) |
+| `date_captured` | UNINDEXED | Frontmatter date_captured or date |
 
 ### Search Flow (UserPromptSubmit hook)