Plan File Management

Structural operations on plan files such as renumbering threads and tasks.

All operations are subcommands of the i2code CLI tool, invoked as:

i2code plan <subcommand> <plan_file> [options]

fix-numbering

Renumber all threads and tasks sequentially. Run this after arbitrary edits made outside the script.

i2code plan fix-numbering <path-to-plan-file>

Run this after:

• Inserting or deleting threads or tasks
• Rearranging plan sections
• When the user asks to renumber or fix numbering

mark-task-complete

Mark a task and all its steps as complete. Optionally appends to change history if rationale is provided.

i2code plan mark-task-complete <plan_file> --thread <N> --task <M> [--rationale <text>]

Errors if the task does not exist or is already complete.

mark-task-incomplete

Mark a completed task and all its steps as incomplete. The reverse of mark-task-complete. Optionally appends to change history if rationale is provided.

i2code plan mark-task-incomplete <plan_file> --thread <N> --task <M> [--rationale <text>]

Errors if the task does not exist or is already incomplete.

reorder-threads

Reorder threads according to a specified ordering, then auto-renumber all threads and tasks.

i2code plan reorder-threads <plan_file> --order <comma-separated-thread-numbers> --rationale <text>

Example: --order 3,1,2 moves thread 3 to position 1, thread 1 to position 2, thread 2 to position 3.

Errors if --order does not contain exactly the set of existing thread numbers.

insert-thread-before

Insert a fully structured thread before a specified thread, then auto-renumber.

i2code plan insert-thread-before <plan_file> --before <N> --title <title> --introduction <text> --tasks <json> --rationale <text>

The --tasks argument is a JSON array of task objects (see spec for schema).

insert-thread-after

Insert a fully structured thread after a specified thread, then auto-renumber.

i2code plan insert-thread-after <plan_file> --after <N> --title <title> --introduction <text> --tasks <json> --rationale <text>

get-next-task

Return the first uncompleted task across the plan, with full metadata and steps. Prints a message if all tasks are complete.

i2code plan get-next-task <plan_file>

list-threads

Return all threads with their numbers, titles, and task completion counts.

i2code plan list-threads <plan_file>

get-summary

Return the plan's name, idea type, overview, and progress (thread count, task count, completed task count).

i2code plan get-summary <plan_file>

get-thread

Return a specific thread's full content including number, title, introduction, and all tasks with their metadata and steps.

i2code plan get-thread <plan_file> --thread <N>

Errors if the thread does not exist.

mark-step-complete

Mark a single step as complete. Appends to change history.

i2code plan mark-step-complete <plan_file> --thread <N> --task <M> --step <S> --rationale <text>

Errors if the step does not exist or is already complete.

mark-step-incomplete

Mark a single completed step as incomplete. The reverse of mark-step-complete. Appends to change history.

i2code plan mark-step-incomplete <plan_file> --thread <N> --task <M> --step <S> --rationale <text>

Errors if the step does not exist or is already incomplete.

replace-thread

Replace a thread's entire content (title, introduction, tasks) in place, then auto-renumber.

i2code plan replace-thread <plan_file> --thread <N> --title <title> --introduction <text> --tasks <json> --rationale <text>

Errors if the thread does not exist.

insert-task-before

Insert a task before a specified task within a thread, then auto-renumber tasks.

i2code plan insert-task-before <plan_file> --thread <N> --before <M> --title <title> --task-type <INFRA|OUTCOME> --entrypoint <cmd> --observable <text> --evidence <cmd> --steps <json> --rationale <text>

The --steps argument is a JSON array of step description strings.

insert-task-after

Insert a task after a specified task within a thread, then auto-renumber tasks.

i2code plan insert-task-after <plan_file> --thread <N> --after <M> --title <title> --task-type <INFRA|OUTCOME> --entrypoint <cmd> --observable <text> --evidence <cmd> --steps <json> --rationale <text>

reorder-tasks

Reorder tasks within a thread according to a specified ordering, then auto-renumber tasks.

i2code plan reorder-tasks <plan_file> --thread <N> --order <comma-separated-task-numbers> --rationale <text>

Example: --thread 1 --order 3,1,2 moves task 1.3 to position 1.1, task 1.1 to position 1.2, task 1.2 to position 1.3.

Errors if --order does not contain exactly the set of existing task numbers in the thread, or if the thread does not exist.

move-task-before

Move a task to before another task within the same thread, then auto-renumber tasks.

i2code plan move-task-before <plan_file> --thread <N> --task <M> --before <P> --rationale <text>

Example: --thread 1 --task 6 --before 3 moves task 1.6 to the position before task 1.3.

Errors if the thread or either task does not exist, or if task and before are the same.

move-task-after

Move a task to after another task within the same thread, then auto-renumber tasks.

i2code plan move-task-after <plan_file> --thread <N> --task <M> --after <P> --rationale <text>

Example: --thread 1 --task 1 --after 3 moves task 1.1 to the position after task 1.3.

Errors if the thread or either task does not exist, or if task and after are the same.

replace-task

Replace a task's content in place within a thread, then auto-renumber tasks. Equivalent to delete-task followed by insert-task but atomic.

i2code plan replace-task <plan_file> --thread <N> --task <M> --title <title> --task-type <INFRA|OUTCOME> --entrypoint <cmd> --observable <text> --evidence <cmd> --steps <json> --rationale <text>

The --steps argument is a JSON array of step description strings.

Errors if the thread or task does not exist.

delete-task

Remove a task from a thread, then auto-renumber remaining tasks.

i2code plan delete-task <plan_file> --thread <N> --task <M> --rationale <text>

Errors if the thread or task does not exist.

delete-thread

Remove a thread entirely, then auto-renumber remaining threads and tasks.

i2code plan delete-thread <plan_file> --thread <N> --rationale <text>

Errors if the thread does not exist.