Skip to content

feat: v0.5.0 — navigation + risk positioning, 15→13 tools#6

Merged
rushikeshmore merged 2 commits intomainfrom
v0.5.0-positioning
Mar 8, 2026
Merged

feat: v0.5.0 — navigation + risk positioning, 15→13 tools#6
rushikeshmore merged 2 commits intomainfrom
v0.5.0-positioning

Conversation

@rushikeshmore
Copy link
Owner

@rushikeshmore rushikeshmore commented Mar 8, 2026

Summary

  • Repositions CodeCortex from "persistent codebase memory" → "codebase navigation and risk layer" based on 3 rounds of agent comparison testing
  • Tools 15→13: removed analyze_module + save_module_analysis, renamed report_feedbackrecord_observation
  • README rewritten with real validated test data from a 6,400-file codebase (OpenClaw, 143K symbols)
  • CLI fix: modules <name> output capped at 30 edges (was dumping 559KB for large modules)

Validated Test Data (Round 3 apples-to-apples)

Without CodeCortex With CodeCortex
Tool calls 37 15 (2.5x fewer)
Total tokens 79K 43K (~50% fewer)
Answer quality 23/25 23/25 (same)
Hidden dependencies No Yes

Files Changed (14)

  • README.md — full rewrite with new positioning + real data
  • CLAUDE.md — tool list 15→13
  • package.json — description updated
  • src/mcp/tools/write.ts — removed 2 tools, renamed 1, renumbered
  • src/core/agent-instructions.ts — AGENT_INSTRUCTIONS rewrite
  • src/cli/commands/modules.ts — EDGE_CAP=30 for CLI output
  • src/mcp/server.ts — tool count + description
  • src/mcp/tools/read.ts — tool description updates
  • src/core/module-gen.ts, src/utils/truncate.ts — reference updates
  • 4 test files updated (276/276 pass)

Test plan

  • tsc --noEmit — clean
  • npm test — 276/276 pass
  • npm run build — success
  • CLI version shows 0.5.0

🤖 Generated with Claude Code

rushikeshmore and others added 2 commits March 8, 2026 23:08
Response size caps: all read tools now use size-adaptive limits based on
project classification (micro/small/medium/large/extra-large). Responses
stay under 10K chars on large repos. detail="brief"|"full" flag on 7 tools.

Search rewrite: 3-tier ranked search (symbols→files→docs) with kind bonus,
export bonus, and local variable demotion. Exported functions rank above
local const assignments.

Agent onboarding: generates .codecortex/AGENT.md with tool guide, appends
pointer to CLAUDE.md/.cursorrules/.windsurfrules/copilot-instructions.md.

New files: project-size.ts (classification + limits), truncate.ts (response
helpers), agent-instructions.ts (onboarding), SECURITY.md, CI workflow.

Init improvements: compact overview.md (directory summary, not raw file
listing), step 7 agent instructions, MCP connection commands in output.

277 tests pass, tsc clean.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…dated claims

Repositions CodeCortex from "persistent codebase memory" to "codebase navigation
and risk layer" based on 3 rounds of agent comparison testing on a 6,400-file repo.

Key changes:
- Tools 15→13: removed analyze_module + save_module_analysis, renamed
  report_feedback → record_observation
- AGENT.md rewritten: "CodeCortex finds WHERE to look. You still read the code."
- README rewritten with real test data (~50% fewer tokens, 2.5x fewer tool calls,
  same quality 23/25 vs 23/25)
- CLI modules command capped at 30 edges (was 559KB for large modules)
- Dropped unvalidated "85% token reduction" claim
- All 276 tests pass, tsc clean, build succeeds

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@github-advanced-security
Copy link

You are seeing this message because GitHub Code Scanning has recently been set up for this repository, or this pull request contains the workflow file for the Code Scanning tool.

What Enabling Code Scanning Means:

  • The 'Security' tab will display more code scanning analysis results (e.g., for the default branch).
  • Depending on your configuration and choice of analysis tool, future pull requests will be annotated with code scanning analysis results.
  • You will be able to see the analysis results for the pull request's branch on this overview once the scans have completed and the checks have passed.

For more information about GitHub Code Scanning, check out
the documentation.

@rushikeshmore rushikeshmore merged commit 226b837 into main Mar 8, 2026
2 of 4 checks passed
@rushikeshmore rushikeshmore deleted the v0.5.0-positioning branch March 8, 2026 19:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant