octocode-cli 1.5.0 → 1.5.3

package/out/chunks/command-help-specs-RVJK6V6M.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { createRequire as __createRequire } from 'module';
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __dirname_fn } from 'path';
+const require = __createRequire(import.meta.url);
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __dirname_fn(__filename);
+import{k as o}from"./chunk-OMXWZJBJ.js";import"./chunk-BRHVQB64.js";import"./chunk-CVNNNSMQ.js";import"./chunk-375ZNU3A.js";import"./chunk-KWJUBVXJ.js";import"./chunk-AYILFPX4.js";import"./chunk-YBBF4DTY.js";function C(n){let m=o(n);return m?e(m):void 0}function e(n){let{handler:m,...d}=n;return d}export{C as findStaticCommandHelp};

package/out/chunks/commands-JFDCC4Q7.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { createRequire as __createRequire } from 'module';
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __dirname_fn } from 'path';
+const require = __createRequire(import.meta.url);
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __dirname_fn(__filename);
+import{a,b,c,d,e,f,g,h,i,j,k}from"./chunk-OMXWZJBJ.js";import"./chunk-BRHVQB64.js";import"./chunk-CVNNNSMQ.js";import"./chunk-375ZNU3A.js";import"./chunk-KWJUBVXJ.js";import"./chunk-AYILFPX4.js";import"./chunk-YBBF4DTY.js";export{e as authCommand,h as cacheCommand,k as findCommand,a as installCommand,c as loginCommand,d as logoutCommand,g as mcpCommand,f as skillsCommand,i as statusCommand,j as syncCommand,b as tokenCommand};

package/out/chunks/{help-P7TCOYAJ.js → help-H3WGUJO7.js}

@@ -5,6 +5,6 @@ import { dirname as __dirname_fn } from 'path';
 const require = __createRequire(import.meta.url);
 const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __dirname_fn(__filename);
