@maxiaochao/pi-toolkit 0.7.1 → 0.7.2

package/CHANGELOG.md

@@ -1,3 +1,7 @@
+## 2026-09-24 - v0.7.2
+
+- bundle the calldiff skill (copied verbatim from tanishqkancharla/calldiff, MIT, pinned to a main commit since upstream has no release tags) for call-stack diffs across git commits; the previous v0.7.1 tarball was briefly unavailable on the registry right after publish and is now served normally
+
 ## 2026-09-24 - v0.7.1
 
 - bundle the herdr skill (copied verbatim from herdrdev/herdr v0.9.1, Apache-2.0) for driving the Herdr terminal multiplexer from inside a pane; move the tapd CLI skill from .claude/skills into skills/ so it ships with the package

package/README.md

@@ -89,6 +89,8 @@ The bundled `herdr` skill (copied verbatim from [herdrdev/herdr](https://github.
 
 The bundled `tapd` skill documents the third-party `tapd` CLI ([studyzy/tapd-ai-cli](https://github.com/studyzy/tapd-ai-cli)) for TAPD: requirements, defects, tasks, iterations, wikis, comments, attachments, timesheets, and workflow status maps, including the `--filter` advanced query syntax. It is the CLI's own command reference, so refresh the file with `tapd skill init` when the CLI changes.
 
+The bundled `calldiff` skill (copied verbatim from [tanishqkancharla/calldiff](https://github.com/tanishqkancharla/calldiff), MIT, pinned to a `main` commit because upstream has no release tags) teaches call-stack diffs across git commits: `diff` shows which callees appeared, disappeared, or moved under an entrypoint, `tree` prints one call tree, and `reach` finds call paths between two symbols, all with `--entry`/`--file` entrypoint selection, `--locs` source locations, and `--format json` for agents.
+
 ## Tiny Subagent
 
 The tiny subagent is a separate npm package. Install it independently when you want the `tiny_subagents` tool:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@maxiaochao/pi-toolkit",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Personal pi coding agent toolkit: /todos, /btw, /cache_export extensions, browser automation, and bundled theme/skills.",
   "type": "module",
   "keywords": [

package/skills/calldiff/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Tanishq Kancharla
+
+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/skills/calldiff/NOTICE

@@ -0,0 +1,19 @@
+calldiff Skill
+
+This directory is copied verbatim from the calldiff repository:
+https://github.com/tanishqkancharla/calldiff
+skills/calldiff/SKILL.md at commit 2086f6e4e9ed3c410bba7c94ca3dde77791b1956 (main)
+
+The upstream repository is licensed under the MIT License. A copy of that
+license is included in LICENSE.
+
+Upstream publishes no release tags, so this file is pinned to a main commit
+instead of a tag. The CLI can also write its own copy with `calldiff skills
+add` (to ~/.agents/skills/calldiff/SKILL.md), but that generated file is terser
+than the committed one — it leaves the --entry/--file descriptions empty and
+says 22 languages — so pi-toolkit ships the committed file.
+
+To refresh, copy skills/calldiff/SKILL.md and LICENSE from a newer upstream
+commit and update the commit above. The bundled commands were smoke-tested
+against calldiff 0.5.0 (`diff`, `tree`, `reach`, `--entry`, `--file`,
+`--maxDepth`/`--max-depth`, `--locs`, `--format json`).

package/skills/calldiff/SKILL.md

@@ -0,0 +1,121 @@
+---
+name: calldiff
+description: Diff call stacks across git commits — like git diff, but for who-calls-whom. Shows which callees appeared, disappeared, or moved under an entrypoint across 23 languages (diff, tree, and reach). Use for agentic code review when call flow changed and line diffs bury the shape of the change.
+requires_bin: calldiff
+command: calldiff
+---
+
+# calldiff diff
+
+Diff call stacks between two git trees
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `from` | `string` | no | Before ref (default: HEAD) |
+| `to` | `string` | no | After ref (default: working tree) |
+| `paths` | `array` | no | Limit to these path prefixes |
+
+## Options
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--entry` | `unknown` |  | Entrypoint symbol(s): functionName or ClassName.method |
+| `--file` | `unknown` |  | Entrypoint file(s): indexed source path; expands to that file's exports |
+| `--maxDepth` | `number` | `12` | Max call-tree depth |
+| `--locs` | `boolean` | `false` | Show call-site source locations (file:line) |
+| `--from` | `string` |  | Left / "before" tree |
+| `--to` | `string` |  | Right / "after" tree |
+
+## Examples
+
+```sh
+# HEAD vs working tree
+calldiff diff
+
+# One ref vs working tree
+calldiff diff main
+
+# Two commits / branches
+calldiff diff abc123 def456
+
+# Force entrypoints
+calldiff diff main feature --entry createAgentSession
+
+# File expands to that file's exports
+calldiff diff main feature --file src/routes.ts
+```
+
+> Semantics match git diff: no refs → HEAD vs worktree; one ref → that vs worktree; two refs → compare those trees.
+
+---
+
+# calldiff reach
+
+Find all call paths from an entrypoint to a target symbol
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `ref` | `string` | no | Git ref (default: working tree) |
+| `paths` | `array` | no | Limit to these path prefixes |
+
+## Options
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--entry` | `unknown` |  | Entrypoint symbol(s): functionName or ClassName.method |
+| `--file` | `unknown` |  | Entrypoint file(s): indexed source path; expands to that file's exports |
+| `--to` | `string` |  | Target symbol to reach (functionName or ClassName.method) |
+| `--maxDepth` | `number` | `12` | Max call-tree depth |
+| `--locs` | `boolean` | `false` | Show call-site source locations (file:line) |
+
+## Examples
+
+```sh
+# Paths in the working tree
+calldiff reach --entry runCheckout --to sendEmail
+
+# Paths at a commit, limited to a directory
+calldiff reach HEAD examples/checkout --entry runCheckout --to sendEmail
+
+# Paths from every export in a file
+calldiff reach --file packages/api/src/flow.ts --to notify
+```
+
+---
+
+# calldiff tree
+
+View a call tree (no diff) for one or more entrypoints
+
+## Arguments
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| `ref` | `string` | no | Git ref (default: working tree) |
+| `paths` | `array` | no | Limit to these path prefixes |
+
+## Options
+
+| Flag | Type | Default | Description |
+|------|------|---------|-------------|
+| `--entry` | `unknown` |  | Entrypoint symbol(s): functionName or ClassName.method |
+| `--file` | `unknown` |  | Entrypoint file(s): indexed source path; expands to that file's exports |
+| `--maxDepth` | `number` | `12` | Max call-tree depth |
+| `--locs` | `boolean` | `false` | Show call-site source locations (file:line) |
+
+## Examples
+
+```sh
+# Tree from working tree
+calldiff tree --entry createAgentSession
+
+# Tree from a commit
+calldiff tree HEAD --entry PiService.createAgentSession
+
+# Every export in a file
+calldiff tree --file packages/api/src/routes.ts
+```