refactor!: migrate task and journal tools to TypeScript with YAML storage

Author: apiad

.opencode/AGENTS.md

@@ -28,19 +28,20 @@ This is a personal starter project using OpenCode for AI-assisted development.
 ## Workflow Conventions
 
 ### Task Management
-- Use the `task` tool to manage TASKS.md
+- Use the `task` tool to manage tasks in `tasks.yaml`
 - All task modifications must go through the tool
-- Task format: `- [status] **ID** Label: Description (Complexity: X) [Deps: Y] (See plan: Z)`
+- Storage: `tasks.yaml` (YAML format)
+- Actions: `add`, `start`, `cancel`, `archive`, `attach-plan`, `list`
 
 ### Journaling
 - Use the `journal` tool to add daily entries
-- Format: `[YYYY-MM-DDTHH:MM:SS] - description`
-- Journal entries must be newer than recent changes for commits
+- Storage: `journal/YYYY-MM-DD.yaml` (YAML format)
+- Actions: `add`, `list`
 
 ### Planning
 - Plans are saved to `plans/` directory
 - Filenames: kebab-case (e.g., `plans/implement-auth.md`)
-- Link plans to tasks via `task` tool
+- Link plans to tasks via `task attach-plan` action
 
 ### Pre-commit Validation
 - Run `git_precommit` tool before committing
@@ -51,11 +52,11 @@ This is a personal starter project using OpenCode for AI-assisted development.
 .opencode/
 ├── agents/          # Agent definitions
 ├── commands/        # High-level commands
-├── tools/           # Custom tools
+├── tools/           # Custom tools (TypeScript)
 └── style-guide.md   # Prose style rules
 
 plans/               # Saved plans
-journal/             # Daily journal entries
+journal/             # Daily journal entries (YAML)
 research/           # Research assets
-TASKS.md            # Project roadmap
+tasks.yaml          # Project roadmap (YAML)
 ```

.opencode/tools/journal.py

@@ -1,14 +1,109 @@
-import { tool } from "@opencode-ai/plugin"
-import { $ } from "bun"
+import { tool } from "@opencode-ai/plugin";
+
+interface JournalEntry {
+  timestamp: string;
+  message: string;
+}
+
+interface JournalData {
+  date: string;
+  entries: JournalEntry[];
+}
+
+const JOURNAL_DIR = "journal";
+
+function getToday(): string {
+  return new Date().toISOString().split("T")[0];
+}
+
+function getJournalPath(date: string): string {
+  return `${JOURNAL_DIR}/${date}.yaml`;
+}
+
+async function loadJournal(date: string): Promise<JournalData> {
+  const path = getJournalPath(date);
+  const file = Bun.file(path);
+  if (!await file.exists()) {
+    return { date, entries: [] };
+  }
+  const content = await file.text();
+  if (!content.trim()) {
+    return { date, entries: [] };
+  }
+  return parseYaml(content, date);
+}
+
+function parseYaml(content: string, date: string): JournalData {
+  const lines = content.split("\n");
+  const data: JournalData = { date, entries: [] };
+  let inEntries = false;
+
+  for (const line of lines) {
+    if (line.startsWith("date:")) {
+      const match = line.match(/date: "(.+)"/);
+      if (match) data.date = match[1];
+    } else if (line.startsWith("entries:")) {
+      inEntries = true;
+    } else if (inEntries && line.match(/^  - timestamp:/)) {
+      const match = line.match(/timestamp: "(.+)"/);
+      if (match) {
+        data.entries.push({ timestamp: match[1], message: "" });
+      }
+    } else if (inEntries && line.match(/^    message:/) && data.entries.length > 0) {
+      const match = line.match(/message: "(.+)"/);
+      if (match) {
+        data.entries[data.entries.length - 1].message = match[1];
+      }
+    }
+  }
+
+  return data;
+}
+
+function toYaml(data: JournalData): string {
+  const lines: string[] = [];
+  lines.push(`date: "${data.date}"`);
+  lines.push("entries:");
+  for (const entry of data.entries) {
+    lines.push(`  - timestamp: "${entry.timestamp}"`);
+    lines.push(`    message: "${entry.message}"`);
+  }
+  return lines.join("\n") + "\n";
+}
 
 export default tool({
-  description: "Add a journal entry with timestamp for today's date",
+  description: "Manage journal entries. Actions: add (add entry for today), list (show today's entries)",
   args: {
-    description: tool.schema.string().describe("Journal entry description"),
+    action: tool.schema.string().describe("Action: add or list"),
+    message: tool.schema.string().optional().describe("Journal entry message (for add)"),
   },
   async execute(args) {
-    const script = ".opencode/tools/journal.py"
-    const result = await $`python3 ${script} ${args.description}`.text()
-    return result
+    const action = args.action || "add";
+    const now = new Date();
+    const timestamp = now.toISOString();
+    const today = now.toISOString().split("T")[0];
+
+    if (action === "list") {
+      const data = await loadJournal(today);
+      if (data.entries.length === 0) {
+        return `No journal entries for ${today}`;
+      }
+      let output = `# Journal - ${today}\n\n`;
+      for (const entry of data.entries) {
+        const time = entry.timestamp.split("T")[1].split(".")[0];
+        output += `- [${time}] ${entry.message}\n`;
+      }
+      return output;
+    }
+
+    const message = args.message;
+    if (!message) {
+      return "Error: --message is required for add action";
+    }
+
+    const data = await loadJournal(today);
+    data.entries.push({ timestamp, message });
+    await Bun.write(getJournalPath(today), toYaml(data));
+    return `Added journal entry: [${timestamp}] - ${message}`;
   },