-import{a as n,b as e,c as p}from"./chunk-V64AXUWB.js";import"./chunk-YBBF4DTY.js";function r(t){let o=["",`  ${n("magenta",e("\u{1F50D}\u{1F419} octocode "+t.name))}`,"",`  ${t.description}`,""];if(t.usage&&(o.push(`  ${e("USAGE")}`),o.push(`    ${t.usage}`),o.push("")),t.options&&t.options.length>0){o.push(`  ${e("OPTIONS")}`);for(let s of t.options){let i=s.short?`-${s.short}, `:"    ",u=`--${s.name}`,a=s.hasValue?" <value>":"",l=s.default!==void 0?p(` (default: ${s.default})`):"";o.push(`    ${n("cyan",i+u+a)}${l}`),o.push(`        ${s.description}`)}o.push("")}process.stdout.write(`${o.join(`
+import{a as n,b as e,c as p}from"./chunk-AYILFPX4.js";import"./chunk-YBBF4DTY.js";function r(t){let o=["",`  ${n("magenta",e("\u{1F50D}\u{1F419} octocode "+t.name))}`,"",`  ${t.description}`,""];if(t.usage&&(o.push(`  ${e("USAGE")}`),o.push(`    ${t.usage}`),o.push("")),t.options&&t.options.length>0){o.push(`  ${e("OPTIONS")}`);for(let s of t.options){let i=s.short?`-${s.short}, `:"    ",u=`--${s.name}`,a=s.hasValue?" <value>":"",l=s.default!==void 0?p(` (default: ${s.default})`):"";o.push(`    ${n("cyan",i+u+a)}${l}`),o.push(`        ${s.description}`)}o.push("")}process.stdout.write(`${o.join(`
 `)}
 `)}export{r as showCommandHelp};

package/out/chunks/main-help-BUTDD4IR.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+import { createRequire as __createRequire } from 'module';
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __dirname_fn } from 'path';
+const require = __createRequire(import.meta.url);
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __dirname_fn(__filename);
+import{a as i,b as c,d as r}from"./chunk-375ZNU3A.js";import"./chunk-KWJUBVXJ.js";import{a as o,b as e,c as t}from"./chunk-AYILFPX4.js";import"./chunk-YBBF4DTY.js";function $(){let l=[];for(let a of i){let s=c.filter(n=>r(n.name)===a);if(s.length!==0){l.push(`    ${t(a)}`);for(let n of s)l.push(`    ${o("cyan",n.name)}`)}}return l}function g(){let l=$(),a=c.length,s=["",`  ${o("magenta",e("\u{1F50D}\u{1F419} Octocode CLI"))}`,"",`  ${e("INSTRUCTIONS FOR AGENTS")}  ${t("(do this before making any tool request)")}`,`    ${t("0.")} Load agent context (protocol + tools + fields)    ${o("yellow","octocode --agent")}`,`    ${t("1.")} List all available tools                          ${o("yellow","octocode tools")}`,`    ${t("2.")} Read a tool's input schema                        ${o("yellow","octocode tools <name>")}`,`    ${t("3.")} Full context with every JSON schema inline        ${o("yellow","octocode --agent --full")}`,"",`  ${e("USAGE")}`,`    ${o("magenta","octocode")} <command> [options]                    ${t("manage Octocode")}`,`    ${o("magenta","octocode")} tools                                  ${t("list all tools")}`,`    ${o("magenta","octocode")} tools <name>                           ${t("show input schema")}`,`    ${o("magenta","octocode")} tools <n1> <n2> ...                    ${t("batch input schemas")}`,`    ${o("magenta","octocode")} tools <name> --queries '<json>'        ${t("run a tool")}`,`    ${o("magenta","octocode")} instructions                           ${t("MCP instructions + all schemas")}`,"",`  ${e("COMMANDS")}  ${t("(manage Octocode configuration)")}`,`    ${o("magenta","install")}          Configure octocode-mcp for an IDE`,`    ${o("magenta","auth")}             Manage GitHub authentication`,`    ${o("magenta","login / logout")}   Sign in or out of GitHub`,`    ${o("magenta","status / token")}   Show auth status or print token`,`    ${o("magenta","skills")}           Search, install & manage Octocode skills`,`    ${o("magenta","mcp")}              Manage MCP marketplace`,`    ${o("magenta","sync")}             Sync MCP configs across IDEs`,`    ${o("magenta","cache")}            Inspect and clean Octocode cache`,"",`  ${e("SKILLS")}  ${t("(octocode skills <subcommand>)")}`,`    ${o("magenta","search")} ${t("<query>")}    Find skills ${t("(agent protocol; --direct for skills.sh results)")}`,`    ${o("magenta","read")} ${t("<path|url>")}   Print a SKILL.md ${t("(local path, owner/repo/path, or GitHub URL)")}`,`    ${o("magenta","list")}              List skills installed across all AI clients`,`    ${o("magenta","install")}           Install skills ${t("(--skill <name>, --local <path>, --targets <list>)")}`,`    ${o("magenta","remove")}            Remove a skill ${t("(--skill <name> or --local <path>)")}`,`    ${o("magenta","sync")} ${t("<from> <to>")}  Copy skills from one client target to another`,"",`  ${e("TOOLS")}  ${t(`(${a} tools \u2014 run directly from terminal)`)}`,...l,"",`  ${e("OPTIONS")}`,`    ${o("cyan","--json")}            Raw JSON (full MCP envelope) for tool runs`,`    ${o("cyan","--compact")}         Leanest tool output (concise verbosity, fewer tokens)`,`    ${o("cyan","--no-color")}        Disable ANSI colors (also via NO_COLOR=1)`,`    ${o("cyan","-h, --help")}        Show this help`,`    ${o("cyan","-v, --version")}     Show version`,"",`  ${e("EXAMPLES")}`,`    ${o("yellow","octocode tools")}                                                          ${t("# list")}`,`    ${o("yellow","octocode tools localSearchCode")}                                          ${t("# schema")}`,`    ${o("yellow","octocode tools localSearchCode githubSearchCode")}                         ${t("# batch schemas")}`,`    ${o("yellow",`octocode tools localSearchCode --queries '{"path":".","pattern":"fn"}'`)}  ${t("# run")}`,`    ${o("yellow","octocode instructions")}                                                   ${t("# full context")}`,"",`    ${o("yellow","octocode install --ide cursor")}`,`    ${o("yellow",'octocode skills search "code review"')}                                     ${t("# find skills")}`,`    ${o("yellow",'octocode skills search "code review" --direct')}                            ${t("# skills.sh results")}`,`    ${o("yellow","octocode skills install --targets claude-code,cursor")}`,"",o("magenta",`  \u2500\u2500\u2500 \u{1F50D}\u{1F419} ${e("https://octocode.ai")} \u2500\u2500\u2500`),""];process.stdout.write(`${s.join(`
+`)}
+`)}export{g as showHelp};

package/out/chunks/{spinner-URV2OX6O.js → spinner-DXD4JQIU.js}

@@ -5,4 +5,4 @@ import { dirname as __dirname_fn } from 'path';
 const require = __createRequire(import.meta.url);
 const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __dirname_fn(__filename);
-import{a}from"./chunk-UCZCF3BQ.js";import"./chunk-V64AXUWB.js";import"./chunk-YBBF4DTY.js";export{a as Spinner};
+import{a}from"./chunk-BRHVQB64.js";import"./chunk-AYILFPX4.js";import"./chunk-YBBF4DTY.js";export{a as Spinner};

package/out/chunks/tool-command-L6PVHUNS.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { createRequire as __createRequire } from 'module';
+import { fileURLToPath as __fileURLToPath } from 'url';
+import { dirname as __dirname_fn } from 'path';
+const require = __createRequire(import.meta.url);
+const __filename = __fileURLToPath(import.meta.url);
+const __dirname = __dirname_fn(__filename);
+import{a,b,c,d,e,f,g,h,i,j,k,l}from"./chunk-375ZNU3A.js";import"./chunk-KWJUBVXJ.js";import"./chunk-AYILFPX4.js";import"./chunk-YBBF4DTY.js";export{a as TOOL_CATEGORIES,b as TOOL_DEFINITIONS,k as executeToolCommand,c as findToolDefinition,e as getDisplayFields,d as getToolCategory,i as getToolsContextString,j as printToolsContext,f as showAvailableTools,h as showMultipleToolSchemas,g as showToolHelp,l as toolCommand};

package/out/octocode-cli.js

@@ -5,4 +5,4 @@ import { dirname as __dirname_fn } from 'path';
 const require = __createRequire(import.meta.url);
 const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __dirname_fn(__filename);
-import{c as d}from"./chunks/chunk-V64AXUWB.js";import"./chunks/chunk-YBBF4DTY.js";var p=new Set(["ide","method","m","output","o","hostname","H","git-protocol","p","type","t","skill","k","local","limit","l","targets","mode","model","resume","r","id","client","c","search","category","env","config","tool","queries","input","responseCharLength","responseCharOffset","target","backup-path"]),S=new Set(["help","h","version","v","force","source","json","status","dry-run","installed","repos","skills","logs","all","tools","full","direct","lsp","api","list","schema","tools-context","check","rollback","install","yes","y","validate","sync"]),T=new Set(["output","responseCharLength","responseCharOffset","tool","queries"]);function h(t,o){return S.has(o)?!1:p.has(o)?!0:t.command==="tool"||typeof t.options.tool=="string"}function g(t=process.argv.slice(2)){let o={command:null,args:[],options:{}},e=0;for(;e<t.length;){let i=t[e];if(i.startsWith("--")){let[s,n]=i.slice(2).split("=");n!==void 0?o.options[s]=n:h(o,s)&&e+1<t.length&&!t[e+1].startsWith("-")?(o.options[s]=t[e+1],e++):o.options[s]=!0}else if(i.startsWith("-")&&!i.startsWith("--")&&i.length>2){let s=i.slice(1),[n,r]=s.split("=");if(T.has(n))r!==void 0?o.options[n]=r:h(o,n)&&e+1<t.length&&!t[e+1].startsWith("-")?(o.options[n]=t[e+1],e++):o.options[n]=!0;else{let a=s,c=a[a.length-1];if(a.length===1&&p.has(c)&&e+1<t.length&&!t[e+1].startsWith("-"))o.options[c]=t[e+1],e++;else for(let m of a)o.options[m]=!0}}else if(i.startsWith("-")&&i.length>1){let s=i.slice(1),n=s[s.length-1];if(s.length===1&&p.has(n)&&e+1<t.length&&!t[e+1].startsWith("-"))o.options[n]=t[e+1],e++;else for(let r of s)o.options[r]=!0}else o.command||typeof o.options.tool=="string"?o.args.push(i):o.command=i;e++}return!o.command&&typeof o.options.tool=="string"&&(o.command="tool",o.args=[o.options.tool,...o.args]),o}function w(t){return!!(t.options.help||t.options.h)}function C(t){return!!(t.options.version||t.options.v)}async function P(){return import("./chunks/commands-XBFPLHSQ.js")}async function H(){return import("./chunks/command-help-specs-JZXVSLZ5.js")}async function l(){return import("./chunks/tool-command-M6VA7P2F.js")}async function u(){return import("./chunks/main-help-ULF5PAQY.js")}async function _(){return import("./chunks/help-P7TCOYAJ.js")}function I(){console.log(),console.log("  Use octocode --tool <toolName> --queries '<json-stringified-input>'."),console.log(`  Example: octocode --tool localSearchCode --queries '{"path":".","pattern":"runCLI"}'`),console.log()}function A(){console.log("octocode v1.5.0")}async function y(t){let o=g(t);if(o.options["tools-context"]===!0){let{printToolsContext:s}=await l();return await s(),!0}if(w(o)){if(o.command==="tool"&&typeof o.options.tool=="string"&&typeof o.args[0]=="string"){let{showToolHelp:n}=await l();if(await n(o.args[0]))return!0}if(o.command==="tool"){let{showHelp:n}=await u();return n(),!0}if(o.command==="tools"){if(typeof o.args[0]=="string"){let{showToolHelp:r}=await l();if(await r(o.args[0]))return!0}let{showAvailableTools:n}=await l();return await n(),!0}if(o.command){let[{findStaticCommandHelp:n},{showCommandHelp:r}]=await Promise.all([H(),_()]),a=n(o.command);if(a)return r(a),!0;let[{findCommand:c},{showHelp:m}]=await Promise.all([P(),u()]),f=c(o.command);return f?(r(f),!0):(m(),!0)}let{showHelp:s}=await u();return s(),!0}if(C(o))return A(),!0;if(!o.command)return!1;if(o.command==="tool")return typeof o.options.tool!="string"?(I(),process.exitCode=1,!0):(await(await l()).executeToolCommand(o)||(process.exitCode=1),!0);if(o.command==="tools"){let{executeToolCommand:s}=await l();return await s(o)||(process.exitCode=1),!0}if(o.command==="instructions"){let{printToolsContext:s}=await l();return await s(),!0}let{findCommand:e}=await P(),i=e(o.command);return i?(await i.handler(o),!0):(console.log(),console.log(`  Unknown command: ${o.command}`),console.log("  Run 'octocode --help' to see available commands."),console.log(),process.exitCode=1,!0)}async function L(){let{showHelp:t}=await import("./chunks/main-help-ULF5PAQY.js");t()}async function N(){await y()||await L()}function x(){process.stdout.write("\x1B[?25h"),console.log(),console.log(d("  Goodbye! \u{1F44B}")),process.exit(0)}process.on("SIGINT",x);process.on("SIGTERM",x);N().catch(t=>{t?.name==="ExitPromptError"&&(console.log(),console.log(d("  Goodbye! \u{1F44B}")),process.exit(0)),console.error("Error:",t),process.exit(1)});
+import{a as c}from"./chunks/chunk-KWJUBVXJ.js";import{c as u}from"./chunks/chunk-AYILFPX4.js";import"./chunks/chunk-YBBF4DTY.js";var d=new Set(["ide","method","m","output","o","hostname","H","git-protocol","p","type","t","skill","k","local","limit","l","targets","mode","model","resume","r","id","client","c","search","category","env","config","tool","queries","format","input","responseCharLength","responseCharOffset","target","backup-path"]),S=new Set(["help","h","version","v","force","source","json","status","dry-run","installed","repos","skills","logs","all","tools","full","direct","lsp","api","list","schema","tools-context","agent","compact","full","no-color","reveal","raw","check","rollback","install","yes","y","validate","sync"]),_=new Set(["output","responseCharLength","responseCharOffset","tool","queries"]);function g(t,o){return S.has(o)?!1:d.has(o)?!0:t.command==="tool"||typeof t.options.tool=="string"}function w(t=process.argv.slice(2)){let o={command:null,args:[],options:{}},e=0;for(;e<t.length;){let i=t[e];if(i.startsWith("--")){let[s,n]=i.slice(2).split("=");n!==void 0?o.options[s]=n:g(o,s)&&e+1<t.length&&!t[e+1].startsWith("-")?(o.options[s]=t[e+1],e++):o.options[s]=!0}else if(i.startsWith("-")&&!i.startsWith("--")&&i.length>2){let s=i.slice(1),[n,r]=s.split("=");if(_.has(n))r!==void 0?o.options[n]=r:g(o,n)&&e+1<t.length&&!t[e+1].startsWith("-")?(o.options[n]=t[e+1],e++):o.options[n]=!0;else{let l=s,m=l[l.length-1];if(l.length===1&&d.has(m)&&e+1<t.length&&!t[e+1].startsWith("-"))o.options[m]=t[e+1],e++;else for(let p of l)o.options[p]=!0}}else if(i.startsWith("-")&&i.length>1){let s=i.slice(1),n=s[s.length-1];if(s.length===1&&d.has(n)&&e+1<t.length&&!t[e+1].startsWith("-"))o.options[n]=t[e+1],e++;else for(let r of s)o.options[r]=!0}else o.command||typeof o.options.tool=="string"?o.args.push(i):o.command=i;e++}return!o.command&&typeof o.options.tool=="string"&&(o.command="tool",o.args=[o.options.tool,...o.args]),o}function C(t){return!!(t.options.help||t.options.h)}function P(t){return!!(t.options.version||t.options.v)}async function y(){return import("./chunks/commands-JFDCC4Q7.js")}async function A(){return import("./chunks/command-help-specs-RVJK6V6M.js")}async function a(){return import("./chunks/tool-command-L6PVHUNS.js")}async function f(){return import("./chunks/main-help-BUTDD4IR.js")}async function H(){return import("./chunks/help-H3WGUJO7.js")}function I(){console.log(),console.log("  Use octocode --tool <toolName> --queries '<json-stringified-input>'."),console.log(`  Example: octocode --tool localSearchCode --queries '{"path":".","pattern":"runCLI"}'`),console.log()}function L(){console.log("octocode v1.5.3")}async function x(t){let o=w(t);if(o.options["no-color"]===!0&&(process.env.NO_COLOR="1"),o.options["tools-context"]===!0||o.options.agent===!0){let{printToolsContext:s}=await a();return await s({full:o.options.full===!0}),!0}if(C(o)){if(o.command==="tool"&&typeof o.options.tool=="string"&&typeof o.args[0]=="string"){let{showToolHelp:n}=await a();if(await n(o.args[0]))return!0}if(o.command==="tool"){let{showHelp:n}=await f();return n(),!0}if(o.command==="tools"){if(typeof o.args[0]=="string"){let{showToolHelp:r}=await a();if(await r(o.args[0]))return!0}let{showAvailableTools:n}=await a();return await n(),!0}if(o.command){let[{findStaticCommandHelp:n},{showCommandHelp:r}]=await Promise.all([A(),H()]),l=n(o.command);if(l)return r(l),!0;let[{findCommand:m},{showHelp:p}]=await Promise.all([y(),f()]),h=m(o.command);return h?(r(h),!0):(p(),!0)}let{showHelp:s}=await f();return s(),!0}if(P(o))return L(),!0;if(!o.command)return!1;if(o.command==="tool")return typeof o.options.tool!="string"?(I(),process.exitCode=c.USAGE,!0):(!await(await a()).executeToolCommand(o)&&!process.exitCode&&(process.exitCode=c.GENERAL),!0);if(o.command==="tools"){let{executeToolCommand:s}=await a();return!await s(o)&&!process.exitCode&&(process.exitCode=c.GENERAL),!0}if(o.command==="instructions"||o.command==="agent"){let{printToolsContext:s}=await a();return await s({full:o.options.full===!0}),!0}let{findCommand:e}=await y(),i=e(o.command);return i?(await i.handler(o),!0):(console.log(),console.log(`  Unknown command: ${o.command}`),console.log("  Run 'octocode --help' to see available commands."),console.log(),process.exitCode=c.NOT_FOUND,!0)}async function N(){let{showHelp:t}=await import("./chunks/main-help-BUTDD4IR.js");t()}async function O(){await x()||await N()}function T(){process.stdout.write("\x1B[?25h"),console.log(),console.log(u("  Goodbye! \u{1F44B}")),process.exit(0)}process.on("SIGINT",T);process.on("SIGTERM",T);O().catch(t=>{t?.name==="ExitPromptError"&&(console.log(),console.log(u("  Goodbye! \u{1F44B}")),process.exit(0)),console.error("Error:",t),process.exit(1)});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "octocode-cli",
-  "version": "1.5.0",
+  "version": "1.5.3",
   "description": "Interactive CLI installer for octocode-mcp - Configure MCP servers for Cursor, Claude Desktop, and more",
   "keywords": [
     "ai-coding",
@@ -68,7 +68,7 @@
     "@vitest/coverage-v8": "^4.0.16",
     "esbuild": "^0.27.2",
     "eslint": "^9.18.0",
-    "octocode-mcp": "^15.0.0",
+    "octocode-mcp": "^15.0.2",
     "octocode-shared": "workspace:^",
     "open": "^11.0.0",
     "tsx": "^4.21.0",

package/skills/octocode-brainstorming/scripts/tavily-search.mjs

@@ -1,14 +1,5 @@
 #!/usr/bin/env node
-/**
- * Tavily web search for octocode-brainstorming.
- *
- * Usage:
- *   node tavily-search.mjs --query "prior art for X" [--depth basic|advanced] [--max-results 8] [--topic general|news] [--time-range month|year]
- *   node tavily-search.mjs --check   # exits 0 if key is set, 1 otherwise
- *
- * Requires TAVILY_API_KEY in env or in <skill_dir>/.env
- * Outputs JSON to stdout; progress/errors to stderr. Never prints the key.
- */
+
 
 import { readFileSync } from 'node:fs';
 import { resolve, dirname } from 'node:path';

package/skills/octocode-chrome-devtools/scripts/cdp-runner.mjs

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-// Run a generated `run(cdp)` script against a Chrome CDP target.
 
 import { resolve, join } from 'path';
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
@@ -392,7 +391,6 @@ async function main() {
   console.error(`[CDP_RUNNER] Session meta dir: ${sessionMetaDir}`);
   console.error(`[CDP_RUNNER] Connected - running ${scriptArg}`);
 
-  // Node PM has no scoped networking; keep generated script fetch/WebSocket on localhost.
   const _origFetch = globalThis.fetch;
   const _OrigWS    = globalThis.WebSocket;
   function isLocalhost(url) {

package/skills/octocode-chrome-devtools/scripts/cdp-sandbox.mjs

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-// Run cdp-runner.mjs with Node permissions, output isolation, and a process timeout.
 
 import { spawn }                          from 'child_process';
 import { resolve, dirname, join }         from 'path';
@@ -32,7 +31,6 @@ mkdirSync(OUTPUT_DIR, { recursive: true, mode: 0o700 });
 const SESSION_META_DIR = join(tmpdir(), '.octocode-chrome-devtools', 'session-meta', `port-${PORT}`);
 mkdirSync(SESSION_META_DIR, { recursive: true, mode: 0o700 });
 
-// Node 22 normalizes --allow-fs-* entries to realpaths; pass symlink and real forms.
 const safePath = (p) => { try { return realpathSync(p); } catch { return p; } };
 
 const TMPDIR_RAW  = tmpdir();
@@ -41,7 +39,6 @@ const RUNNER_REAL = safePath(RUNNER);
 const OUTPUT_REAL = safePath(OUTPUT_DIR);
 const SESSION_META_REAL = safePath(SESSION_META_DIR);
 
-// Stage helpers next to generated $TMPDIR scripts so relative imports work.
 const HELPERS = ['sourcemap-resolver.mjs', 'undercover.mjs'];
 for (const helper of HELPERS) {
   const src = resolve(__dir, helper);
@@ -66,7 +63,6 @@ if (scriptArg) {
 
 const spawnArgv = argv.map(a => (a === scriptArg && scriptReal) ? scriptReal : a);
 
-// Node PM has no stable scoped --allow-net; cdp-runner restricts fetch/WebSocket to localhost.
 const readPaths  = [...new Set([RUNNER, RUNNER_REAL, TMPDIR_RAW, TMPDIR_REAL, ...allowReadExtra])];
 const writePaths = [...new Set([OUTPUT_DIR, OUTPUT_REAL, SESSION_META_DIR, SESSION_META_REAL])];
 
@@ -106,7 +102,7 @@ const scriptTimer = setTimeout(() => {
   child.kill('SIGTERM');
   setTimeout(() => child.kill('SIGKILL'), 2000).unref();
 }, SCRIPT_TIMEOUT_MS);
-scriptTimer.unref(); // don't keep the process alive on its own
+scriptTimer.unref();
 
 child.on('exit', (code, signal) => {
   clearTimeout(scriptTimer);

package/skills/octocode-chrome-devtools/scripts/cdp-template.mjs

@@ -1,17 +1,9 @@
-// Base run(cdp) template. Save task copies in $TMPDIR and run with cdp-sandbox.mjs.
 
 export async function run(cdp) {
-  // Optional: source maps must be registered before navigation.
-  // const { createSourceMapResolver } = await import(new URL('./sourcemap-resolver.mjs', import.meta.url).href);
-  // const resolver = await createSourceMapResolver(cdp);
 
   await cdp.send('Runtime.enable', {});
   await cdp.send('Network.enable', {});
   await cdp.send('Log.enable', {});
-  // await cdp.send('Page.enable', {});
-  // await cdp.send('DOM.enable', {});
-  // await cdp.send('CSS.enable', {});
-  // await cdp.send('Performance.enable', {});
 
   console.log(`[METRIC] Inspecting: ${cdp.targetInfo.url}`);
   cdp.addReasoningStep?.({
@@ -64,9 +56,8 @@ export async function run(cdp) {
       console.log(`[LOG:${entry.level.toUpperCase()}] [${entry.source}] ${entry.text}${entry.url ? ` @ ${entry.url}:${entry.lineNumber}` : ''}`);
   });
 
-  // Add task-specific cdp.send() calls here. See SCRIPT_PATTERNS.md.
 
-  const MONITOR_MS = 10000; // 3s static, 10s dynamic, 30s long network check
+  const MONITOR_MS = 10000;
   console.log(`[METRIC] Monitoring for ${MONITOR_MS / 1000}s...`);
   await new Promise(r => setTimeout(r, MONITOR_MS));
 

package/skills/octocode-chrome-devtools/scripts/open-browser.mjs

@@ -1,5 +1,4 @@
 #!/usr/bin/env node
-// Launch Chrome with CDP enabled; tracks isolated sessions for cleanup.
 
 import { spawn, execSync, execFileSync } from 'child_process';
 import { platform, tmpdir }  from 'os';
@@ -26,7 +25,6 @@ const CONFIG_PATH = getArg('--config', '');
 
 const TMP         = tmpdir();
 const SESSION_FILE = join(TMP, `cdp-session-${PORT}.json`);
-// Headless always uses an isolated temp profile.
 const HEADLESS_PROFILE_DIR = join(TMP, `cdp-chrome-profile-${PORT}`);
 
 function ok(payload)  { console.log(JSON.stringify(payload)); }
@@ -265,7 +263,6 @@ if (CHROME_PATH && !existsSync(CHROME_PATH)) err(`Chrome not found at --chromePa
 
 const HOME = process.env.HOME ?? process.env.USERPROFILE;
 
-// If Chrome is already running without CDP, real-profile launches may hand off to it.
 function isChromeRunning() {
   if (platform() === 'darwin') {
     try { execSync('pgrep -x "Google Chrome" > /dev/null 2>&1'); return true; } catch { return false; }

package/skills/octocode-chrome-devtools/scripts/sourcemap-resolver.mjs

@@ -1,4 +1,3 @@
-// Minimal source-map resolver for CDP scripts; strips sourcesContent.
 
 const B64 = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/';
 const B64_MAP = new Uint8Array(256).fill(255);
@@ -20,7 +19,6 @@ function decodeVLQList(str) {
 }
 
 function parseMap(mapJson) {
-  // Never retain original source bodies.
   delete mapJson.sourcesContent;
 
   const sources = mapJson.sources ?? [];
@@ -63,7 +61,6 @@ function originalPositionFor(parsed, genLine, genCol) {
   const { segments, sources, names } = parsed;
   if (!segments.length) return null;
 
-  // Same-line lookup only; previous-line matches look plausible but are wrong.
   let lo = 0, hi = segments.length - 1, best = -1;
 
   while (lo <= hi) {
@@ -141,7 +138,7 @@ export async function createSourceMapResolver(cdp) {
         }
 
         const mapJson = JSON.parse(mapText);
-        const parsed  = parseMap(mapJson); // strips sourcesContent internally
+        const parsed  = parseMap(mapJson);
         parsedMaps.set(scriptId, parsed);
         stats.loaded++;
       } catch {

package/skills/octocode-chrome-devtools/scripts/undercover.mjs

@@ -1,5 +1,3 @@
-// Drop-in stealth patches for public sites likely to fingerprint headless Chrome.
-// Import from generated scripts before Page.navigate.
 export async function applyStealthPatches(cdp, opts = {}) {
   const ua = opts.userAgent ??
     'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36';

package/skills/octocode-engineer/SKILL.md

@@ -68,7 +68,7 @@ Every **non-trivial** task MUST satisfy this contract:
 
 ## When To Use It
 
-Use when the user asks to **understand** a codebase/feature end-to-end, **change** unclear/shared/cross-file code, **review** quality/architecture/tech-debt/dead-code/security/build issues, or **decide** architecture and validate RFCs against real behavior. Any language; strongest on Node/TypeScript and Python. For formal RFCs with migration strategy, pair with [octocode-rfc-generator](https://skills.sh/bgauryy/octocode-mcp/octocode-rfc-generator).
+Use when the user asks to **understand** a codebase/feature end-to-end, **change** unclear/shared/cross-file code, **review** quality/architecture/tech-debt/dead-code/security/build issues, or **decide** architecture and validate RFCs against real behavior. Any language; strongest on Node/TypeScript and Python. For architecture options, trade-offs, or migration strategy that need a formal proposal before coding, pair with [octocode-rfc-generator](https://skills.sh/bgauryy/octocode-mcp/octocode-rfc-generator).
 
 ## Trivial vs. non-trivial — when the contract binds
 
@@ -120,12 +120,12 @@ Cover all six on a full review; on a scoped task, cover those the change touches
 |------|------|-----------------|
 | Small functions | `scripts/run.js` | `god-function`, `cognitive-complexity`, `halstead-effort`, `excessive-parameters` |
 | Duplication | `scripts/run.js` | `duplicate-function-body`, `duplicate-flow-structure`, `similar-function-body` |
-| Silent failures | `scripts/ast/search.js` | `--preset empty-catch`, `--preset py-bare-except`, `--preset py-pass-except`, `--preset catch-rethrow` |
+| Silent failures | `scripts/ast/search.js` | `--preset empty-catch`, `--preset py-bare-except`, `--preset catch-rethrow` |
 | Loose types | `scripts/ast/search.js` | `--preset any-type`, `--preset type-assertion`, `--preset non-null-assertion` |
 | Intent-revealing names | code read + `lspFindReferences` | widely-used cryptic symbols, abbreviations that spread |
 | Dead / unreachable | scanner + `knip` | `dead-export`, `dead-file`, `unused-import`, `unused-npm-dependency` |
 
-For the full detector catalog, metric definitions, and severity rubric, see [quality-indicators.md](./references/quality-indicators.md).
+Full detector catalog, metric definitions, and severity rubric: [quality-indicators.md](./references/quality-indicators.md).
 
 ### Required output: understanding artifact
 
@@ -260,36 +260,15 @@ Non-trivial tasks follow this arc (recommended, not mandatory): clarify the ques
 
 ## Task shapes
 
-Same working order; emphasis differs:
-
-| Task | Weight on | Notes |
-|------|-----------|-------|
-| **Code understanding** | steps 3–8 (layout → LSP → AST → scoped scanner → read) | Deliverable is the artifact. |
-| **Bug fixing** | Flows + Execution from failing behavior to entry point; adjacent error/retry/contract risk | Fix the smallest layer that solves the root cause; escalate via Smallest-fix vs. safest-fix gate when systemic. |
-| **Refactor** | blast radius (`lspFindReferences`), scoped scan, duplication inventory, then plan | Prefer extracting modules, clarifying contracts, simplifying flows over cosmetic reshuffling. Verify per batch. |
-| **Architecture review** | scanner `--graph` first, then LSP on candidate modules, then read representatives | Report both local and system-level causes. |
-| **RFC / design validation** | map each claim to code ownership; verify flow, contract, and architecture alignment | Mark claims `confirmed|likely|uncertain`; report mismatches as doc or code follow-ups. |
+Same working order; emphasis differs. **Code understanding**: steps 3–8 (layout → LSP → AST → scanner → read), deliverable is the artifact. **Bug fixing**: Flows + Execution from failing behavior inward; fix the smallest responsible layer; escalate at the Smallest-fix gate if systemic. **Refactor**: blast radius first (`lspFindReferences`), then scoped scan + duplication inventory; prefer extracting modules and clarifying contracts over cosmetic reshuffling; verify per batch. **Architecture review**: scanner `--graph` first, then LSP on candidates; report local and system-level causes. **RFC/design validation**: map each claim to code ownership; verify flow, contract, and architecture alignment; mark `confirmed|likely|uncertain`.
 
 ## Before / During / After A Change
 
-Operational actions per phase (investigation substance = lenses + artifact):
-
-### Before
-- Produce the understanding artifact.
-- Map design-doc / RFC claims to concrete code ownership when one exists.
-- Look for an existing local pattern before inventing a new one.
+**Before**: produce the understanding artifact; map RFC/design-doc claims to code ownership; look for an existing pattern before inventing one.
 
-### During
-- Keep edits in the smallest responsible layer; preserve boundaries unless the plan intentionally changes them.
-- Maintain contract/protocol compatibility unless an explicit migration is in scope.
-- If root cause turns out structural mid-task, stop and hit the Smallest-fix vs. safest-fix gate instead of continuing with a cosmetic patch.
+**During**: stay in the smallest responsible layer; preserve contract/protocol compatibility unless migration is in scope; if root cause is structural mid-task, stop at the Smallest-fix vs. safest-fix gate.
 
-### After
-- Run tests, lint, and build/type-check.
-- Re-check changed symbols with LSP after renames/moves; run a scoped scanner pass for non-trivial changes.
-- Run `knip` when the refactor may leave dead artifacts; CSS checks when styles changed.
-- Re-validate the artifact's dimensions against the final implementation; note any remaining architectural risk even if the code now works.
-- Sync docs / RFC sections touched by the change.
+**After**: run tests, lint, build/type-check; re-check changed symbols with LSP; run scoped scanner pass for non-trivial changes; run `knip` if dead artifacts are likely; sync docs/RFC sections the change touches.
 
 ## Confidence Rules
 
@@ -394,8 +373,3 @@ Fallback applies only when an Octocode tool is truly **unavailable** — not reg
 
 **If degraded but completed:** treat the response as valid; on empty/wrong results, retry with a simpler input (drop regex meta-characters, switch to literal search, narrow the path). **Do not** switch to native Claude Code tools — that leaves the skill's evidence model.
 
-## Companion Skill
-
-Pair with the RFC skill when architecture options, trade-offs, or migration strategy need a formal proposal before coding:
-
-- [octocode-rfc-generator](https://skills.sh/bgauryy/octocode-mcp/octocode-rfc-generator) — generate a smart RFC from validated system evidence.

package/skills/octocode-engineer/references/cli-reference.md

@@ -77,17 +77,11 @@ This skill is private (no `bin` entry) — **do not use `npx`**. `npx` applies o
 
 ## Flag Details
 
-`--scope` focuses on specific paths (comma-separated, relative to root). Use `file:symbol` syntax to drill into a specific function or exported variable — only findings whose line range overlaps with that symbol are returned. The full dependency graph is still built so architecture findings involving scoped files are reported. Combinable with `--features`/`--exclude`.
-
-**Symbol scope fallback**: if the scanner cannot resolve a `file:symbol` target (e.g., the symbol name doesn't match an exported function or the file uses patterns that prevent resolution), it falls back to file-level scope and emits a warning: `"symbol scope could not resolve: <path>. Falling back to file-level scope."` If you see this warning, check the exact exported function name and try again, or use file-level scope directly.
-
-`--features` and `--exclude` are mutually exclusive. Both accept pillar names (`architecture`, `code-quality`, `dead-code`, `security`, `test-quality`) and individual category names, comma-separated.
-
-`--semantic` enables TypeChecker + LanguageService analysis (additional categories). Off by default since it adds ~3-5s. Semantic categories require `--semantic` to appear in results.
-
-`--out` changes the output destination. If the path ends with `.json`, writes a single monolithic file (legacy mode). Otherwise, writes to the given directory instead of the default timestamped directory.
-
-`--parser` selects the parse engine: `auto` (default — uses tree-sitter with TS fallback), `typescript` (TS compiler only), or `tree-sitter` (tree-sitter only).
+- **`--scope`**: comma-separated paths relative to root. Use `file:symbol` to drill into a specific exported function — only findings overlapping that symbol are returned; the full dependency graph is still built. If `file:symbol` can't resolve (symbol name mismatch), falls back to file-level scope with a warning — check the exact exported name or switch to file-level scope.
+- **`--features` / `--exclude`**: mutually exclusive. Accept pillar names (`architecture`, `code-quality`, `dead-code`, `security`, `test-quality`) and individual category names, comma-separated.
+- **`--semantic`**: enables TypeChecker + LanguageService analysis (~3-5s overhead). Semantic categories only appear in results when this flag is set.
+- **`--out`**: output destination. Path ending in `.json` → single monolithic file (legacy). Otherwise writes to the given directory instead of the default timestamped directory.
+- **`--parser`**: `auto` (default — tree-sitter with TS fallback), `typescript` (TS compiler only), or `tree-sitter` (tree-sitter only).
 
 ---
 

package/skills/octocode-engineer/references/externals.md

@@ -68,9 +68,7 @@ Declarative rule DSL (`forbidden`/`allowed`/`required`). Scanner has 28 built-in
 
 ```bash
 npx depcruise --no-config --output-type err src/
-npx depcruise --no-config --output-type metrics src/
 npx depcruise --no-config --output-type mermaid src/ > deps.md
-npx depcruise --no-config --output-type mermaid --focus "^src/session" src/
 npx depcruise --no-config --output-type err --affected HEAD src/
 ```
 
@@ -127,10 +125,8 @@ bandit -r <target> -s B101   # skip specific check (e.g. assert)
 ### pytest — Test runner
 
 ```bash
-pytest
 pytest --tb=short -q
 pytest --cov=<package> --cov-report=term-missing
-pytest -x   # stop on first failure
 ```
 
 ---

package/skills/octocode-engineer/references/quality-indicators.md

@@ -91,56 +91,16 @@ The scanner detects quality indicators across 5 pillars: **Architecture**, **Cod
 
 ## New Detector Details
 
-### deep-nesting
-- **Threshold**: `deepNestingThreshold` (default: 5)
-- **Signal**: `max(maxBranchDepth, maxLoopDepth)` per function
-- **Severity mapping**: `≥ threshold+3` → high, `≥ threshold+1` → medium, else → low
-- **Fix strategy**: Guard clauses, early returns, extract to named helpers
-
-### multiple-return-paths
-- **Threshold**: `multipleReturnThreshold` (default: 6)
-- **Signal**: `returns` count per function (includes throw statements)
-- **Severity mapping**: `≥ threshold+4` → high, `≥ threshold+2` → medium, else → low
-- **Fix strategy**: Single result variable, guard clauses for error paths only
-
-### catch-rethrow
-- **Signal**: Catch blocks containing a throw statement — candidates for simplification (may include other statements alongside the rethrow)
-- **Severity**: Always low (noise reduction)
-- **Fix strategy**: Remove the try-catch if only rethrowing, or add logging/wrapping before re-throw
-
-### magic-string
-- **Threshold**: `magicStringMinOccurrences` (default: 3)
-- **Signal**: String literals used in `===`, `!==`, `==`, `!=` comparisons or `case` clauses, appearing ≥ threshold times
-- **Severity mapping**: `≥ 8` → high, `≥ 5` → medium, else → low
-- **Fix strategy**: Extract to named constant or enum
-
-### boolean-parameter-cluster
-- **Threshold**: `booleanParamThreshold` (default: 3)
-- **Signal**: Functions with ≥ threshold parameters typed as `boolean`
-- **Severity**: Always medium
-- **Fix strategy**: Replace with options object or split into separate functions
-
-### promise-all-unhandled
-- **Signal**: `Promise.all/allSettled/race/any` calls without surrounding try-catch or `.catch()` chain
-- **Severity**: Always medium
-- **Fix strategy**: Wrap in try-catch or chain `.catch()`
-
-### export-surface-density
-- **Signal**: `exportCount / totalStatements` ratio ≥ 0.5 (modules with ≥ 20 statements)
-- **Severity mapping**: `≥ 80%` → high, `≥ 60%` → medium, else → low
-- **Fix strategy**: Make non-essential symbols private, split into facade + implementation
-
-### change-risk (composite)
-- **Signal**: Weighted sum of overlapping quality problems in a single file
-- **Components scored**:
-  - High average complexity → +2
-  - High cognitive complexity → +2
-  - Low maintainability functions → +count
-  - Empty catches → +1
-  - Unhandled promise combinators → +1
-  - Excessive exports (>15) → +1
-- **Threshold**: Score ≥ 4 triggers finding
-- **Severity mapping**: `≥ 8` → critical, `≥ 6` → high, else → medium
+| Category | Threshold flag (default) | Signal | Severity | Fix |
+|----------|--------------------------|--------|----------|-----|
+| `deep-nesting` | `--deep-nesting-threshold N` (5) | `max(maxBranchDepth, maxLoopDepth)` per fn | `≥T+3`→high, `≥T+1`→med, else low | Guard clauses, early returns, extract helpers |
+| `multiple-return-paths` | `--multiple-return-threshold N` (6) | return/throw count per fn | `≥T+4`→high, `≥T+2`→med, else low | Single result var; guard clauses for error paths |
+| `catch-rethrow` | — | catch containing a throw (simplification candidates) | always low | Remove try-catch if only re-throwing, or add logging before re-throw |
+| `magic-string` | `--magic-string-min-occurrences N` (3) | string literals in `===`/`!==`/`case` appearing ≥N times | `≥8`→high, `≥5`→med, else low | Extract to named constant or enum |
+| `boolean-parameter-cluster` | `--boolean-param-threshold N` (3) | fns with ≥N `boolean` params | always medium | Options object or split into separate fns |
+| `promise-all-unhandled` | — | `Promise.all/allSettled/race/any` without try-catch or `.catch()` | always medium | Wrap in try-catch or chain `.catch()` |
+| `export-surface-density` | — | `exportCount / totalStatements ≥ 0.5` (files with ≥20 stmts) | `≥80%`→high, `≥60%`→med, else low | Make non-essential symbols private; split facade + impl |
+| `change-risk` | — | weighted sum: complexity+2, cognitive+2, low-MI+count, empty-catch+1, unhandled-promise+1, exports>15+1; fires at ≥4 | `≥8`→critical, `≥6`→high, else med | Fix overlapping quality signals in the file |
 
 ---
 

package/skills/octocode-engineer/references/tool-workflows.md

@@ -49,16 +49,13 @@ Trace a function: definition → callers → callees.
 5. **Find callers** — incoming call hierarchy → who depends on this?
 6. **Find callees** — outgoing call hierarchy → what does this depend on?
 
-### 3 — Impact Analysis (Pre-Refactor)
+### 3 — Impact Analysis (Quick Blast Radius)
 
-Assess blast radius before changing a symbol.
+Fast pre-change check. For a full refactoring plan with coupling and cycle analysis, use [Workflow 12](#12--refactoring-plan-safe-restructure).
 
-1. **Map structural imports** — AST search for import patterns involving the symbol
-2. **Locate the symbol** — text search to get file + lineHint
-3. **Count all consumers** — find references, excluding declaration
-4. **Count test consumers** — find references filtered to test directories only
-5. **Count production consumers** — find references excluding test directories
-6. **Assess safety** — few production refs + high test coverage = safe to change. Many production refs = plan carefully, consider incremental migration.
+1. **Locate the symbol** — text search to get file + lineHint
+2. **Count all consumers** — find references, excluding declaration; split test vs production
+3. **Assess safety** — few production refs + high test coverage = safe to change. Many refs = plan carefully → Workflow 12.
 
 ### 4 — Dead Export Validation
 
@@ -162,17 +159,17 @@ Before writing new code, understand the existing landscape to pick the right loc
 
 ### 12 — Refactoring Plan (Safe Restructure)
 
-Plan a multi-file refactor with full blast radius awareness.
+Full blast-radius refactoring plan. Use when Workflow 3 (quick check) reveals high consumer count or cross-package scope.
 
 1. **Map all files containing the symbol** — text search with file-list mode
 2. **Count all consumers** — find references excluding declaration
-3. **Split test vs production consumers** — find references with include/exclude patterns for test dirs
-4. **Map callers and dependencies** — incoming and outgoing call hierarchy
-5. **Check import graph** — AST search for import patterns in the target area
+3. **Split test vs production consumers** — find references filtered to test dirs; 0 test refs = coverage risk
+4. **Map structural imports** — AST search for import patterns involving the symbol
+5. **Map callers and dependencies** — incoming and outgoing call hierarchy
 6. **Check coupling/cycle risk** — scoped scan with architecture + graph features
 7. **Assess test quality around target** — scoped scan with test-quality feature
 
-**Output**: file list + consumer count + test coverage + coupling risk = refactoring confidence level.
+**Output**: file list + consumer count (test/prod split) + import graph + coupling risk = refactoring confidence level.
 
 ### 13 — Codebase Exploration (New Repo Orientation)
 

package/skills/octocode-engineer/src/analysis/dependency-summary.test.ts

@@ -117,7 +117,7 @@ describe('buildDependencySummary', () => {
   it('detects test-only modules (no production imports, only test imports)', () => {
     const state = makeDependencyState();
     addEdges(state, [
-      ['src/foo.test.ts', 'src/helper.ts', true], // test imports helper
+      ['src/foo.test.ts', 'src/helper.ts', true],
     ]);
     const criticality = new Map<string, FileCriticality>();
     const summary = buildDependencySummary(state, criticality, DEFAULT_OPTS);
@@ -129,7 +129,7 @@ describe('buildDependencySummary', () => {
   it('excludes test files from test-only modules list', () => {
     const state = makeDependencyState();
     addEdges(state, [
-      ['src/foo.test.ts', 'src/bar.test.ts', true], // test imports test
+      ['src/foo.test.ts', 'src/bar.test.ts', true],
     ]);
     const criticality = new Map<string, FileCriticality>();
     const summary = buildDependencySummary(state, criticality, DEFAULT_OPTS);

package/skills/octocode-engineer/src/ast/metrics.test.ts

@@ -150,14 +150,14 @@ describe('collectMetrics', () => {
     const sf = parse('function foo() { if (a && b) {} }');
     const fn = firstFn(sf);
     const m = collectMetrics(fn);
-    expect(m.complexity).toBe(3); // 1 base + 1 if + 1 &&
+    expect(m.complexity).toBe(3);
   });
 
   it('logical || → complexity+1', () => {
     const sf = parse('function foo() { if (a || b) {} }');
     const fn = firstFn(sf);
     const m = collectMetrics(fn);
-    expect(m.complexity).toBe(3); // 1 base + 1 if + 1 ||
+    expect(m.complexity).toBe(3);
   });
 
   it('for-in loop → loops 1', () => {

package/skills/octocode-engineer/src/ast/search-main.ts

@@ -1,12 +1,5 @@
 #!/usr/bin/env node
-/**
- * AST-aware structural code search powered by @ast-grep/napi.
- *
- * Usage:
- *   node scripts/ast/search.js --pattern 'console.log($$$ARGS)' --root ./src
- *   node scripts/ast/search.js --preset empty-catch --root ./packages
- *   node scripts/ast/search.js --kind function_declaration --root ./src --json
- */
+
 
 import fs from 'node:fs';
 import { createRequire } from 'node:module';
@@ -16,10 +9,6 @@ import { ALLOWED_EXTS, isPythonFile } from '../types/index.js';
 
 import type { NapiConfig, SgNode, SgRoot } from '@ast-grep/napi';
 
-// Require (not static-import) @ast-grep/napi so the resolution happens when this
-// module is first evaluated — not when the outer bundle loads. The entry at
-// src/ast/search.ts runs the dependency bootstrap before dynamic-importing this
-// module, so by the time this line executes the native addon is present.
 const nodeRequire = createRequire(import.meta.url);
 const astGrep = nodeRequire('@ast-grep/napi') as typeof import('@ast-grep/napi');
 const {
@@ -75,7 +64,7 @@ export interface AstSearchResult {
   totalMatches: number;
   totalFiles: number;
   matches: AstMatch[];
-  /** Source lines keyed by relative file path — only populated when context > 0 */
+  
   _sourceByFile?: Map<string, string[]>;
 }
 
@@ -272,7 +261,6 @@ export const PRESETS: Record<string, PresetRule> = {
     description: 'Variable declarations without call expressions (candidates for dead code)',
   },
 
-  // ── Python presets ──────────────────────────────────────────────
   'py-bare-except': {
     rule: {
       kind: 'except_clause',
@@ -846,4 +834,3 @@ export async function main(): Promise<void> {
 }
 
 export { ensurePythonRegistered };
-// Direct execution lives in ./search.ts; this file is an internal module.