scopecairn 0.2.0 → 0.2.1

package/dist/cli.js

@@ -2,7 +2,7 @@
 
 // src/cli.ts
 import { Command } from "commander";
-import path15 from "path";
+import path16 from "path";
 
 // src/scanner.ts
 import fs7 from "fs";
@@ -2544,6 +2544,116 @@ ${tests.map((t) => `- ${t}`).join("\n") || "-"}
   return { markdown: md, high: highFiles, medium: medFiles, tests, dependencies: deps };
 }
 
+// src/commands/orientasi.ts
+import fs12 from "fs";
+import path13 from "path";
+function isPathLike(task) {
+  const t = task.trim().replace(/^["']|["']$/g, "");
+  return t === "." || t === "./" || t === "/" || t.startsWith("./") || t.startsWith("../") || t.startsWith("/") || t.startsWith("~");
+}
+function looksLikeRepoPath(db, repoRoot2, task) {
+  const t = task.trim().replace(/^["']|["']$/g, "");
+  if (/\s/.test(t)) return false;
+  if (isPathLike(task)) return true;
+  try {
+    fs12.statSync(path13.resolve(repoRoot2, t));
+    return true;
+  } catch {
+  }
+  try {
+    const row = db.prepare(`SELECT 1 AS ok FROM files WHERE path = ? OR path LIKE ? LIMIT 1`).get(t, `%/${t}`);
+    return !!row;
+  } catch {
+    return false;
+  }
+}
+function topCentral(db, limit = 10) {
+  try {
+    return db.prepare(
+      `SELECT s.name, s.type, f.path AS file, COUNT(*) AS fanin
+         FROM relationships r
+         JOIN symbols s ON s.id = r.target_id
+         JOIN files f ON f.id = s.file_id
+         WHERE s.type IN ('function','class','method','component','interface','type')
+         GROUP BY r.target_id ORDER BY fanin DESC LIMIT ${limit}`
+    ).all();
+  } catch {
+    return [];
+  }
+}
+function cmdOrientasi(repoRoot2, task) {
+  const db = openDb(repoRoot2);
+  try {
+    const files = db.prepare(`SELECT COUNT(*) AS n FROM files`).get().n;
+    if (files === 0) {
+      console.log("Index kosong. Jalankan `scopecairn scan` dulu.");
+      return;
+    }
+    const byLang = db.prepare(`SELECT language, COUNT(*) AS n FROM files GROUP BY language ORDER BY n DESC`).all();
+    const symbols = db.prepare(`SELECT COUNT(*) AS n FROM symbols`).get().n;
+    const t = task.trim().replace(/^["']|["']$/g, "");
+    const abs = path13.resolve(repoRoot2, t);
+    let rel = null;
+    try {
+      const stat = fs12.statSync(abs);
+      if (stat.isFile()) rel = path13.relative(repoRoot2, abs).split(path13.sep).join("/");
+    } catch {
+      rel = null;
+    }
+    if (rel) {
+      const row = db.prepare(`SELECT id FROM files WHERE path = ?`).get(rel);
+      if (row) {
+        const syms = db.prepare(`SELECT name, type FROM symbols WHERE file_id = ? AND type != 'file' LIMIT 20`).all(row.id);
+        const fileSym = db.prepare(`SELECT id FROM symbols WHERE file_id = ? AND type = 'file'`).get(row.id);
+        const linked = /* @__PURE__ */ new Set();
+        if (fileSym) {
+          for (const e of neighbors(db, fileSym.id, 30)) {
+            if (e.other.file !== rel) linked.add(e.other.file);
+          }
+        }
+        console.log(
+          `# Task Context (orientasi)
+
+## Task
+${task}
+
+## File
+${rel}
+
+## Simbol (${syms.length})
+${syms.map((s) => `- ${s.name} (${s.type})`).join("\n") || "-"}
+
+## Terkait langsung
+${[...linked].slice(0, 10).map((f) => `- ${f}`).join("\n") || "-"}
+
+Butuh konteks kerja? Jalankan \`scopecairn context "<deskripsi task>"\`.
+`
+        );
+        return;
+      }
+    }
+    const central = topCentral(db);
+    console.log(
+      `# Task Context (orientasi)
+
+## Task
+${task}
+
+## Ringkasan index
+- ${files} file (${byLang.map((l) => `${l.language} ${l.n}`).join(", ")})
+- ${symbols} simbol
+
+## Simbol paling dipakai
+${central.map((c) => `- ${c.name} (${c.type}, ${c.file}) \u2190 ${c.fanin}x`).join("\n") || "-"}
+
+Mulai dari simbol di atas, atau jalankan \`scopecairn context "<deskripsi task>"\` untuk konteks kerja.
+`
+    );
+  } finally {
+    db.close();
+  }
+}
+
 // src/commands/context.ts
 function cmdContext(repoRoot2, task, opts = {}) {
   if (!opts.noRefresh) {
@@ -2562,6 +2672,11 @@ function cmdContext(repoRoot2, task, opts = {}) {
       console.log("Index kosong. Jalankan `scopecairn scan` dulu.");
       return;
     }
+    if (looksLikeRepoPath(db, repoRoot2, task)) {
+      logInvocation(db, "context");
+      cmdOrientasi(repoRoot2, task);
+      return;
+    }
     const result = retrieve(db, repoRoot2, task);
     if (result.ranked.length === 0) {
       logInvocation(db, "context");
@@ -2731,29 +2846,29 @@ function cmdImpact(repoRoot2, target, opts = {}) {
 }
 
 // src/commands/init.ts
-import fs12 from "fs";
-import path13 from "path";
+import fs13 from "fs";
+import path14 from "path";
 function writeTarget(repoRoot2, target, prefix) {
-  const abs = path13.join(repoRoot2, target.rel);
+  const abs = path14.join(repoRoot2, target.rel);
   const block = target.render(prefix);
   if (target.mode === "new") {
-    const existed = fs12.existsSync(abs);
-    fs12.mkdirSync(path13.dirname(abs), { recursive: true });
-    fs12.writeFileSync(abs, block.endsWith("\n") ? block : block + "\n");
+    const existed = fs13.existsSync(abs);
+    fs13.mkdirSync(path14.dirname(abs), { recursive: true });
+    fs13.writeFileSync(abs, block.endsWith("\n") ? block : block + "\n");
     return existed ? "updated" : "generated";
   }
-  if (fs12.existsSync(abs)) {
-    const cur = fs12.readFileSync(abs, "utf8");
+  if (fs13.existsSync(abs)) {
+    const cur = fs13.readFileSync(abs, "utf8");
     if (cur.includes(MARKER)) {
       const re = new RegExp(`${MARKER}[\\s\\S]*?(?=\\n#[^#]|$)`, "");
-      fs12.writeFileSync(abs, cur.replace(re, block.trimEnd()).trimEnd() + "\n");
+      fs13.writeFileSync(abs, cur.replace(re, block.trimEnd()).trimEnd() + "\n");
       return "updated";
     }
-    fs12.writeFileSync(abs, cur.trimEnd() + "\n\n" + block);
+    fs13.writeFileSync(abs, cur.trimEnd() + "\n\n" + block);
     return "extended";
   }
-  fs12.mkdirSync(path13.dirname(abs), { recursive: true });
-  fs12.writeFileSync(abs, block.endsWith("\n") ? block : block + "\n");
+  fs13.mkdirSync(path14.dirname(abs), { recursive: true });
+  fs13.writeFileSync(abs, block.endsWith("\n") ? block : block + "\n");
   return "generated";
 }
 function cmdInit(repoRoot2, opts = {}) {
@@ -2784,29 +2899,29 @@ function cmdInit(repoRoot2, opts = {}) {
   } else {
     targets = [AGENT_MATRIX[0]];
     for (const t of AGENT_MATRIX.slice(1)) {
-      if (fs12.existsSync(path13.join(repoRoot2, t.presentMarker))) targets.push(t);
+      if (fs13.existsSync(path14.join(repoRoot2, t.presentMarker))) targets.push(t);
     }
   }
   for (const t of targets) {
     const how = writeTarget(repoRoot2, t, prefix);
     console.log(`\u2713 ${t.label}: ${t.rel} (${how})`);
   }
-  const skillPath = path13.join(repoRoot2, agentDir, "skills", "scopecairn", "SKILL.md");
-  fs12.mkdirSync(path13.dirname(skillPath), { recursive: true });
-  fs12.writeFileSync(skillPath, skillMd(prefix));
-  console.log(`\u2713 Skill installed (${path13.relative(repoRoot2, skillPath)})`);
-  const wfPath = path13.join(repoRoot2, "workflows", "scopecairn.md");
-  fs12.mkdirSync(path13.dirname(wfPath), { recursive: true });
-  fs12.writeFileSync(wfPath, workflowMd(prefix));
-  console.log(`\u2713 Workflow installed (${path13.relative(repoRoot2, wfPath)})`);
+  const skillPath = path14.join(repoRoot2, agentDir, "skills", "scopecairn", "SKILL.md");
+  fs13.mkdirSync(path14.dirname(skillPath), { recursive: true });
+  fs13.writeFileSync(skillPath, skillMd(prefix));
+  console.log(`\u2713 Skill installed (${path14.relative(repoRoot2, skillPath)})`);
+  const wfPath = path14.join(repoRoot2, "workflows", "scopecairn.md");
+  fs13.mkdirSync(path14.dirname(wfPath), { recursive: true });
+  fs13.writeFileSync(wfPath, workflowMd(prefix));
+  console.log(`\u2713 Workflow installed (${path14.relative(repoRoot2, wfPath)})`);
   console.log("Ready.");
   console.log("");
   console.log(allowlistGuide(prefix));
 }
 
 // src/benchmark/run.ts
-import fs13 from "fs";
-import path14 from "path";
+import fs14 from "fs";
+import path15 from "path";
 
 // src/benchmark/dataset.ts
 var BENCHMARK_TASKS = [
@@ -2863,7 +2978,7 @@ var BENCHMARK_TASKS = [
 // src/benchmark/run.ts
 function fileChars(repoRoot2, rel) {
   try {
-    return fs13.readFileSync(path14.join(repoRoot2, rel), "utf8").length;
+    return fs14.readFileSync(path15.join(repoRoot2, rel), "utf8").length;
   } catch {
     return 0;
   }
@@ -3015,7 +3130,7 @@ function cmdBenchmark(repoRoot2, opts = {}) {
 // package.json
 var package_default = {
   name: "scopecairn",
-  version: "0.2.0",
+  version: "0.2.1",
   description: "ScopeCairn \u2014 Codebase Intelligence & Agent Optimization Layer (local-first)",
   license: "MIT",
   type: "module",
@@ -3067,11 +3182,11 @@ var package_default = {
 var program = new Command();
 program.name("scopecairn").description("ScopeCairn \u2014 local-first codebase intelligence layer").version(package_default.version);
 function repoRoot() {
-  return path15.resolve(process.cwd());
+  return path16.resolve(process.cwd());
 }
 function resolveRoot(given) {
   if (!given) return repoRoot();
-  return path15.resolve(process.cwd(), given);
+  return path16.resolve(process.cwd(), given);
 }
 program.command("scan").description("Index repository (Fase 1: files + hash + language)").action(() => cmdScan(repoRoot()));
 program.command("status").description("Show index status").action(() => cmdStatus(repoRoot()));

package/package.json

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