Skip to content

Devlog

This is a chronological record of decisions and development notes for the Trailblaze project. Each entry captures a moment in time — what we were thinking, what we decided, and why.

Entries tagged as Decision record significant architectural or technical choices. Other entries are development notes that capture implementation details, debugging sessions, and lessons learned.

Index

Auto-generated. Do not edit manually.

Date Title Type
2026-04-23 On-device MCP tool callbacks — direct QuickJS binding Decision
2026-04-22 A TrailblazeTool is a function call (MCP tool, RPC request — same thing) Devlog
2026-04-22 Scripting SDK — Envelope Migration & Callback Transport (D1 + D2) Decision
2026-04-22 Scripting SDK — client.callTool Round-Trip Decision
2026-04-22 @trailblaze/scripting — Authoring Vision & Roadmap (for TS authors) Decision
2026-04-21 Waypoint Discovery via matchWaypoint — Agent-Driven, Retroactive Devlog
2026-04-21 Scripted Tools — MCP Server Integration Patterns (forward-looking) Decision
2026-04-21 runTrail: Trail-as-Tool Primitive (Proposal) Devlog
2026-04-21 Maestro Scripting & Flow Control — Comparison and Self-Validation Devlog
2026-04-20 YAML-Defined Tools (the tools: mode) Decision
2026-04-20 Scripted Tools — Toolset Consolidation & Revised Sequencing Decision
2026-04-20 Scripted Tools PR A5 — MCP Toolsets Bundled for On-Device Decision
2026-04-20 Scripted Tools PR A3 — MCP SDK Subprocess Toolsets Decision
2026-04-20 Scripted Tools — MCP Extension Conventions Decision
2026-04-20 Scripted Tools Execution Model (QuickJS + Synchronous Host Bridge) Decision
2026-04-20 Scripted Tools PR A3 Phase 1 — Subprocess MCP Client, Lifecycle, and Registration Decision
2026-04-20 Scripted Tools PR A3 — Host-Side Subprocess MCP Toolsets (Scope) Decision
2026-04-20 Scripted Tools PR A2 — Synchronous Tool Execution from JS Decision
2026-04-15 Ref-Based Tap Replaces Node ID Tap Decision
2026-04-12 Platform-Native Hierarchical Snapshots with Stable Element Refs Decision
2026-04-10 CLI and MCP Session Management: Device State and Multi-Terminal Behavior Devlog
2026-04-07 Unified Provider Auto-Detection Across Host and Android Decision
2026-04-07 Workspace Config Resolution: .trailblaze/ and trailblaze-config/ Conventions Decision
2026-04-07 Unified trailblaze-config/ Classpath Layout Decision
2026-04-07 Support reasoning_effort in LLM Config Devlog
2026-04-07 CLI-Based SSO/Auth and Dynamic On-Device Instrumentation Args Devlog
2026-03-20 Screenshot Format Optimization (WebP Everywhere) Decision
2026-03-17 MCP API Redesign: verify→blaze, Mode Defaults, iOS launchApp Fix Devlog
2026-03-17 iOS TrailblazeNode Support via IosMaestro Devlog
2026-03-15 MCP STDIO-to-HTTP Proxy for Development Devlog
2026-03-11 Waypoints and App Navigation Graphs Decision
2026-03-09 Recording Optimization Pipeline Decision
2026-03-09 Agentic Development Loop Decision
2026-03-06 Trail YAML v2 Syntax Decision
2026-03-04 TrailblazeNode — Type-Safe Driver-Specific View Hierarchy Decision
2026-02-20 Scripted Tools Vision (TypeScript/QuickJS) Decision
2026-02-20 Recording Memory Template Substitution Decision
2026-02-09 Agent Resilience, Maestro Decoupling, and Driver-Specific Hierarchies Decision
2026-02-04 Trail/Blaze Agent Architecture Decision
2026-02-04 Mobile-Agent-v3 Integration Plan Decision
2026-02-04 LLM Provider Configuration Decision
2026-02-04 App Target Configuration Decision
2026-02-03 Custom Tool Architecture Decision
2026-01-29 Device-Specific Trail Recordings Decision
2026-01-29 AI Fallback Decision
2026-01-28 Trailblaze MCP Decision
2026-01-28 Logging and Reporting Architecture Decision
2026-01-28 Kotlin as Primary Language Decision
2026-01-28 Koog Library for LLM Communication Decision
2026-01-28 Desktop Application (Moving Away from IDE-based Execution) Decision
2026-01-28 Custom Tool Authoring Decision
2026-01-28 Handwritten Agent Loop Decision
2026-01-14 Tool Naming Convention Decision
2026-01-01 Tool Execution Modes Decision
2026-01-01 Maestro as Current Execution Backend Decision
2025-10-01 Trail Recording Format (YAML) Decision
2025-10-01 LLM as Compiler Architecture Decision