@cubis/foundry 0.3.19 → 0.3.21

package/Ai Agent Workflow/workflows/agent-environment-setup/platforms/antigravity/rules/GEMINI.md

@@ -95,7 +95,7 @@ If Antigravity script harness exists, prefer:
 Use these commands to keep this setup healthy:
 
 - Install/update bundle:
-  `cbx workflows install --platform antigravity --bundle agent-environment-setup --scope project --overwrite`
+  `cbx workflows install --platform antigravity --bundle agent-environment-setup --scope global --overwrite`
 - Rebuild managed routing block:
   `cbx workflows sync-rules --platform antigravity --scope project`
 - Diagnose setup issues:

package/Ai Agent Workflow/workflows/agent-environment-setup/platforms/codex/rules/AGENTS.md

@@ -85,7 +85,7 @@ Before multi-file or architecture-impacting changes, ask targeted questions when
 Use these commands to keep this setup healthy:
 
 - Install/update bundle:
-  `cbx workflows install --platform codex --bundle agent-environment-setup --scope project --overwrite`
+  `cbx workflows install --platform codex --bundle agent-environment-setup --scope global --overwrite`
 - Rebuild managed routing block:
   `cbx workflows sync-rules --platform codex --scope project`
 - Diagnose setup issues:

package/Ai Agent Workflow/workflows/agent-environment-setup/platforms/copilot/rules/AGENTS.md

@@ -94,7 +94,7 @@ Before multi-file or architecture-impacting changes, ask targeted questions when
 Use these commands to keep this setup healthy:
 
 - Install/update bundle:
-  `cbx workflows install --platform copilot --bundle agent-environment-setup --scope project --overwrite`
+  `cbx workflows install --platform copilot --bundle agent-environment-setup --scope global --overwrite`
 - Rebuild managed routing block:
   `cbx workflows sync-rules --platform copilot --scope project`
 - Diagnose setup issues:

package/Ai Agent Workflow/workflows/agent-environment-setup/platforms/copilot/rules/copilot-instructions.md

@@ -94,7 +94,7 @@ Before multi-file or architecture-impacting changes, ask targeted questions when
 Use these commands to keep this setup healthy:
 
 - Install/update bundle:
-  `cbx workflows install --platform copilot --bundle agent-environment-setup --scope project --overwrite`
+  `cbx workflows install --platform copilot --bundle agent-environment-setup --scope global --overwrite`
 - Rebuild managed routing block:
   `cbx workflows sync-rules --platform copilot --scope project`
 - Diagnose setup issues:

package/Ai Agent Workflow/workflows/agent-environment-setup/platforms/cursor/rules/.cursorrules

@@ -77,7 +77,7 @@ Before multi-file or architecture-impacting changes, ask targeted questions when
 Use these commands to keep this setup healthy:
 
 - Install/update bundle:
-  `cbx workflows install --platform cursor --bundle agent-environment-setup --scope project --overwrite`
+  `cbx workflows install --platform cursor --bundle agent-environment-setup --scope global --overwrite`
 - Rebuild managed routing block:
   `cbx workflows sync-rules --platform cursor --scope project`
 - Diagnose setup issues:

package/Ai Agent Workflow/workflows/agent-environment-setup/platforms/windsurf/rules/.windsurfrules

@@ -77,7 +77,7 @@ Before multi-file or architecture-impacting changes, ask targeted questions when
 Use these commands to keep this setup healthy:
 
 - Install/update bundle:
-  `cbx workflows install --platform windsurf --bundle agent-environment-setup --scope project --overwrite`
+  `cbx workflows install --platform windsurf --bundle agent-environment-setup --scope global --overwrite`
 - Rebuild managed routing block:
   `cbx workflows sync-rules --platform windsurf --scope project`
 - Diagnose setup issues:

package/README.md

@@ -60,6 +60,9 @@ cbx workflows install --platform copilot --postman
 
 Install bootstrap behavior:
 - `cbx workflows install` now also bootstraps `ENGINEERING_RULES.md` and `TECH.md` (creates when missing; keeps existing files unless explicitly regenerated).
+- When install scope is `global` (default), skills/powers install to global paths, while workflows + agents stay in workspace (`project`) paths.
+- Rule sync + engineering artifacts (`AGENTS.md`/`GEMINI.md`/Copilot instructions, `ENGINEERING_RULES.md`, `TECH.md`) are maintained in workspace (`project`) scope.
+- Codex workflow templates are maintained in workspace `.agents/workflows` so workflow-wrapper routing remains discoverable in project rules.
 - Optional `--postman` bootstrap creates `postman_setting.json` and installs/configures the Postman skill/MCP for Codex, Antigravity, and Copilot.
 - Use `cbx rules init --platform <platform> --overwrite` to force-regenerate both files.
 
