redline-review 1.0.1 → 2.0.1

package/README.md

@@ -46,7 +46,7 @@ mkdir -p .claude/commands
 cp $(npm root -g)/redline-review/adapters/claude/redline-review.md .claude/commands/redline-review.md
 ```
 
-### Step 6 — Use it in Claude Code
+### Use it in Claude Code
 
 Open any project in Claude Code and type:
 
@@ -69,17 +69,100 @@ You can pass flags directly:
 
 ---
 
-## How it works
+## Review modes
 
-1. Detects your git diff automatically (`git diff main...HEAD`, falls back through `master...HEAD` → `HEAD~1` → `--cached`)
-2. **Auto-detects relevant rule categories** from the diff content (or uses your `--stack`/`--type` flags)
-3. Prints the assembled review prompt to stdout
-4. Your agent reads that prompt and performs the review — no external calls made by the CLI
+### Default — branch diff (PR-style)
+
+```bash
+redline-review
+```
+
+Diffs the current branch against the detected base branch and assembles a review prompt. This is the original behavior — no subcommand needed.
+
+### Range — review between two commits
+
+```bash
+redline-review range --from <commit-ish> --to <commit-ish>
+```
+
+One-shot review of everything that changed between two refs. `--to` defaults to `HEAD` if omitted.
+
+```bash
+# Review changes between two tags
+redline-review range --from v1.0.0 --to v1.1.0
+
+# Review the last 5 commits
+redline-review range --from HEAD~5 --to HEAD
+
+# Strict mode
+redline-review range --from main --to HEAD --prompt strict
+```
+
+### Walk — commit-by-commit review
+
+```bash
+redline-review walk --start [--from <ref>] [--to <ref>] [--interval N] [--direction backwards|forwards]
+redline-review walk --next
+redline-review walk --status
+redline-review walk --reset
+```
+
+Steps through commits one at a time (or in batches), emitting a review prompt for each step. State is persisted in `.git/redline-walk.json`.
+
+```bash
+# Start walking backwards from HEAD to main (default)
+redline-review walk --start
+
+# Walk in batches of 2 commits
+redline-review walk --start --interval 2
+
+# Walk forwards from a specific point
+redline-review walk --start --from v1.0.0 --direction forwards
+
+# Get the next review prompt
+redline-review walk --next
+
+# Check progress
+redline-review walk --status
+
+# Clear walk state
+redline-review walk --reset
+```
+
+The interactive "review → ask → continue" loop lives in your agent (see adapter docs), not in the CLI. The CLI stays stateless per invocation — it reads/writes a small state file but each call is a single deterministic function.
+
+Flags passed at `--start` time (`--stack`, `--type`, `--prompt`) are captured into state and reused for every `--next`.
+
+### Repo — full repository review
+
+```bash
+redline-review repo [--max-tree-depth N] [--stack ...] [--type ...] [--prompt ...]
+```
+
+Emits a review prompt that instructs your agent to systematically explore the entire repository. The prompt includes:
+
+- An annotated file tree with navigation hints (`[entry-point]`, `[config]`, `[migration]`, `[orchestration]`, `[largest]`)
+- Inlined orientation files (package.json, go.mod, README, CI workflows, etc.)
+- Architecture review dimensions (module boundaries, hidden coupling, consistency, abstraction quality, reliability hazards, architectural drift)
+- Rule-based focus areas auto-detected from file extensions
+
+```bash
+# Review this repo
+redline-review repo
+
+# Limit tree depth for large repos
+redline-review repo --max-tree-depth 3
+
+# Override with explicit stack
+redline-review repo --stack go --type architecture,concurrency
+```
 
 ---
 
 ## Flags
 
+All flags work with all modes (default, range, walk, repo).
+
 ### `--type` — focus by concern
 
 ```bash
@@ -123,16 +206,27 @@ redline-review --stack go --type backend
 ### `--prompt` — control review depth
 
 ```bash
-redline-review --prompt base         # default
+redline-review --prompt base         # default for diff-based modes
 redline-review --prompt strict       # CRITICAL and HIGH only + fix suggestions
 redline-review --prompt lightweight  # top 3 issues only
 ```
 
-| Value            | Output                                            |
-| ---------------- | ------------------------------------------------- |
+| Value            | Output                                             |
+| ---------------- | -------------------------------------------------- |
 | `base` (default) | All issues grouped CRITICAL → HIGH → MEDIUM → LOW |
