docs: update CHANGE.md and README.md for v1.0.1 release

CHANGE.md

@@ -6,48 +6,50 @@ This document tracks all significant changes to Gadget Code, organized by date.
 
 ## 2026-05-17 (Sunday)
 
-**Subagent Context Management and Tooling Stability**
+**Release Hardening, Subagent Improvements, and Workspace Intelligence**
 
-Today's focus shifted towards improving subagent context management and stabilizing developmental tools, including a fix for the prompt editor.
+The day focused on preparing the v1.0.1 release with a hardened release script, fixing subagent context management, adding prompt draft persistence, and implementing intelligent workspace startup that detects the workspace directory by walking up the file hierarchy.
 
 ### Changes:
-- **Subagent**: Implemented improvements to subagent context management.
+- **Release**: Added hardened release script with error handling and pre-flight checks.
-- **Development**: Fixed prompt editor functionality.
+- **Subagent**: Improved subagent context management for more reliable agent operations.
-- **Documentation**: Added gadget-tasks architecture documentation and updated technical documentation (README, `agent-toolbox.md`).
+- **Chat Session**: Implemented prompt draft save/restore so in-progress prompts survive view changes.
-- **Dependencies/Build**: Addressed installation and global link issues.
+- **Workspace**: Added intelligent startup — drone detects workspace by walking up directory hierarchy.
+- **Agent Tools**: Updated plan tool with improved prompt language and behavior.
+- **Prompt Editor**: Expanded prompt editor capabilities.
+- **gadget-tasks**: Course correction — converted to headless IDE client architecture (no direct DB access).
+- **Documentation**: Added gadget-tasks architecture documentation; updated README and agent-toolbox docs.
+- **Build**: Fixed installation and global link issues.
+- **Tests**: Updated code-session tests to match current API expectations.
 
 ---
 
 ## 2026-05-16 (Saturday)
 
-**Gadget-Tasks Architecture Correction and AI Toolbox Refactor**
+**AI Toolbox Extraction and Project Manager Upgrades**
 
-This update covers major architectural changes to `gadget-tasks` transition to a headless IDE client and the reorganization of the AI toolbox structure.
+Completed the refactor extracting the AI toolbox from `@gadget/ai` into `@gadget/ai-toolbox`, and implemented Project Manager upgrades across Phases 1–4. Cleaned up incorrect dependencies.
 
 ### Changes:
-- **Architecture**: Converted `gadget-tasks` from directly accessing MongoDB to a headless IDE client architecture using REST API and Socket.IO.
+- **AI Toolbox**: Completed refactor and extraction from `@gadget/ai` into `@gadget/ai-toolbox`.
-- **Infrastructure**: Added `platform.ts` (headless IDE client with session lock and workspace mode) to `gadget-tasks`.
+- **Project Manager**: Implemented upgrades across Phases 1–4.
-- **Cleanup**: Removed duplicated/no longer needed code in `gadget-tasks` (Mongoose models, internal prompt templates, task executor, AI services, and workspace management).
+- **Dependencies**: Removed incorrect `simple-git` package; fixed type references.
-- **AI Toolbox**: Completed refactor and extraction of the AI toolbox from `@gadget/ai` into `@gadget/ai-toolbox`.
-- **Project Manager**: Implemented upgrades across Phases 1-4.
-- **Infrastructure**: Added necessary backend routes (`PATCH /api/v1/projects/:projectId/tasks/:taskId/lastRun`) and service methods for atomic task field updates.
-- **Project Configuration**: Updated `GadgetTasksConfig` and removed unneeded dependencies (`mongoose`, `dayjs`, `simple-git`, etc.).
 
 ---
 
 ## 2026-05-15 (Thursday)
 
-**Context Window Configuration Added**
+**Pull Project, Tool Call Observability, and Context Window Configuration**
 