-})
+});

.opencode/tools/journal.ts

@@ -2,6 +2,7 @@
 import os
 import subprocess
 import sys
+import re
 from datetime import date, datetime
 
 def run_command(command):
@@ -10,7 +11,7 @@ def run_command(command):
 
 def main():
     today = date.today().strftime("%Y-%m-%d")
-    journal_path = f"journal/{today}.md"
+    journal_path = f"journal/{today}.yaml"
 
     res = run_command("git status --porcelain")
     changed_files = [line[3:] for line in res.stdout.strip().splitlines() if line]
@@ -27,7 +28,7 @@ def main():
             print(res.stderr)
             return res.returncode
 
-    meaningful_changes = [f for f in changed_files if not f.startswith(".gemini") and not f.startswith(".opencode") and f != journal_path]
+    meaningful_changes = [f for f in changed_files if not f.startswith(".gemini") and not f.startswith(".opencode") and f != journal_path and not f.endswith(".yaml")]
 
     if not meaningful_changes:
         return 0
@@ -41,36 +42,32 @@ def main():
 
     if not os.path.exists(journal_path):
         print(f"Error: Updated journal required. Please read the latest entries in journal/ to understand context,")
-        print(f"then use: journal <one line summary of changes>")
+        print(f"then use: journal add \"one line summary of changes\"")
         return 1
 
     with open(journal_path, "r") as f:
-        lines = [l.strip() for l in f.readlines() if l.strip()]
-
-    if not lines:
-        print(f"Error: Journal {journal_path} is empty.")
-        print(f"Please use: journal <one line summary of changes>")
-        return 1
-
-    last_line = lines[-1]
-    if not (last_line.startswith("[") and "] - " in last_line):
-        print(f"Error: Invalid journal entry format in {journal_path}: '{last_line}'")
-        print(f"Expected format: '[YYYY-MM-DDTHH:MM:SS] - description'")
-        print(f"Please use: journal <one line summary of changes>")
+        content = f.read()
+
+    # Parse YAML to find last timestamp
+    # Look for pattern: timestamp: "YYYY-MM-DDTHH:MM:SS"
+    timestamps = re.findall(r'timestamp: "(.+)"', content)
+    
+    if not timestamps:
+        print(f"Error: No journal entries found in {journal_path}")
+        print(f"Please use: journal add \"one line summary of changes\"")
         return 1
 
     try:
-        ts_str = last_line[1:last_line.index("]")]
-        last_entry_time = datetime.fromisoformat(ts_str).timestamp()
+        last_entry_time = datetime.fromisoformat(timestamps[-1]).timestamp()
     except (ValueError, IndexError):
-        print(f"Error: Could not parse timestamp from journal entry: '{last_line}'")
-        print(f"Please use: journal <one line summary of changes>")
+        print(f"Error: Could not parse timestamp from journal entry: '{timestamps[-1]}'")
+        print(f"Please use: journal add \"one line summary of changes\"")
         return 1
 
     if last_entry_time < max_mtime:
         print(f"Error: Last journal entry is older than recent changes.")
         print(f"Please read {journal_path} to catch up, then add a summary of your latest work using:")
-        print(f"journal <one line summary of changes>")
+        print(f"journal add \"one line summary of changes\"")
         return 1
 
     return 0