🎩 You're Invited:Meet the Socket team at Black Hat in Las Vegas, August 3-6.RSVP →
pi-git-delegate
Advanced tools
pi-git-delegate - npm Package Compare versions
+19
-0
@@ -7,2 +7,21 @@ # Changelog | ||
| ## [Unreleased] | ||
| ### Added | ||
| - Config smoke tests for `logModel` and `blameModel` shorthand routing. | ||
| - Integration test for empty `git_blame_summary` output. | ||
| - CI workflow smoke test verifying `npm run ci` runs on push/PR. | ||
| ### Removed | ||
| - `docs/template-checklist.md` — template bootstrap doc no longer needed after package setup. | ||
| ## [0.2.1] - 2026-06-27 | ||
| ### Changed | ||
| - README: add canonical `Quick start` section after `Install`, aligned with the Pi OSS extension template. | ||
| - README: preserve delegation guidance, configuration, and tool examples under `When to delegate`, `Configuration`, and `Tool examples`. | ||
| ## [0.2.0] - 2026-06-13 | ||
@@ -9,0 +28,0 @@ |
+18
-3
@@ -69,2 +69,17 @@ import { existsSync, readFileSync } from "node:fs"; | ||
| function parseRouteWithShorthand(routeValue: unknown, shorthandModel: unknown): ModelRoute { | ||
| const route = parseRoute(routeValue); | ||
| // Explicit nested route object should always take precedence over shorthand. | ||
| if (isRecord(routeValue)) { | ||
| return route; | ||
| } | ||
| const model = parseNullableString(shorthandModel); | ||
| if (model !== null) { | ||
| return { provider: null, model }; | ||
| } | ||
| return route; | ||
| } | ||
| function readSettingsFile(filePath: string): Record<string, unknown> | undefined { | ||
@@ -86,5 +101,5 @@ if (!existsSync(filePath)) return undefined; | ||
| return { | ||
| diff: parseRoute(raw.diff), | ||
| log: parseRoute(raw.log), | ||
| blame: parseRoute(raw.blame), | ||
| diff: parseRouteWithShorthand(raw.diff, raw.diffModel), | ||
| log: parseRouteWithShorthand(raw.log, raw.logModel), | ||
| blame: parseRouteWithShorthand(raw.blame, raw.blameModel), | ||
| }; | ||
@@ -91,0 +106,0 @@ } |
+2
-2
| { | ||
| "name": "pi-git-delegate", | ||
| "version": "0.2.0", | ||
| "version": "0.2.1", | ||
| "description": "Pi extension: delegate git operations (diff/log/blame) to cheaper models via subagents, saving costs and keeping parent context clean.", | ||
@@ -55,5 +55,5 @@ "type": "module", | ||
| "typebox": "latest", | ||
| "@types/node": "^22.0.0", | ||
| "@types/node": "^26.0.0", | ||
| "typescript": "^6.0.3" | ||
| } | ||
| } |
+16
-6
@@ -58,10 +58,18 @@ # Pi Git Delegate | ||
| ## Usage | ||
| ## Quick start | ||
| Once installed, the tools are available automatically. Pi calls them via `pi list`. | ||
| After installing (see above) or running `pi -e .` from this repo, call each tool in Pi: | ||
| ### Configure model per tool (optional) | ||
| ```txt | ||
| git_diff_summary({ref: "HEAD~3"}) | ||
| git_log_summary({range: "main..feature"}) | ||
| git_blame_summary({path: "src/auth.ts"}) | ||
| ``` | ||
| Run in Pi: | ||
| The tools are registered automatically — no extra setup required. | ||
| ## Configuration | ||
| Model routing is optional. Run in Pi: | ||
| ```txt | ||
@@ -93,4 +101,6 @@ /git-delegate:configure | ||
| ### Call a tool | ||
| ## Tool examples | ||
| Once installed, the tools are available automatically. Pi calls them via `pi list`. | ||
| ```txt | ||
@@ -154,2 +164,2 @@ git_diff_summary({ref: "HEAD~3"}) | ||
| MIT\n | ||
| MIT |
| # 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` を書く |
No alert changes
Improved metrics
- Lines of code
726
1.68%- Number of lines in readme file
163
7.24%Worsened metrics
- Total package byte prevSize
40618
-12.16%- Number of package files
18
-5.26%No dependency changes