@plurnk/plurnk-meta 1.16.5 → 1.18.0

package/.env.defaults

@@ -1,19 +1,7 @@
-# @plurnk/plurnk-meta — the metaproject layer (membership primitives + teaching corpus).
-# Reader-declares ({§operator-config-env-defaults}): this package's code reads these knobs.
-# PREFIX BEND (owner-approved): the knob keeps its subject-named PLURNK_PLUGINS_ prefix —
-# it gates plugins and that is the honest operator-facing name; one-owner-per-key holds.
+# @plurnk/plurnk-meta — package discovery and product orientation.
 
-# Trust gate over scope-agnostic plugin discovery across the four families
-# (schemes, mimetypes, providers, execs) AND the env-defaults floor: installed =
-# discoverable, but this decides installed = TRUSTED — once, at the host, not
-# re-answered per family.
-# =0 / empty / unset → OFF: every installed plugin loads (no regression).
-# A value → ON: @plurnk/* is always trusted, plus a comma-separated allowlist of
-# additionally-trusted packages (anything else discovered is skipped with a
-# telemetry note, never a crash). Use 1 (a value naming no real package) for
-# "on, zero third-party". Example: =acme-execs-cobol,@firewolf/firepad
+# Plugin trust: 0/empty/unset = all installed packages; 1 = @plurnk/* only;
+# comma-separated package names = @plurnk/* plus those packages. Also gates their defaults.
 PLURNK_PLUGINS_TRUSTED_ONLY=0
-
-# Whole-product orientation deadline in seconds. This includes exhaustive semantic
-# preparation of the workspace's admitted project repository before the model is called.
+# Whole-product orientation deadline, seconds; includes admitted-project search preparation.
 PLURNK_ACCEPTANCE_TIMEOUT=3600

package/CORPUS.md

@@ -11,15 +11,20 @@ Authored defaults published by `@plurnk/plurnk-meta` and consumed by
 | `POLICY.md`                     | Read before the first-run seed of the user-owned XDG config `AGENTS.md`.     |
 | `recap.md`                       | Read for an optional Recap rendered last when its content is nonempty.       |
 | `docs/worker.md`                | Read when registered built-in pull docs are materialized.                    |
+| `skills/plurnk/SKILL.md`         | Standard skill entry; Core composes its package-owned and generated resources. |
 
-Core materializes eligible pull docs at `worker://~/_plurnk/skills/plurnk/<name>.md` and
-exposes them through the turn-0 `### FIND0 [+init,+skills] (worker://~/_plurnk/skills/plurnk/*.md)` survey. Merely
+Core materializes eligible scheme and runtime pull docs at
+`worker:///_plurnk/plurnk/<name>.md` and exposes them through turn-0 FIND surveys. Merely
 placing a file in `docs/` does not register a scheme or make speculative
 teaching current. Every listed source is a required package member; a missing
 or failed read surfaces at the admission boundary rather than silently reducing
 the corpus. The intentionally empty `recap.md` is a dormant source, not a missing
 one.
 
+Plurnk's own reference is catalogued at `skill://plurnk/SKILL.md` alongside
+installed skills. Chapters and the complete generated defaults catalog are
+ordinary pull resources, not additional startup packet sections ({§plurnk-skill}).
+
 ## The teaching split
 
 **Contracts teach the language; docs teach the world.** The contracts parser and
@@ -35,10 +40,21 @@ rather than carrying copies in core. Model-facing teaching changes are verified
 through the composed product gates and tracked against the meta owner in the
 monorepo forge.
 