-The most recent change introduces the `numCtx` (Context Window) setting to the SESSION panel, allowing users to configure the context window size for their AI model sessions. This setting is part of a broader enhancement to the model configuration pipeline that also includes `numPredict` and `maxCompletionTokens` parameters.
+Introduced the Pull Project feature for cloning remote repositories, added tool call observability to the chat session view, and added `numCtx` (Context Window) configuration to the SESSION panel. Also refactored ChatSessionView and added the Gab AI affiliate link.
 
 ### Changes:
-- Added `numCtx` setting to SESSION panel
+- **Pull Project**: Initial implementation for cloning remote repositories into the workspace.
-- Updated model configuration pipeline to include `numPredict`, `numCtx`, and `maxCompletionTokens`
+- **Observability**: Added tool call observability to the chat session view.
-- Modified ChatSessionView to handle new context window settings
+- **File Operations**: Added new file creation capability.
-- Updated session initialization logic to apply context window configuration
+- **SESSION Panel**: Added `numCtx` (Context Window) setting; updated model config pipeline with `numPredict`, `numCtx`, and `maxCompletionTokens`.
-- Added Gab AI affiliate link
+- **ChatSessionView**: Refactored for improved structure; added scripts directory.
-- Changed Ollama abort procedure
+- **Provider**: Added Gab AI affiliate link; changed Ollama abort procedure.
 
 ---
 
@@ -55,84 +57,74 @@ The most recent change introduces the `numCtx` (Context Window) setting to the S
 
 **SubProcess Observability Implementation**
 
-This week focused on implementing comprehensive observability for SubProcess operations within the DroneManager and DroneInspector components, including detailed logging, status tracking, and event emission capabilities.
+Implemented comprehensive observability for SubProcess operations within the DroneManager and DroneInspector components, including status tracking, event emission, and UI display of subprocess execution details.
 
 ### Changes:
-- Implemented Phase 2: SubProcess observability in DroneManager and DroneInspector
+- **SubProcess**: Implemented Phase 1 (SubProcess service and agent tool) and Phase 2 (observability in DroneManager and DroneInspector).
-- Added subprocess status tracking and event emission
+- **UI**: Updated to display subprocess execution details.
-- Updated UI to display subprocess execution details
+- **Fixes**: Fixed mode change log message formatting.
-- Fixed mode change log message formatting
 
 ---
 
 ## 2026-05-13 (Tuesday)
 
-**Documentation and Editor Improvements**
+**CodeMirror Editor Fix and User Mode Documentation**
 
-Documentation updates include adding continuation prompts and remaining steps for User Mode, session summary documentation for MVP completion, and formatting cleanup in AGENTS.md. The editor improvements address a critical issue with CodeMirror editor height constraints in flex layouts.
+Fixed a critical CodeMirror editor height constraint in flex layouts, and added documentation for User Mode continuation prompts and MVP completion summary.
 
 ### Changes:
-- Added continuation prompt and remaining steps for User Mode documentation
+- **Editor**: Fixed CodeMirror editor height constraint in flex layout.
-- Added session summary for User Mode MVP completion
+- **Documentation**: Added continuation prompt and remaining steps for User Mode; added session summary for MVP completion; formatting cleanup in AGENTS.md.
-- Fixed CodeMirror editor height constraint in flex layout
+- **Infrastructure**: Prep work for landing page project.
-- Minor formatting cleanup in AGENTS.md
-- Created new files and prep work for landing page project
 
 ---
 
 ## 2026-05-12 (Monday)
 
-**FILES Panel and Editor Integration**
+**FILES Panel, Editor Integration, and Abort Controller**
 
-This week marked a significant milestone with the implementation of the FILES panel foundation featuring lazy-loading file tree capabilities. The implementation replaced react-ace with @uiw/react-codemirror to resolve React 19 compatibility issues and Vite dev server problems.
+Major milestone: implemented the FILES panel foundation with lazy-loading file tree, replaced react-ace with @uiw/react-codemirror (React 19 compat), added an abort controller for work order processing, and fixed numerous file tree and layout issues.
 
 ### Changes:
