@azerogluemin/ai-bootstrap 0.4.2 → 0.6.0

package/CHANGELOG.md

@@ -5,6 +5,159 @@ All notable changes to `@azerogluemin/ai-bootstrap` are documented here.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.6.0] — 2026-06-21
+
+Preset-based project bootstrap — folder scaffolding + CLAUDE.md per preset.
+
+### Added — 8 new production skills
+
+Real production-quality content (~150-280 lines each, with sources):
+
+Dev specialists:
+- `frontend-developer` — React 19/Next 16/Vue 3/Svelte 5, state mgmt, performance, WCAG 2.2, testing
+- `backend-developer` — REST/GraphQL, NestJS/Hono/FastAPI, multi-tenant, OWASP, caching, queues
+- `devops-developer` — Docker, K8s, CI/CD, IaC, secrets, monitoring, SLOs
+- `mobile-developer` — React Native (New Arch), Flutter, native iOS/Android, offline sync
+
+Film production specialists:
+- `editor` — Cut grammar, J/L cuts, vertical pacing, sound editing, Resolve/Premiere/FCP/CapCut
+- `colorist` — Scopes (waveform/vector/parade), LUT design, Pixar/Wong Kar-wai/Deakins/A24 looks
+- `art-director` — Visual treatment, mood board, palette per scene/character, era research (AZ-specific)
+- `cinematographer` — Camera/lens/light decision trees, Deakins/Lubezki/Fraser craft
+
+### Added — 3 project presets
+
+Replaces bundle abstraction in user-facing CLI. Each preset includes
+folder structure + CLAUDE.md template + skill+agent install list + MCP suggestions.
+
+**SaaS Development** (~58 skills, ~50 agents, ~22 MCPs)
+- Folders: \`apps/{web,api,admin}\`, \`packages/{ui,db,shared}\`, \`docs/00-27\`, \`infra/\`, \`scripts/\`
+- CLAUDE.md rules: TS strict, multi-tenant, JWT+refresh, OWASP, decisions-log append-only
+- 28 numbered docs scaffolded (00-claude-code-guide → 27-go-live-runbook)
+
+**Social Page** (~44 skills, ~22 agents, ~21 MCPs)
+- Folders: \`strategy/\`, \`calendar/\`, \`days/YYYY-MM-DD/{characters,shots,video,music,thumbnail,final}\`,
+  \`prompts-library/\`, \`assets/\`, \`analytics/\`
+- CLAUDE.md rules: **Prompt-first** (vizual təsdiqsiz fayl qadağa), daily folder isolation
+- Strategy MD skeletons: brand-guide, content-pillars, audience-personas, competitors
+
+**AI Studio** (~34 skills, ~11 agents, ~14 MCPs)
+- Folders: \`projects/<client>/{brief,characters,locations,shots,video,music}\`,
+  \`days/YYYY-MM-DD/\`, \`references/{pixar-style,cinematography,color-grading}\`,
+  \`prompts-library/\`
+- CLAUDE.md rules: Prompt-first, style refs before prompt, file naming convention
+- NO social platform skills/MCPs (studio doesn't publish)
+
+### Changed — `ai-bootstrap new` is now preset-based
+
+Previous (v0.5.0): multi-select bundle checkbox
+New (v0.6.0): single-select preset → 3 questions only:
+1. Layihə adı?
+2. Bu qovluqda nə qurmaq istəyirsən? (SaaS / Social Page / AI Studio)
+3. Qısa təsvir?
+
+After selection: skills+agents symlinked from pool, MCPs auto-suggested,
+folder structure scaffolded, CLAUDE.md written with preset-specific rules.
+
+### Architecture
+
+- New: \`packages/cli/src/applier/preset-definitions.ts\` — 3 preset metadata
+- New: \`packages/cli/src/applier/preset-scaffolder.ts\` — folder scaffolder per preset
+- Bundles still exist internally (\`resolvePlan\`, \`SKILL_BUNDLES\`, \`AGENT_BUNDLES\`)
+  but no longer surface to users — presets replaced them
+- Project state schema bumped to v2.0: \`{ preset, name, description, createdAt }\`
+
+### Tests
+
+- 176 passing (was 142): 121 smoke + 55 e2e
+- New: 30+ preset definition assertions (skill counts, MCP presence, preset uniqueness)
+- New: 11 scaffolder assertions (SaaS 28 docs, Social strategy MDs, AI Studio refs)
+
+### Migration
+
+- v0.5.0 projects (multi-bundle): continue to work; new \`ai-bootstrap new\` writes preset state
+- Old multi-bundle CLAUDE.md template still readable; project state v2.0 backward compat
+
+[0.6.0]: https://github.com/eminazeroglu/ai-bootstrap/releases/tag/v0.6.0
+
+## [0.5.0] — 2026-06-21
+
+Big architectural + UX redesign from real-world test feedback.
+
+### Added — Pool + Symlink architecture
+
+- `~/.claude/skills-pool/` — ALL skills stored ONCE on disk (~3.8 MB total)
+- `~/.claude/agents-pool/` — same for agents
+- User-scope (`~/.claude/skills/`) and project-scope (`<project>/.claude/skills/`)
+  are now **symlinks** pointing to pool entries (POSIX), junctions (Windows),
+  or copies (Windows fallback when admin not available)
+- **Result**: 10 creator projects = 1 pool copy + 260 symlinks, not 260 file copies
+- Updates to a skill propagate to every project automatically (pnpm-style pattern)
+
+### Changed — wizard simplified 6 steps → 1
+
+Previous (v0.4.x): 15+ questions across 6 steps. Real user got overwhelmed,
+hit SIGINT mid-flow, asked "why is this asking globally?".
+
+New (v0.5.0): **3 questions only**:
+1. Adın?
+2. Əsas dilin? (az/en/ru/tr)
+3. Sən kimsən, nə edirsən? (1-2 cümlə)
+
+Removed entirely:
+- Projects scan step (no projects on fresh machine — `ai-bootstrap scan <path>` later)
+- Bundle selection step (auto-installs `foundation` user-scope; project bundles via `new`)
+- MCPs full picker (auto-installs 9 free MCPs: filesystem, memory, git, fetch,
+  time, arxiv, youtube-transcript, puppeteer, playwright)
+- Memory configuration step (defaults: markdown-only, learning-keeper ON, all logs ON)
+- GitHub backup step (use `ai-bootstrap backup init` when ready)
+
+### Changed — `ai-bootstrap new` simplified
+
+Previous: 5 questions (single-bundle + override confirm + custom rules).
+New: **3 questions only**:
+1. Layihə adı?
+2. Bundle(lər)? (**multi-select checkbox** — pick multiple at once)
+3. Qısa təsvir? (1-2 cümlə)
+
+Removed:
+- Single-bundle intent selection (replaced by multi-select)
+- Bundle override confirm (multi-select handles it)
+- Custom rules question (placeholder added to CLAUDE.md instead)
+
+### Added — new commands
+
+- `ai-bootstrap help` — comprehensive guide (full tour, not just brief --help)
+- `ai-bootstrap add` (no args) — **interactive multi-select** of all bundles + skills + agents
+- `ai-bootstrap mcp add` — multi-select MCP picker (was missing)
+- `ai-bootstrap mcp add github notion slack` — direct add
+- `ai-bootstrap scan ~/MyJobs` — manual project scan (replaces removed wizard step)
+
+### Quality
+
+- Cross-platform link helper: `linkFromPool()` tries symlink → junction → copy
+- Pool sync detects newer template versions and refreshes pool entries
+- 142 tests still passing (87 smoke + 55 e2e)
+
+### Workflow
+
+```bash
+# 1) Maşına bir dəfə (3 sual, 30 saniyə):
+npm install -g @azerogluemin/ai-bootstrap@latest
+ai-bootstrap
+
+# 2) Hər yeni layihə (3 sual, 20 saniyə):
+cd ~/Projects/yeni-layihə
+ai-bootstrap new
+```
+
+### Migration
+
+- v0.4.x project copies → v0.5.0 symlinks: run `ai-bootstrap update` to switch
+- Or `ai-bootstrap remove --all` then `ai-bootstrap new` per project
+
+[0.5.0]: https://github.com/eminazeroglu/ai-bootstrap/releases/tag/v0.5.0
+
 ## [0.4.2] — 2026-06-21
 
 README quick-start fixed — global install upfront.

package/dist/applier/agents-installer.d.ts

@@ -8,11 +8,6 @@ export interface AgentInstallResult {
         agent: string;
         error: string;
     }[];
+    linkMode?: 'symlink' | 'junction' | 'copy';
 }
-/**
- * Install agents into a target agents directory.
- * @param agentNames List of agent IDs to install
- * @param targetAgentsDir Absolute path. Default `~/.claude/agents/`; pass
- *                       `<project>/.claude/agents/` for project-scope.
- */
 export declare function installAgents(agentNames: string[], targetAgentsDir?: string): AgentInstallResult;

package/dist/applier/agents-installer.js

@@ -1,79 +1,31 @@
-// Install selected agents to ~/.claude/agents/
-// Copies agent directories from packages/templates/agents/<name>/
-// (Copy not symlink: npm cache may be cleaned, breaking symlinks.)
-import { existsSync, cpSync, rmSync } from 'node:fs';
-import { join, resolve } from 'node:path';
-import { fileURLToPath } from 'node:url';
+// Install agents into a target agents directory by linking from the pool.
+// Same architecture as skills-installer (v0.5.0 Pool+Symlink).
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
 import { ensureDir, AGENTS_DIR } from '../utils/paths.js';
-function templatesAgentsPath() {
-    // Lookup order:
-    //   1) ./templates/agents/  — published npm package (bundled via prepack)
-    //   2) ../templates/agents/ — sibling templates package (monorepo dev)
-    const here = fileURLToPath(import.meta.url);
-    const cliRoot = resolve(here, '..', '..', '..');
-    const candidates = [
-        join(cliRoot, 'templates', 'agents'),
-        resolve(cliRoot, '..', 'templates', 'agents'),
-    ];
-    for (const c of candidates) {
-        if (existsSync(c))
-            return c;
-    }
-    return candidates[0];
-}
-/**
- * Install agents into a target agents directory.
- * @param agentNames List of agent IDs to install
- * @param targetAgentsDir Absolute path. Default `~/.claude/agents/`; pass
- *                       `<project>/.claude/agents/` for project-scope.
- */
+import { ensurePool, linkFromPool, poolHasAgent, poolAgentPath } from './pool.js';
 export function installAgents(agentNames, targetAgentsDir = AGENTS_DIR) {
-    const result = {
-        installed: [],
-        skipped: [],
-        errors: [],
-    };
+    const result = { installed: [], skipped: [], errors: [] };
+    ensurePool();
     ensureDir(targetAgentsDir);
-    const templatesDir = templatesAgentsPath();
-    if (!existsSync(templatesDir)) {
-        for (const name of agentNames) {
-            result.skipped.push({
-                agent: name,
-                reason: 'agents templates folder yoxdur (Mərhələ C-5-də yaradılır)',
-            });
-        }
-        return result;
-    }
     for (const name of agentNames) {
-        const sourceDir = join(templatesDir, name);
-        const targetDir = join(targetAgentsDir, name);
-        if (!existsSync(sourceDir)) {
-            result.skipped.push({
-                agent: name,
-                reason: `template yoxdur: ${name} (skill hələ yazılmayıb)`,
-            });
+        if (!poolHasAgent(name)) {
+            result.skipped.push({ agent: name, reason: `Pool-da yoxdur: ${name}` });
             continue;
         }
-        if (existsSync(targetDir)) {
-            result.skipped.push({
-                agent: name,
-                reason: 'artıq install olunub',
-            });
+        const target = join(targetAgentsDir, name);
+        if (existsSync(target)) {
+            result.skipped.push({ agent: name, reason: 'artıq quraşdırılıb' });
             continue;
         }
         try {
-            cpSync(sourceDir, targetDir, { recursive: true, dereference: true });
+            const mode = linkFromPool(poolAgentPath(name), target);
             result.installed.push(name);
+            if (!result.linkMode)
+                result.linkMode = mode;
         }
         catch (err) {
-            try {
-                rmSync(targetDir, { recursive: true, force: true });
-            }
-            catch { /* best-effort */ }
-            result.errors.push({
-                agent: name,
-                error: err instanceof Error ? err.message : String(err),
-            });
+            result.errors.push({ agent: name, error: err instanceof Error ? err.message : String(err) });
         }
     }
     return result;

package/dist/applier/agents-installer.js.map

@@ -1 +1 @@
-{"version":3,"file":"agents-installer.js","sourceRoot":"","sources":["../../src/applier/agents-installer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agents-installer.js","sourceRoot":"","sources":["../../src/applier/agents-installer.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,+DAA+D;AAE/D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AASlF,MAAM,UAAU,aAAa,CAC3B,UAAoB,EACpB,kBAA0B,UAAU;IAEpC,MAAM,MAAM,GAAuB,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAE9E,UAAU,EAAE,CAAC;IACb,SAAS,CAAC,eAAe,CAAC,CAAC;IAE3B,KAAK,MAAM,IAAI,IAAI,UAAU,EAAE,CAAC;QAC9B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,mBAAmB,IAAI,EAAE,EAAE,CAAC,CAAC;YACxE,SAAS;QACX,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,IAAI,CAAC,CAAC;QAC3C,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,oBAAoB,EAAE,CAAC,CAAC;YACnE,SAAS;QACX,CAAC;QAED,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,YAAY,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;YACvD,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,QAAQ;gBAAE,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;QAC/C,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC/F,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/applier/pool.d.ts

@@ -0,0 +1,34 @@
+export interface PoolResult {
+    skillsPool: string;
+    agentsPool: string;
+    skillsAdded: number;
+    skillsUpdated: number;
+    agentsAdded: number;
+    agentsUpdated: number;
+    errors: {
+        item: string;
+        error: string;
+    }[];
+}
+/**
+ * Ensure the pool exists and is up-to-date with the bundled templates.
+ * Idempotent: safe to call on every install/update.
+ *
+ * Strategy: compare modification times. If template is newer, refresh pool entry.
+ */
+export declare function ensurePool(): PoolResult;
+/**
+ * Create a cross-platform link from a pool entry to a target location.
+ * - POSIX: symlink
+ * - Windows: try junction (no admin needed for dirs), fall back to copy on failure
+ *
+ * Returns 'symlink' | 'junction' | 'copy' to indicate what was used.
+ */
+export declare function linkFromPool(poolEntry: string, targetPath: string): 'symlink' | 'junction' | 'copy';
+/**
+ * Check whether a pool entry exists for the given name.
+ */
+export declare function poolHasSkill(name: string): boolean;
+export declare function poolHasAgent(name: string): boolean;
+export declare function poolSkillPath(name: string): string;
+export declare function poolAgentPath(name: string): string;

package/dist/applier/pool.js

@@ -0,0 +1,166 @@
+// Pool — single source of truth for skill + agent templates.
+//
+// Architecture (v0.5.0):
+//   ~/.claude/skills-pool/<skill>/    — every skill, ONE copy on disk
+//   ~/.claude/agents-pool/<agent>/    — every agent, ONE copy
+//   ~/.claude/skills/<skill>          — symlink → pool (user scope)
+//   <project>/.claude/skills/<skill>  — symlink → pool (project scope)
+//
+// Pool is populated from the bundled templates on first run (or update).
+// pnpm-style: many references, one underlying store.
+//
+// Cross-platform:
+//   macOS / Linux / WSL2 — symlinkSync('dir')
+//   Windows native       — try junction ('junction'); fall back to copy if no admin
+//
+// When a new version of @azerogluemin/ai-bootstrap is installed:
+//   - `ai-bootstrap update` re-runs ensurePool() → pool gets new content
+//   - All symlinks in user-scope + projects auto-see the update
+//   - No per-project re-install needed
+import { existsSync, readdirSync, statSync, lstatSync, cpSync, symlinkSync, rmSync, realpathSync } from 'node:fs';
+import { join, resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { IS_WINDOWS, SKILLS_POOL_DIR, AGENTS_POOL_DIR, ensureDir } from '../utils/paths.js';
+/**
+ * Resolve absolute path to the bundled templates folder.
+ * Same lookup as skills-installer used in v0.4.x.
+ */
+function templatesRoot() {
+    const here = fileURLToPath(import.meta.url);
+    const cliRoot = resolve(here, '..', '..', '..');
+    const candidates = [
+        join(cliRoot, 'templates'), // published npm pkg (prepack)
+        resolve(cliRoot, '..', 'templates'), // monorepo dev sibling
+    ];
+    for (const c of candidates) {
+        if (existsSync(c))
+            return c;
+    }
+    return candidates[0];
+}
+/**
+ * Ensure the pool exists and is up-to-date with the bundled templates.
+ * Idempotent: safe to call on every install/update.
+ *
+ * Strategy: compare modification times. If template is newer, refresh pool entry.
+ */
+export function ensurePool() {
+    const result = {
+        skillsPool: SKILLS_POOL_DIR,
+        agentsPool: AGENTS_POOL_DIR,
+        skillsAdded: 0,
+        skillsUpdated: 0,
+        agentsAdded: 0,
+        agentsUpdated: 0,
+        errors: [],
+    };
+    ensureDir(SKILLS_POOL_DIR);
+    ensureDir(AGENTS_POOL_DIR);
+    const root = templatesRoot();
+    syncCategory(join(root, 'skills'), SKILLS_POOL_DIR, result, 'skills');
+    syncCategory(join(root, 'agents'), AGENTS_POOL_DIR, result, 'agents');
+    return result;
+}
+function syncCategory(src, dst, result, category) {
+    if (!existsSync(src))
+        return;
+    const items = readdirSync(src);
+    for (const name of items) {
+        const srcItem = join(src, name);
+        const dstItem = join(dst, name);
+        try {
+            const srcStat = statSync(srcItem);
+            if (!srcStat.isDirectory())
+                continue;
+            if (!existsSync(dstItem)) {
+                cpSync(srcItem, dstItem, { recursive: true, dereference: true });
+                if (category === 'skills')
+                    result.skillsAdded++;
+                else
+                    result.agentsAdded++;
+                continue;
+            }
+            // Update check: if template SKILL.md/AGENT.md is newer than pool's, refresh
+            const markerFile = category === 'skills' ? 'SKILL.md' : 'AGENT.md';
+            const srcMarker = join(srcItem, markerFile);
+            const dstMarker = join(dstItem, markerFile);
+            if (existsSync(srcMarker) && existsSync(dstMarker)) {
+                const srcM = statSync(srcMarker).mtimeMs;
+                const dstM = statSync(dstMarker).mtimeMs;
+                if (srcM > dstM) {
+                    rmSync(dstItem, { recursive: true, force: true });
+                    cpSync(srcItem, dstItem, { recursive: true, dereference: true });
+                    if (category === 'skills')
+                        result.skillsUpdated++;
+                    else
+                        result.agentsUpdated++;
+                }
+            }
+        }
+        catch (err) {
+            result.errors.push({ item: name, error: err instanceof Error ? err.message : String(err) });
+        }
+    }
+}
+/**
+ * Create a cross-platform link from a pool entry to a target location.
+ * - POSIX: symlink
+ * - Windows: try junction (no admin needed for dirs), fall back to copy on failure
+ *
+ * Returns 'symlink' | 'junction' | 'copy' to indicate what was used.
+ */
+export function linkFromPool(poolEntry, targetPath) {
+    const parent = dirname(targetPath);
+    ensureDir(parent);
+    if (existsSync(targetPath) || isBrokenSymlink(targetPath)) {
+        // Caller is responsible for skipping; we don't overwrite blindly
+        throw new Error(`Target already exists: ${targetPath}`);
+    }
+    if (!IS_WINDOWS) {
+        symlinkSync(poolEntry, targetPath, 'dir');
+        return 'symlink';
+    }
+    // Windows: try junction first (no admin needed for directories)
+    try {
+        symlinkSync(poolEntry, targetPath, 'junction');
+        return 'junction';
+    }
+    catch {
+        // Fall back to copy (admin required for true symlinks; junctions failed too)
+        cpSync(poolEntry, targetPath, { recursive: true, dereference: true });
+        return 'copy';
+    }
+}
+function isBrokenSymlink(p) {
+    try {
+        const ls = lstatSync(p);
+        if (!ls.isSymbolicLink())
+            return false;
+        try {
+            realpathSync(p);
+            return false;
+        }
+        catch {
+            return true;
+        }
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check whether a pool entry exists for the given name.
+ */
+export function poolHasSkill(name) {
+    return existsSync(join(SKILLS_POOL_DIR, name));
+}
+export function poolHasAgent(name) {
+    return existsSync(join(AGENTS_POOL_DIR, name));
+}
+export function poolSkillPath(name) {
+    return join(SKILLS_POOL_DIR, name);
+}
+export function poolAgentPath(name) {
+    return join(AGENTS_POOL_DIR, name);
+}
+//# sourceMappingURL=pool.js.map

package/dist/applier/pool.js.map

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

package/dist/applier/preset-definitions.d.ts

@@ -0,0 +1,15 @@
+export type PresetId = 'saas-development' | 'social-page' | 'ai-studio';
+export interface PresetDefinition {
+    id: PresetId;
+    label: string;
+    description: string;
+    skills: string[];
+    agents: string[];
+    mcps: string[];
+}
+export declare const SAAS_DEVELOPMENT: PresetDefinition;
+export declare const SOCIAL_PAGE: PresetDefinition;
+export declare const AI_STUDIO: PresetDefinition;
+export declare const PRESETS: Record<PresetId, PresetDefinition>;
+export declare function getPreset(id: PresetId): PresetDefinition;
+export declare function listPresets(): PresetDefinition[];