pi-daddy 0.26.1 → 0.27.1

package/CHANGELOG.md

@@ -12,6 +12,41 @@ the record of how the package got here and are worth keeping; they are not worth
 > the record of how the package arrived at what it does, and because the reasoning behind each one is
 > usually the clearest statement of why the current behaviour is what it is.
 
+## 0.27.1 — reference enabled installed runtime skills (ADR-0074)
+
+- Setup uses configured Pi runtime skills directly instead of copying them into `.pi/skills`, avoiding
+  duplicate warnings and stale local copies after package upgrades.
+- Definitions and the capability catalog honor Pi package/resource filters, scope precedence and
+  `PI_CODING_AGENT_DIR` without installs, extension execution or model calls.
+- Existing local overrides and grant files stay intact; unregistered npm packages retain legacy scaffolding.
+  Review old local copies before removing them to follow installed package updates.
+
+## 0.27.0 — ordinary work and learning product (release candidate; ADR-0073)
+
+Prepared from `b9cbef9087b3596a0d930c0ec9b843f34c0f27e8`: Sol-approved producer runtime plus the
+passing supported-command assertion fix. Feature PR #52 merged with green CI at
+`b974963a7d0ba5a74fdafe331356c348a1fba565`. Release PR CI/merge, installed qualification and publication
+remain pending. Matching skill-harness release planned: **0.16.0**. Release preparation changes metadata
+and test synchronization only; dependencies and runtime are unchanged.
+
+- Outcome-first Herdr daily panel, observed active model/effort, collapsed history and exact-frame numbered
+  actions. The former diagnostic renderer remains `renderDailyDetails`; frozen fixtures stay unchanged.
+- `/grants work` authoring/selecting of 1–8-task DAGs, scope/alternative/priority changes and explicit
+  model/effort. Bounded runs reuse original delegation/approval/executor/cancellation owners, retain full
+  bounded results, wait on pause and refuse stale pinned scope at admission. No automatic retries.
+- Separate private instruction/presentation retention, including single-work outcome labels; governance
+  ledgers still do not store instruction text. CLI `work list`/`work show` and public setup/run exports.
+- `/grants learning` uses the loaded harness's scoped workspace/wizard. Original trust attention is reused;
+  quality/reveal, adopt/reject/defer, independent eligibility, activation and later observation stay separate.
+- Additive model/effort-only next-order registry, original receipt linkage, rollback and readback recovery;
+  active/old runs stay pinned. Existing fixed-policy, ledger and retention contracts remain unchanged.
+- PR52 review repairs: refuse host stop while pause/pending/unknown control remains; preserve holds on
+  denied or unacknowledged resumes. Show the retained restore digest and every task model/effort before
+  rollback consent; cover exact activation/readback receipt identities and friendly-label CI regressions.
+- Packaged concise guide/register for pi-daddy 0.27.0 with skill-harness 0.16.0. Release PR CI/merge,
+  installed two-extension linkage qualification and publication remain separate coordinator gates; no
+  actual calibration, human acceptance or production improvement is claimed.
+
 ## 0.26.1 — measured-order fractional usage repair (2026-09-14)
 
 - Preserve fractional measured-order usage when serializing results, so bounded recovery and dependent review retain exact reported usage.

package/PRODUCT-GUIDE.md

