mindlore 0.6.8 → 0.7.0

package/skills/mindlore-maintain/SKILL.md

@@ -1,125 +1,125 @@
----
-name: mindlore-maintain
-description: KB maintenance — decay/archive, episode consolidation, contradiction detection
-effort: medium
-context: fork
-allowed-tools: [Read, Write, Edit, Bash, Grep, Glob]
----
-
-## 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-maintain" → `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-maintain
-
-KB bakım skill'i. Reflect düşünür, maintain temizler.
-
-## Trigger
-
-- `/mindlore-maintain` — full rapor (decay + consolidation + contradiction)
-- `/mindlore-maintain decay` — stale doc listesi + archive flow
-- `/mindlore-maintain consolidate` — episode gruplama + dosyaya promote
-- `/mindlore-maintain contradictions` — çelişki analizi
-- `/mindlore-maintain triage` — unpromoted raw dosyaları listele + metadata göster
-
-## Decay Mode
-
-1. Stale documents listele:
-   ```bash
-   DECAY_MOD="$MINDLORE_PKG/dist/scripts/lib/decay.js"
-   node -e "
-     const { listStaleDocuments } = require(process.argv[1]);
-     const Database = require('better-sqlite3');
-     const path = require('path'), os = require('os');
-     const dbPath = path.join(os.homedir(), '.mindlore', 'mindlore.db');
-     const db = new Database(dbPath, {readonly: true});
-     let decayConfig = {};
-     try {
-       const configPath = path.join(os.homedir(), '.mindlore', 'config.json');
-       decayConfig = JSON.parse(require('fs').readFileSync(configPath, 'utf8')).decay || {};
-     } catch (_err) { /* use defaults if config missing or malformed */ }
-     const stale = listStaleDocuments(db, undefined, decayConfig);
-     console.log(JSON.stringify(stale, null, 2));
-     db.close();
-   " "$DECAY_MOD"
-   ```
-
-2. Rapor sun:
-   ```
-   -- Decay Report --
-   | # | File | Score | Last Access | Recalls | Action |
-   |---|------|-------|-------------|---------|--------|
-   | 1 | sources/old-api.md | 0.12 | 2025-11-01 | 0 | Archive? |
-   ```
-
-3. Kullanıcı onaylarsa:
-   a. Git snapshot: `createPreEvictionTag`
-   b. Arşivle: `archiveDocument(db, path)`
-   c. Rapor: "Archived N docs. Git tag: pre-eviction-2026-04-18. Restore: `/mindlore-maintain restore <path>`"
-
-**Kurallar:**
-- Onay almadan ARŞİVLEME
-- Arşiv öncesi HER ZAMAN git snapshot
-- Score + last access + recall count göster
-
-## Consolidation Mode
-
-1. Raw episode sayısını kontrol et
-2. Gruplama önerisi sun:
-   ```
-   -- Consolidation Önerisi --
-   3 learning episode → learnings/typescript-strict-patterns.md
-   2 discovery episode → insights/sqlite-vec-windows-gotchas.md
-   ```
-
-3. Kind→dizin mapping (deterministik):
-   - learning → `learnings/`
-   - discovery → `insights/`
-   - friction → `analyses/`
-   - decision → `decisions/`
-   - preference → CC memory'de var mı kontrol et, varsa skip, yoksa `learnings/`
-
-4. Kullanıcı onaylarsa:
-   a. Hedef dosya yaz (frontmatter zorunlu: consolidated_from, consolidated_at, kind_source)
-   b. Episode'ları işaretle: `markConsolidated(db, ids, targetFile)`
-   c. Rapor: "N episode → M dosya promote edildi"
-
-**Kurallar:**
-- session/event episode'ları CONSOLİDATE EDİLMEZ
-- Onay almadan dosya YAZMA
-- `consolidated_from` frontmatter ZORUNLU (provenance)
-
-## Contradiction Mode
-
-1. Deterministic wiki-lint:
-   ```bash
-   node "$MINDLORE_PKG/dist/scripts/mindlore-health-check.js" ~/.mindlore 2>/dev/null | grep -A 5 'contradiction'
-   ```
-
-2. Semantic analiz (opsiyonel, token harcar)
-
-**Kurallar:**
-- Deterministic check HER ZAMAN çalışır
-- Çelişkileri OTOMATİK düzeltme — kullanıcıya sor
-
-## Full Report Mode (flagsız)
-
-```
--- Maintain Report --
-Decay: 3 stale document (score < 0.3)
-Consolidation: 52 raw episode (learning: 15, discovery: 8, friction: 4)
-Contradictions: 1 found
-
-Aksiyon için:
-  /mindlore-maintain decay
-  /mindlore-maintain consolidate
-  /mindlore-maintain contradictions
-```
-
-## Restore Mode
-
-`/mindlore-maintain restore <path>` — arşivlenmiş dokümanı geri yükler.
+---
+name: mindlore-maintain
+description: KB maintenance — decay/archive, episode consolidation, contradiction detection
+effort: medium
+context: fork
+allowed-tools: [Read, Write, Edit, Bash, Grep, Glob]
+---
+
+## 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-maintain" → `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-maintain
+
+KB bakım skill'i. Reflect düşünür, maintain temizler.
+
+## Trigger
+
+- `/mindlore-maintain` — full rapor (decay + consolidation + contradiction)
+- `/mindlore-maintain decay` — stale doc listesi + archive flow
+- `/mindlore-maintain consolidate` — episode gruplama + dosyaya promote
+- `/mindlore-maintain contradictions` — çelişki analizi
+- `/mindlore-maintain triage` — unpromoted raw dosyaları listele + metadata göster
+
+## Decay Mode
+
+1. Stale documents listele:
+   ```bash
+   DECAY_MOD="$MINDLORE_PKG/dist/scripts/lib/decay.js"
+   node -e "
+     const { listStaleDocuments } = require(process.argv[1]);
+     const Database = require('better-sqlite3');
+     const path = require('path'), os = require('os');
+     const dbPath = path.join(os.homedir(), '.mindlore', 'mindlore.db');
+     const db = new Database(dbPath, {readonly: true});
+     let decayConfig = {};
+     try {
+       const configPath = path.join(os.homedir(), '.mindlore', 'config.json');
+       decayConfig = JSON.parse(require('fs').readFileSync(configPath, 'utf8')).decay || {};
+     } catch (_err) { /* use defaults if config missing or malformed */ }
+     const stale = listStaleDocuments(db, undefined, decayConfig);
+     console.log(JSON.stringify(stale, null, 2));
+     db.close();
+   " "$DECAY_MOD"
+   ```
+
+2. Rapor sun:
+   ```
+   -- Decay Report --
+   | # | File | Score | Last Access | Recalls | Action |
+   |---|------|-------|-------------|---------|--------|
+   | 1 | sources/old-api.md | 0.12 | 2025-11-01 | 0 | Archive? |
+   ```
+
+3. Kullanıcı onaylarsa:
+   a. Git snapshot: `createPreEvictionTag`
+   b. Arşivle: `archiveDocument(db, path)`
+   c. Rapor: "Archived N docs. Git tag: pre-eviction-2026-04-18. Restore: `/mindlore-maintain restore <path>`"
+
+**Kurallar:**
+- Onay almadan ARŞİVLEME
+- Arşiv öncesi HER ZAMAN git snapshot
+- Score + last access + recall count göster
+
+## Consolidation Mode
+
+1. Raw episode sayısını kontrol et
+2. Gruplama önerisi sun:
+   ```
+   -- Consolidation Önerisi --
+   3 learning episode → learnings/typescript-strict-patterns.md
+   2 discovery episode → insights/sqlite-vec-windows-gotchas.md
+   ```
+
+3. Kind→dizin mapping (deterministik):
+   - learning → `learnings/`
+   - discovery → `insights/`
+   - friction → `analyses/`
+   - decision → `decisions/`
+   - preference → CC memory'de var mı kontrol et, varsa skip, yoksa `learnings/`
+
+4. Kullanıcı onaylarsa:
+   a. Hedef dosya yaz (frontmatter zorunlu: consolidated_from, consolidated_at, kind_source)
+   b. Episode'ları işaretle: `markConsolidated(db, ids, targetFile)`
+   c. Rapor: "N episode → M dosya promote edildi"
+
+**Kurallar:**
+- session/event episode'ları CONSOLİDATE EDİLMEZ
+- Onay almadan dosya YAZMA
+- `consolidated_from` frontmatter ZORUNLU (provenance)
+
+## Contradiction Mode
+
+1. Deterministic wiki-lint:
+   ```bash
+   node "$MINDLORE_PKG/dist/scripts/mindlore-health-check.js" ~/.mindlore 2>/dev/null | grep -A 5 'contradiction'
+   ```
+
+2. Semantic analiz (opsiyonel, token harcar)
+
+**Kurallar:**
+- Deterministic check HER ZAMAN çalışır
+- Çelişkileri OTOMATİK düzeltme — kullanıcıya sor
+
+## Full Report Mode (flagsız)
+
+```
+-- Maintain Report --
+Decay: 3 stale document (score < 0.3)
+Consolidation: 52 raw episode (learning: 15, discovery: 8, friction: 4)
+Contradictions: 1 found
+
+Aksiyon için:
+  /mindlore-maintain decay
+  /mindlore-maintain consolidate
+  /mindlore-maintain contradictions
+```
+
+## Restore Mode
+
+`/mindlore-maintain restore <path>` — arşivlenmiş dokümanı geri yükler.