-- Implemented FILES panel foundation with lazy-loading file tree
+- **FILES Panel**: Implemented foundation with lazy-loading file tree; fixed scrolling, duplication, corruption, and expand/collapse rendering issues.
-- Replaced react-ace with @uiw/react-codemirror
+- **Editor**: Replaced react-ace with @uiw/react-codemirror for React 19 compatibility; fixed ACE editor crash (Vite `?url` pattern, Error Boundary).
-- Fixed flexbox scrolling for FILES panel sidebar
+- **Layout**: Fixed flexbox scrolling for sidebar; added `shrink-0` to SESSION and PROJECT panels.
-- Added shrink-0 to SESSION and PROJECT panels for proper flex layout
+- **Abort Controller**: Implemented abort controller for work order processing; added Aborted status.
-- Fixed file tree scrolling and text selection issues
+- **Navigation**: Added navigation to project in Project Manager using slug.
-- Fixed file tree backend recursion breaking lazy loading
+- **Socket**: Defined missing socket event types; enforced typed events in frontend build.
-- Fixed file tree showing entire workspace instead of project directory
+- **AI**: Fixed OpenAI API tool call processing correctness.
-- Fixed file tree duplication and corruption on expand
+- **Agent**: Moved plan prompt language from common block; added plan for project-specific agent instructions.
-- Fixed file tree expand/collapse not rendering children
-- Added navigation to project in Project Manager using slug
-- Fixed ACE editor integration crash — React 19 compat, Vite ?url pattern, Error Boundary
-- Fixed file tree duplication and corruption on expand
 
 ---
 
 ## 2026-05-11 (Sunday)
 
-**Subagent Processing and Authentication Fixes**
+**Subagent Processing, Authentication, and Deployment Documentation**
 
-This weekend's work focused on subagent processing improvements and authentication fixes, including fixes for subagent response handling, session data management, and adding the persona field to sign-in responses.
+Focused on subagent processing improvements and authentication fixes, including subagent response handling, session data management, persona field in sign-in responses, and JWT/heartbeat fixes. Added deployment documentation with installation guides, config examples, and systemd service files.
 
 ### Changes:
-- Fixed subagent response handling and session data
+- **Subagent**: Fixed subagent response handling and session data; crushed whitespace in subagent markdown output.
-- Added persona field to sign-in response
+- **Auth**: Added persona field to sign-in response; fixed JWT expiration bugs and drone heartbeat timeouts.
-- Fixed JWT expiration bugs and drone heartbeat timeouts
+- **ChatSession**: Added reconnect logic; fixed crash.
-- Added installation guides, config examples, and systemd service files
+- **Deployment**: Added installation guides, config examples, and systemd service files.
-- Fixed subagent markdown output whitespace using .subagent-compact.gadget-markdown
+- **Model Config**: Added `numPredict`, `numCtx`, `maxCompletionTokens` to model configuration pipeline.
-- Applied CSS and style fixes for subagent display
+- **Style**: CSS and style fixes for subagent display; updated build prompt.
-- Updated build prompt
+- **Architecture**: Integrated docs/archive for reference; subagents system (written by an agent, for an agent).
-- Fixed auth: include persona field in sign-in response
 
 ---
 
 ## 2026-05-10 (Saturday)
 
-**Workspace and Project Philosophy Shift**
+**Workspace and Project Philosophy Refinement**
 
-This weekend involved a philosophical shift in how Workspaces and Projects are conceptualized and implemented, with improved separation of concerns and clearer boundaries between the two concepts.
+Refined the conceptual model separating Workspaces from Projects, improved the chat interface, and fixed credential provider and API key distribution issues.
 
 ### Changes:
-- Applied philosophy shifts for Workspaces and Projects
+- **Architecture**: Applied philosophy shifts for Workspaces and Projects; updated conceptual model.
-- Updated workspace and project conceptual model
+- **Agent Toolbox**: Refactored and updated agent toolbox.
-- Improved separation of concerns between workspace and project
+- **Fixes**: Fixed credential provider; ensured apiKey is presented to required consumers.
-- Chat interface fixes and cleanup
+- **Chat**: Chat interface fixes and cleanup.
-- Credential provider fix
-- Ensure apiKey is presented to required consumers
 
 ---
 
