AIMFP

Initialize project entry (one per database)

Create a backup of .aimfp-project/ right now, ignoring any threshold. Zips everything except backups/ and watchdog/, adds a generated backup_summary.md, and rotates old archives per the backup_count setting, naming every archive it deletes (rotated, plus a warning sentence). The on-demand counterpart to the automatic inactivity check — call this when aimfp_run reports a scheduled backup due, or before any risky operation.

Create per-project state database (.state/runtime.db) from SQL schema. FP-compliant replacement for mutable global variables.

Create work branch following aimfp-{user}-{number} convention

Set directive status to 'paused'. Does NOT stop services - AI handles service shutdown via directive workflow.

Delete completion path with milestone validation

Delete custom return statement(s) for a helper function. By ID, by text, or all for a helper.

Delete file with comprehensive cross-reference validation

Delete flow with file validation

Delete a function, deciding explicitly what happens to its interactions: refused (with the edges listed) unless repoint_to moves them to the function that took over its job, or confirm_cascade removes them. Every moved or removed edge is recorded in the deletion note so it can be undone. Type relationships must be unlinked first.

Delete interaction

Delete item with status validation

Delete milestone with task validation

Delete a module. CASCADE removes module_files junction entries. Files themselves are NOT deleted.

Delete note (discouraged)

Smart delete with automatic routing to specialized functions when needed

Delete abandoned reserved entries (escape hatch for cancelled reserve operations)

Delete entry from user_preferences.db table

Delete sidequest with item validation (same logic as delete_task)

Delete subtask with item validation (same logic as delete_task)

Delete task with item validation

Delete theme with flow validation

Delete type with relationship validation

Remove type-function relationship

Delete entry from user_directives.db table, writing an entry_deletion note in the same transaction

Dry-run merge analysis - retrieves potential conflict data for AI to evaluate

Compare current Git HEAD with project.last_known_git_hash

(For use with InterCommAIMFP) OPTIONAL pre-apply planning aid: export each pending worker branch and report where two or more branches touch the SAME semantic entity or edge, so the master can re-partition or deliberately order integration BEFORE applying any changeset. Pure read (built entirely from export_state_changeset). An overlap is a heuristic warning, not a verdict — the authoritative 3-way resolution still happens in apply_state_changeset.

Execute git merge and return result. Updates work_branches table on success.

(For use with InterCommAIMFP) Export a semantic changeset of project.db between two committed git states (branch point -> branch tip), expressed entirely in stable semantic keys (file path, file+function/type name, module/theme/flow/path name, and work-hierarchy slugs) with branch-local integer PKs stripped. Each entity is classified add/modify/delete and each edge add/remove. This is the integer-free artifact the master applies to merge a worker's project-state into main without binary-blob conflicts or PK collisions. The changeset is ALSO persisted server-side under .aimfp-project/changesets/ and a small changeset_id handle + counts summary are returned, so the master can drive apply by handle instead of re-transcribing the full object. Pure read of git blobs (the export itself never mutates project.db); persistence writes only a JSON file under .aimfp-project/.

Check if file changed using Git (if available) or filesystem timestamp

Mark a reserved file as tracked after writing it to disk. The path must be a regular file relative to the project root: '.', a directory, or a path leaving the project is refused. Triggers flow assignment and function/type tracking checks.

Batch-finalize multiple reserved files after writing them to disk. All-or-nothing operation. Each path must be a regular file relative to the project root ('.' or a directory is refused).

Mark a reserved function as tracked after writing it. Triggers interaction and type-function relationship checks.

Batch-finalize multiple reserved functions after writing them. Triggers interaction and type-function checks for all.

Finalize reserved type after creation

Finalize multiple reserved types

Match a natural-language user request to the most relevant directive(s). Use when the user describes what they want and you need to find which directive handles it.

Find directive IDs matching one or more intent keywords (direct keyword lookup)

Get all user directives with status='active'. Convenience query for checking active directive count.

Get the project's ordered completion roadmap (stages from setup through completion). Each path contains milestones which contain tasks.

Get list of all unique intent keywords available for searching (simple list)

Get list of all directive names (or filtered by types). Returns names only, NOT full directive data. AI queries by name when needs details.

Load all directives for caching (special orchestrator)

Get project flows (architectural groupings describing intended behavior): all of them, or the ones in flow_ids. Lean by default (descriptions null); detail_level='full' for descriptions. Check BEFORE starting any task to understand the architecture.

Get all infrastructure entries including standard fields (even if empty). Returns complete infrastructure table for session bundling and status reports.

Get all unique intent keywords with usage counts for analytics

Get all modules in the project. Returns list of all module records sorted by name.

Get all project themes (high-level architectural areas). Use to orient on project structure before starting work.

Get all directive categories