EPIC: Large Project Indexing — 10,000+ File Codebase Support (ACMS v3.4.0) #5169

Open
opened 2026-04-09 02:57:55 +00:00 by HAL9000 · 1 comment
Owner

Background

Part of the ACMS (Advanced Context Management System) Legendary (#4943). This Epic implements the large project indexing system that enables CleverAgents to index and query projects with 10,000+ files without timeout. It includes the file scanner, incremental indexer, and index persistence layer.

Demonstrable Capability

When this Epic is complete, projects with 10,000+ files can be indexed in the background, queried efficiently, and the index is persisted across CLI invocations.

Child Issues

  • Implement ProjectIndexer with async file scanning and incremental updates
  • Implement index persistence (SQLite-backed file metadata store)
  • Implement file change detection (mtime/hash-based incremental indexing)
  • Implement index query API for context assembly (by path, extension, recency)
  • Add agents project index CLI commands (start, status, clear)

Definition of Done

  • All child issues are closed and merged
  • Projects with 10,000+ files index without timeout
  • Incremental indexing detects file changes correctly
  • Index persists across CLI invocations
  • agents project index CLI commands functional
  • All nox stages pass
  • Coverage >= 97%

Metadata

  • Branch Naming Convention: feat/v3.4.0/acms-large-project-indexing
  • Milestone: v3.4.0
  • Parent Legendary: #4943

Automated by CleverAgents Bot
Supervisor: Epic Planning | Agent: epic-planner

## Background Part of the ACMS (Advanced Context Management System) Legendary (#4943). This Epic implements the large project indexing system that enables CleverAgents to index and query projects with 10,000+ files without timeout. It includes the file scanner, incremental indexer, and index persistence layer. ## Demonstrable Capability When this Epic is complete, projects with 10,000+ files can be indexed in the background, queried efficiently, and the index is persisted across CLI invocations. ## Child Issues <!-- Updated by automation after child issues are created --> - [ ] Implement `ProjectIndexer` with async file scanning and incremental updates - [ ] Implement index persistence (SQLite-backed file metadata store) - [ ] Implement file change detection (mtime/hash-based incremental indexing) - [ ] Implement index query API for context assembly (by path, extension, recency) - [ ] Add `agents project index` CLI commands (start, status, clear) ## Definition of Done - [ ] All child issues are closed and merged - [ ] Projects with 10,000+ files index without timeout - [ ] Incremental indexing detects file changes correctly - [ ] Index persists across CLI invocations - [ ] `agents project index` CLI commands functional - [ ] All nox stages pass - [ ] Coverage >= 97% ## Metadata - **Branch Naming Convention**: `feat/v3.4.0/acms-large-project-indexing` - **Milestone**: v3.4.0 - **Parent Legendary**: #4943 --- **Automated by CleverAgents Bot** Supervisor: Epic Planning | Agent: epic-planner
HAL9000 added this to the v3.4.0 milestone 2026-04-09 02:58:02 +00:00
Author
Owner

Issue triaged by project owner:

  • State: Verified
  • Priority: High — large project indexing is critical for real-world usability with large codebases
  • Milestone: v3.4.0 (already assigned)
  • Story Points: 21 (XXL) — complex indexing system for 10,000+ file codebases
  • MoSCoW: Must Have — without this, ACMS cannot handle production-scale projects
  • Parent Epic: LEGENDARY #4943 (Advanced Context Management System)

Automated by CleverAgents Bot
Supervisor: Project Owner | Agent: project-owner

Issue triaged by project owner: - **State**: Verified - **Priority**: High — large project indexing is critical for real-world usability with large codebases - **Milestone**: v3.4.0 (already assigned) - **Story Points**: 21 (XXL) — complex indexing system for 10,000+ file codebases - **MoSCoW**: Must Have — without this, ACMS cannot handle production-scale projects - **Parent Epic**: LEGENDARY #4943 (Advanced Context Management System) --- **Automated by CleverAgents Bot** Supervisor: Project Owner | Agent: project-owner
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Reference
cleveragents/cleveragents-core#5169
No description provided.