nex-code 0.4.20 → 0.4.22

package/examples/agentic.md

@@ -0,0 +1,17 @@
+<!-- Few-shot example: agentic / multi-agent parallel work
+     Used by cli/few-shot.js — keep under 250 tokens total.
+     Generic placeholders only. -->
+
+user: Refactor the auth module across backend and frontend in parallel.
+
+A: |
+  I'll split this into independent sub-tasks and run agents in parallel.
+  Step 1 — read the entry points to identify module boundaries:
+  → read_file("src/index.js")
+  → read_file("frontend/src/App.jsx")
+  Step 2 — spawn focused sub-agents for each scope:
+  → spawn_agents([
+      {task: "refactor src/auth/ to use new session API", scope: ["src/auth/"]},
+      {task: "update frontend/src/auth/ components for new API", scope: ["frontend/src/auth/"]}
+    ])
+  Step 3 — review each agent's changes and verify consistency.

package/examples/coding.md

@@ -0,0 +1,14 @@
+<!-- Few-shot example: coding / bug fix
+     Used by cli/few-shot.js — keep under 250 tokens total.
+     Generic placeholders only. -->
+
+user: The request handler crashes on empty input, can you fix it?
+
+A: |
+  I'll read the handler first, then make a targeted fix.
+  Step 1 — read the file to understand the current logic:
+  → read_file("src/handlers/request.js")
+  Step 2 — edit only the lines that cause the crash:
+  → edit_file("src/handlers/request.js", old_string, new_string)
+  Step 3 — run the related tests to confirm:
+  → bash("npm test -- --testPathPattern=request")

package/examples/data.md

@@ -0,0 +1,14 @@
+<!-- Few-shot example: data / Django ORM + PostgreSQL optimization
+     Used by cli/few-shot.js — keep under 250 tokens total.
+     Generic placeholders only. -->
+
+user: The list page loads slowly with 500+ database entries.
+
+A: |
+  I'll find the slow query, check for missing select_related or indexes.
+  Step 1 — find the queryset that powers the list view:
+  → grep("objects\\.all\\|objects\\.filter", "src/views.py")
+  Step 2 — read the view and model to see the query and relations:
+  → read_file("src/views.py")
+  Step 3 — add select_related/prefetch_related or a db_index:
+  → edit_file("src/views.py", old_string, new_string)

package/examples/frontend.md

@@ -0,0 +1,15 @@
+<!-- Few-shot example: frontend / React component bug
+     Used by cli/few-shot.js — keep under 250 tokens total.
+     Generic placeholders only. -->
+
+user: The list component re-renders but still shows stale data after update.
+
+A: |
+  I'll read the component to trace the state flow, then fix it there.
+  Step 1 — read the component file:
+  → read_file("src/components/ItemList.jsx")
+  Step 2 — check the state or store it depends on:
+  → grep("useItemStore\|itemContext", "src/")
+  → read_file("src/store/itemStore.js")
+  Step 3 — fix the state update in the component that owns it:
+  → edit_file("src/components/ItemList.jsx", old_string, new_string)

package/examples/skills/code-review.md

@@ -0,0 +1,15 @@
+# Code Review Skill
+
+When asked to review code, follow this structured approach:
+
+## Review Checklist
+
+1. **Security**: Check for injection, XSS, hardcoded secrets, insecure APIs
+2. **Performance**: Look for N+1 queries, unnecessary re-renders, missing caching
+3. **Correctness**: Verify edge cases, error handling, null checks
+4. **Maintainability**: Assess naming, complexity, code organization
+5. **Testing**: Check test coverage for new/changed code
+
+## Output Format
+
+Rate each category 1-5 and provide specific findings with file:line references.

package/examples/skills/docker-deploy.js