@@ -176,11 +179,9 @@ Project scope:
 - Terminal integration (optional): `.agent/terminal-integration`
 
 Global scope:
-- Workflows: `~/.gemini/antigravity/workflows`
-- Agents: `~/.gemini/antigravity/agents`
 - Skills: `~/.gemini/antigravity/skills`
 - Rules: `~/.gemini/GEMINI.md`
-- Terminal integration (optional): `~/.gemini/antigravity/terminal-integration`
+- Workflows/agents/terminal-integration: default install keeps these in workspace (`.agent/...`) paths.
 
 ### Antigravity Terminal Integration (Optional)
 
@@ -190,7 +191,7 @@ Install-time options:
 
 Behavior:
 - Interactive installs prompt whether to enable terminal verification integration.
-- If enabled, cbx writes managed scripts/config under `.agent/terminal-integration` (or global equivalent).
+- If enabled, cbx writes managed scripts/config under `.agent/terminal-integration`.
 - cbx also writes a managed terminal verification block into Antigravity rule files so post-task verification commands are explicit.
 - Removing the bundle cleans the managed terminal integration directory and block.
 
@@ -207,9 +208,9 @@ Project scope:
   - Example usage: `$workflow-plan`, `$agent-backend-specialist`
 
 Global scope:
-- Workflow templates (reference docs): `~/.agents/workflows`
 - Skills: `~/.agents/skills`
 - Rules: `~/.codex/AGENTS.md`
+- Workflow templates (reference docs): default install keeps these in workspace `.agents/workflows`
 - Agents: not installed for Codex runtime
 
 Legacy compatibility note:
@@ -225,10 +226,9 @@ Project scope:
 - Skill schema note: `cbx` normalizes Copilot skill frontmatter by removing unsupported top-level keys like `displayName` and `keywords` during install.
 
 Global scope:
-- Workflows: `~/.copilot/workflows`
-- Agents: `~/.copilot/agents`
 - Skills: `~/.copilot/skills`
 - Rules: `~/.copilot/copilot-instructions.md`
+- Workflows/agents: default install keeps these in workspace (`.github/...`) paths.
 
 ## Rule Auto-Sync
 
@@ -252,10 +252,20 @@ Behavior:
 ## Scope and Detection
 
 Default scope:
-- `project`
+- Install/init commands:
+  - `cbx workflows install`
+  - `cbx workflows init`
+  - `cbx skills install`
+  - `cbx skills init`
+  - `cbx install` (legacy alias)
+  - `cbx init` (legacy alias)
+  - Default scope for these commands is `global`.
+  - In this default global mode, only skills/powers install globally. Workflows/agents and rule/engineering files remain workspace-scoped.
+- Other workflow/rules commands default to `project`.
 
 Optional:
 - `--scope global`
+- `--scope project`
 
 Platform auto-detection:
 - Uses repo markers for Antigravity/Codex/Copilot.

package/bin/cubis.js

@@ -1295,6 +1295,19 @@ async function resolveProfilePaths(profileId, scope, cwd = process.cwd()) {
   };
 }
 