-| `strict`         | CRITICAL and HIGH only, concrete fix per issue    |
-| `lightweight`    | Top 3 issues, one tight paragraph each            |
+| `strict`         | CRITICAL and HIGH only, concrete fix per issue     |
+| `lightweight`    | Top 3 issues, one tight paragraph each             |
+
+Repo mode defaults to its own `repo-reviewer` template (agent-driven exploration). Pass `--prompt strict` or `--prompt lightweight` to override.
+
+### `--base` — override base branch
+
+```bash
+redline-review --base origin/develop
+redline-review --base main
+```
+
+Only applies to the default (branch diff) mode. Range and walk use `--from`/`--to` instead.
 
 ---
 
@@ -154,6 +248,17 @@ redline-review --stack java --prompt lightweight
 # Security review, any stack
 redline-review --type security
 
+# Review a release range
+redline-review range --from v1.2.0 --to v1.3.0
+
+# Walk through a feature branch commit by commit
+redline-review walk --start --prompt strict
+redline-review walk --next
+redline-review walk --next
+
+# Full repo audit
+redline-review repo
+
 # Pipe to clipboard (macOS) — paste into any agent
 redline-review | pbcopy
 
@@ -174,6 +279,8 @@ When no `--type` or `--stack` flags are given, `redline-review` scans the diff f
 
 If nothing is detected, falls back to `correctness + maintainability + risk-patterns`.
 
+For repo mode (no diff), detection is based on file extensions in the repository.
+
 Detected domains are printed to stderr so they don't pollute the prompt:
 
 ```
@@ -205,16 +312,23 @@ Domains (auto-detected): auth.yaml, concurrency.yaml, performance-db.yaml
 
 Adapter files for other agents are in `adapters/`:
 
-| Agent          | Command                                                                                                                          |
-| -------------- | -------------------------------------------------------------------------------------------------------------------------------- |
-| Claude Code    | `cp $(npm root -g)/redline-review/adapters/claude/redline-review.md ~/.claude/commands/redline-review.md`                        |
-| GitHub Copilot | `cp $(npm root -g)/redline-review/adapters/copilot/redline-review.md .github/copilot-instructions.md`                           |
-| Codex CLI      | `cp $(npm root -g)/redline-review/adapters/codex/redline-review.md AGENTS.md`                                                   |
-| OpenCode       | `cp $(npm root -g)/redline-review/adapters/opencode/redline-review.md AGENTS.md`                                                |
-| Anti-gravity   | `cp $(npm root -g)/redline-review/adapters/antigravity/redline-review.md <your-config-path>`                                    |
+| Agent          | Command                                                                                                   |
+| -------------- | --------------------------------------------------------------------------------------------------------- |
+| Claude Code    | `cp $(npm root -g)/redline-review/adapters/claude/redline-review.md ~/.claude/commands/redline-review.md` |
+| GitHub Copilot | `cp $(npm root -g)/redline-review/adapters/copilot/redline-review.md .github/copilot-instructions.md`    |
+| Codex CLI      | `cp $(npm root -g)/redline-review/adapters/codex/redline-review.md AGENTS.md`                            |
+| OpenCode       | `cp $(npm root -g)/redline-review/adapters/opencode/redline-review.md AGENTS.md`                         |
+| Anti-gravity   | `cp $(npm root -g)/redline-review/adapters/antigravity/redline-review.md <your-config-path>`             |
 
 Each adapter follows the same pattern: run `redline-review`, take the output as the review task.
 
+For the commit walk interactive flow, adapters should:
+
+1. Run `redline-review walk --start` and perform the review
+2. Ask the user: "Continue to the next commit?"
+3. If yes, run `redline-review walk --next` and repeat
+4. When walk is complete (exit 0 with no stdout), inform the user
+
 ---
 
 ## License

package/adapters/antigravity/redline-review.md

@@ -25,6 +25,37 @@ redline-review --prompt strict        # CRITICAL/HIGH severity only
 redline-review --prompt lightweight   # top 3 issues, quick scan
 ```
 
