Replace Summary: prefixes with standard Go package doc comments

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

53 files changed, 58 insertions, 59 deletions

diff --git a/cmd/hexai-lsp-server/main.go b/cmd/hexai-lsp-server/main.go
index 3f7ed60..03e2546 100644
--- a/cmd/hexai-lsp-server/main.go
+++ b/cmd/hexai-lsp-server/main.go
@@ -1,4 +1,4 @@
-// Summary: Hexai LSP entrypoint; parses flags and delegates to internal/hexailsp.
+// Package main is the Hexai LSP entrypoint; parses flags and delegates to internal/hexailsp.
 package main
 
 import (
diff --git a/cmd/hexai-mcp-server/main.go b/cmd/hexai-mcp-server/main.go
index 959c99f..b32c18c 100644
--- a/cmd/hexai-mcp-server/main.go
+++ b/cmd/hexai-mcp-server/main.go
@@ -1,4 +1,4 @@
-// Summary: Hexai MCP server entrypoint; parses flags and delegates to internal/hexaimcp.
+// Package main is the Hexai MCP server entrypoint; parses flags and delegates to internal/hexaimcp.
 package main
 
 import (
diff --git a/cmd/hexai/main.go b/cmd/hexai/main.go
index 874c850..e71a204 100644
--- a/cmd/hexai/main.go
+++ b/cmd/hexai/main.go
@@ -1,4 +1,4 @@
-// Summary: Hexai CLI entrypoint; parses flags and delegates to internal/hexaicli.
+// Package main is the Hexai CLI entrypoint; parses flags and delegates to internal/hexaicli.
 package main
 
 import (
diff --git a/internal/appconfig/config_features_test.go b/internal/appconfig/config_features_test.go
index 9e3528a..123283a 100644
--- a/internal/appconfig/config_features_test.go
+++ b/internal/appconfig/config_features_test.go
@@ -1,4 +1,4 @@
-// Summary: Tests for ignore config, tmux-edit config, and low-level parsing helpers
+// Tests for ignore config, tmux-edit config, and low-level parsing helpers
 // (temperature, model entries, surface entries, resolved model).
 package appconfig
 
diff --git a/internal/appconfig/config_types.go b/internal/appconfig/config_types.go
index d7fcc5d..05befb2 100644
--- a/internal/appconfig/config_types.go
+++ b/internal/appconfig/config_types.go
@@ -1,4 +1,4 @@
-// Summary: Application configuration model and defaults.
+// Package appconfig provides the application configuration model and defaults.
 package appconfig
 
 import "strings"
diff --git a/internal/hexaiaction/types.go b/internal/hexaiaction/types.go
index 8c5652b..8b4ba28 100644
--- a/internal/hexaiaction/types.go
+++ b/internal/hexaiaction/types.go
@@ -1,7 +1,6 @@
+// Package hexaiaction provides core types and constants for hexai-tmux-action.
 package hexaiaction
 
-// Summary: Core types and constants for hexai-tmux-action.
-
 type ActionKind string
 
 const (
diff --git a/internal/hexaicli/run.go b/internal/hexaicli/run.go
index 25ab7c1..1563f5e 100644
--- a/internal/hexaicli/run.go
+++ b/internal/hexaicli/run.go
@@ -1,4 +1,4 @@
-// Summary: Hexai CLI runner; reads input, creates an LLM client, builds messages,
+// Package hexaicli is the Hexai CLI runner; reads input, creates an LLM client, builds messages,
 // streams or collects the model output, and prints a short summary to stderr.
 package hexaicli
 
diff --git a/internal/hexaicli/run_output_test.go b/internal/hexaicli/run_output_test.go
index 77a7c6a..b4614da 100644
--- a/internal/hexaicli/run_output_test.go
+++ b/internal/hexaicli/run_output_test.go
@@ -1,4 +1,4 @@
-// Summary: Tests for CLI job output writing, result counting, config path context,
+// Tests for CLI job output writing, result counting, config path context,
 // cached output writing, and streaming error paths.
 package hexaicli
 
diff --git a/internal/hexaicli/testhelpers_test.go b/internal/hexaicli/testhelpers_test.go
index a4c9e6b..a984674 100644
--- a/internal/hexaicli/testhelpers_test.go
+++ b/internal/hexaicli/testhelpers_test.go
@@ -1,4 +1,4 @@
-// Summary: Test helpers for Hexai CLI tests (stdin swapping and fake LLM clients/streamers).
+// Test helpers for Hexai CLI tests (stdin swapping and fake LLM clients/streamers).
 package hexaicli
 
 import (
diff --git a/internal/hexailsp/run.go b/internal/hexailsp/run.go
index 3741a5e..68d2954 100644
--- a/internal/hexailsp/run.go
+++ b/internal/hexailsp/run.go
@@ -1,4 +1,4 @@
-// Summary: Hexai LSP runner; configures logging, loads config, builds the LLM client,
+// Package hexailsp is the Hexai LSP runner; configures logging, loads config, builds the LLM client,
 // and constructs/runs the LSP server (with injectable factory for tests).
 package hexailsp
 
diff --git a/internal/hexailsp/run_test.go b/internal/hexailsp/run_test.go
index 2b0198a..583c6c8 100644
--- a/internal/hexailsp/run_test.go
+++ b/internal/hexailsp/run_test.go
@@ -1,4 +1,4 @@
-// Summary: Tests for the Hexai LSP runner using a fake server factory and environment keys.
+// Tests for the Hexai LSP runner using a fake server factory and environment keys.
 package hexailsp
 
 import (
diff --git a/internal/hexaimcp/run.go b/internal/hexaimcp/run.go
index eb4fe83..74eb476 100644
--- a/internal/hexaimcp/run.go
+++ b/internal/hexaimcp/run.go
@@ -1,4 +1,4 @@
-// Summary: MCP server orchestrator; loads config, sets up store, and runs server.
+// Package hexaimcp is the MCP server orchestrator; loads config, sets up store, and runs server.
 package hexaimcp
 
 import (
diff --git a/internal/hexaimcp/run_test.go b/internal/hexaimcp/run_test.go
index 6bfe771..6bedbfc 100644
--- a/internal/hexaimcp/run_test.go
+++ b/internal/hexaimcp/run_test.go
@@ -1,4 +1,4 @@
-// Summary: Integration tests for hexaimcp orchestrator
+// Integration tests for hexaimcp orchestrator.
 package hexaimcp
 
 import (
diff --git a/internal/ignore/checker.go b/internal/ignore/checker.go
index 92129b8..034e3db 100644
--- a/internal/ignore/checker.go
+++ b/internal/ignore/checker.go
@@ -1,4 +1,4 @@
-// Summary: Thread-safe gitignore-aware file checker that combines .gitignore
+// Package ignore provides a thread-safe gitignore-aware file checker that combines .gitignore
 // patterns with user-configured extra patterns. Used by the LSP server to
 // skip completions and code actions for ignored files.
 package ignore
diff --git a/internal/llm/anthropic.go b/internal/llm/anthropic.go
index 2fc1d84..0f27dcc 100644
--- a/internal/llm/anthropic.go
+++ b/internal/llm/anthropic.go
@@ -1,4 +1,4 @@
-// Summary: Anthropic client implementation using Messages API with optional streaming support.
+// Anthropic client implementation using Messages API with optional streaming support.
 package llm
 
 import (
diff --git a/internal/llm/ollama.go b/internal/llm/ollama.go
index 896ca13..ade62a9 100644
--- a/internal/llm/ollama.go
+++ b/internal/llm/ollama.go
@@ -1,4 +1,4 @@
-// Summary: Ollama client against a local server; supports chat responses and streaming via /api/chat.
+// Ollama client against a local server; supports chat responses and streaming via /api/chat.
 package llm
 
 import (
diff --git a/internal/llm/openai.go b/internal/llm/openai.go
index 3d2bf94..d2eff05 100644
--- a/internal/llm/openai.go
+++ b/internal/llm/openai.go
@@ -1,4 +1,4 @@
-// Summary: OpenAI client implementation for chat completions with optional streaming and detailed logging.
+// OpenAI client implementation for chat completions with optional streaming and detailed logging.
 package llm
 
 import (
diff --git a/internal/llm/openrouter.go b/internal/llm/openrouter.go
index 19c2f6c..53d2957 100644
--- a/internal/llm/openrouter.go
+++ b/internal/llm/openrouter.go
@@ -1,4 +1,4 @@
-// Summary: OpenRouter client implementation leveraging OpenAI-compatible helpers with provider-specific headers.
+// OpenRouter client implementation leveraging OpenAI-compatible helpers with provider-specific headers.
 package llm
 
 import (
diff --git a/internal/llm/provider.go b/internal/llm/provider.go
index f3170ef..96646cf 100644
--- a/internal/llm/provider.go
+++ b/internal/llm/provider.go
@@ -1,4 +1,4 @@
-// Summary: LLM provider interfaces, request options, configuration, and factory to build a client from config.
+// Package llm defines LLM provider interfaces, request options, configuration, and factory to build a client from config.
 package llm
 
 import (
diff --git a/internal/logging/logging.go b/internal/logging/logging.go
index 9d84ea3..5861aa3 100644
--- a/internal/logging/logging.go
+++ b/internal/logging/logging.go
@@ -1,4 +1,4 @@
-// Summary: ANSI-styled logging utilities with a bound standard logger and configurable preview truncation.
+// Package logging provides ANSI-styled logging utilities with a bound standard logger and configurable preview truncation.
 // All package-level state is accessed via atomic types to avoid data races under concurrent use.
 package logging
 
diff --git a/internal/lsp/context.go b/internal/lsp/context.go
index 4395abf..52ba3a5 100644
--- a/internal/lsp/context.go
+++ b/internal/lsp/context.go
@@ -1,4 +1,4 @@
-// Summary: Builds additional context snippets based on configured mode and truncates text by token heuristic.
+// Builds additional context snippets based on configured mode and truncates text by token heuristic.
 package lsp
 
 import (
diff --git a/internal/lsp/context_test.go b/internal/lsp/context_test.go
index fd555cf..08a2969 100644
--- a/internal/lsp/context_test.go
+++ b/internal/lsp/context_test.go
@@ -1,4 +1,4 @@
-// Summary: Tests for context-building logic (window, full-file) and truncation behavior.
+// Tests for context-building logic (window, full-file) and truncation behavior.
 package lsp
 
 import (
diff --git a/internal/lsp/document.go b/internal/lsp/document.go
index 1ef1a5b..f7d0bbe 100644
--- a/internal/lsp/document.go
+++ b/internal/lsp/document.go
@@ -1,4 +1,4 @@
-// Summary: In-memory document model for the LSP; tracks text, lines, and applies edits.
+// In-memory document model for the LSP; tracks text, lines, and applies edits.
 package lsp
 
 import (
diff --git a/internal/lsp/document_test.go b/internal/lsp/document_test.go
index c805d22..0d19f29 100644
--- a/internal/lsp/document_test.go
+++ b/internal/lsp/document_test.go
@@ -1,4 +1,4 @@
-// Summary: Tests for LSP document model (line management, edits, and transformations).
+// Tests for LSP document model (line management, edits, and transformations).
 package lsp
 
 import (
diff --git a/internal/lsp/handlers.go b/internal/lsp/handlers.go
index fe52512..ebdefc1 100644
--- a/internal/lsp/handlers.go
+++ b/internal/lsp/handlers.go
@@ -1,4 +1,4 @@
-// Summary: LSP JSON-RPC handlers; implements core methods and integrates with the LLM client when enabled.
+// LSP JSON-RPC handlers; implements core methods and integrates with the LLM client when enabled.
 package lsp
 
 import (
diff --git a/internal/lsp/handlers_codeaction.go b/internal/lsp/handlers_codeaction.go
index d393bd4..8b16fcd 100644
--- a/internal/lsp/handlers_codeaction.go
+++ b/internal/lsp/handlers_codeaction.go
@@ -1,4 +1,4 @@
-// Summary: Code Action handlers and helpers split from handlers.go for clarity.
+// Code Action handlers and helpers split from handlers.go for clarity.
 package lsp
 
 import (
diff --git a/internal/lsp/handlers_completion.go b/internal/lsp/handlers_completion.go
index b5fd03f..aca830b 100644
--- a/internal/lsp/handlers_completion.go
+++ b/internal/lsp/handlers_completion.go
@@ -1,4 +1,4 @@
-// Summary: Completion handlers split from handlers.go to reduce file size and isolate feature logic.
+// Completion handlers split from handlers.go to reduce file size and isolate feature logic.
 package lsp
 
 import (
diff --git a/internal/lsp/handlers_document.go b/internal/lsp/handlers_document.go
index 0e6d8e1..a411f4e 100644
--- a/internal/lsp/handlers_document.go
+++ b/internal/lsp/handlers_document.go
@@ -1,4 +1,4 @@
-// Summary: Document open/change/close and in-editor chat handlers split out of handlers.go.
+// Document open/change/close and in-editor chat handlers split out of handlers.go.
 package lsp
 
 import (
diff --git a/internal/lsp/handlers_execute.go b/internal/lsp/handlers_execute.go
index d0bc8fc..f2f2fac 100644
--- a/internal/lsp/handlers_execute.go
+++ b/internal/lsp/handlers_execute.go
@@ -1,4 +1,4 @@
-// Summary: ExecuteCommand handler to support post-edit navigation (jump to generated test).
+// ExecuteCommand handler to support post-edit navigation (jump to generated test).
 package lsp
 
 import (
diff --git a/internal/lsp/handlers_ignore.go b/internal/lsp/handlers_ignore.go
index bbd2dfa..716ea49 100644
--- a/internal/lsp/handlers_ignore.go
+++ b/internal/lsp/handlers_ignore.go
@@ -1,4 +1,4 @@
-// Summary: Helpers for gitignore-aware file filtering in LSP handlers.
+// Helpers for gitignore-aware file filtering in LSP handlers.
 package lsp
 
 import (
diff --git a/internal/lsp/handlers_init.go b/internal/lsp/handlers_init.go
index 24789f7..d343338 100644
--- a/internal/lsp/handlers_init.go
+++ b/internal/lsp/handlers_init.go
@@ -1,4 +1,4 @@
-// Summary: Initialization and lifecycle handlers split from handlers.go.
+// Initialization and lifecycle handlers split from handlers.go.
 package lsp
 
 import (
diff --git a/internal/lsp/handlers_test.go b/internal/lsp/handlers_test.go
index b2b47c0..c127bd9 100644
--- a/internal/lsp/handlers_test.go
+++ b/internal/lsp/handlers_test.go
@@ -1,4 +1,4 @@
-// Summary: Tests for instruction extraction helpers in handlers.go
+// Tests for instruction extraction helpers in handlers.go.
 package lsp
 
 import "testing"
diff --git a/internal/lsp/handlers_utils.go b/internal/lsp/handlers_utils.go
index b36297c..7fb17d2 100644
--- a/internal/lsp/handlers_utils.go
+++ b/internal/lsp/handlers_utils.go
@@ -1,4 +1,4 @@
-// Summary: Generic LSP helpers shared across handlers (LLM opts, prompts, text utils, counters).
+// Generic LSP helpers shared across handlers (LLM opts, prompts, text utils, counters).
 package lsp
 
 import (
diff --git a/internal/lsp/server.go b/internal/lsp/server.go
index 3af7e1d..6442342 100644
--- a/internal/lsp/server.go
+++ b/internal/lsp/server.go
@@ -1,4 +1,4 @@
-// Summary: Minimal LSP server over stdio; manages documents, dispatches requests, and tracks stats.
+// Package lsp provides a minimal LSP server over stdio; manages documents, dispatches requests, and tracks stats.
 package lsp
 
 import (
diff --git a/internal/lsp/transport.go b/internal/lsp/transport.go
index 60e5379..bca2c37 100644
--- a/internal/lsp/transport.go
+++ b/internal/lsp/transport.go
@@ -1,4 +1,4 @@
-// Summary: LSP transport utilities to read and write JSON-RPC messages with Content-Length framing.
+// LSP transport utilities to read and write JSON-RPC messages with Content-Length framing.
 package lsp
 
 import (
diff --git a/internal/lsp/types.go b/internal/lsp/types.go
index 68101f6..ae1f644 100644
--- a/internal/lsp/types.go
+++ b/internal/lsp/types.go
@@ -1,4 +1,4 @@
-// Summary: LSP protocol types used by the server (requests, responses, params, capabilities).
+// LSP protocol types used by the server (requests, responses, params, capabilities).
 package lsp
 
 import "encoding/json"
diff --git a/internal/mcp/handlers_prompt.go b/internal/mcp/handlers_prompt.go
index cfe3385..2819a09 100644
--- a/internal/mcp/handlers_prompt.go
+++ b/internal/mcp/handlers_prompt.go
@@ -1,4 +1,4 @@
-// Summary: MCP prompt-related handler methods for list, get, create, update, and delete operations.
+// MCP prompt-related handler methods for list, get, create, update, and delete operations.
 package mcp
 
 import (
diff --git a/internal/mcp/handlers_prompt_test.go b/internal/mcp/handlers_prompt_test.go
index ad0d261..17b0607 100644
--- a/internal/mcp/handlers_prompt_test.go
+++ b/internal/mcp/handlers_prompt_test.go
@@ -1,4 +1,4 @@
-// Summary: Tests for MCP prompt management handlers (create, update, delete, get, list)
+// Tests for MCP prompt management handlers (create, update, delete, get, list).
 package mcp
 
 import (
diff --git a/internal/mcp/handlers_tool.go b/internal/mcp/handlers_tool.go
index 759de9e..de09a85 100644
--- a/internal/mcp/handlers_tool.go
+++ b/internal/mcp/handlers_tool.go
@@ -1,4 +1,4 @@
-// Summary: MCP tool-related handler methods for listing tools, calling tools,
+// MCP tool-related handler methods for listing tools, calling tools,
 // and JSON Schema definitions for tool inputs.
 package mcp
 
diff --git a/internal/mcp/handlers_tool_test.go b/internal/mcp/handlers_tool_test.go
index 604938a..1d716ae 100644
--- a/internal/mcp/handlers_tool_test.go
+++ b/internal/mcp/handlers_tool_test.go
@@ -1,4 +1,4 @@
-// Summary: Tests for MCP tool handlers (tools/list, tools/call for create/update/delete)
+// Tests for MCP tool handlers (tools/list, tools/call for create/update/delete).
 package mcp
 
 import (
diff --git a/internal/mcp/server.go b/internal/mcp/server.go
index 99cd456..645c0cf 100644
--- a/internal/mcp/server.go
+++ b/internal/mcp/server.go
@@ -1,4 +1,4 @@
-// Summary: MCP server core — struct definition, constructor, main loop, and message dispatch.
+// Package mcp provides the MCP server core — struct definition, constructor, main loop, and message dispatch.
 package mcp
 
 import (
diff --git a/internal/mcp/server_test.go b/internal/mcp/server_test.go
index 8e3d7b5..256b324 100644
--- a/internal/mcp/server_test.go
+++ b/internal/mcp/server_test.go
@@ -1,4 +1,4 @@
-// Summary: Tests for MCP server operations
+// Tests for MCP server operations.
 package mcp
 
 import (
@@ -85,27 +85,27 @@ func readResponse(r io.Reader) (*Response, error) {
 	if len(lines) == 0 {
 		return nil, fmt.Errorf("no response data")
 	}
-	
+
 	// Try to find a response (message with an ID)
 	for _, line := range lines {
 		if len(line) == 0 {
 			continue
 		}
-		
+
 		// Quick check if this might be a response (has "id" field)
 		if !strings.Contains(line, `"id"`) {
 			continue // Skip notifications
 		}
-		
+
 		var resp Response
 		if err := json.Unmarshal([]byte(line), &resp); err != nil {
 			continue // Not a valid response, try next line
 		}
-		
+
 		// Valid response found
 		return &resp, nil
 	}
-	
+
 	return nil, fmt.Errorf("no response found in output (only notifications)")
 }
 
diff --git a/internal/mcp/transport.go b/internal/mcp/transport.go
index 9147ea0..5119d2c 100644
--- a/internal/mcp/transport.go
+++ b/internal/mcp/transport.go
@@ -1,4 +1,4 @@
-// Summary: MCP transport utilities for reading and writing JSON-RPC messages
+// MCP transport utilities for reading and writing JSON-RPC messages
 // using newline-delimited JSON (JSONL) as required by the MCP stdio protocol.
 package mcp
 
diff --git a/internal/mcp/types.go b/internal/mcp/types.go
index 1b11200..9a0aa14 100644
--- a/internal/mcp/types.go
+++ b/internal/mcp/types.go
@@ -1,4 +1,4 @@
-// Summary: MCP protocol types for JSON-RPC 2.0 messages and MCP-specific structures.
+// MCP protocol types for JSON-RPC 2.0 messages and MCP-specific structures.
 package mcp
 
 import "encoding/json"
diff --git a/internal/promptstore/backup_test.go b/internal/promptstore/backup_test.go
index 903f021..7bcd4d4 100644
--- a/internal/promptstore/backup_test.go
+++ b/internal/promptstore/backup_test.go
@@ -1,4 +1,4 @@
-// Summary: Tests for automatic backup functionality
+// Tests for automatic backup functionality.
 package promptstore
 
 import (
diff --git a/internal/promptstore/default_prompts.go b/internal/promptstore/default_prompts.go
index 434855a..8aefb6b 100644
--- a/internal/promptstore/default_prompts.go
+++ b/internal/promptstore/default_prompts.go
@@ -1,4 +1,4 @@
-// Summary: Built-in meta-prompts for prompt management.
+// Built-in meta-prompts for prompt management.
 package promptstore
 
 import (
diff --git a/internal/promptstore/store.go b/internal/promptstore/store.go
index b4b9586..1597b36 100644
--- a/internal/promptstore/store.go
+++ b/internal/promptstore/store.go
@@ -1,4 +1,4 @@
-// Summary: Prompt storage interface and JSONL-based implementation.
+// Package promptstore provides a prompt storage interface and JSONL-based implementation.
 package promptstore
 
 import (
diff --git a/internal/promptstore/store_test.go b/internal/promptstore/store_test.go
index 1ec784a..97b50fa 100644
--- a/internal/promptstore/store_test.go
+++ b/internal/promptstore/store_test.go
@@ -1,4 +1,4 @@
-// Summary: Tests for prompt store operations
+// Tests for prompt store operations.
 package promptstore
 
 import (
diff --git a/internal/promptstore/types.go b/internal/promptstore/types.go
index 56aa99b..bdb11e6 100644
--- a/internal/promptstore/types.go
+++ b/internal/promptstore/types.go
@@ -1,4 +1,4 @@
-// Summary: Data models for prompt storage (templates with arguments).
+// Data models for prompt storage (templates with arguments).
 package promptstore
 
 import "time"
diff --git a/internal/slashcommands/converter.go b/internal/slashcommands/converter.go
index 87c77c8..8f4e526 100644
--- a/internal/slashcommands/converter.go
+++ b/internal/slashcommands/converter.go
@@ -1,4 +1,4 @@
-// Summary: Converts MCP prompts to generic slash command Markdown format.
+// Package slashcommands converts MCP prompts to generic slash command Markdown format.
 package slashcommands
 
 import (
diff --git a/internal/slashcommands/syncer.go b/internal/slashcommands/syncer.go
index 8ff9e58..1268e7b 100644
--- a/internal/slashcommands/syncer.go
+++ b/internal/slashcommands/syncer.go
@@ -1,4 +1,4 @@
-// Summary: File syncer for exporting MCP prompts to slash command files.
+// File syncer for exporting MCP prompts to slash command files.
 package slashcommands
 
 import (
diff --git a/internal/tmuxedit/history.go b/internal/tmuxedit/history.go
index a79672b..eab4db2 100644
--- a/internal/tmuxedit/history.go
+++ b/internal/tmuxedit/history.go
@@ -1,4 +1,4 @@
-// Summary: JSONL-based history storage for tmux popup submissions
+// Package tmuxedit provides JSONL-based history storage for tmux popup submissions.
 package tmuxedit
 
 import (
diff --git a/internal/version.go b/internal/version.go
index 546ad62..d8b0b87 100644
--- a/internal/version.go
+++ b/internal/version.go
@@ -1,4 +1,4 @@
-// Summary: Hexai semantic version identifier used by CLI and LSP binaries.
+// Package internal provides the Hexai semantic version identifier used by CLI and LSP binaries.
 package internal
 
 const Version = "0.24.0"