Align package specs with audit findings (dependencies + section structure) (#27241)

Author: Copilot

pkg/actionpins/README.md

@@ -54,6 +54,7 @@ fmt.Println(reference) // actions/checkout@<sha> # v5
 
 **Internal**:
 - `pkg/console` — warning message formatting
+- `pkg/gitutil` — dynamic SHA resolution via GitHub API/CLI helpers
 - `pkg/logger` — debug logging
 - `pkg/semverutil` — semantic version compatibility checks
 

pkg/console/README.md

@@ -1,5 +1,7 @@
 # console Package
 
+## Overview
+
 The `console` package provides utilities for formatting and rendering terminal output in GitHub Agentic Workflows. It covers message formatting, table and section rendering, interactive prompts, progress bars, spinners, struct rendering, and accessibility support.
 
 ## Design Philosophy

pkg/logger/README.md

@@ -1,5 +1,7 @@
 # logger Package
 
+## Overview
+
 A simple, debug-style logging framework for Go that follows the pattern matching syntax of the [debug npm package](https://www.npmjs.com/package/debug).
 
 ## Features

pkg/parser/README.md

@@ -238,8 +238,15 @@ Import caching is crucial for performance and cycle detection. The `ImportCache`
 ## Dependencies
 
 **Internal**:
+- `pkg/console` — parser-facing warning/error message formatting
+- `pkg/constants` — shared parser constants and default values
+- `pkg/fileutil` — file existence and path helper utilities
+- `pkg/gitutil` — Git remote and host detection helpers
 - `pkg/types` — `BaseMCPServerConfig`
+- `pkg/typeutil` — safe type conversion helpers for dynamic frontmatter
 - `pkg/logger` — debug logging
+- `pkg/sliceutil` — slice helper utilities for validation and merging
+- `pkg/stringutil` — string normalization and ANSI/format helpers
 
 **External**:
 - `github.com/santhosh-tekuri/jsonschema/v5` — JSON schema validation