pi-baton 0.7.1 → 0.7.2

package/CHANGELOG.md

@@ -4,6 +4,17 @@ All notable changes to this project will be documented in this file.
 
 This project follows semantic versioning.
 
+## [Unreleased]
+
+- Add Buy Me a Coffee sponsor button to README and native GitHub funding link via `.github/FUNDING.yml`.
+
+### Changed
+
+- Merged Dependabot PR #14: bump `@earendil-works/pi-ai` devDependency from 0.78.1 to 0.80.2 (type-check clean, 57/57 tests passing).
+- Removed leftover template scaffolding (`prompts/`, `themes/`, `skills/`).
+- Deleted stale template bootstrap docs (`docs/examples.md`, `docs/github-template.md`, `docs/repository-settings.md`, `docs/typescript.md`, `docs/template-checklist.md`) that shipped to npm consumers describing non-existent commands.
+- Updated ROADMAP.md to reflect current version (0.7.1), test count (57), and seed completion status for S-101, S-102, S-103, S-105.
+
 ## [0.7.1] - 2026-06-27
 
 ### Changed
@@ -128,3 +139,4 @@ This project follows semantic versioning.
 - Initial Pi package template.
 - Example extension, Agent Skill, prompt, and theme.
 - CI and npm Trusted Publishing workflow.
+

package/README.md

