@allthingsclaude/blueprints 0.2.0 → 0.3.0-beta.10

package/dist/installer.js

@@ -16,6 +16,36 @@ export const RESEARCH_AGENTS = [
     'research-docs.md',
     'research-web.md',
 ];
+export const LIGHTWEIGHT_AGENTS = [
+    'commit.md',
+    'changelog.md',
+    'handoff.md',
+    'cleanup.md',
+    'imagine.md',
+];
+export const HEAVYWEIGHT_AGENTS = [
+    'audit.md',
+    'debug.md',
+    'secure.md',
+];
+export const DEFAULT_TASKS_DIR = 'tasks';
+export function buildTemplateVars(tasksDir = DEFAULT_TASKS_DIR) {
+    return {
+        '{{TASKS_DIR}}': tasksDir,
+        '{{PLANS_DIR}}': `${tasksDir}/plans`,
+        '{{SESSIONS_DIR}}': `${tasksDir}/sessions`,
+        '{{STATE_FILE}}': `${tasksDir}/STATE.md`,
+    };
+}
+export const TEMPLATE_VARS = buildTemplateVars();
+export function replaceTemplateVars(content, tasksDir) {
+    const vars = tasksDir ? buildTemplateVars(tasksDir) : TEMPLATE_VARS;
+    let result = content;
+    for (const [key, value] of Object.entries(vars)) {
+        result = result.replaceAll(key, value);
+    }
+    return result;
+}
 /**
  * Get the default Claude directory based on the operating system
  */
