scopecairn 0.3.0 → 0.4.0

package/README.md

@@ -28,8 +28,10 @@ No MCP server, no embeddings, no network calls, no telemetry.
   Prisma models, and Drizzle tables/queries detected automatically.
 - **Multi-language** — TypeScript, JavaScript, Python, Java, Go, Rust,
   PHP, C#, C/C++, Ruby, HTML (plus config/schema files as graph nodes).
-- **Multi-agent setup** — one `init` writes rules for AGENTS.md,
-  Claude Code, Gemini, Cursor, Windsurf, Copilot, Kiro, or all at once.
+- **Multi-agent setup** — skills for Claude Code (plugin + marketplace
+  ready), Antigravity, Cursor, Windsurf, Copilot, Kiro, and an OpenCode
+  slash command. ScopeCairn never touches your `AGENTS.md`/`CLAUDE.md` —
+  those hold your repo's details, not tool instructions.
 
 ## Install
 
@@ -63,7 +65,20 @@ it runs project setup itself.
 
 ```bash
 cd your-repo
-scopecairn init      # index + generate AGENTS.md, Skill, Workflow
+scopecairn init      # index + Antigravity Skill + Workflow
+```
+
+Claude Code (project skill, committed with the repo):
+
+```bash
+scopecairn claude install
+```
+
+Or as a plugin from the bundled marketplace (this repo):
+
+```
+/plugin marketplace add <github-user>/scopecairn
+/plugin install scopecairn@scopecairn
 ```
 
 After setup, your agent calls ScopeCairn automatically on every coding task.
@@ -82,7 +97,8 @@ Per-agent installers (instead of `init --agents …`):
 
 ```bash
 scopecairn antigravity install   # Skill + Workflow + allowlist guide
-scopecairn claude install        # CLAUDE.md (also: gemini, cursor, windsurf, copilot, kiro)
+scopecairn claude install        # project skill .claude/skills (also: cursor, windsurf, copilot, kiro)
+scopecairn opencode install      # /scopecairn slash command + permission snippet
 scopecairn claude uninstall      # clean removal, user content preserved
 scopecairn agents list
 ```
@@ -91,7 +107,7 @@ scopecairn agents list
 
 | Command | Description |
 |---|---|
-| `init [path]` | Initial indexing + `AGENTS.md`, Skill, Workflow, agent matrix (`--agents …\|all`) |
+| `init [path]` | Initial indexing + Skill, Workflow, detected agent skills (`--agents …\|all`; never writes `AGENTS.md`) |
 | `scan` / `rebuild` | Manual index management (`scan` inkremental; `rebuild` dari nol) |
 | `status` / `doctor` | Index status (incl. adapters, invocations) and health checks |
 | `context "<task>"` | Main entry point: context + scope (`--escalate`, `--no-refresh`); a path task returns an orientation map |

package/dist/cli.js

@@ -2021,9 +2021,28 @@ Jalankan \`${prefix} scan\` agar indeks ScopeCairn mencerminkan perubahanmu.
 Lewati ScopeCairn hanya untuk pertanyaan non-coding.
 `;
 }