+## Range review
+
+Review changes between two commits or tags:
+
+```bash
+redline-review range --from <ref> --to <ref>
+redline-review range --from v1.0.0 --to v1.1.0 --prompt strict
+```
+
+## Commit walk
+
+Step through commits one at a time. Run `--start`, review the output, then `--next` to advance:
+
+```bash
+redline-review walk --start                       # begin
+redline-review walk --next                        # advance
+redline-review walk --status                      # check progress
+redline-review walk --reset                       # clear state
+redline-review walk --start --interval 2          # batch commits
+redline-review walk --start --direction forwards  # walk oldest → newest
+```
+
+## Repo review
+
+Full repository audit. Output is a manifest — use file-reading tools to explore as instructed:
+
+```bash
+redline-review repo
+redline-review repo --max-tree-depth 3
+```
+
 ## One-shot (no global install)
 
 ```bash

package/adapters/claude/redline-review.md

@@ -12,15 +12,14 @@ The CLI assembles a focused code review prompt from the git diff and the install
 npm install -g redline-review
 ```
 
-## Usage
+## Branch diff (default)
 
 ```bash
-# All rules (default — base branch auto-detected)
+# Auto-detect base branch
 redline-review
 
-# Pin the base branch explicitly (use when auto-detection picks the wrong base)
+# Pin the base branch explicitly
 redline-review --base origin/develop
-redline-review --base develop
 
 # Focused by review type
 redline-review --type auth,performance
@@ -35,7 +34,60 @@ redline-review --prompt strict
 redline-review --prompt lightweight
 ```
 
+## Range review
+
+Review changes between two specific commits or tags.
+
+```bash
+redline-review range --from <ref> --to <ref>
+redline-review range --from v1.0.0 --to v1.1.0
+redline-review range --from HEAD~5 --to HEAD --prompt strict
+```
+
+`--to` defaults to HEAD if omitted.
+
+## Commit walk
+
+Step through commits one at a time.
+
+```bash
+redline-review walk --start
+redline-review walk --next
+redline-review walk --status
+redline-review walk --reset
+```
+
+**Interactive flow:**
+
+1. Run `redline-review walk --start` and capture stdout.
+2. Perform the review described by that prompt.
+3. Present findings to the user, then ask: "Continue to the next commit?"
+4. If the user confirms, run `redline-review walk --next` and repeat from step 2.
+5. If the user declines, stop. State persists — they can resume later with `--next`.
+6. When walk is complete (`--next` exits with no stdout), tell the user.
+
+Optional flags for `--start`:
+
+```bash
+redline-review walk --start --interval 2              # batch 2 commits per step
+redline-review walk --start --direction forwards       # walk oldest → newest
+redline-review walk --start --from v1.0.0 --to v2.0.0 # explicit range
+redline-review walk --start --force                    # overwrite in-progress walk
+```
+
+Flags `--stack`, `--type`, and `--prompt` passed at `--start` time are captured and reused for every `--next`.
+
+## Repo review
+
+Full repository architecture audit. The output is a manifest with an annotated file tree and orientation files — use your file-reading tools to explore the codebase as instructed by the prompt.
+
+```bash
+redline-review repo
+redline-review repo --max-tree-depth 3
+redline-review repo --stack go --type architecture
+```
+
 ## How to use as a Claude Code skill
 
-Place this file at `.claude/commands/redline-review.md` in your project.
+Place this file at `.claude/commands/redline-review.md` in your project (or `~/.claude/commands/redline-review.md` for global access).
 Then invoke it with `/redline-review` in Claude Code.

package/adapters/codex/redline-review.md

@@ -31,6 +31,37 @@ redline-review --prompt strict        # CRITICAL/HIGH only
 redline-review --prompt lightweight   # top 3 issues
 ```
 
+## Range review
+
+Review changes between two commits or tags:
+
+```bash
+redline-review range --from <ref> --to <ref>
+redline-review range --from v1.0.0 --to v1.1.0 --prompt strict
+```
+
+## Commit walk
+
+Step through commits one at a time. Run `--start`, review the output, then `--next` to advance:
+
+```bash
+redline-review walk --start                       # begin
+redline-review walk --next                        # advance
+redline-review walk --status                      # check progress
+redline-review walk --reset                       # clear state
+redline-review walk --start --interval 2          # batch commits
+redline-review walk --start --direction forwards  # walk oldest → newest
+```
+
+## Repo review
+
+Full repository audit. Output is a manifest — use file-reading tools to explore as instructed:
+
+```bash
+redline-review repo
+redline-review repo --max-tree-depth 3
+```
+
 ## One-shot (no global install)
 
 ```bash

package/adapters/copilot/redline-review.md

@@ -24,8 +24,6 @@ Take the full output and treat it as your review instructions. Perform the revie
 
 ## Focused reviews
 
-In the Copilot Chat panel, ask it to run:
-
 ```bash
 redline-review --type auth,performance
 redline-review --stack laravel,inertia --type backend
@@ -33,6 +31,37 @@ redline-review --prompt strict
 redline-review --prompt lightweight
 ```
 