@@ -78,7 +108,7 @@ export function ensureDir(dirPath) {
 /**
  * Copy all files from source to destination directory
  */
-export function copyDirectory(srcDir, destDir) {
+export function copyDirectory(srcDir, destDir, tasksDir) {
     ensureDir(destDir);
     const files = fs.readdirSync(srcDir);
     let copiedCount = 0;
@@ -86,35 +116,59 @@ export function copyDirectory(srcDir, destDir) {
         const srcFile = path.join(srcDir, file);
         const destFile = path.join(destDir, file);
         const stat = fs.statSync(srcFile);
-        if (stat.isFile()) {
+        if (stat.isFile() && file.endsWith('.md')) {
+            const content = fs.readFileSync(srcFile, 'utf-8');
+            const updated = replaceTemplateVars(content, tasksDir);
+            fs.writeFileSync(destFile, updated, 'utf-8');
+            copiedCount++;
+        }
+        else if (stat.isFile()) {
             fs.copyFileSync(srcFile, destFile);
             copiedCount++;
         }
         else if (stat.isDirectory()) {
             // Recursively copy subdirectories
-            copiedCount += copyDirectory(srcFile, path.join(destDir, file));
+            copiedCount += copyDirectory(srcFile, path.join(destDir, file), tasksDir);
         }
     }
     return copiedCount;
 }
 /**
- * Get the model to use for a given agent file based on power level
+ * Determine the tier for an agent based on its filename
+ */
+export function getAgentTier(filename) {
+    if (LIGHTWEIGHT_AGENTS.includes(filename))
+        return 'lightweight';
+    if (RESEARCH_AGENTS.includes(filename))
+        return 'research';
+    if (HEAVYWEIGHT_AGENTS.includes(filename))
+        return 'heavyweight';
+    return 'standard';
+}
+/**
+ * Get the model to use for a given agent file based on power level and tier
+ *
+ * Tiers:
+ * - lightweight: commit, changelog, handoff, cleanup, imagine (rote tasks)
+ * - research: codebase/docs/web research (search + synthesize)
+ * - standard: refactor, test, plan, implement, etc. (balanced)
+ * - heavyweight: audit, debug, secure (deep reasoning, high stakes)
  */
 export function getModelForAgent(filename, powerLevel) {
-    const isResearch = RESEARCH_AGENTS.includes(filename);
+    const tier = getAgentTier(filename);
     const modelMap = {
-        1: { research: 'haiku', other: 'haiku' },
-        2: { research: 'haiku', other: 'sonnet' },
-        3: { research: 'sonnet', other: 'sonnet' },
-        4: { research: 'sonnet', other: 'opus' },
-        5: { research: 'opus', other: 'opus' },
+        1: { lightweight: 'haiku', research: 'haiku', standard: 'haiku', heavyweight: 'sonnet' },
+        2: { lightweight: 'haiku', research: 'haiku', standard: 'sonnet', heavyweight: 'sonnet' },
+        3: { lightweight: 'sonnet', research: 'sonnet', standard: 'sonnet', heavyweight: 'sonnet' },
+        4: { lightweight: 'sonnet', research: 'opus', standard: 'opus', heavyweight: 'opus' },
+        5: { lightweight: 'opus', research: 'opus', standard: 'opus', heavyweight: 'opus' },
     };
-    return isResearch ? modelMap[powerLevel].research : modelMap[powerLevel].other;
+    return modelMap[powerLevel][tier];
 }
 /**
  * Copy agent files with model rewritten based on power level
  */
-export function copyAgentsWithPowerLevel(srcDir, destDir, powerLevel) {
+export function copyAgentsWithPowerLevel(srcDir, destDir, powerLevel, tasksDir) {
     ensureDir(destDir);
     const files = fs.readdirSync(srcDir);
     let copiedCount = 0;
@@ -123,12 +177,13 @@ export function copyAgentsWithPowerLevel(srcDir, destDir, powerLevel) {
         const destFile = path.join(destDir, file);
         const stat = fs.statSync(srcFile);
         if (stat.isDirectory()) {
-            copiedCount += copyAgentsWithPowerLevel(srcFile, path.join(destDir, file), powerLevel);
+            copiedCount += copyAgentsWithPowerLevel(srcFile, path.join(destDir, file), powerLevel, tasksDir);
         }
         else if (stat.isFile() && file.endsWith('.md')) {
             const content = fs.readFileSync(srcFile, 'utf-8');
             const model = getModelForAgent(file, powerLevel);
-            const updated = content.replace(/^(model:\s*).+$/m, `$1${model}`);
+            let updated = content.replace(/^(model:\s*).+$/m, `$1${model}`);
+            updated = replaceTemplateVars(updated, tasksDir);
             fs.writeFileSync(destFile, updated, 'utf-8');
             copiedCount++;
         }
@@ -139,10 +194,52 @@ export function copyAgentsWithPowerLevel(srcDir, destDir, powerLevel) {
     }
     return copiedCount;
 }
+/**
+ * Get the current package version
+ */
+export function getPackageVersion() {
+    const packageRoot = path.join(__dirname, '..');
+    const pkgPath = path.join(packageRoot, 'package.json');
+    try {
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+        return pkg.version || 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+}
+/**
+ * Remove files from a destination directory that no longer exist in the source
+ */
+export function cleanStaleFiles(srcDir, destDir) {
+    if (!fs.existsSync(destDir))
+        return 0;
+    let removedCount = 0;
+    const destFiles = fs.readdirSync(destDir);
+    for (const file of destFiles) {
+        const srcFile = path.join(srcDir, file);
+        const destFile = path.join(destDir, file);
+        const destStat = fs.statSync(destFile);
+        if (destStat.isDirectory()) {
+            if (fs.existsSync(srcFile)) {
+                removedCount += cleanStaleFiles(srcFile, destFile);
+            }
+            else {
+                fs.rmSync(destFile, { recursive: true });
+                removedCount++;
+            }
+        }
+        else if (!fs.existsSync(srcFile)) {
+            fs.unlinkSync(destFile);
+            removedCount++;
+        }
+    }
+    return removedCount;
+}
 /**
  * Install blueprints to the target path
  */
-export async function installBlueprints(targetPath, powerLevel = 3) {
+export async function installBlueprints(targetPath, powerLevel = 3, tasksDir = DEFAULT_TASKS_DIR) {
     const sourcePaths = getSourcePaths();
     const installPaths = getInstallPaths(targetPath);
     // Verify source directories exist
@@ -154,10 +251,16 @@ export async function installBlueprints(targetPath, powerLevel = 3) {
     }
     // Ensure base .claude directory exists
     ensureDir(installPaths.base);
+    // Clean stale files from previous installations
+    cleanStaleFiles(sourcePaths.commands, installPaths.commands);
+    cleanStaleFiles(sourcePaths.agents, installPaths.agents);
     // Copy commands
-    const commandsCount = copyDirectory(sourcePaths.commands, installPaths.commands);
+    const commandsCount = copyDirectory(sourcePaths.commands, installPaths.commands, tasksDir);
     // Copy agents with power level model overrides
-    const agentsCount = copyAgentsWithPowerLevel(sourcePaths.agents, installPaths.agents, powerLevel);
+    const agentsCount = copyAgentsWithPowerLevel(sourcePaths.agents, installPaths.agents, powerLevel, tasksDir);
+    // Write version marker
+    const version = getPackageVersion();
+    fs.writeFileSync(path.join(installPaths.base, '.blueprints-version'), JSON.stringify({ version, installedAt: new Date().toISOString(), powerLevel }, null, 2), 'utf-8');
     return {
         commands: commandsCount,
         agents: agentsCount,

package/dist/installer.js.map

@@ -1 +1 @@
-{"version":3,"file":"installer.js","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"installer.js","sourceRoot":"","sources":["../src/installer.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allthingsclaude/blueprints",
-  "version": "0.2.0",
+  "version": "0.3.0-beta.10",
   "description": "Claude Code commands and agents for enhanced AI-assisted development workflows",
   "type": "module",
   "main": "dist/index.js",
@@ -15,6 +15,10 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "prepublishOnly": "pnpm run build && pnpm run test",
+    "release:beta": "pnpm run build && pnpm run test && npm version prerelease --preid beta && git push && git push --tags",
+    "release:beta:patch": "pnpm run build && pnpm run test && npm version prepatch --preid beta && git push && git push --tags",
+    "release:beta:minor": "pnpm run build && pnpm run test && npm version preminor --preid beta && git push && git push --tags",
+    "release:beta:major": "pnpm run build && pnpm run test && npm version premajor --preid beta && git push && git push --tags",
     "release:patch": "pnpm run build && pnpm run test && npm version patch && git push && git push --tags",
     "release:minor": "pnpm run build && pnpm run test && npm version minor && git push && git push --tags",
     "release:major": "pnpm run build && pnpm run test && npm version major && git push && git push --tags"

package/content/commands/optimize.md

@@ -1,338 +0,0 @@
----
-description: Optimize code by eliminating DRY violations without changing behavior
-argument-hint: [optional: file/folder path, "functions" | "components" | "hooks" | "types" | "constants"]
-author: "@markoradak"
----
-
-# DRY Optimization Assistant
-
-I'll find and eliminate DRY violations across your codebase, consolidating duplicated logic into single sources of truth while guaranteeing identical behavior.
-
-## Current State
-
-**Working Directory**: !`pwd`
-
-**Branch**: !`git branch --show-current`
-
-**Status**:
-!`git status --short`
-
-**Files to Analyze**:
-!`find src -name "*.ts" -o -name "*.tsx" 2>/dev/null | wc -l` TypeScript files
-
----
-
-## Focus Area
-
-$ARGUMENTS
-
----
-
-## Optimization Workflow
-
-### Phase 1: Snapshot Baseline
-
-Before any changes, capture the current state:
-
-1. **Type safety**: Run `pnpm typecheck` — record result
-2. **Lint compliance**: Run `pnpm lint` — record result
-3. **Tests**: Run `pnpm test:run` — record result
-4. **Build**: Run `pnpm build` — record result
-
-All four MUST pass before and after optimization. If any fail before starting, stop and report.
-
----
-
-### Phase 2: DRY Violation Scan
-
-Based on the focus area, scan for specific duplication:
-
-#### If "functions" or no argument:
-- Find functions with identical or near-identical bodies across files
-- Detect repeated inline logic (same 3+ line blocks)
-- Identify utility patterns repeated instead of shared
-
-#### If "components":
-- Find components with overlapping JSX structures
-- Detect repeated render patterns that differ only by props
-- Identify components that could be parameterized into one
-
-#### If "hooks":
-- Find duplicated state + effect patterns across components
-- Detect repeated data-fetching logic
-- Identify shared lifecycle patterns not yet extracted
-
-#### If "types":
-- Find overlapping or identical type/interface definitions
-- Detect types that are subsets of each other
-- Identify repeated union types or utility type patterns
-
-#### If "constants":
-- Find magic values repeated across files
-- Detect duplicate configuration objects
-- Identify repeated string literals used as identifiers
-
-#### If specific file/folder provided:
-- Deep DRY analysis scoped to that area only
-
----
-
-## Detection Strategies
-
-### Exact Duplicates
-
-```bash
-# Find identical function bodies (same name, different files)
-grep -rn "export function\|export const" src/ --include="*.ts" --include="*.tsx"
-
-# Find repeated multi-line patterns
-grep -rn "pattern" src/ --include="*.ts" --include="*.tsx"
-```
-
-### Structural Duplicates
-
-Look for code that follows the same shape but with different values:
-
-- **Same control flow** with different variables
-- **Same JSX structure** with different props/text
-- **Same validation logic** with different fields
-- **Same API call pattern** with different endpoints
-
-### Logical Duplicates
-
-Look for code that achieves the same outcome through different implementations:
-
-- **Same business rule** expressed differently
-- **Same computation** performed in multiple places
-- **Same transformation** applied to different data shapes
-
----
-
-## Optimization Strategies
-
-### 1. Extract Shared Function
-
-**When**: 3+ occurrences of identical or parameterizable logic
-
-**How**:
-- Identify the common core and the varying parts
-- Create a function that takes the varying parts as parameters
-- Replace all occurrences with calls to the shared function
-
-**Location Rules**:
-- Used within one file → private helper in same file
-- Used across files in one feature → `lib/[feature].ts`
-- Used across features → `lib/shared.ts` or `lib/utils/[name].ts`
-
-### 2. Extract Shared Component
-
-**When**: 2+ components share significant JSX structure
-
-**How**:
-- Identify the common layout and the varying slots/values
-- Design a props interface that captures all variations
-- Create one component that renders all cases via props
-
-**Guard**: Only extract if the shared component is simpler than the sum of its parts. If the props interface becomes complex to cover all cases, the duplication may be justified.
-
-### 3. Extract Custom Hook
-
-**When**: 2+ components share state + effect logic
-
-**How**:
-- Identify the shared state shape and effect triggers
-- Extract into `hooks/use[Name].ts`
-- Return the same interface each component was using
-
-### 4. Consolidate Types
-
-**When**: Overlapping interfaces or repeated type patterns
-
-**How**:
-- Identify the superset type
-- Use `Pick`, `Omit`, `Partial`, or `extends` to derive variants
-- Place shared types in `types/[domain].ts`
-
-### 5. Extract Constants
-
-**When**: Same literal value appears in 3+ places
-
-**How**:
-- Create a named constant in `lib/constants.ts`
-- Replace all occurrences with the constant reference
-- Use `as const` for literal types
-
----
-
-## DRY Optimization Report Format
-
-```markdown
-# DRY Optimization Report
-
-**Scanned**: [X] files in [path]
-**Focus**: [area or "all"]
-**Baseline**: typecheck OK | lint OK | tests OK | build OK
-
----
-
-## Violations Found
-
-| # | Type | Occurrences | Lines Duplicated | Saveable Lines | Priority |
-|---|------|-------------|------------------|----------------|----------|
-| 1 | [exact/structural/logical] | X | Y | Z | High |
-| 2 | ... | ... | ... | ... | Medium |
-
-**Total Duplication**: ~[X] lines across [Y] files
-**Estimated Reduction**: ~[Z] lines ([N]%)
-
----
-
-## High Priority Optimizations
-
-### 1. [Descriptive Name]
-
-**Violation Type**: Exact / Structural / Logical
-**Occurrences**: [count]
-
-**Found In**:
-- `src/path/A.tsx:23-45` (22 lines)
-- `src/path/B.tsx:67-89` (22 lines)
-- `src/path/C.ts:12-34` (22 lines)
-
-**Duplicated Code** (from first occurrence):
-```typescript
-// The repeated code
-```
-
-**Optimization**:
-
-**Strategy**: Extract Shared [Function/Component/Hook/Type]
-**New Location**: `src/lib/[name].ts`
-
-```typescript
-// The consolidated version
-```
-
-**Replacement** (at each call site):
-```typescript
-// How each occurrence changes
-```
-
-**Savings**: -[X] lines, [Y] files touched
-**Risk**: None — identical behavior guaranteed
-
----
-
-## Medium Priority Optimizations
-
-### 2. [Descriptive Name]
-
-**Violation Type**: Structural
-**Occurrences**: 2
-
-**Options**:
-1. **Parameterize now** — extract with config parameter
-2. **Wait** — only 2 occurrences, may diverge
-
-**Recommendation**: [Which and why]
-
----
-
-## Constants to Extract
-
-| Value | Occurrences | Suggested Name | Target File |
-|-------|-------------|----------------|-------------|
-| `"api/v1"` | 12 | `API_BASE_PATH` | `lib/constants.ts` |
-| `30000` | 4 | `DEFAULT_TIMEOUT_MS` | `lib/constants.ts` |
-
----
-
-## Types to Consolidate
-
-| Type | Locations | Strategy |
-|------|-----------|----------|
-| `UserData` / `UserInfo` | 3 files | Merge into `types/user.ts` |
-| `ApiResponse<T>` | 5 files | Single definition in `types/api.ts` |
-
----
-
-## Summary
-
-| Priority | Count | Lines Saved |
-|----------|-------|-------------|
-| High | X | ~Y |
-| Medium | X | ~Y |
-| Constants | X | ~Y |
-| Types | X | ~Y |
-| **Total** | **X** | **~Y** |
-
----
-
-## Execution Plan
-
-### Auto-apply (Safe)
-
-1. [ ] Extract constants to shared location
-2. [ ] Consolidate duplicate type definitions
-3. [ ] Replace exact-duplicate functions with shared imports
-
-### Requires Review
-
-1. [ ] Structural duplications (confirm parameterization approach)
-2. [ ] Component extractions (confirm props interface design)
-3. [ ] Hook extractions (confirm return interface)
-
----
-
-## Post-Optimization Verification
-
-1. [ ] `pnpm typecheck` — MUST match baseline
-2. [ ] `pnpm lint` — MUST match baseline
-3. [ ] `pnpm test:run` — MUST match baseline
-4. [ ] `pnpm build` — MUST match baseline
-5. [ ] Manual spot-check of changed behavior paths
-
-Would you like me to apply the high-priority optimizations?
-```
-
----
-
-## Behavior Preservation Rules
-
-These rules are non-negotiable:
-
-1. **No functional changes**: Every optimization MUST produce identical behavior
-2. **Baseline before, baseline after**: All checks must pass before starting and after finishing
-3. **One optimization at a time**: Apply, verify, then proceed to next
-4. **Revert on failure**: If any verification fails after a change, revert immediately
-5. **No premature abstraction**: Only extract when the duplication is clear and stable
-
-### DO
-- Extract when the duplication is exact or clearly parameterizable
-- Keep extracted units focused — one responsibility per function/component/hook
-- Name based on what it does, not where it came from
-- Preserve original function signatures at call sites
-- Run full verification after each change
-
-### DON'T
-- Extract 2-occurrence patterns unless they're exact duplicates
-- Create god-functions that handle too many variations via params
-- Change public API signatures unless all consumers are updated
-- Optimize code that's about to be deleted or rewritten
-- Bundle unrelated optimizations into a single change
-- Sacrifice readability for fewer lines
-
----
-
-## When to Stop
-
-Not all duplication should be eliminated:
-
-- **2 occurrences with likely divergence**: Leave them — premature abstraction is worse than duplication
-- **Similar but semantically different**: Two functions that happen to look alike but serve different purposes should stay separate
-- **Test code**: Some duplication in tests improves readability and independence
-- **Configuration**: Repeated config values that might change independently should stay separate
-
----
-
-Use the Task tool to launch the optimize agent (subagent_type="optimize") which will capture the baseline, scan for DRY violations, present a prioritized report, and — with user approval — apply optimizations one at a time with validation after each change.