scopecairn 0.12.0 → 0.14.0

package/README.md

@@ -1,4 +1,22 @@
-# ScopeCairn
+<p align="center">
+  <img src="assets/icon.png" alt="ScopeCairn Icon" width="140" height="140" style="border-radius: 32px;" />
+</p>
+
+<h1 align="center">ScopeCairn</h1>
+
+<p align="center">
+  <strong>Local-first codebase intelligence &amp; task scope guard for AI coding agents.</strong><br>
+  <em>Understand before exploring. Retrieve before reading.</em>
+</p>
+
+<p align="center">
+  <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D20-22c55e.svg?style=flat-square" alt="Node.js version"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-6366f1.svg?style=flat-square" alt="License: MIT"></a>
+  <img src="https://img.shields.io/badge/local--first-100%25-00f0ff.svg?style=flat-square" alt="Local-First">
+  <img src="https://img.shields.io/badge/telemetry-zero-a855f7.svg?style=flat-square" alt="Zero Telemetry">
+</p>
+
+---
 
 Local-first codebase intelligence layer for AI coding agents.
 Understand the codebase, then give the agent only what it needs:
@@ -58,6 +76,16 @@ No MCP server, no embeddings, no network calls, no telemetry.
   click-for-details side panel (callers, callees, centrality scores).
   Nodes sized by symbols/PageRank, colored by Louvain community.
   Pan, zoom, hover inspect. Double-click to open, no server.
+- **Decision log** — `scopecairn decide "pakai X karena Y"` records an
+  architectural decision once; it is carried into every later
+  `context` call, so the agent stops re-litigating settled choices.
+- **Definition of Done check** — `verify --dod` rates each DoD item and
+  is honest about what it cannot know: `pass` only for what the machine
+  verified (scope, index freshness), `warn`/`fail` where it has evidence,
+  `manual` for judgement calls. Never a fabricated "done".
+- **Local usage report** — `status --usage` reads the local invocation
+  log: commands used, closed-loop rate (`scan` after a task), average
+  symbols per task. Local only, never leaves the machine.
 - **Graph export for external tools** — `scopecairn graph --export
   mermaid|graphml|dot|json` writes `.scopecairn/graph.<ext>` for PR
   diagrams (Mermaid), Gephi/Cytoscape (GraphML), Graphviz (DOT),
@@ -118,9 +146,10 @@ scopecairn scan                             # index repository (--rebuild, --cle
 scopecairn context "tambah fitur auth"      # AI agent task context + scope
 scopecairn impact src/indexer.ts            # blast radius & affected tests (--run-tests)
 scopecairn graph buildContext               # inspect relations, path (--to), export (--export)
-scopecairn verify                           # pre-commit safety guard (--diff, --arch)
-scopecairn status                           # index statistics & health checks (--doctor, --html)
+scopecairn verify --dod                     # pre-commit safety guard (--diff, --arch, --dod)
+scopecairn status --usage                   # index statistics & health checks (--doctor, --html)
 scopecairn read symbol indexFileSymbols     # symbol-level source excerpt
