pi-git-delegate 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+This project follows semantic versioning.
+
+## [0.2.0] - 2026-06-13
+
+### Added
+
+- `git_diff_summary` typed tool — delegates `git diff` summarization to a subagent.
+- `git_log_summary` typed tool — delegates `git log` digest generation to a subagent.
+- `git_blame_summary` typed tool — delegates `git blame` contributor context to a subagent.
+- `/git-delegate:configure` and `/git-delegate:status` commands for settings help.
+- Removed template `skills/`, `prompts/`, and `themes/` resources to avoid Pi resource conflicts and invalid theme warnings.
+
+## [0.1.2] - 2026-06-04
+
+### Changed
+
+- README and `docs/template-checklist.md` now follow the Pi OSS minimal-docs policy: `docs/` is optional, with explicit post-generation cleanup for template bootstrap docs.
+- Template bootstrap docs (`github-template.md`, `repository-settings.md`, `typescript.md`) are labeled for delete-or-merge after setup.
+
+## [0.1.1] - 2026-06-01
+
+### Changed
+
+- Publish workflow now supports npm publishing on merged package version bumps in addition to tags, releases, and manual dispatch.
+- Publish workflow now installs a current npm CLI so npm Trusted Publishing OIDC is supported.
+- CI and publish workflow commands no longer include literal trailing `\\n` text.
+
+## [0.1.0] - YYYY-MM-DD
+
+### Added
+
+- Initial Pi package template.
+- Example extension, Agent Skill, prompt, and theme.
+- CI and npm Trusted Publishing workflow.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 YOUR_NAME
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,152 @@
+# Pi Git Delegate
+
+[![CI](https://github.com/eiei114/pi-git-delegate/actions/workflows/ci.yml/badge.svg)](https://github.com/eiei114/pi-git-delegate/actions/workflows/ci.yml)
+[![Publish](https://github.com/eiei114/pi-git-delegate/actions/workflows/publish.yml/badge.svg)](https://github.com/eiei114/pi-git-delegate/actions/workflows/publish.yml)
+[![npm version](https://img.shields.io/npm/v/pi-git-delegate.svg)](https://www.npmjs.com/package/pi-git-delegate)
+[![npm downloads](https://img.shields.io/npm/dm/pi-git-delegate.svg)](https://www.npmjs.com/package/pi-git-delegate)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![Pi package](https://img.shields.io/badge/pi-package-purple.svg)](https://pi.dev/packages)
+
+> Delegate git operations (diff/log/blame) to cheaper models via subagents — keeping parent context clean and cutting costs.
+
+## What this is
+
+Pi Git Delegate provides typed tools that internally delegate heavy git read operations (diff, log, blame) to subagents. The subagent processes the raw git output and returns only a concise summary to the parent session. This prevents large diffs from polluting the parent's context window and lets you route expensive operations to cheaper models.
+
+## When to delegate
+
+The cost leverage principle: **delegate only when input is large and output is small.**
+
+| Operation | Delegation | Why |
+|---|---|---|
+| `git diff` (→ summary) | ✅ Delegate | Diff is large (1000+ tokens), summary is tiny |
+| `git log` (→ changelog) | ✅ Delegate | Many commits → compact digest |
+| `git blame` (→ context) | ✅ Delegate | Full blame is verbose; what matters is who/when/why |
+| `git status` | ❌ Direct | Output is tiny; subagent overhead not worth it |
+| `git push` / `git commit` | ❌ Direct | Write operations stay in parent for safety |
+
+## Features
+
+- **`git_diff_summary`** — delegate `git diff` to a subagent, return a 1-3 sentence summary
+- **`git_log_summary`** — delegate `git log` range, return a structured digest
+- **`git_blame_summary`** — delegate `git blame`, return who changed what and why
+- **Per-tool model routing** — set `provider` and `model` per tool in `.pi/settings.json` (`null` uses the session defaults)
+- **`/git-delegate:configure`** — interactive help for writing the settings block
+- **`/git-delegate:status`** — show current model routing and example JSON
+- **Model override parameter** — override model per-call via tool parameter
+- **Fallback to current model** — no config needed; uses the parent session model
+- **Write guard** — no write operations exposed as tools
+
+## Install
+
+```bash
+pi install npm:pi-git-delegate
+```
+
+Install locally (project-scoped):
+
+```bash
+pi install npm:pi-git-delegate -l
+```
+
+Try without installing:
+
+```bash
+pi -e .
+```
+
+## Usage
+
+Once installed, the tools are available automatically. Pi calls them via `pi list`.
+
+### Configure model per tool (optional)
+
+Run in Pi:
+
+```txt
+/git-delegate:configure
+```
+
+This shows what each key does, prints a starter JSON block, and can save it to `.pi/settings.json` interactively.
+
+Check the current routing anytime with:
+
+```txt
+/git-delegate:status
+```
+
+Manual example for `.pi/settings.json`:
+
+```json
+{
+  "pi-git-delegate": {
+    "diff": { "provider": "anthropic", "model": "claude-3-5-haiku-latest" },
+    "log": { "provider": null, "model": null },
+    "blame": { "provider": null, "model": null }
+  }
+}
+```
+
+`null` means "use the current session provider/model".
+
+### Call a tool
+
+```txt
+git_diff_summary({ref: "HEAD~3"})
+→ "feat: add avatar upload with resize (3 files, 2 commits)"
+
+git_log_summary({range: "main..feature"})
+→ "3 commits: feat(avatar), fix(crop), chore(deps)"
+
+git_blame_summary({path: "src/auth.ts"})
+→ "src/auth.ts: 3 authors, most recent by @alice (2026-06-01)"
+```
+
+## Package contents
+
+| Path | Purpose |
+|---|---|
+| `extensions/` | Pi TypeScript extension entrypoints |
+| `lib/` | Shared TypeScript helpers |
+| `docs/` | Optional supporting docs |
+
+## Development
+
+```bash
+npm install
+npm run ci
+```
+
+## Release
+
+This package is set up for npm Trusted Publishing, so no `NPM_TOKEN` is required.
+
+```bash
+npm version patch
+git push
+```
+
+See [`docs/release.md`](docs/release.md) for setup details.
+
+## Docs
+
+`docs/` is optional supporting documentation, not a fixed six-file set. README stays the GitHub/npm entrypoint; add `docs/*.md` only when they help users or maintainers.
+
+- [`docs/examples.md`](docs/examples.md) — tool usage examples
+- [`docs/release.md`](docs/release.md) — Trusted Publishing details (README Release summarizes the flow)
+
+## Security
+
+Pi packages can execute code with your local permissions. Review extensions before installing third-party packages.
+
+For vulnerability reporting, see [`SECURITY.md`](SECURITY.md).
+
+## Links
+
+- npm: https://www.npmjs.com/package/pi-git-delegate
+- GitHub: https://github.com/eiei114/pi-git-delegate
+- Issues: https://github.com/eiei114/pi-git-delegate/issues
+
+## License
+
+MIT\n

package/docs/examples.md

@@ -0,0 +1,50 @@
+# Examples
+
+Pi Git Delegate ships typed tools for delegating heavy git read operations to subagents.
+
+## Extension
+
+`extensions/index.ts` registers:
+
+- `git_diff_summary`
+- `git_log_summary`
+- `git_blame_summary`
+- `/git-delegate:configure`
+- `/git-delegate:status`
+
+Try it locally:
+
+```bash
+pi -e .
+```
+
+Then call a tool from Pi:
+
+```txt
+git_diff_summary({ref: "HEAD~3"})
+git_log_summary({range: "HEAD~5..HEAD"})
+git_blame_summary({path: "lib/config.ts"})
+```
+
+## Settings
+
+Configure per-tool subagent models:
+
+```txt
+/git-delegate:configure
+/git-delegate:status
+```
+
+Manual example for `.pi/settings.json`:
+
+```json
+{
+  "pi-git-delegate": {
+    "diff": { "provider": "anthropic", "model": "claude-3-5-haiku-latest" },
+    "log": { "provider": null, "model": null },
+    "blame": { "provider": null, "model": null }
+  }
+}
+```
+
+`null` uses the current session provider/model.

package/docs/release.md

@@ -0,0 +1,57 @@
+# Release
+
+This package uses npm Trusted Publishing with GitHub Actions OIDC.
+
+Do not add `NPM_TOKEN` or long-lived npm tokens to GitHub Secrets.
+
+## One-time npm setup
+
+On npmjs.com, configure Trusted Publishing for this package:
+
+- Publisher: GitHub Actions
+- Repository: this GitHub repository
+- Workflow filename: `publish.yml`
+
+## Publish
+
+```bash
+npm version patch
+git push
+```
+
+On `main`, `.github/workflows/auto-release.yml` checks `package.json` version. If `v<version>` does not exist yet, it creates the tag, creates the GitHub Release, then explicitly dispatches `.github/workflows/publish.yml` for that tag.
+
+The `v*.*.*` tag also triggers `.github/workflows/publish.yml`, which runs CI and publishes to npm when tags are pushed manually.
+Publishing also runs when a GitHub Release is published, and can be run manually from GitHub Actions with `workflow_dispatch`.
+
+The workflow skips `name@version` if that exact package version already exists on npm.
+
+## Workflow guardrail
+
+Do not ship a new Pi OSS package or version bump with only `package.json` changes.
+The repository must include the release workflow pair:
+
+- `.github/workflows/auto-release.yml` creates `v<version>` tags and GitHub Releases from `main` version bumps.
+- `.github/workflows/publish.yml` publishes to npm through Trusted Publishing.
+
+Important: tags or releases created by `GITHUB_TOKEN` do not reliably fan out into another workflow through normal `push.tags` or `release.published` triggers. The template keeps publishing reliable by having `auto-release.yml` explicitly dispatch `publish.yml` after creating the tag/release. If you change the release flow, keep one explicit handoff path: `workflow_dispatch` from auto-release, `repository_dispatch`, or `workflow_run` on the auto-release workflow.
+
+## GitHub Actions requirements
+
+- `permissions: id-token: write`
+- `permissions: actions: write` on auto-release so it can dispatch `publish.yml`
+- `auto-release.yml` must call `gh workflow run publish.yml --ref "$TAG" -f ref="$TAG"`, or `publish.yml` must have an equivalent explicit handoff trigger such as `workflow_run`
+- GitHub-hosted runner
+- Node.js 24, so the release job uses a current npm CLI for Trusted Publishing
+- No `NPM_TOKEN`
+- `npm publish` from the configured workflow file
+
+## First release checklist
+
+- [ ] `package.json` name is final
+- [ ] `repository.url` points to the real GitHub repository
+- [ ] npm Trusted Publisher is configured
+- [ ] `npm run ci` passes
+- [ ] `npm pack --dry-run` contains only intended files
+- [ ] CHANGELOG.md has the release date
+

package/docs/template-checklist.md

@@ -0,0 +1,144 @@
+# Template Setup Checklist
+
+このテンプレートから新しい Pi 拡張OSSを作った後に埋めること。
+
+## Recommended flow
+
+- [ ] Vault project notes を `4_Project/<ProjectName>/` に作る
+- [ ] `CONTEXT.md` / `README.md` / `ROADMAP.md` / `Docs/` / `Issues/` / `Progress/` を揃える
+- [ ] PRD を `4_Project/<ProjectName>/Docs/` に置く
+- [ ] approved issue を `4_Project/<ProjectName>/Issues/` に切る
+- [ ] OSS repo 側で実装する
+- [ ] `npm run ci` / `npm test` / `npm pack --dry-run` を通す
+- [ ] release 後に Vault へ learnings / release notes を戻す
+
+## Repository
+
+- [ ] GitHub repository name を決める
+- [ ] GitHub About 欄を書く
+- [ ] GitHub topics を設定する
+  - [ ] `pi`
+  - [ ] `pi-package`
+  - [ ] `agent-skill`
+  - [ ] `typescript`
+- [ ] GitHub Settingsで `Template repository` をONにする
+- [ ] Repository URL を `package.json` に反映する
+- [ ] README の `OWNER/REPO` を実リポジトリに置き換える
+
+## Package metadata
+
+- [ ] `package.json` の `name` を変更する
+- [ ] `description` を書く
+- [ ] `author` を入れる
+- [ ] `repository.url` を埋める
+- [ ] `bugs.url` を埋める
+- [ ] `homepage` を埋める
+- [ ] `keywords` を見直す
+- [ ] `LICENSE` の年・名前を更新する
+
+## README placeholders
+
+- [ ] `PACKAGE_DISPLAY_NAME` を置き換える
+- [ ] `PACKAGE_NAME` を置き換える
+- [ ] `OWNER/REPO` を置き換える
+- [ ] one-line pitch を書く
+- [ ] feature list を書く
+- [ ] quick start command を実コマンドにする
+- [ ] npm URL を確認する
+- [ ] GitHub URL を確認する
+
+## Pi package manifest
+
+- [ ] `pi.extensions` に公開する拡張だけを残す
+- [ ] **extension のみで ship するなら** `pi.skills` / `pi.prompts` / `pi.themes` を `package.json` から削除する
+- [ ] **extension のみで ship するなら** `skills/` / `prompts/` / `themes/` ディレクトリを削除する
+- [ ] skill を出すなら `example-skill` を **package 固有名** にリネームする（例: `<pkg>-workflow`）
+- [ ] prompt を出すなら `example.md` を **package 固有名** にリネームする（例: `<pkg>-summarize.md`）
+- [ ] theme を出すなら built-in theme と同じ **全必須 color token** を入れる。未完成なら `themes/` ごと削除
+- [ ] `package.json` の `files` から、削除した resource パスを外す
+- [ ] skill を出さないなら `keywords` / GitHub topics から `agent-skill` を外す
+- [ ] Pi 起動ログに `[Skill conflicts]` / `[Prompt conflicts]` / `[Theme conflicts]` が **自 package 分で出ない** ことを確認する
+
+## Documentation
+
+`docs/` は固定6ファイル必須ではない。README を正とし、価値がある doc だけ残す。
+
+### Required root files (public)
+
+- [ ] `README.md` — GitHub/npm の入口。Install / Quick start / Release / Security を含める
+- [ ] `LICENSE`
+- [ ] `SECURITY.md`
+- [ ] `CHANGELOG.md`
+- [ ] Release 手順が README と workflow で明確（Trusted Publishing 設定含む）
+
+### Recommended public docs (keep when useful)
+
+- [ ] `docs/examples.md` — 例が README に載り切らないとき
+- [ ] `docs/release.md` — Trusted Publishing や release 手順の詳細が README だけでは足りないとき
+- [ ] `docs/usage.md` — 使い方が README に載り切らないとき（必要なら新規作成）
+
+### Optional maintainer docs
+
+- [ ] `docs/template-checklist.md` — このファイル。成熟 repo では README からの主ナビにしない。不要なら削除可
+
+### Post-generation cleanup (delete or merge template setup docs)
+
+テンプレート生成直後の bootstrap 用。プロジェクト固有の価値がなければ削除し、必要な内容は README / `docs/release.md` / `docs/examples.md` に統合する。
+
+- [ ] `docs/github-template.md` を削除するか、固有の手順だけ README / Vault に移す
+- [ ] `docs/repository-settings.md` を削除するか、About/topics など必要分だけ README に移す
+- [ ] `docs/typescript.md` を削除するか、TypeScript 方針は README Development に要約する
+- [ ] README の Docs 節から、削除したファイルへのリンクを外す
+- [ ] `package.json` の `files` から、削除した `docs/` パスを外す（残す doc だけ明示する）
+
+## TypeScript
+
+- [ ] `extensions/index.ts` を実装に合わせて更新する
+- [ ] `extensions/hello.ts` が不要なら削除する
+- [ ] 共通ロジックを `lib/` に切り出す
+- [ ] `strict: true` を維持する
+- [ ] custom tool parameters は TypeBox schema で定義する
+- [ ] string choices は `StringEnum` helper を使う
+- [ ] runtime dependency は `dependencies`、Pi提供packageは `peerDependencies` に置く
+- [ ] `package.json.files` に公開対象だけを入れる
+- [ ] 詳細はセットアップ中だけ `docs/typescript.md` を参照し、不要なら post-generation cleanup で削除
+
+## GitHub Template repo
+
+- [ ] `gh repo create --template OWNER/pi-extension-template` で作成できることを確認する
+- [ ] public/privateどちらの作成例もdocsに載せる（`docs/github-template.md` を残す場合）
+
+## CI / Release
+
+- [ ] `npm run ci` が通る
+- [ ] `npm pack --dry-run` が通る
+- [ ] npm Trusted Publishing を設定する
+- [ ] npm Trusted Publisher の workflow filename が `publish.yml` になっている
+- [ ] `NPM_TOKEN` を使っていないことを確認する
+- [ ] `auto-release.yml` が `main` の version bump から tag/release を作ることを確認する
+- [ ] `publish.yml` が `workflow_dispatch` と `release.published` に対応していることを確認する
+- [ ] 初回リリースで npm provenance が付いているか確認する
+
+### Workflow handoff guard
+
+- [ ] `.github/workflows/auto-release.yml` exists before first release
+- [ ] `.github/workflows/publish.yml` exists before first release
+- [ ] `auto-release.yml` has `permissions: actions: write` and `contents: write`
+- [ ] `publish.yml` has `permissions: id-token: write` for npm Trusted Publishing
+- [ ] Auto release explicitly hands off to publish: `gh workflow run publish.yml --ref "$TAG" -f ref="$TAG"`, or `publish.yml` has an equivalent `workflow_run` / `repository_dispatch` trigger
+- [ ] Do not rely only on `push.tags` or `release.published` when the tag/release is created by `GITHUB_TOKEN`; that can leave npm unchanged after merge
+
+## npm page
+
+- [ ] npm package URL を README に追加する
+- [ ] npm description が適切に表示されるか確認する
+- [ ] provenance が付いているか確認する
+- [ ] 不要なファイルが package に含まれていないか確認する（`npm pack --dry-run` で `docs/` の残し方も確認）
+
+## Before first release
+
+- [ ] サンプルコードを実機 Pi でロードする
+- [ ] `pi install git:github.com/OWNER/REPO` を試す
+- [ ] `pi -e .` を試す
+- [ ] README のコマンドがコピペで動くか確認する
+- [ ] CHANGELOG に `0.1.0` を書く

package/extensions/index.ts

@@ -0,0 +1,8 @@
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { registerGitDelegateCommands } from "../lib/register-commands.ts";
+import { registerGitDelegateTools } from "../lib/register-tools.ts";
+
+export default function (pi: ExtensionAPI) {
+  registerGitDelegateCommands(pi);
+  registerGitDelegateTools(pi);
+}

package/lib/config.ts

@@ -0,0 +1,122 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
+
+export type GitDelegateToolName = "git_diff_summary" | "git_log_summary" | "git_blame_summary";
+export type GitDelegateToolKey = "diff" | "log" | "blame";
+
+export interface ModelRoute {
+  provider: string | null;
+  model: string | null;
+}
+
+export interface GitDelegateConfig {
+  diff: ModelRoute;
+  log: ModelRoute;
+  blame: ModelRoute;
+}
+
+export interface ResolvedSubagentRoute {
+  provider?: string;
+  model?: string;
+}
+
+export const NULL_MODEL_ROUTE: ModelRoute = {
+  provider: null,
+  model: null,
+};
+
+export const DEFAULT_GIT_DELEGATE_CONFIG: GitDelegateConfig = {
+  diff: { ...NULL_MODEL_ROUTE },
+  log: { ...NULL_MODEL_ROUTE },
+  blame: { ...NULL_MODEL_ROUTE },
+};
+
+const TOOL_CONFIG_KEYS: Record<GitDelegateToolName, GitDelegateToolKey> = {
+  git_diff_summary: "diff",
+  git_log_summary: "log",
+  git_blame_summary: "blame",
+};
+
+function isRecord(value: unknown): value is Record<string, unknown> {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+
+function trimOrUndefined(value: string | null | undefined): string | undefined {
+  if (value === null || value === undefined) return undefined;
+  const trimmed = value.trim();
+  return trimmed ? trimmed : undefined;
+}
+
+function parseNullableString(value: unknown): string | null {
+  if (value === null || value === undefined) return null;
+  if (typeof value !== "string") return null;
+  const trimmed = value.trim();
+  return trimmed ? trimmed : null;
+}
+
+function parseRoute(value: unknown): ModelRoute {
+  if (!isRecord(value)) {
+    return { ...NULL_MODEL_ROUTE };
+  }
+
+  return {
+    provider: parseNullableString(value.provider),
+    model: parseNullableString(value.model),
+  };
+}
+
+function readSettingsFile(filePath: string): Record<string, unknown> | undefined {
+  if (!existsSync(filePath)) return undefined;
+  try {
+    const parsed = JSON.parse(readFileSync(filePath, "utf8")) as unknown;
+    return isRecord(parsed) ? parsed : undefined;
+  } catch {
+    return undefined;
+  }
+}
+
+function parseGitDelegateConfig(settings: Record<string, unknown> | undefined): GitDelegateConfig | undefined {
+  if (!settings) return undefined;
+  const raw = settings["pi-git-delegate"];
+  if (!isRecord(raw)) return undefined;
+
+  return {
+    diff: parseRoute(raw.diff),
+    log: parseRoute(raw.log),
+    blame: parseRoute(raw.blame),
+  };
+}
+
+export function loadGitDelegateConfig(cwd: string): GitDelegateConfig | undefined {
+  const projectSettings = readSettingsFile(join(cwd, ".pi", "settings.json"));
+  const projectConfig = parseGitDelegateConfig(projectSettings);
+  if (projectConfig !== undefined) return projectConfig;
+
+  const agentSettings = readSettingsFile(join(getAgentDir(), "settings.json"));
+  return parseGitDelegateConfig(agentSettings);
+}
+
+export function resolveSubagentRoute(
+  toolName: GitDelegateToolName,
+  config: GitDelegateConfig | undefined,
+  override?: { provider?: string; model?: string },
+): ResolvedSubagentRoute | undefined {
+  const overrideProvider = trimOrUndefined(override?.provider);
+  const overrideModel = trimOrUndefined(override?.model);
+  if (overrideProvider || overrideModel) {
+    return {
+      provider: overrideProvider,
+      model: overrideModel,
+    };
+  }
+
+  if (!config) return undefined;
+
+  const route = config[TOOL_CONFIG_KEYS[toolName]];
+  const provider = trimOrUndefined(route.provider);
+  const model = trimOrUndefined(route.model);
+  if (!provider && !model) return undefined;
+
+  return { provider, model };
+}

package/lib/git-exec.ts

@@ -0,0 +1,21 @@
+import { spawnSync } from "node:child_process";
+
+export interface GitRunResult {
+  stdout: string;
+  stderr: string;
+  status: number;
+}
+
+export function runGit(args: string[], cwd: string): GitRunResult {
+  const result = spawnSync("git", args, {
+    cwd,
+    encoding: "utf8",
+    maxBuffer: 10 * 1024 * 1024,
+  });
+
+  return {
+    stdout: (result.stdout ?? "").trim(),
+    stderr: (result.stderr ?? "").trim(),
+    status: result.status ?? 1,
+  };
+}

package/lib/prompts.ts

@@ -0,0 +1,34 @@
+export const DIFF_SUMMARY_PROMPT = `You are a git diff summarizer. Given a raw git diff output,
+produce a concise summary in 1-3 sentences covering:
+- What files changed
+- The nature of the changes (feature, fix, refactor)
+- Any notable patterns or risks
+
+Do not output the diff back. Only output the summary.
+Use no markdown formatting. One paragraph max.`;
+
+export const LOG_SUMMARY_PROMPT = `You are a git log summarizer. Given a git log output with
+commit hashes and messages, produce a concise digest in
+2-4 sentences covering:
+- How many commits and their general theme
+- The main types of changes (features, fixes, refactors)
+- Any notable patterns
+
+Do not output the raw log. Only output the summary.
+Use no markdown formatting. Two paragraphs max.`;
+
+export const BLAME_SUMMARY_PROMPT = `You are a git blame summarizer. Given a git blame output,
+produce a concise summary in 2-3 sentences covering:
+- Total number of contributors to this file
+- Who made the most recent changes and when
+- The general age of the file (new, actively maintained, stable)
+
+Do not output the raw blame. Only output the summary.
+Use no markdown formatting. Two paragraphs max.`;
+
+export function buildSubagentPrompt(systemPrompt: string, gitOutput: string): string {
+  return `${systemPrompt}
+
+Git output:
+${gitOutput}`;
+}