tok.toml

  1# SPDX-FileCopyrightText: Amolith <amolith@secluded.site>
  2#
  3# SPDX-License-Identifier: CC0-1.0
  4
  5# plan rendering
  6[plan]
  7no_goal = "No goal set yet"
  8legend_label = "Legend:"
  9no_tasks = "No tasks yet."
 10
 11# status labels
 12[status]
 13pending = "pending"
 14in_progress = "in progress"
 15completed = "completed"
 16failed = "failed"
 17cancelled = "cancelled"
 18
 19# shared helpers
 20[session]
 21none_active = "No active session. Start one with `np s`."
 22
 23# start command (cmd/s.go)
 24[session.start]
 25already_active = "Session %s is already active for %s.\n"
 26already_active_guidance = "Ask your operator whether they want to resume (`np r`) or archive (`np a`) it."
 27now_active = "Session %s is now active for %s.\n\n"
 28guidance = """If you haven't already, read any provided issue/ticket/file/webpage/commit/etc. references and thoroughly mull them over. If you already see the contents above, don't re-read them. If there were no referenced files or you don't have a clear picture of the issue, you may selectively read additional relevant files until you do have a clear picture.
 29Set the goal with `np g s -t "goal title" -d "goal description"`.
 30Capture the most concise form of the overarching goal using no more than 20 words in the title. Elaborate _usefully_ in the description; don't just repeat the title in more flowery language. In case we're interrupted and need to pick up from this plan later, include:
 31- Summaries of only the relevant portions of the referenced content. Include their URLs/IDs/hashes. Copy the user's language around the references: if they say 'look at bug REF', use 'Bug: REF' near the summary. If 'issue NUM', then 'Issue: NUM.'
 32- Paths to the relevant files, and if there are particularly relevant symbols from those files, include them too. DO NOT summarise the files or symbols. Only list them if they're relevant
 33- An 'Immediate thoughts:' line at the bottom. You should have enough files to have some idea of the issue and its resolution; briefly capture your immediate thoughts in this line, couching with appropriate uncertainty.
 34Add single tasks with `np t a -t "task" -d "details"`, but prefer batching. For multi-line descriptions, use literal newlines:
 35    np t a -t "first task" -d "step 1 details" -t "second task" -d "step 2 with
 36    more details" -t "third task" -d "step three"
 37Keep task statuses up to date as you work:
 38  Single update:  `np t u -i task-id -s in_progress|completed|failed|cancelled`
 39  But prefer batching:  `np t u -i abc123 -s completed -i def456 -s in_progress`
 40Use `np p` if you need to review the full plan."""
 41
 42# resume command (cmd/r.go)
 43[session.resume]
 44header = "\nResuming session. To continue:"
 45guidance = """1. Thoroughly consider the goal and its description.
 462. Read the referenced files and symbols, especially in the pending tasks, to understand what work remains.
 473. Add more tasks if needed. For multi-line descriptions, use literal newlines:
 48       # Single
 49       np t a -t "task title" -d "details"
 50
 51       # Batch (preferred for multiple additions)
 52       np t a -t "first" -d "step 1 details" -t "second" -d "step 2 with
 53       more details" -t "third" -d "step three"`
 544. Update task status as you work:
 55     Single: `np t u -i <task-id> -s <status>`
 56     Batch:  `np t u -i <id1> -s <status1> -i <id2> -s <status2>`
 57   Statuses: pending, in_progress, completed, failed, cancelled"""
 58in_progress_count = "\n%d task(s) are in progress.\n"
 59pending_count = "%d task(s) are pending.\n"
 60
 61# archive command (cmd/a.go)
 62[session.archive]
 63success = "Session %s archived.\n"
 64none_active = "No active session. Start one with `np s`."
 65
 66# goal set command (cmd/g/s.go)
 67[goal.set]
 68title_required = "Goal title is required."
 69description_required = "Goal description is required."
 70already_set = "Goal already set. Use 'np g u' to update it (requires -r/--reason flag)."
 71guidance = "Study everything above carefully, the reference content, the source code, the documentation, etc. Once you've a solid understanding of how to approach resolving the request, fill out your task list. Prefer adding/updating in batch."
 72
 73# goal update command (cmd/g/u.go)
 74[goal.update]
 75not_set = "No goal set yet. Use 'np g s' first."
 76reason_required = "Reason is required for goal updates."
 77title_empty = "Goal title cannot be empty."
 78no_changes_provided = "Provide at least one of --title or --description to update the goal."
 79no_changes_made = "Goal already matches the provided values; no changes made."
 80guidance = "Goal updated. Ensure pending tasks still align with the goal and adjust them and/or add new tasks if necessary."
 81
 82# task add command (cmd/t/a.go)
 83[task.add]
 84count_mismatch = "Number of titles and descriptions must match."
 85none_provided = "Provide at least one task with -t title -d description."
 86title_empty_at = "Task title at position %d cannot be empty.\n"
 87title_empty = "Task title cannot be empty."
 88success = "Added %d task(s).\n"
 89guidance = """Update task statuses as you work:
 90  Single: `np t u -i task-id -s in_progress|completed|failed|cancelled`.
 91  Batch:  `np t u -i abc123 -s completed -i def456 -s in_progress`."""
 92
 93# task list command (cmd/t/t.go)
 94[task.list]
 95invalid_status = "Invalid status %q. Valid: pending, in_progress, completed, failed, cancelled, all.\n"
 96
 97# task update command (cmd/t/u.go)
 98[task.update]
 99no_ids = "Provide at least one task ID with -i/--id."
100title_desc_single_only = "Title and description updates are only supported for single task updates."
101status_count_mismatch = "Multiple task IDs provided but status count doesn't match. For batch updates, provide equal -i and -s flags."
102invalid_status = "Invalid status %q for task %s. Valid: pending, in_progress, completed, failed, cancelled.\n"
103reason_required_status = "Reason (-r/--reason) is required when changing status to cancelled or failed."
104not_found = "Task %q not found in current session.\n"
105no_updates = "No tasks were updated (all tasks either not found or already at target status)."
106success = "Updated %d task(s).\n"
107none_pending_archive = "No pending tasks remaining. If you've completed the goal, escalate to the operator and ask whether to archive the session (`np a`)."
108continue_working = "Continue working through remaining tasks. Use `np t u -i <id1> -s <status1> -i <id2> -s <status2>` to update multiple tasks at once."
109title_empty = "Task title cannot be empty."
110invalid_status_single = "Invalid status %q. Valid: pending, in_progress, completed, failed, cancelled.\n"
111no_changes_provided = "Provide at least one of --title, --description, or --status to update the task."
112reason_required = "Reason (-r/--reason) is required for title/description updates or when changing status to cancelled/failed."
113completed_continue = "Task marked completed. Continue working through remaining tasks. Use `np t u -i <id1> -s <status1> -i <id2> -s <status2>` to update multiple at once."
114updated_review = "Task updated. Use `np p` to review the full plan."