+scopecairn decide "graf di SQLite, tanpa embedding"   # catat keputusan arsitektur
 ```
 
 Per-agent installers (instead of `init --agents …`):
@@ -144,8 +173,8 @@ ScopeCairn organizes its capabilities into **6 core commands** aligned with code
 | `context "<task>"` | **AI Agent Context & Scope:** Main agent entry point with auto-refresh, task classification, relevant context, task scope, and Task Guard. Options: `--escalate`, `--mode NORMAL\|FAST\|SAFE\|AUDIT`, `--max-tokens N`, `--no-history`, `--with-diff`, `--json`. |
 | `impact <target>` | **Blast Radius & Test Selection:** Change impact analysis across direct, indirect, tests, UI components, and API clients. Options: `--run-tests` (run affected tests directly), `--tests` (list affected tests only), `--repos [list]` (cross-repo blast radius). |
 | `graph [symbol]` | **Knowledge Graph & Navigation:** Symbol relations, PageRank centrality, community clusters, and cycle status. Options: `--to <target>` (shortest multi-hop call path), `--export <fmt>` (`mermaid\|graphml\|dot\|json`). |
-| `verify` | **Pre-Commit Safety Guard:** Working tree check against protected files, task scope creep, and circular dependency regressions. Options: `--diff` (structural symbol-level diff vs HEAD), `--arch` (architectural layer rules), `--strict`, `--task <t>`. |
-| `status` | **Health & Diagnostics:** Index statistics and metadata. Options: `--doctor` (integration and adapter health check), `--verbose`, `--html` (generate local HTML dashboard). |
+| `verify` | **Pre-Commit Safety Guard:** Working tree check against protected files, task scope creep, and circular dependency regressions. Options: `--diff` (structural symbol-level diff vs HEAD), `--arch` (architectural layer rules), `--dod` (Definition of Done: verified / warned / manual, never a claimed pass), `--strict`, `--task <t>`. |
+| `status` | **Health & Diagnostics:** Index statistics and metadata. Options: `--doctor` (integration and adapter health check), `--usage` (local usage & compliance report), `--verbose`, `--html` (generate local HTML dashboard). |
 
 ### Helper & Setup Commands
 
@@ -153,6 +182,7 @@ ScopeCairn organizes its capabilities into **6 core commands** aligned with code
 | ------- | ----------- |
 | `init [path]` | Initial indexing + Skill, Workflow, detected agent skills (`--agents …\|all`). |
 | `read symbol <name>` | Symbol-level source excerpt (not whole files). |
+| `decide "…"` | Record an architectural decision into `.scopecairn/decisions.md` (no argument: list them). Read back by `context`. |
 | `benchmark [--tune]` | Retrieval recall, irrelevant ratio, context reduction + weight tuning (dev-only, hidden from `--help`). |
 | `<agent> install` | Agent installers: `antigravity`, `claude`, `cursor`, `windsurf`, `copilot`, `kiro`, `opencode`. |
 

package/assets/banner.svg

@@ -0,0 +1,137 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 960 260" width="100%" height="100%">
+  <defs>
+    <!-- Background Gradient -->
+    <linearGradient id="bannerBg" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#070A12" />
+      <stop offset="50%" stop-color="#0B101E" />
+      <stop offset="100%" stop-color="#05070D" />
+    </linearGradient>
+
+    <!-- Border Stroke -->
+    <linearGradient id="bannerBorder" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#00F0FF" stop-opacity="0.6" />
+      <stop offset="35%" stop-color="#6366F1" stop-opacity="0.3" />
+      <stop offset="70%" stop-color="#A855F7" stop-opacity="0.6" />
+      <stop offset="100%" stop-color="#00F0FF" stop-opacity="0.1" />
+    </linearGradient>
+
+    <!-- Text Title Gradient -->
+    <linearGradient id="titleGrad" x1="0%" y1="0%" x2="100%" y2="0%">
+      <stop offset="0%" stop-color="#38BDF8" />
+      <stop offset="45%" stop-color="#00F0FF" />
+      <stop offset="100%" stop-color="#C084FC" />
+    </linearGradient>
+
+    <!-- Glow Filter -->
+    <filter id="bannerGlow" x="-20%" y="-20%" width="140%" height="140%">
+      <feGaussianBlur stdDeviation="6" result="blur" />
+      <feMerge>
+        <feMergeNode in="blur" />
+        <feMergeNode in="SourceGraphic" />
+      </feMerge>
+    </filter>
+
+    <filter id="softGlow" x="-30%" y="-30%" width="160%" height="160%">
+      <feGaussianBlur stdDeviation="16" result="blur" />
+    </filter>
+  </defs>
+
+  <!-- Banner Outer Card -->
+  <rect x="2" y="2" width="956" height="256" rx="20" fill="url(#bannerBg)" stroke="url(#bannerBorder)" stroke-width="1.5" />
+
+  <!-- Background Decorative Grid Lines -->
+  <g stroke="#1E293B" stroke-width="0.7" opacity="0.35">
+    <line x1="0" y1="65" x2="960" y2="65" />
+    <line x1="0" y1="130" x2="960" y2="130" />
+    <line x1="0" y1="195" x2="960" y2="195" />
+    <line x1="240" y1="0" x2="240" y2="260" />
+    <line x1="480" y1="0" x2="480" y2="260" />
+    <line x1="720" y1="0" x2="720" y2="260" />
+  </g>
+
+  <!-- Ambient Glow Pods -->
+  <circle cx="140" cy="130" r="110" fill="#00F0FF" opacity="0.12" filter="url(#softGlow)" />
+  <circle cx="210" cy="90" r="80" fill="#8B5CF6" opacity="0.15" filter="url(#softGlow)" />
+
+  <!-- ==================== LEFT: EMBEDDED ICON ==================== -->
+  <g transform="translate(40, 20)">
+    <!-- Outer Scope Ring -->
+    <circle cx="110" cy="110" r="85" fill="none" stroke="#6366F1" stroke-width="1.2" stroke-dasharray="3 7" opacity="0.5" />
+    <circle cx="110" cy="110" r="68" fill="none" stroke="#00F0FF" stroke-width="1.8" opacity="0.8" filter="url(#bannerGlow)" />
+    <circle cx="110" cy="82" r="38" fill="none" stroke="#A855F7" stroke-width="2" opacity="0.85" filter="url(#bannerGlow)" />
+
+    <!-- Scope Crosshairs -->
+    <line x1="110" y1="18" x2="110" y2="52" stroke="#00F0FF" stroke-width="2" stroke-linecap="round" filter="url(#bannerGlow)" />
+    <line x1="110" y1="168" x2="110" y2="202" stroke="#00F0FF" stroke-width="2" stroke-linecap="round" filter="url(#bannerGlow)" />
+    <line x1="18" y1="110" x2="52" y2="110" stroke="#00F0FF" stroke-width="2" stroke-linecap="round" filter="url(#bannerGlow)" />
+    <line x1="168" y1="110" x2="202" y2="110" stroke="#00F0FF" stroke-width="2" stroke-linecap="round" filter="url(#bannerGlow)" />
+
+    <!-- Cairn Stones Stack -->
+    <!-- Base Stone -->
+    <polygon points="50,158 110,168 170,158 160,176 110,183 60,176" fill="#141E33" stroke="#334155" stroke-width="1" />
+    <polygon points="50,158 75,145 145,145 170,158 110,168" fill="#1E293B" stroke="#475569" stroke-width="1" />
+    <path d="M 60,176 L 110,183 L 160,176" fill="none" stroke="#00F0FF" stroke-width="1.8" opacity="0.7" filter="url(#bannerGlow)" />
+    
+    <!-- Middle Stone -->
+    <polygon points="72,118 92,107 128,107 148,118 110,127" fill="#334155" stroke="#475569" stroke-width="1" />
+    <polygon points="72,118 110,127 110,143 78,134" fill="#1E293B" stroke="#334155" stroke-width="1" />
+    <polygon points="110,127 148,118 142,134 110,143" fill="#0F172A" stroke="#334155" stroke-width="1" />
+    <path d="M 78,134 L 110,143 L 142,134" fill="none" stroke="#A855F7" stroke-width="1.8" opacity="0.9" filter="url(#bannerGlow)" />
+
+    <!-- Apex Stone -->
+    <polygon points="110,60 88,94 110,100" fill="#334155" stroke="#475569" stroke-width="1" />
+    <polygon points="110,60 110,100 132,94" fill="#1E293B" stroke="#334155" stroke-width="1" />
+    <line x1="110" y1="60" x2="110" y2="100" stroke="#00F0FF" stroke-width="1.8" filter="url(#bannerGlow)" />
+    <circle cx="110" cy="82" r="3.5" fill="#FFFFFF" filter="url(#bannerGlow)" />
+    <circle cx="110" cy="82" r="1.8" fill="#00F0FF" />
+
+    <!-- Constellation Graph Node Accents -->
+    <circle cx="158" cy="85" r="3" fill="#00F0FF" filter="url(#bannerGlow)" />
+    <circle cx="62" cy="100" r="2.5" fill="#A855F7" />
+  </g>
+
+  <!-- ==================== RIGHT: BRAND IDENTITY ==================== -->
+  <g transform="translate(290, 48)">
+    <!-- Small Category Label -->
+    <text x="0" y="24" fill="#38BDF8" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', sans-serif" font-size="12" font-weight="700" letter-spacing="3.5" opacity="0.9">LOCAL-FIRST AGENT INTELLIGENCE</text>
+
+    <!-- Main Title -->
+    <text x="0" y="74" fill="url(#titleGrad)" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', sans-serif" font-size="44" font-weight="800" letter-spacing="-0.5">ScopeCairn</text>
+
+    <!-- Subtitle / Mission -->
+    <text x="0" y="108" fill="#94A3B8" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', sans-serif" font-size="15" font-weight="400" letter-spacing="0.2">
+      Understand before exploring. Precise task scope &amp; codebase knowledge graph for AI coding agents.
+    </text>
+
+    <!-- Feature Badges / Pills -->
+    <g transform="translate(0, 134)">
+      <!-- Badge 1: Knowledge Graph -->
+      <g transform="translate(0, 0)">
+        <rect x="0" y="0" width="144" height="26" rx="13" fill="#0E1726" stroke="#00F0FF" stroke-opacity="0.4" stroke-width="1" />
+        <circle cx="13" cy="13" r="3.5" fill="#00F0FF" />
+        <text x="24" y="17" fill="#E2E8F0" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="11" font-weight="600">Knowledge Graph</text>
+      </g>
+
+      <!-- Badge 2: Scope Guard -->
+      <g transform="translate(154, 0)">
+        <rect x="0" y="0" width="138" height="26" rx="13" fill="#141126" stroke="#A855F7" stroke-opacity="0.4" stroke-width="1" />
+        <circle cx="13" cy="13" r="3.5" fill="#A855F7" />
+        <text x="24" y="17" fill="#E2E8F0" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="11" font-weight="600">Task Scope Guard</text>
+      </g>
+
+      <!-- Badge 3: Impact Analysis -->
+      <g transform="translate(302, 0)">
+        <rect x="0" y="0" width="134" height="26" rx="13" fill="#0C1B2A" stroke="#38BDF8" stroke-opacity="0.4" stroke-width="1" />
+        <circle cx="13" cy="13" r="3.5" fill="#38BDF8" />
+        <text x="24" y="17" fill="#E2E8F0" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="11" font-weight="600">Impact Analysis</text>
+      </g>
+
+      <!-- Badge 4: Zero Telemetry -->
+      <g transform="translate(446, 0)">
+        <rect x="0" y="0" width="134" height="26" rx="13" fill="#0B171B" stroke="#10B981" stroke-opacity="0.4" stroke-width="1" />
+        <circle cx="13" cy="13" r="3.5" fill="#10B981" />
+        <text x="24" y="17" fill="#E2E8F0" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif" font-size="11" font-weight="600">Zero Telemetry</text>
+      </g>
+    </g>
+  </g>
+</svg>

package/assets/icon.svg

@@ -0,0 +1,210 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512" width="100%" height="100%">
+  <defs>
+    <!-- Background Gradient -->
+    <radialGradient id="bgGlow" cx="50%" cy="45%" r="65%">
+      <stop offset="0%" stop-color="#141E33" />
+      <stop offset="60%" stop-color="#0B0F19" />
+      <stop offset="100%" stop-color="#05070D" />
+    </radialGradient>
+
+    <!-- Border Gradient -->
+    <linearGradient id="borderGrad" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#00F0FF" stop-opacity="0.8" />
+      <stop offset="50%" stop-color="#6366F1" stop-opacity="0.4" />
+      <stop offset="100%" stop-color="#A855F7" stop-opacity="0.8" />
+    </linearGradient>
+
+    <!-- Scope Laser Gradient -->
+    <linearGradient id="cyanLaser" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#38BDF8" />
+      <stop offset="50%" stop-color="#00F0FF" />
+      <stop offset="100%" stop-color="#0284C7" />
+    </linearGradient>
+
+    <linearGradient id="purpleLaser" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#C084FC" />
+      <stop offset="100%" stop-color="#7C3AED" />
+    </linearGradient>
+
+    <!-- Stone Obsidian Shading -->
+    <!-- Top Apex Stone -->
+    <linearGradient id="apexLeft" x1="30%" y1="0%" x2="70%" y2="100%">
+      <stop offset="0%" stop-color="#334155" />
+      <stop offset="100%" stop-color="#0F172A" />
+    </linearGradient>
+    <linearGradient id="apexRight" x1="70%" y1="0%" x2="30%" y2="100%">
+      <stop offset="0%" stop-color="#1E293B" />
+      <stop offset="100%" stop-color="#090D16" />
+    </linearGradient>
+    <linearGradient id="apexBottom" x1="50%" y1="0%" x2="50%" y2="100%">
+      <stop offset="0%" stop-color="#475569" />
+      <stop offset="100%" stop-color="#1E293B" />
+    </linearGradient>
+
+    <!-- Middle Stone -->
+    <linearGradient id="midTop" x1="20%" y1="0%" x2="80%" y2="100%">
+      <stop offset="0%" stop-color="#334155" />
+      <stop offset="100%" stop-color="#1E293B" />
+    </linearGradient>
+    <linearGradient id="midFront" x1="50%" y1="0%" x2="50%" y2="100%">
+      <stop offset="0%" stop-color="#1E293B" />
+      <stop offset="100%" stop-color="#0A0E17" />
+    </linearGradient>
+    <linearGradient id="midLeft" x1="0%" y1="50%" x2="100%" y2="50%">
+      <stop offset="0%" stop-color="#2D3748" />
+      <stop offset="100%" stop-color="#141A24" />
+    </linearGradient>
+
+    <!-- Base Stone -->
+    <linearGradient id="baseTop" x1="0%" y1="0%" x2="100%" y2="100%">
+      <stop offset="0%" stop-color="#334155" />
+      <stop offset="100%" stop-color="#1E293B" />
+    </linearGradient>
+    <linearGradient id="baseFront" x1="50%" y1="0%" x2="50%" y2="100%">
+      <stop offset="0%" stop-color="#1A2234" />
+      <stop offset="100%" stop-color="#080C14" />
+    </linearGradient>
+
+    <!-- Filters for Glow Effect -->
+    <filter id="laserGlow" x="-30%" y="-30%" width="160%" height="160%">
+      <feGaussianBlur stdDeviation="5" result="blur" />
+      <feMerge>
+        <feMergeNode in="blur" />
+        <feMergeNode in="blur" />
+        <feMergeNode in="SourceGraphic" />
+      </feMerge>
+    </filter>
+
+    <filter id="intenseGlow" x="-50%" y="-50%" width="200%" height="200%">
+      <feGaussianBlur stdDeviation="9" result="blur" />
+      <feMerge>
+        <feMergeNode in="blur" />
+        <feMergeNode in="SourceGraphic" />
+      </feMerge>
+    </filter>
+  </defs>
+
+  <!-- Container App Squircle (macOS / Modern Icon Standard) -->
+  <rect x="16" y="16" width="480" height="480" rx="108" fill="url(#bgGlow)" stroke="url(#borderGrad)" stroke-width="2.5" />
+
+  <!-- Ambient Internal Backdrop Glow -->
+  <circle cx="256" cy="240" r="140" fill="#00F0FF" opacity="0.07" filter="url(#intenseGlow)" />
+  <circle cx="256" cy="180" r="80" fill="#8B5CF6" opacity="0.12" filter="url(#intenseGlow)" />
+
+  <!-- Target Scope Reticle Elements -->
+  <!-- Outer Dotted Calibration Ring -->
+  <circle cx="256" cy="256" r="190" fill="none" stroke="#6366F1" stroke-width="1.5" stroke-dasharray="3 9" opacity="0.45" />
+
+  <!-- Scope HUD Corner Brackets -->
+  <g stroke="#00F0FF" stroke-width="2" fill="none" opacity="0.4">
+    <!-- Top-Left Bracket -->
+    <path d="M 80 120 L 80 80 L 120 80" />
+    <!-- Top-Right Bracket -->
+    <path d="M 392 80 L 432 80 L 432 120" />
+    <!-- Bottom-Left Bracket -->
+    <path d="M 80 392 L 80 432 L 120 432" />
+    <!-- Bottom-Right Bracket -->
+    <path d="M 432 392 L 432 432 L 392 432" />
+  </g>
+
+  <!-- Concentric Targeting Rings (Mid + Upper Focus) -->
+  <circle cx="256" cy="256" r="150" fill="none" stroke="#00F0FF" stroke-width="2" opacity="0.75" filter="url(#laserGlow)" />
+  <circle cx="256" cy="190" r="85" fill="none" stroke="#A855F7" stroke-width="2.5" opacity="0.8" filter="url(#laserGlow)" />
+  <circle cx="256" cy="190" r="48" fill="none" stroke="#00F0FF" stroke-width="1.8" opacity="0.9" />
+
+  <!-- Scope Reticle Crosshairs (Crosslines with precise gaps) -->
+  <!-- Main Vertical Scope Line -->
+  <line x1="256" y1="75" x2="256" y2="135" stroke="#00F0FF" stroke-width="2.5" stroke-linecap="round" filter="url(#laserGlow)" />
+  <line x1="256" y1="365" x2="256" y2="435" stroke="#00F0FF" stroke-width="2.5" stroke-linecap="round" filter="url(#laserGlow)" />
+  <line x1="256" y1="140" x2="256" y2="350" stroke="#00F0FF" stroke-width="1.2" stroke-dasharray="4 6" opacity="0.5" />
+
+  <!-- Main Horizontal Scope Line -->
+  <line x1="75" y1="256" x2="135" y2="256" stroke="#00F0FF" stroke-width="2.5" stroke-linecap="round" filter="url(#laserGlow)" />
+  <line x1="377" y1="256" x2="437" y2="256" stroke="#00F0FF" stroke-width="2.5" stroke-linecap="round" filter="url(#laserGlow)" />
+
+  <!-- Precision Sub-scope Crosshair at Apex Focal Center (256, 190) -->
+  <line x1="180" y1="190" x2="215" y2="190" stroke="#38BDF8" stroke-width="2" stroke-linecap="round" />
+  <line x1="297" y1="190" x2="332" y2="190" stroke="#38BDF8" stroke-width="2" stroke-linecap="round" />
+
+  <!-- ==================== THE CAIRN STONES ==================== -->
+
+  <!-- BASE STONE (Foundation / Repository Grounding) -->
+  <g id="base-stone">
+    <!-- Base Shadow / Glow Rim -->
+    <ellipse cx="256" cy="385" rx="145" ry="32" fill="#00F0FF" opacity="0.1" filter="url(#laserGlow)" />
+    
+    <!-- Facets of Base Stone -->
+    <!-- Front Face -->
+    <polygon points="120,365 256,388 392,365 372,405 256,418 140,405" fill="url(#baseFront)" stroke="#1E293B" stroke-width="1" />
+    <!-- Top Face -->
+    <polygon points="120,365 170,335 342,335 392,365 256,388" fill="url(#baseTop)" stroke="#334155" stroke-width="1" />
+    <!-- Bottom Bevel Rim Highlight -->
+    <path d="M 140,405 L 256,418 L 372,405" fill="none" stroke="#00F0FF" stroke-width="2" opacity="0.65" filter="url(#laserGlow)" />
+    
+    <!-- Codebase Knowledge Graph Circuit Trace on Base Stone -->
+    <path d="M 165,372 L 210,378 L 245,368 L 295,380 L 340,368" fill="none" stroke="#00F0FF" stroke-width="1.8" opacity="0.75" />
+    <circle cx="210" cy="378" r="3.5" fill="#00F0FF" filter="url(#laserGlow)" />
+    <circle cx="245" cy="368" r="3" fill="#A855F7" />
+    <circle cx="295" cy="380" r="3.5" fill="#00F0FF" filter="url(#laserGlow)" />
+  </g>
+
+  <!-- MIDDLE STONE (Task Context & Module Balance) -->
+  <g id="middle-stone">
+    <!-- Floating Shadow between base and middle -->
+    <ellipse cx="256" cy="318" rx="100" ry="16" fill="#000000" opacity="0.6" />
+
+    <!-- Facets of Middle Stone -->
+    <!-- Top Facet -->
+    <polygon points="170,270 215,245 297,245 342,270 256,290" fill="url(#midTop)" stroke="#475569" stroke-width="1" />
+    <!-- Left Facet -->
+    <polygon points="170,270 256,290 256,325 185,305" fill="url(#midLeft)" stroke="#1E293B" stroke-width="1" />
+    <!-- Right Facet -->
+    <polygon points="256,290 342,270 327,305 256,325" fill="url(#midFront)" stroke="#1E293B" stroke-width="1" />
+
+    <!-- Edge Neon Accent Highlight -->
+    <path d="M 170,270 L 256,290 L 342,270" fill="none" stroke="#818CF8" stroke-width="2" opacity="0.8" />
+    <path d="M 185,305 L 256,325 L 327,305" fill="none" stroke="#A855F7" stroke-width="2.2" opacity="0.85" filter="url(#laserGlow)" />
+
+    <!-- Graph Relation Line (Edge) -->
+    <path d="M 205,282 L 235,275 L 275,295 L 305,280" fill="none" stroke="#38BDF8" stroke-width="1.5" opacity="0.8" />
+    <circle cx="235" cy="275" r="3" fill="#38BDF8" filter="url(#laserGlow)" />
+    <circle cx="275" cy="295" r="3.5" fill="#C084FC" filter="url(#laserGlow)" />
+  </g>
+
+  <!-- APEX STONE (The Summit / Target Scope Focal Beacon) -->
+  <g id="apex-stone">
+    <!-- Hover Shadow -->
+    <ellipse cx="256" cy="235" rx="50" ry="10" fill="#000000" opacity="0.7" />
+
+    <!-- Facets of Apex Jewel / Pyramid Stone -->
+    <!-- Left Facet -->
+    <polygon points="256,140 205,215 256,228" fill="url(#apexLeft)" stroke="#475569" stroke-width="1" />
+    <!-- Right Facet -->
+    <polygon points="256,140 256,228 307,215" fill="url(#apexRight)" stroke="#334155" stroke-width="1" />
+    <!-- Top Ridge Line -->
+    <line x1="256" y1="140" x2="256" y2="228" stroke="#00F0FF" stroke-width="2" opacity="0.9" filter="url(#laserGlow)" />
+
+    <!-- Rim Accents -->
+    <path d="M 205,215 L 256,228 L 307,215" fill="none" stroke="#00F0FF" stroke-width="2.5" opacity="0.9" filter="url(#laserGlow)" />
+
+    <!-- Focal Center Reticle Core -->
+    <circle cx="256" cy="190" r="5" fill="#FFFFFF" filter="url(#intenseGlow)" />
+    <circle cx="256" cy="190" r="2.5" fill="#00F0FF" />
+  </g>
+
+  <!-- Constellation / Knowledge Graph Nodes floating around -->
+  <g id="graph-nodes">
+    <circle cx="370" cy="195" r="4" fill="#00F0FF" opacity="0.85" filter="url(#laserGlow)" />
+    <line x1="340" y1="210" x2="370" y2="195" stroke="#00F0FF" stroke-width="1" stroke-dasharray="2 3" opacity="0.5" />
+
+    <circle cx="140" cy="225" r="3.5" fill="#A855F7" opacity="0.85" filter="url(#laserGlow)" />
+    <line x1="170" y1="240" x2="140" y2="225" stroke="#A855F7" stroke-width="1" stroke-dasharray="2 3" opacity="0.5" />
+
+    <circle cx="345" cy="330" r="3.5" fill="#38BDF8" opacity="0.8" filter="url(#laserGlow)" />
+    <circle cx="165" cy="325" r="4" fill="#00F0FF" opacity="0.8" filter="url(#laserGlow)" />
+  </g>
+
+  <!-- Calibrated Boundary Angle Marks (Degree coordinates) -->
+  <text x="256" y="60" text-anchor="middle" fill="#00F0FF" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, monospace" font-size="11" font-weight="700" letter-spacing="3" opacity="0.75">SCOPE·CAIRN</text>
+  <text x="256" y="465" text-anchor="middle" fill="#818CF8" font-family="-apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, monospace" font-size="9" font-weight="600" letter-spacing="4" opacity="0.6">CODEBASE INTELLIGENCE</text>
+</svg>

package/dist/{chunk-G5RA43OH.js → chunk-4VHUOZ7J.js}

@@ -17,7 +17,7 @@ function loadDatabaseSync() {
 }
 var DATA_DIR_NAME = ".scopecairn";
 var DB_FILE_NAME = "scopecairn.db";
-var SCHEMA_VERSION = 7;
+var SCHEMA_VERSION = 8;
 function dataDir(repoRoot) {
   return path.join(repoRoot, DATA_DIR_NAME);
 }
@@ -85,6 +85,17 @@ function openDb(repoRoot) {
       reason TEXT NOT NULL DEFAULT ''
     );
     CREATE INDEX IF NOT EXISTS idx_task_context_task ON task_context(task_id);
+    -- Scope yang DIRENDER ke agent (Required/Optional/Protected), disimpan
+    -- per task. Tanpa ini verify --task harus menghitung ulang scope dari
+    -- task string, dan hasilnya bisa berbeda dari yang benar-benar dilihat
+    -- agent (co-change history, --escalate, task SIMPLE) \u2192 false positive.
+    CREATE TABLE IF NOT EXISTS task_scope (
+      task_id INTEGER NOT NULL REFERENCES tasks(id) ON DELETE CASCADE,
+      path TEXT NOT NULL,
+      tier TEXT NOT NULL,
+      PRIMARY KEY (task_id, path)
+    );
+    CREATE INDEX IF NOT EXISTS idx_task_scope_task ON task_scope(task_id);
     -- Fase 5: invocation log untuk compliance rate (AI-5, \xA718).
     CREATE TABLE IF NOT EXISTS invocations (
       id INTEGER PRIMARY KEY AUTOINCREMENT,
@@ -138,6 +149,15 @@ function openDb(repoRoot) {
     );
     CREATE INDEX IF NOT EXISTS idx_commit_files_sha ON commit_files(sha);
     CREATE INDEX IF NOT EXISTS idx_commit_files_path ON commit_files(path);
+    -- Cache fan-in (jumlah relasi masuk per simbol). Dipakai ranking
+    -- retrieval: tanpa cache, retrieve() menghitung ulang
+    -- GROUP BY target_id di seluruh tabel relationships pada SETIAP
+    -- pemanggilan \u2014 O(E) penuh, dan itu bottleneck utama di repo besar.
+    -- Dipopulate ulang di akhir scanRepository (satu lintasan GROUP BY).
+    CREATE TABLE IF NOT EXISTS fanin (
+      node_id INTEGER PRIMARY KEY,
+      n INTEGER NOT NULL
+    );
     CREATE VIRTUAL TABLE IF NOT EXISTS commit_fts USING fts5(
       sha UNINDEXED, subject, body, paths
     );
@@ -157,10 +177,17 @@ function openDb(repoRoot) {
     `UPDATE relationships SET evidence = 'INFERRED'
      WHERE relationship_type IN ('QUERIES','ROUTES_TO','TESTS') AND evidence = 'EXTRACTED'`
   );
-  db.exec(
-    `UPDATE relationships SET evidence = 'AMBIGUOUS'
-     WHERE relationship_type = 'CALLS' AND confidence < 1.0 AND evidence = 'EXTRACTED'`
-  );
+  const CALLS_BACKFILL_KEY = "migration_calls_evidence_v1";
+  const callsBackfilled = db.prepare(`SELECT value FROM meta WHERE key = ?`).get(CALLS_BACKFILL_KEY);
+  if (!callsBackfilled) {
+    db.exec(
+      `UPDATE relationships SET evidence = 'AMBIGUOUS'
+       WHERE relationship_type = 'CALLS' AND confidence < 1.0 AND evidence = 'EXTRACTED'`
+    );
+    db.prepare(`INSERT INTO meta(key, value) VALUES (?, '1') ON CONFLICT(key) DO NOTHING`).run(
+      CALLS_BACKFILL_KEY
+    );
+  }
   return db;
 }
 function hashContent(buf) {
@@ -295,54 +322,17 @@ function ensureProtectedFile(repoRoot) {
   }
 }
 
-// src/scope/scope.ts
-function computeScope(highFiles, mediumFiles, testFiles, patterns, historyOptional) {
-  const required = [];
-  const optional = [];
-  const protectedFiles = [];
-  const seen = /* @__PURE__ */ new Set();
-  const place = (f) => {
-    if (seen.has(f)) return;
-    seen.add(f);
-    if (isProtected(f, patterns)) protectedFiles.push(f);
-    else if (highFiles.includes(f)) required.push(f);
-    else optional.push(f);
-  };
-  for (const f of highFiles) place(f);
-  for (const f of mediumFiles) place(f);
-  for (const t of testFiles) {
-    if (seen.has(t)) continue;
-    seen.add(t);
-    if (isProtected(t, patterns)) protectedFiles.push(t);
-    else optional.push(t);
-  }
-  for (const h of historyOptional ?? []) {
-    if (seen.has(h)) continue;
-    seen.add(h);
-    if (isProtected(h, patterns)) protectedFiles.push(h);
-    else optional.push(h);
-  }
-  return { required, optional, protected: protectedFiles };
-}
-function scopeBlock(scope) {
-  const fmt = (xs) => xs.length > 0 ? xs.join(", ") : "-";
-  return `## Scope
-Required: ${fmt(scope.required)}
-Optional: ${fmt(scope.optional)}
-Protected: ${fmt(scope.protected)}
-`;
-}
-
 export {
   dataDir,
   dbPath,
   openDb,
   hashContent,
+  DEFAULT_PROTECTED_PATTERNS,
   matchPattern,
   loadProtectedPatterns,
   isProtected,
+  SECRET_PATTERNS,
+  isSecretFile,
   isIndexableMetaFile,
-  ensureProtectedFile,
-  computeScope,
-  scopeBlock
+  ensureProtectedFile
 };

package/dist/{chunk-2BIPX6YJ.js → chunk-GQFBQRDD.js}

@@ -2,71 +2,10 @@
 import {
   logError
 } from "./chunk-OPA4TMAT.js";
-
-// src/retrieval/tokenize.ts
-var STOP = /* @__PURE__ */ new Set([
-  "the",
-  "a",
-  "an",
-  "of",
-  "to",
-  "in",
-  "for",
-  "on",
-  "with",
-  "and",
-  "or",
-  "src",
-  "lib",
-  "app",
-  "test",
-  "tests",
-  "spec"
-]);
-function stemVariants(t) {
-  const out = /* @__PURE__ */ new Set([t]);
-  if (t.endsWith("ies") && t.length > 4) out.add(t.slice(0, -3) + "y");
-  else if (t.endsWith("es") && t.length > 4 && /(s|x|z|ch|sh)es$/.test(t)) out.add(t.slice(0, -2));
-  else if (t.endsWith("s") && t.length > 3 && !t.endsWith("ss")) out.add(t.slice(0, -1));
-  if (t.endsWith("ing") && t.length > 5) {
-    const base = t.slice(0, -3);
-    out.add(base);
-    out.add(base + "e");
-  }
-  if (t.endsWith("ation") && t.length > 7) {
-    const base = t.slice(0, -5);
-    out.add(base);
-  }
-  return [...out];
-}
-var EXPLICIT_STEM = /* @__PURE__ */ new Map([
-  ["configuration", "config"],
-  ["configurations", "config"],
-  ["configured", "config"],
-  ["ranking", "rank"],
-  ["ranked", "rank"],
-  ["weights", "weight"],
-  ["dependencies", "dependency"],
-  ["dependency", "depend"],
-  ["extraction", "extract"],
-  ["extracted", "extract"]
-]);
-function tokenizeIdentifier(raw) {
-  const parts = raw.replace(/[\\/]/g, " ").replace(/[.:\-_"']/g, " ").replace(/([a-z0-9])([A-Z])/g, "$1 $2").replace(/([A-Z]+)([A-Z][a-z])/g, "$1 $2").toLowerCase().split(/[^a-z0-9]+/g).filter((t) => t.length >= 2 && !STOP.has(t));
-  const out = /* @__PURE__ */ new Set();
-  for (const t of parts) {
-    out.add(t);
-    for (const v of stemVariants(t)) {
-      if (v.length >= 2 && !STOP.has(v)) out.add(v);
-    }
-    const e = EXPLICIT_STEM.get(t);
-    if (e && !STOP.has(e)) out.add(e);
-  }
-  return [...out];
-}
-function tokenizeTask(text) {
-  return tokenizeIdentifier(text);
-}
+import {
+  tokenizeIdentifier,
+  tokenizeTask
+} from "./chunk-UVKHDHBU.js";
 
 // src/retrieval/history/index.ts
 function stripConventionalPrefix(subject) {
@@ -309,8 +248,6 @@ function leaveOneOut(db, shas, opts = {}) {
 }
 
 export {
-  tokenizeIdentifier,
-  tokenizeTask,
   syncCommitFts,
   HISTORY_HALF_LIFE_DAYS,
   HISTORY_MIN_SCORE,