@punks/cli 2.0.0-beta.0 → 2.0.0-beta.1

package/README.md

@@ -42,7 +42,7 @@ Use `--baseline bundled` to force the npm-shipped baseline, or `--refresh-baseli
 
 Language packs are detected separately from framework packs. TypeScript is selected when scanned manifests depend on `typescript` or when nested source files include `.ts` / `.tsx`; Python is selected from nested `.py` files. Root-level config files and vendor, virtualenv, generated, scaffold, docs, examples, `scripts`, `opensrc`, cache, and build output directories are ignored.
 
-The default subagent manifest includes Python templates that combine the language skills into `python-app`, `python-async`, and `python-testing` specialists.
+The generated subagent manifest is repo-shaped from selected packs and prompt specs. Python specialists are generated only when the Python language pack is selected.
 
 To install only the local `dp-cli` operator skill from the public skills repo checkout:
 

package/dist/index.js

@@ -52435,7 +52435,7 @@ var toolCatalog = [
 
 // package.json
 var name = "@punks/cli";
-var version = "2.0.0-beta.0";
+var version = "2.0.0-beta.1";
 // src/baseline/bundled.ts
 var bundledBaseline = {
   summary: {
@@ -54883,6 +54883,66 @@ var renderSubagentManifestPrompt = ({
   "- Use explicit skill lists when runtime inheritance differs across harnesses."
 ].join(`
 `);
+var renderSubagentManifestModule = ({
+  spec,
+  baseline,
+  fallback
+}) => {
+  if (spec.specialists.length === 0) {
+    return fallback;
+  }
+  const baseSpecialists = spec.finalPacks.includes("research") && !spec.specialists.some((specialist) => specialist.id === "code-review") ? [
+    {
+      id: "code-review",
+      ownedPaths: ["."],
+      guidanceFiles: ["AGENTS.md"],
+      packs: ["research"],
+      skills: ["simplify", "improve-codebase-architecture"],
+      notes: "Use for findings-first review across changed code, simplification opportunities, and grounded architecture-friction findings."
+    }
+  ] : [];
+  const specialists = [...baseSpecialists, ...spec.specialists];
+  const selectedPacks = [...new Set(specialists.flatMap((specialist) => specialist.packs))];
+  const packDescriptions = new Map(baseline.packs.map((pack2) => [pack2.id, pack2.description]));
+  const capabilityPacks = Object.fromEntries(selectedPacks.map((packId) => [
+    packId,
+    {
+      description: packDescriptions.get(packId) ?? `${packId} guidance pack.`,
+      skills: skillsForPack(packId, baseline)
+    }
+  ]));
+  const agents = specialists.map((specialist) => ({
+    name: specialist.id,
+    description: specialist.notes,
+    ownedPaths: specialist.ownedPaths.flatMap((ownedPath) => ownedPath === "." ? ["**/*"] : [ownedPath, `${ownedPath}/**`]),
+    guidanceFiles: specialist.guidanceFiles,
+    activationInstructions: [
+      "Before planning or editing, read every file in `guidanceFiles` for this role.",
+      "In those scoped AGENTS.md files, find the `Primary skills here` list and treat each named skill as mandatory for matching work.",
+      "Activate a skill by opening its SKILL.md, reading the workflow/checklist needed for the assigned task, and applying it before edits.",
+      "If the task touches multiple owned or related scopes, inspect each scope's nearest AGENTS.md and activate the union of relevant skills."
+    ],
+    packs: specialist.packs,
+    skills: specialist.skills,
+    boundaries: [
+      "Operate only inside the assigned owned paths unless the parent explicitly expands scope.",
+      "If the task clearly belongs to another specialist, say so explicitly instead of improvising outside your scope.",
+      "If the task changes architecture, setup, contracts, decisions, or operator workflow, update the relevant docs or runbook in the same task."
+    ]
+  }));
+  return [
+    "const capabilityPacks = ",
+    JSON.stringify(capabilityPacks, null, 2),
+    `;
+`,
+    "const agents = ",
+    JSON.stringify(agents, null, 2),
+    `;
+`,
+    `export { agents, capabilityPacks };
+`
+  ].join("");
+};
 var sortSubagentSpecialists = (spec) => ({
   ...spec,
   specialists: spec.specialists.toSorted((left3, right3) => left3.id.localeCompare(right3.id))
@@ -55470,7 +55530,11 @@ var writeScaffoldOutput = ({
   generatedFiles.push(writeArtifact({
     outputDirectory,
     relativePath: ".agents/subagents/manifest.mjs",
-    content: shouldPreserveExistingManagedFiles && existsSync4(sourceManifestPath) ? readFileSync5(sourceManifestPath, "utf8") : defaultSubagentManifestTemplate
+    content: shouldPreserveExistingManagedFiles && existsSync4(sourceManifestPath) ? readFileSync5(sourceManifestPath, "utf8") : renderSubagentManifestModule({
+      spec: subagentManifestSpec,
+      baseline,
+      fallback: defaultSubagentManifestTemplate
+    })
   }));
   subagentFiles.push(".agents/subagents/manifest.mjs");
   for (const hook of hookRegistryForBaseline(baseline).filter((entry) => finalHookIds.includes(entry.id))) {
@@ -57457,7 +57521,7 @@ var runUpdate = ({
     finalPacks,
     outputDirectory: expectedDirectory,
     repoShapeMode,
-    preserveExistingManagedFiles: false,
+    preserveExistingManagedFiles: true,
     displayOutputDirectory: rootDirectory,
     baseline
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@punks/cli",
-  "version": "2.0.0-beta.0",
+  "version": "2.0.0-beta.1",
   "description": "Devpunks AI scaffolding CLI",
   "bin": {
     "devpunks": "dist/index.js",
@@ -21,6 +21,7 @@
     "dev": "bun run ./src/index.ts scaffold",
     "local": "bun run build && bun run ./dist/index.js",
     "release:publish": "node ./scripts/publish-release.mjs",
+    "release:publish:beta": "NPM_TAG=beta node ./scripts/publish-release.mjs",
     "sync:skills": "node ./scripts/sync-skills-repo.mjs",
     "test": "vitest run --config vitest.config.ts"
   },