All notable changes to this project are documented in this file.
- Fixed skill loading protocol across all platforms (Codex, Copilot, Claude, Antigravity): agents now load skills recommended by
route_resolve(primarySkillHint,primarySkills[0],detectedLanguageSkill) before executing non-trivial tasks instead of ignoring them. - Added TIER 1b to the managed skill-routing block so
cbx workflows sync-rulespropagates the post-route skill loading rule to installed projects. - Corrected the Codex sandbox override note to explicitly name the Foundry MCP tools and the expected post-route loading behavior.
- Synced stale power SKILL.md for frontend-design (was v1 with broken refs, now v3.0 matching canonical skill).
- Regenerated all 47 power SKILL.md mirrors from canonical skills and 121 POWER.md wrappers.
- Re-synced 88 skills across copilot and claude platform mirrors.
- Simplified Decision Log response contract:
- Removed
Files Usedsection (no more full absolute path listings). Skills Usednow lists skill, workflow, or agent names instead of full file paths.- Reduced engineering guardrail items from 9 to 8.
- Removed
- Clarified Postman MCP guidance across skills, workflows, README, and platform rule templates:
- direct
postmanMCP server is now the explicit execution path for collections, workspaces, environments, monitors, and runs - Foundry
postman_*tools are documented as config/status helpers only.
- direct
- Added quota-safe Postman execution guidance:
- no automatic
runCollection->runMonitorfallback - Postman CLI is the recommended secondary path after direct MCP execution fails
- monitor quota, API rate limits, and runtime timeouts are documented as separate failure classes.
- no automatic
cbx initnow keeps MCP runtime selection available whencubis-foundryis the only MCP selected.- Foundry MCP install/config patching now respects the selected runtime:
- local runtime keeps the
cbx mcp servestdio registration - docker runtime points supported clients at the local Docker MCP endpoint
- local runtime keeps the
cbx workflows config --mcp-runtime ...now reapplies managed MCP target wiring so runtime changes update the platform config.
- Added
--overwritesupport tocbx initand wired it through wizard execution so guided installs can replace existing managed files instead of failing/being skipped. - Updated init wizard documentation/help examples to include overwrite usage in scripted and repeat install flows.
- Extended MCP startup reliability fixes across all supported platforms:
- project/global Postman MCP runtime targets now prefer static Authorization headers when managed keys are available
- Stitch header generation now also supports managed static key injection for runtime startup reliability.
- Unified default managed credential aliases across install paths:
- Postman default env alias is now
POSTMAN_API_KEY_DEFAULT - Stitch default env alias is now
STITCH_API_KEY_DEFAULT - aligns non-wizard installs with wizard persistence behavior across platforms.
- Postman default env alias is now
- Fixed
cbx mcp serveruntime failure from global npm installs by including required MCP runtime dependencies in the main package (@modelcontextprotocol/sdk,zod). - Improved Codex global Postman MCP startup reliability:
- after registration, CBX now patches Codex MCP config to use static Authorization headers when a managed Postman key is available
- avoids startup failures caused by missing shell-exported
POSTMAN_API_KEY_DEFAULT.
- Added dedicated Postman workflow routing across supported platforms:
- new
/postmanworkflow definition - generated platform assets for Codex, Antigravity, and Copilot
- generated wrapper skill
workflow-postmanfor Codex.
- new
- Tightened Postman guidance to be MCP-first:
- explicitly prefer
postman.*/postman_*tools for execution - disallow default fallback to raw JSON/curl/Newman unless explicitly requested.
- explicitly prefer
- Updated Postman setup/troubleshooting docs to be scope-aware (
project|global) so project installs stop drifting to global-only guidance. - Updated Codex rules template to reinforce no default JSON/curl fallback when Postman MCP tools are available.
- Updated smoke test expectations from 18 to 19 workflows/prompts/commands where applicable.
- Refined
cbx initwelcome banner to a cleaner terminal layout with improved spacing and branding readability. - Removed placeholder banner text and replaced it with final Cubis Foundry ASCII presentation.
- Improved
cbx remove allcleanup coverage:- removes CBX-managed skills from all configured profile path candidates (not just a single preferred path)
- includes legacy Codex skill path cleanup (
~/.codex/skills) for managed artifacts - removes empty global CBX roots (
~/.cbx,~/.agents) after cleanup when eligible.
- Ensured global remove flow clears CBX-managed profile/config artifacts consistently (
~/.cbx/cbx_config.json,~/.cbx/state.json,~/.cbx/credentials.envwhen present).
- Added Postman workspace selection step to
cbx initwizard:- interactive workspace list from Postman API when key is available
- manual workspace ID fallback prompt when listing is unavailable.
- Added non-interactive workspace flag for wizard:
cbx init --postman-workspace-id <id|null>
- Updated wizard execution mapping so selected Postman workspace is persisted through install flow.
- Updated init wizard docs and TTY smoke test to validate the new workspace selection step.
- Added full cleanup command surfaces:
cbx remove all ...cbx workflows remove-all ...
- Added cleanup engine for removing CBX-managed generated artifacts across selected scopes/platforms (workflows, wrappers, managed rule blocks/docs, MCP artifacts, runtime entries, and state/config roots).
- Added optional credential cleanup flag for full cleanup (
--include-credentials). - Added true-PTY init smoke test (
scripts/test-init-tty.exp) and expanded smoke coverage for scripted init + remove-all command surfaces.
- Updated README with full cleanup documentation and generated-file ignore recommendations for downstream repositories.
- Migrated CLI runtime source to TypeScript modules under
src/cliwith compiled runtime output indist/cli. - Replaced
bin/cubis.jswith a thin runtime loader that executes compiled CLI output. - Centralized command registration in modular TS command registrars (
workflows,mcp,rules). - Added root CLI build pipeline (
tsconfig.cli.json,npm run build:cli,prepackbuild hook). - Added interactive
cbx initguided installer (bundle/platform/skills/MCP/scope flow with sequential per-platform execution). - Added
cbx initwelcome branding screen and JSON summary mode. - Added Stitch-only and Foundry-only MCP selection support in guided install flow.
cbx rules initnow refreshes generated/legacyENGINEERING_RULES.mdtemplates even without--overwrite.- Managed engineering block now points to full absolute paths and enforces Decision Log response style.
- Added maintainers-facing wizard documentation at
docs/cli-init-wizard.md.
- Removed legacy alias command tree
cbx skills .... - Removed root aliases
cbx installandcbx platforms. - Removed alias subcommand
cbx workflows init.
- Canonical command surfaces are now:
cbx initcbx workflows ...cbx mcp ...cbx rules ...cbx agents status
- Added profile-based install controls for workflow setup:
--skill-profile <core|web-backend|full>--include-mcp--all-skillsalias for full catalog install
- Added
cbx workflows prune-skillsto detect/remove nested duplicates and out-of-profile installed skills. - Added split MCP catalog and roots:
mcp/skillsmcp/powersmcp/catalogs/default.json
- Changed default install behavior to
coreskill profile for lower context footprint. - Updated resolver/index generation to support combined workflow + MCP skill roots.
- Updated powers generation and validation scripts to handle split roots.
- Refined rule/agent templates to reduce forced skill loading and keep selection adaptive.
- Refreshed language skills and added new language packs:
java-procsharp-prokotlin-pro
- Fixed nested duplicate cleanup to catch direct-child duplicate skill folders.
- Fixed duplicate-skill-name collision handling in index generation and alias metadata.
- Renamed repository assets directory from
Ai Agent Workflowtoworkflows. - Updated all CLI/scripts/package references to use the new
workflowspath.
- Republished package with a README content touch to force npm UI metadata/index refresh.
- Switched credential/config source to
cbx_config.jsononly for Postman and Stitch runtime selection. - Added profile-based credential model for Postman/Stitch (
profiles[]+activeProfileName) with compatibility mirrors. - Updated
cbx workflows config --showto include computedstatuswith stored source vs effective source and active profile/env alias context. - Changed default skill install resolution to indexed top-level skills (
skills_index.json+ resolved skill dirs), instead of curated manifest subset. - Added automatic nested duplicate skill cleanup during install (for example duplicate skill packs nested under
postman/*). - Rewrote README into a full operational guide (quickstarts, scopes, credential flows, MCP placement, troubleshooting, migration).
- Added
cbx workflows config keysprofile-management commands:listadduseremove
- Added
cbx skills config keyscompatibility alias.
- Removed legacy Postman fallback file references from runtime/docs and enforce migration to
cbx_config.json. - Updated validation/smoke scripts to align with global-skill default install model and profile-based config behavior.
- Added missing
golang-proskill toagent-environment-setupmanifest for Codex, Antigravity, and Copilot installs.
- Updated Postman skill/power guidance to use
cbx_config.jsonas the default config source withPOSTMAN_API_KEYenv-first auth. - Added explicit instruction to avoid referencing legacy Postman fallback configs in normal responses when
cbx_config.jsonexists.
- Fixed MCP install merge behavior for existing JSONC config files (comments/trailing commas), so existing MCP entries are preserved instead of being reset.
- Fixed Postman MCP patching to parse and merge JSONC for platform config targets (for example
.vscode/mcp.json).
- Added
cbx workflows configcommand to view and editcbx_config.jsonfrom terminal. - Added
cbx skills configalias for compatibility with deprecatedskillscommand group. - Added docs for showing/updating/clearing Postman
defaultWorkspaceIdafter install.
- Improved Postman install warnings when workspace selection is not persisted because existing
cbx_config.jsonwas skipped. - Included actionable follow-up command in warnings (
cbx workflows config ...).
- Added a root
CHANGELOG.mdand npm-visible changelog section inREADME.md. - Included
CHANGELOG.mdin published npm package files.
- Added Antigravity-only default
StitchMCPruntime setup in Gemini settings. - Added
--stitch-api-keyandSTITCH_API_KEYsupport for Stitch MCP config. - Added managed Stitch MCP definition output in
.cbx/mcp/antigravity/stitch.json. - Added Stitch and Postman API key setup links and guidance in
README.md.
- Split Postman MCP management from skill folder into managed
.cbx/mcp/<platform>/postman.json. - Added centralized Postman config via
cbx_config.json. - Added MCP scope controls (
project/workspace/global/user) with platform-aware runtime placement. - Kept rules/engineering artifacts in workspace scope while defaulting skills/powers install to global scope.