kanon-cli 0.1.0 → 0.1.2

package/src/prompts/templates.js

@@ -5,31 +5,44 @@
 
 export const DEFAULT_SYSTEM = `You are a Kanon board agent. You interact with the board using the \`kanon\` CLI which is in your PATH. The CLI is already authenticated.
 
+The card details below already contain the full card content — do NOT re-read the card with \`kanon card <id>\` unless you need to refresh after making changes.
+
 ## Key Commands
 \`\`\`
-kanon card <id>                          — Read card details
-kanon card create "title" "list" [opts]  — Create card
-kanon card update <id> [opts]            — Update card (--comment, --add-label, --move, --done, etc.)
-kanon board                              — Board context (lists, labels, members)
-kanon cards                              — List all cards
-kanon help-all                           — Full command reference with all options
+kanon card update <id> --comment "text"  — Add a comment
+kanon card update <id> --move "List"     — Move card to a list (by name)
+kanon card update <id> --done            — Mark card as done
+kanon card update <id> --description "x" — Set description
+kanon card update <id> --add-label "x"   — Add a label
+kanon card <id>                          — Re-read card (only if needed)
+kanon board                              — Board context (only if you need list names or members)
+kanon cards                              — List all cards (only if task requires it)
+kanon subcard <parentId>                  — List subcards
+kanon subcard <parentId> nest <cardId>   — Nest card under parent
+kanon subcard <parentId> unnest <cardId> — Unnest card from parent
+kanon card create <title> <list> --parent <id> — Create as subcard
+kanon sheet <id>                         — Read sheet data
+kanon sheet <id> set <tab> <row> <col> "val" — Set cell (0-indexed)
+kanon sheet <id> export                  — CSV output
+kanon note <id>                          — Read note text
+kanon note <id> set "text"               — Set note text
+kanon note <id> append "text"            — Append to note
+kanon canvas <id>                        — Read canvas objects & connections
+kanon help-all                           — Full command reference
 \`\`\`
 
-Run \`kanon help-all\` to see all available commands including checklists, labels, lists, and attachments.
 Be concise and fast. Do not explain what you will do — just do it.`;
 
-export const DEFAULT_TASK = `When you receive a card:
-1. Read the title, description, labels, and comments to understand what needs to be done.
-2. If the card references other cards, use \`kanon card <id>\` to read them.
-3. If you need board context (available lists, labels, members), use \`kanon board\`.
-4. Execute the task. If it involves code changes, implement them, then commit and push.
-5. When you start working, move the card to an "In Progress" list if one exists.
-6. When done, add a brief comment summarizing what you did.
-7. When the task is fully complete, move the card to a "Review" list if one exists and mark it as done.
-8. If something is unclear, add a comment with your questions instead of guessing.
+export const DEFAULT_TASK = `## Instructions
+1. The card details above are already complete — start working immediately.
+2. If the task involves code changes, implement them, then commit and push.
+3. When done, add a brief comment summarizing what you did.
+4. Move the card to "Review" and mark it done:
+   \`kanon card update <id> --move "Review" --done\`
+5. If something is unclear, add a comment with your questions instead of guessing.
 
-Do not modify cards you were not asked to work on.
-Always read the full card before taking action — check comments for recent feedback.`;
+Do not run \`kanon board\`, \`kanon cards\`, or \`kanon help-all\` unless the task specifically requires that information.
+Do not modify cards you were not asked to work on.`;
 
 export const DEFAULT_BUNDLE = `You have multiple cards to work on. Review each card below and process them.
 Use sub-agents (the Agent tool) to work on cards in parallel where possible.
@@ -40,7 +53,10 @@ For each card, follow the task instructions above.`;
  * Format card details into a readable block.
  */
 export function formatCard(card) {
-  const parts = [`Card ID: ${card.id}`, `Title: ${card.title}`];
+  const parts = [`Card ID: ${card.id}`];
+  if (card.boardId) parts.push(`Board ID: ${card.boardId}`);
+  if (card.list_name) parts.push(`List: ${card.list_name}`);
+  parts.push(`Title: ${card.title}`);
 
   if (card.description) {
     parts.push(`Description: ${card.description}`);
@@ -60,6 +76,26 @@ export function formatCard(card) {
     }
   }
 
+  if (card.subcards?.length) {
+    parts.push(`\nSubcards:`);
+    for (const sc of card.subcards) {
+      const done = sc.is_done ? ' [done]' : '';
+      parts.push(`- ${sc.title} (${sc.id})${done}`);
+    }
+  }
+
+  if (card.parent_card_id) {
+    parts.push(`Parent card: ${card.parent_card_id}`);
+  }
+
+  const attachments = [];
+  if (card.has_sheet) attachments.push('sheet');
+  if (card.has_note) attachments.push('note');
+  if (card.has_whiteboard) attachments.push('canvas');
+  if (attachments.length) {
+    parts.push(`Attachments: ${attachments.join(', ')} (use \`kanon ${attachments[0]} ${card.id}\` to read)`);
+  }
+
   if (card.comments?.length) {
     parts.push(`\nComments (newest first):`);
     for (const c of card.comments.slice(0, 10)) {