| name | fpf:actualize |
| description | Reconcile the project's FPF state with recent repository changes |
Actualize Knowledge Base
This command is a core part of maintaining a living assurance case. It keeps your FPF knowledge base (.fpf/) in sync with the evolving reality of your project's codebase.
The command performs a three-part audit against recent git changes to surface potential context drift, stale evidence, and outdated decisions. This aligns with the Observe phase of the FPF Canonical Evolution Loop (B.4) and helps manage Epistemic Debt (B.3.4).
Action (Run-Time)
Step 1: Check Git Changes
Run git commands to identify changes since last actualization:
git rev-parse HEAD
git diff --name-only <baseline_commit> HEAD
git diff --stat <baseline_commit> HEAD
Step 2: Analyze Report for Context Drift
-
Review changed files for core project configuration:
package.json, go.mod, Cargo.toml, requirements.txt
Dockerfile, docker-compose.yml
.env.example, config files
-
If configuration files changed:
- Re-read project structure (README, config files)
- Compare detected context with
.fpf/context.md
- Present diff to user