@fargowealth/fargo-ai-cli 1.2.0 → 1.2.1

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 1.2.1
+
+- Clarified in `fargo lego deploy --help` that deployment preparation creates a
+  ready, unpublished deployment and that production publication is a separate
+  explicitly approved Fargo Pass MCP action.
+- Documented the 4,000-character release-note limit and replaced full-changelog
+  examples with a concise per-release notes file.
+- Documented that publication normally inherits the security-checked access
+  policy stored on the prepared deployment.
+
 ## 1.2.0
 
 - Added `--login-required yes|no` to select the target company-account sign-in

package/README.md

@@ -78,7 +78,7 @@ fargo lego deploy \
   --entrypoint index.html \
   --version 1.4.0 \
   --name "Navigation refresh" \
-  --notes-file CHANGELOG.md
+  --notes-file RELEASE_NOTES.md
 ```
 
 For Workers use `--target worker`; the default entrypoint becomes `index.js`.
@@ -104,9 +104,15 @@ fargo lego deploy \
   --login-required yes \
   --version 1.4.0 \
   --name "Full-stack release" \
-  --notes-file CHANGELOG.md
+  --notes-file RELEASE_NOTES.md
 ```
 
+Release notes are limited to 4,000 characters by both the CLI and hosted
+deployment service. Pass concise notes for one version with `--notes`, or keep
+them in a per-release file such as `RELEASE_NOTES.md`. Do not pass an entire
+multi-version changelog unless it is within the limit and intentionally belongs
+to the new release.
+
 Use repeated `--assets-run-worker-first-route <glob>` options instead of the
 boolean flag when only selected routes should invoke the Worker first. The
 hosted LEGO publisher uploads the assets and attaches the binding; Cloudflare
@@ -146,6 +152,18 @@ MCP deployment contract. The result is `ready`, never automatically published.
 Use `--dry-run` to validate both local packages without authentication or
 network writes.
 
+After reviewing the returned deployment and receiving explicit approval,
+publish that exact deployment through Fargo Pass MCP:
+
+```sh
+fargo mcp call lego_deployment_release --args \
+  '{"action":"publish","appId":"app_xxx","deploymentId":"dep_xxx"}'
+```
+
+Publication is a separate production write. The prepared deployment already
+contains its security-checked access policy, so callers normally do not need to
+repeat `visibility`, `loginRequired`, or `accessTargets` at publish time.
+
 Deployment artifacts preserve binary bytes and include
 `.fargo-deploy/manifest.json`. Default limits are 1,000 files, 25 MB total,
 20 MB per file, and a 25 MB ZIP.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fargowealth/fargo-ai-cli",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Agent-neutral Fargo AI CLI, MCP client, and LEGO project tooling",
   "type": "module",
   "bin": {

package/src/cli.mjs

@@ -157,7 +157,8 @@ Required:
   --target <pages|worker>       Deployment target
   --version <version>           Release version
   --name <name>                 Release name
-  --notes <text>                Release notes (or --notes-file <path>)
+  --notes <text>                One release's notes, maximum 4000 characters
+  --notes-file <path>           Read one release's notes from a file; same limit
 
 Source and execution:
   --source <directory>          Source snapshot root (default: .)
@@ -188,13 +189,18 @@ Worker Runtime Topology:
   --queue-max-concurrency <n>   Optional maximum concurrent consumers
   --queue-retry-delay <s>       Optional retry delay in seconds
 
+Result and publication:
+  This command creates a ready, unpublished deployment. Production traffic is
+  unchanged. After review and explicit approval, publish the returned deployment
+  with Fargo Pass MCP lego_deployment_release(action=publish).
+
 Example:
   fargo lego deploy --app app_xxx --source . \\
     --deploy-dir .build/worker --target worker --entrypoint index.js \\
     --assets-dir dist --assets-binding ASSETS \\
     --assets-not-found-handling single-page-application \\
     --assets-run-worker-first --version 1.4.0 --name "Full-stack release" \\
-    --notes-file CHANGELOG.md
+    --notes-file RELEASE_NOTES.md
 
 .fargo-assets/ is an internal archive directory reserved for Fargo CLI.
 Do not create or copy it manually; always pass browser output with --assets-dir.

package/src/constants.mjs

@@ -1,4 +1,4 @@
-export const CLI_VERSION = "1.2.0";
+export const CLI_VERSION = "1.2.1";
 export const DEVICE_CODE_GRANT_TYPE = "urn:ietf:params:oauth:grant-type:device_code";
 export const DEFAULT_AUTH_URL = "https://auth.fargowealth.app";
 export const DEFAULT_API_URL = "https://mcp.fargowealth.app";