@lytics/[email protected]

Patch Changes

• 579925c: Incremental indexing now works! dev update detects changed, new, and deleted files.

  What's new:

  • Only re-indexes files that actually changed (via content hash)
  • Detects new files added since last index
  • Cleans up documents for deleted files
  • Removes orphaned symbols when code is modified

  Usage:

  dev index .     # First run: full index
  dev update      # Fast incremental update
  dev index . --force  # Force full re-index

@lytics/[email protected]

Minor Changes

• d0481b4: feat(scanner): Extract arrow functions, function expressions, and exported constants

  New Features

  Arrow Function Extraction

  • Extract arrow functions assigned to const/let variables
  • Extract function expressions assigned to variables
  • Detect React hooks automatically (use* naming pattern)
  • Detect async arrow functions

  Exported Constant Extraction

  • Extract exported const with object literal initializers (config objects)
  • Extract exported const with array literal initializers (static lists)
  • Extract exported const with call expression initializers (factories like createContext())

  API Changes

  New DocumentType value:

  • Added 'variable' to DocumentType union

  New metadata fields:

  • isArrowFunction?: boolean - true for arrow functions (vs function expressions)
  • isHook?: boolean - true if name matches /^use[A-Z]/ (React convention)
  • isAsync?: boolean - true for async functions
  • isConstant?: boolean - true for exported constants
  • constantKind?: 'object' | 'array' | 'value' - kind of constant initializer

  Examples

  Now extracts:

  export const useAuth = () => { ... }           // Hook (isHook: true)
  export const fetchData = async (url) => { ... } // Async (isAsync: true)
  const validateEmail = (email: string) => ...   // Utility function
  export const API_CONFIG = { baseUrl: '...' }   // Object constant
  export const LANGUAGES = ['ts', 'js']          // Array constant
  export const AppContext = createContext({})    // Factory constant

  Migration

  No breaking changes. The new 'variable' DocumentType is additive. Existing queries for 'function', 'class', etc. continue to work unchanged.

@lytics/[email protected]

Patch Changes

• ad4af12: ### Features

  • Test file hints in search results: dev_search now shows related test files (e.g., utils.test.ts) after search results. This surfaces test files without polluting semantic search rankings.

  Design

  • Uses structural matching (.test.ts, .spec.ts patterns) rather than semantic search
  • Keeps semantic search pure - test hints are in a separate "Related test files:" section
  • Patterns are configurable for future extensibility via function parameters

@lytics/[email protected]

Patch Changes

