@llblab/pi-actors 0.45.1 → 0.46.0

package/{recipes/pipeline-artifact-bundle.json → dist/skills/artifacts/recipes/bundle.json}

@@ -1,10 +1,10 @@
 {
   "async": true,
   "imports": {
-    "artifactWrite": "pipeline-artifact-write.json",
-    "manifest": "utility-artifact-manifest.json",
-    "manifestWrite": "utility-artifact-write.json",
-    "validation": "utility-validation-wrapper.json"
+    "artifactWrite": "artifacts/write",
+    "manifest": "artifacts/manifest",
+    "manifestWrite": "artifacts/file-write",
+    "validation": "actors/command-validate"
   },
   "args": [
     "input:string",

package/dist/{recipes/utility-artifact-write.json → skills/artifacts/recipes/file-write.json}

@@ -1,16 +1,14 @@
 {
   "async": false,
   "args": [
-    "repo:path",
     "artifact_path:path",
     "mode:enum(create,overwrite,append)"
   ],
   "defaults": {
-    "repo": "~/.pi/agent/extensions/pi-actors",
     "mode": "create"
   },
   "template": {
-    "template": "{repo}/scripts/recipe-utils.mjs artifact-write {artifact_path} {mode}",
+    "template": "{skill_dir}/scripts/artifact-utils.mjs write {artifact_path} {mode}",
     "output": "stdout"
   }
 }

package/dist/{recipes/utility-artifact-manifest.json → skills/artifacts/recipes/manifest.json}

@@ -1,16 +1,14 @@
 {
   "args": [
-    "repo:path",
     "artifact_path:path",
     "title:string",
     "status:enum(draft,ready,blocked,accepted)",
     "summary:string"
   ],
   "defaults": {
-    "repo": "~/.pi/agent/extensions/pi-actors",
     "title": "Artifact",
     "status": "draft",
     "summary": "Machine-readable artifact manifest."
   },
-  "template": "{repo}/scripts/recipe-utils.mjs artifact-manifest {artifact_path} {title} {status} {summary}"
+  "template": "{skill_dir}/scripts/artifact-utils.mjs manifest {artifact_path} {title} {status} {summary}"
 }

package/{recipes/pipeline-artifact-report.json → dist/skills/artifacts/recipes/report.json}

@@ -1,8 +1,8 @@
 {
   "async": true,
   "imports": {
-    "normalizer": "subagent-normalize.json",
-    "artifact": "subagent-artifact.json"
+    "normalizer": "swarm/subagent-normalize",
+    "artifact": "swarm/subagent-artifact"
   },
   "args": [
     "input:string",

package/dist/{recipes/pipeline-artifact-write.json → skills/artifacts/recipes/write.json}

@@ -1,9 +1,9 @@
 {
   "async": true,
   "imports": {
-    "normalizer": "subagent-normalize.json",
-    "artifact": "subagent-artifact.json",
-    "writer": "utility-artifact-write.json"
+    "normalizer": "swarm/subagent-normalize",
+    "artifact": "swarm/subagent-artifact",
+    "writer": "artifacts/file-write"
   },
   "args": [
     "input:string",

package/dist/skills/artifacts/scripts/artifact-utils.mjs

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+
+/** Artifact-owned deterministic manifest and write helpers. */
+
+import {
+  appendFileSync,
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  statSync,
+  writeFileSync,
+} from "node:fs";
+import { dirname, resolve } from "node:path";
+
+function fail(message) {
+  console.error(message);
+  process.exit(1);
+}
+
+function pathOf(value) {
+  return resolve(String(value).replace(/^~(?=\/|$)/, process.env.HOME ?? "~"));
+}
+
+function manifest(pathValue, title = "Artifact", status = "draft", summary = "") {
+  const path = pathOf(pathValue);
+  const exists = existsSync(path);
+  const stat = exists ? statSync(path) : undefined;
+  console.log(JSON.stringify({
+    title,
+    status,
+    path,
+    exists,
+    bytes: stat?.size ?? 0,
+    modified: stat?.mtime?.toISOString?.() ?? null,
+    summary,
+  }, null, 2));
+}
+
+function write(pathValue, mode = "create") {
+  const path = pathOf(pathValue);
+  if (!["create", "overwrite", "append"].includes(mode))
+    fail(`Invalid artifact write mode: ${mode}`);
+  if (mode === "create" && existsSync(path)) fail(`Artifact already exists: ${path}`);
+  const content = readFileSync(0, "utf8");
+  mkdirSync(dirname(path), { recursive: true });
+  if (mode === "append") appendFileSync(path, content);
+  else writeFileSync(path, content, "utf8");
+  console.log(JSON.stringify({
+    path,
+    mode,
+    bytes: statSync(path).size,
+    written: true,
+  }, null, 2));
+}
+
+const [command, ...args] = process.argv.slice(2);
+try {
+  if (command === "manifest") manifest(args[0] ?? "artifact.md", args[1], args[2], args[3]);
+  else if (command === "write") write(args[0] ?? "artifact.md", args[1]);
+  else fail(`Unknown artifact command: ${command ?? ""}`);
+} catch (error) {
+  fail(error instanceof Error ? error.message : String(error));
+}

package/dist/skills/media/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: media
+description: Local media discovery, playlist construction, and controllable playback capabilities.
+---
+
+# Media
+
+Own reusable local media workflows and services.
+
+## Scope
+
+- Scan caller-selected media sources and build bounded playlists.
+- Run controllable playback when the local player implements declared actions.
+- Emit canonical Trace and consume canonical Control without inventing media-specific runtime nouns.
+
+This Skill does not own the Run kernel, user media, transport delivery, or general artifact policy. Its Recipe identity is `media/<filename stem>`; Recipe files have no top-level `name`. Helper-backed Recipes locate only co-located scripts through `{skill_dir}`, and cross-capability composition uses exact `<skill>/<recipe>` references.

package/dist/{recipes/pipeline-media-library.json → skills/media/recipes/library.json}

@@ -1,8 +1,8 @@
 {
   "async": true,
   "imports": {
-    "playlist": "utility-playlist-build.json",
-    "artifact": "pipeline-artifact-report.json"
+    "playlist": "media/playlist-build",
+    "artifact": "artifacts/report"
   },
   "args": [
     "source_dir:path",

package/{recipes/music-player.json → dist/skills/media/recipes/player.json}

@@ -1,7 +1,6 @@
 {
   "async": true,
   "args": [
-    "repo:path",
     "command:enum(play,pause,resume,toggle,next,previous,stop,status)",
     "source:string",
     "loop:bool",
@@ -10,7 +9,6 @@
     "state_dir:path"
   ],
   "defaults": {
-    "repo": "~/.pi/agent/extensions/pi-actors",
     "command": "play",
     "loop": "true",
     "volume": "70",
@@ -26,5 +24,5 @@
     "stop",
     "status"
   ],
-  "template": "{repo}/scripts/music-player.mjs {command} {source} {loop} {volume} {player} {state_dir}"
+  "template": "{skill_dir}/scripts/music-player.mjs {command} {source} {loop} {volume} {player} {state_dir}"
 }

package/dist/{recipes/utility-playlist-build.json → skills/media/recipes/playlist-build.json}

@@ -1,17 +1,15 @@
 {
   "args": [
-    "repo:path",
     "source_dir:path",
     "extensions:string",
     "max_depth:int",
     "output_mode:enum(paths,m3u,inline)"
   ],
   "defaults": {
-    "repo": "~/.pi/agent/extensions/pi-actors",
     "source_dir": "~/Music",
     "extensions": ".mp3,.ogg,.wav,.flac,.m4a",
     "max_depth": "2",
     "output_mode": "paths"
   },
-  "template": "{repo}/scripts/recipe-utils.mjs playlist {source_dir} {extensions} {max_depth} {output_mode}"
+  "template": "{skill_dir}/scripts/media-utils.mjs playlist {source_dir} {extensions} {max_depth} {output_mode}"
 }

package/dist/skills/media/scripts/media-utils.mjs

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+
+/** Media-owned playlist construction helper. */
+
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { extname, join, resolve } from "node:path";
+
+function fail(message) {
+  console.error(message);
+  process.exit(1);
+}
+
+function walkFiles(dir, maxDepth = 2, depth = 0, out = []) {
+  if (depth > maxDepth || !existsSync(dir)) return out;
+  for (const entry of readdirSync(dir)) {
+    const path = join(dir, entry);
+    const stat = statSync(path);
+    if (stat.isDirectory()) walkFiles(path, maxDepth, depth + 1, out);
+    else if (stat.isFile()) out.push(path);
+  }
+  return out;
+}
+
+function playlist(
+  sourceValue,
+  extensionsValue = ".mp3,.ogg,.wav,.flac,.m4a",
+  maxDepthValue = "2",
+  outputMode = "paths",
+) {
+  const source = resolve(String(sourceValue).replace(/^~(?=\/|$)/, process.env.HOME ?? "~"));
+  const maxDepth = Number.parseInt(maxDepthValue, 10);
+  const extensions = new Set(extensionsValue.split(",").map((item) => item.trim().toLowerCase()).filter(Boolean));
+  const files = walkFiles(source, Number.isFinite(maxDepth) ? maxDepth : 2)
+    .filter((file) => extensions.has(extname(file).toLowerCase()))
+    .sort((a, b) => a.localeCompare(b));
+  if (outputMode === "m3u") console.log(["#EXTM3U", ...files].join("\n"));
+  else if (outputMode === "inline") console.log(files.join("|"));
+  else console.log(files.join("\n"));
+}
+
+const [command, ...args] = process.argv.slice(2);
+try {
+  if (command === "playlist") playlist(args[0] ?? "~/Music", args[1], args[2], args[3]);
+  else fail(`Unknown media command: ${command ?? ""}`);
+} catch (error) {
+  fail(error instanceof Error ? error.message : String(error));
+}

package/dist/{scripts → skills/media/scripts}/music-player.mjs

@@ -39,14 +39,20 @@ import {
 import { fileURLToPath, pathToFileURL } from "node:url";
 
 function packageRoot() {
-  return dirname(dirname(fileURLToPath(import.meta.url)));
+  return dirname(dirname(dirname(dirname(fileURLToPath(import.meta.url)))));
 }
 
 async function importRuntimeModule(name) {
   const root = packageRoot();
-  const compiled = join(root, "dist", "lib", `${name}.js`);
+  const compiled = join(root, "lib", `${name}.js`);
+  const installedCompiled = join(root, "dist", "lib", `${name}.js`);
   const source = join(root, "lib", `${name}.ts`);
-  return await import(pathToFileURL(existsSync(compiled) ? compiled : source).href);
+  const module = existsSync(compiled)
+    ? compiled
+    : root.includes(`${delimiter}node_modules${delimiter}`) && existsSync(installedCompiled)
+      ? installedCompiled
+      : source;
+  return await import(pathToFileURL(module).href);
 }
 
 const { appendRunControlInStateDir, claimRunControlByIdInStateDir,

package/dist/skills/project-work/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: project-work
+description: Repository inspection, documentation maintenance, release preparation, and project health workflows.
+---
+
+# Project Work
+
+Own reusable workflows for inspecting and maintaining software projects.
+
+## Scope
+
+- Summarize Git, package, Skill, changelog, and documentation state.
+- Compose repository health, documentation maintenance, and release-readiness evidence.
+- Keep project-level orchestration separate from lower-level artifact and actor utilities.
+
+This Skill does not own the Run kernel, publication authority, multi-agent methodology, or artifact-writing mechanics. Its Recipe identity is `project-work/<filename stem>`; Recipe files have no top-level `name`. It composes other capabilities only through exact `<skill>/<recipe>` references and keeps project-specific helper behavior under its own `scripts/` directory.

package/dist/skills/project-work/recipes/changelog-section.json

@@ -0,0 +1,11 @@
+{
+  "args": [
+    "file:path",
+    "version:string"
+  ],
+  "defaults": {
+    "file": "CHANGELOG.md",
+    "version": "0.7.1"
+  },
+  "template": "{skill_dir}/scripts/project-utils.mjs changelog-section {file} {version}"
+}

package/{recipes/pipeline-docs-maintenance.json → dist/skills/project-work/recipes/docs-maintenance.json}

@@ -1,10 +1,10 @@
 {
   "async": true,
   "imports": {
-    "docs_index": "utility-markdown-index.json",
-    "reviewer": "subagent-review.json",
-    "planner": "subagent-plan.json",
-    "artifact": "pipeline-artifact-report.json"
+    "docs_index": "project-work/markdown-index",
+    "reviewer": "swarm/subagent-review",
+    "planner": "swarm/subagent-plan",
+    "artifact": "artifacts/report"
   },
   "args": [
     "docs_dir:path",

package/dist/skills/project-work/recipes/package-summary.json

@@ -0,0 +1,9 @@
+{
+  "args": [
+    "package_json:path"
+  ],
+  "defaults": {
+    "package_json": "package.json"
+  },
+  "template": "{skill_dir}/scripts/project-utils.mjs package-summary {package_json}"
+}

package/{recipes/pipeline-release-readiness.json → dist/skills/project-work/recipes/release-readiness.json}

@@ -1,12 +1,12 @@
 {
   "async": true,
   "imports": {
-    "changelog": "utility-changelog-section.json",
-    "package": "utility-package-summary.json",
-    "skill": "utility-skill-summary.json",
-    "validation": "utility-validation-wrapper.json",
-    "review": "subagent-review-coordinator.json",
-    "artifact": "pipeline-artifact-report.json"
+    "changelog": "project-work/changelog-section",
+    "package": "project-work/package-summary",
+    "skill": "project-work/skill-summary",
+    "validation": "actors/command-validate",
+    "review": "swarm/subagent-review-coordinator",
+    "artifact": "artifacts/report"
   },
   "args": [
     "scope:path",

package/dist/{recipes/pipeline-release-summary.json → skills/project-work/recipes/release-summary.json}

@@ -1,11 +1,11 @@
 {
   "async": true,
   "imports": {
-    "changelog": "utility-changelog-section.json",
-    "package": "utility-package-summary.json",
-    "skill": "utility-skill-summary.json",
-    "validation": "utility-validation-wrapper.json",
-    "artifact": "pipeline-artifact-report.json"
+    "changelog": "project-work/changelog-section",
+    "package": "project-work/package-summary",
+    "skill": "project-work/skill-summary",
+    "validation": "actors/command-validate",
+    "artifact": "artifacts/report"
   },
   "args": [
     "scope:path",

package/{recipes/pipeline-repo-health.json → dist/skills/project-work/recipes/repo-health.json}

@@ -1,12 +1,12 @@
 {
   "async": true,
   "imports": {
-    "git_status": "utility-git-status.json",
-    "git_log": "utility-git-log.json",
-    "docs_index": "utility-markdown-index.json",
-    "validation": "utility-validation-wrapper.json",
-    "normalizer": "subagent-normalize.json",
-    "artifact": "pipeline-artifact-report.json"
+    "git_status": "project-work/git-status",
+    "git_log": "project-work/git-log",
+    "docs_index": "project-work/markdown-index",
+    "validation": "actors/command-validate",
+    "normalizer": "swarm/subagent-normalize",
+    "artifact": "artifacts/report"
   },
   "args": [
     "repo:path",

package/{recipes/pipeline-async-run-ops.json → dist/skills/project-work/recipes/run-ops.json}

@@ -1,9 +1,9 @@
 {
   "async": true,
   "imports": {
-    "snapshot": "utility-run-ops-snapshot.json",
-    "normalizer": "subagent-normalize.json",
-    "artifact": "pipeline-artifact-report.json"
+    "snapshot": "actors/run-ops-snapshot",
+    "normalizer": "swarm/subagent-normalize",
+    "artifact": "artifacts/report"
   },
   "args": [
     "state_root:path",

package/dist/skills/project-work/recipes/skill-summary.json

@@ -0,0 +1,11 @@
+{
+  "args": [
+    "skill:path",
+    "package_json:path"
+  ],
+  "defaults": {
+    "skill": "skills/actors/SKILL.md",
+    "package_json": "package.json"
+  },
+  "template": "{skill_dir}/scripts/project-utils.mjs skill-summary {skill} {package_json}"
+}

package/dist/skills/project-work/scripts/project-utils.mjs

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+
+/** Project-work metadata and changelog helpers. */
+
+import { existsSync, readFileSync } from "node:fs";
+import { resolve } from "node:path";
+
+function fail(message) {
+  console.error(message);
+  process.exit(1);
+}
+
+function pathOf(value) {
+  return resolve(String(value).replace(/^~(?=\/|$)/, process.env.HOME ?? "~"));
+}
+
+function readJson(file) {
+  if (!existsSync(file)) return undefined;
+  try {
+    return JSON.parse(readFileSync(file, "utf8"));
+  } catch {
+    return undefined;
+  }
+}
+
+function packageSummary(fileValue = "package.json") {
+  const pkg = readJson(pathOf(fileValue));
+  if (!pkg) fail(`Package JSON not found or invalid: ${fileValue}`);
+  const dependencies = Object.keys(pkg.dependencies ?? {}).sort();
+  const devDependencies = Object.keys(pkg.devDependencies ?? {}).sort();
+  console.log(JSON.stringify({
+    name: pkg.name ?? "",
+    version: pkg.version ?? "",
+    type: pkg.type ?? "",
+    private: Boolean(pkg.private),
+    packageManager: pkg.packageManager ?? "",
+    files: Array.isArray(pkg.files) ? pkg.files : [],
+    bin: pkg.bin ?? null,
+    main: pkg.main ?? "",
+    exports: pkg.exports ?? null,
+    scripts: Object.keys(pkg.scripts ?? {}).sort(),
+    dependencyCount: dependencies.length,
+    devDependencyCount: devDependencies.length,
+    dependencies,
+    devDependencies,
+  }, null, 2));
+}
+
+function skillSummary(skillValue, packageValue = "package.json") {
+  const content = readFileSync(pathOf(skillValue), "utf8");
+  const pkg = readJson(pathOf(packageValue)) ?? {};
+  const frontmatter = content.match(/^---\r?\n([\s\S]*?)\r?\n---/)?.[1] ?? "";
+  const fields = Object.fromEntries(frontmatter.split(/\r?\n/).flatMap((line) => {
+    const match = line.match(/^([A-Za-z_][\w-]*):\s*(.*)$/);
+    return match ? [[match[1], match[2].trim()]] : [];
+  }));
+  const version = fields.version ?? frontmatter.match(/^\s+version:\s*([^\n]+)$/m)?.[1]?.trim() ?? "";
+  const body = content.replace(/^---\r?\n[\s\S]*?\r?\n---\r?\n?/, "");
+  console.log(JSON.stringify({
+    path: skillValue,
+    name: fields.name ?? "",
+    description: fields.description ?? "",
+    version,
+    packageVersion: pkg.version ?? "",
+    versionMatchesPackage: version === pkg.version,
+    frontmatterExtraColonLines: frontmatter.split(/\r?\n/).filter((line) =>
+      /^\w+:\s*\S/.test(line) && (line.match(/:/g) ?? []).length > 1),
+    bodyLineCount: body.split(/\r?\n/).length,
+    headings: body.split(/\r?\n/).filter((line) => /^#{1,6}\s/.test(line)),
+  }, null, 2));
+}
+
+function changelogSection(fileValue, version) {
+  const lines = readFileSync(pathOf(fileValue), "utf8").split(/\r?\n/);
+  const start = lines.findIndex((line) => line.startsWith("## ") && line.includes(version));
+  if (start < 0) fail(`Version section not found: ${version}`);
+  const next = lines.findIndex((line, index) => index > start && line.startsWith("## "));
+  console.log(lines.slice(start, next < 0 ? lines.length : next).join("\n").trimEnd());
+}
+
+const [command, ...args] = process.argv.slice(2);
+try {
+  if (command === "package-summary") packageSummary(args[0]);
+  else if (command === "skill-summary") skillSummary(args[0], args[1]);
+  else if (command === "changelog-section") changelogSection(args[0] ?? "CHANGELOG.md", args[1] ?? "Unreleased");
+  else fail(`Unknown project command: ${command ?? ""}`);
+} catch (error) {
+  fail(error instanceof Error ? error.message : String(error));
+}

package/dist/skills/recipe-memory/SKILL.md

@@ -0,0 +1,16 @@
+---
+name: recipe-memory
+description: Package-owned structural review components for safe persistent Recipe capability memory.
+---
+
+# Recipe Memory
+
+Own the executable reviewer components used by automatic draft and active-tool Recipe evolution.
+
+## Scope
+
+- Review value-free structural projections rather than executable content or machine-local paths.
+- Return bounded decisions for deterministic package-owned executors.
+- Remain package-owned so user Recipes cannot shadow or redirect automatic review.
+
+This Skill does not own registry mutation, CAS, journaling, quarantine, lineage, retry, reset, or safe-boundary activation. Those remain Run-kernel and registry responsibilities. Its direct Recipe identities are `recipe-memory/<filename stem>`; Recipe files have no top-level `name`. They are internal components, never automatic user tools.

package/dist/skills/swarm/SKILL.md

@@ -9,7 +9,7 @@ Subagent orchestration: delegated review, quorum consensus, scoped locks, clean-
 
 ## Purpose
 
-Run subagents safely and predictably through reusable orchestration contracts.
+Run subagents safely and predictably through reusable orchestration contracts. Skill Recipe identity is `<active Skill name>/<Recipe filename stem>`; Recipe files have no top-level `name`. Components are direct files under `recipes/` and use exact `swarm/<recipe>` identities, including `swarm/lens-review`, `swarm/quorum-review`, `swarm/research-synthesis`, and `swarm/development-tasking`; they remain components rather than automatic tools.
 
 Activation rule: load this skill before launching multiple independent actors or subagents, even when the work is creative artifact generation rather than code review. The coordinator owns decomposition, disjoint scopes, launch correctness, result integration, and final validation; participants may choose local content or implementation details independently inside their assigned boundaries.
 
@@ -31,7 +31,7 @@ Maintain this skill as a living orchestration standard. When real swarm work exp
 - `Lens`: A deliberately narrow cognitive role assigned to one subagent, such as security, tests, architecture, economics, or operator UX.
 - `Task Card`: A bounded implementation assignment with goal, allowed files, avoided files, expected output, and validation gates.
 - `Component Capability`: An abstract adapter operation such as launcher, reviewer, verifier, merger, quorum, checkpoint, follow-up, judge, or normalizer. Swarm may target these capabilities, but local adapters bind them to concrete tools, recipes, draft recipes, command templates, async runs, or services.
-- `Draft Recipe`: A reusable but non-registered recipe captured from a successful inline actor spawn under `~/.pi/agent/recipes/drafts`. It can be replayed by explicit file path and later promoted into the active tool recipe root after enough dogfood.
+- `Draft Recipe`: A reusable but non-registered recipe captured from a successful inline actor spawn under `~/.pi/agent/recipes/drafts`. It can be replayed by an explicit `.json` / `.md` path (relative entry paths use invocation `cwd`) and later promoted into the active tool Recipe root after enough dogfood.
 - `Coordinator Checkpoint`: A deliberate subagent pause where the subagent preserves its working context, sends a bounded question or status to the orchestrator, receives a coordinator reply, and continues in the same subagent context.
 - `Evidence Checkpoint`: A deliberate stop where a subagent records sources, assumptions, confidence, contradictions, or blocking evidence gaps before synthesis.
 - `Integrator`: The human or agent that merges isolated branches/worktrees into the shared target and owns conflict resolution.
@@ -162,7 +162,7 @@ Use [`references/development-swarm.md`](./references/development-swarm.md) for c
 
 Purpose: turn one result into many risk lenses and a decision-grade verdict.
 
-Use lens swarm for broad coverage, quorum for confidence on one critical judgement, or both for high-stakes releases. In adapters that expose current session model/thinking policy, default ordinary same-policy review swarms to that current policy and require explicit args only when intentionally varying models or thinking levels. Run a cheap model/tool preflight before launching expensive reviewer fanout; if it fails, use the `ACTOR_PREFLIGHT_FAILED` stage/model/error-class/prompt-file diagnostic to choose explicit override args instead of rerunning blindly. For packaged review swarms, tune `min_successful_reviewers`, `reviewer_concurrency`, `subagent_ttl_ms`, and `merge_policy` instead of manual reruns; preserve partial reports and label the outcome `complete`, `degraded`, or `insufficient_data`. The final report should separate consensus findings, minority findings, merger findings, risks, and recommended next actions.
+Use lens swarm for broad coverage, quorum for confidence on one critical judgement, or both for high-stakes releases. In adapters that expose current session model/thinking policy, default ordinary same-policy review swarms to that current policy and require explicit args only when intentionally varying models or thinking levels. Run a cheap model/tool preflight before launching expensive reviewer fanout; if it fails, use the `ACTOR_PREFLIGHT_FAILED` stage/model/error-class/prompt-file diagnostic to choose explicit override args instead of rerunning blindly. For Skill-owned review swarms, tune `min_successful_reviewers`, `reviewer_concurrency`, `subagent_ttl_ms`, and `merge_policy` instead of manual reruns; preserve partial reports and label the outcome `complete`, `degraded`, or `insufficient_data`. The final report should separate consensus findings, minority findings, merger findings, risks, and recommended next actions.
 
 A review swarm synthesis must not fabricate claims. Every final finding should trace to a reviewer note, checked artifact, command output, source, or explicit merger rationale. Devil's Advocate critical findings must be preserved or explicitly disproved with evidence.
 
@@ -345,7 +345,7 @@ Locks prevent subagents from interfering with shared scopes. Locks are optional
 
 ## Validation
 
-After changing Swarm adapter contracts or packaged documentation, validate the local distribution with whatever checks the host project provides. At minimum, review the text for boundary drift:
+After changing Swarm adapter contracts or Skill documentation, validate the local distribution with whatever checks the host project provides. At minimum, review the text for boundary drift:
 
 - no dependency on a specific extension, actor runtime, registry, recipe store, or CLI runner;
 - no bundled broad coordinator or lock runtime as portable Swarm core;

package/{recipes/pipeline-architect-coordinator.json → dist/skills/swarm/recipes/architect.json}

@@ -1,11 +1,11 @@
 {
   "async": true,
   "imports": {
-    "reviewer": "subagent-review.json",
-    "critic": "subagent-critic.json",
-    "verifier": "subagent-verify.json",
-    "merger": "subagent-merge.json",
-    "normalizer": "subagent-normalize.json"
+    "reviewer": "swarm/subagent-review",
+    "critic": "swarm/subagent-critic",
+    "verifier": "swarm/subagent-verify",
+    "merger": "swarm/subagent-merge",
+    "normalizer": "swarm/subagent-normalize"
   },
   "args": [
     "problem:string",

package/{recipes/pipeline-checkpoint-continuation.json → dist/skills/swarm/recipes/checkpoint-continuation.json}

@@ -1,9 +1,9 @@
 {
   "async": true,
   "imports": {
-    "checkpoint": "subagent-checkpoint.json",
-    "followup": "subagent-followup.json",
-    "normalizer": "subagent-normalize.json"
+    "checkpoint": "swarm/subagent-checkpoint",
+    "followup": "swarm/subagent-followup",
+    "normalizer": "swarm/subagent-normalize"
   },
   "args": [
     "state:string",

package/dist/{recipes/pipeline-development-tasking.json → skills/swarm/recipes/development-tasking.json}

@@ -1,10 +1,10 @@
 {
   "async": true,
   "imports": {
-    "planner": "subagent-plan.json",
-    "task_card": "subagent-task-card.json",
-    "critic": "subagent-critic.json",
-    "normalizer": "subagent-normalize.json"
+    "planner": "swarm/subagent-plan",
+    "task_card": "swarm/subagent-task-card",
+    "critic": "swarm/subagent-critic",
+    "normalizer": "swarm/subagent-normalize"
   },
   "args": [
     "goal:string",

package/dist/{recipes/lens-swarm.json → skills/swarm/recipes/lens-review.json}

@@ -2,7 +2,7 @@
   "description": "General-purpose multi-lens review swarm. Launches independent reviewers by lens, then verifies, merges, judges, and normalizes the result.",
   "async": true,
   "imports": {
-    "coordinator": "subagent-review-coordinator.json"
+    "coordinator": "swarm/subagent-review-coordinator"
   },
   "args": [
     "scope:string",