@llblab/pi-actors 0.22.5 → 0.24.0

package/dist/recipes/pipeline-development-tasking.json

@@ -0,0 +1,81 @@
+{
+  "async": true,
+  "imports": {
+    "planner": "subagent-plan.json",
+    "task_card": "subagent-task-card.json",
+    "critic": "subagent-critic.json",
+    "normalizer": "subagent-normalize.json"
+  },
+  "args": [
+    "goal:string",
+    "allowed:string",
+    "avoided:string",
+    "checks:string",
+    "constraints:string",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "allowed": "Caller must provide allowed files, directories, or logical scopes before implementation.",
+    "avoided": "Avoid unrelated files, public contracts, generated artifacts, and broad refactors unless explicitly allowed.",
+    "checks": "Smallest validation that proves the task card is complete.",
+    "constraints": "Split into bounded mutation zones and preserve integrator ownership of shared contracts.",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "task_card.completed",
+      "pipeline.completed",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": [
+    {
+      "name": "planner",
+      "values": {
+        "goal": "{goal}",
+        "scope": "Allowed: {allowed}. Avoided: {avoided}.",
+        "constraints": "{constraints}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "task_card",
+      "values": {
+        "goal": "Use plan from stdin to create one bounded implementation assignment for: {goal}",
+        "allowed": "{allowed}",
+        "avoided": "{avoided}",
+        "checks": "{checks}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "critic",
+      "values": {
+        "target": "Use generated plan and task card from stdin.",
+        "constraints": "{constraints}",
+        "risk_policy": "Find unsafe scope expansion, missing ownership, and weak validation gates.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "normalizer",
+      "values": {
+        "input": "Use plan, task card, and critique from stdin.",
+        "format": "Markdown sections: Task Card, Allowed Files, Avoid Files, Checks, Risks, Integrator Notes.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}

package/dist/recipes/pipeline-docs-maintenance.json

@@ -0,0 +1,80 @@
+{
+  "async": true,
+  "imports": {
+    "docs_index": "utility-markdown-index.json",
+    "reviewer": "subagent-review.json",
+    "planner": "subagent-plan.json",
+    "artifact": "pipeline-artifact-report.json"
+  },
+  "args": [
+    "docs_dir:path",
+    "readme:path",
+    "change_summary:string",
+    "artifact_path:path",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "docs_dir": "docs",
+    "readme": "README.md",
+    "change_summary": "Recent project changes require documentation/index consistency review.",
+    "artifact_path": "./docs-maintenance.md",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "docs.completed",
+      "artifact.prepared",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": [
+    {
+      "name": "docs_index",
+      "values": {
+        "directory": "{docs_dir}",
+        "title": "Documentation Index",
+        "include_pattern": "*.md"
+      }
+    },
+    {
+      "name": "reviewer",
+      "values": {
+        "scope": "README {readme}, docs directory {docs_dir}, and docs index output from stdin.",
+        "lens": "documentation maintenance and navigation consistency",
+        "instructions": "Review whether docs navigation, README entrypoints, and changed behavior are coherent. Change summary: {change_summary}",
+        "output_format": "Markdown sections: Missing Links, Stale Docs, Needed Updates, Safe No-op Areas.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "planner",
+      "values": {
+        "goal": "Prepare a bounded docs maintenance plan for: {change_summary}",
+        "scope": "Use docs index and documentation review from stdin. README: {readme}. Docs dir: {docs_dir}.",
+        "constraints": "Prefer smallest documentation changes; do not rewrite stable docs cosmetically.",
+        "output_format": "Markdown sections: Required Edits, Optional Edits, Validation, Stop Conditions.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "artifact",
+      "values": {
+        "input": "Use docs review and maintenance plan from stdin.",
+        "artifact_path": "{artifact_path}",
+        "artifact_format": "Markdown sections: Docs State, Required Updates, Optional Follow-up, Validation.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}

package/dist/recipes/pipeline-media-library.json

@@ -0,0 +1,59 @@
+{
+  "async": true,
+  "imports": {
+    "playlist": "utility-playlist-build.json",
+    "artifact": "pipeline-artifact-report.json"
+  },
+  "args": [
+    "source_dir:path",
+    "extensions:string",
+    "max_depth:int",
+    "output_mode:enum(paths,m3u,inline)",
+    "artifact_path:path",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "source_dir": "~/Music",
+    "extensions": ".mp3,.ogg,.wav,.flac,.m4a",
+    "max_depth": "2",
+    "output_mode": "m3u",
+    "artifact_path": "./media-library.md",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "media.completed",
+      "artifact.prepared",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": [
+    {
+      "name": "playlist",
+      "values": {
+        "source_dir": "{source_dir}",
+        "extensions": "{extensions}",
+        "max_depth": "{max_depth}",
+        "output_mode": "{output_mode}"
+      }
+    },
+    {
+      "name": "artifact",
+      "values": {
+        "input": "Use playlist/media listing from stdin. Source directory: {source_dir}. Output mode: {output_mode}.",
+        "artifact_path": "{artifact_path}",
+        "artifact_format": "Markdown sections: Source, Playlist Output, Playback Notes, Next Actions.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}

package/dist/recipes/pipeline-quorum-review.json

@@ -0,0 +1,79 @@
+{
+  "async": true,
+  "imports": {
+    "subagent": "subagent-prompt.json",
+    "merger": "subagent-merge.json",
+    "judge": "subagent-judge.json",
+    "normalizer": "subagent-normalize.json"
+  },
+  "args": [
+    "prompt:string",
+    "models:array",
+    "merge_mode:enum(consensus-first,risk-first)",
+    "merger_model:string",
+    "judge_model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "merge_mode": "consensus-first",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "quorum.completed",
+      "review.completed",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": [
+    {
+      "parallel": true,
+      "repeat": "{models.length}",
+      "failure": "branch",
+      "template": {
+        "name": "subagent",
+        "values": {
+          "prompt": "{prompt}",
+          "model": "{models[index]}",
+          "tools": "{tools}",
+          "output_format": "Vote-style Markdown: Verdict, Rationale, Evidence, Confidence."
+        }
+      }
+    },
+    {
+      "name": "merger",
+      "values": {
+        "inputs": "Use quorum outputs from stdin.",
+        "mode": "{merge_mode}",
+        "model": "{merger_model}",
+        "tools": "{tools}",
+        "risk_policy": "Preserve vote shape, minority severe findings, and confidence disagreements."
+      }
+    },
+    {
+      "name": "judge",
+      "values": {
+        "report": "Use merged quorum report from stdin.",
+        "evidence": "Use raw quorum outputs and merged report from stdin.",
+        "model": "{judge_model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "normalizer",
+      "values": {
+        "input": "Use merged and judged quorum output from stdin.",
+        "format": "Markdown sections: Verdict, Vote Shape, Consensus, Minority Findings, Confidence, Required Action.",
+        "model": "{merger_model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}

package/dist/recipes/pipeline-release-readiness.json

@@ -0,0 +1,110 @@
+{
+  "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"
+  },
+  "args": [
+    "scope:path",
+    "version:string",
+    "package_json:path",
+    "skill:path",
+    "validation_command:string",
+    "artifact_path:path",
+    "lenses:array",
+    "reviewer_model:string",
+    "verifier_model:string",
+    "merger_model:string",
+    "judge_model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "scope": ".",
+    "version": "0.15.0",
+    "package_json": "{scope}/package.json",
+    "skill": "{scope}/skills/actors/SKILL.md",
+    "validation_command": "npm run validate",
+    "artifact_path": "./release-readiness.md",
+    "lenses": [
+      "release",
+      "package contents",
+      "operator UX",
+      "documentation",
+      "packaged skills"
+    ],
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "release.completed",
+      "artifact.prepared",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": [
+    {
+      "name": "changelog",
+      "values": {
+        "file": "{scope}/CHANGELOG.md",
+        "version": "{version}"
+      }
+    },
+    {
+      "name": "package",
+      "values": {
+        "package_json": "{package_json}",
+        "repo": "{scope}"
+      }
+    },
+    {
+      "name": "skill",
+      "values": {
+        "skill": "{skill}",
+        "package_json": "{package_json}",
+        "repo": "{scope}"
+      }
+    },
+    {
+      "name": "validation",
+      "values": {
+        "scope": "{scope}",
+        "command": "{validation_command}"
+      }
+    },
+    {
+      "name": "review",
+      "values": {
+        "scope": "Release scope {scope} for version {version}. Use changelog, package summary, packaged skill summary, and validation output from stdin.",
+        "lenses": "{lenses}",
+        "claim": "Version {version} is ready for release or the remaining blockers are explicitly identified.",
+        "reviewer_model": "{reviewer_model}",
+        "verifier_model": "{verifier_model}",
+        "merger_model": "{merger_model}",
+        "judge_model": "{judge_model}",
+        "tools": "{tools}",
+        "output_format": "Markdown sections: Release Verdict, Blocking Issues, Package/Docs Risks, Validation Evidence, Publish Notes, Required Follow-up."
+      }
+    },
+    {
+      "name": "artifact",
+      "values": {
+        "input": "Use release readiness review from stdin.",
+        "artifact_path": "{artifact_path}",
+        "artifact_format": "Markdown sections: Release Verdict, Evidence, Risks, Checklist, Next Actions.",
+        "model": "{merger_model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}

package/dist/recipes/pipeline-release-summary.json

@@ -0,0 +1,88 @@
+{
+  "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"
+  },
+  "args": [
+    "scope:path",
+    "version:string",
+    "package_json:path",
+    "skill:path",
+    "validation_command:string",
+    "artifact_path:path",
+    "risk_notes:string",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "scope": ".",
+    "package_json": "{scope}/package.json",
+    "skill": "{scope}/skills/actors/SKILL.md",
+    "validation_command": "npm run validate",
+    "artifact_path": "./release-summary.md",
+    "risk_notes": "No extra risk notes supplied.",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "release.summary_ready",
+      "artifact.prepared",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "artifacts": {
+    "summary": "{artifact_path}"
+  },
+  "template": [
+    {
+      "name": "changelog",
+      "values": {
+        "file": "{scope}/CHANGELOG.md",
+        "version": "{version}"
+      }
+    },
+    {
+      "name": "package",
+      "values": {
+        "package_json": "{package_json}",
+        "repo": "{scope}"
+      }
+    },
+    {
+      "name": "skill",
+      "values": {
+        "skill": "{skill}",
+        "package_json": "{package_json}",
+        "repo": "{scope}"
+      }
+    },
+    {
+      "name": "validation",
+      "values": {
+        "scope": "{scope}",
+        "command": "{validation_command}"
+      }
+    },
+    {
+      "name": "artifact",
+      "values": {
+        "input": "Prepare an evidence-only release summary for version {version}. Use changelog, package summary, packaged skill summary, validation output, and these risk notes: {risk_notes}. Do not propose or perform commit, PR, merge, tag, publish, or any external release side effect.",
+        "artifact_path": "{artifact_path}",
+        "artifact_format": "Markdown sections: Release Summary, Validation Evidence, Package And Skill Evidence, Risks, PR Body Draft, Operator-Gated Next Steps. The PR Body Draft must be suitable for copy/paste and must not claim that release side effects already happened.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}

package/dist/recipes/pipeline-repo-health.json

@@ -0,0 +1,89 @@
+{
+  "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"
+  },
+  "args": [
+    "repo:path",
+    "docs_dir:path",
+    "validation_command:string",
+    "artifact_path:path",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "repo": ".",
+    "docs_dir": "docs",
+    "validation_command": "npm run validate",
+    "artifact_path": "./repo-health.md",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "repo_health.completed",
+      "artifact.prepared",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": [
+    {
+      "name": "git_status",
+      "values": {
+        "repo": "{repo}"
+      }
+    },
+    {
+      "name": "git_log",
+      "values": {
+        "repo": "{repo}",
+        "count": "8"
+      }
+    },
+    {
+      "name": "docs_index",
+      "values": {
+        "directory": "{repo}/{docs_dir}",
+        "title": "Documentation Index"
+      }
+    },
+    {
+      "name": "validation",
+      "values": {
+        "scope": "{repo}",
+        "command": "{validation_command}"
+      }
+    },
+    {
+      "name": "normalizer",
+      "values": {
+        "input": "Use repository status, recent log, docs index, and validation output from stdin. Repo: {repo}.",
+        "format": "Markdown sections: Branch State, Recent Commits, Docs Surface, Validation, Risks, Next Actions.",
+        "model": "{model}",
+        "thinking": "off",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "artifact",
+      "values": {
+        "input": "Use normalized repo health output from stdin.",
+        "artifact_path": "{artifact_path}",
+        "artifact_format": "Markdown sections: Branch State, Validation, Risks, Next Actions.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}

package/dist/recipes/pipeline-research-synthesis.json

@@ -0,0 +1,94 @@
+{
+  "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"
+  },
+  "args": [
+    "question:string",
+    "sources:string",
+    "constraints:string",
+    "model:string",
+    "tools:string"
+  ],
+  "defaults": {
+    "sources": "Use provided source notes or artifact paths only; mark missing evidence.",
+    "constraints": "Bound the question, preserve contradictions, and avoid publication-style certainty when evidence is weak.",
+    "tools": ""
+  },
+  "mailbox": {
+    "accepts": [
+      "control.stop",
+      "control.cancel",
+      "control.kill"
+    ],
+    "emits": [
+      "research.completed",
+      "command.done",
+      "run.done",
+      "run.failed"
+    ]
+  },
+  "template": [
+    {
+      "name": "planner",
+      "values": {
+        "goal": "Answer research question: {question}",
+        "scope": "Sources: {sources}",
+        "constraints": "{constraints}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "evidence",
+      "values": {
+        "question": "{question}",
+        "sources": "{sources}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "contradictions",
+      "values": {
+        "inputs": "Use plan and evidence map from stdin.",
+        "focus": "Contradictions, weak evidence, and missing source classes for question: {question}",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "verifier",
+      "values": {
+        "claim": "The synthesis can answer the research question within the stated constraints.",
+        "evidence": "Use plan, evidence map, and contradiction map from stdin.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "merger",
+      "values": {
+        "inputs": "Use all previous research outputs from stdin.",
+        "mode": "risk-first",
+        "risk_policy": "Preserve uncertainty and contradictions over forced consensus.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    },
+    {
+      "name": "normalizer",
+      "values": {
+        "input": "Use merged research synthesis from stdin.",
+        "format": "Markdown sections: Question, Evidence Map, Synthesis, Contradictions, Confidence, Missing Evidence, Next Evidence Slice.",
+        "model": "{model}",
+        "tools": "{tools}"
+      }
+    }
+  ]
+}