@@ -0,0 +1,127 @@
+# Work and learning in Pi
+
+This guide targets **pi-daddy 0.27.1** with **skill-harness 0.16.0**. The 0.27.1 patch references enabled
+installed runtime skills directly and prevents setup from creating duplicate project copies.
+Release qualification and publication are recorded in the release PR; version metadata alone is not proof.
+The [current requirement register](./REQUIREMENTS.md) separates implementation from release evidence.
+From an installed shell command, `pi-daddy guide` prints this guide; `pi-daddy current` prints the register.
+
+## Start once
+
+After the patch is published, install it with Pi's normal package manager:
+`pi install npm:pi-daddy@0.27.1` and `pi install npm:skill-harness@0.16.0`.
+Do not treat these planned version commands as evidence the packages are already available.
+Start a **fresh Pi session** after upgrading the harness: its existing immutable bridge survives `/reload`.
+In the project, run `/grants init`, review capability consent, then `/grants` to see usable definitions.
+Enabled installed runtime skills are used in place, using Pi's package filters and config directory.
+No `.pi/skills/` copies are created for them. Existing local overrides and `.pi/grants.env` are preserved;
+review old copies before removing one to follow installed package updates. Unregistered npm packages retain
+legacy copy scaffolding. This works for any runtime skill package; there is no Principal-specific policy.
+A definition without `allowed-tools` remains unavailable until its author declares a ceiling.
+Select an available authenticated Pi model; this product never copies credentials or chooses a fallback.
+
+## Declare, run, inspect
+
+1. **`/grants work new`** asks for an overall outcome, then one to eight tasks. Each task has its own
+   outcome/instructions, agent definition (or **No tools**), explicit model and requested effort.
+2. Choose which earlier tasks each task depends on, then the maximum parallel agents (one to eight).
+   No dependencies means independent work; a chain expresses sequential work. Review and save.
+   **Saving does not run anything.** Text is retained in owner-only local files, not governance ledgers.
+3. In Herdr, **`/grants host`**, then **`/grants dashboard`**, connects the existing owner to a right panel
+   without moving focus. The plugin/install handshake and actual Pi pane ownership still apply.
+4. **`/grants work run`** shows the exact setup and bounds, then asks before launching. Every child goes
+   through the original delegation/grant/approval/executor path. Failed predecessors block only their
+   dependent branch. Complete predecessor output is handed over only within the 32 KiB bound; it is
+   never silently truncated. Child deadlines/output limits and the subtree budget remain enforced.
+5. **`/grants work results`** opens retained output. Editor changes are discarded; control characters are
+   escaped. A digest mismatch is an error, not permission to substitute another artifact.
+
+The run is finite, with no automatic retry or restart recovery. Esc requests cancellation and waits for
+original children to settle. Ordinary model work has **no universal dollar/token cap**; provider usage is
+not invented from output size. Effort is an observed/requested launch setting, not measured internal thought.
+
+## Read and steer the panel
+
+The outcome comes first, followed by **Running**, **Waiting**, **Needs you** or **Finished**. Active rows
+show observed model/effort; unknown observations stay unknown. Completed attempts are collapsed.
+**Finished is not accepted.** `d` opens diagnostics/history. There are no guessed percentages or ETAs.
+
+Enter a displayed **number** for its action. A repaint never gives an old number a new meaning; stale
+choices refuse. Feedback distinguishes acknowledgement, applied control, pending and unknown results.
+Pause stops new admission, not active children. Pending bounded tasks wait for resume. Stop-agent targets
+one original active handle and does not cancel siblings. A pause racing an approval can still refuse that
+attempt at the original boundary; it is not automatically retried. Reads/redraws never request work.
+
+**`/grants work`** also selects saved setups or the task for ordinary `delegate`, changes priorities,
+and records scope revisions or alternatives. Live changes use the existing owner's validation/CAS.
+Topology changes require new work; active runs are never rebound. A selected-scope change prevents the
+old bounded order's remaining children from starting. **`/grants host stop` refuses while paused: choose
+Resume new work in the original dashboard first.** Busy/pending controls must finish or be explicitly
+reconciled first. Unknown acknowledgements keep the host for readback; stop never silently releases them.
+Ending the whole Pi session disconnects the host, but does not reconcile unknown effects. A successful
+stop preserves evidence, not a recoverable controller, and cancels no child. **Disconnected** means live
+actions are unavailable, not that children stopped.
+
+For shell inspection only: `pi-daddy work list` and `pi-daddy work show` (`--dir` is optional).
+The existing `pi-daddy work add --id … --outcome …` single-obligation entry point remains supported.
+
+## Learn deliberately; earn interruptions separately
+
+1. **`/grants learning`** creates or explicitly connects a local learning workspace for this exact work
+   snapshot, archive, population and author. Scope changes require a new explicit connection, not reuse.
+2. Start the daily host, then choose **Retain current work for learning**. This captures actual P01
+   observations and binds the real resulting case batch. An empty batch remains empty.
+3. Open the guided learning review. Review retained cases; connect qualified retained comparisons;
+   inspect **all** comparison artifacts. Record an explicit durable quality choice **before** revealing
+   model/cost. Artifact contents themselves may reveal identity; prior excerpt feedback remains prior
+   feedback, never a full-artifact or fresh-blind judgment.
+4. Record **adopt / reject / defer** separately. Quality preference is neither adoption authority nor
+   activation. Missing evidence, unresolved cases and unavailable artifacts have explicit defer reasons.
+5. The harness's **Trust / independent labels** forms freeze a scoped population/policy and separately
+   obtain independent case and unflagged-sample labels. A nomination, success exit or human click is not
+   calibration. Unconfigured/insufficient/stale trust remains silent or deferred; attention is not reset.
+
+Deliberate review does **not** reserve earned automatic exposure. For an automatic closing request use
+`/grants host closing`, pause new work and settle/cancel active children. The panel offers retained case
+cards only under the original presence/quiescence/trust/attention rules. A visible acknowledgement is
+separate from preparation. If trust changes, explicitly resume new work, then stop/start the host to bind
+the original configured trust store; its retained attention is reused, never refilled.
+
+## Adopt settings for later orders
+
+Under **`/grants learning` → Adoption / rollback for next orders**, create the scoped registry and prepare a named
+model/effort profile. This records candidate bytes, **not evidence that they are better**. A qualified
+comparison must bind that exact candidate digest to real outputs and its actual original hypothesis/case.
+Use the guided review to link those retained origins; missing qualifying data remains a scoped defer.
+
+**Activate adopted comparison** configures that binding, separately asks for independent current
+eligibility and exact activation consent, then applies the original registry and links its real receipt.
+Only model/effort for the same task IDs and definition names can vary. Task instructions, topology,
+capabilities and assessment meaning cannot expand through this profile. Normal definition-digest/approval
+checks still run; this does not freeze definition files or the project tree. Fixed-policy contracts are unchanged.
+Subsequent bounded `/grants work` runs ask for fresh eligibility and pin the profile; active/old runs never
+migrate. Ordinary direct `delegate` calls keep their explicit caller configuration. After selecting different work,
+this menu explicitly reconnects that scope's saved settings or creates a fresh baseline; old stores remain.
+
+**Roll back active adoption** shows the immutable restore digest and each task's exact retained model/effort
+before separate consent for next orders. With nested adoptions, this is the previous profile, not necessarily
+baseline. Missing or inconsistent registry lineage refuses instead of substituting a named profile.
+If effect and learning linkage separate on failure, **Recover learning link** reconnects the original
+registry observation without replaying activation/rollback.
+
+After actual adopted work, **Link observed result from latest adopted order** shows real retained bytes,
+asks for an independent outcome/note, previews its scoped classification and confirms the link.
+**Unknown** is valid. Acceptance stays absent; runtime completion is not confirmed quality, calibrated
+improvement or automatic rollback. More extensive independent observation entry is available in the harness.
+
+## Boundaries and local state
+
+`.pi/work-setups/` holds private setup history; `.pi/work-current.json` selects work;
+`.pi/learning-workspace.json` and `.pi/work-policy-registry.json` are navigation/binding records, not authority.
+`.pi/work-registry-bindings/` preserves settings-store bindings per work scope.
+Original bounded run/control stores live under the operator's local state directory; `.pi/work-last-run.json`
+locates the most recent result. Do not hand-edit these records. Invalid/aliased/mismatched bytes refuse.
+
+This governs **Pi's tool surface**, not a hostile process or same-UID actor. `bash` can escape governance;
+workspace routing is not OS containment. Human authority, genuine labels, calibration and later outcomes
+must actually exist. The UI cannot manufacture them, and this guide does not claim they have been obtained.

