octocode-cli 1.5.1 → 1.5.3

package/out/chunks/chunk-UCZCF3BQ.js

@@ -1,9 +0,0 @@
-#!/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 r}from"./chunk-V64AXUWB.js";var i=new Set;function e(){process.stdout.write("\x1B[?25h")}var o=!1;function l(){o||(o=!0,process.on("exit",e),process.on("SIGINT",()=>{e(),process.exit(0)}),process.on("SIGTERM",()=>{e(),process.exit(0)}),process.on("uncaughtException",n=>{e(),console.error("Uncaught exception:",n),process.exit(1)}))}var h=class{text;frames;i;timer;constructor(t=""){this.text=t,this.frames=["\u280B","\u2819","\u2839","\u2838","\u283C","\u2834","\u2826","\u2827","\u2807","\u280F"],this.i=0,this.timer=null}start(t,s=0){t&&(this.text=t),this.timer&&(clearInterval(this.timer),this.timer=null),l(),i.add(this),process.stdout.write("\x1B[?25l");let u=" ".repeat(s);return this.timer=setInterval(()=>{let c=this.frames[this.i++%this.frames.length];process.stdout.write(`\r${u}${r("cyan",c)} ${this.text}`)},80),this}clear(){return this.timer&&(clearInterval(this.timer),this.timer=null),i.delete(this),process.stdout.write("\r\x1B[2K"),process.stdout.write("\x1B[?25h"),this}stop(t="\u2713",s="green"){return this.timer&&(clearInterval(this.timer),this.timer=null),i.delete(this),process.stdout.write(`\r\x1B[2K${r(s,t)} ${this.text}
-`),process.stdout.write("\x1B[?25h"),this}succeed(t){return t&&(this.text=t),this.stop("\u2713","green")}fail(t){return t&&(this.text=t),this.stop("\u2717","red")}info(t){return t&&(this.text=t),this.stop("\u2139","blue")}warn(t){return t&&(this.text=t),this.stop("\u26A0","yellow")}update(t){return this.text=t,this}};export{h as a};

package/out/chunks/commands-XBFPLHSQ.js

@@ -1,8 +0,0 @@
-#!/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-OQBJTZWK.js";import"./chunk-UCZCF3BQ.js";import"./chunk-CVNNNSMQ.js";import"./chunk-7476PETK.js";import"./chunk-V64AXUWB.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/main-help-ULF5PAQY.js

@@ -1,10 +0,0 @@
-#!/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 l,d as r}from"./chunk-7476PETK.js";import{a as o,b as e,c as t}from"./chunk-V64AXUWB.js";import"./chunk-YBBF4DTY.js";function $(){let n=[];for(let c of i){let a=l.filter(s=>r(s.name)===c);if(a.length!==0){n.push(`    ${t(c)}`);for(let s of a)n.push(`    ${o("cyan",s.name)}`)}}return n}function d(){let n=$(),c=l.length,a=["",`  ${o("magenta",e("\u{1F50D}\u{1F419} Octocode CLI"))}`,"",`  ${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")}           Install/remove bundled 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("TOOLS")}  ${t(`(${c} tools \u2014 run directly from terminal)`)}`,...n,"",`  ${e("OPTIONS")}`,`    ${o("cyan","--json")}            Raw JSON output`,`    ${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 install --targets claude-code,cursor")}`,"",o("magenta",`  \u2500\u2500\u2500 \u{1F50D}\u{1F419} ${e("https://octocode.ai")} \u2500\u2500\u2500`),""];process.stdout.write(`${a.join(`
-`)}
-`)}export{d as showHelp};

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

@@ -1,8 +0,0 @@
-#!/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-7476PETK.js";import"./chunk-V64AXUWB.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/skills/octocode-research/AGENTS.md

@@ -1,349 +0,0 @@
-# Octocode Research Skill - Agent Development Guide
-
-> HTTP API server wrapping `octocode-mcp` tools for code research at `localhost:1987` by default (configurable via `OCTOCODE_RESEARCH_HOST` / `OCTOCODE_RESEARCH_PORT`)
-
-## Project Overview
-
-| Attribute | Value |
-|-----------|-------|
-| **Type** | Express.js HTTP Server |
-| **Host** | localhost (default) |
-| **Port** | 1987 (default) |
-| **Package** | `octocode-research` |
-| **Version** | 2.0.0 |
-| **Main Dependency** | `octocode-mcp` |
-
----
-
-## Quick Commands
-
-```bash
-# Development
-npm run build       # Bundle with tsdown
-npm start           # Run bundled server
-npm run dev         # Run with tsx watch mode
-npm test            # Run tests with Vitest
-npm run test:watch  # Watch mode testing
-npm run lint        # ESLint check
-npm run lint:fix    # Auto-fix lint issues
-
-# Server Health Check
-curl http://localhost:1987/health
-```
-
----
-
-## Project Structure
-
-```
-octocode-research/
-├── src/
-│   ├── server.ts              # Express server entry point
-│   ├── index.ts               # Re-exports from octocode-mcp
-│   ├── mcpCache.ts            # MCP client caching
-│   ├── routes/
-│   │   ├── local.ts           # Local tool handlers (used in tests)
-│   │   ├── lsp.ts             # LSP tool handlers (used in tests)
-│   │   ├── github.ts          # GitHub tool handlers (used in tests)
-│   │   ├── package.ts         # Package tool handlers (used in tests)
-│   │   ├── tools.ts           # /tools/* - MAIN tool API (mounted)
-│   │   └── prompts.ts         # /prompts/* - prompt discovery (mounted)
-│   ├── middleware/
-│   │   ├── errorHandler.ts    # Error response formatting
-│   │   ├── logger.ts          # Request/response logging
-│   │   ├── queryParser.ts     # Zod validation
-│   │   └── readiness.ts       # Server readiness check
-│   ├── validation/
-│   │   ├── index.ts           # Schema exports
-│   │   ├── schemas.ts         # HTTP schemas (import from octocode-mcp)
-│   │   └── httpPreprocess.ts  # HTTP query string preprocessing
-│   ├── utils/
-│   │   ├── colors.ts          # Console color functions
-│   │   ├── logger.ts          # File-based logging
-│   │   ├── responseBuilder.ts # Role-based response formatting
-│   │   ├── responseFactory.ts # Response creation helpers
-│   │   ├── responseParser.ts  # MCP response parsing
-│   │   ├── resilience.ts      # Resilience utilities
-│   │   ├── retry.ts           # Retry with backoff
-│   │   ├── circuitBreaker.ts  # Circuit breaker pattern
-│   │   └── routeFactory.ts    # Route handler factory
-│   ├── types/
-│   │   ├── express.d.ts       # Express type extensions
-│   │   ├── guards.ts          # Type guard functions
-│   │   ├── mcp.ts             # MCP protocol types
-│   │   ├── responses.ts       # Response types
-│   │   └── toolTypes.ts       # Tool parameter types
-│   └── __tests__/
-│       ├── integration/       # Integration tests
-│       │   ├── circuitBreaker.test.ts
-│       │   └── routes.test.ts
-│       └── unit/              # Unit tests
-│           ├── circuitBreaker.test.ts
-│           ├── logger.test.ts
-│           ├── responseBuilder.test.ts
-│           └── retry.test.ts
-├── docs/
-│   ├── API_REFERENCE.md       # Complete HTTP API reference
-│   ├── ARCHITECTURE.md        # Architecture documentation
-│   └── FLOWS.md               # Main flows & connections
-├── references/
-│   └── GUARDRAILS.md          # Safety guardrails
-├── scripts/                   # Bundled output
-│   ├── server.js              # Bundled server
-│   └── server.d.ts            # Type declarations
-├── SKILL.md                   # Skill definition for AI agents
-├── AGENTS.md                  # This file
-├── tsdown.config.ts           # tsdown bundler configuration
-├── package.json
-├── tsconfig.json
-├── eslint.config.mjs
-└── vitest.config.ts           # Test configuration
-```
-
----
-
-## API Endpoints
-
-### Available Routes
-
-| Endpoint | Description |
-|----------|-------------|
-| `GET /health` | Server health check |
-| `GET /tools/list` | List all tools (concise) |
-| `GET /tools/info` | List all tools with details |
-| `GET /tools/info/:toolName` | Get specific tool schema (call BEFORE using!) |
-| `GET /tools/system` | Get system prompt (load FIRST) |
-| `GET /tools/initContext` | Combined system prompt + all tool schemas (recommended for init) |
-| `POST /tools/call/:toolName` | **Execute any tool** |
-| `GET /prompts/list` | List all prompts |
-| `GET /prompts/info/:promptName` | Get specific prompt content |
-
-### Tool Execution (Unified API)
-
-**All tools are called via `POST /tools/call/:toolName`** with JSON body:
-
-```bash
-curl -X POST http://localhost:1987/tools/call/localSearchCode \
-  -H "Content-Type: application/json" \
-  -d '{"queries":[{
-    "pattern":"useState",
-    "path":"/project",
-    "mainResearchGoal":"Find React hooks",
-    "researchGoal":"Locate useState",
-    "reasoning":"Need source location"
-  }]}'
-```
-
-### Available Tools (via `/tools/call/:toolName`)
-
-| Tool Name | Category | Description |
-|-----------|----------|-------------|
-| `localSearchCode` | Local | Code search via ripgrep |
-| `localGetFileContent` | Local | Read file content |
-| `localFindFiles` | Local | Find files by pattern/metadata |
-| `localViewStructure` | Local | View directory tree |
-| `lspGotoDefinition` | LSP | Go to symbol definition |
-| `lspFindReferences` | LSP | Find all references |
-| `lspCallHierarchy` | LSP | Call hierarchy (incoming/outgoing) |
-| `githubSearchCode` | GitHub | Search GitHub code |
-| `githubGetFileContent` | GitHub | Read GitHub files |
-| `githubSearchRepositories` | GitHub | Search repositories |
-| `githubViewRepoStructure` | GitHub | View repo structure |
-| `githubSearchPullRequests` | GitHub | Search pull requests |
-| `packageSearch` | Package | Search npm/PyPI packages |
-
----
-
-## Key Files & Responsibilities
-
-### Entry Points
-
-| File | Purpose |
-|------|---------|
-| `src/server.ts` | Express app creation, route mounting, graceful shutdown |
-| `src/index.ts` | Re-exports octocode-mcp functions with cleaner names |
-| `src/mcpCache.ts` | MCP client instance caching and management |
-
-### Routes
-
-Each route file follows the pattern:
-1. Import tool function from `../index.js`
-2. Define Express Router
-3. Apply validation middleware
-4. Execute tool and format response
-
-### Middleware
-
-| File | Purpose |
-|------|---------|
-| `queryParser.ts` | Validates query params against Zod schemas |
-| `errorHandler.ts` | Catches errors, formats consistent responses |
-| `logger.ts` | Logs requests to console and file |
-| `readiness.ts` | Server readiness check middleware |
-
-### Validation
-
-Schemas are imported from `octocode-mcp/public` (source of truth) and wrapped with HTTP preprocessing.
-
-| File | Purpose |
-|------|---------|
-| `schemas.ts` | HTTP-wrapped schemas importing from `octocode-mcp/public` |
-| `httpPreprocess.ts` | Query string conversion (string→number/boolean/array) |
-
-When adding/modifying endpoints:
-1. Check if schema exists in `octocode-mcp/public`
-2. Create HTTP wrapper in `validation/schemas.ts` with preprocessing
-3. Apply schema validation in route handler
-
----
-
-## Development Guidelines
-
-### Adding a New Endpoint
-
-1. **Add schema** in `src/validation/schemas.ts`
-2. **Create route handler** in appropriate `src/routes/*.ts`
-3. **Add route to server.ts** if new route group
-4. **Update types** if needed
-5. **Add tests** in `src/__tests__/`
-6. **Document** in docs/ARCHITECTURE.md
-
-### Code Style
-
-- **TypeScript strict mode** enabled
-- **Zod** for runtime validation
-- **Express async handlers** - wrap with try/catch or error middleware
-- **Consistent logging** - use `agentLog`, `successLog`, `errorLog` from colors.ts
-
-### Testing
-
-```bash
-yarn test                 # Run all tests
-yarn test:watch          # Watch mode
-yarn test -- --coverage  # With coverage report
-```
-
----
-
-## Response Format
-
-### Single Query Response (`POST /tools/call/:toolName`)
-
-```typescript
-{
-  tool: "localSearchCode",
-  success: true,
-  data: { files: [...], totalMatches: 10 },
-  hints: ["Use lineHint for LSP tools", ...],
-  research: {
-    mainResearchGoal: "...",
-    researchGoal: "...",
-    reasoning: "..."
-  }
-}
-```
-
-### Bulk Query Response (2-3 queries)
-
-```typescript
-{
-  tool: "localSearchCode",
-  bulk: true,
-  success: true,
-  instructions: "...",
-  results: [
-    { id: 1, status: "hasResults", data: {...}, research: {...} },
-    { id: 2, status: "empty", data: {...}, research: {...} }
-  ],
-  hints: { hasResults: [...], empty: [...], error: [...] },
-  counts: { total: 2, hasResults: 1, empty: 1, error: 0 }
-}
-```
-
-### Error Response
-
-```typescript
-{
-  tool: "localSearchCode",
-  success: false,
-  data: {},
-  hints: ["Error recovery hint..."],
-  research: {...}
-}
-```
-
----
-
-## Key Dependencies
-
-| Package | Purpose |
-|---------|---------|
-| `octocode-mcp` | Core tool implementations |
-| `express` | HTTP server framework |
-| `zod` | Schema validation |
-| `@modelcontextprotocol/sdk` | MCP format types |
-
----
-
-## Documentation References
-
-| Doc | Purpose |
-|-----|---------|
-| [SKILL.md](./SKILL.md) | How AI agents should USE this skill |
-| [docs/ARCHITECTURE.md](./docs/ARCHITECTURE.md) | Detailed architecture |
-| [docs/FLOWS.md](./docs/FLOWS.md) | Main flows & component connections |
-
----
-
-## Console Output Colors
-
-| Category | Color | Function |
-|----------|-------|----------|
-| Agent messages | 🟣 Purple | `agentLog()` |
-| Tool results | 🔵 Blue | `resultLog()` |
-| Success | 🟢 Green | `successLog()` |
-| Errors | 🔴 Red | `errorLog()` |
-| Warnings | 🟡 Yellow | `warnLog()` |
-| Secondary info | Gray | `dimLog()` |
-
----
-
-## Troubleshooting
-
-### Server won't start
-```bash
-# Check if port 1987 is in use
-lsof -i :1987
-
-# Kill existing process
-kill -9 $(lsof -ti :1987)
-```
-
-### Build errors
-```bash
-# Clean and rebuild
-rm -rf scripts/
-npm run build
-```
-
-### Missing dependencies
-```bash
-# Reinstall
-rm -rf node_modules/
-yarn install
-```
-
----
-
-## Access Control
-
-| Path | Access |
-|------|--------|
-| `src/`, `src/__tests__/` | ✅ Auto |
-| `docs/`, `references/` | ✅ Auto |
-| `*.json`, `*.config.*` | ⚠️ Ask first |
-| `.env*`, `node_modules/`, `scripts/` | ❌ Never modify |
-
----
-
-*This skill wraps `octocode-mcp` tools as HTTP endpoints. For tool-specific documentation, see the [octocode-mcp package](https://github.com/bgauryy/octocode-mcp/blob/main/AGENTS.md).*