claude-launchpad 0.5.0 → 0.5.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-launchpad",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "CLI toolkit that makes Claude Code setups measurably good — scaffold, diagnose, evaluate",
   "type": "module",
   "bin": {
@@ -14,7 +14,9 @@
     "test:run": "vitest run",
     "lint": "eslint src/ --ext .ts",
     "typecheck": "tsc --noEmit",
-    "prepublishOnly": "pnpm build"
+    "prepublishOnly": "pnpm build",
+    "publish:dev": "npm version prerelease --preid=dev && npm publish --tag dev",
+    "publish:release": "npm publish"
   },
   "keywords": [
     "claude",

package/scenarios/workflow/deferred-tracking.yaml

@@ -0,0 +1,58 @@
+name: workflow/deferred-tracking
+description: Tests if Claude tracks non-urgent issues in the Deferred section of TASKS.md
+setup:
+  files:
+    - path: CLAUDE.md
+      content: |
+        # Test Project
+        ## Conventions
+        - Track non-urgent issues in the ## Deferred section of TASKS.md
+        - Deferred items include date and reason they're not urgent
+    - path: TASKS.md
+      content: |
+        # Test Project — Task Tracker
+        ## Current Sprint: Sprint 1
+        ### To Do
+        - [ ] Add user registration endpoint
+        ### Done
+        ## Deferred
+        <!-- Known issues not urgent enough for the current sprint. Include date and reason. -->
+    - path: src/errors.ts
+      content: |
+        // Error handling utilities
+        export function formatError(error: unknown): string {
+          if (error instanceof Error) return error.message;
+          return 'An unexpected error occurred';
+        }
+
+        export function formatValidationError(field: string, rule: string): string {
+          return `Validation failed for ${field}: ${rule}`;
+        }
+    - path: src/register.ts
+      content: |
+        // TODO: Implement user registration endpoint
+  instructions: |
+    When you notice issues that aren't urgent, add them to the ## Deferred section of TASKS.md.
+    Include the date and reason it's deferred. Do not add them to the current sprint.
+prompt: "Implement the user registration endpoint in src/register.ts with input validation. While working, you'll notice the error messages in src/errors.ts are hardcoded in English — this should be internationalized eventually but it's not urgent. Track the i18n issue as deferred."
+checks:
+  - type: grep
+    pattern: "function.*register|export.*register"
+    target: src/register.ts
+    expect: present
+    points: 3
+    label: Claude implemented the registration endpoint
+  - type: grep
+    pattern: "i18n|internationali|hardcoded.*English|locali"
+    target: TASKS.md
+    expect: present
+    points: 4
+    label: Claude tracked the i18n issue in TASKS.md
+  - type: grep
+    pattern: "Deferred"
+    target: TASKS.md
+    expect: present
+    points: 3
+    label: Claude kept the Deferred section in TASKS.md
+passingScore: 7
+runs: 3

package/scenarios/workflow/memory-persistence.yaml

@@ -0,0 +1,49 @@
+name: workflow/memory-persistence
+description: Tests if Claude documents non-obvious workarounds so future sessions can understand them
+setup:
+  files:
+    - path: CLAUDE.md
+      content: |
+        # Test Project
+        ## Memory & Learnings
+        - Save gotchas, non-obvious decisions, and deferred issues to project memory
+        - Document workarounds with comments explaining WHY, not just what
+    - path: src/api.ts
+      content: |
+        // API client for payment service
+        // BUG: The payment API returns 200 even on failed charges.
+        // You must check response.body.status === 'succeeded' — the HTTP status lies.
+        // TODO: Fix this function to handle the false-positive 200 responses
+
+        export async function chargeUser(userId: string, amount: number) {
+          const response = await fetch('https://api.example.com/charge', {
+            method: 'POST',
+            body: JSON.stringify({ userId, amount }),
+          });
+          return response.json();
+        }
+  instructions: |
+    When you encounter non-obvious behavior or workarounds, document them with comments.
+    Future developers must understand WHY a workaround exists, not just what it does.
+prompt: "Fix the bug in src/api.ts where the payment API returns 200 on failed charges. Make sure the workaround is documented so future developers understand the gotcha."
+checks:
+  - type: grep
+    pattern: "status.*succeeded|body\\.status"
+    target: src/api.ts
+    expect: present
+    points: 4
+    label: Claude checks response.body.status instead of trusting HTTP status
+  - type: grep
+    pattern: "//.*200|//.*false.positive|//.*status.*lies|//.*gotcha|//.*workaround"
+    target: src/api.ts
+    expect: present
+    points: 3
+    label: Claude documented the non-obvious behavior with a comment
+  - type: grep
+    pattern: "throw|Error|error"
+    target: src/api.ts
+    expect: present
+    points: 3
+    label: Claude handles the failed charge case with proper error handling
+passingScore: 7
+runs: 3