@cubis/foundry 0.3.18 → 0.3.20

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

@@ -13,6 +13,18 @@ This file defines mandatory behavior for Antigravity projects installed via `cbx
 - Skills: `.agent/skills`
 - Rules file: `.agent/rules/GEMINI.md`
 
+## Startup Transparency (Required)
+
+Before executing workflows, agents, or code edits, publish a short `Decision Log` that is visible to the user:
+
+1. Rule file(s) read at startup (at minimum `.agent/rules/GEMINI.md`, plus any additional rule files loaded).
+2. Workflow decision (`/workflow` or direct mode) and why it was chosen.
+3. Agent routing decision (`@agent` or direct mode) and why it was chosen.
+4. Skill loading decision (skill names loaded) and why they were chosen.
+
+If routing changes during the task, publish a `Decision Update` before continuing.
+Keep this user-visible summary concise and factual; do not expose private chain-of-thought.
+
 ## 2) Workflow-First Contract
 
 1. If the user explicitly requests a slash command, run that workflow first.
@@ -83,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

@@ -9,6 +9,18 @@ This file defines mandatory behavior for Codex projects installed via `cbx workf
 - Skills: `.agents/skills`
 - Rules file: `AGENTS.md`
 
+## Startup Transparency (Required)
+
+Before executing workflows, agents, or code edits, publish a short `Decision Log` that is visible to the user:
+
+1. Rule file(s) read at startup (at minimum `AGENTS.md`, plus any additional rule files loaded).
+2. Workflow decision (`$workflow-*` or direct mode) and why it was chosen.
+3. Agent routing decision (`$agent-*` or direct mode) and why it was chosen.
+4. Skill loading decision (skill names loaded) and why they were chosen.
+
+If routing changes during the task, publish a `Decision Update` before continuing.
+Keep this user-visible summary concise and factual; do not expose private chain-of-thought.
+
 ## 2) Skill-Based Workflow
 
 1. Codex operates primarily through **Skills** and **Rules**.
@@ -73,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

@@ -9,6 +9,18 @@ This file defines mandatory behavior for GitHub Copilot projects installed via `
 - Skills: `.github/skills`
 - Rules file (project): `.github/copilot-instructions.md`
 
+## Startup Transparency (Required)
+
+Before executing workflows, agents, or code edits, publish a short `Decision Log` that is visible to the user:
+
+1. Rule file(s) read at startup (at minimum `.github/copilot-instructions.md`, plus any additional rule files loaded).
+2. Workflow decision (`/workflow` or direct mode) and why it was chosen.
+3. Agent routing decision (`@agent` or direct mode) and why it was chosen.
+4. Skill loading decision (skill names loaded) and why they were chosen.
+
+If routing changes during the task, publish a `Decision Update` before continuing.
+Keep this user-visible summary concise and factual; do not expose private chain-of-thought.
+
 ## 2) Workflow-First Contract
 
 1. If the user explicitly requests a slash command, run that workflow first.
@@ -82,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

@@ -9,6 +9,18 @@ This file defines mandatory behavior for GitHub Copilot projects installed via `
 - Skills: `.github/skills`
 - Rules file (project): `.github/copilot-instructions.md`
 
+## Startup Transparency (Required)
+
+Before executing workflows, agents, or code edits, publish a short `Decision Log` that is visible to the user:
+
+1. Rule file(s) read at startup (at minimum `.github/copilot-instructions.md`, plus any additional rule files loaded).
+2. Workflow decision (`/workflow` or direct mode) and why it was chosen.
+3. Agent routing decision (`@agent` or direct mode) and why it was chosen.
+4. Skill loading decision (skill names loaded) and why they were chosen.
+
+If routing changes during the task, publish a `Decision Update` before continuing.
+Keep this user-visible summary concise and factual; do not expose private chain-of-thought.
+
 ## 2) Workflow-First Contract
 
 1. If the user explicitly requests a slash command, run that workflow first.
@@ -82,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

@@ -9,6 +9,18 @@ This file defines mandatory behavior for Cursor projects installed via `cbx work
 - Skills: `.cursor/skills`
 - Rules file: `.cursorrules`
 
+## Startup Transparency (Required)
+
+Before executing workflows, agents, or code edits, publish a short `Decision Log` that is visible to the user:
+
+1. Rule file(s) read at startup (at minimum `.cursorrules`, plus any additional rule files loaded).
+2. Workflow decision (`/workflow` or direct mode) and why it was chosen.
+3. Agent routing decision (`@agent` or direct mode) and why it was chosen.
+4. Skill loading decision (skill names loaded) and why they were chosen.
+
+If routing changes during the task, publish a `Decision Update` before continuing.
+Keep this user-visible summary concise and factual; do not expose private chain-of-thought.
+
 ## 2) Smart Skill Selection (TIER 0)
 
 Before starting ANY task, the agent MUST:
@@ -65,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

@@ -9,6 +9,18 @@ This file defines mandatory behavior for Windsurf projects installed via `cbx wo
 - Skills: `.windsurf/skills`
 - Rules file: `.windsurfrules`
 
+## Startup Transparency (Required)
+
+Before executing workflows, agents, or code edits, publish a short `Decision Log` that is visible to the user:
+
+1. Rule file(s) read at startup (at minimum `.windsurfrules`, plus any additional rule files loaded).
+2. Workflow decision (`/workflow` or direct mode) and why it was chosen.
+3. Agent routing decision (`@agent` or direct mode) and why it was chosen.
+4. Skill loading decision (skill names loaded) and why they were chosen.
+
+If routing changes during the task, publish a `Decision Update` before continuing.
+Keep this user-visible summary concise and factual; do not expose private chain-of-thought.
+
 ## 2) Smart Skill Selection (TIER 0)
 
 Before starting ANY task, the agent MUST:
@@ -65,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,7 @@ 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`, workflow/skill/agent artifacts install to global paths, but rule sync + engineering artifacts are maintained in workspace (`project`) scope.
 - 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.
 
@@ -252,10 +253,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`.
+  - Rule files (`AGENTS.md`/`GEMINI.md`/Copilot instructions) and engineering files (`ENGINEERING_RULES.md`, `TECH.md`) are still updated in workspace (`project`) scope during install.
+- 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

@@ -3319,7 +3319,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(
@@ -3474,6 +3476,7 @@ async function cleanupAntigravityTerminalIntegration({
 async function runWorkflowInstall(options) {
   try {
     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 bundleId = await chooseBundle(options.bundle);
@@ -3516,7 +3519,7 @@ async function runWorkflowInstall(options) {
       bundleId,
       manifest,
       platform,
-      scope,
+      scope: ruleScope,
       overwrite: Boolean(options.overwrite),
       dryRun,
       cwd: process.cwd()
@@ -3524,13 +3527,13 @@ async function runWorkflowInstall(options) {
 
     const syncResult = await syncRulesForPlatform({
       platform,
-      scope,
+      scope: ruleScope,
       dryRun,
       cwd: process.cwd()
     });
     const engineeringArtifactsResult = await upsertEngineeringArtifacts({
       platform,
-      scope,
+      scope: ruleScope,
       overwrite: false,
       dryRun,
       skipTech: false,
@@ -3548,7 +3551,7 @@ async function runWorkflowInstall(options) {
     const terminalVerificationRuleResult =
       platform === "antigravity" && installResult.terminalIntegration
         ? await upsertTerminalVerificationForInstall({
-            scope,
+            scope: ruleScope,
             cwd: process.cwd(),
             terminalIntegration: installResult.terminalIntegration,
             dryRun
@@ -3590,7 +3593,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") {

package/package.json

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