@agentworkforce/cli 0.15.0 → 0.15.1

package/CHANGELOG.md

@@ -7,6 +7,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.15.1] - 2026-05-08
+
 ### Added
 
 - `agentworkforce agent` now records launch metadata for direct harness

package/README.md

@@ -1,9 +1,9 @@
 # agentworkforce CLI
 
 A thin command-line front end for the workload-router. Spawns the harness CLI
-(`claude`, `codex`, `opencode`) configured by a selected **persona** — either a
-built-in one from `/personas/`, or an installed/local one that extends a lower
-source.
+(`claude`, `codex`, `opencode`) configured by a selected **persona** from the
+project-local layer, configured source directories, or the small internal
+built-in system catalog.
 
 ```
 agentworkforce create [--save-in-directory=<target>] [--save-default] [--install-in-repo] [--no-launch-metadata]
@@ -59,8 +59,9 @@ agentworkforce agent <persona>[@<tier>]
   1. A **cwd-local** id (files in `<cwd>/.agentworkforce/workforce/personas/*.json`)
   2. A configured persona source dir, in order. The default is
      `~/.agentworkforce/workforce/personas/*.json`.
-  3. A **library** persona — by intent first (e.g. `review`), then by id
-     (e.g. `code-reviewer`)
+  3. An internal **library** persona — by intent first, then by id. The built-in
+     library is system-only; optional personas such as `code-reviewer` come from
+     installed persona packs.
 - `<tier>` — `best` | `best-value` | `minimum`. Defaults to `best-value`.
 
 Unknown persona prints the full catalog with each entry's origin.
@@ -80,7 +81,7 @@ persona inputs:
 | Input | Meaning |
 | --- | --- |
 | `TARGET_DIR` | Absolute directory where the new `<id>.json` persona file should be written. |
-| `CREATE_MODE` | `local` writes only JSON; `built-in` also updates catalog/routing/test/docs integration. |
+| `CREATE_MODE` | `local` writes only JSON; `built-in` is reserved for internal/system personas and also updates catalog/routing/test/docs integration. |
 
 Targets:
 
@@ -119,7 +120,7 @@ agentworkforce create --save-in-directory=dir:1
 # Create in an explicit checked-out persona directory and make that the default
 agentworkforce create --save-in-directory=../team-personas/personas --save-default
 
-# Create a built-in persona in this repo's /personas catalog
+# Create an internal/system built-in persona in this repo's /personas catalog
 agentworkforce create --save-in-directory=library
 ```
 
@@ -129,13 +130,11 @@ agentworkforce create --save-in-directory=library
 agentworkforce create
 
 # Interactive code reviewer
-agentworkforce agent review@best-value
-
-# Interactive PostHog session (library persona, needs POSTHOG_API_KEY)
-agentworkforce agent posthog@best
+agentworkforce install @agentworkforce/personas-core --persona code-reviewer
+agentworkforce agent code-reviewer@best-value
 
 # Interactive against a local override
-agentworkforce agent my-posthog@best
+agentworkforce agent my-reviewer@best
 ```
 
 ## Install persona packs
@@ -158,6 +157,8 @@ Npm package specs are resolved with `npm pack`, so npm auth, npm config,
 private packages, tags, and versions work the same way they do for npm:
 
 ```sh
+agentworkforce install @agentworkforce/personas-core
+agentworkforce install @agentworkforce/personas-core@0.8.0 --persona code-reviewer
 agentworkforce install @agentrelay/personas
 agentworkforce install @agentrelay/personas@1.2.3
 agentworkforce install @agentrelay/personas@latest
@@ -176,8 +177,8 @@ By default, every `*.json` file in the pack's persona directory is copied.
 Use repeated `--persona <id>` flags to install a subset by persona `id`:
 
 ```sh
+agentworkforce install @agentworkforce/personas-core --persona code-reviewer
 agentworkforce install @agentrelay/personas --persona relay-orchestrator
-agentworkforce install @agentrelay/personas --persona relay-orchestrator --persona code-reviewer
 ```
 
 If any requested id is missing, the command exits non-zero before copying
@@ -209,19 +210,18 @@ basename if they are expected to be installed together.
 A pack can contain multiple personas:
 
 ```text
-@agentrelay/personas
+@acme/personas
 ├── package.json
 └── personas/
-    ├── relay-orchestrator.json
-    ├── code-reviewer.json
-    └── e2e-validator.json
+    ├── reviewer.json
+    └── release-runner.json
 ```
 
 `package.json` may declare the persona directory:
 
 ```json
 {
-  "name": "@agentrelay/personas",
+  "name": "@acme/personas",
   "version": "1.2.3",
   "files": ["personas"],
   "keywords": ["agentworkforce-personas"],
@@ -427,7 +427,9 @@ MCP servers to attach*. Full library shape:
 }
 ```
 
-See `/personas/*.json` for all built-ins.
+The repo built-in catalog is intentionally system-only and currently contains
+`persona-maker`. Optional reusable personas are installed from packs such as
+`@agentworkforce/personas-core` or `@agentrelay/personas`.
 
 ## Local personas & the cascade
 
@@ -437,7 +439,7 @@ wins):
 1. `<cwd>/.agentworkforce/workforce/personas/*.json` — **cwd**
 2. Configurable persona source dirs, in order. Default:
    `~/.agentworkforce/workforce/personas/*.json` — **user**
-3. Built-in personas in `/personas/` — **library**
+3. Internal built-in system personas in `/personas/` — **library**
 
 Local files are **partial overlays**: only the fields you set replace the
 inherited value. Everything else cascades through from below.
@@ -446,56 +448,62 @@ Set `AGENT_WORKFORCE_HOME` to move the `~/.agentworkforce/workforce` config
 root. The legacy `AGENT_WORKFORCE_CONFIG_DIR` env var is still honored as a
 direct override for the default user persona directory.
 
-### Minimal override: add your API key
+### Minimal override
+
+Install the core pack first so `code-reviewer` exists in a lower layer:
 
-`~/.agentworkforce/workforce/personas/my-posthog.json`:
+```sh
+agentworkforce install @agentworkforce/personas-core --persona code-reviewer
+```
+
+`~/.agentworkforce/workforce/personas/my-reviewer.json`:
 
 ```json
 {
-  "id": "my-posthog",
-  "extends": "posthog",
-  "env": { "POSTHOG_API_KEY": "$POSTHOG_API_KEY" }
+  "id": "my-reviewer",
+  "extends": "code-reviewer",
+  "systemPrompt": "Review this repository's API compatibility and migration risks. Lead with blockers."
 }
 ```
 
-That inherits every field from the library `posthog` persona, then layers your
-`env` on top. `agentworkforce agent my-posthog@best` now works as long as
-`POSTHOG_API_KEY` is exported in your shell.
+That inherits every field from the installed `code-reviewer` persona, then
+layers your local prompt on top.
 
 ### Same-id override (implicit extends)
 
 If your file's `id` matches a persona in a lower layer and you omit `extends`,
 the loader implicitly inherits from that same-id base:
 
-`<cwd>/.agentworkforce/workforce/personas/posthog.json`:
+`<cwd>/.agentworkforce/workforce/personas/code-reviewer.json`:
 
 ```json
 {
-  "id": "posthog",
-  "env": { "POSTHOG_API_KEY": "$POSTHOG_API_KEY" }
+  "id": "code-reviewer",
+  "systemPrompt": "Review with this repository's compatibility checklist first."
 }
 ```
 
-Resolving `posthog` now hits this cwd override first; it inherits the rest
-(MCP, tiers, description, etc.) from the library `posthog`.
+Resolving `code-reviewer` now hits this cwd override first; it inherits the
+rest from the installed lower-layer `code-reviewer`.
 
 ### Cascade chain
 
-A cwd file can extend a user or configured-dir file, which extends the library:
+A cwd file can extend a user or configured-dir file, which can extend an
+installed pack persona or the internal library:
 
 ```
-~/.agentworkforce/workforce/personas/ph-base.json:
-{ "id": "ph-base", "extends": "posthog", "env": { "POSTHOG_ORG": "acme" } }
+~/.agentworkforce/workforce/personas/reviewer-base.json:
+{ "id": "reviewer-base", "extends": "code-reviewer", "systemPrompt": "Review with org-wide API compatibility rules." }
 
-<cwd>/.agentworkforce/workforce/personas/ph-prod.json:
-{ "id": "ph-prod", "extends": "ph-base", "env": { "POSTHOG_API_KEY": "$PROD_KEY" } }
+<cwd>/.agentworkforce/workforce/personas/reviewer-prod.json:
+{ "id": "reviewer-prod", "extends": "reviewer-base", "systemPrompt": "Add this service's migration checklist." }
 ```
 
-Resolving `ph-prod`:
+Resolving `reviewer-prod`:
 
-- Start with library `posthog` (MCP, tiers, prompt, …)
-- Layer user `ph-base` on top (adds `POSTHOG_ORG=acme`)
-- Layer cwd `ph-prod` on top (adds `POSTHOG_API_KEY`)
+- Start with installed `code-reviewer` (tiers, skills, prompt, ...)
+- Layer user `reviewer-base` on top
+- Layer cwd `reviewer-prod` on top
 
 `extends` is resolved **strictly against lower layers** — cwd extends configured
 dirs or library, configured dirs extend lower configured dirs or library, and
@@ -506,7 +514,7 @@ library has no `extends`.
 ```jsonc
 {
   "id": "my-agent",            // required
-  "extends": "posthog",        // optional; implicit same-id if omitted
+  "extends": "code-reviewer",  // optional; implicit same-id if omitted
   "description": "…",          // replaces base description
   "skills": [ … ],             // replaces entire skills array
   "inputs": {                  // prompt-visible runtime inputs; union by key
@@ -572,7 +580,7 @@ Minimal local persona:
 ```json
 {
   "id": "my-reviewer",
-  "extends": "review",
+  "extends": "code-reviewer",
   "description": "Reviews this project with local conventions.",
   "systemPrompt": "Focus on this repository's API compatibility rules and summarize only blocking issues."
 }
@@ -580,17 +588,18 @@ Minimal local persona:
 
 ### Built-in persona
 
-Built-in personas live in the repo's `/personas` catalog and require full
-workload-router integration:
+Built-in personas live in the repo's `/personas` catalog, are reserved for
+required internal/system surface, and require workload-router integration:
 
 ```sh
 agentworkforce create --save-in-directory=library
 ```
 
 The persona maker receives `CREATE_MODE=built-in`, so it should write
-`personas/<id>.json`, update the intent list/catalog registration/routing
-profile/test fixture/README, regenerate `src/generated/personas.ts`, and run
-the repo check.
+`personas/<id>.json`, update the internal catalog registration/routing/tests/docs
+as needed, regenerate `src/generated/personas.ts`, and run the repo check.
+Optional generic or domain personas should be published through persona packs
+instead.
 
 ### Full persona file
 
@@ -827,18 +836,15 @@ Codex-backed tiers can set Codex launch policy inside `harnessSettings`:
 `--search`. Prefer `workspace-write` plus `workspaceWriteNetworkAccess` for
 package or registry discovery so filesystem writes stay sandboxed.
 
-### Example: PostHog with auto-approve
+### Example: narrowing inherited auto-approval
 
-The built-in `posthog` persona declares `permissions.allow = ["mcp__posthog"]`
-so that once you've authenticated (either by passing `POSTHOG_API_KEY` up
-front or via Claude's OAuth flow), subsequent analytics tool calls don't
-prompt. To narrow the auto-approval to read-only tools, override in a local
-persona:
+If an installed lower-layer persona declares broad permissions, a local override
+can add narrower tool patterns for project workflows:
 
 ```json
 {
-  "id": "my-posthog",
-  "extends": "posthog",
+  "id": "my-analytics",
+  "extends": "analytics-reader",
   "permissions": {
     "allow": [
       "mcp__posthog__projects-get",
@@ -849,10 +855,10 @@ persona:
 }
 ```
 
-Because `allow` is a union, the base's `"mcp__posthog"` would still be in the
-merged list. If you want to *shrink* the allow list in a local override,
-include a comment explaining why — there's currently no "replace" knob, only
-union. (File an issue if you need one.)
+Because `allow` is a union, any broad allow pattern from the base persona would
+still be in the merged list. If you need to shrink an allow list, create a
+standalone local persona or update the lower-layer pack persona; overlays only
+append.
 
 ## MCP servers
 
@@ -941,12 +947,14 @@ cascade/extends merge and before prompt input substitution.
 Opt out for one launch:
 
 ```sh
+agentworkforce install @agentworkforce/personas-core --persona code-reviewer
 agentworkforce agent --no-launch-metadata code-reviewer@best
 ```
 
 Opt out through the environment:
 
 ```sh
+agentworkforce install @agentworkforce/personas-core --persona code-reviewer
 AGENTWORKFORCE_LAUNCH_METADATA=0 agentworkforce agent code-reviewer@best
 ```
 
@@ -994,6 +1002,7 @@ Pass `--install-in-repo` to fall back to the legacy behavior (skills land in
 the repo's `.claude/skills/` directory, cleaned on exit):
 
 ```sh
+agentworkforce install @agentworkforce/personas-core --persona code-reviewer
 agentworkforce agent --install-in-repo code-reviewer@best
 ```
 
@@ -1097,11 +1106,11 @@ agentworkforce CLI just wires the paths and passes the persona's argv.
 ### Example
 
 ```sh
-# Interactive PostHog session with the repo's CLAUDE.md, .claude/, and
+# Interactive persona session with the repo's CLAUDE.md, .claude/, and
 # .mcp.json hidden — session sees the persona's staged skills plus your
 # user-level ~/.claude/CLAUDE.md, nothing else from this repo.
-export POSTHOG_API_KEY=phx_…
-agentworkforce agent posthog@best
+agentworkforce install @agentworkforce/personas-core --persona code-reviewer
+agentworkforce agent code-reviewer@best
 ```
 
 On exit: mount is synced back to the real repo, then torn down; skill
@@ -1109,9 +1118,7 @@ stage dir is cleaned up by the existing `rm -rf` cleanup command.
 
 ## Selecting a harness per tier
 
-A persona's three tiers can use different harnesses. The built-in
-`npm-provenance-publisher` has `best` on codex and `best-value` on opencode,
-for example.
+A persona's three tiers can use different harnesses.
 
 If a persona uses MCP, keep every tier on `claude` — only the claude harness
 wires MCP at spawn time today.

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/cli.js

@@ -5,7 +5,7 @@ import { appendFileSync, existsSync, mkdirSync, readFileSync, readSync, rmSync,
 import { constants, homedir } from 'node:os';
 import { dirname, isAbsolute, join, resolve as resolvePath } from 'node:path';
 import { pathToFileURL } from 'node:url';
-import { HARNESS_VALUES, PERSONA_TAGS, PERSONA_TIERS, personaCatalog, resolveSidecar, routingProfiles, useSelection } from '@agentworkforce/workload-router';
+import { HARNESS_VALUES, PERSONA_TAGS, PERSONA_TIERS, listBuiltInPersonas, personaCatalog, resolveSidecar, routingProfiles, useSelection } from '@agentworkforce/workload-router';
 import { buildInteractiveSpec, detectHarnesses, formatDropWarnings, MissingPersonaInputError, renderPersonaInputs, resolvePersonaInputs, resolveMcpServersLenient, resolveStringMapLenient } from '@agentworkforce/harness-kit';
 import { launchOnMount, readAgentDotfiles } from '@relayfile/local-mount';
 import ora from 'ora';
@@ -117,11 +117,11 @@ configured persona dir is ~/.agentworkforce/workforce/personas.
 Examples:
   agentworkforce create
   agentworkforce create --save-in-directory=user
-  agentworkforce agent npm-provenance-publisher@best
-  agentworkforce agent my-posthog@best
-  agentworkforce agent review@best-value
+  agentworkforce install @agentworkforce/personas-core --persona code-reviewer
+  agentworkforce agent code-reviewer@best-value
+  agentworkforce agent my-reviewer@best
   agentworkforce list
-  agentworkforce show posthog
+  agentworkforce show code-reviewer
   agentworkforce install @agentrelay/personas --persona relay-orchestrator
   agentworkforce install ./local-personas --overwrite
   agentworkforce sources list
@@ -159,7 +159,7 @@ function collectKnownPersonas() {
             description: spec.description
         });
     }
-    for (const spec of Object.values(personaCatalog)) {
+    for (const spec of listBuiltInPersonas()) {
         if (byName.has(spec.id))
             continue;
         byName.set(spec.id, {
@@ -196,11 +196,14 @@ function resolveSpec(key) {
     const catalogAsIntent = personaCatalog[key];
     if (catalogAsIntent)
         return catalogAsIntent;
-    const byId = Object.values(personaCatalog).find((p) => p.id === key);
+    const byId = listBuiltInPersonas().find((p) => p.id === key);
     if (byId)
         return byId;
+    const packHint = 'Optional first-party personas are installed from packs, for example:\n' +
+        '  agentworkforce install @agentworkforce/personas-core\n' +
+        '  agentworkforce install @agentrelay/personas';
     return {
-        error: `Unknown persona "${key}". Known personas:\n${formatNameDescriptionTable(collectKnownPersonas())}`
+        error: `Unknown persona "${key}". Known personas:\n${formatNameDescriptionTable(collectKnownPersonas())}\n\n${packHint}`
     };
 }
 function parseSelector(sel) {
@@ -748,7 +751,7 @@ async function runInteractive(selection, options) {
     const resolvedMcp = mcpResolution.servers;
     // In session mode the install command is never `:` — it at minimum runs
     // the plugin scaffold (mkdir + manifest + symlink) so `--plugin-dir` has a
-    // valid target even for skill-less personas like posthog. Gate on the
+    // valid target even for skill-less local personas. Gate on the
     // command string rather than `installs.length` so we don't skip that.
     const skillIds = install.plan.installs.map((i) => i.skillId).join(', ');
     const installLabel = install.plan.installs.length === 0
@@ -1374,7 +1377,7 @@ function collectPersonaRows() {
         pushSpec(spec, local.sources.get(id) ?? 'library');
         seen.add(id);
     }
-    for (const spec of Object.values(personaCatalog)) {
+    for (const spec of listBuiltInPersonas()) {
         if (seen.has(spec.id))
             continue;
         pushSpec(spec, 'library');
@@ -1588,7 +1591,7 @@ function resolveShowTarget(selector, all) {
             spec = byIntent;
         }
         else {
-            const byId = Object.values(personaCatalog).find((p) => p.id === key);
+            const byId = listBuiltInPersonas().find((p) => p.id === key);
             if (byId)
                 spec = byId;
         }
@@ -1858,7 +1861,7 @@ async function runAgentSelector(selector, flags, inputValues) {
  */
 export function buildPickCandidates() {
     const byId = new Map();
-    for (const spec of Object.values(personaCatalog)) {
+    for (const spec of listBuiltInPersonas()) {
         byId.set(spec.id, {
             id: spec.id,
             intent: spec.intent,