@@ -140,34 +132,29 @@ This weekend involved a philosophical shift in how Workspaces and Projects are c
 
 **Agentic Workflow Loop Rebuild**
 
-This week involved a complete rebuild of the Agentic Workflow Loop to improve reliability and performance, including better error handling, improved checkpointing, and enhanced event emission capabilities.
+Rebuilt the Agentic Workflow Loop from the ground up for improved reliability and performance, with enhanced streaming response handling, chat session auto-naming, and drone-to-IDE log transport.
 
 ### Changes:
-- Re-built Agentic Workflow Loop with improved reliability
+- **AWL**: Re-built Agentic Workflow Loop with improved reliability and checkpointing.
-- Enhanced streaming response handling
+- **Streaming**: Enhanced streaming response handling and correctness.
-- Implemented chat session auto-naming with IDE update
+- **Chat Session**: Implemented auto-naming with IDE update.
-- Improved checkpointing and event emission
+- **Logging**: Added GadgetLogTransportSocket for drone-to-IDE log streaming.
-- GadgetLogTransportSocket and the drone-to-IDE log
 
 ---
 
 ## 2026-05-08 (Thursday)
 
-**Chat Session Heartbeat and User Settings**
+**Chat Session Heartbeat, User Settings, and Logging Unification**
 
-This week focused on implementing chat session heartbeat functionality and user settings management, ensuring that active sessions are properly tracked and can be recovered in case of unexpected disconnections.
+Implemented chat session heartbeat and session unlock, user settings management, configurable reasoning effort, and unified logging into `@gadget/api` as GadgetLog. Redesigned sign-in form and provider/model selection.
 
 ### Changes:
-- Implemented chat session heartbeat and session unlock
+- **Session**: Implemented chat session heartbeat and session unlock.
-- Added user settings management
+- **User Settings**: Added user settings management; made reasoning effort configurable.
-- Made reasoning effort configurable
+- **Auth**: Redesigned sign-in form and presentation; removed sign-up concept; integrated persona field in User.
-- Added editable session name with cog icon
+- **UI**: Reworked provider/model selection with save/cancel pattern; added editable session name with cog icon; added navigation to return to Project Manager.
-- Redesigned sign-in form and presentation
+- **Logging**: Unified logging into `@gadget/api` as GadgetLog; pre-task cleanup to reduce log spam; fixed logging when file logging is disabled.
-- Integrated persona field in User
+- **Streaming**: Fixed streaming response handling for Ollama.
-- Reworked provider/model selection with save/cancel pattern
-- Added navigation to return to Project Manager
-- Quick fix for when logging.file.enabled is false
-- Refactor: unify logging into @gadget/api as GadgetLog
 
 ---
 
@@ -175,135 +162,119 @@ This week focused on implementing chat session heartbeat functionality and user
 
 **Streaming Responses Implementation**
 
-This week saw the implementation of streaming responses for AI model interactions, including proper handling of streaming data from Ollama and other providers with support for real-time token delivery and response completion tracking.
+Implemented streaming responses for AI model interactions, including proper handling of streaming data from Ollama and other providers with real-time token delivery and response completion tracking.
 
 ### Changes:
-- Implemented streaming responses for Ollama
+- **Streaming**: Implemented streaming responses for Ollama with real-time token delivery and completion tracking.
-- Added streaming response handling and correctness improvements
+- **Documentation**: Created documentation for streaming responses.
-- Created documentation for streaming responses
-- Improved real-time token delivery and completion tracking
 
 ---
 
 ## 2026-05-06 (Tuesday)
 
-**Agent Tool and Toolbox Refactoring**
+**Agent Tool and Toolbox Architecture**
 
-This week involved significant refactoring of the agent tool and toolbox architecture, including unifying logging into @gadget/api as GadgetLog and restructuring the toolbox to support better tool registration and management.
+Significant refactoring of the agent tool and toolbox architecture, establishing the foundational pattern for tool registration and management.
 
 ### Changes:
-- Refactored agent tool and toolbox architecture
+- **Architecture**: Refactored agent tool and toolbox; established tool registration and management patterns.
-- Unified logging into @gadget/api as GadgetLog
+- **AI Environment**: Agent, tools, toolbox, tool loop, and AI environment foundation.
-- Improved tool registration and management
-- Reduced log spam through pre-task cleanup
-- Agent, tools, toolbox, tool loop, AI environment
 
 ---
 
 ## 2026-05-05 (Monday)
 
-**Basic Chat System Implementation**
+**Basic Chat System Milestone**
 
-This week marked a major milestone with the implementation of a working basic chat system, including provider, model, and mode selection capabilities, along with enhanced AgentService.process method functionality.
+Achieved a working basic chat system — the first end-to-end milestone — with provider, model, and mode selection, ChatTurn processing, and agent progress tracking.
 
 ### Changes:
-- Implemented basic chat system
+- **Chat**: Implemented basic working chat system (checkpoint).
-- Added provider, model, and mode selections
+- **Selection**: Added provider, model, and mode selections.
-- Enhanced AgentService.process method
+- **Processing**: Enhanced AgentService.process method; implemented ChatTurn processing and component.
-- Implemented chat turn processing
+- **Infrastructure**: Renamed platform.apiKey to platform.gadgetKey; reduced log output.
-- Added agent progress tracking
 
 ---
 
 ## 2026-05-03 (Saturday)
 
-**Status Message Display Fix**
+**Workspace Mode Management and Status Display**
 
-This weekend's work focused on fixing the status message display in the agent interface and implementing workspace mode management improvements with drone status message socket events.
+Fixed status message display in the agent interface and implemented workspace mode management with drone status message socket events.
 
 ### Changes:
-- Fixed status message display in agent interface
+- **Status**: Fixed status message display in agent interface.
-- Implemented workspace mode management
+- **Workspace**: Implemented workspace mode management; added drone status message socket events.
-- Added drone status message socket events
-- Many fixes
 
 ---
 
 ## 2026-05-02 (Friday)
 
-**Workspace Mode Switching**
+**Workspace Mode Switching with Validation**
 
-This week involved implementing workspace mode switching functionality with proper validation, ensuring that workspace mode changes are validated before being applied, preventing invalid state transitions.
+Implemented workspace mode switching with validation, ensuring workspace mode changes are validated before being applied, along with session lock and workspace processing refinements.
 
 ### Changes:
-- Implemented workspace mode switching with validation
+- **Workspace**: Implemented workspace mode switching with validation.
-- Added session lock and workspace processing refinements
+- **Session**: Added session lock and workspace processing refinements.
-- Improved workspace management system
+- **Socket**: Socket message and drone workspace cleanup; drone doc updates.
-- Workspace management progress
 
 ---
 
 ## 2026-05-01 (Thursday)
 
-**Welcome to The Grid**
+**The Grid Home View and GadgetId Migration**
 
-This week marked the beginning of a new phase with the implementation of the "Welcome to The Grid" home view, including JWT processing fixes, session startup/shutdown/refactoring improvements, and the transition from Types.ObjectId to GadgetId.
+Implemented the "Welcome to The Grid" home view, fixed JWT processing, refactored session lifecycle management, and completed the transition from Types.ObjectId to GadgetId across the codebase.
 
 ### Changes:
-- Implemented "Welcome to The Grid" home view
+- **Home View**: Implemented "Welcome to The Grid" home view; return to Home on sign out.
-- Fixed JWT processing
+- **Auth**: Fixed JWT processing.
-- Refactored session startup, shutdown, and import
+- **Session**: Refactored session startup, shutdown, and import; fixed import errors.
-- Transitioned from Types.ObjectId to GadgetId
+- **GadgetId**: Completed transition from Types.ObjectId to GadgetId (string alias using nanoid); correctly generate nanoid IDs in default clauses.
-- Added return to Home on sign out
-- More populate fixes
 
 ---
 
 ## 2026-04-30 (Wednesday)
 
-**Socket Protocol Implementation**
+**Socket Protocol and Drone Manager**
 
