kanon-cli 0.1.0

package/src/prompts/templates.js

@@ -0,0 +1,127 @@
+/**
+ * Unified prompt builder for Kanon agent.
+ * Builds a single prompt from config-defined system + task prompts and card context.
+ */
+
+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.
+
+## 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
+\`\`\`
+
+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.
+
+Do not modify cards you were not asked to work on.
+Always read the full card before taking action — check comments for recent feedback.`;
+
+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.
+If cards might conflict (e.g. editing the same files), process them sequentially.
+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}`];
+
+  if (card.description) {
+    parts.push(`Description: ${card.description}`);
+  }
+
+  if (card.labels?.length) {
+    parts.push(`Labels: ${card.labels.map(l => l.name).join(', ')}`);
+  }
+
+  if (card.checklists?.length) {
+    for (const cl of card.checklists) {
+      parts.push(`\nChecklist: ${cl.title}`);
+      for (const item of cl.items || []) {
+        const status = item.completed ? '[x]' : '[ ]';
+        parts.push(`- ${status} ${item.text}`);
+      }
+    }
+  }
+
+  if (card.comments?.length) {
+    parts.push(`\nComments (newest first):`);
+    for (const c of card.comments.slice(0, 10)) {
+      const author = c.user?.name || c.user_name || 'Unknown';
+      parts.push(`\n${author} (${c.created_at}):\n${c.text}`);
+    }
+  }
+
+  return parts.join('\n');
+}
+
+/**
+ * Build a unified prompt from config and card context.
+ * @param {object} card - Full card object with title, description, labels, comments, etc.
+ * @param {object} config - Project config containing prompts.system and prompts.task
+ * @returns {string} Complete prompt string
+ */
+/**
+ * Build a unified prompt from config and card context.
+ * @param {object} card - Full card object
+ * @param {object} config - Project config containing prompts.system and prompts.task
+ * @param {string} [extraPrompt] - Optional extra prompt from the trigger rule
+ * @returns {string} Complete prompt string
+ */
+export function buildPrompt(card, config, extraPrompt = '') {
+  const systemPrompt = config?.prompts?.system || DEFAULT_SYSTEM;
+  const taskPrompt = config?.prompts?.task || DEFAULT_TASK;
+
+  let prompt = `${systemPrompt}
+
+## Card Details
+${formatCard(card)}
+
+${taskPrompt}`;
+
+  if (extraPrompt) {
+    prompt += `\n\n## Trigger Context\n${extraPrompt}`;
+  }
+
+  return prompt;
+}
+
+/**
+ * Build a bundled prompt for multiple cards.
+ * @param {Array<{card: object, extraPrompt?: string}>} tasks - Array of card tasks
+ * @param {object} config - Project config containing prompts
+ * @returns {string} Combined prompt string
+ */
+export function buildBundlePrompt(tasks, config) {
+  const systemPrompt = config?.prompts?.system || DEFAULT_SYSTEM;
+  const taskPrompt = config?.prompts?.task || DEFAULT_TASK;
+  const bundlePrompt = config?.prompts?.bundle || DEFAULT_BUNDLE;
+
+  let prompt = `${systemPrompt}\n\n${bundlePrompt}\n`;
+
+  for (let i = 0; i < tasks.length; i++) {
+    prompt += `\n---\n\n## Card ${i + 1}\n${formatCard(tasks[i].card)}\n`;
+    if (tasks[i].extraPrompt) {
+      prompt += `\nTrigger context: ${tasks[i].extraPrompt}\n`;
+    }
+  }
+
+  prompt += `\n---\n\n${taskPrompt}`;
+  return prompt;
+}