@@ -0,0 +1,17 @@
+module.exports = {
+  name: "docker-deploy",
+  description: "Docker deployment helpers for containerized applications",
+  instructions: `When deploying Docker containers:
+1. Always build with --no-cache for production images
+2. Use multi-stage builds to minimize image size
+3. Tag with both latest and version-specific tags
+4. Run health checks after deployment
+5. Keep the previous image as rollback target`,
+  commands: [
+    {
+      cmd: "/docker-build",
+      desc: "Build and tag Docker image",
+    },
+  ],
+  tools: [],
+};

package/examples/skills/git-workflow.md

@@ -0,0 +1,23 @@
+# Git Workflow Skill
+
+Enforce a structured git workflow:
+
+## Branch Naming
+
+- `feat/description` — new features
+- `fix/description` — bug fixes
+- `refactor/description` — code restructuring
+- `docs/description` — documentation changes
+
+## Commit Messages
+
+Use conventional commits: `type: description`
+Types: feat, fix, docs, test, refactor, chore
+
+## PR Process
+
+1. Create feature branch from devel
+2. Make focused changes
+3. Write tests
+4. Open PR against devel
+5. Squash merge after approval

package/examples/sysadmin.md

@@ -0,0 +1,15 @@
+<!-- Few-shot example: sysadmin / AlmaLinux server debugging
+     Used by cli/few-shot.js — keep under 250 tokens total.
+     Generic placeholders only — no real hostnames, IPs, or paths. -->
+
+user: The web app is showing 502 bad gateway on the server.
+
+A: |
+  I'll check the server via SSH — nginx logs first, then the app service.
+  Step 1 — check the nginx error log on the server:
+  → ssh_exec(server, "tail -60 /var/log/nginx/error.log")
+  Step 2 — check if the gunicorn service is running:
+  → service_logs(server, "myapp", lines=40)
+  Step 3 — fix the issue on the server and restart:
+  → ssh_exec(server, "sed -i 's/broken/fixed/' /home/user/project/app.py")
+  → service_manage(server, "myapp", "restart")

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "nex-code",
-  "version": "0.4.20",
+  "version": "0.4.22",
   "description": "The open-source agentic coding CLI. Free with Ollama Cloud — switch to OpenAI, Anthropic or Gemini anytime. Alternative to Claude Code & Gemini CLI.",
   "bin": {
     "nex-code": "./dist/nex-code.js"
   },
   "files": [
     "dist/",
+    "examples/",
     "README.md",
     "LICENSE"
   ],
@@ -16,15 +17,18 @@
   "scripts": {
     "start": "node dist/nex-code.js",
     "build": "esbuild bin/nex-code.js --bundle --platform=node --target=node18 --outfile=dist/nex-code.js --minify --external:axios --external:dotenv --external:playwright",
+    "dev": "esbuild bin/nex-code.js --bundle --platform=node --target=node18 --outfile=dist/nex-code.js --external:axios --external:dotenv --external:playwright --watch",
     "test": "jest --forceExit",
     "test:orchestrator": "jest tests/orchestrator.test.js --forceExit",
     "coverage": "jest --coverage --forceExit",
     "test:watch": "jest --watch",
+    "typecheck": "tsc --noEmit",
     "format": "prettier --write .",
     "install-hooks": "ln -sf ../../hooks/pre-push .git/hooks/pre-push && chmod +x .git/hooks/pre-push && ln -sf ../../hooks/post-merge .git/hooks/post-merge && chmod +x .git/hooks/post-merge && echo 'Hooks installed (pre-push, post-merge).'",
     "prepublishOnly": "npm run build && npm test",
     "merge-to-main": "bash scripts/merge-to-main.sh",
     "improve": "node scripts/improve.js",
+    "extract-examples": "node scripts/extract-examples.js",
     "benchmark:realworld": "node scripts/benchmark-realworld.js",
     "release": "npm version patch && git push --follow-tags && npm publish"
   },
@@ -73,7 +77,8 @@
   "devDependencies": {
     "esbuild": "^0.27.3",
     "jest": "^29.7.0",
-    "prettier": "^3.8.1"
+    "prettier": "^3.8.1",
+    "typescript": "^5.9.3"
   },
   "overrides": {
     "brace-expansion": ">=5.0.5",