Set directive status to 'active' and record activated_at timestamp. Does NOT deploy services - AI handles deployment via directive workflow.

Add completion path stage

Add/update user preference for directive

Batch-assign multiple files to flows. Skips existing links silently. More efficient than multiple add_file_to_flow calls.

Assign a finalized file to an architectural flow. Every finalized file needs at least one flow assignment to stay architecturally connected.

Assign a file to a module. Creates module_files junction entry. Same pattern as add_file_to_flow.

Batch assign multiple files to modules. More efficient than multiple add_file_to_module calls. Skips duplicates silently, fails fast on missing entities.

Add project flow

Record a dependency between two functions by name (call, chain, borrow, compose, pipe). Interactions are how the AI traces dependency graphs.

Batch-record function dependencies by ID. More efficient than multiple add_interaction calls for tracking all cross-function dependencies.

Create a single work item under a task, subtask, or sidequest. Items are the smallest trackable units of work.

Batch-create multiple work items under a single parent in one call. All items created with status 'pending'.

Add milestone to completion path

Create a new module (reusable code boundary). A module maps to a directory. Files are assigned explicitly via add_file_to_module. Use external_dependencies to record wrapped libraries.

Record a decision, architecture change, or context event in the project's audit trail. Supports typed notes with optional directive linking.

Add new entry to project database

Add entry to user settings database

Create an urgent interruption that pauses the current task. Use for bug fixes, blockers, or unexpected work discovered mid-task.

Create a focused sub-unit of work under a parent task. The parent is paused until all subtasks complete.

Create a task under a milestone with flow associations. Tasks are created ONE at a time as work progresses, not all at once.

Add project theme

Add tracking note to user_preferences.db (only when tracking enabled)

Link tracked types to the functions that use them with a role (factory, transformer, validator, etc.). Enables 'what functions use TypeX?' queries.

Add entry to user_directives.db table. Returns inserted record with ID.

Add note to user_directives.db notes table for AI record-keeping

Add new project-wide user setting to user_settings table

Session termination orchestrator. Gathers session audit data: reads watchdog state and final reminders, queries all files and functions from DB for AI to cross-reference, reads recent notes and task state. Stops watchdog process if running. Returns structured audit data for AI to interpret and act on. No analysis logic — AI determines what is stale or missing.

Phase 1 mechanical setup orchestrator for project initialization. Atomically creates directories, databases with schemas, and templates. No deep logic - pure mechanical operations.

Main entry point orchestrator. Called on session start (is_new_session=true) for full context bundle, and at work checkpoints (is_new_session=false) for watchdog alerts only.

Status orchestrator that retrieves comprehensive project state. Gathers data from multiple tables for AI to determine next steps.

Update multiple project items atomically. Used after code generation or bulk operations to ensure consistency.

Check if ProjectBlueprint.md has changed using Git or filesystem timestamp

Clear watchdog reminders after they have been reviewed and handled. Reminders persist in .aimfp-project/watchdog/reminders.json until this is called. Call after addressing all watchdog findings (file deletions, unregistered files, etc.).

Returns list of allowed values for CHECK constraint enum fields in aimfp_core.db. Parses schema to extract CHECK(field IN (...)) constraints.

Initialize project entry (one per database)

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 function with validation and interaction cascade

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

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

Compare current Git HEAD with project.last_known_git_hash

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

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

Mark a reserved file as tracked after writing it to disk. Triggers flow assignment and function/type tracking checks.

Batch-finalize multiple reserved files after writing them to disk. All-or-nothing operation.

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 all project flows (architectural groupings describing intended behavior). 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

Get category by name (fairly frequent)

Returns the Claude Code allowlist (.claude/settings.local.json contents) that pre-approves every AIMFP MCP tool, so the user is not prompted once per tool on first use. Allowlist is derived live from the tool registry so it can never drift. Does NOT write any file — returns ready-to-write JSON + target path; the AI writes/merges it, keeping AIMFP's 'never write outside .aimfp-project/' guarantee intact. Call when the user asks to set up AIMFP permissions or skip approval prompts.

Get where to loop back after completing directive

Get completion paths filtered by status

Get field names and types for a specific table

Get complete schema for core database (all tables and fields)

List all tables in core database

Get current Git branch name

Get current Git HEAD commit hash

Single entry point for scoped project status queries. Replaces 5-10 separate helper calls with one flexible query.

Get list of all available databases with metadata

Load a directive's workflow steps, preferences, and linked notes by name. ALWAYS call BEFORE executing any workflow — directives are the authoritative source, not memory.

Read and return the full MD documentation file for a directive. Resolves the md_file_path from aimfp_core.db to an absolute path within the installed package, reads the file, and returns content + absolute path + token estimate.

General-purpose query for directive flows by category, type, or directive names. Complements navigation helpers (get_next_directives_from_status, etc.) which are specialized for workflow routing.

Get all intent keywords for a specific directive

Get all directives in a category

Get all directives filtered by type (orchestration vs reference)

Get all directives that use a helper (reciprocal lookup)

Search directives by intent keywords and return full directive objects