@@ -11,6 +11,7 @@
 [![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)
 [![Trusted Publishing](https://img.shields.io/badge/npm-Trusted%20Publishing-blue.svg)](docs/release.md)
+<a href="https://buymeacoffee.com/ekawano114m"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" width="217" height="60"></a>
 
 > Run YAML-defined review loops in Pi with per-step model switching and isolated step context.
 
@@ -134,7 +135,7 @@ steps:
 | `agents/` | Builtin `worker` and `reviewer` subagent definitions |
 | `workflows/` | Builtin `default-review-loop.yaml` |
 | `assets/` | README / package branding assets |
-| `docs/` | Release and maintainer docs |
+| `docs/` | Release and maintainer documentation |
 
 ## Development
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-baton",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Pi-native workflow baton runner with per-step model switching and isolated step context.",
   "type": "module",
   "engines": {

package/docs/examples.md

@@ -1,49 +0,0 @@
-# Examples
-
-This template ships one minimal example for each Pi package resource type.
-
-## Extension
-
-`extensions/hello.ts` registers:
-
-- `/template-hello`
-- a small session status indicator
-
-Try it with:
-
-```bash
-pi -e .
-```
-
-Then run:
-
-```txt
-/template-hello YourName
-```
-
-## Agent Skill
-
-`skills/example-skill/SKILL.md` demonstrates a minimal Agent Skill.
-
-Replace it with your real workflow instructions.
-
-## Prompt template
-
-`prompts/example.md` demonstrates a tiny prompt template with one variable.
-
-## Theme
-
-`themes/example-theme.json` is a placeholder theme. Replace it or remove `themes/` if your package does not ship themes.
-
-## Typed custom tool
-
-`extensions/index.ts` registers:
-
-- `/template-info`
-- `template_greet` custom tool
-
-The tool demonstrates:
-
-- TypeBox object parameters
-- a string enum schema via `StringEnum`
-- shared logic imported from `lib/greeting.ts`

package/docs/github-template.md

@@ -1,63 +0,0 @@
-# GitHub Template Repository
-
-> **Template bootstrap doc.** Use while setting up a new repo from this template. Delete this file or merge any project-specific steps into README / Vault notes once setup is done, unless it still adds maintainer value.
-
-## Recommended development flow
-
-After generating a repo from this template, use this default order:
-
-```txt
-Vault notes -> PRD -> Issues -> implement -> ci/check -> release -> save learnings
-```
-
-In practice:
-
-1. Create Vault notes under `4_Project/<ProjectName>/`.
-2. Add `CONTEXT.md`, `README.md`, `ROADMAP.md`, `Docs/`, `Issues/`, and `Progress/`.
-3. Write the PRD in `Docs/`.
-4. Split approved issue files into `Issues/`.
-5. Implement in the OSS repo created from this template.
-6. Run CI and package checks before release.
-7. Save release notes and follow-up decisions back to the Vault project.
-
-Enable template mode on the source repository:
-
-```txt
-GitHub repo → Settings → General → Template repository
-```
-
-Create a public repository from the template:
-
-```bash
-gh repo create OWNER/new-pi-extension \
-  --public \
-  --template OWNER/pi-extension-template \
-  --clone
-```
-
-Create a private repository from the template:
-
-```bash
-gh repo create OWNER/new-pi-extension \
-  --private \
-  --template OWNER/pi-extension-template \
-  --clone
-```
-
-Include all branches if needed:
-
-```bash
-gh repo create OWNER/new-pi-extension \
-  --public \
-  --template OWNER/pi-extension-template \
-  --include-all-branches \
-  --clone
-```
-
-After creation:
-
-```bash
-cd new-pi-extension
-npm install
-npm run ci
-```\n

package/docs/repository-settings.md

@@ -1,43 +0,0 @@
-# Repository Settings
-
-> **Template bootstrap doc.** Use while configuring GitHub About, topics, and branch protection after generating a repo. Delete this file or merge needed settings into README once setup is done, unless it still adds maintainer value.
-
-Use this file after creating a real repository from the template.
-
-## GitHub About
-
-Suggested fields:
-
-- Description: one-line pitch for the Pi package
-- Website: npm package URL or project docs URL
-- Topics:
-  - `pi`
-  - `pi-package`
-  - `agent-skill`
-  - `typescript`
-
-## Template mode
-
-If this repository itself should be reusable as a template:
-
-```txt
-Settings → General → Template repository
-```
-
-## Branch protection
-
-Recommended for public packages:
-
-- Require pull request before merging
-- Require status checks to pass
-- Require `CI` workflow
-- Block force pushes on the default branch
-
-## npm package page
-
-After first publish:
-
-- Confirm README renders correctly
-- Confirm package provenance appears
-- Confirm package contents are intentional
-- Add npm URL to GitHub About and README

package/docs/template-checklist.md

@@ -1,140 +0,0 @@
-# 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` に公開する拡張だけを残す
-- [ ] `pi.skills` に公開する skill だけを残す
-- [ ] 不要なら `prompts/` を消す
-- [ ] 不要なら `themes/` を消す
-- [ ] サンプル名を実名に変える
-
-## 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/docs/typescript.md

@@ -1,77 +0,0 @@
-# TypeScript Guide
-
-> **Template bootstrap doc.** Use while learning this template's TypeScript layout and dependency rules. Delete this file or summarize the policies you keep in README Development once setup is done, unless it still adds maintainer value.
-
-This is a TypeScript-first Pi package template.
-
-## Layout
-
-```txt
-extensions/*.ts      Pi extension entrypoints
-lib/*.ts             Shared TypeScript helpers
-skills/*/SKILL.md    Agent Skills
-prompts/*.md         Prompt templates
-themes/*.json        Themes
-tests/*.test.mjs     Smoke tests
-tests/*.test.ts      Optional TypeScript tests if you add a TS test runner
-```
-
-Pi loads TypeScript extensions directly, so no build step is required for normal use.
-
-## Strict mode
-
-`tsconfig.json` keeps `strict: true`. Prefer fixing types over loosening compiler options.
-
-## Extension entrypoints
-
-Two entrypoint styles are shown:
-
-- `extensions/hello.ts`: single-file extension
-- `extensions/index.ts`: index-style extension that imports shared code from `lib/`
-
-For larger packages, keep entrypoints thin and put reusable logic in `lib/`.
-
-## TypeBox schemas
-
-Use TypeBox schemas for custom tool parameters.
-
-```ts
-import { Type } from "typebox";
-
-const parameters = Type.Object({
-  name: Type.String({ description: "Name to greet" }),
-});
-```
-
-## String enums
-
-For string choices, use the local `StringEnum` helper from `lib/schema.ts`.
-
-```ts
-import { StringEnum } from "../lib/schema.ts";
-
-const mode = StringEnum(["short", "friendly"], {
-  description: "Greeting style",
-});
-```
-
-This emits a JSON Schema `enum`, which is friendlier to model providers than a union of string literals.
-
-## Runtime dependencies vs peer dependencies
-
-Pi bundles core packages for extension authors. Keep Pi-provided packages as `peerDependencies` and also install them as `devDependencies` for local typechecking.
-
-Use `peerDependencies` for:
-
-- `@earendil-works/pi-coding-agent`
-- `@earendil-works/pi-ai`
-- `@earendil-works/pi-tui`
-- `typebox`
-
-Use `dependencies` for runtime packages your extension imports that Pi does not provide.
-
-Use `devDependencies` for local-only tools such as TypeScript, test runners, and linters.
-
-## Package contents
-
-Control npm package contents with `package.json` `files`. Prefer this over `.npmignore` so the published package stays explicit.