@cubis/foundry 0.3.30 → 0.3.32

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 All notable changes to this project are documented in this file.
 
+## [0.3.31] - 2026-02-27
+
+### Changed
+
+- Renamed repository assets directory from `Ai Agent Workflow` to `workflows`.
+- Updated all CLI/scripts/package references to use the new `workflows` path.
+
 ## [0.3.30] - 2026-02-27
 
 ### Changed

package/bin/cubis.js

@@ -31,7 +31,7 @@ const TERMINAL_VERIFICATION_BLOCK_START_RE = /<!--\s*cbx:terminal:verification:s
 const TERMINAL_VERIFICATION_BLOCK_END_RE = /<!--\s*cbx:terminal:verification:end\s*-->/g;
 const ENGINEERING_RULES_BLOCK_START_RE = /<!--\s*cbx:engineering:auto:start[^>]*-->/g;
 const ENGINEERING_RULES_BLOCK_END_RE = /<!--\s*cbx:engineering:auto:end\s*-->/g;
-const AGENT_ASSETS_SUBDIR = "Ai Agent Workflow";
+const AGENT_ASSETS_SUBDIR = "workflows";
 const COPILOT_ALLOWED_SKILL_FRONTMATTER_KEYS = new Set([
   "compatibility",
   "description",
@@ -61,12 +61,23 @@ const WORKFLOW_PROFILES = {
       workflowDirs: [".agent/workflows"],
       agentDirs: [".agent/agents"],
       skillDirs: [".agent/skills"],
+      commandDirs: [".gemini/commands"],
       ruleFilesByPriority: [".agent/rules/GEMINI.md"]
     },
     global: {
-      workflowDirs: ["~/.gemini/antigravity/workflows"],
-      agentDirs: ["~/.gemini/antigravity/agents"],
-      skillDirs: ["~/.gemini/antigravity/skills"],
+      workflowDirs: [
+        "~/.gemini/antigravity/workflows",
+        "~/.gemini/antigravity/global_workflows"
+      ],
+      agentDirs: [
+        "~/.gemini/antigravity/agents",
+        "~/.gemini/antigravity/global_agents"
+      ],
+      skillDirs: [
+        "~/.gemini/antigravity/skills",
+        "~/.gemini/antigravity/global_skills"
+      ],
+      commandDirs: ["~/.gemini/commands"],
       ruleFilesByPriority: ["~/.gemini/GEMINI.md"]
     },
     detectorPaths: [".agent", ".agent/workflows", ".agent/rules/GEMINI.md"],
@@ -101,12 +112,14 @@ const WORKFLOW_PROFILES = {
       workflowDirs: [".github/copilot/workflows"],
       agentDirs: [".github/agents"],
       skillDirs: [".github/skills"],
+      promptDirs: [".github/prompts"],
       ruleFilesByPriority: ["AGENTS.md", ".github/copilot-instructions.md"]
     },
     global: {
       workflowDirs: ["~/.copilot/workflows"],
       agentDirs: ["~/.copilot/agents"],
       skillDirs: ["~/.copilot/skills"],
+      promptDirs: ["~/.copilot/prompts"],
       ruleFilesByPriority: ["~/.copilot/copilot-instructions.md"]
     },
     detectorPaths: [
@@ -1359,7 +1372,9 @@ async function recordBundleInstallState({ scope, platform, bundleId, artifacts,
     installedAt: new Date().toISOString(),
     workflows: artifacts.workflows.map(toPosixPath),
     agents: artifacts.agents.map(toPosixPath),
-    skills: artifacts.skills.map(toPosixPath)
+    skills: artifacts.skills.map(toPosixPath),
+    commands: (artifacts.commands || []).map(toPosixPath),
+    prompts: (artifacts.prompts || []).map(toPosixPath)
   };
 
   await writeState(scope, state, cwd);
@@ -1381,11 +1396,27 @@ async function resolveProfilePaths(profileId, scope, cwd = process.cwd()) {
   const profile = WORKFLOW_PROFILES[profileId];
   if (!profile) throw new Error(`Unknown platform '${profileId}'.`);
   const cfg = profile[scope];
+  const workflowDirs = Array.isArray(cfg.workflowDirs) ? cfg.workflowDirs : [];
+  const agentDirs = Array.isArray(cfg.agentDirs) ? cfg.agentDirs : [];
+  const skillDirs = Array.isArray(cfg.skillDirs) ? cfg.skillDirs : [];
+  const commandDirs = Array.isArray(cfg.commandDirs) ? cfg.commandDirs : [];
+  const promptDirs = Array.isArray(cfg.promptDirs) ? cfg.promptDirs : [];
+
+  const resolvePreferredDir = async (dirs) => {
+    if (dirs.length === 0) return null;
+    const expanded = dirs.map((dirPath) => expandPath(dirPath, cwd));
+    for (const candidate of expanded) {
+      if (await pathExists(candidate)) return candidate;
+    }
+    return expanded[0];
+  };
 
   return {
-    workflowsDir: expandPath(cfg.workflowDirs[0], cwd),
-    agentsDir: expandPath(cfg.agentDirs[0], cwd),
-    skillsDir: expandPath(cfg.skillDirs[0], cwd),
+    workflowsDir: await resolvePreferredDir(workflowDirs),
+    agentsDir: await resolvePreferredDir(agentDirs),
+    skillsDir: await resolvePreferredDir(skillDirs),
+    commandsDir: commandDirs[0] ? expandPath(commandDirs[0], cwd) : null,
+    promptsDir: promptDirs[0] ? expandPath(promptDirs[0], cwd) : null,
     ruleFilesByPriority: cfg.ruleFilesByPriority.map((filePath) => expandPath(filePath, cwd))
   };
 }
@@ -1399,7 +1430,9 @@ async function resolveArtifactProfilePaths(profileId, scope, cwd = process.cwd()
   return {
     ...scopedPaths,
     workflowsDir: workspacePaths.workflowsDir,
-    agentsDir: workspacePaths.agentsDir
+    agentsDir: workspacePaths.agentsDir,
+    commandsDir: workspacePaths.commandsDir ?? scopedPaths.commandsDir,
+    promptsDir: workspacePaths.promptsDir ?? scopedPaths.promptsDir
   };
 }
 
@@ -3643,9 +3676,14 @@ async function findNestedSkillDirs(rootDir, depth = 0, nested = []) {
     if (!entry.isDirectory()) continue;
     const childDir = path.join(rootDir, entry.name);
     const skillFile = path.join(childDir, "SKILL.md");
-    if (depth >= 1 && (await pathExists(skillFile))) {
+
+    // Treat direct children and deeper descendants as nested skills.
+    // Once a nested skill boundary is detected, stop descending further.
+    if (depth >= 0 && (await pathExists(skillFile))) {
       nested.push(childDir);
+      continue;
     }
+
     await findNestedSkillDirs(childDir, depth + 1, nested);
   }
   return nested;
@@ -3717,6 +3755,12 @@ async function installBundleArtifacts({
     if (platformInstallsCustomAgents(platform)) {
       await mkdir(profilePaths.agentsDir, { recursive: true });
     }
+    if (profilePaths.commandsDir && Array.isArray(platformSpec.commands) && platformSpec.commands.length > 0) {
+      await mkdir(profilePaths.commandsDir, { recursive: true });
+    }
+    if (profilePaths.promptsDir && Array.isArray(platformSpec.prompts) && platformSpec.prompts.length > 0) {
+      await mkdir(profilePaths.promptsDir, { recursive: true });
+    }
   }
 
   const bundleRoot = path.join(agentAssetsRoot(), "workflows", bundleId);
@@ -3724,7 +3768,7 @@ async function installBundleArtifacts({
 
   const installed = [];
   const skipped = [];
-  const artifacts = { workflows: [], agents: [], skills: [] };
+  const artifacts = { workflows: [], agents: [], skills: [], commands: [], prompts: [] };
 
   const workflowFiles = Array.isArray(platformSpec.workflows) ? platformSpec.workflows : [];
   for (const workflowFile of workflowFiles) {
@@ -3760,6 +3804,38 @@ async function installBundleArtifacts({
     else installed.push(destination);
   }
 
+  const commandFiles = Array.isArray(platformSpec.commands) ? platformSpec.commands : [];
+  for (const commandFile of commandFiles) {
+    if (!profilePaths.commandsDir) continue;
+    const source = path.join(platformRoot, "commands", commandFile);
+    const destination = path.join(profilePaths.commandsDir, path.basename(commandFile));
+
+    if (!(await pathExists(source))) {
+      throw new Error(`Missing command source file: ${source}`);
+    }
+
+    const result = await copyArtifact({ source, destination, overwrite, dryRun });
+    artifacts.commands.push(destination);
+    if (result.action === "skipped" || result.action === "would-skip") skipped.push(destination);
+    else installed.push(destination);
+  }
+
+  const promptFiles = Array.isArray(platformSpec.prompts) ? platformSpec.prompts : [];
+  for (const promptFile of promptFiles) {
+    if (!profilePaths.promptsDir) continue;
+    const source = path.join(platformRoot, "prompts", promptFile);
+    const destination = path.join(profilePaths.promptsDir, path.basename(promptFile));
+
+    if (!(await pathExists(source))) {
+      throw new Error(`Missing prompt source file: ${source}`);
+    }
+
+    const result = await copyArtifact({ source, destination, overwrite, dryRun });
+    artifacts.prompts.push(destination);
+    if (result.action === "skipped" || result.action === "would-skip") skipped.push(destination);
+    else installed.push(destination);
+  }
+
   const skillIds = await resolveInstallSkillIds({
     platformSpec,
     extraSkillIds
@@ -3969,6 +4045,18 @@ async function removeBundleArtifacts({
     if (await safeRemove(destination, dryRun)) removed.push(destination);
   }
 
+  for (const commandFile of platformSpec.commands || []) {
+    if (!profilePaths.commandsDir) continue;
+    const destination = path.join(profilePaths.commandsDir, path.basename(commandFile));
+    if (await safeRemove(destination, dryRun)) removed.push(destination);
+  }
+
+  for (const promptFile of platformSpec.prompts || []) {
+    if (!profilePaths.promptsDir) continue;
+    const destination = path.join(profilePaths.promptsDir, path.basename(promptFile));
+    if (await safeRemove(destination, dryRun)) removed.push(destination);
+  }
+
   const skillIds = await resolveInstallSkillIds({ platformSpec, extraSkillIds: [] });
   for (const skillId of skillIds) {
     const destination = path.join(profilePaths.skillsDir, skillId);
@@ -3997,14 +4085,26 @@ function printPlatforms() {
       `  project agents:    ${agentsEnabled ? profile.project.agentDirs[0] : "(disabled for this platform)"}`
     );
     console.log(`  project skills:    ${profile.project.skillDirs[0]}`);
+    if (Array.isArray(profile.project.commandDirs) && profile.project.commandDirs.length > 0) {
+      console.log(`  project commands:  ${profile.project.commandDirs[0]}`);
+    }
+    if (Array.isArray(profile.project.promptDirs) && profile.project.promptDirs.length > 0) {
+      console.log(`  project prompts:   ${profile.project.promptDirs[0]}`);
+    }
     console.log(`  project rules:     ${profile.project.ruleFilesByPriority.join(" | ")}`);
     console.log(`  global workflows:  ${profile.global.workflowDirs[0]}`);
     console.log(
       `  global agents:     ${agentsEnabled ? profile.global.agentDirs[0] : "(disabled for this platform)"}`
     );
     console.log(`  global skills:     ${profile.global.skillDirs[0]}`);
+    if (Array.isArray(profile.global.commandDirs) && profile.global.commandDirs.length > 0) {
+      console.log(`  global commands:   ${profile.global.commandDirs[0]}`);
+    }
+    if (Array.isArray(profile.global.promptDirs) && profile.global.promptDirs.length > 0) {
+      console.log(`  global prompts:    ${profile.global.promptDirs[0]}`);
+    }
     console.log(`  global rules:      ${profile.global.ruleFilesByPriority.join(" | ")}`);
-    console.log("  default install:   workflows/agents -> project, skills -> global");
+    console.log("  default install:   workflows/agents/commands/prompts -> project, skills -> global");
   }
 }
 
@@ -4225,6 +4325,16 @@ async function createDoctorReport({ platform, scope, cwd = process.cwd() }) {
     skills: {
       path: artifactPaths.skillsDir,
       exists: await pathExists(artifactPaths.skillsDir)
+    },
+    commands: {
+      path: artifactPaths.commandsDir,
+      enabled: Boolean(artifactPaths.commandsDir),
+      exists: artifactPaths.commandsDir ? await pathExists(artifactPaths.commandsDir) : null
+    },
+    prompts: {
+      path: artifactPaths.promptsDir,
+      enabled: Boolean(artifactPaths.promptsDir),
+      exists: artifactPaths.promptsDir ? await pathExists(artifactPaths.promptsDir) : null
     }
   };
 
@@ -4306,9 +4416,11 @@ async function createDoctorReport({ platform, scope, cwd = process.cwd() }) {
   if (
     !pathStatus.workflows.exists &&
     !pathStatus.skills.exists &&
-    !(pathStatus.agents.enabled && pathStatus.agents.exists)
+    !(pathStatus.agents.enabled && pathStatus.agents.exists) &&
+    !(pathStatus.commands.enabled && pathStatus.commands.exists) &&
+    !(pathStatus.prompts.enabled && pathStatus.prompts.exists)
   ) {
-    recommendations.push("No workflow/agent/skill directories found in this scope.");
+    recommendations.push("No workflow/agent/skill/command/prompt directories found in this scope.");
   }
 
   if (platform === "codex" && scope === "project") {
@@ -4369,6 +4481,20 @@ async function createDoctorReport({ platform, scope, cwd = process.cwd() }) {
     );
   }
 
+  if (platform === "antigravity" && pathStatus.workflows.exists && pathStatus.commands.enabled && !pathStatus.commands.exists) {
+    warnings.push("Antigravity workflows are present but .gemini/commands is missing.");
+    recommendations.push(
+      `Reinstall to generate command files: cbx workflows install --platform antigravity --bundle agent-environment-setup --scope ${scope} --overwrite`
+    );
+  }
+
+  if (platform === "copilot" && pathStatus.workflows.exists && pathStatus.prompts.enabled && !pathStatus.prompts.exists) {
+    warnings.push("Copilot workflows are present but prompts directory is missing.");
+    recommendations.push(
+      `Reinstall to generate prompt files: cbx workflows install --platform copilot --bundle agent-environment-setup --scope ${scope} --overwrite`
+    );
+  }
+
   if (platform === "copilot" && pathStatus.skills.exists) {
     const findings = await validateCopilotSkillsSchema(artifactPaths.skillsDir);
     if (findings.length > 0) {
@@ -4434,6 +4560,16 @@ function printDoctorReport(report) {
     console.log(`- Agents: ${report.paths.agents.path} : ${report.paths.agents.exists ? "exists" : "missing"}`);
   }
   console.log(`- Skills: ${report.paths.skills.path} : ${report.paths.skills.exists ? "exists" : "missing"}`);
+  if (report.paths.commands.enabled === false) {
+    console.log(`- Commands: (disabled)`);
+  } else {
+    console.log(`- Commands: ${report.paths.commands.path} : ${report.paths.commands.exists ? "exists" : "missing"}`);
+  }
+  if (report.paths.prompts.enabled === false) {
+    console.log(`- Prompts: (disabled)`);
+  } else {
+    console.log(`- Prompts: ${report.paths.prompts.path} : ${report.paths.prompts.exists ? "exists" : "missing"}`);
+  }
 
   console.log("\nManaged block:");
   console.log(`- Status: ${report.managedBlockStatus}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cubis/foundry",
-  "version": "0.3.30",
+  "version": "0.3.32",
   "description": "Cubis Foundry CLI for workflow-first AI agent environments",
   "type": "module",
   "bin": {
@@ -10,7 +10,7 @@
   },
   "files": [
     "bin",
-    "Ai Agent Workflow",
+    "workflows",
     "README.md",
     "CHANGELOG.md"
   ],
@@ -23,10 +23,13 @@
     "test:smoke": "bash scripts/smoke-workflows.sh",
     "test:all": "npm run test:attributes && npm run test:smoke",
     "test:all:strict": "npm run test:attributes:strict && npm run test:smoke",
-    "generate:powers": "node \"Ai Agent Workflow/scripts/generate-powers.mjs\"",
-    "generate:powers:force": "node \"Ai Agent Workflow/scripts/generate-powers.mjs\" --force",
-    "generate:powers:from-skills": "node \"Ai Agent Workflow/scripts/generate-powers.mjs\" --from-skills",
-    "generate:powers:sync": "node \"Ai Agent Workflow/scripts/generate-powers.mjs\" --sync-skills --force"
+    "generate:platform-assets": "node scripts/generate-platform-assets.mjs",
+    "sync:skill-mirrors": "node scripts/sync-skill-mirrors.mjs",
+    "generate:skills-index": "node scripts/generate-skills-index.mjs",
+    "generate:powers": "node \"workflows/scripts/generate-powers.mjs\"",
+    "generate:powers:force": "node \"workflows/scripts/generate-powers.mjs\" --force",
+    "generate:powers:from-skills": "node \"workflows/scripts/generate-powers.mjs\" --from-skills",
+    "generate:powers:sync": "node \"workflows/scripts/generate-powers.mjs\" --sync-skills --force"
   },
   "engines": {
     "node": ">=18.17"

package/workflows/powers/database-design/POWER.md

@@ -0,0 +1,13 @@
+---
+name: database-design
+description: Database design principles and decision-making. Schema design, indexing strategy, ORM selection, serverless databases.
+---
+
+# database-design
+
+This is a compatibility power wrapper for the `database-design` skill.
+
+Primary source:
+- `workflows/skills/database-design/SKILL.md`
+
+Use this folder for power-specific extensions when needed.

package/workflows/powers/database-design/SKILL.md

@@ -0,0 +1,11 @@
+---
+name: database-design
+description: Database design principles and decision-making. Schema design, indexing strategy, ORM selection, serverless databases.
+---
+
+# database-design
+
+This power mirrors the base skill:
+- `workflows/skills/database-design/SKILL.md`
+
+When both exist, prefer the base skill as source of truth unless power-specific overrides are added here.

package/workflows/powers/database-skills/engines/mongodb/POWER.md

@@ -0,0 +1,10 @@
+# mongodb
+
+Source skill:
+- `workflows/skills/database-skills/skills/mongodb/SKILL.md`
+
+Focus:
+- Access-pattern-first schema design
+- Compound index strategy
+- Cursor/range pagination over deep `skip`
+- `explain("executionStats")` evidence

package/workflows/powers/database-skills/engines/mysql/POWER.md

@@ -0,0 +1,10 @@
+# mysql
+
+Source skill:
+- `workflows/skills/database-skills/skills/mysql/SKILL.md`
+
+Focus:
+- Composite/covering index design
+- Keyset pagination with stable ordering
+- `EXPLAIN` / `EXPLAIN ANALYZE` evidence
+- Online DDL lock and replication risk checks

package/workflows/powers/database-skills/engines/neki/POWER.md

@@ -0,0 +1,10 @@
+# neki
+
+Source skill:
+- `workflows/skills/database-skills/skills/neki/SKILL.md`
+
+Focus:
+- Shard key and locality planning
+- Cross-shard boundary minimization
+- Reversible migration milestones
+- Explicit assumption tracking (pre-GA)

package/workflows/powers/database-skills/engines/postgres/POWER.md

@@ -0,0 +1,10 @@
+# postgres
+
+Source skill:
+- `workflows/skills/database-skills/skills/postgres/SKILL.md`
+
+Focus:
+- Multicolumn/partial/INCLUDE indexes
+- Keyset pagination for deep lists
+- `EXPLAIN (ANALYZE, BUFFERS)` evidence
+- Vacuum/autovacuum and stats health

package/workflows/powers/database-skills/engines/redis/POWER.md

@@ -0,0 +1,10 @@
+# redis
+
+Source skill:
+- `workflows/skills/database-skills/skills/redis/SKILL.md`
+
+Focus:
+- Key schema as access index
+- Sorted set and SCAN-based pagination patterns
+- Pipeline/batching throughput optimization
+- Memory/latency diagnostics and eviction safety

package/workflows/powers/database-skills/engines/sqlite/POWER.md

@@ -0,0 +1,10 @@
+# sqlite
+
+Source skill:
+- `workflows/skills/database-skills/skills/sqlite/SKILL.md`
+
+Focus:
+- `EXPLAIN QUERY PLAN` verification
+- Multicolumn/covering index design
+- Keyset pagination for large local datasets
+- WAL/checkpoint tuning and transaction batching

package/workflows/powers/database-skills/engines/supabase/POWER.md

@@ -0,0 +1,10 @@
+# supabase
+
+Source skill:
+- `workflows/skills/database-skills/skills/supabase/SKILL.md`
+
+Focus:
+- RLS policy correctness and predicate indexing
+- Keyset pagination for heavy endpoints
+- Query optimization + advisor workflow
+- Pooler mode and managed/self-host compatibility checks

package/workflows/powers/database-skills/engines/vitess/POWER.md

@@ -0,0 +1,10 @@
+# vitess
+
+Source skill:
+- `workflows/skills/database-skills/skills/vitess/SKILL.md`
+
+Focus:
+- Vindex and VSchema routing quality
+- Shard-local query design
+- Shard-aware seek pagination
+- Resharding rollout + rollback safety