@llblab/pi-actors 0.45.1 → 0.46.0

package/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/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/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/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/{dist/recipes/pipeline-architect-coordinator.json → 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/{dist/recipes/pipeline-checkpoint-continuation.json → 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/{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/{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",

package/{recipes/pipeline-quorum-review.json → skills/swarm/recipes/quorum-review.json}

@@ -1,10 +1,10 @@
 {
   "async": true,
   "imports": {
-    "subagent": "subagent-prompt.json",
-    "merger": "subagent-merge.json",
-    "judge": "subagent-judge.json",
-    "normalizer": "subagent-normalize.json"
+    "subagent": "swarm/subagent-prompt",
+    "merger": "swarm/subagent-merge",
+    "judge": "swarm/subagent-judge",
+    "normalizer": "swarm/subagent-normalize"
   },
   "args": [
     "prompt:string",

package/{dist/recipes/pipeline-research-synthesis.json → skills/swarm/recipes/research-synthesis.json}

@@ -1,12 +1,12 @@
 {
   "async": true,
   "imports": {
-    "planner": "subagent-plan.json",
-    "evidence": "subagent-evidence-map.json",
-    "contradictions": "subagent-contradiction-map.json",
-    "verifier": "subagent-verify.json",
-    "merger": "subagent-merge.json",
-    "normalizer": "subagent-normalize.json"
+    "planner": "swarm/subagent-plan",
+    "evidence": "swarm/subagent-evidence-map",
+    "contradictions": "swarm/subagent-contradiction-map",
+    "verifier": "swarm/subagent-verify",
+    "merger": "swarm/subagent-merge",
+    "normalizer": "swarm/subagent-normalize"
   },
   "args": [
     "question:string",

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

@@ -1,7 +1,7 @@
 {
   "async": true,
   "imports": {
-    "coordinator": "subagent-review-coordinator.json"
+    "coordinator": "swarm/subagent-review-coordinator"
   },
   "args": [
     "scope:string",

package/{dist/recipes/subagents-prompts.json → skills/swarm/recipes/subagent-prompts.json}

@@ -1,7 +1,7 @@
 {
   "async": true,
   "imports": {
-    "subagent": "subagent-prompt.json"
+    "subagent": "swarm/subagent-prompt"
   },
   "args": [
     "prompts:array",

package/{dist → skills/swarm}/recipes/subagent-quorum.json

@@ -1,7 +1,7 @@
 {
   "async": true,
   "imports": {
-    "subagent": "subagent-prompt.json"
+    "subagent": "swarm/subagent-prompt"
   },
   "args": [
     "prompt:string",

package/{recipes → skills/swarm/recipes}/subagent-review-coordinator.json

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

package/dist/recipes/utility-changelog-section.json

@@ -1,13 +0,0 @@
-{
-  "args": [
-    "repo:path",
-    "file:path",
-    "version:string"
-  ],
-  "defaults": {
-    "repo": "~/.pi/agent/extensions/pi-actors",
-    "file": "CHANGELOG.md",
-    "version": "0.7.1"
-  },
-  "template": "{repo}/scripts/recipe-utils.mjs changelog-section {file} {version}"
-}

package/dist/recipes/utility-package-summary.json

@@ -1,11 +0,0 @@
-{
-  "args": [
-    "package_json:path",
-    "repo:path"
-  ],
-  "defaults": {
-    "package_json": "package.json",
-    "repo": "~/.pi/agent/extensions/pi-actors"
-  },
-  "template": "{repo}/scripts/recipe-utils.mjs package-summary {package_json}"
-}

package/dist/recipes/utility-run-summary.json

@@ -1,11 +0,0 @@
-{
-  "args": [
-    "repo:path",
-    "state_root:path"
-  ],
-  "defaults": {
-    "repo": "~/.pi/agent/extensions/pi-actors",
-    "state_root": "~/.pi/agent/tmp/pi-actors/runs"
-  },
-  "template": "{repo}/scripts/recipe-utils.mjs run-summary {state_root}"
-}

package/dist/recipes/utility-skill-summary.json

@@ -1,13 +0,0 @@
-{
-  "args": [
-    "skill:path",
-    "package_json:path",
-    "repo:path"
-  ],
-  "defaults": {
-    "skill": "skills/actors/SKILL.md",
-    "package_json": "package.json",
-    "repo": "~/.pi/agent/extensions/pi-actors"
-  },
-  "template": "{repo}/scripts/recipe-utils.mjs skill-summary {skill} {package_json}"
-}

package/dist/recipes/utility-validate-recipe.json

@@ -1,13 +0,0 @@
-{
-  "args": [
-    "target:path",
-    "all:bool",
-    "repo:path"
-  ],
-  "defaults": {
-    "target": "recipes",
-    "all": "true",
-    "repo": "~/.pi/agent/extensions/pi-actors"
-  },
-  "template": "{repo}/scripts/validate-recipe.mjs {target} {all?--all:}"
-}

package/dist/scripts/executable-block-style.d.mts

@@ -1 +0,0 @@
-export function executableBlockBlankLines(source: string): number[];

package/dist/scripts/executable-block-style.mjs

@@ -1,73 +0,0 @@
-/** Detect blank lines inside executable JavaScript and TypeScript blocks. */
-
-export function executableBlockBlankLines(source) {
-  const lines = source.split(/\r?\n/u);
-  const blanks = [];
-  const stack = [];
-  let blockComment = false;
-  let currentExecutableDepth = 0;
-  let previousCode = "";
-  let quote;
-  for (let lineIndex = 0; lineIndex < lines.length; lineIndex += 1) {
-    const line = lines[lineIndex];
-    if (
-      /^\s*$/u.test(line) &&
-      currentExecutableDepth > 0 &&
-      quote !== "`"
-    )
-      blanks.push(lineIndex + 1);
-    let code = "";
-    let regularExpression = false;
-    for (let index = 0; index < line.length; index += 1) {
-      const char = line[index];
-      const next = line[index + 1];
-      if (blockComment) {
-        if (char === "*" && next === "/") {
-          blockComment = false;
-          index += 1;
-        }
-        continue;
-      }
-      if (quote) {
-        if (char === "\\") index += 1;
-        else if (char === quote) quote = undefined;
-        continue;
-      }
-      if (regularExpression) {
-        if (char === "\\") index += 1;
-        else if (char === "/") regularExpression = false;
-        continue;
-      }
-      if (char === "/" && next === "*") {
-        blockComment = true;
-        index += 1;
-        continue;
-      }
-      if (char === "/" && next === "/") break;
-      if (
-        char === "/" &&
-        /^(?:|.*(?:[=(,:;!&|?{}]|\b(?:return|case|throw)))\s*$/u.test(code)
-      ) {
-        regularExpression = true;
-        continue;
-      }
-      if (char === '"' || char === "'" || char === "`") {
-        quote = char;
-        continue;
-      }
-      if (char === "{") {
-        const prefix = code.trimEnd() || previousCode;
-        const executable =
-          /\)\s*$|=>\s*$|\b(?:else|try|finally|do)\s*$/u.test(prefix);
-        stack.push(executable);
-        if (executable) currentExecutableDepth += 1;
-      } else if (char === "}") {
-        if (stack.pop()) currentExecutableDepth -= 1;
-      }
-      code += char;
-    }
-    if (quote !== "`") quote = undefined;
-    if (code.trim()) previousCode = code.trim();
-  }
-  return blanks;
-}