@work-shape/catalyst-cli 0.8.0-rc.24 → 0.8.0-rc.26

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@work-shape/catalyst-cli",
3
- "version": "0.8.0-rc.24",
3
+ "version": "0.8.0-rc.26",
4
4
  "license": "MIT",
5
5
  "repository": {
6
6
  "type": "git",
@@ -40,9 +40,9 @@
40
40
  "@types/node": "^24.13.1",
41
41
  "tsup": "^8.5.1",
42
42
  "typescript": "^6.0.3",
43
- "@work-shape/catalyst-api-contract": "0.8.0-rc.24",
44
- "@work-shape/catalyst-asset-schemas": "0.8.0-rc.24",
45
- "@work-shape/catalyst-api-client": "0.8.0-rc.24"
43
+ "@work-shape/catalyst-api-contract": "0.8.0-rc.26",
44
+ "@work-shape/catalyst-asset-schemas": "0.8.0-rc.26",
45
+ "@work-shape/catalyst-api-client": "0.8.0-rc.26"
46
46
  },
47
47
  "scripts": {
48
48
  "build": "tsup",
@@ -36,6 +36,17 @@ catalyst references --json
36
36
 
37
37
  The kind is the first word: `agent`, `skill`, `guardrail`, `app`, `workflow`, `data-store` or any other kind `catalyst kinds` lists. Add `--workspace <id>` for the assets one workspace owns, and `--json` for the instance's answer as it came.
38
38
 
39
+ ## Where data belongs
40
+
41
+ Decide this before you put data into any asset. A skill folder holds instructions, small fixed reference files and offline calculators: at most 2 MiB a file, 8 MiB and 500 files a skill (`catalyst skill validate` and `put` refuse more). Its scripts run in the instance's sandbox with no network, no secrets and no tools, so never write `curl` or another fetch into a skill script and never put a corpus into a skill folder.
42
+
43
+ - A larger or changing corpus (statutes, manuals, document collections) is a Knowledge Base: filled by upload, by a synced document source such as Dropbox, or by a Workflow that calls the Knowledge Base's `ingest` operation. Cite with dates.
44
+ - Records people or Apps write are a Data Store.
45
+ - An outside system or anything with a credential is a Connection, used by the agent or a Workflow and never by a skill script. An App reaches it only through a named action.
46
+ - An App makes a PDF with the kit's `pdf.download` or `pdf.fromHtml`, never a bundled PDF library. Another file an App makes is generated in the browser with a bundled library and downloaded.
47
+
48
+ Where the 8 MiB or the network stops you, change the design, not the folder. `catalyst docs configure/where-data-belongs` has the page.
49
+
39
50
  ## Use a skill of the instance here
40
51
 
41
52
  Only when the person asks to use a skill locally, run `catalyst skill pull <name> .claude/skills/<name>` for Claude Code or `catalyst skill pull <name> .agents/skills/<name>` for Codex. Pulling again refreshes the folder and refuses local edits. Its scripts may assume Catalyst's sandbox, so read them before running them.