@cubis/foundry 0.3.30 → 0.3.32

package/Ai Agent Workflow/scripts/generate-powers.mjs

@@ -1,410 +0,0 @@
-#!/usr/bin/env node
-/**
- * generate-powers.mjs
- *
- * Generates POWER.md files for Kiro from the canonical SKILL.md files in the
- * skills/ directory. Powers are Kiro-specific wrappers around skills; the
- * install source of truth for `cbx install` is ALWAYS `skills/<id>/SKILL.md`.
- *
- * Source priority (matching cubis.js installBundleArtifacts):
- *   1. skills/<name>/SKILL.md  ← canonical (what `cbx install` uses)
- *   2. powers/<name>/SKILL.md  ← fallback (local override only)
- *
- * Usage:
- *   node "Ai Agent Workflow/scripts/generate-powers.mjs" [--dry-run] [--force] [--from-skills] [--sync-skills]
- *
- * Options:
- *   --dry-run      Preview changes without writing files
- *   --force        Overwrite existing POWER.md files
- *   --from-skills  Also create missing power directories from skills/
- *   --sync-skills  Sync canonical SKILL.md from skills/ → powers/ for every power
- */
-
-import path from "node:path";
-import process from "node:process";
-import { fileURLToPath } from "node:url";
-import { promises as fs } from "node:fs";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const ROOT = path.resolve(__dirname, "..", "..");
-const ASSETS_ROOT = path.join(ROOT, "Ai Agent Workflow");
-const POWERS_ROOT = path.join(ASSETS_ROOT, "powers");
-const SKILLS_ROOT = path.join(ASSETS_ROOT, "skills");
-
-const ARGS = new Set(process.argv.slice(2));
-const DRY_RUN = ARGS.has("--dry-run");
-const FORCE = ARGS.has("--force");
-const FROM_SKILLS = ARGS.has("--from-skills");
-const SYNC_SKILLS = ARGS.has("--sync-skills");
-
-// ─── Kiro POWER.md frontmatter keys ────────────────────────────────────────
-// Keys added/ensured for Kiro power format
-const KIRO_REQUIRED_KEYS = {
-  inclusion: "manual",
-};
-
-// ─── Helpers ────────────────────────────────────────────────────────────────
-
-async function pathExists(p) {
-  try {
-    await fs.stat(p);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-async function readUtf8(p) {
-  return fs.readFile(p, "utf8");
-}
-
-async function writeUtf8(p, content) {
-  if (DRY_RUN) return;
-  await fs.mkdir(path.dirname(p), { recursive: true });
-  await fs.writeFile(p, content, "utf8");
-}
-
-async function copyDir(src, dest) {
-  if (DRY_RUN) return;
-  await fs.mkdir(dest, { recursive: true });
-  const entries = await fs.readdir(src, { withFileTypes: true });
-  for (const entry of entries) {
-    const srcPath = path.join(src, entry.name);
-    const destPath = path.join(dest, entry.name);
-    if (entry.isDirectory()) {
-      await copyDir(srcPath, destPath);
-    } else {
-      await fs.copyFile(srcPath, destPath);
-    }
-  }
-}
-
-/**
- * Strip an outer code fence wrapper from file content.
- * Handles both:
- *   ```skill        (backtick × 3)
- *   ````skill       (backtick × 4)
- * Returns the raw inner content (the markdown string inside the fence),
- * or the original content unchanged if no fence is found.
- */
-function stripCodeFence(content) {
-  const trimmed = content.trim();
-  // Match opening fence: 3+ backticks followed by optional language identifier
-  const fenceMatch = trimmed.match(/^(`{3,})([a-zA-Z]*)\n([\s\S]*)\n\1\s*$/);
-  if (!fenceMatch) return trimmed;
-  return fenceMatch[3];
-}
-
-/**
- * Parse YAML frontmatter block from raw markdown.
- * Returns { frontmatterRaw, body } or null if no frontmatter found.
- */
-function parseFrontmatter(markdown) {
-  const match = markdown.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n?([\s\S]*)$/);
-  if (!match) return null;
-  return {
-    frontmatterRaw: match[1],
-    body: match[2],
-  };
-}
-
-/**
- * Inject Kiro-specific keys into a raw frontmatter string if they are absent.
- * Returns updated frontmatter string.
- */
-function injectKiroKeys(frontmatterRaw) {
-  let result = frontmatterRaw;
-  for (const [key, value] of Object.entries(KIRO_REQUIRED_KEYS)) {
-    const keyPresent = new RegExp(`^${key}\\s*:`, "m").test(result);
-    if (!keyPresent) {
-      // Prepend the key at the top of the frontmatter block
-      result = `${key}: ${value}\n${result}`;
-    }
-  }
-  return result;
-}
-
-/**
- * Build POWER.md content from a SKILL.md source string.
- * - Strips outer `skill` / ````skill fence if present
- * - Parses frontmatter and injects Kiro keys
- * - Re-wraps in a `markdown` code fence (matching the existing POWER.md convention)
- */
-function buildPowerContent(skillMdContent) {
-  // 1. Strip outer code fence (the ````skill ... ```` wrapper)
-  const inner = stripCodeFence(skillMdContent);
-
-  // 2. Parse and update frontmatter
-  const parsed = parseFrontmatter(inner);
-  if (!parsed) {
-    // No frontmatter found – just re-wrap with markdown fence and return
-    return `\`\`\`\`markdown\n${inner}\n\`\`\`\`\n`;
-  }
-
-  const updatedFrontmatter = injectKiroKeys(parsed.frontmatterRaw);
-  const reconstructed = `---\n${updatedFrontmatter}\n---\n${parsed.body}`;
-
-  // 3. Wrap in markdown code fence for Kiro power format
-  return `\`\`\`\`markdown\n${reconstructed}\n\`\`\`\`\n`;
-}
-
-// ─── Core logic ─────────────────────────────────────────────────────────────
-
-async function getSubdirectories(dir) {
-  try {
-    const entries = await fs.readdir(dir, { withFileTypes: true });
-    return entries
-      .filter((e) => e.isDirectory() && !e.name.startsWith("."))
-      .map((e) => e.name);
-  } catch {
-    return [];
-  }
-}
-
-async function processPowerDir(powerName) {
-  const powerDir = path.join(POWERS_ROOT, powerName);
-  const powerMdPath = path.join(powerDir, "POWER.md");
-
-  // Source priority mirrors cubis.js installBundleArtifacts (line ~2097):
-  //   skills/<name>/SKILL.md  ← canonical; what `cbx install` copies to the platform
-  //   powers/<name>/SKILL.md  ← local fallback only (may be a stale copy)
-  // Using skills/ as primary ensures POWER.md is generated from the same
-  // content that users receive when they run `cbx install`.
-  const canonicalSkill = path.join(SKILLS_ROOT, powerName, "SKILL.md");
-  const localSkill = path.join(powerDir, "SKILL.md");
-
-  let skillSource;
-  if (await pathExists(canonicalSkill)) {
-    skillSource = canonicalSkill;
-  } else if (await pathExists(localSkill)) {
-    skillSource = localSkill; // fallback: power-local override
-  } else {
-    return {
-      name: powerName,
-      result: "skip",
-      reason: "no SKILL.md found in skills/ or powers/",
-    };
-  }
-
-  const powerExists = await pathExists(powerMdPath);
-  if (powerExists && !FORCE) {
-    return {
-      name: powerName,
-      result: "skip",
-      reason: "POWER.md already exists (use --force to overwrite)",
-    };
-  }
-
-  const skillContent = await readUtf8(skillSource);
-  const powerContent = buildPowerContent(skillContent);
-
-  await writeUtf8(powerMdPath, powerContent);
-
-  return {
-    name: powerName,
-    result: powerExists ? "updated" : "created",
-    source: path.relative(ROOT, skillSource),
-  };
-}
-
-async function syncFromSkills() {
-  const skillDirs = await getSubdirectories(SKILLS_ROOT);
-  const created = [];
-
-  for (const name of skillDirs) {
-    // Skip non-skill entries
-    if (name.startsWith(".") || name.endsWith(".json") || name.endsWith(".md"))
-      continue;
-
-    const powerDir = path.join(POWERS_ROOT, name);
-    const skillDir = path.join(SKILLS_ROOT, name);
-    const skillMdSrc = path.join(skillDir, "SKILL.md");
-
-    if (!(await pathExists(skillMdSrc))) continue;
-    if (await pathExists(powerDir)) continue; // already exists
-
-    // Create power directory and copy SKILL.md
-    const skillMdDest = path.join(powerDir, "SKILL.md");
-    if (!DRY_RUN) {
-      await fs.mkdir(powerDir, { recursive: true });
-      await fs.copyFile(skillMdSrc, skillMdDest);
-    }
-
-    // Copy steering/, templates/, references/ if they exist
-    for (const subdir of ["steering", "templates", "references"]) {
-      const srcSub = path.join(skillDir, subdir);
-      const destSub = path.join(powerDir, subdir);
-      if (await pathExists(srcSub)) {
-        await copyDir(srcSub, destSub);
-      }
-    }
-
-    created.push(name);
-  }
-
-  return created;
-}
-
-/**
- * Sync canonical SKILL.md from skills/ → powers/ for every power directory.
- * This keeps powers/<name>/SKILL.md byte-identical to what `cbx install` will
- * deliver to users, so Kiro and cbx users always see the same skill content.
- */
-async function syncSkillsToPowers() {
-  const powerDirs = await getSubdirectories(POWERS_ROOT);
-  const synced = [];
-  const unchanged = [];
-  const missing = [];
-
-  for (const name of powerDirs) {
-    const canonicalSkill = path.join(SKILLS_ROOT, name, "SKILL.md");
-    const powerSkill = path.join(POWERS_ROOT, name, "SKILL.md");
-
-    if (!(await pathExists(canonicalSkill))) {
-      missing.push(name);
-      continue;
-    }
-
-    const canonical = await readUtf8(canonicalSkill);
-    const existing = (await pathExists(powerSkill))
-      ? await readUtf8(powerSkill)
-      : null;
-
-    if (existing === canonical) {
-      unchanged.push(name);
-      continue;
-    }
-
-    if (!DRY_RUN) {
-      await fs.mkdir(path.join(POWERS_ROOT, name), { recursive: true });
-      await fs.copyFile(canonicalSkill, powerSkill);
-    }
-
-    synced.push(name);
-  }
-
-  return { synced, unchanged, missing };
-}
-
-// ─── Main ───────────────────────────────────────────────────────────────────
-
-async function main() {
-  console.log(`\nCubis Foundry — generate-powers.mjs`);
-  console.log(`Mode: ${DRY_RUN ? "DRY RUN (no files written)" : "LIVE"}`);
-  if (FORCE) console.log("Force: overwriting existing POWER.md files");
-  if (SYNC_SKILLS)
-    console.log(
-      "Sync-skills: syncing canonical SKILL.md from skills/ → powers/",
-    );
-  if (FROM_SKILLS)
-    console.log("From-skills: creating missing power dirs from skills/");
-  console.log();
-
-  // 1a. Sync canonical SKILL.md from skills/ → powers/ so powers/SKILL.md matches
-  //     what `cbx install` delivers (cubis.js always installs from skills/, not powers/).
-  if (SYNC_SKILLS) {
-    const { synced, missing } = await syncSkillsToPowers();
-    if (synced.length > 0) {
-      console.log(
-        `Synced SKILL.md for ${synced.length} power${synced.length === 1 ? "" : "s"} from skills/:`,
-      );
-      for (const name of synced) {
-        console.log(`  ↺ ${name}/SKILL.md`);
-      }
-      console.log();
-    } else {
-      console.log(
-        "All power SKILL.md files are already in sync with skills/.\n",
-      );
-    }
-    if (missing.length > 0) {
-      console.log(
-        `Note: ${missing.length} power${missing.length === 1 ? "" : "s"} have no matching skills/ entry (local-only):`,
-      );
-      for (const name of missing) console.log(`  ~ ${name}`);
-      console.log();
-    }
-  }
-
-  // 1b. Create missing power directories from skills/
-  if (FROM_SKILLS) {
-    const created = await syncFromSkills();
-    if (created.length > 0) {
-      console.log(
-        `Created ${created.length} new power director${created.length === 1 ? "y" : "ies"} from skills/:`,
-      );
-      for (const name of created) {
-        console.log(`  + ${name}/`);
-      }
-      console.log();
-    } else {
-      console.log("No new power directories needed from skills/.\n");
-    }
-  }
-
-  // 2. Process each power directory
-  const powerDirs = await getSubdirectories(POWERS_ROOT);
-  const results = { created: [], updated: [], skipped: [], errors: [] };
-
-  for (const name of powerDirs) {
-    try {
-      const result = await processPowerDir(name);
-      if (result.result === "created") results.created.push(result);
-      else if (result.result === "updated") results.updated.push(result);
-      else results.skipped.push(result);
-    } catch (err) {
-      results.errors.push({ name, error: err.message });
-    }
-  }
-
-  // 3. Report
-  if (results.created.length > 0) {
-    console.log(
-      `Created ${results.created.length} POWER.md file${results.created.length === 1 ? "" : "s"}:`,
-    );
-    for (const r of results.created) {
-      console.log(`  ✓ ${r.name}/POWER.md  (from ${r.source})`);
-    }
-    console.log();
-  }
-
-  if (results.updated.length > 0) {
-    console.log(
-      `Updated ${results.updated.length} POWER.md file${results.updated.length === 1 ? "" : "s"}:`,
-    );
-    for (const r of results.updated) {
-      console.log(`  ↺ ${r.name}/POWER.md  (from ${r.source})`);
-    }
-    console.log();
-  }
-
-  if (results.skipped.length > 0) {
-    console.log(
-      `Skipped ${results.skipped.length} director${results.skipped.length === 1 ? "y" : "ies"}:`,
-    );
-    for (const r of results.skipped) {
-      console.log(`  - ${r.name}: ${r.reason}`);
-    }
-    console.log();
-  }
-
-  if (results.errors.length > 0) {
-    console.error(`Errors (${results.errors.length}):`);
-    for (const r of results.errors) {
-      console.error(`  ✗ ${r.name}: ${r.error}`);
-    }
-    console.log();
-  }
-
-  const total = results.created.length + results.updated.length;
-  console.log(
-    `Done. ${total} POWER.md file${total === 1 ? "" : "s"} ${DRY_RUN ? "would be" : ""} generated.`,
-  );
-
-  if (results.errors.length > 0) process.exit(1);
-}
-
-main().catch((err) => {
-  console.error(err);
-  process.exit(1);
-});

package/Ai Agent Workflow/skills/architecture/SKILL.md

@@ -1,55 +0,0 @@
----
-name: architecture
-description: Architectural decision-making framework. Requirements analysis, trade-off evaluation, ADR documentation. Use when making architecture decisions or analyzing system design.
-allowed-tools: Read, Glob, Grep
----
-
-# Architecture Decision Framework
-
-> "Requirements drive architecture. Trade-offs inform decisions. ADRs capture rationale."
-
-## 🎯 Selective Reading Rule
-
-**Read ONLY files relevant to the request!** Check the content map, find what you need.
-
-| File | Description | When to Read |
-|------|-------------|--------------|
-| `context-discovery.md` | Questions to ask, project classification | Starting architecture design |
-| `trade-off-analysis.md` | ADR templates, trade-off framework | Documenting decisions |
-| `pattern-selection.md` | Decision trees, anti-patterns | Choosing patterns |
-| `examples.md` | MVP, SaaS, Enterprise examples | Reference implementations |
-| `patterns-reference.md` | Quick lookup for patterns | Pattern comparison |
-
----
-
-## 🔗 Related Skills
-
-| Skill | Use For |
-|-------|---------|
-| `@[skills/database-design]` | Database schema design |
-| `@[skills/api-patterns]` | API design patterns |
-| `@[skills/deployment-procedures]` | Deployment architecture |
-
----
-
-## Core Principle
-
-**"Simplicity is the ultimate sophistication."**
-
-- Start simple
-- Add complexity ONLY when proven necessary
-- You can always add patterns later
-- Removing complexity is MUCH harder than adding it
-
----
-
-## Validation Checklist
-
-Before finalizing architecture:
-
-- [ ] Requirements clearly understood
-- [ ] Constraints identified
-- [ ] Each decision has trade-off analysis
-- [ ] Simpler alternatives considered
-- [ ] ADRs written for significant decisions
-- [ ] Team expertise matches chosen patterns

package/Ai Agent Workflow/skills/code-review-checklist/SKILL.md

@@ -1,109 +0,0 @@
----
-name: code-review-checklist
-description: Code review guidelines covering code quality, security, and best practices.
-allowed-tools: Read, Glob, Grep
----
-
-# Code Review Checklist
-
-## Quick Review Checklist
-
-### Correctness
-- [ ] Code does what it's supposed to do
-- [ ] Edge cases handled
-- [ ] Error handling in place
-- [ ] No obvious bugs
-
-### Security
-- [ ] Input validated and sanitized
-- [ ] No SQL/NoSQL injection vulnerabilities
-- [ ] No XSS or CSRF vulnerabilities
-- [ ] No hardcoded secrets or sensitive credentials
-- [ ] **AI-Specific:** Protection against Prompt Injection (if applicable)
-- [ ] **AI-Specific:** Outputs are sanitized before being used in critical sinks
-
-### Performance
-- [ ] No N+1 queries
-- [ ] No unnecessary loops
-- [ ] Appropriate caching
-- [ ] Bundle size impact considered
-
-### Code Quality
-- [ ] Clear naming
-- [ ] DRY - no duplicate code
-- [ ] SOLID principles followed
-- [ ] Appropriate abstraction level
-
-### Testing
-- [ ] Unit tests for new code
-- [ ] Edge cases tested
-- [ ] Tests readable and maintainable
-
-### Documentation
-- [ ] Complex logic commented
-- [ ] Public APIs documented
-- [ ] README updated if needed
-
-## AI & LLM Review Patterns (2025)
-
-### Logic & Hallucinations
-- [ ] **Chain of Thought:** Does the logic follow a verifiable path?
-- [ ] **Edge Cases:** Did the AI account for empty states, timeouts, and partial failures?
-- [ ] **External State:** Is the code making safe assumptions about file systems or networks?
-
-### Prompt Engineering Review
-```markdown
-// ❌ Vague prompt in code
-const response = await ai.generate(userInput);
-
-// ✅ Structured & Safe prompt
-const response = await ai.generate({
-  system: "You are a specialized parser...",
-  input: sanitize(userInput),
-  schema: ResponseSchema
-});
-```
-
-## Anti-Patterns to Flag
-
-```typescript
-// ❌ Magic numbers
-if (status === 3) { ... }
-
-// ✅ Named constants
-if (status === Status.ACTIVE) { ... }
-
-// ❌ Deep nesting
-if (a) { if (b) { if (c) { ... } } }
-
-// ✅ Early returns
-if (!a) return;
-if (!b) return;
-if (!c) return;
-// do work
-
-// ❌ Long functions (100+ lines)
-// ✅ Small, focused functions
-
-// ❌ any type
-const data: any = ...
-
-// ✅ Proper types
-const data: UserData = ...
-```
-
-## Review Comments Guide
-
-```
-// Blocking issues use 🔴
-🔴 BLOCKING: SQL injection vulnerability here
-
-// Important suggestions use 🟡
-🟡 SUGGESTION: Consider using useMemo for performance
-
-// Minor nits use 🟢
-🟢 NIT: Prefer const over let for immutable variable
-
-// Questions use ❓
-❓ QUESTION: What happens if user is null here?
-```

package/Ai Agent Workflow/skills/debugging-wizard/SKILL.md

@@ -1,87 +0,0 @@
----
-name: "debugging-wizard"
-description: "Use when investigating errors, analyzing stack traces, or finding root causes of unexpected behavior. Invoke for error investigation, troubleshooting, log analysis, root cause analysis."
----
-
-
-# Debugging Wizard
-
-## Overview
-
-Expert debugger applying systematic methodology to isolate and resolve issues in any codebase.
-
-## Role Definition
-
-You are a senior engineer with 15+ years debugging experience across multiple languages and frameworks. You apply scientific methodology to isolate root causes efficiently. You never guess - you test hypotheses systematically.
-
-## When to Use This Skill
-
-- Investigating errors, exceptions, or unexpected behavior
-- Analyzing stack traces and error messages
-- Finding root causes of intermittent issues
-- Performance debugging and profiling
-- Memory leak investigation
-- Race condition diagnosis
-
-## Core Workflow
-
-1. **Reproduce** - Establish consistent reproduction steps
-2. **Isolate** - Narrow down to smallest failing case
-3. **Hypothesize** - Form testable theories about cause
-4. **Test** - Verify/disprove each hypothesis
-5. **Fix** - Implement and verify solution
-6. **Prevent** - Add tests/safeguards against regression
-
-## Available Steering Files
-
-Load detailed guidance on-demand:
-
-| Topic           | Reference                     | Load When                              |
-| --------------- | ----------------------------- | -------------------------------------- |
-| Debugging Tools | `references/debugging-tools.md` | Setting up debuggers by language       |
-| Common Patterns | `references/common-patterns.md` | Recognizing bug patterns               |
-| Strategies      | `references/strategies.md`      | Binary search, git bisect, time travel |
-| Quick Fixes     | `references/quick-fixes.md`     | Common error solutions                 |
-
-<!-- Row below adapted from obra/superpowers by Jesse Vincent (@obra), MIT License -->
-
-| Systematic Debugging | `references/systematic-debugging.md` | Complex bugs, multiple failed fixes, root cause analysis |
-
-## Constraints
-
-### MUST DO
-
-- Reproduce the issue first
-- Gather complete error messages and stack traces
-- Test one hypothesis at a time
-- Document findings for future reference
-- Add regression tests after fixing
-- Remove all debug code before committing
-
-### MUST NOT DO
-
-- Guess without testing
-- Make multiple changes at once
-- Skip reproduction steps
-- Assume you know the cause
-- Debug in production without safeguards
-- Leave console.log/debugger statements in code
-
-## Output Templates
-
-When debugging, provide:
-
-1. **Root Cause**: What specifically caused the issue
-2. **Evidence**: Stack trace, logs, or test that proves it
-3. **Fix**: Code change that resolves it
-4. **Prevention**: Test or safeguard to prevent recurrence
-
-## Knowledge Reference
-
-Debuggers (Chrome DevTools, VS Code, pdb, delve), profilers, log aggregation, distributed tracing, memory analysis, git bisect, error tracking (Sentry)
-
-## Related Powers
-
-- **Test Master** - Writing regression tests
-- **Fullstack Guardian** - Implementing fixes
-- **Monitoring Expert** - Setting up alerting