execute

Note

As of v1.0, fialr execute is an alias for fialr organize --execute. See organize for the current documentation.

fialr execute <plan_csv> <target> --reviewed

Execute a standalone plan.csv produced by the plan command. Moves and renames files according to the plan entries. Requires explicit --reviewed confirmation.

---

Arguments

Argument	Description
plan_csv	Path to the plan.csv file from a previous fialr plan run (required)
target	Root directory of the file corpus (required)

Options

Option	Description
--reviewed	Confirm that the plan has been reviewed (required)
--jobs-dir PATH	Directory for job artifacts (default: .fialr/jobs)

---

What it does

execute reads a plan.csv file and applies the operations it describes. This is the standalone execution path — an alternative to fialr organize --execute --reviewed, which runs the full pipeline in one command.

Workflow

The typical workflow is:

1. Run fialr plan <target> -o ./plan to generate a plan
2. Review plan_preview.md and plan.csv
3. Run fialr execute ./plan/plan.csv <target> --reviewed to apply it

Safety gates

The --reviewed flag is mandatory. Without it, the command refuses to run. This is a deliberate friction point: someone must confirm they have read the plan before any files move.

Execution process

For each entry in the plan:

1. Load and validate the plan CSV
2. Create a job directory for tracking
3. Execute all plan operations (moves, renames) with hash verification
4. Log every operation to the append-only audit ledger
5. Record provenance (original path, original name) in XATTRs and SQLite

Job artifacts

Every execution creates a job directory under --jobs-dir:

.fialr/jobs/{YYYY-MM-DD}_execute_{uuid}/
  log.json           # append-only operation log
  checkpoint.json    # last completed operation index

---

Output

execute ./plan/plan.csv ~/Documents --reviewed

  EXECUTE  plan.csv → ~/Documents
  entries  812
  moved  798
  skipped  14
  errors  0
  elapsed  4.1s

The exit code is 0 when there are no errors, 1 otherwise.

---

Examples

# Execute a reviewed plan
fialr execute ./plan/plan.csv ~/Documents --reviewed

# Specify a custom jobs directory
fialr execute ./plan/plan.csv ~/Documents --reviewed --jobs-dir ./jobs

---

See also

• plan — generate the plan.csv that this command consumes
• organize — run the full pipeline in one command
• validate — verify file integrity after execution
• undo — reverse operations if needed