-## Teaching doctrine
-
-**Canon-voice calibration (2026-07-06, probe-backed).** Voice tunes to the FLOOR model's minimum-audible threshold, never any tier's max compliance. A footer loud enough to fix the floor OVER-DRIVES strong models (live evidence: Grok Build fanatically curates under a loud budget footer). Soft is safe because the engine makes floor-misses RECOVERABLE (premature-200 -> pending-set 409 -> repair); that coupling is load-bearing — if failures stop being recoverable, recalibrate louder. The footer is pluggable; potato-heavy deployments inject more at their discretion. The one recency-sensitive line is await-before-200 (lean-footer A/B, gemma, n=6: 6/6 reap in the recency footer vs 3/6 cached-canon-only). Retreat trigger: 409-repair LOOPS (not single misses); first line restored is await-before-200.
-
-**The requiem acceptance gate.** Teaching changes ship against BEFORE/AFTER corpus deltas (reasoning-token + requiem-recurrence), never hunches. Triage separates legibility debt from genuine protocol friction. Model-owned context is the product property: deterministic state and scoped or whole-item KILL support the model's judgment without prescribing what to hide. A re-probe against >=0.76.5 is owed (grammar lane).
-
-**Example doctrine (Arecibo teaching).** Concrete over placeholder — a live model spawned a worker literally named 'name' from a (worker://name) table cell within a day of shipping; placeholders in reserved-bracket forms are doubly banned. Bare-gesture register per section — op-teaching lines carry the gesture, the mechanism stays the engine's; match the surrounding register. Distribution is load-bearing — clustered examples teach false couplings; rebalance coverage, never add runtime prose. TIME is a distribution axis — dynamics teach as protocol-accurate worked multi-turn traces (the Delegation breath), never prose essays; an inaccurate trace (same-turn READ+200) models the wrong protocol.
+## Teaching review
+
+- Keep startup orientation lean; put subsystem mechanics in pull references.
+  A recovery warning belongs at the state that makes it relevant, not in every packet.
+- Use concrete, executable examples. Distribute them across useful operations
+  rather than accidentally teaching one pattern as the only workflow.
+- Show temporal behavior with legal turns under {§op-execution-order} and
+  {§send}; describe the contract, not a model's historical workaround.
+- Evaluate packet bytes, reasoning, operation results, and self-audit evidence
+  together. Distinguish a teaching gap from a runtime defect before prescribing
+  more teaching. Compare model behavior when the change is behavioral; do not
+  promote one small probe into a universal rule.
+- Preserve model-owned context management. Runtime configuration and operator
+  policy can tune different workloads without broadening the default teaching.
+
+Probe history and unresolved experiments belong in forge issues, not current
+doctrine. {§teaching-corpus} owns source membership; {§recap} owns the optional
+footer. Neither creates a second admission rule or release gate.

package/POLICY.md

@@ -1,4 +0,0 @@
-YOU SHOULD assign bounded, independently completable subtasks to WORKers.
-YOU SHOULD format user-facing responses in Markdown, using Mermaid, tables, lists, or prose as the content warrants.
-YOU SHOULD verify theories against real reproductions.
-YOU SHOULD verify solutions with relevant tests, including cases beyond examples and happy paths.

package/README.md

@@ -12,9 +12,7 @@ The plurnk metaproject layer, published — what the family shares that no singl
 - `Meta.packageDirs(nodeModulesDir)` — scope-agnostic, symlink-aware enumeration across Node's ancestor resolution chain as `{ dir, name }` candidates; the nearest package name wins. Ordering and filtering are the caller's policy.
 - `Meta.nearestNodeModules(fromDir)` — walk up to the nearest `node_modules` holding the ecosystem (witness: `@plurnk` scope); `null` when absent.
 
-**The teaching corpus**: authored policy, a compact Recap, and built-in scheme sources resolved from this installed package. Meta owns the source bytes and membership; core owns admission and projection. See [`CORPUS.md`](./CORPUS.md) and {§teaching-corpus}.
-
-**Family tooling** grows here (scaffolders, meta bins) — the published surface of the metaproject's management layer.
+**The teaching corpus**: authored policy, an optional Recap, the Plurnk skill entry, and built-in scheme references resolved from this installed package. Meta owns the source bytes and membership; core owns admission, resource composition, and projection. See [`CORPUS.md`](./CORPUS.md) and {§teaching-corpus}.
 
 [`DOGFOOD.md`](./DOGFOOD.md) defines the whole-product, outside-client acceptance gate for daily-driver and release readiness.
 

package/SPEC.md

@@ -16,6 +16,7 @@ sources into a consuming package would create a second teaching owner.
 | `POLICY.md`                     | Required   | First-run default operating policy                 | Policy bootstrap {§policy-sections}                     |
 | `recap.md`                       | Required   | Optional default operational Recap                 | Per-packet user-slot footer {§recap}                    |
 | `docs/worker.md`                | Required   | Deep reference prose for the reserved worker scheme | Pull-doc materialization {§schemes-directory}           |
+| `skills/plurnk/SKILL.md`         | Required   | Standard Plurnk skill entry and chapter directory | Service-provided skill {§plurnk-skill} |
 
 Required is a package-membership statement, not unconditional packet
 projection. Each source is read only at its consuming boundary; absence or an
@@ -32,14 +33,13 @@ unregistered names do not ship as speculative teaching. Manifest `documentation`
 optional: an absent field contributes no pull doc, while a present field is the
 fallback only when meta owns no source for that scheme name.
 
-## §no-bundled-skills No package-bundled Agent Skills
+## §skills-installation-boundary Skill composition and installation
 
-Meta publishes no Agent Skills of its own. Skill discovery, installation, and
-enablement are the Worker's `skills` Functionality family in core
-({§skills-functionality}); the model learns that family from its generated
-manager document, never from a bundled skill that teaches a shell package
-manager. Standard skills reach a Worker only from the universal project and
-user-global roots.
+Meta authors the standard Plurnk `SKILL.md`; Core composes its resource tree
+from package-owned references and generated resources ({§plurnk-skill}). Skill
+discovery and enablement use the same Worker family as installed skills
+({§skills-functionality}). Neither package copies skills into universal roots
+or invokes an installer merely to expose the service's own reference material.
 
 ## §plugin-discovery Installed capability discovery
 

package/dist/index.d.ts

@@ -20,14 +20,12 @@ export interface PluginAttributionSource {
 export declare const TEACHING_CORPUS: Readonly<{
     readonly policy: "POLICY.md";
     readonly recap: "recap.md";
+    readonly skill: "skills/plurnk/SKILL.md";
     readonly schemeDocs: Readonly<{
         readonly worker: "docs/worker.md";
     }>;
-    readonly skillDocs: Readonly<{
-        readonly git: "docs/git.md";
-    }>;
 }>;
-export type TeachingCorpusSource = typeof TEACHING_CORPUS.policy | typeof TEACHING_CORPUS.recap | (typeof TEACHING_CORPUS.schemeDocs)[keyof typeof TEACHING_CORPUS.schemeDocs] | (typeof TEACHING_CORPUS.skillDocs)[keyof typeof TEACHING_CORPUS.skillDocs];
+export type TeachingCorpusSource = typeof TEACHING_CORPUS.policy | typeof TEACHING_CORPUS.recap | typeof TEACHING_CORPUS.skill | (typeof TEACHING_CORPUS.schemeDocs)[keyof typeof TEACHING_CORPUS.schemeDocs];
 export default class Meta {
     #private;
     static declaresKind(manifest: unknown, kind: PluginKind): boolean;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,mBAAmB,GAAG,QAAQ,CAAC;AAItG,MAAM,MAAM,4BAA4B,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AAC7D,MAAM,MAAM,iBAAiB,GAAG,SAAS,MAAM,EAAE,CAAC;AAClD,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAEzE,MAAM,WAAW,wBAAwB;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACpC,YAAY,CAAC,CAAC,OAAO,EAAE,wBAAwB,GAAG,4BAA4B,GAAG,IAAI,GAAG,SAAS,CAAC;CACrG;AAaD,eAAO,MAAM,eAAe;qBAChB,WAAW;oBACZ,UAAU;;yBAZT,gBAAgB;;;sBAOnB,aAAa;;EASX,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAC1B,OAAO,eAAe,CAAC,MAAM,GAC7B,OAAO,eAAe,CAAC,KAAK,GAC5B,CAAC,OAAO,eAAe,CAAC,UAAU,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,UAAU,CAAC,GAC5E,CAAC,OAAO,eAAe,CAAC,SAAS,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,SAAS,CAAC,CAAA;AAMhF,MAAM,CAAC,OAAO,OAAO,IAAI;;IACrB,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAGhE;IAKD,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,OAAO,CAKpG;IAED,MAAM,CAAC,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,iBAAiB,CAiBhF;IAKD,MAAM,CAAC,kBAAkB,CACrB,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,wBAAwB,EACjC,WAAW,EAAE,MAAM,GACpB,iBAAiB,CAcnB;IAED,MAAM,CAAC,mBAAmB,CAAC,GAAG,KAAK,EAAE,SAAS,iBAAiB,EAAE,GAAG,iBAAiB,CAIpF;IAkCD,OAAa,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAyB5E;IAED,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASxD;CACJ"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,gBAAgB;IAC7B,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,UAAU,GAAG,QAAQ,GAAG,mBAAmB,GAAG,QAAQ,CAAC;AAItG,MAAM,MAAM,4BAA4B,GAAG,MAAM,GAAG,MAAM,EAAE,CAAC;AAC7D,MAAM,MAAM,iBAAiB,GAAG,SAAS,MAAM,EAAE,CAAC;AAClD,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAEzE,MAAM,WAAW,wBAAwB;IACrC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,uBAAuB;IACpC,YAAY,CAAC,CAAC,OAAO,EAAE,wBAAwB,GAAG,4BAA4B,GAAG,IAAI,GAAG,SAAS,CAAC;CACrG;AAQD,eAAO,MAAM,eAAe;qBAChB,WAAW;oBACZ,UAAU;oBACV,wBAAwB;;yBARvB,gBAAgB;;EAWjB,CAAC;AAEZ,MAAM,MAAM,oBAAoB,GAC1B,OAAO,eAAe,CAAC,MAAM,GAC7B,OAAO,eAAe,CAAC,KAAK,GAC5B,OAAO,eAAe,CAAC,KAAK,GAC5B,CAAC,OAAO,eAAe,CAAC,UAAU,CAAC,CAAC,MAAM,OAAO,eAAe,CAAC,UAAU,CAAC,CAAC;AAMnF,MAAM,CAAC,OAAO,OAAO,IAAI;;IACrB,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,GAAG,OAAO,CAGhE;IAKD,MAAM,CAAC,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,OAAO,CAKpG;IAED,MAAM,CAAC,oBAAoB,CAAC,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,iBAAiB,CAiBhF;IAKD,MAAM,CAAC,kBAAkB,CACrB,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,wBAAwB,EACjC,WAAW,EAAE,MAAM,GACpB,iBAAiB,CAcnB;IAED,MAAM,CAAC,mBAAmB,CAAC,GAAG,KAAK,EAAE,SAAS,iBAAiB,EAAE,GAAG,iBAAiB,CAIpF;IAkCD,OAAa,WAAW,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAyB5E;IAED,MAAM,CAAC,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CASxD;CACJ"}

package/dist/index.js

@@ -24,15 +24,11 @@ const SCHEME_TEACHING = Object.freeze({
 });
 // {§teaching-corpus} — the authored package membership is one exported fact;
 // consumers decide when and where each required source is projected.
-// {§git-skill} — the one bundled skill document, surfaced by the service where it applies.
-const SKILL_TEACHING = Object.freeze({
-    git: "docs/git.md",
-});
 export const TEACHING_CORPUS = Object.freeze({
     policy: "POLICY.md",
     recap: "recap.md",
+    skill: "skills/plurnk/SKILL.md",
     schemeDocs: SCHEME_TEACHING,
-    skillDocs: SKILL_TEACHING,
 });
 const RESERVED_ATTRIBUTION_PREFIX = "@plurnk/";
 const EMPTY_ATTRIBUTION = Object.freeze([]);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAC3E,0EAA0E;AAC1E,6EAA6E;AAC7E,kFAAkF;AAClF,+EAA+E;AAC/E,4BAA4B;AAC5B,4EAA4E;AAC5E,gFAAgF;AAChF,iFAAiF;AACjF,+EAA+E;AAC/E,6EAA6E;AAC7E,2CAA2C;AAC3C,8EAA8E;AAC9E,iFAAiF;AACjF,4EAA4E;AAC5E,kFAAkF;AAClF,mFAAmF;AACnF,+DAA+D;AAE/D,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,IAAI,MAAM,WAAW,CAAC;AA4B7B,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IAClC,MAAM,EAAE,gBAAgB;CAClB,CAAC,CAAC;AAEZ,6EAA6E;AAC7E,qEAAqE;AACrE,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC;IACzC,MAAM,EAAE,WAAW;IACnB,KAAK,EAAE,UAAU;IACjB,KAAK,EAAE,wBAAwB;IAC/B,UAAU,EAAE,eAAe;CAErB,CAAC,CAAC;AASZ,MAAM,2BAA2B,GAAG,UAAU,CAAC;AAC/C,MAAM,iBAAiB,GAAsB,MAAM,CAAC,MAAM,CAAC,EAAc,CAAC,CAAC;AAE3E,MAAM,CAAC,OAAO,OAAO,IAAI;IACrB,MAAM,CAAC,YAAY,CAAC,QAAiB,EAAE,IAAgB;QACnD,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,KAAK,IAAI;YAAE,OAAO,KAAK,CAAC;QACpE,OAAQ,QAA+B,CAAC,IAAI,KAAK,IAAI,CAAC;IAC1D,CAAC;IAED,gEAAgE;IAChE,+EAA+E;IAC/E,qFAAqF;IACrF,MAAM,CAAC,SAAS,CAAC,WAAmB,EAAE,GAAG,GAAuC,OAAO,CAAC,GAAG;QACvF,MAAM,KAAK,GAAG,GAAG,CAAC,2BAA2B,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;QAC5D,IAAI,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,GAAG;YAAE,OAAO,IAAI,CAAC;QAC/C,IAAI,WAAW,CAAC,UAAU,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC;QACpD,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,CAAC,oBAAoB,CAAC,GAAY,EAAE,WAAmB;QACzD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,iBAAiB,CAAC;QAChE,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAChD,MAAM,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,2BAA2B,CAAC,CAAC;QACvE,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YAC9B,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAClD,MAAM,IAAI,KAAK,CAAC,WAAW,WAAW,8DAA8D,CAAC,CAAC;YAC1G,CAAC;YACD,IAAI,KAAK,CAAC,UAAU,CAAC,2BAA2B,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;gBAC/D,MAAM,IAAI,KAAK,CACX,WAAW,WAAW,OAAO,2BAA2B,oBAAoB;sBAC1E,GAAG,2BAA2B,uBAAuB,WAAW,mBAAmB,KAAK,GAAG,CAChG,CAAC;YACN,CAAC;YACD,OAAO,KAAK,CAAC;QACjB,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED,2EAA2E;IAC3E,wEAAwE;IACxE,0DAA0D;IAC1D,MAAM,CAAC,kBAAkB,CACrB,MAAe,EACf,OAAiC,EACjC,WAAmB;QAEnB,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS;YAAE,OAAO,iBAAiB,CAAC;QACtE,MAAM,IAAI,GAAI,MAAqC,CAAC,YAAY,CAAC;QACjE,IAAI,IAAI,KAAK,SAAS;YAAE,OAAO,iBAAiB,CAAC;QACjD,IAAI,OAAO,IAAI,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAM,IAAI,SAAS,CAAC,WAAW,WAAW,iDAAiD,CAAC,CAAC;QACjG,CAAC;QACD,IAAI,GAAY,CAAC;QACjB,IAAI,CAAC;YACD,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,MAAM,IAAI,KAAK,CAAC,WAAW,WAAW,0BAA0B,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,OAAO,IAAI,CAAC,oBAAoB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,CAAC,mBAAmB,CAAC,GAAG,KAAmC;QAC7D,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,iBAAiB,CAAC;QACjD,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;QACnD,OAAO,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACvE,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,eAAe,CAAC,cAAsB;QAC/C,IAAI,OAAmF,CAAC;QACxF,IAAI,CAAC;YACD,OAAO,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,EAAE,CAAC;QACd,CAAC;QACD,MAAM,UAAU,GAAuB,EAAE,CAAC;QAC1C,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC1B,IAAI,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,cAAc,EAAE,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YAC7F,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;gBACvD,IAAI,MAAsB,CAAC;gBAC3B,IAAI,CAAC;oBACD,MAAM,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;gBAC9D,CAAC;gBAAC,MAAM,CAAC;oBACL,SAAS;gBACb,CAAC;gBACD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;oBACrB,IAAI,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,cAAc,EAAE;wBAAE,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;gBACtI,CAAC;YACL,CAAC;iBAAM,CAAC;gBACJ,UAAU,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;YACtF,CAAC;QACL,CAAC;QACD,OAAO,UAAU,CAAC;IACtB,CAAC;IAED,8EAA8E;IAC9E,+EAA+E;IAC/E,kFAAkF;IAClF,gFAAgF;IAChF,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,cAAsB;QAC3C,MAAM,UAAU,GAAuB,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG,IAAI,GAAG,EAAU,CAAC;QACpC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;QACnC,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACvC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACxB,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAClB,KAAK,MAAM,SAAS,IAAI,MAAM,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtD,IAAI,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC;oBAAE,SAAS;gBAC5C,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC9B,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC/B,CAAC;YACD,IAAI,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC/B,IAAI,IAAI,GAAkB,IAAI,CAAC;YAC/B,OAAO,IAAI,EAAE,CAAC;gBACV,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBACpC,IAAI,MAAM,KAAK,MAAM;oBAAE,MAAM;gBAC7B,MAAM,GAAG,MAAM,CAAC;gBAChB,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;gBACxG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;oBAAC,IAAI,GAAG,SAAS,CAAC;oBAAC,MAAM;gBAAC,CAAC;YACvF,CAAC;YACD,IAAI,IAAI,KAAK,IAAI;gBAAE,MAAM;YACzB,GAAG,GAAG,IAAI,CAAC;QACf,CAAC;QACD,OAAO,UAAU,CAAC;IACtB,CAAC;IAED,MAAM,CAAC,kBAAkB,CAAC,OAAe;QACrC,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,IAAI,EAAE,CAAC;YACV,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YACjD,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;gBAAE,OAAO,SAAS,CAAC;YAClE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YACjC,IAAI,MAAM,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAC;YAChC,GAAG,GAAG,MAAM,CAAC;QACjB,CAAC;IACL,CAAC;CACJ"}

package/docs/worker.md

@@ -2,45 +2,140 @@
 
 ## Summary
 
-Coordinate workers and manage shared or private workspace entries.
-
-Workers inhabit one workspace. `worker://<name>` addresses a named worker; `worker://~` is the
-current-worker control sigil; `worker://~/path` addresses your private entries; `worker:///path`
-addresses the shared commons.
-`### WORK0 (worker://<name>)` with a task body spawns a fresh worker with an empty log.
-`### FORK0 (worker://<name>)` branches your current history. `### SEND0 (worker://<name>)`
-with a message body wakes and messages a worker; `### KILL0 (worker://<name>)` ends one.
-Workers share project files and the commons, while private entries
-and conversation logs remain owner-scoped. A worker is born from WORK/FORK, never EDIT —
-`### EDIT0 (worker://<name>)` on the bare worker is rejected.
-
-**The path is the discriminator.** `worker://<name>` with no path addresses a literal worker name
-for WORK, FORK, SEND, READ, or KILL; `worker://~` addresses the caller for SEND or KILL.
-The control form is exact: a trailing slash, userinfo, port, query, fragment, or `{metadata}` modifier
-is invalid rather than ignored.
-`worker://<name>/path` addresses an ancestry-visible named entry; `### EDIT0 (worker://~/todo.md)`
-with a body writes your own private entry.
-
-**WORK to delegate, FORK to branch.** For fan-out, WORK a distinct-named worker per job. Each gets
-a fresh task. FORK only to carry *your own* context down an alternate path.
-
-**Loop: spawn once → park → collect on wake.** Spawn and park with:
-
-```example
-### WORK0 (worker://capital-checker)
+Coordinate workers, request isolated BARE inference, and manage workspace entries.
+
+Workers inhabit one workspace. The authority selects a worker; a path selects
+an entry rather than controlling that worker.
+
+| Address | Meaning | Model access |
+| --- | --- | --- |
+| `worker://reviewer` | Named worker | WORK/FORK create; SEND messages; READ collects; KILL terminates. |
+| `worker://reviewer/notes.md` | Named scratch entry | Read and write from any worker in the workspace. |
+| `worker:///notes.md` | Shared commons entry | Read and write. |
+
+The packet names your worker, its parent (`null` at a root), and the loop and turn you are producing under `## Worker`, below the log. Addresses are literal and keep
+the same meaning when passed to another worker. All scratch belongs to the
+workspace; its namespace does not require a namesake worker. Generated
+references live under `worker:///_plurnk/`; reference
+refreshes may replace those generated documents. EDIT creates or changes an
+entry, never a worker. An unscoped EDIT creates the entry from its body.
+
+````EDIT (worker://reviewer/scratch/greet.mjs) <!-- create the entry from the body -->
+export const greet = (name) => `hello ${name}`;
+
+console.log(greet("world"));
+````
+
+Control addresses contain only scheme and authority: no trailing slash,
+userinfo, port, query, fragment, or `[metadata]` modifier.
+
+An entry whose source has a readable projection (HTML, a notebook) carries it
+beside the source as `#readable`, text/markdown, in its own line coordinates;
+the default channel stays the source. Patterns match the channel they address:
+`page.html` matches the markup, `page.html#readable` the Markdown. The
+projection follows every source write and is never written itself.
+
+## Turn sources
+
+| Address | Read-only source in your worker's history |
+| --- | --- |
+| `ops:///<loop>/<turn>` | The exact submitted program, including interstitial text. |
+| `reasoning:///<loop>/<turn>` | Original provider reasoning when exposed, or a harness turn's authored rationale. |
+
+READ brings the selected source into your log; KILL of that READ curates only
+its log projection, never the original evidence. No later reasoning is added
+automatically after initialization's example READ.
+
+A READ can retain your current turn's reasoning: the source exists when your
+OPs execute. The packet's `## Worker` block names the coordinate you are
+producing. For example, on `"loop":1,"turn":3`:
+
+````READ (reasoning:///1/3) <1,-1>
+````
+
+The ordinary READ receipt appears in subsequent packets. A turn that produced
+no reasoning reads empty; a turn that has not happened returns a missing-source
+result. READ never requests inference.
+
+## Delegation
+
+**WORK to delegate, FORK to branch.** WORK starts a fresh log with your task
+prompt; FORK copies your history and named scratch into its new name, then
+diverges. Embedded addresses are preserved verbatim. Both share the workspace.
+Omit the address to allocate a short worker name, reported in the receipt;
+explicit names cannot replace an existing worker, even after it finishes.
+A path outside the `worker://` scheme is the child's prompt resource, as for
+BARE: `WORK (specs/feature.md)` reads the file whole as the task,
+an inline body follows it after a blank line, and the child is auto-named.
+Use SEND to give an existing worker a follow-up task.
+
+Directed SEND accepts `<delay,interval>` in whole minutes to schedule its body
+as a new task, rather than interrupting an unfinished task:
+
+````SEND (worker://reviewer) <0,60>
+Check for new messages and report relevant findings.
+````
+
+`<60>` runs once after an hour; `<0,60>` starts immediately and repeats hourly.
+Delay is nonnegative; an interval is positive. Occurrences never overlap; missed
+ticks coalesce without a backlog. Each occurrence uses the original instruction
+and policy with fresh task limits. Success permits the next occurrence; an all-failed inventory or
+an engine failure ends the recurrence. KILL cancels current and future tasks.
+Queued future tasks remain live worker obligations, visible with their due times.
+
+## BARE inference
+
+BARE makes one isolated call to the child model, not a persistent worker.
+It receives no parent history or tools. Give it a prompt resource, an inline
+prompt, or both; resource text precedes an inline body with a blank line between.
+
+````BARE (worker://reviewer/question.md)
+````
+````BARE
+What is the capital of Germany?
+````
+
+The resource supplies its complete current READ text, not a preview. Neither
+prompt form is truncated to fit; provider capacity still applies. A failed
+source read returns its error without making an inference call.
+Consecutive BARE calls run concurrently and settle before the turn continues.
+Their answers are ordinary BARE receipts, visible in the next packet.
+
+## Lifecycle
+
+**Continue or wait.** TASK declares the current inventory. An `in_progress`
+item keeps the loop working while children run; `waiting` joins their activity:
+
+````WORK (worker://capital-checker)
 Find the capital of France from a primary source
+````
+
+````TASK
+[{"content":"Await capital-checker's answer.","status":"waiting"}]
+````
+
+TASK with waiting intent accepts `<timeout,poll>` in whole minutes. It continues the same loop;
+neither a deadline nor a poll repeats a message or command.
+
+| Scope | Wake condition |
+| --- | --- |
+| Omitted / `<-1>` | Existing work completes or a message arrives; inherit open streams' polling. |
+| `<60>` | Also wake after at most 60 minutes, even without other work. |
+| `<-1,60>` | Also wake after 60 minutes to observe; no wait deadline. |
+| `<60,0>` | Deadline or an event; no periodic stream observation. |
 
-### SEND0 (WAIT)
-Awaiting capital-checker.
-```
+A wake ends that wait. Submit another waiting inventory to wait again. Waking
+retains the loop's prompts, turn allowance, and remaining execution time;
+parked time does not consume execution time. An untimed wait without live work
+continues. A terminal inventory with at least one completed item claims success;
+a nonempty all-failed inventory concludes unsuccessfully.
 
-You wake when the worker concludes: its
-result arrives open in your log as a `SEND` from `worker://capital-checker` — read it and continue.
-Or pull it with `### READ0 (worker://capital-checker)`; it returns the result, or `425` while running. Spawn
-each worker exactly once. Fan-out uses distinct names, followed by one park. Each conclusion wakes
-you with its delta.
+Each child task's conclusion reaches its parent automatically as a log `SEND` from
+`worker://capital-checker`, waking a waiting parent. Success includes the body;
+failure preserves its status and Problem. `READ (worker://capital-checker)`
+collects the same result explicitly. While the child is running it returns
+`425`; the inventory still chooses whether to continue or wait.
+A result does not imply that every task in that worker has finished.
 
-**Concluding with live workers.** `### SEND0 (TERM)` is refused (`409`) while you hold a live worker or
-open stream. The system packet lists them under `## Active Child Workers` and `## Child Streams`.
-Either `### SEND0 (WAIT)` to await them or `### KILL0 (worker://<name>)` the ones you no longer need.
-A same-turn KILL followed by `### SEND0 (TERM)` concludes cleanly.
+`KILL (worker://<name>)` cancels that worker and its descendants, including
+queued work and unread messages. History remains readable; a later SEND can start new work.

package/package.json

@@ -1,7 +1,13 @@
 {
     "name": "@plurnk/plurnk-meta",
-    "version": "1.16.5",
+    "version": "1.18.0",
     "description": "The plurnk metaproject layer, published: plugin-membership primitives (the ONE trust rule, scope-agnostic symlink-aware enumeration, deployment-root resolution), the project teaching corpus (personality, Recap, scheme docs), and the home for family tooling.",
+    "keywords": [
+        "plurnk",
+        "agent-skills",
+        "skill",
+        "documentation"
+    ],
     "license": "MIT",
     "type": "module",
     "engines": {
@@ -17,6 +23,7 @@
         "POLICY.md",
         "recap.md",
         "docs/**/*",
+        "skills/**/*",
         "DIVERGENCES.md"
     ],
     "exports": {

package/skills/plurnk/SKILL.md

@@ -0,0 +1,21 @@
+---
+name: plurnk
+description: Configure Plurnk, select and tune models, and look up its worker and tool contracts.
+---
+
+# Plurnk
+
+| Need | Reference |
+| --- | --- |
+| Configuration cascade, persistence, permissions, skills | [Configuration](references/configuration.md) |
+| Model routes, reasoning, context, local endpoints | [Models](references/models.md) |
+| Every installed package's settings and defaults | [Complete .env.defaults](.env.defaults) |
+| Worker hierarchy, messaging, and delegation | [Worker reference](worker:///_plurnk/plurnk/worker.md) |
+| Which project files you can see, and why a file is missing | [Membership](worker:///_plurnk/plurnk/members.md) |
+| Agent Skills, MCP servers, and A2A agents: when to reach for one, how to add one | `worker:///_plurnk/plurnk/skills.md`, `mcp.md`, `agents.md` |
+| Running code: the shell and each interpreter's body, stdin, arguments, exit status | `worker:///_plurnk/plurnk/sh.md`, `node.md`, `python3.md`, … |
+| Enabled MCP server invocations and schemas | `worker:///_plurnk/tools/` |
+| Built-in executors and scheme references | `worker:///_plurnk/plurnk/` |
+
+READ the relevant reference; FIND can select paths and search their bodies.
+Defaults describe available settings, not the operator's effective configuration.

package/docs/git.md

@@ -1,60 +0,0 @@
-# git — advanced repository usage
-
-## Summary
-
-Advanced git usage: commits, branches, worktrees, and delegation in the Plurnk environment.
-
-Your workspace is a git working tree. Tracked files are the membership you READ, FIND, and
-EDIT; the packet's `## Git Status` names the branch and counts staged, unstaged, and untracked
-paths every turn. Routine work needs none of this document: edit, run the tests, commit. Read
-on when the task spans branches, parallel workers, or history you did not write.
-
-**Commits are the only shareable state.** Every worker sees the same working tree, so an
-uncommitted change is visible to all of them and belongs to none of them. "Dirt" means
-uncommitted changes to tracked content; an untracked file belongs to no branch at all. Commit
-before you delegate, commit before you switch, and commit small: one intention per commit,
-the subject a sentence that says what changed, never why the model felt like it.
-
-**One branch per child, one child per checkout.** A branch-shaped subtask is an ordinary
-WORK whose brief begins with the branch it owns:
-
-```example
-### EXEC0 <!-- park my own work before anyone switches -->
-git add -A && git commit -q -m "wip: parser rewrite before delegating the lexer"
-
-### WORK0 (worker://lexer)
-On a new branch `feat/lexer` from the current HEAD: replace src/lexer.js with the
-table-driven lexer described in docs/lexer.md, run `npm test`, commit on that branch,
-then `git switch -` back to the branch you started on and report the commit hash.
-
-### SEND0 (WAIT)
-Awaiting lexer.
-```
-
-Never let two children drive `git switch` in the same checkout at the same time: the second
-switch strands the first child's edits on the wrong branch. Spawn branch-shaped children one at
-a time, or give each its own worktree.
-
-**Worktrees give parallel children their own checkout.** `git worktree add ../lexer-wt
-feat/lexer` creates a second working tree on its own branch; a child told to work inside it can
-switch, commit, and run tests without touching yours. Membership follows the worktree's tracked
-files. Remove it with `git worktree remove ../lexer-wt` after the merge; a forced removal
-discards uncommitted work there.
-
-**The parent collects and merges deliberately.** When a child reports, READ its commit
-(`git show --stat <hash>`) before merging. Merge with `git merge --no-ff feat/lexer` or
-fast-forward when the history is linear; resolve conflicts yourself rather than asking the child
-to redo the work blind. Delete the branch once merged.
-
-**History you did not write is not yours to rewrite.** Never `git push --force`, rebase, or
-amend commits that exist on a remote or in another worker's branch. Amend only your own
-unpushed tip. Prefer a new commit that fixes over a rewrite that hides.
-
-**Inspect before you act.** `git status --short`, `git diff --stat`, `git log --oneline -20`,
-and `git blame -L <start>,<end> <path>` answer most questions about a tree in one EXEC each.
-Read a file at another revision with `git show <ref>:<path>` rather than switching branches to
-look at it.
-
-**Stash is a last resort.** A stash is invisible to every other worker and to the packet's
-git status. If work must be set aside, commit it as `wip:` on its branch and reset or revert
-later; a commit can be seen, a stash is easily lost.