package/skills/mindlore-query/SKILL.md

@@ -1,151 +1,151 @@
----
-name: mindlore-query
-description: Search, ask, stats, brief — compounding pipeline
-context: fork
-allowed-tools: [Bash, Read, Grep, Glob]
----
-
-# Skill: Mindlore Query
-
-Search, ask, analyze, and retrieve knowledge from `.mindlore/`.
-
-## 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-query" → `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.
-
-## 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`.
-
-## Modes
-
-### search
-
-FTS5 keyword search + episodes recall with unified results.
-
-**Flow:**
-1. Parse user query into keywords (strip stop words)
-2. Run FTS5 MATCH on `mindlore_fts` table (knowledge: "ne biliyorum")
-3. Run LIKE search on `episodes` table (memory: "ne oldu, ne karar aldım")
-4. Merge results: FTS5 results first, then matching episodes
-5. Return top 5 knowledge results + top 3 episode results
-6. Display knowledge as table with snippet preview, episodes as timeline
-7. If `--tags <tag>` flag provided: `WHERE tags MATCH '<tag>'` filter (FTS5 only)
-8. If `--episodes-only` flag: skip FTS5, show only episode matches
-
-**Output format:**
-```
-| # | Category | Title | Description | Score |
-|---|----------|-------|-------------|-------|
-| 1 | sources  | React Hooks | useEffect cleanup patterns | -2.34 |
-```
-
-### ask
-
-Compounding query pipeline — knowledge grows with each answer.
-
-**Flow:**
-1. Parse user question
-2. FTS5 search → find relevant files (sources + domains + analyses + insights — previous answers INCLUDED)
-3. Read top 3-5 relevant files
-4. Synthesize answer from found knowledge
-5. Cite sources: `[kaynak: sources/x.md]` format
-6. Ask user: "Bu cevabı kaydetmemi ister misin?"
-7. If yes → determine target:
-   - Short answer (<200 lines, 1-2 sources) → `insights/{slug}.md`
-   - Large synthesis (200+ lines, 3+ sources) → `analyses/{slug}.md`
-8. Write with frontmatter:
-
-```yaml
----
-slug: react-hooks-cleanup-comparison
-type: insight
-title: React Hooks Cleanup Comparison
-tags: [react, hooks, useEffect]
-confidence: high
-sources_used: [react-hooks, typescript-generics]
-description: Comparison of cleanup patterns in useEffect vs useLayoutEffect
----
-```
-
-9. FTS5 auto-indexes via FileChanged hook → next query finds this answer
-10. Update relevant domain page (max 1) with backlink if applicable
-11. Append to `log.md`: `| {date} | query-ask | {slug}.md |`
-
-**Compounding effect:** Step 2 searches ALL of `.mindlore/` including previous `insights/` and `analyses/`. Each saved answer enriches the next query.
-
-**Error compounding prevention:**
-- `confidence` field is REQUIRED on writebacks (high/medium/low)
-- `sources_used` lists exact slugs — traceability
-- Health check flags conflicting analyses on same topic (different confidence)
-- User approval is the quality gate — low-quality answers are not saved
-
-### stats
-
-Knowledge base statistics.
-
-**Flow:**
-1. Count files per directory (9 directories)
-2. Count FTS5 entries and file_hashes entries
-3. Find most recent ingest (latest file by modified date per directory)
-4. Count tags frequency (parse all frontmatter, aggregate tags)
-5. Display summary:
-
-```
-Mindlore Stats
-─────────────
-Total files: 47 (FTS5: 47 indexed)
- - sources:     18
- - domains:      5
- - analyses:     6
- - insights:     3
- - connections:  2
- - learnings:    4
- - diary:        8
- - decisions:    1
- - raw:          0
-
-Top tags: security (12), hooks (8), fts5 (6), testing (5)
-Last ingest: 2026-04-11 (sources/react-hooks.md)
-DB size: 1.2 MB
-```
-
-### brief
-
-Quick context on a topic — token-efficient (~50 tokens output).
-
-**Flow:**
-1. FTS5 search for topic
-2. If domain page exists → read first 3 lines of body (after frontmatter)
-3. If no domain → read description field from top FTS5 match
-4. Return: title + description + "Read full: {path}" pointer
-5. Do NOT read full file — this mode is for quick "do I need to open this?" decisions
-
-**Output format:**
-```
-[Mindlore Brief: Security]
-SSH hardening, firewall rules, audit checks. 5 sources, 2 analyses linked.
-→ Read full: .mindlore/domains/security.md
-```
-
-## Rules
-
-- All modes respect the SCHEMA.md writeback rules (Section 6: Wiki vs Diary)
-- search and brief are read-only — no writes
-- ask writes only with user approval
-- stats is read-only
-- Token strategy: Read relevant files directly
-- Tags filter: `--tags security` works in search and ask modes
-- Max results: search=5, ask=3-5 (for synthesis), brief=1
+---
+name: mindlore-query
+description: Search, ask, stats, brief — compounding pipeline
+context: fork
+allowed-tools: [Bash, Read, Grep, Glob]
+---
+
+# Skill: Mindlore Query
+
+Search, ask, analyze, and retrieve knowledge from `.mindlore/`.
+
+## 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-query" → `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.
+
+## 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`.
+
+## Modes
+
+### search
+
+FTS5 keyword search + episodes recall with unified results.
+
+**Flow:**
+1. Parse user query into keywords (strip stop words)
+2. Run FTS5 MATCH on `mindlore_fts` table (knowledge: "ne biliyorum")
+3. Run LIKE search on `episodes` table (memory: "ne oldu, ne karar aldım")
+4. Merge results: FTS5 results first, then matching episodes
+5. Return top 5 knowledge results + top 3 episode results
+6. Display knowledge as table with snippet preview, episodes as timeline
+7. If `--tags <tag>` flag provided: `WHERE tags MATCH '<tag>'` filter (FTS5 only)
+8. If `--episodes-only` flag: skip FTS5, show only episode matches
+
+**Output format:**
+```
+| # | Category | Title | Description | Score |
+|---|----------|-------|-------------|-------|
+| 1 | sources  | React Hooks | useEffect cleanup patterns | -2.34 |
+```
+
+### ask
+
+Compounding query pipeline — knowledge grows with each answer.
+
+**Flow:**
+1. Parse user question
+2. FTS5 search → find relevant files (sources + domains + analyses + insights — previous answers INCLUDED)
+3. Read top 3-5 relevant files
+4. Synthesize answer from found knowledge
+5. Cite sources: `[kaynak: sources/x.md]` format
+6. Ask user: "Bu cevabı kaydetmemi ister misin?"
+7. If yes → determine target:
+   - Short answer (<200 lines, 1-2 sources) → `insights/{slug}.md`
+   - Large synthesis (200+ lines, 3+ sources) → `analyses/{slug}.md`
+8. Write with frontmatter:
+
+```yaml
+---
+slug: react-hooks-cleanup-comparison
+type: insight
+title: React Hooks Cleanup Comparison
+tags: [react, hooks, useEffect]
+confidence: high
+sources_used: [react-hooks, typescript-generics]
+description: Comparison of cleanup patterns in useEffect vs useLayoutEffect
+---
+```
+
+9. FTS5 auto-indexes via FileChanged hook → next query finds this answer
+10. Update relevant domain page (max 1) with backlink if applicable
+11. Append to `log.md`: `| {date} | query-ask | {slug}.md |`
+
+**Compounding effect:** Step 2 searches ALL of `.mindlore/` including previous `insights/` and `analyses/`. Each saved answer enriches the next query.
+
+**Error compounding prevention:**
+- `confidence` field is REQUIRED on writebacks (high/medium/low)
+- `sources_used` lists exact slugs — traceability
+- Health check flags conflicting analyses on same topic (different confidence)
+- User approval is the quality gate — low-quality answers are not saved
+
+### stats
+
+Knowledge base statistics.
+
+**Flow:**
+1. Count files per directory (9 directories)
+2. Count FTS5 entries and file_hashes entries
+3. Find most recent ingest (latest file by modified date per directory)
+4. Count tags frequency (parse all frontmatter, aggregate tags)
+5. Display summary:
+
+```
+Mindlore Stats
+─────────────
+Total files: 47 (FTS5: 47 indexed)
+ - sources:     18
+ - domains:      5
+ - analyses:     6
+ - insights:     3
+ - connections:  2
+ - learnings:    4
+ - diary:        8
+ - decisions:    1
+ - raw:          0
+
+Top tags: security (12), hooks (8), fts5 (6), testing (5)
+Last ingest: 2026-04-11 (sources/react-hooks.md)
+DB size: 1.2 MB
+```
+
+### brief
+
+Quick context on a topic — token-efficient (~50 tokens output).
+
+**Flow:**
+1. FTS5 search for topic
+2. If domain page exists → read first 3 lines of body (after frontmatter)
+3. If no domain → read description field from top FTS5 match
+4. Return: title + description + "Read full: {path}" pointer
+5. Do NOT read full file — this mode is for quick "do I need to open this?" decisions
+
+**Output format:**
+```
+[Mindlore Brief: Security]
+SSH hardening, firewall rules, audit checks. 5 sources, 2 analyses linked.
+→ Read full: .mindlore/domains/security.md
+```
+
+## Rules
+
+- All modes respect the SCHEMA.md writeback rules (Section 6: Wiki vs Diary)
+- search and brief are read-only — no writes
+- ask writes only with user approval
+- stats is read-only
+- Token strategy: Read relevant files directly
+- Tags filter: `--tags security` works in search and ask modes
+- Max results: search=5, ask=3-5 (for synthesis), brief=1