+## Range review
+
+Review changes between two commits or tags:
+
+```bash
+redline-review range --from <ref> --to <ref>
+redline-review range --from v1.0.0 --to v1.1.0 --prompt strict
+```
+
+## Commit walk
+
+Step through commits one at a time. After each step, perform the review from the output, then run `--next` to continue:
+
+```bash
+redline-review walk --start                       # begin
+redline-review walk --next                        # advance
+redline-review walk --status                      # check progress
+redline-review walk --reset                       # clear state
+redline-review walk --start --interval 2          # batch commits
+redline-review walk --start --direction forwards  # walk oldest → newest
+```
+
+## Repo review
+
+Full repository audit. Output is a manifest — use file-reading tools to explore the codebase as instructed:
+
+```bash
+redline-review repo
+redline-review repo --max-tree-depth 3
+```
+
 ## Workspace instructions path
 
 `.github/copilot-instructions.md` is loaded automatically by Copilot in VS Code for workspace-level context.

package/adapters/opencode/redline-review.md

@@ -25,6 +25,37 @@ redline-review --prompt strict
 redline-review --prompt lightweight
 ```
 
+## Range review
+
+Review changes between two commits or tags:
+
+```bash
+redline-review range --from <ref> --to <ref>
+redline-review range --from v1.0.0 --to v1.1.0 --prompt strict
+```
+
+## Commit walk
+
+Step through commits one at a time. Run `--start`, review the output, then `--next` to advance:
+
+```bash
+redline-review walk --start                       # begin
+redline-review walk --next                        # advance
+redline-review walk --status                      # check progress
+redline-review walk --reset                       # clear state
+redline-review walk --start --interval 2          # batch commits
+redline-review walk --start --direction forwards  # walk oldest → newest
+```
+
+## Repo review
+
+Full repository audit. Output is a manifest — use file-reading tools to explore as instructed:
+
+```bash
+redline-review repo
+redline-review repo --max-tree-depth 3
+```
+
 ## Integration tip
 
 Add to your project's `AGENTS.md` or OpenCode instructions:

package/dist/detect-repo-stacks.d.ts

@@ -0,0 +1,2 @@
+export declare function detectRepoStacks(): string[];
+//# sourceMappingURL=detect-repo-stacks.d.ts.map

package/dist/detect-repo-stacks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-repo-stacks.d.ts","sourceRoot":"","sources":["../src/detect-repo-stacks.ts"],"names":[],"mappings":"AAkBA,wBAAgB,gBAAgB,IAAI,MAAM,EAAE,CAkC3C"}

package/dist/detect-repo-stacks.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectRepoStacks = detectRepoStacks;
+const child_process_1 = require("child_process");
+const build_context_1 = require("./build-context");
+const EXTENSION_STACK_MAP = {
+    '.go': 'go',
+    '.tsx': 'react',
+    '.jsx': 'react',
+    '.vue': 'vue',
+    '.svelte': 'svelte',
+    '.rb': 'rails',
+    '.java': 'java',
+    '.cs': 'csharp',
+    '.py': 'django',
+    '.php': 'laravel',
+};
+const FALLBACK_FILES = ['correctness.yaml', 'maintainability.yaml', 'risk-patterns.yaml'];
+function detectRepoStacks() {
+    let files;
+    try {
+        const output = (0, child_process_1.execSync)('git ls-files', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        files = output ? output.split('\n') : [];
+    }
+    catch {
+        return FALLBACK_FILES;
+    }
+    const extCounts = new Map();
+    for (const f of files) {
+        const dot = f.lastIndexOf('.');
+        if (dot === -1)
+            continue;
+        const ext = f.slice(dot).toLowerCase();
+        extCounts.set(ext, (extCounts.get(ext) ?? 0) + 1);
+    }
+    const stacks = new Set();
+    for (const [ext, count] of extCounts) {
+        if (count < 2)
+            continue;
+        const stack = EXTENSION_STACK_MAP[ext];
+        if (stack)
+            stacks.add(stack);
+    }
+    // Detect Node.js projects by package.json presence
+    if (files.includes('package.json') && !stacks.has('react')) {
+        stacks.add('node');
+    }
+    if (stacks.size === 0)
+        return FALLBACK_FILES;
+    const result = (0, build_context_1.buildReviewContext)({ stack: Array.from(stacks) });
+    return result.length > 0 ? result : FALLBACK_FILES;
+}
+//# sourceMappingURL=detect-repo-stacks.js.map

package/dist/detect-repo-stacks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-repo-stacks.js","sourceRoot":"","sources":["../src/detect-repo-stacks.ts"],"names":[],"mappings":";;AAkBA,4CAkCC;AApDD,iDAAyC;AACzC,mDAAqD;AAErD,MAAM,mBAAmB,GAA2B;IAClD,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,OAAO;IACf,MAAM,EAAE,OAAO;IACf,MAAM,EAAE,KAAK;IACb,SAAS,EAAE,QAAQ;IACnB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,MAAM;IACf,KAAK,EAAE,QAAQ;IACf,KAAK,EAAE,QAAQ;IACf,MAAM,EAAE,SAAS;CAClB,CAAC;AAEF,MAAM,cAAc,GAAG,CAAC,kBAAkB,EAAE,sBAAsB,EAAE,oBAAoB,CAAC,CAAC;AAE1F,SAAgB,gBAAgB;IAC9B,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAA,wBAAQ,EAAC,cAAc,EACpC,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAChE,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,cAAc,CAAC;IACxB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC/B,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,SAAS;QACzB,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC;QACvC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;IACjC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,SAAS,EAAE,CAAC;QACrC,IAAI,KAAK,GAAG,CAAC;YAAE,SAAS;QACxB,MAAM,KAAK,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,KAAK;YAAE,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAED,mDAAmD;IACnD,IAAI,KAAK,CAAC,QAAQ,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3D,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,CAAC;IAED,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,cAAc,CAAC;IAE7C,MAAM,MAAM,GAAG,IAAA,kCAAkB,EAAC,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACjE,OAAO,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC;AACrD,CAAC"}

package/dist/manifest.d.ts

@@ -0,0 +1,8 @@
+export interface ManifestResult {
+    tree: string;
+    orientationContent: string;
+    fileCount: number;
+    truncated: boolean;
+}
+export declare function buildManifest(maxDepth?: number): ManifestResult;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AA2DA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,MAAM,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,aAAa,CAAC,QAAQ,GAAE,MAAW,GAAG,cAAc,CA0FnE"}

package/dist/manifest.js

@@ -0,0 +1,154 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildManifest = buildManifest;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const child_process_1 = require("child_process");
+const ENTRY_POINT_PATTERNS = /^(main|index|app|server|entrypoint|bootstrap|startup)\./i;
+const ORCHESTRATION_PATTERNS = /\b(runtime|scheduler|worker|queue|dispatcher|processor)\b/i;
+const MIGRATION_PATTERNS = /\bmigrations?\b/i;
+const CONFIG_BASENAMES = new Set([
+    'dockerfile', 'docker-compose.yml', 'docker-compose.yaml',
+    'makefile', 'justfile', 'taskfile.yml',
+    '.env.example', '.env.sample',
+]);
+const CONFIG_EXTENSIONS = new Set(['.tf', '.toml', '.ini']);
+const BINARY_EXTENSIONS = new Set([
+    '.png', '.jpg', '.jpeg', '.gif', '.ico', '.svg', '.webp', '.bmp',
+    '.woff', '.woff2', '.ttf', '.eot', '.otf',
+    '.zip', '.tar', '.gz', '.bz2', '.7z', '.rar',
+    '.exe', '.dll', '.so', '.dylib', '.bin',
+    '.mp3', '.mp4', '.avi', '.mov', '.wav',
+    '.pdf', '.doc', '.docx', '.xls', '.xlsx',
+    '.pyc', '.class', '.o', '.obj',
+]);
+const ORIENTATION_FILES = [
+    'package.json', 'go.mod', 'Cargo.toml', 'pyproject.toml',
+    'Gemfile', 'pom.xml', 'build.gradle', 'composer.json',
+    'Makefile', 'justfile', 'Taskfile.yml',
+    'tsconfig.json',
+];
+const MAX_INLINE_SIZE = 2048;
+const MAX_README_SIZE = 2048;
+function isBinary(filePath) {
+    const ext = path_1.default.extname(filePath).toLowerCase();
+    return BINARY_EXTENSIONS.has(ext);
+}
+function getTag(filePath, basename) {
+    if (ENTRY_POINT_PATTERNS.test(basename))
+        return 'entry-point';
+    if (MIGRATION_PATTERNS.test(filePath))
+        return 'migration';
+    if (ORCHESTRATION_PATTERNS.test(basename))
+        return 'orchestration';
+    if (CONFIG_BASENAMES.has(basename.toLowerCase()))
+        return 'config';
+    if (CONFIG_EXTENSIONS.has(path_1.default.extname(filePath).toLowerCase()))
+        return 'config';
+    if (basename.toLowerCase().startsWith('config') || basename.toLowerCase().startsWith('settings'))
+        return 'config';
+    return null;
+}
+function getLineCount(filePath) {
+    try {
+        const output = (0, child_process_1.execSync)(`wc -l < "${filePath}"`, { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        return parseInt(output, 10) || 0;
+    }
+    catch {
+        return 0;
+    }
+}
+function buildManifest(maxDepth = 10) {
+    let files;
+    try {
+        const output = (0, child_process_1.execSync)('git ls-files', { encoding: 'utf8', stdio: ['pipe', 'pipe', 'pipe'] }).trim();
+        files = output ? output.split('\n') : [];
+    }
+    catch {
+        return { tree: '(no tracked files)', orientationContent: '', fileCount: 0, truncated: false };
+    }
+    const nonBinary = files.filter(f => !isBinary(f));
+    // Compute largest files (top 10 by line count)
+    const fileSizes = [];
+    for (const f of nonBinary.slice(0, 500)) {
+        const lines = getLineCount(f);
+        if (lines > 0)
+            fileSizes.push({ file: f, lines });
+    }
+    fileSizes.sort((a, b) => b.lines - a.lines);
+    const largestFiles = new Set(fileSizes.slice(0, 10).map(f => f.file));
+    const largestMap = new Map(fileSizes.slice(0, 10).map(f => [f.file, f.lines]));
+    // Build annotated tree
+    let truncated = false;
+    const treeLines = [];
+    for (const f of nonBinary) {
+        const depth = f.split('/').length - 1;
+        if (depth > maxDepth) {
+            truncated = true;
+            continue;
+        }
+        const basename = path_1.default.basename(f);
+        const tag = getTag(f, basename);
+        const isLargest = largestFiles.has(f);
+        let annotation = '';
+        if (tag)
+            annotation += `  [${tag}]`;
+        if (isLargest)
+            annotation += `  (${largestMap.get(f)} lines) [largest]`;
+        treeLines.push(f + annotation);
+    }
+    if (truncated) {
+        const truncCount = nonBinary.filter(f => f.split('/').length - 1 > maxDepth).length;
+        treeLines.push(`... (${truncCount} files beyond depth ${maxDepth} truncated)`);
+    }
+    // Inline orientation files
+    const orientationParts = [];
+    for (const name of ORIENTATION_FILES) {
+        if (!files.includes(name))
+            continue;
+        try {
+            const content = fs_1.default.readFileSync(name, 'utf8');
+            if (content.length <= MAX_INLINE_SIZE) {
+                orientationParts.push(`### ${name}\n\`\`\`\n${content.trimEnd()}\n\`\`\``);
+            }
+            else {
+                orientationParts.push(`### ${name}\n\`\`\`\n${content.slice(0, MAX_INLINE_SIZE).trimEnd()}\n... (truncated)\n\`\`\``);
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    // Inline README (first 2KB)
+    const readmeFile = files.find(f => /^readme\.md$/i.test(f));
+    if (readmeFile) {
+        try {
+            const content = fs_1.default.readFileSync(readmeFile, 'utf8');
+            const trimmed = content.slice(0, MAX_README_SIZE).trimEnd();
+            orientationParts.push(`### ${readmeFile}\n${trimmed}${content.length > MAX_README_SIZE ? '\n... (truncated)' : ''}`);
+        }
+        catch { /* skip */ }
+    }
+    // Inline CI workflows (truncated)
+    const ciFiles = files.filter(f => f.startsWith('.github/workflows/') && f.endsWith('.yml'));
+    for (const f of ciFiles.slice(0, 3)) {
+        try {
+            const content = fs_1.default.readFileSync(f, 'utf8');
+            const trimmed = content.slice(0, 1024).trimEnd();
+            orientationParts.push(`### ${f}\n\`\`\`yaml\n${trimmed}${content.length > 1024 ? '\n... (truncated)' : ''}\n\`\`\``);
+        }
+        catch {
+            continue;
+        }
+    }
+    return {
+        tree: treeLines.join('\n'),
+        orientationContent: orientationParts.join('\n\n'),
+        fileCount: files.length,
+        truncated,
+    };
+}
+//# sourceMappingURL=manifest.js.map