@difflab/pi 0.7.2 → 0.8.0

package/README.md

@@ -10,9 +10,11 @@ pi install npm:@difflab/pi
 
 Run `/skill:diffpi-setup` to validate or configure the environment. Setup asks before making changes and reloads Pi when needed. It installs upstream Grounded Docs, Simple English, and Context Mode skills and package-managed agent profiles for the subagent plugin. The package manifest loads every bundled skill and registers `plan_verify`, `review_*`, setup, reload, logging, template, and CI tools without selecting an inline role. Installed package resources and a host's actually callable tools are different facts; if the host withholds `Agent`, `get_subagent_result`, or `plan_verify`, report that exact missing capability. Diffpi does not implement an external Cursor SDK bridge.
 
+If an update leaves copied global agent profiles stale, run `/skill:diffpi-doctor`. It checks the installed package's agents, then uses `diffpi_doctor` to back up and update only changed `diffpi-*.md` profiles. It does not rerun setup or install anything. Reload affected Pi sessions; an existing inline prompt may require a new conversation. Package skills themselves load from the installed package, not copied global files.
+
 ## Planning
 
-`/plan` forwards to the bundled plan skill. Plans are live `PLAN.md` files plus numbered briefs in `.diffpi/plan/<YYMMDD[-ticket]-short-slug>/`. The old managed plan engine is not shipped; historical files stay on disk.
+`/plan` forwards to the bundled `/skill:diffpi-plan`, not an unrelated global `plan` skill. Plans are live `PLAN.md` files plus numbered briefs in `.diffpi/plan/<YYMMDD[-ticket]-short-slug>/`. The old managed plan engine is not shipped; historical files stay on disk.
 
 ```text
 /plan init <short-slug> [--branch name]
@@ -32,7 +34,7 @@ Orchestrator alone updates plan status and checkboxes during execution. It seria
 
 ## Review
 
-`/review` forwards to the bundled review skill. Every target-bearing workflow calls `review_context` first, preserving target, backend, cwd, and `--local`. The package supports GitHub/GitLab forge reviews and local `tuicr` sessions; merge is GitHub-only.
+`/review` forwards to the bundled `/skill:diffpi-review`, not an unrelated global `review` skill. Every target-bearing workflow calls `review_context` first, preserving target, backend, cwd, and `--local`. The package supports GitHub/GitLab forge reviews and local `tuicr` sessions; merge is GitHub-only.
 
 ```text
 /review auto [target] [--local]

package/dist/commands/dispatch.d.ts

@@ -1,4 +1,4 @@
 import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
-/** Alias only: Pi expands the skill for the calling agent, including its help route. */
+/** Alias only: the namespaced package skill cannot be shadowed by a generic global skill. */
 export declare function forwardWorkflow(pi: ExtensionAPI, workflow: 'plan' | 'review', args: string): void;
 //# sourceMappingURL=dispatch.d.ts.map

package/dist/commands/dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/commands/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAKjG"}
+{"version":3,"file":"dispatch.d.ts","sourceRoot":"","sources":["../../src/commands/dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEpE,6FAA6F;AAC7F,wBAAgB,eAAe,CAAC,EAAE,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAKjG"}

package/dist/commands/plan.d.ts

@@ -1,4 +1,4 @@
 import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
-/** /plan is only a shortcut for Pi's native /skill:plan expansion. */
+/** /plan is only a shortcut for Pi's native /skill:diffpi-plan expansion. */
 export declare function registerPlanCommand(pi: ExtensionAPI): void;
 //# sourceMappingURL=plan.d.ts.map

package/dist/commands/plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/commands/plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAGpE,sEAAsE;AACtE,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAO1D"}
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/commands/plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAGpE,6EAA6E;AAC7E,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAO1D"}

package/dist/commands/review.d.ts

@@ -1,4 +1,4 @@
 import type { ExtensionAPI } from '@earendil-works/pi-coding-agent';
-/** /review is only a shortcut for Pi's native /skill:review expansion. */
+/** /review is only a shortcut for Pi's native /skill:diffpi-review expansion. */
 export declare function registerReviewCommand(pi: ExtensionAPI): void;
 //# sourceMappingURL=review.d.ts.map

package/dist/commands/review.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/commands/review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAGpE,0EAA0E;AAC1E,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAO5D"}
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/commands/review.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAGpE,iFAAiF;AACjF,wBAAgB,qBAAqB,CAAC,EAAE,EAAE,YAAY,GAAG,IAAI,CAO5D"}

package/dist/doctor.d.ts

@@ -0,0 +1,9 @@
+import { type SetupAction, type SetupOptions } from './setup';
+export interface AgentDoctorResult {
+    actions: SetupAction[];
+    backups: string[];
+    agentDir: string;
+}
+/** Inspect or sync only installed Diffpi agent files, never full setup. */
+export declare function doctorAgents(options?: SetupOptions): Promise<AgentDoctorResult>;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../src/doctor.ts"],"names":[],"mappings":"AAKA,OAAO,EAAkB,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,SAAS,CAAC;AAU9E,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,2EAA2E;AAC3E,wBAAsB,YAAY,CAAC,OAAO,GAAE,YAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAsDzF"}