-This week focused on implementing and refining the socket protocol for drone-to-IDE communication, including defining missing socket event types, enforcing typed events in the frontend build, and adding a setting for max Socket.IO HTTP buffer size.
+Implemented socket protocol completeness with typed events, created the DroneManager, and finalized Project Manager correctness.
 
 ### Changes:
-- Implemented socket protocol completeness
+- **Socket Protocol**: Implemented socket protocol completeness; defined missing event types; enforced typed events in frontend build.
-- Defined missing socket event types
+- **Drone Manager**: Created DroneManager (WIP).
-- Enforced typed events in frontend build
+- **Config**: Added setting for max Socket.IO HTTP buffer size.
-- Added max Socket.IO HTTP buffer size setting
+- **Project Manager**: Wrap-up on Project Manager correctness.
-- Created drone manager
 
 ---
 
 ## 2026-04-29 (Tuesday)
 
-**Workspace Persistence and Crash Recovery**
+**Drone-to-IDE Event Routing and Workspace Persistence**
 
-This week involved implementing workspace persistence and crash recovery capabilities, including adding workspace mode to the gadget-drone process, event emissions to the Agentic Workflow Loop, and drone-to-IDE event routing.
+Implemented drone-to-IDE event routing, added event emissions to the Agentic Workflow Loop, and implemented workspace persistence and crash recovery. Added workspace mode to the gadget-drone process.
 
 ### Changes:
-- Implemented workspace persistence and crash recovery
+- **Event Routing**: Implemented Drone→IDE event routing (Phase 3); added event emissions to AWL (Phase 4).
-- Added workspace mode to gadget-drone process
+- **Workspace**: Added workspace mode to gadget-drone process; implemented workspace persistence and crash recovery (Phase 5).
-- Added event emissions to Agentic Workflow Loop
+- **Protocol**: Implemented prompt submission; fixed type conflicts; added socket protocol documentation.
-- Implemented drone-to-IDE event routing
+- **Config**: Added max Socket.IO HTTP buffer size setting; standardized interfaces.
-- Fixed type conflicts and implemented prompt submission
 
 ---
 
 ## 2026-04-28 (Monday)
 
-**Dark Industrial Theme and JWT Authentication**
+**Dark Industrial Theme, JWT Auth, and Project Manager**
 
-This week marked a significant visual and architectural milestone with the implementation of the dark industrial theme, Project Manager, and JWT authentication, replacing the previous sign-up concept with a more streamlined sign-in experience.
+Significant visual and architectural milestone: implemented the dark industrial theme, Project Manager, and JWT authentication, replacing sign-up with streamlined sign-in.
 
 ### Changes:
-- Implemented dark industrial theme
+- **Theme**: Implemented dark industrial theme with correct border colors and enforcement.
-- Added Project Manager
+- **Auth**: Implemented JWT authentication.
-- Implemented JWT authentication
+- **Project Manager**: Added project service.
-- Enforced theme correctly
+- **Models**: Refactored gadget-code model interfaces to `@gadget/api`.
-- Added project service
+- **Infrastructure**: Added workspaceDir to DroneRegistration; E2E tests for theme.
-- Updated DroneRegistration with workspaceDir
-- Fix: Darken border colors to match dark industrial theme
-- Theme enforced and correctly implemented; e2e tests added for theme
 
 ---
 
@@ -311,8 +282,8 @@ This week marked a significant visual and architectural milestone with the imple
 
 **Initial Commit**
 
-The project was initialized with the initial commit, establishing the foundation for all subsequent development.
+The project was initialized, establishing the foundation for all subsequent development.
 
 ### Changes:
-- Initial project commit
+- Initial project commit.
-- Established basic project structure
+- Established basic project structure.

README.md

@@ -253,5 +253,5 @@ Apache 2.0 — See [LICENSE](./LICENSE) for details.
 
 ---
 
-**Status:** Production-ready foundation with complete Chat Session UI  
+**Status:** v1.0.1 — First release. Self-hosted agentic engineering platform with local/self-hosted AI model support, complete Chat Session UI, subagent processing, and workspace management.  
 **Last Updated:** May 17, 2026