@chalksurf/cli 0.3.4 → 0.3.7
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/README.md +7 -3
- package/dist/bin/chalksurf.js +4757 -2421
- package/docs/agents.md +24 -3
- package/docs/exit-codes.md +2 -0
- package/docs/manual.md +40 -4
- package/docs/mcp.md +11 -3
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -57,17 +57,21 @@ npx @chalksurf/cli --profile prod-codex exercise update EXERCISE_ID \
|
|
|
57
57
|
Admin sheet-series labeling:
|
|
58
58
|
|
|
59
59
|
```bash
|
|
60
|
-
npx @chalksurf/cli --profile prod-codex sheet list --
|
|
60
|
+
npx @chalksurf/cli --profile prod-codex sheet list --all --result-file inventory.json --json
|
|
61
61
|
npx @chalksurf/cli --profile prod-codex sheet series list --subject math --json
|
|
62
|
-
npx @chalksurf/cli --profile prod-codex sheet bulk-update
|
|
62
|
+
npx @chalksurf/cli --profile prod-codex sheet bulk-update \
|
|
63
|
+
--input batch-001.json --result-file batch-001.result.json --json
|
|
63
64
|
```
|
|
64
65
|
|
|
65
|
-
Use the returned confirmation digest in an unchanged apply batch. `--input -` reads JSON from stdin; `--input-json` remains available for short inline payloads.
|
|
66
|
+
Use the returned confirmation digest in an unchanged apply batch. `--input -` reads JSON from stdin; `--input-json` remains available for short inline payloads. If an apply response is uncertain, verify the original manifest with `sheet bulk-update verify` before considering another apply.
|
|
67
|
+
|
|
68
|
+
Every operational command accepts `--result-file PATH`. The CLI preflights a new destination before command execution, writes the complete success or failure JSON envelope to a private file, and refuses to overwrite existing evidence. Stdout stays compact and includes the absolute result path. If publication fails after the command finishes, stdout contains the complete envelope plus a warning and the command keeps its original exit code.
|
|
66
69
|
|
|
67
70
|
Sheet import manifests use top-level `sheets[]`, where each sheet has one `targetFolderPath` and one or more ordered `sources[]`. See [the canonical example](./packages/cli/docs/examples/sheet-import-manifest.json).
|
|
68
71
|
|
|
69
72
|
## Docs
|
|
70
73
|
|
|
74
|
+
- [Public CLI and MCP documentation](https://chalksurf.com/docs)
|
|
71
75
|
- [Manual operator guide](./packages/cli/docs/manual.md)
|
|
72
76
|
- [Agent and Codex guide](./packages/cli/docs/agents.md)
|
|
73
77
|
- [MCP guide](./packages/cli/docs/mcp.md)
|