octocode-cli 1.2.7 → 1.2.9

package/skills/octocode-engineer/scripts/ast/search.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+import b from"node:fs";import f from"node:path";import{js as M,ts as N,tsx as E}from"@ast-grep/napi";import w from"node:path";import{fileURLToPath as A}from"node:url";function T(t,e=process.argv[1]){return e?A(t)===w.resolve(e):!1}import R from"node:path";import*as u from"typescript";var k={couplingThreshold:15,fanInThreshold:20,fanOutThreshold:15,godModuleStatements:500,godModuleExports:20,barrelSymbolThreshold:30,sdpMinDelta:.15,sdpMaxSourceInstability:.6,layerOrder:[],minFunctionStatements:6,minFlowStatements:6,criticalComplexityThreshold:30,godFunctionStatements:100,godFunctionMiThreshold:10,cognitiveComplexityThreshold:15,parameterThreshold:5,halsteadEffortThreshold:5e5,maintainabilityIndexThreshold:20,anyThreshold:5,flowDupThreshold:3,similarityThreshold:.85,deepNestingThreshold:5,multipleReturnThreshold:6,magicStringMinOccurrences:3,booleanParamThreshold:3,overrideChainThreshold:3,shotgunThreshold:8,secretEntropyThreshold:4.5,secretMinLength:20,mockThreshold:10},O={root:process.cwd(),out:null,json:!1,packageRoot:R.join(process.cwd(),"packages"),parser:"auto",includeTests:!1,emitTree:!0,treeDepth:4,noCache:!1,clearCache:!1,semantic:!1,graph:!1,graphAdvanced:!1,flow:!1,scope:null,scopeSymbols:null,features:null,ignoreDirs:new Set([".git",".next",".yarn",".cache",".octocode","node_modules","dist","coverage","out"]),findingsLimit:1/0,noDiversify:!1,maxRecsPerCategory:2,deepLinkTopN:12,thresholds:{...k},affected:null,saveBaseline:!1,ignoreKnown:null,reporter:"default",focus:null,focusDepth:1,collapse:null,atLeast:null,configFile:null},_={architecture:["dependency-cycle","dependency-critical-path","dependency-test-only","architecture-sdp-violation","high-coupling","god-module-coupling","orphan-module","unreachable-module","layer-violation","low-cohesion","mega-folder","distance-from-main-sequence","feature-envy","untested-critical-code","over-abstraction","concrete-dependency","circular-type-dependency","shotgun-surgery","import-side-effect-risk","cycle-cluster","broker-module","bridge-module","package-boundary-chatter","startup-risk-hub","namespace-import","commonjs-in-esm","export-star-leak","mixed-module-format"],"code-quality":["duplicate-function-body","duplicate-flow-structure","function-optimization","cognitive-complexity","god-module","god-function","halstead-effort","low-maintainability","excessive-parameters","unsafe-any","empty-catch","switch-no-default","unused-parameter","deep-override-chain","interface-compliance","type-assertion-escape","promise-misuse","narrowable-type","missing-error-boundary","await-in-loop","sync-io","uncleared-timer","listener-leak-risk","unbounded-collection","similar-function-body","message-chain","deep-nesting","multiple-return-paths","catch-rethrow","magic-string","boolean-parameter-cluster","promise-all-unhandled","export-surface-density","change-risk"],"dead-code":["dead-export","dead-re-export","re-export-duplication","re-export-shadowed","unused-npm-dependency","package-boundary-violation","barrel-explosion","unused-import","orphan-implementation","move-to-caller","semantic-dead-export","dead-file"],security:["hardcoded-secret","eval-usage","unsafe-html","sql-injection-risk","unsafe-regex","prototype-pollution-risk","unvalidated-input-sink","input-passthrough-risk","path-traversal-risk","command-injection-risk","debug-log-leakage","sensitive-data-logging"],"test-quality":["low-assertion-density","test-no-assertion","excessive-mocking","shared-mutable-state","missing-test-cleanup","focused-test","fake-timer-no-restore","missing-mock-restoration"]},$=new Set(Object.values(_).flat());var x=new Set([".ts",".tsx",".js",".jsx",".mjs",".cjs"]);var j=new Set([u.SyntaxKind.IfStatement,u.SyntaxKind.SwitchStatement,u.SyntaxKind.TryStatement,u.SyntaxKind.ForStatement,u.SyntaxKind.WhileStatement,u.SyntaxKind.DoStatement,u.SyntaxKind.ForOfStatement,u.SyntaxKind.ForInStatement,u.SyntaxKind.ConditionalExpression]);var y={"empty-catch":{rule:{kind:"catch_clause",has:{kind:"statement_block",regex:"^\\{\\s*\\}$"}},description:"Empty catch blocks that silently swallow errors"},"console-log":{rule:{pattern:"console.log($$$ARGS)"},description:"console.log calls left in production code"},"console-any":{rule:{pattern:"console.$METHOD($$$ARGS)"},description:"Any console method call (log, warn, error, debug, etc.)"},debugger:{rule:{kind:"debugger_statement"},description:"Debugger statements left in code"},"todo-fixme":{rule:{kind:"comment",regex:"(?i)(TODO|FIXME|HACK|XXX|BUG)"},description:"TODO, FIXME, HACK, XXX, BUG comments"},"any-type":{rule:{kind:"predefined_type",regex:"^any$"},description:"Explicit `any` type annotations"},"type-assertion":{rule:{kind:"as_expression"},description:"TypeScript type assertions (as X)"},"non-null-assertion":{rule:{kind:"non_null_expression"},description:"Non-null assertions (x!)"},"fat-arrow-body":{rule:{kind:"arrow_function",has:{kind:"statement_block"}},description:"Arrow functions with statement block bodies (could be expression)"},"nested-ternary":{rule:{kind:"ternary_expression",has:{kind:"ternary_expression",stopBy:"end"}},description:"Nested ternary expressions (hard to read)"},"throw-string":{rule:{kind:"throw_statement",has:{kind:"string"}},description:"Throwing string literals instead of Error objects"},"switch-no-default":{rule:{kind:"switch_statement",not:{has:{kind:"switch_default",stopBy:"end"}}},description:"Switch statements without a default case"},"class-declaration":{rule:{kind:"class_declaration"},description:"All class declarations"},"async-function":{rule:{kind:"function_declaration",regex:"^async "},description:"Async function declarations"},"export-default":{rule:{kind:"export_statement",has:{field:"default"}},description:"Default exports"},"import-star":{rule:{kind:"import_statement",has:{kind:"namespace_import"}},description:"Namespace imports (import * as X)"},"catch-rethrow":{rule:{kind:"catch_clause",has:{kind:"statement_block",has:{kind:"throw_statement"}}},description:"Catch blocks that only re-throw the caught error"},"promise-all":{rule:{pattern:"Promise.all($$$ARGS)"},description:"Promise.all calls (check for missing error handling)"},"boolean-param":{rule:{kind:"type_annotation",has:{kind:"predefined_type",regex:"^boolean$"}},description:"Function parameters typed as boolean"},"magic-number":{rule:{kind:"number",not:{regex:"^[01]$"}},description:"Numeric literals (excluding 0 and 1) \u2014 potential magic numbers"},"deep-callback":{rule:{kind:"arrow_function",inside:{kind:"arrow_function",inside:{kind:"arrow_function",stopBy:"end"},stopBy:"end"}},description:"Deeply nested arrow function callbacks (3+ levels)"},"unused-var":{rule:{kind:"variable_declarator",not:{has:{kind:"call_expression",stopBy:"end"}}},description:"Variable declarations without call expressions (candidates for dead code)"}};function C(t){let e=f.basename(t);return/\.(test|spec)\.(ts|tsx|js|jsx|mjs|cjs)$/.test(e)||e.startsWith("test_")||t.includes("__tests__")}function F(t,e){let i=[],r=n=>{let o;try{o=b.readdirSync(n,{withFileTypes:!0})}catch{return}o.sort((a,s)=>a.name.localeCompare(s.name));for(let a of o){if(e.ignoreDirs.has(a.name)||a.isSymbolicLink())continue;let s=f.join(n,a.name);if(a.isDirectory()){r(s);continue}if(!a.isFile()||a.name.endsWith(".d.ts"))continue;let c=f.extname(a.name);x.has(c)&&(!e.includeTests&&C(s)||i.push(s))}};return r(t),i}function v(t){switch(t){case".tsx":return E;case".jsx":return E;case".js":case".mjs":case".cjs":return M;default:return N}}function L(t,e){let i={},r,n=/\$\$\$([A-Z_][A-Z0-9_]*)/g,o=new Set;for(;(r=n.exec(e))!==null;){let s=r[1];o.add(s);let c=t.getMultipleMatches(s);c.length>0&&(i[`$$$${s}`]=c.map(d=>d.text()).join(", "))}let a=/(?<!\$)\$([A-Z_][A-Z0-9_]*)(?!\$)/g;for(;(r=a.exec(e))!==null;){let s=r[1];if(o.has(s))continue;let c=t.getMatch(s);c&&(i[`$${s}`]=c.text())}return i}function D(t,e,i){let r=t.range(),n={file:e,kind:String(t.kind()),text:t.text(),lineStart:r.start.line+1,lineEnd:r.end.line+1,columnStart:r.start.column,columnEnd:r.end.column};if(i){let o=L(t,i);Object.keys(o).length>0&&(n.metaVariables=o)}return n}function P(t,e,i,r,n){let o=f.extname(t),a=v(o),s;try{s=a.parse(e).root().findAll(i)}catch{return[]}let c=[];for(let d of s){if(c.length>=n)break;c.push(D(d,t,r))}return c}function I(t,e,i){let r,n,o,a=null;if(e.preset){let l=y[e.preset];if(!l){let p=Object.keys(y).join(", ");throw new Error(`Unknown preset: "${e.preset}". Available: ${p}`)}r=l,n=`preset:${e.preset} \u2014 ${l.description}`,o="preset"}else if(e.rule)r=e.rule,n=`rule:${JSON.stringify(e.rule)}`,o="rule";else if(e.kind)r={rule:{kind:e.kind}},n=`kind:${e.kind}`,o="kind";else if(e.pattern)r=e.pattern,a=e.pattern,n=`pattern:${e.pattern}`,o="pattern";else throw new Error("Must provide --pattern, --kind, --preset, or --rule");let s=[],c=new Set,d=e.context>0?new Map:void 0;for(let l of t){if(s.length>=e.limit)break;let p;try{p=b.readFileSync(l,"utf8")}catch{continue}let h=f.relative(i,l),g=e.limit-s.length,S=P(h,p,r,a,g);S.length>0&&(c.add(h),s.push(...S),d&&d.set(h,p.split(`
+`)))}let m={query:n,queryType:o,totalMatches:s.length,totalFiles:c.size,matches:s};return d&&(m._sourceByFile=d),m}function G(t){let e={root:process.cwd(),pattern:null,kind:null,preset:null,rule:null,json:!1,limit:500,includeTests:!1,ignoreDirs:new Set([".git",".next",".yarn",".cache",".octocode","node_modules","dist","coverage","out"]),context:0},i=!1;for(let r=0;r<t.length;r++){let n=t[r];if(n==="--pattern"||n==="-p"){e.pattern=t[++r];continue}if(n.startsWith("--pattern=")){e.pattern=n.slice(10);continue}if(n==="--kind"||n==="-k"){e.kind=t[++r];continue}if(n.startsWith("--kind=")){e.kind=n.slice(7);continue}if(n==="--preset"){e.preset=t[++r];continue}if(n.startsWith("--preset=")){e.preset=n.slice(9);continue}if(n==="--rule"){let o=t[++r];try{e.rule=JSON.parse(o)}catch{throw new Error(`Invalid --rule JSON: ${o?.slice(0,100)??"(empty)"}`)}continue}if(n==="--root"){e.root=f.resolve(t[++r]);continue}if(n.startsWith("--root=")){e.root=f.resolve(n.slice(7));continue}if(n==="--json"){e.json=!0;continue}if(n==="--limit"){e.limit=parseInt(t[++r],10);continue}if(n==="--include-tests"){e.includeTests=!0;continue}if(n==="--context"||n==="-C"){e.context=parseInt(t[++r],10);continue}if(n==="--list-presets"){i=!0;continue}(n==="--help"||n==="-h")&&(B(),process.exit(0))}return Number.isNaN(e.limit)&&(e.limit=500),Number.isNaN(e.context)&&(e.context=0),{opts:e,listPresets:i}}function B(){console.log(`
+ast-search \u2014 Structural code search powered by ast-grep
+
+Usage:
+  node scripts/ast/search.js [options]
+
+Search modes (pick one):
+  --pattern, -p <code>     Match code structurally (e.g. 'console.log($$$ARGS)')
+  --kind, -k <kind>        Match AST node kind (e.g. 'function_declaration')
+  --preset <name>          Use a built-in search preset (e.g. 'empty-catch')
+  --rule <json>            Raw ast-grep rule object as JSON
+
+Options:
+  --root <path>            Search root directory (default: cwd)
+  --json                   Output as JSON
+  --limit N                Max matches (default: 500)
+  --include-tests          Include test files
+  --context, -C N          Lines of context around matches (text output only)
+  --list-presets           Show available presets and exit
+  --help, -h               Show this message
+
+Pattern wildcards:
+  $NAME                    Match any single AST node
+  $$$NAME                  Match zero or more nodes (variadic)
+
+Examples:
+  node scripts/ast/search.js -p 'console.log($$$ARGS)' --root ./src
+  node scripts/ast/search.js --preset empty-catch --root ./packages
+  node scripts/ast/search.js -k function_declaration --json --limit 20
+  node scripts/ast/search.js --preset todo-fixme --include-tests
+  node scripts/ast/search.js -p 'if ($COND) { return $VAL }' --root ./src
+  node scripts/ast/search.js --rule '{"rule":{"kind":"catch_clause"}}' --root ./src
+
+Presets:
+${Object.entries(y).map(([t,e])=>`  ${t.padEnd(22)} ${e.description}`).join(`
+`)}
+`)}function K(t,e,i){let r=[];r.push(`
+\u{1F50D} ${t.query}`),r.push(`   ${t.totalMatches} matches across ${t.totalFiles} files
+`);let n=e.context,o=t._sourceByFile,a="";for(let s of t.matches){if(s.file!==a&&(a=s.file,r.push(`
+\u2500\u2500 ${a} \u2500\u2500`)),n>0&&o){let m=o.get(s.file);if(m){let l=Math.max(0,s.lineStart-1-n),p=Math.min(m.length,s.lineEnd+n);for(let h=l;h<p;h++){let g=h+1,S=g>=s.lineStart&&g<=s.lineEnd?">":" ";r.push(`  ${S} ${String(g).padStart(4)} | ${m[h]}`)}r.push("");continue}}let d=(s.text.length>200?s.text.slice(0,200)+"\u2026":s.text).replace(/\n/g,"\u21B5").replace(/\s+/g," ");if(r.push(`  L${s.lineStart}:${s.columnStart}  [${s.kind}]  ${d}`),s.metaVariables&&Object.keys(s.metaVariables).length>0)for(let[m,l]of Object.entries(s.metaVariables)){let p=l.length>80?l.slice(0,80)+"\u2026":l;r.push(`    ${m} = ${p}`)}}return r.push(""),r.join(`
+`)}async function X(){let{opts:t,listPresets:e}=G(process.argv.slice(2));if(e){if(t.json)console.log(JSON.stringify(y));else{console.log(`
+Available presets:
+`);for(let[n,o]of Object.entries(y))console.log(`  ${n.padEnd(22)} ${o.description}`);console.log("")}return}!t.pattern&&!t.kind&&!t.preset&&!t.rule&&(console.error("Error: Must provide --pattern, --kind, --preset, or --rule"),console.error("Run with --help for usage information."),process.exit(1));let i=F(t.root,t);i.length===0&&(console.error(`No files found in ${t.root}`),process.exit(1));let r=I(i,t,t.root);t.json?console.log(JSON.stringify(r)):console.log(K(r,t,t.root))}T(import.meta.url)&&X().catch(t=>{console.error(t),process.exit(1)});export{y as PRESETS,F as collectSearchFiles,K as formatTextOutput,G as parseSearchArgs,I as runSearch,P as searchFile};

