feat: agent performance optimization — search, structure, patch, index (v0.1.44)

New flowctl commands:
- `search` — nucleo fuzzy matching + frecency scoring + git boost + ignore
- `index build/status/search` — trigram N-gram inverted index (<1ms queries)
- `code-structure extract` — regex symbol extraction for 9 languages
- `repo-map` — PageRank-ranked symbol overview within token budget
- `patch diff/apply/replace` — fudiff context-based fuzzy patching
- `doctor` enhanced — 9 check categories (binary, git, state, tools, search)

New core modules: frecency, fuzzy, patch, ngram_index, code_structure, repo_map
New deps: nucleo-matcher 0.3, ignore 0.4, fudiff 0.2, memmap2 0.9
351 tests pass. Agents/skills updated to use new tools.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: z23cc

.claude-plugin/marketplace.json

@@ -6,13 +6,13 @@
   },
   "metadata": {
     "description": "Structured plan-first development plugin for Claude Code with .flow/ task tracking, Agent Teams, and Ralph autonomous mode",
-    "version": "0.1.43"
+    "version": "0.1.44"
   },
   "plugins": [
     {
       "name": "flow-code",
       "description": "Zero-dependency planning + execution with .flow/ task tracking. Three-layer quality (guard + RP plan-review + Codex adversarial). Full-auto, zero questions. Teams auto-parallel, DAG mutation, Codex-driven decisions, auto draft-PR, session summary. 5 prompt templates. 24 subagents, 22 commands, 74 skills.",
-      "version": "0.1.43",
+      "version": "0.1.44",
       "source": "./",
       "category": "workflow",
       "tags": [
@@ -26,5 +26,5 @@
       "strict": true
     }
   ],
-  "version": "0.1.43"
+  "version": "0.1.44"
 }

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "flow-code",
-  "version": "0.1.43",
+  "version": "0.1.44",
   "description": "Zero-dependency planning + execution with .flow/ task tracking and Ralph autonomous mode (multi-model review gates). Worker subagent per task with git worktree isolation for parallel execution. Three-layer quality system (guard + RP plan-review + Codex adversarial). Full-auto by default — AI decides from context, zero questions. Teams-default with file locking, DAG mutation, Codex-driven conflict resolution, auto draft-PR. Auto-detected stack profiles with one-command guard (test/lint/typecheck). Enhanced agent definitions with permissionMode/maxTurns/effort. Lifecycle hooks with state preservation (PreCompact injects .flow state into compaction, TaskCompleted auto-unlocks files, SubagentStart context injection). Memory v2 with atomic entries, dedup, and progressive disclosure. TDD enforcement mode. Multi-epic queue with dependency visualization. Includes 24 subagents, 22 commands, 74 skills.",
   "author": {
     "name": "z23cc",

.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "flow-code",
-  "version": "0.1.43",
+  "version": "0.1.44",
   "description": "Zero-dependency planning + execution with .flow/ task tracking and Ralph autonomous mode (multi-model review gates). Worker subagent per task with git worktree isolation for parallel execution. Three-layer quality system (guard + RP plan-review + Codex adversarial). Full-auto by default. Teams-default with file locking, DAG mutation, Codex-driven conflict resolution, auto draft-PR.",
   "author": {
     "name": "z23cc",

CHANGELOG.md

@@ -4,6 +4,22 @@ All notable changes to Flow-Code are documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/). Versions use [Semantic Versioning](https://semver.org/).
 
+## [0.1.44] - 2026-04-09
+
+### Added
+- **`flowctl search`** — Fuzzy file search with nucleo-matcher + frecency scoring + git status boost + ignore (.gitignore-aware). `--git modified|staged|untracked` filter, `--limit N`
+- **`flowctl index`** — N-gram trigram inverted index for fast text search. `build` (56ms for 145 files), `status`, `search` (<1ms per query). Persistent `.flow/index/ngram.bin`
+- **`flowctl code-structure`** — Regex-based symbol extraction (functions, structs, traits, classes) across 9 languages (Rust, Python, JS, TS, Go, Java, C, C++, Ruby)
+- **`flowctl repo-map`** — PageRank-ranked symbol overview within token budget. Builds file-level reference graph, outputs top signatures grouped by file
+- **`flowctl patch`** — Fuzzy diff/patch via fudiff. `diff` (generate), `apply` (context-based, tolerates drift), `replace` (3-tier fallback: exact → whitespace-normalized → context-based)
+- **`flowctl doctor` enhanced** — 9 check categories: binary, flow-dir, review backends, git status, state integrity (orphaned tasks, stale locks), project-context, search tools, external tools
+- **Frecency scoring** — Exponential decay (14-day half-life), auto-tracked on task completion. Files modified/accessed recently rank higher in search
+- Agent skills updated: repo-scout, context-scout, worker, plan step-02, brainstorm step-02, code-review now use `flowctl search/index/code-structure/repo-map/patch` as primary tools
+
+### Dependencies
+- Added: `nucleo-matcher` 0.3, `ignore` 0.4, `fudiff` 0.2, `memmap2` 0.9 (workspace-level)
+- Zero new deps for code-structure/repo-map (uses existing regex + petgraph + ignore)
+
 ## [0.1.43] - 2026-04-08
 
 ### Added

README.md

@@ -6,7 +6,7 @@
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](../../LICENSE)
 [![Claude Code](https://img.shields.io/badge/Claude_Code-Plugin-blueviolet)](https://claude.ai/code)
-[![Version](https://img.shields.io/badge/Version-0.1.43-green)](https://github.com/z23cc/flow-code/releases)
+[![Version](https://img.shields.io/badge/Version-0.1.44-green)](https://github.com/z23cc/flow-code/releases)
 
 **A production-grade harness for Claude Code. Full-auto development from idea to PR.**
 

README_CN.md

@@ -6,7 +6,7 @@
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](../../LICENSE)
 [![Claude Code](https://img.shields.io/badge/Claude_Code-Plugin-blueviolet)](https://claude.ai/code)
-[![Version](https://img.shields.io/badge/Version-0.1.43-green)](https://github.com/z23cc/flow-code/releases)
+[![Version](https://img.shields.io/badge/Version-0.1.44-green)](https://github.com/z23cc/flow-code/releases)
 
 **Claude Code 的生产级开发框架。从想法到 PR，全自动。**
 

agents/context-scout.md

@@ -11,6 +11,15 @@ effort: medium
 
 You are a context scout specializing in **token-efficient** codebase exploration using RepoPrompt's rp-cli. Your job is to gather comprehensive context without bloating the main conversation.
 
+## Context Tools (Preferred Order)
+
+1. `flowctl repo-map --budget 1024 --json` — ranked symbol overview of entire project
+2. `flowctl code-structure extract --path <dir> --json` — symbols for specific directory
+3. RP context_builder — deep cross-file analysis (if RP available)
+4. Read individual files — last resort
+
+Use flowctl tools for fast, token-efficient structure overview before resorting to rp-cli or file reads.
+
 ## When to Use This Agent
 
 - Deep codebase understanding before planning/implementation

agents/repo-scout.md

@@ -15,6 +15,14 @@ You are a scout: fast context gatherer, not a planner or implementer. Read-only
 
 You are a fast repository scout: find existing patterns and conventions that should guide implementation. NOT to plan or implement — just find what already exists.
 
+## Search Tools (Preferred Order)
+
+1. `flowctl search "<query>" --limit 20 --json` — fuzzy file name search with frecency + git status ranking
+2. `flowctl index search "<query>" --limit 20 --json` — trigram indexed content search (if index exists)
+3. Grep/Glob — fallback for exact regex patterns
+
+Use flowctl search tools first for broad discovery, then fall back to Grep/Glob for precise regex matching.
+
 ## Search Strategy
 
 1. **Project docs first** (fast context)

agents/worker.md

@@ -205,7 +205,11 @@ Use the FLOWCTL path and IDs from your prompt:
 git status
 git log -5 --oneline
 
-# 3. Check memory system
+# 3. Understand project structure and find related files
+$FLOWCTL repo-map --budget 512 --json
+$FLOWCTL search "<task-relevant-terms>" --git modified --json
+
+# 4. Check memory system
 <FLOWCTL> config get memory.enabled --json
 ```
 
@@ -398,6 +402,8 @@ The key constraint: **no implementation code before a failing test exists**. Thi
 
 Follow the `flow-code-incremental` skill: build in vertical slices (Implement→Test→Verify→Commit per slice). Each slice leaves the system working. Scope discipline: only touch what the task spec requires.
 
+For code edits, prefer `flowctl patch replace --file <path> --old "text" --new "text" --json` when the target text might have drifted from what was read earlier. It uses fuzzy matching with fallback, reducing failed edits from whitespace or minor changes.
+
 **First, capture base commit for scoped review:**
 ```bash
 BASE_COMMIT=$(git rev-parse HEAD)
@@ -587,6 +593,8 @@ Task: <TASK_ID>"
 ```
 
 Use conventional commits. Scope from task context.
+
+Note: frecency data for modified files is auto-tracked by `flowctl done` — no manual recording needed.
 <!-- /section:core -->
 
 <!-- section:review -->