@plurnk/plurnk-meta 1.0.7 → 1.0.9

package/DIVERGENCES.md

@@ -11,7 +11,7 @@ Doctrine (owner, 2026-07-13): industry standard unless informed, explicit except
 | 5 | Config | Layered dotenv + example files | `.env.defaults` assembled floor: reader-declares, ONE-LAW key ownership, set-if-unset under operator env | **EXCEPTION (owner design, core SPEC §operator-config-env-defaults)** — standard dotenv layering PLUS a uniqueness law and self-documenting floor; strictly more disciplined than the standard, same operator surface. |
 | 6 | CI | Hosted CI (GitHub Actions) | Committed local git hooks; the 82s drill is the whole gate | **EXCEPTION (owner doctrine, AGENTS §one-gate)** — supply-chain posture: no write-token attack surface, the gate that cannot be forgotten, failures caught before the remote sees them. |
 | 7 | Monorepo dev loop | Build-based (project references, turbo/nx caches) | No-build source resolution via the `plurnk-dev` exports condition | **EXCEPTION** — a direct consequence of committing fully to Node 26 no-compile TS (type-stripping), which the runtime is not walking back with Bun at its heels. Zero-build inner loop; the one sharp edge (types-condition ordering) found + fixed 2026-07-13. No compat hedge — Node 26 to the bone. Owner-ruled 2026-07-15. |
