@cubis/foundry 0.3.15 → 0.3.16

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +42 -1
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -20,6 +20,23 @@ Compatibility binaries are still shipped for migration:
20
20
  - `cubiskill`
21
21
  - `cubis`
22
22
 
23
+ ## Quick Setup (Simple)
24
+
25
+ ```bash
26
+ # 1) Install CLI
27
+ npm install -g @cubis/foundry
28
+
29
+ # 2) Set Postman key once (recommended: env mode)
30
+ export POSTMAN_API_KEY="<your-postman-api-key>"
31
+
32
+ # 3) Install workflow bundle for your platform
33
+ cbx workflows install --platform codex --bundle agent-environment-setup --postman --yes
34
+
35
+ # 4) Optional: install for other platforms too
36
+ cbx workflows install --platform antigravity --bundle agent-environment-setup --postman --yes
37
+ cbx workflows install --platform copilot --bundle agent-environment-setup --postman --yes
38
+ ```
39
+
23
40
  ## Command Model
24
41
 
25
42
  `workflows` is now the primary command group.
@@ -36,13 +53,23 @@ cbx workflows install --platform antigravity --dry-run
36
53
  cbx workflows install --platform antigravity --terminal-integration --terminal-verifier codex
37
54
  cbx workflows install --platform codex --postman
38
55
  cbx workflows install --platform codex --postman --postman-workspace-id null
56
+ cbx workflows install --platform codex --postman --postman-api-key "<key>"
57
+ cbx workflows install --platform antigravity --postman
58
+ cbx workflows install --platform copilot --postman
39
59
  ```
40
60
 
41
61
  Install bootstrap behavior:
42
62
  - `cbx workflows install` now also bootstraps `ENGINEERING_RULES.md` and `TECH.md` (creates when missing; keeps existing files unless explicitly regenerated).
43
- - Optional `--postman` bootstrap creates `postman_setting.json` and installs/configures the Postman skill.
63
+ - Optional `--postman` bootstrap creates `postman_setting.json` and installs/configures the Postman skill/MCP for Codex, Antigravity, and Copilot.
44
64
  - Use `cbx rules init --platform <platform> --overwrite` to force-regenerate both files.
45
65
 
66
+ Postman setup behavior:
67
+ - `postman_setting.json` is generated in project root (or `~/.cbx/postman_setting.json` with `--scope global`).
68
+ - Env-first auth is supported: when `POSTMAN_API_KEY` is set, generated settings keep `apiKey: null` and MCP config uses `Bearer ${POSTMAN_API_KEY}`.
69
+ - Inline auth is supported with `--postman-api-key <key>`.
70
+ - `--postman-workspace-id null` writes JSON `null` for `defaultWorkspaceId`.
71
+ - In project scope, `postman_setting.json` is auto-added to `.gitignore` (no duplicate entries).
72
+
46
73
  `rules` manages strict engineering policy and a generated codebase tech map:
47
74
 
48
75
  ```bash
@@ -60,6 +87,14 @@ What `cbx rules init` does:
60
87
  - Generates `TECH.md` at workspace root by scanning the current codebase.
61
88
  - Preserves user content outside managed markers.
62
89
 
90
+ `TECH.md` scanner coverage (deterministic, no AI calls):
91
+ - Language/file signals from workspace scan.
92
+ - JS/TS package signals from `package.json` (including nested/monorepo package files).
93
+ - Flutter/Dart package signals from `pubspec.yaml`.
94
+ - Go module signals from `go.mod`.
95
+ - Python package signals from `requirements*.txt` and `pyproject.toml`.
96
+ - Rust crate signals from `Cargo.toml`.
97
+
63
98
  ### Deprecated Alias
64
99
 
65
100
  `cbx skills ...` still works for one minor cycle and prints a deprecation notice.
@@ -317,6 +352,12 @@ Run attribute validation (strict, fails on warnings):
317
352
  npm run test:attributes:strict
318
353
  ```
319
354
 
355
+ Run TECH.md scanner integration tests:
356
+
357
+ ```bash
358
+ npm run test:tech-md
359
+ ```
360
+
320
361
  Run full workflow smoke test:
321
362
 
322
363
  ```bash
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cubis/foundry",
3
- "version": "0.3.15",
3
+ "version": "0.3.16",
4
4
  "description": "Cubis Foundry CLI for workflow-first AI agent environments",
5
5
  "type": "module",
6
6
  "bin": {