package/README.md

@@ -21,6 +21,27 @@ for this project. See *What this governs, and what it does not*.
 > **Known gaps are stated rather than implied** — see *Status* at the end of this file. The largest is
 > deliberate: a child granted `bash` escapes governance entirely, by decision.
 
+## Everyday work and learning — 0.27.0 release candidate
+
+Paired with planned **skill-harness 0.16.0**. Producer runtime is Sol-approved; feature PR #52 merged
+with green CI at `b974963a7d0ba5a74fdafe331356c348a1fba565`. Release PR CI/merge, installed qualification
+and publication remain pending. Release preparation changes metadata and test synchronization only,
+not runtime or dependencies.
+
+Start with the short installed **[PRODUCT-GUIDE.md](./PRODUCT-GUIDE.md)** and
+**[current requirement register](./REQUIREMENTS.md)**. `/grants work` now authors/selects bounded multi-task
+and dependent work with explicit agent/model/effort choices; `/grants host` and `/grants dashboard` show
+outcomes, real active work and numbered controls; `/grants learning` opens retained cases, comparisons,
+trust, quality/adoption choices and next-order settings through the loaded harness. These are source
+implementation paths, not evidence that calibration, human acceptance or publication has occurred.
+The historical worked-example transcripts below remain evidence for their stated versions.
+
+
+Configured runtime skills are used directly at their installed paths; setup creates no duplicate
+`.pi/skills/` copies. Pi package/resource filters and `PI_CODING_AGENT_DIR` apply. Existing local overrides
+and `.pi/grants.env` stay intact. Only legacy npm packages never registered with Pi are copied by init;
+`--force` applies only to those copies. Review old local copies before removing them to use package updates.
+
 ## What this governs, and what it does not
 
 **It governs the tool surface: which tools pi exposes to a model.** That part is structural, not advisory —
@@ -242,7 +263,7 @@ explicit **Relink and open** repair. **Not now** or dismissal leaves both the ex
 unchanged; protocol mismatches are not replaced by guesswork.
 A connected host can publish exact pre-authorized actions as short commands such as `pause-new-dispatch` or `defer-weekly`; the dashboard lists their human labels and accepts the key followed by Enter. The host resolves the key to its current CAS-bound request, so a person does not type JSON or tokens. Unknown/stale keys refuse before effects; raw JSON remains compatibility-only.
 
-With pi-daddy 0.25.0 and skill-harness 0.15.0 loaded, declare work, reload, then run `/grants host <fresh-id>`. Library hosts can use the explicit `pi-daddy/daily-dashboard-host` export. This creates one process-owned daily host, captures the current work/facts sources, publishes its private socket to `/grants dashboard`, and lists `pause-new-dispatch` or `resume-dispatch` plus `refresh-current-work`. Compatible recorded P01 snapshots and selected obligations also become labelled scope-successor, alternative, and put-first actions; choosing one still passes exact intent authority and host/selection/tip CAS, then atomically rebinds both persisted and current-session declared work before new ordinary dispatch is released. Refresh is a deliberate action that atomically mirrors the current declared ledger and advances the existing source checkpoint; periodic dashboard redraw remains read-only. Pausing blocks only new governed ordinary children; a child already running keeps its original caller/result. An active retained child also gets an exact `cancel-exec-…` action (up to the ordinary eight-child width); choosing it requests abort through the original handle without cancelling siblings or implying acceptance/rejection. `/grants host closing` declares two minutes of explicit closing presence; only a paused, reservation-free, ordinary-quiescent host offers case-card preparation, and absent trust qualification defers without spending the five-card budget. `/grants host stop` closes the host and never cancels a child. Restart uses a fresh id; no PID, user-entered JSON/CAS envelope or prior controller is recovered.
+For the planned pi-daddy 0.27.0 / skill-harness 0.16.0 pair, start a fresh Pi session after installing the qualified releases (the immutable harness bridge survives `/reload`), declare work, then run `/grants host <fresh-id>`. Library hosts can use the explicit `pi-daddy/daily-dashboard-host` export. This creates one process-owned daily host, captures the current work/facts sources, publishes its private socket to `/grants dashboard`, and lists `pause-new-dispatch` or `resume-dispatch` plus `refresh-current-work`. Compatible recorded P01 snapshots and selected obligations also become labelled scope-successor, alternative, and put-first actions; choosing one still passes exact intent authority and host/selection/tip CAS, then atomically rebinds both persisted and current-session declared work before new ordinary dispatch is released. Refresh is a deliberate action that atomically mirrors the current declared ledger and advances the existing source checkpoint; periodic dashboard redraw remains read-only. Pausing blocks only new governed ordinary children; a child already running keeps its original caller/result. An active retained child also gets an exact `cancel-exec-…` action (up to the ordinary eight-child width); choosing it requests abort through the original handle without cancelling siblings or implying acceptance/rejection. `/grants host closing` declares two minutes of explicit closing presence; only a paused, reservation-free, ordinary-quiescent host offers case-card preparation, and absent trust qualification defers without spending the five-card budget. `/grants host stop` refuses while paused, busy, pending or acknowledgement-unknown: resume new work in the original dashboard first, and reconcile pending controls explicitly. Refusal preserves the original host/socket; unknown effects are never silently released. A successful stop closes the host and never cancels a child. Restart uses a fresh id; no PID, user-entered JSON/CAS envelope or prior controller is recovered.
 
 The separate `pi-daddy/measured-order` export composes no-tool measured Sol/Terra sessions into a bounded dependent order. Every retry and deterministic output contract is predeclared; bounded JSON projection contracts admit free-form prose without pre-knowing the whole artifact hash, and dependent prompts consume the actual retained predecessor output with its observed seal. A reopened controller treats another owner's unfinished claim as unknown and cannot replay it; an independently authorized exact acknowledgement can consume that schedule position, but never refunds or settles the original resource reservation. See ADR-0072.
 