• 40192f5: Fix dev_history tool schema for Claude API compatibility

  • Removed anyOf from input schema (Claude API doesn't support it at top level)
  • Validation for "at least one of query or file required" is still enforced in execute()

@lytics/[email protected]

Patch Changes

• 4b55a04: Fix MCP server to include all 9 adapters and improve tool descriptions for better AI tool adoption

  Bug Fix:

  • CLI's mcp start command now registers all 9 adapters (was missing HealthAdapter, RefsAdapter, MapAdapter, HistoryAdapter)
  • Updated tool list in CLI output and install messages to show all 9 tools

  Tool Description Improvements:

  • dev_search: Added "USE THIS FIRST" trigger, comparison to grep for conceptual queries
  • dev_map: Clarified it shows component counts and exports, better than list_dir
  • dev_explore: Clarified workflow - use after dev_search for "similar" and "relationships" actions
  • dev_refs: Added guidance to use for specific symbols, use dev_search for conceptual queries
  • dev_history: Added "WHY" trigger, clarified semantic search over commits
  • dev_plan: Emphasized "ALL context in one call" value prop for GitHub issues
  • dev_gh: Clarified semantic search by meaning, not just keywords

  These description improvements help AI tools (Claude, Cursor) choose the right dev-agent tool for each task.

@lytics/[email protected]

Patch Changes

• 573ad3a: feat: unified indexing and CLI improvements

  dev index . now indexes everything in one command:

  • Code (always)
  • Git history (if in a git repo)
  • GitHub issues/PRs (if gh CLI installed)

  Shows an upfront "indexing plan" with prerequisites check.
  Use --no-git or --no-github to skip specific indexers.

  New dev git commands:

  • dev git index - index git history separately
  • dev git search <query> - semantic search over commits
  • dev git stats - show indexed commit count

  Fix: dev --version now correctly displays installed version (injected at build time).

@lytics/[email protected]

Minor Changes

• c42f5ba: feat: Intelligent Git History (v0.4.0)

  New capabilities for understanding codebase history:

  dev_history tool - Semantic search over git commits

  • Search commit messages by meaning (e.g., "authentication token fix")
  • Get file history with rename tracking
  • Token-budgeted output

  dev_map enhancements - Change frequency indicators

  • 🔥 Hot directories (5+ commits in 30 days)
  • ✏️ Active directories (1-4 commits in 30 days)
  • 📝 Recent activity (commits in 90 days)

  dev_plan enhancements - Git context in planning

  • Related commits shown alongside code snippets
  • Issue/PR references extracted from commits
  • Helps understand prior work on similar features

  Core infrastructure:

  • GitIndexer for semantic commit search
  • LocalGitExtractor for git operations
  • Extensible architecture for future git features

@lytics/[email protected]

Minor Changes

• afa8adb: feat: Context Quality release (v0.3.0)

  This release significantly enhances dev-agent's ability to provide rich, actionable context to AI assistants.

  New Tools

  dev_refs - Relationship Queries

  Query code relationships to understand what calls what:

  • Find all callers of a function
  • Find all callees (what a function calls)
  • Includes file paths, line numbers, and snippets

  dev_map - Codebase Overview

  Get a high-level view of repository structure:

  • Directory tree with component counts
  • Hot Paths: Most referenced files in the codebase
  • Smart Depth: Adaptive expansion based on information density
  • Signatures: Function/class signatures in export listings
  • Configurable depth and focus directory

  Enhanced Tools

  dev_plan - Context Assembler (Breaking Change)

  Completely refactored from heuristic task breakdown to context assembly:

  • Returns rich context package instead of task lists
  • Includes issue details with comments
  • Includes relevant code snippets from semantic search
  • Includes detected codebase patterns
  • Let LLMs do the reasoning with better data

  Migration: The old task breakdown output is removed. The new output provides strictly more information for LLMs to create their own plans.

  dev_search - Richer Results (from v0.2.0)

  • Code snippets included in results
  • Import statements for context
  • Caller/callee hints
  • Progressive disclosure based on token budget

  Philosophy

  This release embraces the principle: Provide structured data, let LLMs reason.

  Instead of trying to be smart with heuristics, dev-agent now focuses on assembling comprehensive context that AI assistants can use effectively.

@lytics/[email protected]

Minor Changes

• bc44ec7: chore: bump main package to match core and mcp versions

  Syncs the main @lytics/dev-agent package version with the underlying @lytics/dev-agent-core and @lytics/dev-agent-mcp packages which were bumped to 0.2.0 for the "Richer Search Results" feature.

v0.1.0 - Initial Release

🎉 Initial Release

@lytics/dev-agent is now available on npm!

npm install -g @lytics/dev-agent

Features

• 🔍 Semantic Code Search - Natural language queries across your codebase
• 🐙 GitHub Integration - Search issues/PRs with semantic understanding
• 📋 Implementation Planning - Generate plans from GitHub issues with code context
• 🔎 Code Exploration - Discover patterns, find similar code, analyze relationships
• 💚 Health Monitoring - Check component status and system health
• 📊 Repository Status - View indexing progress and statistics

MCP Tools

When integrated with Cursor or Claude Code:

• dev_search - Semantic code search
• dev_status - Repository status and health
• dev_explore - Code pattern discovery
• dev_plan - Implementation planning from issues
• dev_gh - GitHub issue/PR search
• dev_health - Component health checks

Quick Start

# Install globally
npm install -g @lytics/dev-agent

# Index your repository
cd /path/to/your/repo
dev index .

# Install MCP integration
dev mcp install --cursor  # For Cursor IDE
dev mcp install           # For Claude Code

Requirements

• Node.js >= 22 (LTS)
• For GitHub integration: GitHub CLI

Links

• 📦 npm package
• 📖 Documentation