-function agentsMd(prefix) {
-  return `${MARKER}
-${ruleBody(prefix)}`;
+function claudeSkillMd(prefix) {
+  return `---
+name: scopecairn
+description: ScopeCairn codebase context + scope. Use for ALL coding tasks
+  (feature, bugfix, refactor, code questions) before exploring the repo,
+  and when the user says "scopecairn", asks for a repo overview, or asks
+  to set up ScopeCairn.
+allowed-tools: Bash
+---
+
+# ScopeCairn
+
+1. Jika \`.scopecairn/scopecairn.db\` belum ada: jalankan \`${prefix} init\`
+   (bila CLI belum ada: \`npm install -g scopecairn\`), laporkan file/simbol/relasi, berhenti.
+2. Jika sudah ada: jalankan \`${prefix} context "<task user>"\`.
+   Mulai dari Relevant Files. Jangan menjelajah dari nol.
+3. Ubah hanya Required/Optional; Protected perlu persetujuan user.
+   Simbol bersama \u2192 \`${prefix} impact <path>\`.
+   Butuh isi fungsi \u2192 \`${prefix} read symbol <nama>\`, bukan baca file penuh.
+4. Task membesar (>2 file)? Panggil ulang \`${prefix} context --escalate\`.
+5. Setelah mengedit: \`${prefix} scan\`. Berhenti saat acceptance criteria terpenuhi.
+`;
 }
 function genericRuleMd(prefix) {
   return `${MARKER}
@@ -2064,6 +2083,37 @@ Shortcut manual bila agent lupa memanggil ScopeCairn otomatis.
 4. Perlu source simbol? \`${prefix} read symbol <nama>\`.
 `;
 }
+function opencodeCommandMd(prefix) {
+  return `---
+description: ScopeCairn codebase context + scope for a task
+---
+
+Run \`${prefix} context "$ARGUMENTS"\` with the bash tool, then:
+
+1. Use Relevant Files as the starting point \u2014 do not explore from zero.
+2. Change only Required and Optional files; Protected needs user approval.
+3. If shared symbols change, run \`${prefix} impact <path>\`.
+4. Need a function body? Use \`${prefix} read symbol <nama>\`, not full reads.
+5. After editing, run \`${prefix} scan\` so the ScopeCairn index stays fresh.
+<!-- scopecairn:managed -->
+`;
+}
+function opencodePermissionGuide(prefix) {
+  const cmds = ["context", "impact", "read", "graph", "status", "doctor"];
+  const rules = cmds.map((c) => `      "${prefix} ${c} *": "allow"`).join(",\n");
+  return `Agar command di atas jalan tanpa persetujuan, gabungkan ke opencode.json
+(project root atau ~/.config/opencode/opencode.json):
+
+{
+  "permission": {
+    "bash": {
+${rules}
+    }
+  }
+}
+
+Catatan: ScopeCairn tidak mengubah opencode.json Anda secara otomatis.`;
+}
 var ALLOWLIST_COMMANDS = [
   "context",
   "impact",
@@ -2085,29 +2135,13 @@ Catatan: ScopeCairn tidak mengubah pengaturan IDE Anda secara otomatis.`;
 
 // src/integrate/matrix.ts
 var AGENT_MATRIX = [
-  {
-    id: "agents",
-    label: "AGENTS.md (universal: Codex, Aider, Opencode, Amp, Jules, ...)",
-    rel: "AGENTS.md",
-    mode: "merge",
-    render: agentsMd,
-    presentMarker: "AGENTS.md"
-  },
   {
     id: "claude",
     label: "Claude Code",
-    rel: "CLAUDE.md",
-    mode: "merge",
-    render: genericRuleMd,
-    presentMarker: "CLAUDE.md"
-  },
-  {
-    id: "gemini",
-    label: "Gemini / Antigravity CLI",
-    rel: "GEMINI.md",
-    mode: "merge",
-    render: genericRuleMd,
-    presentMarker: "GEMINI.md"
+    rel: ".claude/skills/scopecairn/SKILL.md",
+    mode: "new",
+    render: claudeSkillMd,
+    presentMarker: ".claude"
   },
   {
     id: "cursor",
@@ -2140,6 +2174,14 @@ var AGENT_MATRIX = [
     mode: "new",
     render: genericRuleMd,
     presentMarker: ".kiro"
+  },
+  {
+    id: "opencode",
+    label: "OpenCode",
+    rel: ".opencode/commands/scopecairn.md",
+    mode: "new",
+    render: opencodeCommandMd,
+    presentMarker: ".opencode"
   }
 ];
 function findTarget(id) {
@@ -2194,7 +2236,7 @@ async function cmdDoctor(repoRoot2) {
     const abs = path11.join(repoRoot2, t.rel);
     if (!fs11.existsSync(abs)) continue;
     const text = fs11.readFileSync(abs, "utf8");
-    if (!text.includes(MARKER)) continue;
+    if (t.mode === "merge" && !text.includes(MARKER)) continue;
     matrixOk++;
     const used = extractPrefixUsed(text);
     if (used && used !== expectedPrefix) {
@@ -2216,7 +2258,7 @@ async function cmdDoctor(repoRoot2) {
   const wfPath = path11.join(repoRoot2, "workflows", "scopecairn.md");
   console.log(`${tick(fs11.existsSync(wfPath))} Workflow (workflows/scopecairn.md, opsional)`);
   console.log(`i Strict Mode mengabaikan allowlist \u2014 semua perintah tetap perlu persetujuan.`);
-  const healthy = nodeOk && sqliteOk && ts.ok && dbOk && matrixOk > 0 && skillOk && prefixOk;
+  const healthy = nodeOk && sqliteOk && ts.ok && dbOk && (matrixOk > 0 || skillOk) && prefixOk;
   console.log(`Status: ${healthy ? "HEALTHY" : "DEGRADED (see \u2717 above)"}`);
 }
 
@@ -2464,29 +2506,36 @@ function retrieve(db, repoRoot2, task, opts) {
     proximity.set(s.symbolId, Math.max(proximity.get(s.symbolId) ?? 0, s.bm25));
     visited.add(s.symbolId);
   });
-  const edgeStmt = db.prepare(
-    `SELECT source_id, target_id, weight FROM relationships`
-  );
-  const adj = /* @__PURE__ */ new Map();
-  for (const r of edgeStmt.all()) {
-    if (!adj.has(r.source_id)) adj.set(r.source_id, []);
-    adj.get(r.source_id).push({ to: r.target_id, w: r.weight });
-    if (!adj.has(r.target_id)) adj.set(r.target_id, []);
-    adj.get(r.target_id).push({ to: r.source_id, w: r.weight * 0.8 });
+  const CHUNK = 2e3;
+  function neighborsOf(ids) {
+    const out = [];
+    for (let i = 0; i < ids.length; i += CHUNK) {
+      const c = ids.slice(i, i + CHUNK);
+      const ph = c.map(() => "?").join(",");
+      for (const r of db.prepare(
+        `SELECT source_id AS f, target_id AS t, weight AS w FROM relationships WHERE source_id IN (${ph})`
+      ).all(...c)) {
+        out.push({ from: r.f, to: r.t, w: r.w });
+      }
+      for (const r of db.prepare(
+        `SELECT target_id AS f, source_id AS t, weight * 0.8 AS w FROM relationships WHERE target_id IN (${ph})`
+      ).all(...c)) {
+        out.push({ from: r.f, to: r.t, w: r.w });
+      }
+    }
+    return out;
   }
   let hopScore = 1;
   for (let depth = 1; depth <= config.maxDepth; depth++) {
     hopScore *= config.decayPerHop;
     const next = [];
-    for (const id of frontier) {
-      const base = proximity.get(id) ?? 0;
-      for (const e of adj.get(id) ?? []) {
-        const cand = base * e.w * hopScore;
-        if (cand > (proximity.get(e.to) ?? 0)) proximity.set(e.to, cand);
-        if (!visited.has(e.to)) {
-          visited.add(e.to);
-          next.push(e.to);
-        }
+    for (const e of neighborsOf(frontier)) {
+      const base = proximity.get(e.from) ?? 0;
+      const cand = base * e.w * hopScore;
+      if (cand > (proximity.get(e.to) ?? 0)) proximity.set(e.to, cand);
+      if (!visited.has(e.to)) {
+        visited.add(e.to);
+        next.push(e.to);
       }
     }
     frontier = next;
@@ -3256,14 +3305,13 @@ function withCore(ids) {
       console.log(`! Unknown agent "${id}" (pilihan: ${AGENT_MATRIX.map((x) => x.id).join(", ")}, all)`);
       continue;
     }
-    out.push(t);
+    if (!out.includes(t)) out.push(t);
   }
-  if (!out.includes(AGENT_MATRIX[0])) out.unshift(AGENT_MATRIX[0]);
   return out;
 }
 function withDetected(repoRoot2) {
-  const targets = [AGENT_MATRIX[0]];
-  for (const t of AGENT_MATRIX.slice(1)) {
+  const targets = [];
+  for (const t of AGENT_MATRIX) {
     if (fs15.existsSync(path15.join(repoRoot2, t.presentMarker))) targets.push(t);
   }
   return targets;
@@ -3499,8 +3547,13 @@ function registerAgentCommands(program2, repoRoot2) {
     const cmd = program2.command(t.id).description(`${t.label} integration`);
     cmd.command("install").description(`Write ${t.rel}`).action(() => {
       const root = repoRoot2();
-      const r = installTarget(root, t, detectPrefix(root));
+      const prefix = detectPrefix(root);
+      const r = installTarget(root, t, prefix);
       console.log(`\u2713 ${t.label}: ${r.rel} (${r.how})`);
+      if (t.id === "opencode") {
+        console.log("");
+        console.log(opencodePermissionGuide(prefix));
+      }
     });
     cmd.command("uninstall").description(`Remove ScopeCairn block from ${t.rel}`).action(() => {
       const r = uninstallTarget(repoRoot2(), t);
@@ -3512,7 +3565,7 @@ function registerAgentCommands(program2, repoRoot2) {
 // package.json
 var package_default = {
   name: "scopecairn",
-  version: "0.3.0",
+  version: "0.4.0",
   description: "ScopeCairn \u2014 Codebase Intelligence & Agent Optimization Layer (local-first)",
   license: "MIT",
   type: "module",
@@ -3599,7 +3652,7 @@ program.command("context <task>").description("Main entry point: auto-refresh +
 program.command("impact <target>").description("Change impact analysis: file, symbol, function, or class").option("--no-refresh", "skip incremental refresh (debugging/benchmark)").action(
   (target, opts) => cmdImpact(repoRoot(), target, opts)
 );
-program.command("init [path]").description("Initial indexing + generate AGENTS.md, Skill, Workflow, agent matrix").option("--agents <list>", "agent targets: comma list from agents,claude,gemini,cursor,windsurf,copilot,kiro, or 'all'").action(
+program.command("init [path]").description("Initial indexing + Skill, Workflow, agent skills (never touches AGENTS.md)").option("--agents <list>", "agent targets: comma list from claude,cursor,windsurf,copilot,kiro,opencode, or 'all'").action(
   (targetPath, opts) => cmdInit(resolveRoot(targetPath), opts)
 );
 program.command("benchmark").description("Retrieval recall, irrelevant ratio, context reduction + weight tuning").option("--tune", "grid search bobot FR-05").option("--no-refresh", "skip incremental refresh (debugging/benchmark)").action(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "scopecairn",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "ScopeCairn — Codebase Intelligence & Agent Optimization Layer (local-first)",
   "license": "MIT",
   "type": "module",

package/skills/scopecairn/SKILL.md

@@ -1,31 +1,30 @@
 ---
 name: scopecairn
-description: Set up ScopeCairn codebase intelligence in a repository. Use when the user says "scopecairn", "scopecairn ./", "scopecairn <path>", asks to index a repo for an AI agent, or wants the agent to understand a codebase with ScopeCairn.
+description: Set up ScopeCairn codebase intelligence, then use it for coding
+  tasks. Use when the user says "scopecairn", "scopecairn ./",
+  "scopecairn <path>", asks to index a repo for an AI agent, asks for a
+  repo overview, or for ALL coding tasks (feature, bugfix, refactor)
+  before exploring the repo.
+allowed-tools: Bash
 ---
 
-# ScopeCairn setup
+# ScopeCairn
 
-The user invoked ScopeCairn with a path (e.g. `scopecairn ./`).
-Your job: run project setup so this repo becomes agent-readable.
+## Setup (bila `.scopecairn/scopecairn.db` belum ada)
 
-## Steps
+1. Resolve path: `.`/`./` = direktori proyek saat ini.
+2. Jalankan `scopecairn init <path>` (`npx -y scopecairn init <path>`
+   bila CLI belum ada; atau `npm install -g scopecairn` dulu).
+3. Laporkan singkat: file terindex, simbol, relasi, adapter,
+   file integrasi yang ditulis. Berhenti setelah setup.
 
-1. Resolve the path: `.` or `./` means the current project directory.
-   A relative or absolute path means that directory.
-2. Run setup in that directory:
-   `scopecairn init <path>` (or `npx -y scopecairn init <path>` if it is not installed).
-3. If the command is not found, install globally first
-   (`npm install -g scopecairn`), then retry step 2.
-4. Report back, briefly: files indexed, symbols, relationships,
-   detected adapters, and which integration files were written
-   (AGENTS.md, Skill, Workflow, agent matrix).
+## Tiap task coding (bila index sudah ada)
 
-## Rules
-
-- Setup is read-only toward source code. `init` only adds/updates
-  `AGENTS.md` (marker block), the agent Skill, the Workflow file,
-  and the `.scopecairn/` index directory. Never refactor user code.
-- If a terminal command needs approval, ask once — after setup,
-  recommend the user allowlist the read-only commands printed by `init`.
-- After setup, coding tasks go through `scopecairn context "<task>"`,
-  never by re-exploring the repository from zero.
+1. Jalankan `scopecairn context "<task user>"`.
+   Mulai dari Relevant Files. Jangan menjelajah dari nol.
+2. Ubah hanya Required/Optional; Protected perlu persetujuan user.
+   Simbol bersama → `scopecairn impact <path>`.
+   Butuh isi fungsi → `scopecairn read symbol <nama>`, bukan baca file penuh.
+3. Task membesar (>2 file)? Panggil ulang `scopecairn context --escalate`.
+4. Setelah mengedit: `scopecairn scan`.
+   Berhenti saat acceptance criteria terpenuhi.