@punks/cli 1.0.7 → 2.0.0-beta.1

package/dist/data/scripts/sync-subagents.mjs

@@ -52,7 +52,7 @@ const cursorManagedComment =
 const opencodeManagedComment =
   "<!-- Generated by scripts/sync-subagents.mjs. Edit .agents/subagents/manifest.mjs instead. -->";
 
-function buildCodexAgentConfig({ hasFormatHook }) {
+function buildCodexAgentConfig({ hasFormatHook, hasTestHook }) {
   const lines = [
     "[agents]",
     "max_threads = 6",
@@ -74,6 +74,16 @@ function buildCodexAgentConfig({ hasFormatHook }) {
     );
   }
 
+  if (hasTestHook) {
+    lines.push(
+      "PreToolUse = [",
+      '  { matcher = "Bash|.*[Pp]ull.?[Rr]equest.*|.*[Pp][Rr].?[Cc]reate.*|.*create[_-]?pull[_-]?request.*", hooks = [',
+      '    { type = "command", command = "node \\"$(git rev-parse --show-toplevel)/.codex/hooks/require-tests-for-pr.mjs\\" codex", statusMessage = "Checking tests before PR creation", timeout = 600 },',
+      "  ] },",
+      "]",
+    );
+  }
+
   if (hasFormatHook) {
     lines.push(
       "PostToolUse = [",
@@ -88,9 +98,37 @@ function buildCodexAgentConfig({ hasFormatHook }) {
   return lines.join("\n");
 }
 
-function buildClaudeSettingsConfig({ hasFormatHook }) {
+function buildClaudeSettingsConfig({ hasFormatHook, hasTestHook }) {
   return {
     hooks: {
+      ...(hasTestHook
+        ? {
+            PreToolUse: [
+              {
+                matcher: "mcp__github__create_pull_request",
+                hooks: [
+                  {
+                    type: "command",
+                    command:
+                      'node "$CLAUDE_PROJECT_DIR"/.claude/hooks/require-tests-for-pr.mjs claude',
+                    timeout: 600,
+                  },
+                ],
+              },
+              {
+                matcher: "Bash",
+                hooks: [
+                  {
+                    type: "command",
+                    command:
+                      'node "$CLAUDE_PROJECT_DIR"/.claude/hooks/require-tests-for-pr.mjs claude',
+                    timeout: 600,
+                  },
+                ],
+              },
+            ],
+          }
+        : {}),
       ...(hasFormatHook
         ? {
             PostToolUse: [
@@ -99,7 +137,8 @@ function buildClaudeSettingsConfig({ hasFormatHook }) {
                 hooks: [
                   {
                     type: "command",
-                    command: 'node "$CLAUDE_PROJECT_DIR"/.claude/hooks/format-edited-file.mjs claude',
+                    command:
+                      'node "$CLAUDE_PROJECT_DIR"/.claude/hooks/format-edited-file.mjs claude',
                     timeout: 30,
                   },
                 ],
@@ -111,10 +150,24 @@ function buildClaudeSettingsConfig({ hasFormatHook }) {
   };
 }
 
-function buildCursorHooksConfig({ hasFormatHook }) {
+function buildCursorHooksConfig({ hasFormatHook, hasTestHook }) {
   return {
     version: 1,
     hooks: {
+      ...(hasTestHook
+        ? {
+            beforeMCPExecution: [
+              {
+                command: "node .cursor/hooks/require-tests-for-pr.mjs cursor",
+              },
+            ],
+            beforeShellExecution: [
+              {
+                command: "node .cursor/hooks/require-tests-for-pr.mjs cursor",
+              },
+            ],
+          }
+        : {}),
       ...(hasFormatHook
         ? {
             afterFileEdit: [
@@ -341,7 +394,7 @@ async function syncHookSurface() {
   await mkdir(cursorHooksDir, { recursive: true });
   await mkdir(opencodePluginsDir, { recursive: true });
 
-  for (const hookName of ["format-edited-file.mjs"]) {
+  for (const hookName of ["format-edited-file.mjs", "require-tests-for-pr.mjs"]) {
     const sourcePath = path.join(sharedHooksPath, hookName);
     const targetPaths = [
       path.join(codexHooksDir, hookName),
@@ -395,10 +448,15 @@ async function main() {
   await mkdir(path.dirname(cursorHooksJsonPath), { recursive: true });
   const availableHooks = {
     hasFormatHook: await pathExists(path.join(sharedHooksPath, "format-edited-file.mjs")),
+    hasTestHook: await pathExists(path.join(sharedHooksPath, "require-tests-for-pr.mjs")),
   };
   await writeFile(codexConfigPath, buildCodexAgentConfig(availableHooks), "utf8");
   await rm(path.join(codexDir, "hooks.json"), { force: true });
-  await writeFile(claudeSettingsPath, encodeJson(buildClaudeSettingsConfig(availableHooks)), "utf8");
+  await writeFile(
+    claudeSettingsPath,
+    encodeJson(buildClaudeSettingsConfig(availableHooks)),
+    "utf8",
+  );
   await writeFile(cursorHooksJsonPath, encodeJson(buildCursorHooksConfig(availableHooks)), "utf8");
   await writeManagedFiles(claudeAgentsDir, "md", claudeFiles);
   await writeManagedFiles(codexAgentsDir, "toml", codexFiles);

package/dist/data/subagents/manifest.mjs

@@ -1,7 +1,6 @@
 const capabilityPacks = {
   "frontend-core": {
-    description:
-      "Core Next.js and React app structure guidance for product-facing frontend work.",
+    description: "Core Next.js and React app structure guidance for product-facing frontend work.",
     skills: [
       "next-best-practices",
       "async-react-patterns",
@@ -10,13 +9,11 @@ const capabilityPacks = {
     ],
   },
   simplify: {
-    description:
-      "Simplify and refine recently modified code for clarity and consistency.",
+    description: "Simplify and refine recently modified code for clarity and consistency.",
     skills: ["simplify"],
   },
   "frontend-ui": {
-    description:
-      "UI implementation, browser testing, visual quality, and composition patterns.",
+    description: "UI implementation, browser testing, visual quality, and composition patterns.",
     skills: [
       "agent-browser",
       "frontend-design",
@@ -30,8 +27,7 @@ const capabilityPacks = {
     skills: ["tanstack-query"],
   },
   "frontend-cache": {
-    description:
-      "Next.js cache components, PPR, cache tags, and related rendering/cache behavior.",
+    description: "Next.js cache components, PPR, cache tags, and related rendering/cache behavior.",
     skills: ["next-cache-components"],
   },
   "server-core": {
@@ -42,25 +38,16 @@ const capabilityPacks = {
   "api-core": {
     description:
       "Effect application logic, pre-write authoring guidance, service/layer patterns, and test-first backend domain work.",
-    skills: [
-      "effect-authoring",
-      "effect-best-practices",
-      "effect-recoverable-actions",
-      "tdd",
-    ],
+    skills: ["effect-authoring", "effect-best-practices", "effect-recoverable-actions", "tdd"],
   },
   "auth-core": {
-    description:
-      "Better Auth conventions and security-sensitive authentication behavior.",
-    skills: [
-      "better-auth-best-practices",
-      "better-auth-security-best-practices",
-    ],
+    description: "Better Auth conventions and security-sensitive authentication behavior.",
+    skills: ["better-auth-best-practices", "better-auth-security-best-practices"],
   },
   "docs-core": {
     description:
       "Repo documentation maintenance, routing, and human-facing durable knowledge capture.",
-    skills: ["docs-maintenance"],
+    skills: ["docs-ingest-phase"],
   },
   "review-core": {
     description:
@@ -78,8 +65,7 @@ const capabilityPacks = {
     ],
   },
   "python-async": {
-    description:
-      "Python asyncio, concurrent I/O, async API boundaries, and async test strategy.",
+    description: "Python asyncio, concurrent I/O, async API boundaries, and async test strategy.",
     skills: [
       "async-python-patterns",
       "python-project-structure",
@@ -90,11 +76,7 @@ const capabilityPacks = {
   "python-quality": {
     description:
       "Python pytest coverage, fixture design, style checks, and refactor-safe quality work.",
-    skills: [
-      "python-testing-patterns",
-      "python-code-style",
-      "python-design-patterns",
-    ],
+    skills: ["python-testing-patterns", "python-code-style", "python-design-patterns"],
   },
 };
 
@@ -133,14 +115,14 @@ const agents = [
     ],
   },
   {
-    name: "docs-maintenance",
+    name: "docs-ingest-phase",
     description:
       "Use for repo documentation work centered on docs updates, index maintenance, ADR routing, and keeping docs grounded in implemented reality.",
     ownedPaths: ["docs/**"],
     guidanceFiles: ["docs/AGENTS.md"],
     activationInstructions: skillActivationInstructions,
     packs: ["docs-core", "simplify"],
-    skills: ["docs-maintenance", "simplify"],
+    skills: ["docs-ingest-phase", "simplify"],
     boundaries: [
       "Own documentation updates in docs/ and keep them human-facing and implementation-grounded.",
       "If the task is mainly code implementation, tell the parent to use the relevant code specialist and only return for the docs follow-up.",
@@ -295,11 +277,7 @@ const agents = [
     guidanceFiles: ["packages/auth/AGENTS.md"],
     activationInstructions: skillActivationInstructions,
     packs: ["auth-core", "simplify"],
-    skills: [
-      "better-auth-best-practices",
-      "better-auth-security-best-practices",
-      "simplify",
-    ],
+    skills: ["better-auth-best-practices", "better-auth-security-best-practices", "simplify"],
     boundaries: [
       "Treat auth work as security-sensitive and stay inside packages/auth unless explicitly coordinating with another specialist.",
       "If the task is mainly Effect application logic, tell the parent to use api-domain instead.",
@@ -342,14 +320,7 @@ const agents = [
     name: "python-async",
     description:
       "Use for Python async work centered on asyncio, concurrent I/O, async APIs, background tasks, and async test coverage.",
-    ownedPaths: [
-      "src/**",
-      "packages/**",
-      "services/**",
-      "apps/**",
-      "tests/**",
-      "pyproject.toml",
-    ],
+    ownedPaths: ["src/**", "packages/**", "services/**", "apps/**", "tests/**", "pyproject.toml"],
     guidanceFiles: ["AGENTS.md"],
     activationInstructions: skillActivationInstructions,
     packs: ["python-async", "python-quality", "simplify"],
@@ -383,12 +354,7 @@ const agents = [
     guidanceFiles: ["AGENTS.md"],
     activationInstructions: skillActivationInstructions,
     packs: ["python-quality", "simplify"],
-    skills: [
-      "python-testing-patterns",
-      "python-code-style",
-      "python-design-patterns",
-      "simplify",
-    ],
+    skills: ["python-testing-patterns", "python-code-style", "python-design-patterns", "simplify"],
     boundaries: [
       "Own pytest structure, fixtures, parameterization, integration-test shape, and test readability.",
       "Prefer tests that exercise real behavior over brittle mocks unless the boundary is genuinely external.",