agentflight 0.3.2 → 0.4.0

package/docs/development/changed-file-filters.md

@@ -0,0 +1,58 @@
+# Changed-File Filters
+
+AgentFlight keeps changed-file analysis local and deterministic. It reads git status, filters its own runtime artifacts, applies optional project filters, and then computes risk, review focus, proof gaps, reports, replays, resumes, and snapshots from the remaining files.
+
+## Always-On Runtime Filters
+
+AgentFlight always excludes its own runtime artifacts:
+
+- `.agentflight/sessions/**`
+- `.agentflight/reports/**`
+- `.agentflight/current/**`
+- `.agentflight/evidence/**`
+
+These files are evidence and generated session data. Including them would make AgentFlight pollute its own risk and review output.
+
+`.agentflight/config.json` stays visible because it is user-controlled project configuration and may be intentionally committed.
+
+## Project Filters
+
+Use `.agentflight/config.json` to hide generated or internal files that should not affect review intelligence:
+
+```json
+{
+  "changedFileFilters": {
+    "ignore": [".projscan-memory/**"]
+  }
+}
+```
+
+You can add other local patterns when they match your repo policy:
+
+```json
+{
+  "changedFileFilters": {
+    "ignore": [".projscan-memory/**", "coverage/**", "dist/**", ".next/**"]
+  }
+}
+```
+
+Ignored files do not appear in:
+
+- `agentflight status`
+- `agentflight report`
+- `agentflight replay`
+- `agentflight resume`
+- `agentflight snapshot` risk and review summaries
+
+Keep filters conservative. Do not ignore generated files that reviewers are expected to inspect.
+
+## Supported Pattern Shape
+
+The MVP filter supports:
+
+- exact paths, such as `.projscan-memory/memory.json`
+- directory prefixes ending with `/**`, such as `.projscan-memory/**`
+- simple basename wildcards, such as `*.log`
+
+Malformed or empty patterns are ignored rather than crashing the CLI.

package/docs/{roadmap.md → roadmap/index.md}

@@ -13,12 +13,17 @@
 - Defensive ProjScan and AgentLoopKit adapters.
 - Verification evidence capture.
 - Session events and snapshots.
+- Review focus ranking.
+- Proof gap detection.
+- Review readiness recommendations.
+- Config-driven generated/internal changed-file filters.
 
 ## Future Free/Open-Core
 
 - Basic local session history.
 - Structured `--json` output.
 - Richer configurable verification command profiles.
+- Deeper ProjScan-enriched review hints once stable structured output exists.
 - More precise git diff stats without including full code by default.
 - Timeline filtering and richer local replay navigation.