+async function resolveArtifactProfilePaths(profileId, scope, cwd = process.cwd()) {
+  const scopedPaths = await resolveProfilePaths(profileId, scope, cwd);
+  if (scope !== "global") return scopedPaths;
+
+  // Global install mode is skills-only. Keep workflows/agents in workspace scope.
+  const workspacePaths = await resolveProfilePaths(profileId, "project", cwd);
+  return {
+    ...scopedPaths,
+    workflowsDir: workspacePaths.workflowsDir,
+    agentsDir: workspacePaths.agentsDir
+  };
+}
+
 async function listBundleIds() {
   const root = path.join(agentAssetsRoot(), "workflows");
   if (!(await pathExists(root))) return [];
@@ -2632,12 +2645,13 @@ async function installBundleArtifacts({
   platform,
   scope,
   overwrite,
+  profilePathsOverride = null,
   extraSkillIds = [],
   terminalVerifierSelection = null,
   dryRun = false,
   cwd = process.cwd()
 }) {
-  const profilePaths = await resolveProfilePaths(platform, scope, cwd);
+  const profilePaths = profilePathsOverride || (await resolveArtifactProfilePaths(platform, scope, cwd));
   const platformSpec = manifest.platforms?.[platform];
 
   if (!platformSpec) {
@@ -2766,6 +2780,46 @@ async function installBundleArtifacts({
   };
 }
 
+async function installCodexProjectWorkflowTemplates({
+  bundleId,
+  manifest,
+  overwrite,
+  dryRun = false,
+  cwd = process.cwd()
+}) {
+  const platform = "codex";
+  const platformSpec = manifest.platforms?.[platform];
+  if (!platformSpec) return { installed: [], skipped: [] };
+
+  const workflowFiles = Array.isArray(platformSpec.workflows) ? platformSpec.workflows : [];
+  if (workflowFiles.length === 0) return { installed: [], skipped: [] };
+
+  const profilePaths = await resolveProfilePaths(platform, "project", cwd);
+  if (!dryRun) {
+    await mkdir(profilePaths.workflowsDir, { recursive: true });
+  }
+
+  const bundleRoot = path.join(agentAssetsRoot(), "workflows", bundleId);
+  const platformRoot = path.join(bundleRoot, "platforms", platform);
+  const installed = [];
+  const skipped = [];
+
+  for (const workflowFile of workflowFiles) {
+    const source = path.join(platformRoot, "workflows", workflowFile);
+    const destination = path.join(profilePaths.workflowsDir, path.basename(workflowFile));
+
+    if (!(await pathExists(source))) {
+      throw new Error(`Missing workflow source file: ${source}`);
+    }
+
+    const result = await copyArtifact({ source, destination, overwrite, dryRun });
+    if (result.action === "skipped" || result.action === "would-skip") skipped.push(destination);
+    else installed.push(destination);
+  }
+
+  return { installed, skipped };
+}
+
 async function seedRuleFileFromTemplateIfMissing({
   bundleId,
   manifest,
@@ -2833,10 +2887,11 @@ async function removeBundleArtifacts({
   manifest,
   platform,
   scope,
+  profilePathsOverride = null,
   dryRun = false,
   cwd = process.cwd()
 }) {
-  const profilePaths = await resolveProfilePaths(platform, scope, cwd);
+  const profilePaths = profilePathsOverride || (await resolveArtifactProfilePaths(platform, scope, cwd));
   const platformSpec = manifest.platforms?.[platform];
   if (!platformSpec) throw new Error(`Bundle '${bundleId}' does not define platform '${platform}'.`);
 
@@ -2886,6 +2941,7 @@ function printPlatforms() {
     );
     console.log(`  global skills:     ${profile.global.skillDirs[0]}`);
     console.log(`  global rules:      ${profile.global.ruleFilesByPriority.join(" | ")}`);
+    console.log("  default install:   workflows/agents -> project, skills -> global");
   }
 }
 
@@ -3060,21 +3116,22 @@ function printRemoveSummary({
 async function createDoctorReport({ platform, scope, cwd = process.cwd() }) {
   const profile = WORKFLOW_PROFILES[platform];
   const profilePaths = await resolveProfilePaths(platform, scope, cwd);
+  const artifactPaths = await resolveArtifactProfilePaths(platform, scope, cwd);
   const agentsEnabled = platformInstallsCustomAgents(platform);
 
   const pathStatus = {
     workflows: {
-      path: profilePaths.workflowsDir,
-      exists: await pathExists(profilePaths.workflowsDir)
+      path: artifactPaths.workflowsDir,
+      exists: await pathExists(artifactPaths.workflowsDir)
     },
     agents: {
-      path: profilePaths.agentsDir,
+      path: artifactPaths.agentsDir,
       enabled: agentsEnabled,
-      exists: agentsEnabled ? await pathExists(profilePaths.agentsDir) : null
+      exists: agentsEnabled ? await pathExists(artifactPaths.agentsDir) : null
     },
     skills: {
-      path: profilePaths.skillsDir,
-      exists: await pathExists(profilePaths.skillsDir)
+      path: artifactPaths.skillsDir,
+      exists: await pathExists(artifactPaths.skillsDir)
     }
   };
 
@@ -3100,7 +3157,7 @@ async function createDoctorReport({ platform, scope, cwd = process.cwd() }) {
 
   let terminalIntegration = null;
   if (platform === "antigravity") {
-    const integrationDir = getAntigravityTerminalIntegrationDir(profilePaths);
+    const integrationDir = getAntigravityTerminalIntegrationDir(artifactPaths);
     const configPath = path.join(integrationDir, "config.json");
     const exists = await pathExists(integrationDir);
     const configExists = await pathExists(configPath);
@@ -3220,7 +3277,7 @@ async function createDoctorReport({ platform, scope, cwd = process.cwd() }) {
   }
 
   if (platform === "copilot" && pathStatus.skills.exists) {
-    const findings = await validateCopilotSkillsSchema(profilePaths.skillsDir);
+    const findings = await validateCopilotSkillsSchema(artifactPaths.skillsDir);
     if (findings.length > 0) {
       const preview = findings
         .slice(0, 5)
@@ -3236,7 +3293,7 @@ async function createDoctorReport({ platform, scope, cwd = process.cwd() }) {
   }
 
   if (platform === "copilot" && pathStatus.agents.exists) {
-    const findings = await validateCopilotAgentsSchema(profilePaths.agentsDir);
+    const findings = await validateCopilotAgentsSchema(artifactPaths.agentsDir);
     if (findings.length > 0) {
       const preview = findings
         .slice(0, 5)
@@ -3319,7 +3376,9 @@ function withWorkflowBaseOptions(command) {
 }
 
 function withInstallOptions(command) {
-  return withWorkflowBaseOptions(command)
+  return command
+    .option("-p, --platform <platform>", "target platform id")
+    .option("--scope <scope>", "target scope: project|global", "global")
     .option("-b, --bundle <bundle>", "bundle id (default: agent-environment-setup)")
     .option("--overwrite", "overwrite existing files")
     .option(
@@ -3445,7 +3504,7 @@ async function cleanupAntigravityTerminalIntegration({
   cwd,
   dryRun = false
 }) {
-  const profilePaths = await resolveProfilePaths("antigravity", scope, cwd);
+  const profilePaths = await resolveArtifactProfilePaths("antigravity", scope, cwd);
   const integrationDir = getAntigravityTerminalIntegrationDir(profilePaths);
   const dirRemoved = await safeRemove(integrationDir, dryRun);
 
@@ -3473,9 +3532,12 @@ async function cleanupAntigravityTerminalIntegration({
 
 async function runWorkflowInstall(options) {
   try {
+    const cwd = process.cwd();
     const scope = normalizeScope(options.scope);
+    const ruleScope = scope === "global" ? "project" : scope;
     const dryRun = Boolean(options.dryRun);
-    const platform = await resolvePlatform(options.platform, scope, process.cwd());
+    const platform = await resolvePlatform(options.platform, scope, cwd);
+    const artifactProfilePaths = await resolveArtifactProfilePaths(platform, scope, cwd);
     const bundleId = await chooseBundle(options.bundle);
     const manifest = await readBundleManifest(bundleId);
 
@@ -3497,7 +3559,7 @@ async function runWorkflowInstall(options) {
     const postmanSelection = await resolvePostmanInstallSelection({
       scope,
       options,
-      cwd: process.cwd()
+      cwd
     });
 
     const installResult = await installBundleArtifacts({
@@ -3506,35 +3568,51 @@ async function runWorkflowInstall(options) {
       platform,
       scope,
       overwrite: Boolean(options.overwrite),
+      profilePathsOverride: artifactProfilePaths,
       extraSkillIds: postmanSelection.enabled ? [POSTMAN_SKILL_ID] : [],
       terminalVerifierSelection,
       dryRun,
-      cwd: process.cwd()
+      cwd
     });
 
+    if (platform === "codex" && scope === "global") {
+      const codexProjectPaths = await resolveProfilePaths("codex", "project", cwd);
+      if (path.resolve(artifactProfilePaths.workflowsDir) !== path.resolve(codexProjectPaths.workflowsDir)) {
+        const codexProjectWorkflows = await installCodexProjectWorkflowTemplates({
+          bundleId,
+          manifest,
+          overwrite: Boolean(options.overwrite),
+          dryRun,
+          cwd
+        });
+        installResult.installed.push(...codexProjectWorkflows.installed);
+        installResult.skipped.push(...codexProjectWorkflows.skipped);
+      }
+    }
+
     await seedRuleFileFromTemplateIfMissing({
       bundleId,
       manifest,
       platform,
-      scope,
+      scope: ruleScope,
       overwrite: Boolean(options.overwrite),
       dryRun,
-      cwd: process.cwd()
+      cwd
     });
 
     const syncResult = await syncRulesForPlatform({
       platform,
-      scope,
+      scope: ruleScope,
       dryRun,
-      cwd: process.cwd()
+      cwd
     });
     const engineeringArtifactsResult = await upsertEngineeringArtifacts({
       platform,
-      scope,
+      scope: ruleScope,
       overwrite: false,
       dryRun,
       skipTech: false,
-      cwd: process.cwd()
+      cwd
     });
     const postmanSetupResult = await configurePostmanInstallArtifacts({
       scope,
@@ -3542,14 +3620,14 @@ async function runWorkflowInstall(options) {
       postmanSelection,
       overwrite: Boolean(options.overwrite),
       dryRun,
-      cwd: process.cwd()
+      cwd
     });
 
     const terminalVerificationRuleResult =
       platform === "antigravity" && installResult.terminalIntegration
         ? await upsertTerminalVerificationForInstall({
-            scope,
-            cwd: process.cwd(),
+            scope: ruleScope,
+            cwd,
             terminalIntegration: installResult.terminalIntegration,
             dryRun
           })
@@ -3562,7 +3640,7 @@ async function runWorkflowInstall(options) {
         bundleId,
         artifacts: installResult.artifacts,
         ruleFilePath: syncResult.filePath,
-        cwd: process.cwd()
+        cwd
       });
     }
 
@@ -3590,7 +3668,7 @@ async function runWorkflowInstall(options) {
     if (dryRun) {
       console.log("\nDry-run complete. Re-run without `--dry-run` to apply changes.");
     } else {
-      console.log("\nTip: run `cbx workflows doctor --platform " + platform + " --scope " + scope + "`.");
+      console.log("\nTip: run `cbx workflows doctor --platform " + platform + " --scope " + ruleScope + "`.");
     }
   } catch (error) {
     if (error?.name === "ExitPromptError") {
@@ -3608,9 +3686,12 @@ async function runWorkflowRemove(target, options) {
       throw new Error("Missing <bundle-or-workflow>. Usage: cbx workflows remove <bundle-or-workflow>");
     }
 
+    const cwd = process.cwd();
     const scope = normalizeScope(options.scope);
+    const ruleScope = scope === "global" ? "project" : scope;
     const dryRun = Boolean(options.dryRun);
-    const platform = await resolvePlatform(options.platform, scope, process.cwd());
+    const platform = await resolvePlatform(options.platform, scope, cwd);
+    const artifactProfilePaths = await resolveArtifactProfilePaths(platform, scope, cwd);
     const bundleIds = await listBundleIds();
 
     let removed = [];
@@ -3637,8 +3718,9 @@ async function runWorkflowRemove(target, options) {
         manifest,
         platform,
         scope,
+        profilePathsOverride: artifactProfilePaths,
         dryRun,
-        cwd: process.cwd()
+        cwd
       });
 
       removed = removeResult.removed;
@@ -3646,7 +3728,7 @@ async function runWorkflowRemove(target, options) {
       if (platform === "antigravity") {
         terminalIntegrationCleanup = await cleanupAntigravityTerminalIntegration({
           scope,
-          cwd: process.cwd(),
+          cwd,
           dryRun
         });
         if (terminalIntegrationCleanup.dirRemoved) {
@@ -3654,8 +3736,7 @@ async function runWorkflowRemove(target, options) {
         }
       }
     } else {
-      const profilePaths = await resolveProfilePaths(platform, scope, process.cwd());
-      const workflowFile = await findWorkflowFileByTarget(profilePaths.workflowsDir, target);
+      const workflowFile = await findWorkflowFileByTarget(artifactProfilePaths.workflowsDir, target);
 
       if (!workflowFile) {
         throw new Error(`Could not find workflow or bundle '${target}' in platform '${platform}'.`);
@@ -3679,9 +3760,9 @@ async function runWorkflowRemove(target, options) {
 
     const syncResult = await syncRulesForPlatform({
       platform,
-      scope,
+      scope: ruleScope,
       dryRun,
-      cwd: process.cwd()
+      cwd
     });
 
     if (!dryRun && removedType === "bundle") {
@@ -3690,7 +3771,7 @@ async function runWorkflowRemove(target, options) {
         platform,
         bundleId: target,
         ruleFilePath: syncResult.filePath,
-        cwd: process.cwd()
+        cwd
       });
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cubis/foundry",
-  "version": "0.3.19",
+  "version": "0.3.21",
   "description": "Cubis Foundry CLI for workflow-first AI agent environments",
   "type": "module",
   "bin": {