Ca Task

/ca-task — task-board writer

The one blessed way to mutate <project-root>/.codearbiter/open-tasks.md (resolves D-1). Hand-editing the board is no longer the only path; this command keeps every entry schema-conformant and every transition dated. The board LOGIC lives in the pure _taskboardlib transforms; this command runs the thin writer taskwrite.py from the selected installed package.

Before an authorized board mutation, read the installed helper card:

../../includes/helper-invocation.md relative to this loaded skill. Set its loaded-resource input to the absolute path of this loaded command or skill, and select the literal relative helper hooks/taskwrite.py. Resolve and check that helper exactly once using the card, then run its interpreter-selection block for the current shell. Run from the intended project worktree so the writer targets that project's board. Do not switch to the plugin directory, use a root token from a hook environment in an ordinary tool call, or search source/cache copies.

Verbs

Always put -- before user text (a desc or title) so a value beginning with - is not parsed as a flag. Use the validated Python 3 interpreter selected by the card; never retry a refused helper under another interpreter. Keep every option before -- and pass user text as one literal argument.

• add — append a queued task. ID-less by default; pass --id <group>.<type> to mint a dotted ID now, --from <origin> for a harvest back-ref, --boundaries a,b for the security/trust boundaries it touches. The description must be nonblank and single-line; origin and boundary values must also stay on one line.
  • Invoke the resolved helper with add [--id group.type] [--from origin] [--boundaries a,b] -- <desc>.
• start — flip a task to in-progress and stamp the started date (so it can never be a dateless [~]). On an ID-less item, pass --as <group>.<type> to mint its dotted ID at pick-up. --date YYYY-MM-DD overrides today.
  • Invoke the resolved helper with start [--as group.type] [--date YYYY-MM-DD] -- <id|title>.
• done — flip an in-progress task to done and stamp the done date (--date overrides today). A queued task must be started first.
  • Invoke the resolved helper with done [--date YYYY-MM-DD] -- <id|title>.

The following are literal minimal add invocations after the installed helper and interpreter have been resolved. Bind the named text variable to the exact caller-supplied description; do not paste that text into the command syntax.

PowerShell add invocation

& $caPython -B $caHelper add -- $caDescription
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }

POSIX add invocation

"$ca_python" -B "$ca_helper" add -- "$ca_description"

When add needs fields, bind each value separately and keep all options before --. Use the --from=<value> form if the origin begins with a hyphen. These examples preserve quotes, metacharacters, and non-ASCII description text as one argument; neither shell evaluates the variable's contents as a command.

PowerShell add with options

$caAddArgs = @('add', '--id', $caId, "--from=$caOrigin", '--boundaries', $caBoundaries, '--', $caDescription)
& $caPython -B $caHelper @caAddArgs
if ($LASTEXITCODE -ne 0) { exit $LASTEXITCODE }