package/skills/octocode-engineer/scripts/ast/tree-search.js

@@ -0,0 +1,27 @@
+#!/usr/bin/env node
+import a from"node:fs";import x from"node:path";import w from"node:path";import{fileURLToPath as F}from"node:url";function b(e,t=process.argv[1]){return t?F(e)===w.resolve(t):!1}function R(){console.log(`
+ast-tree-search \u2014 Search generated ast-trees.txt output
+
+Usage:
+  node scripts/ast/tree-search.js [options]
+
+Options:
+  --input, -i <path>       Path to ast-trees.txt, a scan directory, or .octocode/scan (default: .octocode/scan)
+  --pattern, -p <regex>    Regex to match against AST tree lines
+  --kind, -k <kind>        Match a node kind (supports snake_case or PascalCase)
+  --file <regex>           Filter matches to section file paths that match the regex
+  --section <regex>        Filter matches to section headers that match the regex
+  --limit <n>              Max matches to return (default: 50, 0 = all)
+  --context, -C <n>        Context lines around each match (default: 0)
+  --json                   Output matches as JSON
+  --ignore-case            Case-insensitive pattern matching
+  --help, -h               Show this message
+
+Examples:
+  node scripts/ast/tree-search.js -i .octocode/scan -k function_declaration --limit 25
+  node scripts/ast/tree-search.js -i .octocode/scan/2026-03-18T23-43-21-490Z -k ClassDeclaration --file 'src/index'
+  node scripts/ast/tree-search.js -i .octocode/scan -p 'IfStatement|SwitchStatement' --section 'src/'
+`)}function u(e,t,s){let i=e.indexOf("=");return i!==-1?{value:e.slice(i+1),nextIndex:s}:{value:t[s+1]||"",nextIndex:s+1}}function y(e){let t={input:".octocode/scan",pattern:null,kind:null,context:0,json:!1,ignoreCase:!1,limit:50,file:null,section:null},s=!1;for(let i=0;i<e.length;i+=1){let n=e[i];if(n==="--json"){t.json=!0;continue}if(n==="--ignore-case"){t.ignoreCase=!0;continue}if(n==="--help"||n==="-h"){s=!0;continue}if(n==="--input"||n==="-i"||n.startsWith("--input=")){let r=u(n,e,i);t.input=r.value,i=r.nextIndex;continue}if(n==="--pattern"||n==="-p"||n.startsWith("--pattern=")){let r=u(n,e,i);t.pattern=r.value,i=r.nextIndex;continue}if(n==="--kind"||n==="-k"||n.startsWith("--kind=")){let r=u(n,e,i);t.kind=r.value,i=r.nextIndex;continue}if(n==="--file"||n.startsWith("--file=")){let r=u(n,e,i);t.file=r.value,i=r.nextIndex;continue}if(n==="--section"||n.startsWith("--section=")){let r=u(n,e,i);t.section=r.value,i=r.nextIndex;continue}if(n==="--limit"||n.startsWith("--limit=")){let r=u(n,e,i),o=Number.parseInt(r.value,10);t.limit=Number.isFinite(o)?o:50,i=r.nextIndex;continue}if(n==="--context"||n==="-C"||n.startsWith("--context=")){let r=u(n,e,i),o=Number.parseInt(r.value,10);t.context=Number.isFinite(o)?o:0,i=r.nextIndex;continue}throw new Error(`Unknown argument: ${n}`)}return{opts:t,showHelp:s}}function v(e){if(!e.pattern&&!e.kind)throw new Error("Must provide --pattern or --kind");if(!Number.isFinite(e.context)||e.context<0)throw new Error("--context must be a non-negative integer");if(!Number.isFinite(e.limit)||e.limit<0)throw new Error("--limit must be a non-negative integer")}function N(e){return e.replace(/([a-z0-9])([A-Z])/g,"$1_$2").replace(/[-\s]+/g,"_").toLowerCase()}function C(e){return e.split("_").filter(Boolean).map(t=>t.charAt(0).toUpperCase()+t.slice(1)).join("")}function A(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}function g(e,t,s){if(!e)return null;try{return new RegExp(e,t)}catch(i){throw new Error(`Invalid ${s} regex: ${i.message}`)}}function j(e){let s=e.indexOf(" \u2014 ");return s===-1?null:e.slice(s+3).trim()||null}function q(e){let t=x.resolve(e);if(!a.existsSync(t))throw new Error(`Input does not exist: ${t}`);if(a.statSync(t).isFile())return{requestedInput:t,inputFile:t,selectionMode:"direct-file"};let i=x.join(t,"ast-trees.txt");if(a.existsSync(i)&&a.statSync(i).isFile())return{requestedInput:t,inputFile:i,selectionMode:"scan-dir"};let n=a.readdirSync(t,{withFileTypes:!0}).filter(r=>r.isDirectory()).map(r=>x.join(t,r.name,"ast-trees.txt")).filter(r=>a.existsSync(r)&&a.statSync(r).isFile()).sort((r,o)=>a.statSync(o).mtimeMs-a.statSync(r).mtimeMs);if(n.length===0)throw new Error(`No ast-trees.txt found under: ${t}`);return{requestedInput:t,inputFile:n[0],selectionMode:"latest-scan"}}function E(e,t){let s=t.ignoreCase?"i":"",i=g(t.pattern,s,"pattern"),n=g(t.file,s,"file"),r=g(t.section,s,"section"),o=null;if(t.kind){let c=N(t.kind),l=C(c);o=new RegExp(`\\b(?:${A(c)}|${A(l)})\\b`,s)}let p=a.readFileSync(e.inputFile,"utf8").split(/\r?\n/),h=[],f="",d=null;for(let c=0;c<p.length;c+=1){let l=p[c];if(l.startsWith("## ")&&(f=l.slice(3).trim(),d=j(f)),i&&!i.test(l)||o&&!o.test(l)||r&&!r.test(f)||n&&!n.test(d??""))continue;let S=Math.max(0,c-t.context),T=Math.min(p.length,c+t.context+1);h.push({section:f,file:d,lineNumber:c+1,line:l,context:p.slice(S,T).map((k,I)=>({lineNumber:S+I+1,line:k}))})}let m=t.limit===0?h:h.slice(0,t.limit),$=new Set(h.map(c=>c.file).filter(Boolean)).size,M=[t.kind?`kind=${t.kind}`:null,t.pattern?`pattern=${t.pattern}`:null,t.file?`file=${t.file}`:null,t.section?`section=${t.section}`:null].filter(Boolean);return{requestedInput:e.requestedInput,inputFile:e.inputFile,selectionMode:e.selectionMode,query:M.join(", "),limit:t.limit,totalMatches:h.length,returnedMatches:m.length,truncated:m.length<h.length,uniqueFiles:$,matches:m}}function O(e,t){let s=[];s.push(`
+AST tree search: ${e.query}`),s.push(`Requested input: ${e.requestedInput}`),s.push(`Selected AST file: ${e.inputFile} (${e.selectionMode})`),s.push(`Matches: ${e.totalMatches} total, showing ${e.returnedMatches}${e.truncated?` (limit ${e.limit})`:""}`),s.push(`Matched files: ${e.uniqueFiles}
+`);let i="";for(let n of e.matches){if(n.section!==i&&(i=n.section,s.push(`-- ${i||"(no section)"} --`)),t.context>0){for(let o of n.context){let p=o.lineNumber===n.lineNumber?">":" ";s.push(` ${p} ${String(o.lineNumber).padStart(4)} | ${o.line}`)}s.push("");continue}let r=n.file?` (${n.file})`:"";s.push(`  L${n.lineNumber}${r}  ${n.line}`)}return e.totalMatches===0&&s.push("No matches found."),s.push(""),s.join(`
+`)}async function L(){try{let{opts:e,showHelp:t}=y(process.argv.slice(2));if(t){R();return}v(e);let s=q(e.input),i=E(s,e);if(e.json){console.log(JSON.stringify(i,null,2));return}console.log(O(i,e))}catch(e){console.error(e.message),process.exit(1)}}b(import.meta.url)&&L();export{O as formatAstTreeSearchOutput,y as parseAstTreeSearchArgs,q as resolveAstTreeInput,E as searchAstTree,v as validateAstTreeSearchOptions};