@@ -785,7 +806,7 @@ Subpaths are exported individually (`pi-daddy/resolve`, `/ledger`, `/spawn`, `/d
 ```bash
 pi install npm:pi-daddy     # as a pi extension
 npm i pi-daddy              # as a library (the resolver, ledger and spawn planner are pure)
-npx pi-daddy init           # as a command: scaffold .pi/skills/ and .pi/grants.env from installed
+npx pi-daddy init           # as a command: prepare .pi/grants.env using enabled installed
                             # skill packages — see the worked example above
 npx pi-daddy work add --id daily-1 --outcome "Ship the declared slice"
                             # select one digest-only obligation; /reload then /grants dashboard

package/REQUIREMENTS.md

@@ -0,0 +1,41 @@
+# Current producer requirement register
+
+**Release candidate:** pi-daddy **0.27.0**, paired with planned skill-harness **0.16.0**, implementing the
+2026-09-14 proposal. This is current product scope, not an npm/release receipt or a replacement for dated
+evidence. Read [PRODUCT-GUIDE.md](./PRODUCT-GUIDE.md).
+
+| Requirement | Supported entry point / implementation | Boundary / remaining evidence |
+| --- | --- | --- |
+| Outcome-first side panel; Running/Waiting/Needs you/Finished/Disconnected | `/grants host`, `/grants dashboard`; `daily-panel`, existing host/socket | Actual owner/observations only. Unknown model/effort stays unknown. Full diagnostics/history under Details. |
+| Real available steering and acknowledgement | Numbered exact-frame choices; pause/resume, original-child cancellation, explicit capture and closing | Repaint cannot remap a number. Stop refuses outstanding pause/pending/unknown control; resume first. No action on reads; no recovered controller; pending/unknown is not applied. |
+| Normal multi-task authoring/selection | `/grants work new`, `/grants work`; `work-setup` P01 builders and private retained text | 1–8 tasks, explicit dependencies/model/effort/concurrency. No ledger JSON authoring. Legacy single-work and ordinary delegate/all/chain remain. |
+| Scope/alternative/priority changes | Work menu → existing daily intent owner/CAS; selected-task binding for direct delegate | Topology changes need new work. Instructions/configuration may be deliberately revised; permission semantics do not widen. Active orders never rebind. |
+| Bounded parallel/dependent work and results | `/grants work run`, `/grants work results`; `work-run`, original `runOneDelegation` | Subtree budget, 1–8 concurrency, original child timeout/output/approval/grant guards. Failed dependencies block their branch. Pause waits; no retry/relaunch, no ordinary dollar/token cap. |
+| Public retained learning and scope-bound trust | `/grants learning` → existing harness workspace/wizard via original bridge | Raw selected snapshot digest + archive/population/author pinned. Deliberate review is not earned exposure. Actual labels/calibration may be absent. |
+| Full quality choice before model/cost reveal | Harness full-artifact editor, durable quality choice, separate reveal | Prior excerpts/previously exposed content remain limited evidence. Human full review/preference has not been fabricated by implementation. |
+| Distinct adopt/reject/defer; next-order settings | Learning → Adoption / rollback; `ordinary-work-policy-v1` and original adoption predicates/control journals | Exact model/effort candidate only; unchanged definition names/task IDs/scope/assessment; not a definition-file/tree pin. Current confirmed cases/origin/choice/adopt intent plus independent eligibility/activation required. No false fixed-policy profile. |
+| Rollback, pinning and later observations | Next-order registry → actual receipt linkage/recovery; latest adopted-order output observation | Rollback consent shows the retained restore digest and every task model/effort. Activation/recovery preserve exact original request/adoption proof. Old runs keep original pins. Real confirmed outcomes require independent consent; unknown is valid. No inferred acceptance, calibration, automatic rollback or efficacy. |
+| Installed guide/public contracts | `pi-daddy guide` / `current`, package root/subpath exports and Pi extension | Existing frozen governance/retention/fixed-policy contracts and historical fixtures are preserved. No new runtime dependency or Principal-specific policy. |
+
+## Evidence status and release gates
+
+Implementation is present in source. Focused regression files accompany setup, scheduler, panel/action
+binding, original late-admission guard, learning composition and additive registry. Legacy diagnostic view
+fixtures remain checked through `renderDailyDetails`; ordinary `renderDailyView` is the concise panel.
+
+**Producer runtime is Sol-approved; feature PR #52 merged with green CI at
+`b974963a7d0ba5a74fdafe331356c348a1fba565`. Release PR CI/merge, installed cross-package/Herdr
+qualification and publication remain pending coordinator gates.** A narrow type/build/unit or
+bridge check is not evidence of live model quality, calibrated trust, actual adoption/rollback or later
+production improvement. Exact candidate/check receipts belong with the delivery evidence, not invented
+inside this portable register.
+
+No model experiments, nested review agents, mutation programme, global install, release or historical
+evidence rewrite is required by this implementation step. Existing CI/ordinary behavioral checks remain.
+
+## Data that must be real
+
+A comparison without qualified retained outputs/original linked evidence is deferred. A trust policy
+without sufficient independent scoped labels stays silent/deferred. A setting without independent current
+eligibility/approval does not activate. A later outcome without an actual adopted run and retained bytes
+stays unavailable/unknown. These are explicit operational states, not invitations to supply fake data.

package/dist/catalog.d.ts

@@ -38,13 +38,7 @@ export interface Catalog {
 export declare function classifyToolNames(observed: string[]): CatalogEntry[];
 /** Skill roots pi discovers, project first. */
 export declare function skillDirs(cwd: string): string[];
-/**
- * Discover skills: a directory containing `SKILL.md` is one skill named after the directory; a top-level
- * `.md` file is a skill named after the file. Mirrors pi's documented convention.
- *
- * Directories are not descended into beyond one level, matching pi's rule that a directory containing
- * `SKILL.md` is a single skill rather than a tree to explore.
- */
+/** Enumerate the same enabled Pi resource paths as definitions, preserving resolver precedence. */
 export declare function loadSkills(cwd: string): Promise<CatalogEntry[]>;
 /**
  * Spawnable definitions, as `agent:<name>` capabilities.

package/dist/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEzE,OAAO,EAAsC,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAyB,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAGnF,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC;AAE3F,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,cAAc,CAAC;IACrB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,0CAA0C;IAC1C,GAAG,EAAE,UAAU,EAAE,CAAC;IAClB,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,EAAE,CAAC;IAC3C,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC;CACtC;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CAMpE;AAED,+CAA+C;AAC/C,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAE/C;AAED;;;;;;GAMG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CA+BrE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,YAAY,EAAE,CAM3F;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,qBAAqB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAIjG;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAY5D;AAED,qGAAqG;AACrG,wBAAsB,YAAY,CAAC,KAAK,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC/B,4GAA4G;IAC5G,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,OAAO,CAAC,CAgCnB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,EAAE,CAgC3F;AA6DD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAuB1F;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO9E"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH,OAAO,EAAmB,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEzE,OAAO,EAAsC,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AACnF,OAAO,EAAyB,KAAK,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAGnF,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,WAAW,GAAG,WAAW,CAAC;AAE3F,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,IAAI,EAAE,cAAc,CAAC;IACrB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,OAAO;IACtB,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,0CAA0C;IAC1C,GAAG,EAAE,UAAU,EAAE,CAAC;IAClB,MAAM,CAAC,IAAI,EAAE,cAAc,GAAG,UAAU,EAAE,CAAC;IAC3C,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC;CACtC;AAED,gFAAgF;AAChF,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,YAAY,EAAE,CAMpE;AAED,+CAA+C;AAC/C,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAE/C;AAED,mGAAmG;AACnG,wBAAsB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAOrE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,YAAY,EAAE,CAM3F;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,qBAAqB,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,YAAY,EAAE,CAIjG;AAED,mFAAmF;AACnF,wBAAgB,WAAW,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,OAAO,CAY5D;AAED,qGAAqG;AACrG,wBAAsB,YAAY,CAAC,KAAK,EAAE;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IAC/B,4GAA4G;IAC5G,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,OAAO,CAAC,CAgCnB;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,EAAE,CAgC3F;AA6DD;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAuB1F;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAO9E"}

package/dist/catalog.js

@@ -17,8 +17,8 @@
  * also how pi's `--tools` matches — and marked `kind: "extension"` for display. `ext:` ids remain
  * supported for hand-authored grants; `deriveOwnGrant` already matches them by bare name.
  */
-import { readdir, stat } from "node:fs/promises";
-import { homedir } from "node:os";
+import { getAgentDir } from "@earendil-works/pi-coding-agent";
+import { resolveSkillResources, skillResourceName } from "./skill-resources.js";
 import { join } from "node:path";
 import { loadDefinitions } from "./definitions.js";
 import { PI_BUILTIN_TOOLS, WILDCARD } from "./pi-tools.js";
@@ -35,47 +35,15 @@ export function classifyToolNames(observed) {
 }
 /** Skill roots pi discovers, project first. */
 export function skillDirs(cwd) {
-    return [join(cwd, ".pi", "skills"), join(homedir(), ".pi", "agent", "skills")];
+    return [join(cwd, ".pi", "skills"), join(getAgentDir(), "skills")];
 }
-/**
- * Discover skills: a directory containing `SKILL.md` is one skill named after the directory; a top-level
- * `.md` file is a skill named after the file. Mirrors pi's documented convention.
- *
- * Directories are not descended into beyond one level, matching pi's rule that a directory containing
- * `SKILL.md` is a single skill rather than a tree to explore.
- */
+/** Enumerate the same enabled Pi resource paths as definitions, preserving resolver precedence. */
 export async function loadSkills(cwd) {
     const found = new Map();
-    for (const dir of skillDirs(cwd)) {
-        let names;
-        try {
-            names = await readdir(dir);
-        }
-        catch {
-            continue; // absent skill root is normal
-        }
-        for (const name of names.sort()) {
-            const path = join(dir, name);
-            try {
-                const info = await stat(path);
-                if (info.isDirectory()) {
-                    const inner = await readdir(path).catch(() => []);
-                    if (inner.includes("SKILL.md") && !found.has(name)) {
-                        found.set(name, { capability: `skill:${name}`, kind: "skill", source: path });
-                    }
-                }
-                else if (name.endsWith(".md")) {
-                    const skill = name.replace(/\.md$/, "");
-                    if (!found.has(skill)) {
-                        found.set(skill, { capability: `skill:${skill}`, kind: "skill", source: path });
-                    }
-                }
-            }
-            catch {
-                // An unreadable entry is simply not catalogued; it therefore cannot be granted, which is the
-                // fail-closed direction.
-            }
-        }
+    for (const { path } of (await resolveSkillResources(cwd)).skills) {
+        const name = skillResourceName(path);
+        if (!found.has(name))
+            found.set(name, { capability: `skill:${name}`, kind: "skill", source: path });
     }
     return [...found.values()];
 }

package/dist/catalog.js.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAChF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAwB,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAmB,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,qBAAqB,EAA8B,MAAM,gBAAgB,CAAC;AACnF,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAmBtD,gFAAgF;AAChF,MAAM,UAAU,iBAAiB,CAAC,QAAkB;IAClD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAS,gBAAgB,CAAC,CAAC;IACnD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAClD,UAAU,EAAE,QAAQ,IAAI,EAAE;QAC1B,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAE,SAAmB,CAAC,CAAC,CAAE,WAAqB;KACzE,CAAC,CAAC,CAAC;AACN,CAAC;AAED,+CAA+C;AAC/C,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,EAAE,QAAQ,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAC,CAAC;AACrE,CAAC;AAED,mGAAmG;AACnG,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW;IAC1C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwB,CAAC;IAC9C,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,qBAAqB,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;QACjE,MAAM,IAAI,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,SAAS,IAAI,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACtG,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,WAAyC;IACzE,OAAO,CAAC,GAAG,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC3C,UAAU,EAAE,SAAS,CAAC,CAAC,IAAI,EAAE;QAC7B,IAAI,EAAE,WAAoB;QAC1B,MAAM,EAAE,CAAC,CAAC,MAAM;KACjB,CAAC,CAAC,CAAC;AACN,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAA+B,EAAE,MAAe;IAC/E,OAAO,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC;SACpC,IAAI,EAAE;SACN,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,aAAa,EAAE,EAAgB,EAAE,IAAI,EAAE,WAAoB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAC/H,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,WAAW,CAAC,OAAuB;IACjD,MAAM,OAAO,GAAG,IAAI,GAAG,EAA4B,CAAC;IACpD,KAAK,MAAM,KAAK,IAAI,OAAO;QAAE,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC;YAAE,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;IACtG,MAAM,IAAI,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAC5F,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAC3B,OAAO;QACL,OAAO,EAAE,IAAI;QACb,GAAG,EAAE,GAAG;QACR,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC;QAC9E,GAAG,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC;KAC3C,CAAC;AACJ,CAAC;AAED,qGAAqG;AACrG,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,KAKlC;IACC,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QAC1D,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC;QACrB,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC;QAC1B,kGAAkG;QAClG,uGAAuG;QACvG,yGAAyG;QACzG,qEAAqE;QACrE,KAAK,CAAC,YAAY;YAChB,CAAC,CAAC,qBAAqB,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,IAAI,CAC5C,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,EAC9C,GAAG,EAAE,CAAC,EAAoB,CAC3B;YACH,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,EAAoB,CAAC;KAC1C,CAAC,CAAC;IACH,OAAO,WAAW,CAAC;QACjB,kGAAkG;QAClG,mGAAmG;QACnG,mGAAmG;QACnG,oGAAoG;QACpG,wCAAwC;QACxC,EAAE;QACF,mGAAmG;QACnG,oGAAoG;QACpG,oGAAoG;QACpG,uFAAuF;QACvF,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,QAAQ,IAAI,EAAW,EAAE,IAAI,EAAE,SAAkB,EAAE,CAAC,CAAC;QACtG,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,MAAM;QACT,GAAG,iBAAiB,CAAC,WAAW,CAAC;QACjC,GAAG,UAAU;KACd,CAAC,CAAC;AACL,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAuB,EAAE,OAAgB;IAC3E,qGAAqG;IACrG,wGAAwG;IACxG,yGAAyG;IACzG,iGAAiG;IACjG,qGAAqG;IACrG,kFAAkF;IAClF,EAAE;IACF,uGAAuG;IACvG,yGAAyG;IACzG,0GAA0G;IAC1G,oGAAoG;IACpG,wGAAwG;IACxG,uGAAuG;IACvG,EAAE;IACF,qGAAqG;IACrG,2GAA2G;IAC3G,wGAAwG;IACxG,yGAAyG;IACzG,yGAAyG;IACzG,2GAA2G;IAC3G,sGAAsG;IACtG,0GAA0G;IAC1G,uGAAuG;IACvG,iBAAiB;IACjB,0GAA0G;IAC1G,2GAA2G;IAC3G,oEAAoE;IACpE,MAAM,MAAM,GAAG,CAAC,CAAa,EAAE,EAAE,CAC/B,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,cAAc,IAAI,CAAC,KAAK,kBAAkB;WAC/D,CAAC,CAAC,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrF,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACvE,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,kBAAkB,GAAqC;IAC3D,WAAW,EAAE,WAAW;IACxB,kBAAkB,EAAE,WAAW;IAC/B,eAAe,EAAE,WAAW;IAC5B,eAAe,EAAE,WAAW;IAC5B,gBAAgB,EAAE,YAAY;IAC9B,yBAAyB,EAAE,WAAW;IACtC,gBAAgB,EAAE,WAAW;CAC9B,CAAC;AAEF;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,CAAS,EAAE,CAAS;IACxC,iEAAiE;IACjE,MAAM,IAAI,GAAe;QACvB,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;QACjD,IAAI,KAAK,CAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACvC,IAAI,KAAK,CAAS,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;KACxC,CAAC;IACF,IAAI,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACnB,IAAI,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IAElB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACX,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3C,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YAClE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACrE,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YACtC,CAAC;YACD,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACb,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC;QACtB,OAAO,GAAG,IAAI,CAAC;QACf,IAAI,GAAG,GAAG,CAAC;QACX,GAAG,GAAG,KAAK,CAAC;IACd,CAAC;IACD,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAmB,EAAE,OAAgB;IACrE,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAC1D,IAAI,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAEpD,oGAAoG;IACpG,6FAA6F;IAC7F,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IACtD,IAAI,CAAC,EAAE;QAAE,OAAO,IAAI,CAAC;IACrB,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;IACtC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC;IACvD,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAE3B,IAAI,IAAI,GAAsB,IAAI,CAAC;IACnC,IAAI,YAAY,GAAG,KAAK,GAAG,CAAC,CAAC;IAC7B,KAAK,MAAM,SAAS,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACpC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,EAAE,CAAC;YAAE,SAAS;QACxC,MAAM,CAAC,GAAG,YAAY,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,GAAG,YAAY,EAAE,CAAC;YACrB,YAAY,GAAG,CAAC,CAAC;YACjB,IAAI,GAAG,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,YAAY,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;AAC7C,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,KAAK,GAA2B,EAAE,CAAC;IACzC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QACpC,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,SAAS;QACtD,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC;IAChE,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/cli.d.ts

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * `pi-daddy` — the command line, which today has exactly one subcommand.
+ * `pi-daddy` — scaffolding, read-only work inspection and the installed product guide.
  *
  * Thin on purpose: argv in, `discoverSkillPackages` + `planInit` + `applyInit`, report out. Every decision
  * lives in `./init.ts`, `./grant-env.ts` and `./skill-packages.ts` as functions that touch no argv and print
@@ -13,7 +13,7 @@
  * was accepted in silence — the exact failure the check's own comment says it prevents.
  */
 export interface ParsedArgs {
-    command: "init" | "work-add" | "help" | "version";
+    command: "init" | "work-add" | "work-list" | "work-show" | "guide" | "current" | "help" | "version";
     dir?: string;
     force: boolean;
     id?: string;

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AA6BH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;IAClD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAqDpD;AAwJD,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAyC1D"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG;AAoCH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;IACpG,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CAwDpD;AAyJD,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAkD1D"}

package/dist/cli.js

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
 /**
- * `pi-daddy` — the command line, which today has exactly one subcommand.
+ * `pi-daddy` — scaffolding, read-only work inspection and the installed product guide.
  *
  * Thin on purpose: argv in, `discoverSkillPackages` + `planInit` + `applyInit`, report out. Every decision
  * lives in `./init.ts`, `./grant-env.ts` and `./skill-packages.ts` as functions that touch no argv and print
@@ -20,22 +20,29 @@ import { UnsafeGrantError } from "./grant-env.js";
 import { applyInit, countDeclaring, planInit } from "./init.js";
 import { registeredWorkspaceIds } from "./workspace.js";
 import { discoverSkillPackages, skillPackageRoots } from "./skill-packages.js";
-import { declareWork } from "./work-command.js";
+import { declareWork, loadDeclaredWork } from "./work-command.js";
+import { listWorkSetups, workPresentation } from "./work-setup.js";
+import { panelText } from "./daily-panel.js";
 const USAGE = `pi-daddy — capability governance for pi sub-agents
 
 Usage:
-  pi-daddy init [--force] [--dir <path>]   scaffold .pi/skills/ and .pi/grants.env from installed
+  pi-daddy init [--force] [--dir <path>]   prepare .pi/grants.env from enabled installed
                                            packages that declare skills (package.json "pi": {"skills": …})
   pi-daddy work add --id <id> --outcome <text> [--dir <path>]
                                            declare one current obligation for ordinary delegation
+  pi-daddy work list | work show [--dir <path>]
+                                           inspect saved setups or selected outcome (no model calls)
+  In Pi: /grants work                     guided multi-task/model/effort/dependency setup and run
+         /grants learning                 retained review, trust, adoption and later outcomes
+  pi-daddy guide | current               installed product guide / current requirement register
   pi-daddy --help | --version
 
-init copies each declared SKILL.md into .pi/skills/ and writes a grant naming exactly what those files
-declare. It never chooses a ceiling: a skill declaring no \`allowed-tools\` is copied with a commented
-placeholder and stays unspawnable until you fill it in. Capabilities that can change your machine
+init references skills already enabled in Pi at their installed or local paths. Legacy unregistered npm
+skills are copied into .pi/skills/. It never chooses a ceiling: missing or unusable \`allowed-tools\`
+stays unspawnable. Capabilities that can change your machine
 (bash, write, edit) are written COMMENTED — uncomment them deliberately. Review the files, then commit.
 
-  --force   rewrite the SKILL.md copies that already exist. This DISCARDS any \`allowed-tools\` you added.
+  --force   rewrite legacy unregistered npm SKILL.md copies that already exist. This DISCARDS any \`allowed-tools\` you added.
             It never rewrites .pi/grants.env — delete that file if you want it regenerated.`;
 /**
  * Parse argv. Pure, exported, and tested — argv handling is where both of this file's defects lived.
@@ -53,12 +60,15 @@ export function parseArgs(argv) {
     if (args.includes("--version") || args.includes("-v"))
         return { command: "version", force: false, errors: [] };
     const [command, ...tail] = args;
+    if (command === "guide" || command === "current")
+        return { command, force: false, errors: tail.length ? [`${command} takes no arguments`] : [] };
     if (command !== "init" && command !== "work")
         return { command: "help", force: false, errors: [`unknown command "${command}"`] };
     const work = command === "work";
-    const rest = work && tail[0] === "add" ? tail.slice(1) : tail;
-    if (work && tail[0] !== "add")
-        return { command: "work-add", force: false, errors: ["work needs subcommand add"] };
+    const workVerb = tail[0];
+    const rest = work ? tail.slice(1) : tail;
+    if (work && !["add", "list", "show"].includes(workVerb))
+        return { command: "work-add", force: false, errors: ["work needs add, list or show; /grants work opens guided setup in Pi"] };
     const errors = [];
     let dir;
     let force = false;
@@ -68,7 +78,7 @@ export function parseArgs(argv) {
         if (arg === "--force" && !work) {
             force = true;
         }
-        else if (arg === "--id" && work) {
+        else if (arg === "--id" && work && workVerb === "add") {
             const value = rest[i + 1];
             if (value === undefined || value.startsWith("-"))
                 errors.push("--id needs a value");
@@ -77,7 +87,7 @@ export function parseArgs(argv) {
                 i += 1;
             }
         }
-        else if (arg === "--outcome" && work) {
+        else if (arg === "--outcome" && work && workVerb === "add") {
             const value = rest[i + 1];
             if (value === undefined || value.startsWith("-"))
                 errors.push("--outcome needs text");
@@ -106,6 +116,8 @@ export function parseArgs(argv) {
             errors.push(`unknown option ${arg}`);
         }
     }
+    if (work && workVerb !== "add")
+        return { command: workVerb === "list" ? "work-list" : "work-show", force: false, errors, ...(dir ? { dir } : {}) };
     if (work) {
         if (!id && !errors.some(error => error.startsWith("--id")))
             errors.push("--id needs a value");
@@ -123,7 +135,7 @@ async function init(cwd, force) {
         // only `<cwd>/node_modules` and said "npm install …" — so an operator who had just run
         // `pi install npm:principal-pi-skills`, which installs to the agent root, was told to install a package
         // they had already installed (R-75).
-        console.log(`pi-daddy init: no installed package declares skills (a package.json "pi": {"skills": [...]} ` +
+        console.log(`pi-daddy init: no enabled configured skills or unregistered npm package declares skills (a package.json "pi": {"skills": [...]} ` +
             `field). Nothing to scaffold.\n\nLooked in:\n` +
             skillPackageRoots(cwd).map((r) => `  ${r}\n`).join("") +
             `\n  pi install npm:principal-pi-skills    # seven skills, and registers it with pi\n` +
@@ -160,12 +172,14 @@ async function init(cwd, force) {
     // `--force` is destructive and says so at the moment it acts, not only in `--help` — which is the one
     // place the operator running the command is not reading.
     if (force) {
-        const existing = plan.skills.length;
+        const existing = plan.skills.filter(s => !s.referenced).length;
         console.log(`\n--force: rewriting up to ${existing} SKILL.md cop${existing === 1 ? "y" : "ies"} from the installed\n` +
             `packages. Any \`allowed-tools\` you wrote in them is DISCARDED. .pi/grants.env is never rewritten.`);
     }
     const outcome = await applyInit(plan, { force });
     const short = (path) => relative(cwd, path) || path;
+    for (const skill of plan.skills.filter(s => s.referenced))
+        console.log(`using ${short(skill.sourcePath)} (enabled in Pi; no copy)`);
     for (const path of outcome.written)
         console.log(`wrote ${short(path)}`);
     for (const path of outcome.kept)
@@ -258,6 +272,22 @@ export async function main(argv) {
         console.log(USAGE);
         return 0;
     }
+    if (parsed.command === "guide" || parsed.command === "current") {
+        console.log(await readFile(new URL(parsed.command === "guide" ? "../PRODUCT-GUIDE.md" : "../REQUIREMENTS.md", import.meta.url), "utf8"));
+        return 0;
+    }
+    if (parsed.command === "work-list" || parsed.command === "work-show") {
+        const cwd = resolvePath(parsed.dir ?? process.cwd());
+        if (parsed.command === "work-list") {
+            const setups = await listWorkSetups(cwd);
+            console.log(setups.map((s, i) => `${i + 1}. ${panelText(s.setup.outcome)} — ${s.setup.tasks.length} tasks; up to ${s.setup.maxParallel} parallel`).join("\n") || "No saved multi-task setups. In Pi: /grants work");
+        }
+        else {
+            const state = await loadDeclaredWork(resolvePath(cwd, ".pi/work-current.json")), view = state ? await workPresentation(state) : null;
+            console.log(view ? [panelText(view.outcome), ...view.obligations.map(o => `- ${panelText(o.outcome)}`)].join("\n") : state ? "Selected legacy work; outcome text unavailable" : "No work selected. In Pi: /grants work");
+        }
+        return 0;
+    }
     if (parsed.command === "work-add") {
         const declared = await declareWork({
             cwd: resolvePath(parsed.dir ?? process.cwd()),