-| 8 | Internal versioning | Independent semver + ranges | Lockstep exact pins inside the monorepo | **EXCEPTION** — exact-pinned, fully-reproducible publish surface with zero pin maintenance (release script); consumers see ordinary semver. The per-release publish volume is not a cost to minimize but the honest WEIGHT of a coherent release — every ship is felt, releases stay deliberate ("pain is the best teacher"). Outside leaves peer `^1` = CONVERGED. Owner-ruled 2026-07-15. |
+| 8 | Internal versioning | Independent semver + ranges | Lockstep exact pins inside the monorepo | **EXCEPTION** — exact-pinned, fully-reproducible publish surface with zero pin maintenance (release script); consumers see ordinary semver. The per-release publish volume is not a cost to minimize but the honest WEIGHT of a coherent release — every ship is felt, releases stay deliberate ("pain is the best teacher"). Outside leaves: `^1` RETIRED (owner-ruled 2026-07-17, #512 — a `^1` peer on a fail-forward surface is dishonest; xai@1.0.0 detonated beside providers@1.0.7 to prove it): stepchildren pin heads EXACT until the stability declaration, swept by the release train's stepchild phase every release. |
 | 9 | Package naming | `@scope/name` | `@plurnk/plurnk-name` | **EXCEPTION (owner ruling 2026-07-11)** — shipped surface frozen; renames rejected as churn without user-facing gain. |
 | 10 | Commit convention | Conventional Commits | Conventional subjects ≤80, subject-only, no trailers, hook-enforced | **CONVERGED-plus** — standard grammar, stricter brevity; context rides references (#N / hash / SPEC tag), owner-ruled 2026-07-12. |
 | 11 | Test tooling | Vitest/Jest common; node:test rising | node:test + node:assert exclusively | **EXCEPTION (owner mandate, global)** — zero-dep native runner; the direction the ecosystem itself is moving. |
@@ -19,5 +19,6 @@ Doctrine (owner, 2026-07-13): industry standard unless informed, explicit except
 | 13 | API stability posture | Pre-external-adopter ecosystems churn routinely; stability is DECLARED when outsiders arrive, not performed before | Lockstep 1.0.x numbering with routine fail-forward breaks; majors reserved for a deliberate stability declaration | **CONVERGED 2026-07-13 (#402, owner-instigated)** — the earlier "plugin break = platform MAJOR" rule was performative maturity, retired. |
 | 14 | Reasoning default | Reasoning-capable models default reasoning-on | `REASONING=adaptive` shipped floor | **CONVERGED 2026-07-13** (owner ruling). |
 | 15 | Git in a sandboxed agent | Environment isolation (container/microVM → real git in the box) or no-shell/in-process (isomorphic-git, e.g. WebContainers where the git binary is absent) | Capability-level sandbox → `EXEC[git]` is **isomorphic-git** (in-process, no subprocess); full git via the `EXEC:git …` sh fallthrough, gated on the deployment granting a shell; the `EXEC[gh]` tag/package purged; core repo-management moved onto iso-git | **EXCEPTION — owner-ruled 2026-07-16 (#460).** plurnk sandboxes at the capability level (tag policy, on-host, no per-op container), placing it in the no-shell/in-process class: a raw-git CLI tag is a *false sandbox* (escapes via `git config alias '!sh'`, hooks, `-c core.pager`, `filter-branch --tree-filter`), so in-process iso-git is the forced correct answer. Extends the tag-bar (execs#21 / #350): a capability tag is earned only by a genuine in-process capability the sh fallthrough can't provide (sqlite, wasm, iso-git); CLI-wrapping tags (git, gh, go, cargo) never earn one — they ARE the sh fallthrough. Scope: dev-infra git (lane worktrees, the pre-push gate) stays real-git-CLI on the trusted box — iso-git has no worktree support. |
+| 16 | Management / control plane | AG-UI models agent runs only; servers expose management (list/create/rename/fork threads, constraints, config) via a SEPARATE REST/RPC API alongside the run stream | Management verbs ride the AG-UI run envelope — `forwardedProps.plurnk.action` in, `CUSTOM plurnk.action.result` out; one endpoint, one connection, one auth boundary | **EXCEPTION — owner-ruled 2026-07-18 (#475).** One-wire, no side-channel. Convergence has no target (AG-UI has no management-plane concept), so a separate API is MORE bespoke, not less; the row ratifies the exclusive-portal consolidation that DELETED the WS/`/plurnk/rpc` side-channel. Zero conformance cost — rides the sanctioned `forwardedProps` + `CUSTOM` extension points, invisible to generic clients (no standard event translated away), serves the dumb-client one-socket posture. **Convergence trigger:** if AG-UI adds a native management/control-plane concept, this flips to a convergence item. |
 
 Maintenance: new divergences get a row before they ship; a PROPOSED ruling converts on owner sign-off (recorded on #400).

package/PLURNK_PERSONALITY.md

@@ -1,4 +1,4 @@
-- You decompose non-trivial prompts into taxonomized, tagged, and topical unknown:/// entries to resolve before acting.
+- You decompose non-trivial prompts into taxonomized, tagged, and topical worker:/// entries to resolve before acting.
 - You are concerned with user alignment, documentation alignment, specification alignment, and coverage alignment.
 - You don't code in response to inquiries and exploratory, open questions. You patiently educate, inquire, and align.
 - You ignore emotional subtext, sarcasm, and tone. You never apologize, but you are quick to affirm if you were incorrect.
@@ -9,9 +9,9 @@
 - You trust internal contracts, only building robust guards against bugs on external surfaces.
 - You disregard ambient updates on the state of your environment unless they pertain to your current focus.
 - Your commits add yourself, `Plurnk <plurnk@pm.me>` to the trailer. Branch freely, then merge if solo and PR if in a team.
-- **Knowledgebase:** Curate a taxonomized, tagged, and topical mind map of everything known:/// about the project.
+- **Knowledgebase:** Curate a taxonomized, tagged, and topical worker:/// mind map of everything known about the project.
 - **Plan:** Write a markdown checklist `- [x] Step 1\n- [ ] Step 2\n` in PLAN to list your prerogatives and priorities.
-- **Project:** Maintain a worker://self/project.md of project conventions, patterns, practices, and preferences.
+- **Project:** Maintain a worker://~/project.md of project conventions, patterns, practices, and preferences.
 - **Log:** Distill everything that's not relevant to your current concern and pack it where you can find it later.
 - **Context:** Your Active Context is your workbench. FOLD, KILL, and distill to the knowledgebase to keep it relevant.
 - **Errors:** READ the row the error points at. You can OPEN the "model" log item to find your mistake.

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@plurnk/plurnk-meta",
-    "version": "1.0.7",
+    "version": "1.0.9",
     "description": "The plurnk metaproject layer, published: plugin-membership primitives (the ONE trust rule, scope-agnostic symlink-aware enumeration, deployment-root resolution), the family teaching corpus (personality, requirements, scheme docs), and the home for family tooling.",
     "license": "MIT",
     "type": "module",