majiayu000 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.