create-tasks

Create Tasks

Create only tasks justified by the request. Use the kotgent CLI for tracker operations and git for repository identity and provenance. Do not use an MCP server, SDK, direct daemon request, or helper script.

Honor the command contract

• Run each kotgent invocation as a standalone command. Do not pipe or post-process it inline, merge stderr into stdout, or append an echo of the status; those forms hide the command's real exit code or destroy the stdout/stderr contract.
• Treat successful task and project stdout as one JSON value. Treat failure stderr as one JSON object.
• Treat exit 2 as a command-construction bug: stderr may be plain usage text. Stop and report the exact command and stderr; do not retry it unchanged.
• Never run project init, project restore, or project delete in this workflow.
• Never delete already-created tasks to roll back a partial batch.
• Resolve the current session from the live kotgent pane by default. Never read KOTGENT_SESSION_ID as identity or copy it into --session. Use --session only for a caller outside a kotgent pane when the invocation context or user explicitly supplied the exact current session ID.

Preflight

Complete every check before creating the first task:

1. Run git --version and kotgent --version. Stop if either command is unavailable.
2. Resolve the repository root with git rev-parse --show-toplevel. Stop outside a Git worktree.
3. Establish one identity mode before any tracker mutation:
   • In the normal pane mode, run a ref-less kotgent task show. Accept exit 0, or exit 1 with empty stdout, no status, and error exactly equal to this session is not linked to a task — name one, or link one with `kotgent task claim <ref>` . Any other response means pane resolution failed; stop rather than adding --session from the environment.
   • Outside a kotgent pane, require an exact session ID explicitly supplied by the invocation context or user, then run kotgent task show --session <session-id>. Accept exit 0, or exit 1 with empty stdout, no status, and error exactly equal to session '<session-id>' is not linked to a task — name one: kotgent task <command> <ref> --session <session-id>. Never infer an ID from a provider conversation, environment variable, name, cwd, recency, or kotgent list. Keep the chosen mode for the whole run.
4. Inspect <root>/.kotgent.json and resolve one of these project states:
   • If the file exists, require valid JSON and a UUID-shaped id. Run kotgent project list. If it contains that ID, record the live project UUID and run kotgent task list --project <project-uuid>.
   • If the descriptor's ID is absent from the live list, run kotgent project list --archived. Stop if that ID is archived; never restore it. If it is absent there too, leave the project unresolved so the first contextual task add adopts the committed descriptor.
   • If the file is absent, do not stop and do not run project init. Leave the project unresolved so the first contextual task add creates the descriptor and project.
5. Resolve the full commit with git rev-parse HEAD; stop if HEAD does not exist or is not a full SHA. Resolve the branch with git symbolic-ref --quiet --short HEAD; use the literal detached only when that command reports detached HEAD.
6. Select the exact active host label: Codex, Claude Code, or Junie.