@forumulate/cli 0.20.6 → 0.21.0

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 (93) hide show
  1. package/CHANGELOG.md +418 -0
  2. package/dist/api/operations.json +1 -1
  3. package/dist/cache-command.d.ts +1 -1
  4. package/dist/cache-command.d.ts.map +1 -1
  5. package/dist/check/markdown-links.d.ts.map +1 -1
  6. package/dist/check/markdown-links.js +3 -28
  7. package/dist/check/markdown-links.js.map +1 -1
  8. package/dist/commands/groups-community.d.ts.map +1 -1
  9. package/dist/commands/groups-community.js +6 -0
  10. package/dist/commands/groups-community.js.map +1 -1
  11. package/dist/doctor/command.d.ts +1 -1
  12. package/dist/doctor/command.d.ts.map +1 -1
  13. package/dist/exit-codes.d.ts +7 -1
  14. package/dist/exit-codes.d.ts.map +1 -1
  15. package/dist/exit-codes.js +8 -1
  16. package/dist/exit-codes.js.map +1 -1
  17. package/dist/heartbeat-command.d.ts +14 -5
  18. package/dist/heartbeat-command.d.ts.map +1 -1
  19. package/dist/heartbeat-command.js +72 -18
  20. package/dist/heartbeat-command.js.map +1 -1
  21. package/dist/help-commands.d.ts +18 -11
  22. package/dist/help-commands.d.ts.map +1 -1
  23. package/dist/help-commands.js +64 -12
  24. package/dist/help-commands.js.map +1 -1
  25. package/dist/help.d.ts +1 -1
  26. package/dist/help.d.ts.map +1 -1
  27. package/dist/help.js +11 -3
  28. package/dist/help.js.map +1 -1
  29. package/dist/import/mdx.d.ts.map +1 -1
  30. package/dist/import/mdx.js +6 -15
  31. package/dist/import/mdx.js.map +1 -1
  32. package/dist/known-flags.js +2 -2
  33. package/dist/known-flags.js.map +1 -1
  34. package/dist/plan/cli-release.d.ts +8 -0
  35. package/dist/plan/cli-release.d.ts.map +1 -0
  36. package/dist/plan/cli-release.js +47 -0
  37. package/dist/plan/cli-release.js.map +1 -0
  38. package/dist/plan/command.d.ts +2 -0
  39. package/dist/plan/command.d.ts.map +1 -1
  40. package/dist/plan/command.js +21 -1
  41. package/dist/plan/command.js.map +1 -1
  42. package/dist/plan/conflicts.d.ts +28 -0
  43. package/dist/plan/conflicts.d.ts.map +1 -0
  44. package/dist/plan/conflicts.js +111 -0
  45. package/dist/plan/conflicts.js.map +1 -0
  46. package/dist/plan/document.d.ts +2 -0
  47. package/dist/plan/document.d.ts.map +1 -1
  48. package/dist/plan/document.js +9 -0
  49. package/dist/plan/document.js.map +1 -1
  50. package/dist/plan/domain-lines.d.ts +34 -0
  51. package/dist/plan/domain-lines.d.ts.map +1 -0
  52. package/dist/plan/domain-lines.js +40 -0
  53. package/dist/plan/domain-lines.js.map +1 -0
  54. package/dist/plan/output.d.ts +30 -3
  55. package/dist/plan/output.d.ts.map +1 -1
  56. package/dist/plan/output.js +46 -7
  57. package/dist/plan/output.js.map +1 -1
  58. package/dist/plan/pull.d.ts +31 -4
  59. package/dist/plan/pull.d.ts.map +1 -1
  60. package/dist/plan/pull.js +119 -17
  61. package/dist/plan/pull.js.map +1 -1
  62. package/dist/publish/command.d.ts.map +1 -1
  63. package/dist/publish/command.js +14 -2
  64. package/dist/publish/command.js.map +1 -1
  65. package/dist/publish/docs-apply.d.ts.map +1 -1
  66. package/dist/publish/docs-apply.js +2 -0
  67. package/dist/publish/docs-apply.js.map +1 -1
  68. package/dist/publish/docs-plan.d.ts +0 -5
  69. package/dist/publish/docs-plan.d.ts.map +1 -1
  70. package/dist/publish/docs-plan.js +9 -18
  71. package/dist/publish/docs-plan.js.map +1 -1
  72. package/dist/publish/fences.d.ts +17 -0
  73. package/dist/publish/fences.d.ts.map +1 -0
  74. package/dist/publish/fences.js +40 -0
  75. package/dist/publish/fences.js.map +1 -0
  76. package/dist/publish/frontmatter.d.ts +7 -0
  77. package/dist/publish/frontmatter.d.ts.map +1 -1
  78. package/dist/publish/frontmatter.js +20 -0
  79. package/dist/publish/frontmatter.js.map +1 -1
  80. package/dist/publish/posts.d.ts.map +1 -1
  81. package/dist/publish/posts.js +2 -1
  82. package/dist/publish/posts.js.map +1 -1
  83. package/dist/run.d.ts.map +1 -1
  84. package/dist/run.js +9 -40
  85. package/dist/run.js.map +1 -1
  86. package/dist/validate.d.ts +1 -1
  87. package/dist/validate.d.ts.map +1 -1
  88. package/dist/version.d.ts +1 -1
  89. package/dist/version.js +1 -1
  90. package/dist/whoami.d.ts +1 -1
  91. package/dist/whoami.d.ts.map +1 -1
  92. package/dist/whoami.js +1 -1
  93. package/package.json +3 -2
@@ -1,14 +1,21 @@
1
- export declare const PUBLISH_HELP = "forumulate publish \u2014 publish a folder of Markdown into a space\n\nUsage:\n forumulate publish <folder> --org <id|slug> --space <id|slug> [flags]\n\n (org: and space: may come from forumulate.yaml, FORUMULATE_ORG / FORUMULATE_SPACE\n or `forumulate config set` instead of the flags.)\n\n One folder per collection, front matter for titles, slugs, order and SEO, assets\n uploaded once by content hash. A re-run changes only what changed, then reads the\n space back and fails if anything did not land.\n\nFlags:\n --dry-run print the plan; write nothing (no token needed for a public space)\n --prune move pages/posts/collections with no file to the trash\n --only a,b just these slugs, files, folders, or manifest parts\n (site, theme, settings, openapi, monitors)\n --force re-send every page even if it looks unchanged, AND overwrite pages\n edited in the studio since the last publish\n --purge page|space|none\n what to drop from the cache when done (default page): page = every\n page this run changed; space = the whole space (a title in the\n navigation changed); none = leave the CDN alone. Reported per CDN.\n --no-verify skip the read-back --pace <ms> gap between writes (250)\n --manifest <file> a forumulate.yaml somewhere else\n --diff print the changed paragraphs and fields of each update\n --strict fail (exit 1, nothing written) on a relative link that names no page;\n without it each one is printed as `warn <file>:<line> link to nothing`\n --no-report do not record this run (publish.completed is not sent)\n --json one JSON summary: {space, created, updated, unchanged, trashed,\n purged, verify, diffUrl, runId, lines, errors}\n --out <file> write that output to a file\n --preview <name> publish nothing: send the pages this run would add or change (and\n with --prune, remove) to a preview named <name> (pr-123) and print\n its link \u2014 the space as the change would publish it, on its own\n addresses, for 7 days (previews.ttl_days). Same name again: same\n link, renewed. --json adds previews[{urls, summary, comment}].\n --preview-ttl <d> a shorter life for the preview link, in days\n --comment with --preview in CI: post the link and diff table on the pull\n request (GitHub, Gitea, GitLab, Bitbucket; GITHUB_TOKEN /\n GITEA_TOKEN / GITLAB_TOKEN / BITBUCKET_TOKEN), editing it on re-runs\n\nLinks: a relative link to a page in ANOTHER space of this folder (../guides/x.md, or\n./x when only one other space has x) is rewritten to that page's address on the host\nboth spaces are published on; one that names no page anywhere is reported, here and\nby the importer (unresolvedLinks).\n\nStudio edits: a page edited in the studio (or through the API) since this folder was\nlast published is not overwritten. The run stops before writing and prints\n CONFLICT <slug> edited in studio by <name> at <time>\nPull the change into the file, or re-run with --force to overwrite it.\n\nforumulate.yaml keys:\n org, space where to publish (one space), or\n spaces: [{path, space, create: {type, name, visibility}, rootCollection,\n theme, settings, tags, openapi: [{file|url, collection, ...}], monitors,\n redirects: [{from, to, status?, type?}] or a CSV file name,\n redirects are merged into the space's table, never replaced\n about: {...} | about.yaml (an ABOUT space's parts)}]\n site: {...} the site configuration (applied with PATCH semantics)\n theme: {...} the space theme\n Guide: https://forumulate.com/guides/content-as-code\n\nOlder forms (deprecated in 0.11.0; they still run and print a notice on stderr):\n publish <orgId> <spaceId> <folder> \u2192 publish <folder> --org \u2026 --space \u2026\n publish <orgId> <spaceId> <pageId> \u2192 forumulate items publish <pageId> --space \u2026\n\nExamples:\n forumulate publish docs --org acme --space docs --dry-run\n forumulate publish docs --org acme --space docs --purge space --json --out run.json\n forumulate publish docs --org acme --space docs --preview pr-123 --comment\n\nOutput (every command):\n --json the result as JSON on stdout; progress and warnings go to stderr\n --out <file> write stdout to a file instead (never truncated, exit 1 if the write fails)\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
2
- export declare const SYNC_HELP = "forumulate sync \u2014 the same folder publish, plan by default\n\nUsage:\n forumulate sync <folder> [--apply] [--prune] [--diff] [--org \u2026] [--space \u2026]\n\n Without --apply it plans and writes nothing; with --apply it is `publish`.\n Takes every publish flag (--only, --force, --purge, --no-verify, --pace,\n --manifest, --json). See `forumulate publish --help` for them and the\n forumulate.yaml keys.\n\nOutput (every command):\n --json the result as JSON on stdout; progress and warnings go to stderr\n --out <file> write stdout to a file instead (never truncated, exit 1 if the write fails)\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
3
- export declare const PLAN_HELP = "forumulate plan / forumulate apply \u2014 one document for a whole site\n\nUsage:\n forumulate plan [forumulate.yaml] [--org <id|slug>] [--create-org] [--diff] [--check] [--prune] [--verbose]\n forumulate apply [forumulate.yaml] [--org <id|slug>] [--create-org] [--prune] [--batch <n>] [--secrets-file <path>] [--verbose]\n\n Reads a version-2 forumulate.yaml and the Markdown folders it names, and sends it to\n PUT /orgs/{org}/manifest: plan is the dry run (the diff, nothing written), apply\n writes it. Every unit goes through the endpoint that owns it, is read back after the\n write, and is recorded, so a re-apply of the same files writes nothing and a page\n edited in the studio since the last apply shows as drift.\n\nFlags:\n --org <o> the organization (else `org:` in the file, else FORUMULATE_ORG)\n --create-org the org may not exist yet (same as `orgName:` in the file): plan prints\n `+ create org <slug>` and plans the rest against an empty org, writing nothing;\n apply creates it first (`orgs ensure`), then applies\n --diff plan: print each changed field, from -> to\n --check plan: exit 1 when anything would change (drift detection in CI)\n --prune also delete what this manifest created earlier and no longer\n declares \u2014 only for the kinds the file declares (pages go to the trash)\n --batch <n> apply: changed pages per request (default 20; the edge cuts a request at 30 s)\n --vars-file <p> read ${NAME}s from a dotenv file, repeatable (later files win); values of 8+ characters\n are masked in all output (--show-secrets reveals them); --env-file is the old name, and\n for a missing file there Node itself exits 9 before the CLI starts; a variable already set in the shell wins\n A value is masked only while the file holds it: keep a retired one there for the\n next plan, or --diff prints it as the old side of the change\n --show-secrets leave declared secrets in the output; refused unless stdout is a terminal\n --allow-unset-env apply: publish a page whose ${NAME} is unset as written (default: refuse)\n --secrets-file <p> apply: write every shown-once value (executor key, webhook secret) and every\n heartbeat's pingUrl (monitors/<space>/<name>, on every apply) to <p> as JSON,\n mode 0600, merged over what it holds (an existing file must already be 0600).\n Without it they are redacted in the output, human and --json alike: keep the file\n --verbose list unchanged steps and what exists but the file does not mention\n (left alone; --json always carries it as `extras`)\n --json the API's answer (plan) or {ok, batches} (apply)\n\n ${NAME} is read from the environment anywhere outside pages/posts: a whole value, or\n inside a string (url: ${API_URL}/health); $${NAME} is the literal text. In content and\n code keys (body, customJs, \u2026) only a whole value. An unset name stops the run.\n The organization must exist, unless the file says `orgName:` or you pass --create-org;\n `forumulate orgs ensure <slug>` also creates it (idempotent).\n A domain whose `state` waits on a verification file not served yet is held (onUnverified: hold,\n the default): plan and apply print `waiting: \u2026` with what each proof method saw, every other\n unit applies, and apply still exits 0 \u2014 re-apply once the file is served.\n apply puts each heartbeat monitor's pingUrl in --secrets-file; `forumulate heartbeat ping-url` re-reads it.\n\nforumulate.yaml (version: 2):\n version: 2\n org: acme\n spaces: [{slug, name, type, visibility, settings, theme, redirects, collections,\n locales: [{code, label}], seo: {...}, translations: {<code>: {name,\n description, seoTitle, seoDescription}}, preset, piecePreset, frontDoor,\n contactForm: {...} | file.yaml (CONTACT), about: {...} | file.yaml (ABOUT)}]\n pages: [{dir: content/docs, space: docs, collection?, locales?, ignore?: [globs],\n env?: true (substitute ${NAME} in bodies)} a Markdown folder:\n page.md + page.es.md or es/page.md twins; front matter title, slug,\n seoTitle, seoDescription, canonicalUrl, sections, collection, order\n (or a 01- prefix), draft; sub-folders are collections\n | {space, slug, title, body, ...}] or one page inline\n sites: [{slug, name, spaces: [slugs], config: {...}, configMode: merge|replace}]\n domains, reader_auth, consent, connectors, executor, webhooks, tokens, status_monitors,\n brand, prune \u2014 as PUT /orgs/{org}/manifest documents them.\n Guide: https://forumulate.com/guides/forumulate-yaml-apply\n\nExamples:\n forumulate plan --diff\n forumulate plan --check # CI: fail when the site drifted from the repository\n forumulate apply --prune\n\nOutput (every command):\n --json the result as JSON on stdout; progress and warnings go to stderr\n --out <file> write stdout to a file instead (never truncated, exit 1 if the write fails)\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
4
- export declare const DEV_HELP = "forumulate dev \u2014 preview a folder of Markdown locally\n\nUsage:\n forumulate dev <folder> --org <id|slug> --space <id|slug> [--port 4321] [--site <url>]\n\n Renders with your space's own renderer and reloads on save. Nothing is written\n to the space.\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
5
- export declare const LOGIN_HELP = "forumulate login \u2014 store a token for this API\n\nUsage:\n forumulate login [--token <pat>] (asks for it, hidden, when not given)\n\n The token is checked against the API first, then stored in\n ~/.config/forumulate/credentials.json (mode 0600), keyed by API base, so a\n staging token is never sent to production. On every later command a\n --token beats FORUMULATE_TOKEN, which beats the stored token.\n Mint a token at https://forumulate.com/account/tokens\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
6
- export declare const LOGOUT_HELP = "forumulate logout \u2014 forget the stored token for this API\n\nUsage:\n forumulate logout\n\n Warns when FORUMULATE_TOKEN is still set, because it still wins.\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
7
- export declare const SNAPSHOT_HELP = "forumulate snapshot \u2014 save a version snapshot of a space\n\nUsage:\n forumulate snapshot <orgId> <spaceId> <label\u2026> [--json]\n (also: forumulate snapshots --help)\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
8
- export declare const CONFORMANCE_HELP = "forumulate conformance \u2014 run the Content Sync Protocol suite\n\nUsage:\n forumulate conformance <collectionUrl> [--json]\n\n Runs against any platform's collection endpoint, ours included. Exit 1 when a\n check fails.\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
9
- export declare const CONTENT_HELP = "forumulate content \u2014 a content library's model as code\n\nUsage:\n forumulate content types --library <id|slug> [--org \u2026] [--out forumulate.d.ts]\n [--preview] [--schema <file>] [--check]\n forumulate content pull --library <id|slug> [--format json|payload] [--out <file>]\n forumulate content push [file] [--library \u2026] [--dry-run] [--yes] [--force]\n [--rename type.field=new | block:hero.field=new | library:field=new]\n [--rename-type old=new] [--rename-block old=new]\n\n Here --out names the file the command writes (not a stdout redirect).\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
10
- export declare const IMPORT_HELP = "forumulate import mdx <folder> [--json] lists, by file and line, what would publish as literal text; exit 1 if any.\n\nforumulate import \u2014 bring another CMS's content into a library\n\nUsage:\n forumulate import <payload|contentful|sanity|strapi|wordpress> <export path>\n --library <id|slug> [--org \u2026] [--dry-run] [--yes]\n [--config payload.config.ts] [--publish source|all|none]\n [--allow-model-removals] [--pace <ms>] [--base-url <url>]\n\n Always shows a dry run first; a re-run updates what a previous import made.\n\nOutput (every command):\n --json the result as JSON on stdout; progress and warnings go to stderr\n --out <file> write stdout to a file instead (never truncated, exit 1 if the write fails)\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
11
- export declare const TRANSLATIONS_HELP = "forumulate translations (alias i18n) \u2014 every translation capability\n\nUsage:\n forumulate translations locales list|add|relabel|remove|set [--space \u2026|--library \u2026]\n forumulate translations status [--locale es,fr] [--fail-on missing,outdated]\n forumulate translations pull [--out translations] [--locale \u2026] [--only \u2026]\n forumulate translations push [dir] [--dry-run]\n forumulate translations auto --locale es [--state missing,outdated] [--publish]\n forumulate translations labels|overrides pull|push [file] [--format json|xliff]\n forumulate translations item-locale <itemId> <locale|none>\n forumulate translations remove <pieceId> <locale> --yes\n forumulate translations entry <entryId> <locale> [--fields f.json]\n forumulate translations name <locale> <name\u2026>\n forumulate translations switcher get|set <f.json>\n forumulate translations provider status|connect|disconnect\n\n Here --out names the folder or file the command writes.\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
1
+ export declare const PUBLISH_HELP = "forumulate publish \u2014 publish a folder of Markdown into a space\n\nUsage:\n forumulate publish <folder> --org <id|slug> --space <id|slug> [flags]\n\n (org: and space: may come from forumulate.yaml, FORUMULATE_ORG / FORUMULATE_SPACE\n or `forumulate config set` instead of the flags.)\n\n One folder per collection, front matter for titles, slugs, order and SEO, assets\n uploaded once by content hash. A re-run changes only what changed, then reads the\n space back and fails if anything did not land.\n\nFlags:\n --dry-run print the plan; write nothing (no token needed for a public space)\n --prune move pages/posts/collections with no file to the trash\n --only a,b just these slugs, files, folders, or manifest parts\n (site, theme, settings, openapi, monitors)\n --force re-send every page even if it looks unchanged, AND overwrite pages\n edited in the studio since the last publish\n --purge page|space|none\n what to drop from the cache when done (default page): page = every\n page this run changed; space = the whole space (a title in the\n navigation changed); none = leave the CDN alone. Reported per CDN.\n --no-verify skip the read-back --pace <ms> gap between writes (250)\n --manifest <file> a forumulate.yaml somewhere else\n --diff print the changed paragraphs and fields of each update\n --strict fail (exit 1, nothing written) on a relative link that names no page;\n without it each one is printed as `warn <file>:<line> link to nothing`\n --no-report do not record this run (publish.completed is not sent)\n --json one JSON summary: {space, created, updated, unchanged, trashed,\n purged, verify, diffUrl, runId, lines, errors}\n --out <file> write that output to a file\n --preview <name> publish nothing: send the pages this run would add or change (and\n with --prune, remove) to a preview named <name> (pr-123) and print\n its link \u2014 the space as the change would publish it, on its own\n addresses, for 7 days (previews.ttl_days). Same name again: same\n link, renewed. --json adds previews[{urls, summary, comment}].\n --preview-ttl <d> a shorter life for the preview link, in days\n --comment with --preview in CI: post the link and diff table on the pull\n request (GitHub, Gitea, GitLab, Bitbucket; GITHUB_TOKEN /\n GITEA_TOKEN / GITLAB_TOKEN / BITBUCKET_TOKEN), editing it on re-runs\n\nLinks: a relative link to a page in ANOTHER space of this folder (../guides/x.md, or\n./x when only one other space has x) is rewritten to that page's address on the host\nboth spaces are published on; one that names no page anywhere is reported, here and\nby the importer (unresolvedLinks).\n\nStudio edits: a page edited in the studio (or through the API) since this folder was\nlast published is not overwritten. The run stops before writing and prints\n CONFLICT <slug> edited in studio by <name> at <time>\nPull the change into the file, or re-run with --force to overwrite it.\n\nforumulate.yaml keys:\n org, space where to publish (one space), or\n spaces: [{path, space, create: {type, name, visibility}, rootCollection,\n theme, settings, tags, openapi: [{file|url, collection, ...}], monitors,\n redirects: [{from, to, status?, type?}] or a CSV file name,\n redirects are merged into the space's table, never replaced\n about: {...} | about.yaml (an ABOUT space's parts)}]\n site: {...} the site configuration (applied with PATCH semantics)\n theme: {...} the space theme\n\nOlder forms (deprecated in 0.11.0; they still run and print a notice on stderr):\n publish <orgId> <spaceId> <folder> \u2192 publish <folder> --org \u2026 --space \u2026\n publish <orgId> <spaceId> <pageId> \u2192 forumulate items publish <pageId> --space \u2026\n\nExamples:\n forumulate publish docs --org acme --space docs --dry-run\n forumulate publish docs --org acme --space docs --purge space --json --out run.json\n forumulate publish docs --org acme --space docs --preview pr-123 --comment\n\nOutput (every command):\n --json the result as JSON on stdout; progress and warnings go to stderr\n --out <file> write stdout to a file instead (never truncated, exit 1 if the write fails)\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish or apply)\n 6 outdated: this CLI is older than the oldest the API supports (upgrade it)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
2
+ export declare const SYNC_HELP = "forumulate sync \u2014 the same folder publish, plan by default\n\nUsage:\n forumulate sync <folder> [--apply] [--prune] [--diff] [--org \u2026] [--space \u2026]\n\n Without --apply it plans and writes nothing; with --apply it is `publish`.\n Takes every publish flag (--only, --force, --purge, --no-verify, --pace,\n --manifest, --json). See `forumulate publish --help` for them and the\n forumulate.yaml keys.\n\nOutput (every command):\n --json the result as JSON on stdout; progress and warnings go to stderr\n --out <file> write stdout to a file instead (never truncated, exit 1 if the write fails)\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish or apply)\n 6 outdated: this CLI is older than the oldest the API supports (upgrade it)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
3
+ export declare const PLAN_HELP = "forumulate plan / forumulate apply \u2014 one document for a whole site\n\nUsage:\n forumulate plan [forumulate.yaml] [--org <id|slug>] [--create-org] [--diff] [--check] [--prune] [--verbose]\n forumulate apply [forumulate.yaml] [--org <id|slug>] [--create-org] [--prune] [--batch <n>] [--secrets-file <path>] [--verbose]\n\n Reads a version-2 forumulate.yaml and the Markdown folders it names, and sends it to\n PUT /orgs/{org}/manifest: plan is the dry run (the diff, nothing written), apply\n writes it. Every unit goes through the endpoint that owns it, is read back after the\n write, and is recorded, so a re-apply of the same files writes nothing.\n\n Studio edits: a page edited in the studio (or through the API) since the last apply is\n a CONFLICT. plan prints it under the page (who, when) and ends with the fix:\n forumulate pull <dir> --space <slug> --only <slugs>\n apply refuses the whole run (exit 5, nothing written) unless --force, which overwrites\n the edits with your files. plan --check exits 5 when a conflict is the only thing wrong.\n\nFlags:\n --org <o> the organization (else `org:` in the file, else FORUMULATE_ORG)\n --create-org the org may not exist yet (same as `orgName:` in the file): plan prints\n `+ create org <slug>` and plans the rest against an empty org, writing nothing;\n apply creates it first (`orgs ensure`), then applies\n --diff plan: print each changed field, from -> to; for a page edited in the studio,\n its paragraphs, live (-) against your file (+)\n --force apply: overwrite pages edited in the studio since the last apply (else exit 5)\n --check plan: exit 1 when anything would change (drift detection in CI), 5 on a studio edit\n --prune also delete what this manifest created earlier and no longer\n declares \u2014 only for the kinds the file declares (pages go to the trash)\n --batch <n> apply: changed pages per request (default 20; the edge cuts a request at 30 s)\n --vars-file <p> read ${NAME}s from a dotenv file, repeatable (later files win); values of 8+ characters\n are masked in all output (--show-secrets reveals them); --env-file is the old name, and\n for a missing file there Node itself exits 9 before the CLI starts; a variable already set in the shell wins\n A value is masked only while the file holds it: keep a retired one there for the\n next plan, or --diff prints it as the old side of the change\n --show-secrets leave declared secrets in the output; refused unless stdout is a terminal\n --allow-unset-env apply: publish a page whose ${NAME} is unset as written (default: refuse)\n --secrets-file <p> apply: write every shown-once value (executor key, webhook secret) and every\n heartbeat's pingUrl (monitors/<space>/<name>, on every apply) to <p> as JSON,\n mode 0600, merged over what it holds (an existing file must already be 0600).\n Without it they are redacted in the output, human and --json alike: keep the file\n --verbose list unchanged steps and what exists but the file does not mention\n (left alone; --json always carries it as `extras`)\n --json the API's answer (plan) or {ok, batches} (apply)\n\n ${NAME} is read from the environment anywhere outside pages/posts: a whole value, or\n inside a string (url: ${API_URL}/health); $${NAME} is the literal text. In content and\n code keys (body, customJs, \u2026) only a whole value. An unset name stops the run.\n The organization must exist, unless the file says `orgName:` or you pass --create-org;\n `forumulate orgs ensure <slug>` also creates it (idempotent).\n A domain whose `state` waits on a verification file not served yet is held (onUnverified: hold,\n the default): plan and apply print `waiting: \u2026` with what each proof method saw, every other\n unit applies, and apply still exits 0 \u2014 re-apply once the file is served.\n apply puts each heartbeat monitor's pingUrl in --secrets-file; `forumulate heartbeat ping-url` re-reads it.\n\nforumulate.yaml (version: 2):\n version: 2\n org: acme\n spaces: [{slug, name, type, visibility, settings, theme, redirects, collections,\n locales: [{code, label}], seo: {...}, translations: {<code>: {name,\n description, seoTitle, seoDescription}}, preset, piecePreset, frontDoor,\n contactForm: {...} | file.yaml (CONTACT), about: {...} | file.yaml (ABOUT)}]\n pages: [{dir: content/docs, space: docs, collection?, locales?, ignore?: [globs],\n env?: true (substitute ${NAME} in bodies)} a Markdown folder:\n page.md + page.es.md or es/page.md twins; front matter title, slug,\n seoTitle, seoDescription, canonicalUrl, sections, collection, order\n (or a 01- prefix), draft; sub-folders are collections\n | {space, slug, title, body, ...}] or one page inline\n sites: [{slug, name, spaces: [slugs], config: {...}, configMode: merge|replace}]\n domains, reader_auth, consent, connectors, executor, webhooks, tokens, status_monitors,\n brand, prune, force \u2014 as PUT /orgs/{org}/manifest documents them.\n sites[].subdomain: <label> claims <label>.forumulate.com for the site (`+ claim subdomain`); null releases it.\n\nExamples:\n forumulate plan --diff\n forumulate plan --check # CI: fail when the site drifted from the repository\n forumulate apply --prune\n\nOutput (every command):\n --json the result as JSON on stdout; progress and warnings go to stderr\n --out <file> write stdout to a file instead (never truncated, exit 1 if the write fails)\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish or apply)\n 6 outdated: this CLI is older than the oldest the API supports (upgrade it)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
4
+ export declare const DEV_HELP = "forumulate dev \u2014 preview a folder of Markdown locally\n\nUsage:\n forumulate dev <folder> --org <id|slug> --space <id|slug> [--port 4321] [--site <url>]\n\n Renders with your space's own renderer and reloads on save. Nothing is written\n to the space.\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish or apply)\n 6 outdated: this CLI is older than the oldest the API supports (upgrade it)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
5
+ export declare const LOGIN_HELP = "forumulate login \u2014 store a token for this API\n\nUsage:\n forumulate login [--token <pat>] (asks for it, hidden, when not given)\n\n The token is checked against the API first, then stored in\n ~/.config/forumulate/credentials.json (mode 0600), keyed by API base, so a\n staging token is never sent to production. On every later command a\n --token beats FORUMULATE_TOKEN, which beats the stored token.\n Mint a token at https://forumulate.com/account/tokens\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish or apply)\n 6 outdated: this CLI is older than the oldest the API supports (upgrade it)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
6
+ export declare const LOGOUT_HELP = "forumulate logout \u2014 forget the stored token for this API\n\nUsage:\n forumulate logout\n\n Warns when FORUMULATE_TOKEN is still set, because it still wins.\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish or apply)\n 6 outdated: this CLI is older than the oldest the API supports (upgrade it)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
7
+ export declare const SNAPSHOT_HELP = "forumulate snapshot \u2014 save a version snapshot of a space\n\nUsage:\n forumulate snapshot <orgId> <spaceId> <label\u2026> [--json]\n (also: forumulate snapshots --help)\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish or apply)\n 6 outdated: this CLI is older than the oldest the API supports (upgrade it)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
8
+ export declare const CONFORMANCE_HELP = "forumulate conformance \u2014 run the Content Sync Protocol suite\n\nUsage:\n forumulate conformance <collectionUrl> [--json]\n\n Runs against any platform's collection endpoint, ours included. Exit 1 when a\n check fails.\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish or apply)\n 6 outdated: this CLI is older than the oldest the API supports (upgrade it)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
9
+ export declare const CONTENT_HELP = "forumulate content \u2014 a content library's model as code\n\nUsage:\n forumulate content types --library <id|slug> [--org \u2026] [--out forumulate.d.ts]\n [--preview] [--schema <file>] [--check]\n forumulate content pull --library <id|slug> [--format json|payload] [--out <file>]\n forumulate content push [file] [--library \u2026] [--dry-run] [--yes] [--force]\n [--rename type.field=new | block:hero.field=new | library:field=new]\n [--rename-type old=new] [--rename-block old=new]\n\n Here --out names the file the command writes (not a stdout redirect).\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish or apply)\n 6 outdated: this CLI is older than the oldest the API supports (upgrade it)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
10
+ export declare const IMPORT_HELP = "forumulate import mdx <folder> [--json] lists, by file and line, what would publish as literal text; exit 1 if any.\n\nforumulate import \u2014 bring another CMS's content into a library\n\nUsage:\n forumulate import <payload|contentful|sanity|strapi|wordpress> <export path>\n --library <id|slug> [--org \u2026] [--dry-run] [--yes]\n [--config payload.config.ts] [--publish source|all|none]\n [--allow-model-removals] [--pace <ms>] [--base-url <url>]\n\n Always shows a dry run first; a re-run updates what a previous import made.\n\nOutput (every command):\n --json the result as JSON on stdout; progress and warnings go to stderr\n --out <file> write stdout to a file instead (never truncated, exit 1 if the write fails)\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish or apply)\n 6 outdated: this CLI is older than the oldest the API supports (upgrade it)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
11
+ export declare const TRANSLATIONS_HELP = "forumulate translations (alias i18n) \u2014 every translation capability\n\nUsage:\n forumulate translations locales list|add|relabel|remove|set [--space \u2026|--library \u2026]\n forumulate translations status [--locale es,fr] [--fail-on missing,outdated]\n forumulate translations pull [--out translations] [--locale \u2026] [--only \u2026]\n forumulate translations push [dir] [--dry-run]\n forumulate translations auto --locale es [--state missing,outdated] [--publish]\n forumulate translations labels|overrides pull|push [file] [--format json|xliff]\n forumulate translations item-locale <itemId> <locale|none>\n forumulate translations remove <pieceId> <locale> --yes\n forumulate translations entry <entryId> <locale> [--fields f.json]\n forumulate translations name <locale> <name\u2026>\n forumulate translations switcher get|set <f.json>\n forumulate translations provider status|connect|disconnect\n\n Here --out names the folder or file the command writes.\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL)\n 2 usage 3 auth (no token, 401, token not allowed)\n 4 not found 5 conflict (409/412, edited in the studio since your last publish or apply)\n 6 outdated: this CLI is older than the oldest the API supports (upgrade it)\n 9 not ours: Node refuses a missing --env-file before the CLI starts (use --vars-file)\n 124 --wait timed out (the job keeps running; with --wait, a failed job is 1)";
12
+ /**
13
+ * The guide each command's own `--help` ends with (F-09): one `Guide:` line,
14
+ * last, the same form for every command that has one. Links named inline in
15
+ * the middle of a page were how three commands had a guide and twenty did not.
16
+ */
17
+ export declare const GUIDES_BASE = "https://forumulate.com/guides";
18
+ export declare const COMMAND_GUIDE: Readonly<Record<string, string>>;
12
19
  /** The command → its own help. A command missing here prints the global help. */
13
20
  export declare const COMMAND_HELP: Readonly<Record<string, string>>;
14
21
  //# sourceMappingURL=help-commands.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"help-commands.d.ts","sourceRoot":"","sources":["../src/help-commands.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,YAAY,k9JA0EN,CAAC;AAEpB,eAAO,MAAM,SAAS,igCAYH,CAAC;AAEpB,eAAO,MAAM,SAAS,0gLAwEH,CAAC;AAEpB,eAAO,MAAM,QAAQ,spBAQF,CAAC;AAEpB,eAAO,MAAM,UAAU,62BAWJ,CAAC;AAEpB,eAAO,MAAM,WAAW,qjBAOL,CAAC;AAEpB,eAAO,MAAM,aAAa,ikBAMP,CAAC;AAEpB,eAAO,MAAM,gBAAgB,onBAQV,CAAC;AAEpB,eAAO,MAAM,YAAY,2+BAYN,CAAC;AAEpB,eAAO,MAAM,WAAW,soCAcL,CAAC;AAEpB,eAAO,MAAM,iBAAiB,02CAkBX,CAAC;AAEpB,iFAAiF;AACjF,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA8BzD,CAAC"}
1
+ {"version":3,"file":"help-commands.d.ts","sourceRoot":"","sources":["../src/help-commands.ts"],"names":[],"mappings":"AAuBA,eAAO,MAAM,YAAY,m/JAyEN,CAAC;AAEpB,eAAO,MAAM,SAAS,0lCAYH,CAAC;AAEpB,eAAO,MAAM,SAAS,8sMA+EH,CAAC;AAEpB,eAAO,MAAM,QAAQ,+uBAQF,CAAC;AAEpB,eAAO,MAAM,UAAU,s8BAWJ,CAAC;AAEpB,eAAO,MAAM,WAAW,8oBAOL,CAAC;AAEpB,eAAO,MAAM,aAAa,0pBAMP,CAAC;AAEpB,eAAO,MAAM,gBAAgB,6sBAQV,CAAC;AAEpB,eAAO,MAAM,YAAY,okCAYN,CAAC;AAEpB,eAAO,MAAM,WAAW,+tCAcL,CAAC;AAEpB,eAAO,MAAM,iBAAiB,m8CAkBX,CAAC;AAEpB;;;;GAIG;AACH,eAAO,MAAM,WAAW,kCAAkC,CAAC;AAC3D,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAuB1D,CAAC;AAOF,iFAAiF;AACjF,eAAO,MAAM,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA6CxD,CAAC"}
@@ -1,6 +1,6 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
- exports.COMMAND_HELP = exports.TRANSLATIONS_HELP = exports.IMPORT_HELP = exports.CONTENT_HELP = exports.CONFORMANCE_HELP = exports.SNAPSHOT_HELP = exports.LOGOUT_HELP = exports.LOGIN_HELP = exports.DEV_HELP = exports.PLAN_HELP = exports.SYNC_HELP = exports.PUBLISH_HELP = void 0;
3
+ exports.COMMAND_HELP = exports.COMMAND_GUIDE = exports.GUIDES_BASE = exports.TRANSLATIONS_HELP = exports.IMPORT_HELP = exports.CONTENT_HELP = exports.CONFORMANCE_HELP = exports.SNAPSHOT_HELP = exports.LOGOUT_HELP = exports.LOGIN_HELP = exports.DEV_HELP = exports.PLAN_HELP = exports.SYNC_HELP = exports.PUBLISH_HELP = void 0;
4
4
  const heartbeat_command_1 = require("./heartbeat-command");
5
5
  const validate_1 = require("./validate");
6
6
  const command_1 = require("./doctor/command");
@@ -83,7 +83,6 @@ forumulate.yaml keys:
83
83
  about: {...} | about.yaml (an ABOUT space's parts)}]
84
84
  site: {...} the site configuration (applied with PATCH semantics)
85
85
  theme: {...} the space theme
86
- Guide: https://forumulate.com/guides/content-as-code
87
86
 
88
87
  Older forms (deprecated in 0.11.0; they still run and print a notice on stderr):
89
88
  publish <orgId> <spaceId> <folder> → publish <folder> --org … --space …
@@ -119,16 +118,23 @@ Usage:
119
118
  Reads a version-2 forumulate.yaml and the Markdown folders it names, and sends it to
120
119
  PUT /orgs/{org}/manifest: plan is the dry run (the diff, nothing written), apply
121
120
  writes it. Every unit goes through the endpoint that owns it, is read back after the
122
- write, and is recorded, so a re-apply of the same files writes nothing and a page
123
- edited in the studio since the last apply shows as drift.
121
+ write, and is recorded, so a re-apply of the same files writes nothing.
122
+
123
+ Studio edits: a page edited in the studio (or through the API) since the last apply is
124
+ a CONFLICT. plan prints it under the page (who, when) and ends with the fix:
125
+ forumulate pull <dir> --space <slug> --only <slugs>
126
+ apply refuses the whole run (exit 5, nothing written) unless --force, which overwrites
127
+ the edits with your files. plan --check exits 5 when a conflict is the only thing wrong.
124
128
 
125
129
  Flags:
126
130
  --org <o> the organization (else \`org:\` in the file, else FORUMULATE_ORG)
127
131
  --create-org the org may not exist yet (same as \`orgName:\` in the file): plan prints
128
132
  \`+ create org <slug>\` and plans the rest against an empty org, writing nothing;
129
133
  apply creates it first (\`orgs ensure\`), then applies
130
- --diff plan: print each changed field, from -> to
131
- --check plan: exit 1 when anything would change (drift detection in CI)
134
+ --diff plan: print each changed field, from -> to; for a page edited in the studio,
135
+ its paragraphs, live (-) against your file (+)
136
+ --force apply: overwrite pages edited in the studio since the last apply (else exit 5)
137
+ --check plan: exit 1 when anything would change (drift detection in CI), 5 on a studio edit
132
138
  --prune also delete what this manifest created earlier and no longer
133
139
  declares — only for the kinds the file declares (pages go to the trash)
134
140
  --batch <n> apply: changed pages per request (default 20; the edge cuts a request at 30 s)
@@ -172,8 +178,8 @@ forumulate.yaml (version: 2):
172
178
  | {space, slug, title, body, ...}] or one page inline
173
179
  sites: [{slug, name, spaces: [slugs], config: {...}, configMode: merge|replace}]
174
180
  domains, reader_auth, consent, connectors, executor, webhooks, tokens, status_monitors,
175
- brand, prune — as PUT /orgs/{org}/manifest documents them.
176
- Guide: https://forumulate.com/guides/forumulate-yaml-apply
181
+ brand, prune, force — as PUT /orgs/{org}/manifest documents them.
182
+ sites[].subdomain: <label> claims <label>.forumulate.com for the site (\`+ claim subdomain\`); null releases it.
177
183
 
178
184
  Examples:
179
185
  forumulate plan --diff
@@ -275,8 +281,39 @@ Usage:
275
281
  Here --out names the folder or file the command writes.
276
282
 
277
283
  ${exit_codes_1.EXIT_CODES_HELP}`;
284
+ /**
285
+ * The guide each command's own `--help` ends with (F-09): one `Guide:` line,
286
+ * last, the same form for every command that has one. Links named inline in
287
+ * the middle of a page were how three commands had a guide and twenty did not.
288
+ */
289
+ exports.GUIDES_BASE = 'https://forumulate.com/guides';
290
+ exports.COMMAND_GUIDE = {
291
+ publish: 'content-as-code',
292
+ sync: 'content-as-code',
293
+ dev: 'content-as-code',
294
+ doctor: 'cli',
295
+ validate: 'cli',
296
+ login: 'api-tokens-and-scopes',
297
+ logout: 'api-tokens-and-scopes',
298
+ whoami: 'api-tokens-and-scopes',
299
+ auth: 'api-tokens-and-scopes',
300
+ cache: 'cli',
301
+ snapshot: 'cli',
302
+ conformance: 'cli',
303
+ content: 'headless-cms',
304
+ import: 'importing',
305
+ pull: 'forumulate-yaml-apply',
306
+ 'domains records': 'custom-domains',
307
+ translations: 'translations-everywhere',
308
+ i18n: 'translations-everywhere',
309
+ check: 'cli',
310
+ plan: 'forumulate-yaml-apply',
311
+ apply: 'forumulate-yaml-apply',
312
+ heartbeat: 'status-monitors',
313
+ };
314
+ const withGuides = (pages) => Object.fromEntries(Object.entries(pages).map(([cmd, text]) => [cmd, exports.COMMAND_GUIDE[cmd] ? `${text.trimEnd()}\n\nGuide: ${exports.GUIDES_BASE}/${exports.COMMAND_GUIDE[cmd]}` : text]));
278
315
  /** The command → its own help. A command missing here prints the global help. */
279
- exports.COMMAND_HELP = {
316
+ exports.COMMAND_HELP = withGuides({
280
317
  publish: exports.PUBLISH_HELP,
281
318
  sync: exports.SYNC_HELP,
282
319
  dev: exports.DEV_HELP,
@@ -291,11 +328,26 @@ exports.COMMAND_HELP = {
291
328
  conformance: exports.CONFORMANCE_HELP,
292
329
  content: exports.CONTENT_HELP,
293
330
  import: exports.IMPORT_HELP,
294
- pull: `forumulate pull <folder> --space <slug> [--org <id|slug>]
331
+ pull: `forumulate pull <folder> --space <slug> [--org <id|slug>] [--only a,b] [--kinds <kind>] [--diff]
295
332
 
296
333
  Studio edits back into the folder, as Markdown. A file that already holds a page keeps its name and
297
334
  front matter, and a page not edited since it was last published is left alone. A new page gets its
298
- collection's folder, and its metadata, order and parent in front matter.`,
335
+ collection's folder, and its metadata, order and parent in front matter.
336
+
337
+ --only a,b just these slugs (what \`plan\` names under "Edited in the studio"); every other
338
+ file is left as it is
339
+ --diff print what would change in each file (paragraphs, - file + live); write nothing
340
+ --kinds <kind> pages | legal | faq | posts | releases. A space holds one kind, by its type
341
+ (DOCS and most others: pages; LEGAL: legal; FAQ: faq; BLOG: posts; CHANGELOG:
342
+ releases), and that is the default; naming another is a usage error (exit 2).
343
+ Posts and releases come back one Markdown file each (title and slug in front
344
+ matter), the form \`posts: {dir}\` and \`publish\` read
345
+
346
+ A block Markdown cannot express (a drawing, an extension block, an API operation) is kept as a
347
+ \`\`\`forumulate-block fence that publish and apply read back as that block, and named on stderr:
348
+ WARN <slug>: block <type> kept as a fenced component
349
+
350
+ ${exit_codes_1.EXIT_CODES_HELP}`,
299
351
  'domains records': `forumulate domains records [forumulate.yaml] [--org <o>] [--json] [--format cloudflare] [--vars-file <p>]
300
352
 
301
353
  The DNS records a plan waits for, as data. They exist once a domain is claimed: before the first
@@ -306,5 +358,5 @@ apply there are none, and stderr names the domains still to claim.`,
306
358
  plan: exports.PLAN_HELP,
307
359
  apply: exports.PLAN_HELP,
308
360
  heartbeat: heartbeat_command_1.HEARTBEAT_HELP,
309
- };
361
+ });
310
362
  //# sourceMappingURL=help-commands.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"help-commands.js","sourceRoot":"","sources":["../src/help-commands.ts"],"names":[],"mappings":";;;AAAA,2DAAqD;AACrD,yCAA2C;AAC3C,8CAA+C;AAC/C,6CAA+C;AAC/C,qCAAuC;AACvC,mDAA6C;AAC7C,6EAA6E;AAC7E,6CAAiE;AAEjE;;;;;;;;;GASG;AACH,MAAM,MAAM,GAAG;;8FAE+E,CAAC;AAElF,QAAA,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAwE1B,MAAM;;EAEN,4BAAe,EAAE,CAAC;AAEP,QAAA,SAAS,GAAG;;;;;;;;;;EAUvB,MAAM;;EAEN,4BAAe,EAAE,CAAC;AAEP,QAAA,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsEvB,MAAM;;EAEN,4BAAe,EAAE,CAAC;AAEP,QAAA,QAAQ,GAAG;;;;;;;;EAQtB,4BAAe,EAAE,CAAC;AAEP,QAAA,UAAU,GAAG;;;;;;;;;;;EAWxB,4BAAe,EAAE,CAAC;AAEP,QAAA,WAAW,GAAG;;;;;;;EAOzB,4BAAe,EAAE,CAAC;AAEP,QAAA,aAAa,GAAG;;;;;;EAM3B,4BAAe,EAAE,CAAC;AAEP,QAAA,gBAAgB,GAAG;;;;;;;;EAQ9B,4BAAe,EAAE,CAAC;AAEP,QAAA,YAAY,GAAG;;;;;;;;;;;;EAY1B,4BAAe,EAAE,CAAC;AAEP,QAAA,WAAW,GAAG;;;;;;;;;;;;EAYzB,MAAM;;EAEN,4BAAe,EAAE,CAAC;AAEP,QAAA,iBAAiB,GAAG;;;;;;;;;;;;;;;;;;EAkB/B,4BAAe,EAAE,CAAC;AAEpB,iFAAiF;AACpE,QAAA,YAAY,GAAqC;IAC5D,OAAO,EAAE,oBAAY;IACrB,IAAI,EAAE,iBAAS;IACf,GAAG,EAAE,gBAAQ;IACb,MAAM,EAAE,qBAAW;IACnB,QAAQ,EAAE,wBAAa;IACvB,KAAK,EAAE,kBAAU;IACjB,MAAM,EAAE,mBAAW;IACnB,MAAM,EAAE,oBAAW;IACnB,IAAI,EAAE,oBAAW;IACjB,KAAK,EAAE,0BAAU;IACjB,QAAQ,EAAE,qBAAa;IACvB,WAAW,EAAE,wBAAgB;IAC7B,OAAO,EAAE,oBAAY;IACrB,MAAM,EAAE,mBAAW;IACnB,IAAI,EAAE;;;;yEAIiE;IACvE,iBAAiB,EAAE;;;mEAG8C;IACjE,YAAY,EAAE,yBAAiB;IAC/B,IAAI,EAAE,yBAAiB;IACvB,KAAK,EAAE,oBAAgB;IACvB,IAAI,EAAE,iBAAS;IACf,KAAK,EAAE,iBAAS;IAChB,SAAS,EAAE,kCAAc;CAC1B,CAAC"}
1
+ {"version":3,"file":"help-commands.js","sourceRoot":"","sources":["../src/help-commands.ts"],"names":[],"mappings":"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"}
package/dist/help.d.ts CHANGED
@@ -1,3 +1,3 @@
1
1
  /** `forumulate help`. The resource groups print their own (`forumulate spaces --help`). */
2
- export declare const HELP = "forumulate \u2014 Forumulate command-line interface\n\nUsage:\n forumulate <command> [args]\n\nCommands:\n login [--token <pat>] Store a token for this API, so every other\n command stops needing FORUMULATE_TOKEN in\n the environment\n logout Forget the stored token\n whoami [--json] Who you are, and WHICH token: its source (--token,\n FORUMULATE_TOKEN or credentials.json), id, name,\n last 4, expiry, narrowing and the API base\n auth status [--json] The same report, for scripts\n config set|get|unset|list Defaults: org, space, library, api-version\n (`forumulate config set org acme`)\n\nEvery API operation:\n api list [--tag t] [--search w] Discover operations and their summaries\n [--refresh] ...from the live API's spec, not the bundled one\n api describe <operationId> Parameters and body schema, as flags\n api <operationId> [args] [flags] Call it: --<param> value, --data @f.json,\n api <METHOD> <path> [flags] --field a.b=v, --paginate, --json\n\nResources (each: <group> --help lists its verbs and the operation each calls):\n Org: orgs | members | invites | groups | roles | service-accounts (bots)\n tokens (pats) | keys | integration-tokens (int-tokens)\n webhooks | extensions | audit\n Spaces: spaces | snapshots | shape | domains | assets | space-types (types)\n Docs: items (pages) | docs | collections | versions | change-requests (crs)\n openapi | sdks | github (git)\n Content: blog | forum | changelog | roadmap | status | events | course\n careers | forms | about (blog/forum/changelog/status: translations \u2026)\n CMS: libraries | entries | media | releases | environments (envs)\n Site: theme | sites | reader\n Jobs: jobs | backups | imports | manifest (starters take --wait [--timeout s])\n search <query...> [--org] e.g. spaces create Docs --slug docs --type DOCS\n items create --space docs --file a.md --publish\n docs schedule set <pageId> <when> --space docs\n webhooks deliveries <id>; webhooks replay <id> <d>\n --out <file> where a file answer goes (SDK archive, PDF, CSV export)\n cache purge --space <s> [--page p] Drop cached copies (web tier + every CDN); deletes\n nothing\n completion bash|zsh|fish Shell completion script\n\nOlder forms, unchanged:\n orgs List your organizations\n spaces <orgId> List spaces in an org\n items <orgId> <spaceId> List what is in a space, with where each\n piece's content lives\n search <orgId> <query...> Unified search across docs/forum/blog\n dev <folder> Preview a folder of Markdown locally, rendered\n by your space's own renderer; reloads on save.\n --org <id> --space <id> [--port 4321] [--site <your docs URL>]\n publish <folder> --org <o> --space <s>\n Publish a folder of Markdown: one folder per\n collection, front matter, assets, order,\n and a forumulate.yaml manifest for space,\n site, theme, OpenAPI and monitors. Re-runs\n change only what changed, then read back.\n --org <id|slug> --space <id|slug> (or org:/space: in the manifest)\n --dry-run print the plan, write nothing (no token needed for a\n public space)\n --prune remove pages/posts/collections with no file (to the trash)\n --only a,b just these slugs, files, folders, or manifest parts\n (site, theme, settings, openapi, monitors)\n --force re-send every page even if it looks unchanged\n --no-verify skip the read-back --pace <ms> gap between writes\n --manifest <file> a manifest somewhere else\n --diff print the changed paragraphs and fields of each update\n --purge page|space|none what to drop from the cache (default page),\n reported per CDN\n --json one summary: created, updated, unchanged, trashed, purged,\n verify, diffUrl (the run is recorded; publish.completed fires)\n Pages edited in the studio since the last publish are not overwritten\n without --force. Full reference: forumulate publish --help\n sync <folder> Content as code: the same folder publish,\n PLAN BY DEFAULT. Posts (blog), pages\n (docs, custom, legal), FAQ questions,\n changelog releases and blog categories,\n matched by slug; images uploaded once by\n content hash; README, LICENSE, _drafts/,\n dotfiles skipped. Guide:\n https://forumulate.com/guides/content-as-code\n --apply write the plan (then read it back)\n --prune also remove what has no file (to the trash)\n --diff print the changed paragraphs and fields of each update\n --org, --space, --only, --force, --no-verify, --pace, --manifest, --json\n as for publish\n plan [forumulate.yaml] The whole site as one document (version: 2):\n spaces and their SEO, languages, front doors,\n contact form and About parts, Markdown pages\n with locale twins, redirects, sites. Prints\n the diff; writes nothing. --check exits 1\n when it is not empty. Full reference:\n forumulate plan --help\n apply [forumulate.yaml] Carry that plan out, idempotently, every\n write read back; --prune also removes what\n the manifest wrote and no longer declares\n --secrets-file <p> keeps the shown-once keys (0600);\n the output redacts them\n plan and apply: --vars-file <p> (repeatable) reads ${NAME}s from a dotenv file (the shell wins);\n declared secrets are masked in all output (--show-secrets on a terminal shows them)\n pull <folder> --space <s> Studio edits back into the folder, as Markdown; the\n next step when plan --check names an edited page\n init --from-site <folder> A first forumulate.yaml from the Markdown a site has\n import mdx <folder> What in these files would publish as literal text,\n with file and line; exit 1 when anything would\n domains records [forumulate.yaml] The DNS records a plan waits for, as data:\n [--json] [--format cloudflare] type, name, value, proxied: false\n heartbeat ping <monitor> [--fail] Report a job's pass to a heartbeat monitor\n (--message <why> with --fail); forumulate heartbeat --help\n heartbeat ping-url <monitor> Print that monitor's ping URL (it holds its secret)\n orgs ensure <slug> [--name <n>] The organization, created only when missing; safe to\n [--external-ref <ref>] re-run (run it before the first plan/apply)\n domains setup <host> --space <s> What a domain still waits for: mode, pendingReason,\n message; then domains verify / activate <host>\n check links [folder] Broken internal links, #anchors, pictures and\n (--external) outside links in a folder, before\n publishing; exit 1 when any is broken\n --space <s> [--org <o>] the same report for a published space\n --allow-redirect <hosts> --ignore <text> --json\n publish <folder> --preview <name> Send the change to a preview link instead of\n publishing it (--comment posts it on the PR)\n domains <orgId> <spaceId> List this space's domains and their state\n domains verify <orgId> <spaceId> <hostname>\n Re-run verification and say what is missing\n snapshot <orgId> <spaceId> <label> Create a space version snapshot\n content types --library <id|slug> TypeScript for a content library's model:\n collections, globals, the block union\n [--org <id|slug>] [--out forumulate.d.ts] [--preview] [--schema <file>]\n [--check] fail (exit 1) when the file is out of date, write nothing\n content pull --library <id|slug> Write the model to forumulate.content.json\n [--format json|payload] [--out <file>] (payload: forumulate.payload.ts)\n content push [file] Show the diff against the library, then\n apply it as a new model version\n [--library \u2026] [--dry-run] [--yes] [--force]\n [--rename type.field=new | block:hero.field=new | library:field=new]\n [--rename-type old=new] [--rename-block old=new]\n import <payload|contentful|sanity|strapi|wordpress> <export path>\n Bring another CMS's content into a library:\n model, media, entries, references (always\n shows a dry run first)\n Re-running updates entries a\n previous import made. strapi takes a\n folder or an unencrypted export .tar.gz\n --library <id|slug> [--org \u2026] [--dry-run] [--yes]\n [--config payload.config.ts] (payload) the config that becomes the model\n [--publish source|all|none] what to publish (default: what was live)\n [--allow-model-removals] [--pace <ms>] [--base-url <url>] (strapi uploads)\n translations (alias i18n) Every translation capability, one vocabulary\n locales list|add|relabel|remove|set a space's (--space) or library's\n (--library) languages; set es=Espa\u00F1ol fr [--prune] is exact\n status each piece \u00D7 language: missing/draft/published/outdated\n [--locale es,fr] [--fail-on missing,outdated] (exit 1)\n pull one Markdown file per piece per language \u2192 [--out translations]\n [--locale \u2026] [--only slug,\u2026] [--include-missing] (stubs)\n push [dir] diff the files against the API, write what changed [--dry-run]\n auto machine-translate with YOUR DeepL/AI key --locale es\n [--state missing,outdated] [--only \u2026] [--force] [--publish]\n [--library \u2026 --entry id,\u2026] [--dry-run]\n labels pull|push [file] chrome words (--site <id> | --space \u2026)\n overrides pull|push [file] org UI string overrides [--prune]\n [--format json|xliff] for labels and overrides\n item-locale <itemId> <locale|none> correct a piece's declared language\n remove <pieceId> <locale> one translation (--yes)\n entry <entryId> <locale> a library entry's twin [--fields f.json]\n name <locale> <name\u2026> a space's (or --collection's) name\n switcher get|set <f.json> the org's reader language switcher\n provider status|connect|disconnect your DeepL key (DEEPL_API_KEY)\n conformance <collectionUrl> Run the Content Sync Protocol suite against\n any platform's collection endpoint\n validate [dir] Check forumulate.yaml, front matter and $schema\n files against the published schemas, with\n did-you-mean hints. --json; exit 2 if invalid\n doctor <readerUrl> | --site <s> Check a live site from the outside: health,\n canonical on both addresses, sitemap, cache\n consistency, root redirect, descriptions,\n llms.txt, favicon, consent tag, white-label\n leaks. --json; exit 1 on any FAIL\n help [command] Show this help, or a command's own\n (every command also takes --help)\n\nEnvironment:\n FORUMULATE_TOKEN Personal Access Token (Bearer). Overrides a stored one, so\n CI keeps working exactly as it did; --token overrides it.\n Mint one at\n https://forumulate.com/account/tokens\n FORUMULATE_URL The site (default https://forumulate.com); the API is its\n /api, i.e. https://forumulate.com/api. A value already\n ending in /api is used as-is.\n FORUMULATE_API_URL Exact API base, for a local API with no /api prefix\n (http://localhost:4000). Wins over FORUMULATE_URL.\n FORUMULATE_API is read as the same thing.\n FORUMULATE_ORG, FORUMULATE_SPACE, FORUMULATE_LIBRARY\n Defaults for --org, --space and --library; they beat\n `forumulate config set`, a flag beats both.\n FORUMULATE_API_VERSION\n Forumulate-Version for api/resource commands\n (default: the SDK's current version).\n\nThe SDK (ForumulateClient.fromEnv) and the MCP server (@forumulate/mcp) read\nthe same variables. Guide: https://forumulate.com/guides/api-tokens-and-scopes\n\nEvery FORUMULATE_* variable not listed above is reported (with the one you\nprobably meant) by `forumulate whoami` and on any authentication failure.\n\nFlags:\n --json Emit raw JSON instead of a formatted summary (stdout only;\n progress and warnings go to stderr)\n --out <file> Write stdout to a file (never truncated; non-zero exit if the\n write fails). content/translations use --out for their own file\n --jsonl With --paginate: one JSON row per line, streamed\n --token <pat> The token for this run, on every command. Precedence:\n --token, then FORUMULATE_TOKEN, then credentials.json. On an\n operation with a `token` parameter of its own (registries\n set, github connect, domains acme-challenge) the flag is that\n parameter; set FORUMULATE_TOKEN for the PAT there\n --dry-run (api, resources) print the request instead of sending it\n --dry-run Plan the work and write nothing (publish of a directory)\n --version Print the CLI version\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL) 2 usage\n 3 auth (no token, 401, token not allowed) 4 not found\n 5 conflict (409/412, edited in the studio since your last publish)\n";
2
+ export declare const HELP = "forumulate \u2014 Forumulate command-line interface\n\nUsage:\n forumulate <command> [args]\n\nCommands:\n login [--token <pat>] Store a token for this API, so every other\n command stops needing FORUMULATE_TOKEN in\n the environment\n logout Forget the stored token\n whoami [--json] Who you are, and WHICH token: its source (--token,\n FORUMULATE_TOKEN or credentials.json), id, name,\n last 4, expiry, narrowing and the API base\n auth status [--json] The same report, for scripts\n config set|get|unset|list Defaults: org, space, library, api-version\n (`forumulate config set org acme`)\n\nEvery API operation:\n api list [--tag t] [--search w] Discover operations and their summaries\n [--refresh] ...from the live API's spec, not the bundled one\n api describe <operationId> Parameters and body schema, as flags\n api <operationId> [args] [flags] Call it: --<param> value, --data @f.json,\n api <METHOD> <path> [flags] --field a.b=v, --paginate, --json\n\nResources (each: <group> --help lists its verbs and the operation each calls):\n Org: orgs | members | invites | groups | roles | service-accounts (bots)\n tokens (pats) | keys | integration-tokens (int-tokens)\n webhooks | extensions | audit\n Spaces: spaces | snapshots | shape | domains | assets | space-types (types)\n Docs: items (pages) | docs | collections | versions | change-requests (crs)\n openapi | sdks | github (git)\n Content: blog | forum | changelog | roadmap | status | events | course\n careers | forms | about (blog/forum/changelog/status: translations \u2026)\n CMS: libraries | entries | media | releases | environments (envs)\n Site: theme | sites | reader\n Jobs: jobs | backups | imports | manifest (starters take --wait [--timeout s])\n search <query...> [--org] e.g. spaces create Docs --slug docs --type DOCS\n items create --space docs --file a.md --publish\n docs schedule set <pageId> <when> --space docs\n webhooks deliveries <id>; webhooks replay <id> <d>\n --out <file> where a file answer goes (SDK archive, PDF, CSV export)\n cache purge --space <s> [--page p] Drop cached copies (web tier + every CDN); deletes\n nothing\n completion bash|zsh|fish Shell completion script\n\nOlder forms, unchanged:\n orgs List your organizations\n spaces <orgId> List spaces in an org\n items <orgId> <spaceId> List what is in a space, with where each\n piece's content lives\n search <orgId> <query...> Unified search across docs/forum/blog\n dev <folder> Preview a folder of Markdown locally, rendered\n by your space's own renderer; reloads on save.\n --org <id> --space <id> [--port 4321] [--site <your docs URL>]\n publish <folder> --org <o> --space <s>\n Publish a folder of Markdown: one folder per\n collection, front matter, assets, order,\n and a forumulate.yaml manifest for space,\n site, theme, OpenAPI and monitors. Re-runs\n change only what changed, then read back.\n --org <id|slug> --space <id|slug> (or org:/space: in the manifest)\n --dry-run print the plan, write nothing (no token needed for a\n public space)\n --prune remove pages/posts/collections with no file (to the trash)\n --only a,b just these slugs, files, folders, or manifest parts\n (site, theme, settings, openapi, monitors)\n --force re-send every page even if it looks unchanged\n --no-verify skip the read-back --pace <ms> gap between writes\n --manifest <file> a manifest somewhere else\n --diff print the changed paragraphs and fields of each update\n --purge page|space|none what to drop from the cache (default page),\n reported per CDN\n --json one summary: created, updated, unchanged, trashed, purged,\n verify, diffUrl (the run is recorded; publish.completed fires)\n Pages edited in the studio since the last publish are not overwritten\n without --force. Full reference: forumulate publish --help\n sync <folder> Content as code: the same folder publish,\n PLAN BY DEFAULT. Posts (blog), pages\n (docs, custom, legal), FAQ questions,\n changelog releases and blog categories,\n matched by slug; images uploaded once by\n content hash; README, LICENSE, _drafts/,\n dotfiles skipped. Guide:\n https://forumulate.com/guides/content-as-code\n --apply write the plan (then read it back)\n --prune also remove what has no file (to the trash)\n --diff print the changed paragraphs and fields of each update\n --org, --space, --only, --force, --no-verify, --pace, --manifest, --json\n as for publish\n plan [forumulate.yaml] The whole site as one document (version: 2):\n spaces and their SEO, languages, front doors,\n contact form and About parts, Markdown pages\n with locale twins, redirects, sites. Prints\n the diff; writes nothing. --check exits 1\n when it is not empty. Full reference:\n forumulate plan --help\n apply [forumulate.yaml] Carry that plan out, idempotently, every\n write read back; --prune also removes what\n the manifest wrote and no longer declares;\n a page edited in the studio stops it (exit 5)\n unless --force\n --secrets-file <p> keeps the shown-once keys (0600);\n the output redacts them\n plan and apply: --vars-file <p> (repeatable) reads ${NAME}s from a dotenv file (the shell wins);\n declared secrets are masked in all output (--show-secrets on a terminal shows them)\n pull <folder> --space <s> Studio edits back into the folder, as Markdown; the\n next step when plan names an edited page\n (--only a,b, --diff, --kinds posts|releases|\u2026)\n init --from-site <folder> A first forumulate.yaml from the Markdown a site has\n import mdx <folder> What in these files would publish as literal text,\n with file and line; exit 1 when anything would\n domains records [forumulate.yaml] The DNS records a plan waits for, as data:\n [--json] [--format cloudflare] type, name, value, proxied: false\n heartbeat ping <monitor> [--fail] Report a job's pass to a heartbeat monitor\n (--message <why> with --fail); forumulate heartbeat --help\n heartbeat ping-url <monitor> Print that monitor's ping URL (it holds its secret)\n heartbeat rotate <monitor> A new ping secret, same monitor; the old one works\n [--overlap <seconds>] for the overlap (default 3600)\n orgs ensure <slug> [--name <n>] The organization, created only when missing; safe to\n [--external-ref <ref>] re-run (run it before the first plan/apply)\n domains setup <host> --space <s> What a domain still waits for: mode, pendingReason,\n message; then domains verify / activate <host>\n check links [folder] Broken internal links, #anchors, pictures and\n (--external) outside links in a folder, before\n publishing; exit 1 when any is broken\n --space <s> [--org <o>] the same report for a published space\n --allow-redirect <hosts> --ignore <text> --json\n publish <folder> --preview <name> Send the change to a preview link instead of\n publishing it (--comment posts it on the PR)\n domains <orgId> <spaceId> List this space's domains and their state\n domains verify <orgId> <spaceId> <hostname>\n Re-run verification and say what is missing\n snapshot <orgId> <spaceId> <label> Create a space version snapshot\n content types --library <id|slug> TypeScript for a content library's model:\n collections, globals, the block union\n [--org <id|slug>] [--out forumulate.d.ts] [--preview] [--schema <file>]\n [--check] fail (exit 1) when the file is out of date, write nothing\n content pull --library <id|slug> Write the model to forumulate.content.json\n [--format json|payload] [--out <file>] (payload: forumulate.payload.ts)\n content push [file] Show the diff against the library, then\n apply it as a new model version\n [--library \u2026] [--dry-run] [--yes] [--force]\n [--rename type.field=new | block:hero.field=new | library:field=new]\n [--rename-type old=new] [--rename-block old=new]\n import <payload|contentful|sanity|strapi|wordpress> <export path>\n Bring another CMS's content into a library:\n model, media, entries, references (always\n shows a dry run first)\n Re-running updates entries a\n previous import made. strapi takes a\n folder or an unencrypted export .tar.gz\n --library <id|slug> [--org \u2026] [--dry-run] [--yes]\n [--config payload.config.ts] (payload) the config that becomes the model\n [--publish source|all|none] what to publish (default: what was live)\n [--allow-model-removals] [--pace <ms>] [--base-url <url>] (strapi uploads)\n translations (alias i18n) Every translation capability, one vocabulary\n locales list|add|relabel|remove|set a space's (--space) or library's\n (--library) languages; set es=Espa\u00F1ol fr [--prune] is exact\n status each piece \u00D7 language: missing/draft/published/outdated\n [--locale es,fr] [--fail-on missing,outdated] (exit 1)\n pull one Markdown file per piece per language \u2192 [--out translations]\n [--locale \u2026] [--only slug,\u2026] [--include-missing] (stubs)\n push [dir] diff the files against the API, write what changed [--dry-run]\n auto machine-translate with YOUR DeepL/AI key --locale es\n [--state missing,outdated] [--only \u2026] [--force] [--publish]\n [--library \u2026 --entry id,\u2026] [--dry-run]\n labels pull|push [file] chrome words (--site <id> | --space \u2026)\n overrides pull|push [file] org UI string overrides [--prune]\n [--format json|xliff] for labels and overrides\n item-locale <itemId> <locale|none> correct a piece's declared language\n remove <pieceId> <locale> one translation (--yes)\n entry <entryId> <locale> a library entry's twin [--fields f.json]\n name <locale> <name\u2026> a space's (or --collection's) name\n switcher get|set <f.json> the org's reader language switcher\n provider status|connect|disconnect your DeepL key (DEEPL_API_KEY)\n conformance <collectionUrl> Run the Content Sync Protocol suite against\n any platform's collection endpoint\n validate [dir] Check forumulate.yaml, front matter and $schema\n files against the published schemas, with\n did-you-mean hints. --json; exit 2 if invalid\n doctor <readerUrl> | --site <s> Check a live site from the outside: health,\n canonical on both addresses, sitemap, cache\n consistency, root redirect, descriptions,\n llms.txt, favicon, consent tag, white-label\n leaks. --json; exit 1 on any FAIL\n help [command] Show this help, or a command's own\n (every command also takes --help)\n\nEnvironment:\n FORUMULATE_TOKEN Personal Access Token (Bearer). Overrides a stored one, so\n CI keeps working exactly as it did; --token overrides it.\n Mint one at\n https://forumulate.com/account/tokens\n FORUMULATE_URL The site (default https://forumulate.com); the API is its\n /api, i.e. https://forumulate.com/api. A value already\n ending in /api is used as-is.\n FORUMULATE_API_URL Exact API base, for a local API with no /api prefix\n (http://localhost:4000). Wins over FORUMULATE_URL.\n FORUMULATE_API is read as the same thing.\n FORUMULATE_ORG, FORUMULATE_SPACE, FORUMULATE_LIBRARY\n Defaults for --org, --space and --library; they beat\n `forumulate config set`, a flag beats both.\n FORUMULATE_API_VERSION\n Forumulate-Version for api/resource commands\n (default: the SDK's current version).\n\nThe SDK (ForumulateClient.fromEnv) and the MCP server (@forumulate/mcp) read\nthe same variables. Guide: https://forumulate.com/guides/api-tokens-and-scopes\n\nEvery FORUMULATE_* variable not listed above is reported (with the one you\nprobably meant) by `forumulate whoami` and on any authentication failure.\n\nFlags:\n --json Emit raw JSON instead of a formatted summary (stdout only;\n progress and warnings go to stderr)\n --out <file> Write stdout to a file (never truncated; non-zero exit if the\n write fails). content/translations use --out for their own file\n --jsonl With --paginate: one JSON row per line, streamed\n --token <pat> The token for this run, on every command. Precedence:\n --token, then FORUMULATE_TOKEN, then credentials.json. On an\n operation with a `token` parameter of its own (registries\n set, github connect, domains acme-challenge) the flag is that\n parameter; set FORUMULATE_TOKEN for the PAT there\n --dry-run (api, resources) print the request instead of sending it\n --dry-run Plan the work and write nothing (publish of a directory)\n --version Print the CLI version\n\nExit status:\n 0 ok 1 failed (verification mismatch, doctor FAIL) 2 usage\n 3 auth (no token, 401, token not allowed) 4 not found\n 5 conflict (409/412, edited in the studio since your last publish or apply)\n 6 outdated (this CLI is older than the oldest the API supports)\n\nEvery command's own --help ends with its guide. All guides: https://forumulate.com/guides\n";
3
3
  //# sourceMappingURL=help.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,eAAO,MAAM,IAAI,yveAkOhB,CAAC"}
1
+ {"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,eAAO,MAAM,IAAI,4xfA0OhB,CAAC"}
package/dist/help.js CHANGED
@@ -100,13 +100,16 @@ Older forms, unchanged:
100
100
  forumulate plan --help
101
101
  apply [forumulate.yaml] Carry that plan out, idempotently, every
102
102
  write read back; --prune also removes what
103
- the manifest wrote and no longer declares
103
+ the manifest wrote and no longer declares;
104
+ a page edited in the studio stops it (exit 5)
105
+ unless --force
104
106
  --secrets-file <p> keeps the shown-once keys (0600);
105
107
  the output redacts them
106
108
  plan and apply: --vars-file <p> (repeatable) reads \${NAME}s from a dotenv file (the shell wins);
107
109
  declared secrets are masked in all output (--show-secrets on a terminal shows them)
108
110
  pull <folder> --space <s> Studio edits back into the folder, as Markdown; the
109
- next step when plan --check names an edited page
111
+ next step when plan names an edited page
112
+ (--only a,b, --diff, --kinds posts|releases|…)
110
113
  init --from-site <folder> A first forumulate.yaml from the Markdown a site has
111
114
  import mdx <folder> What in these files would publish as literal text,
112
115
  with file and line; exit 1 when anything would
@@ -115,6 +118,8 @@ Older forms, unchanged:
115
118
  heartbeat ping <monitor> [--fail] Report a job's pass to a heartbeat monitor
116
119
  (--message <why> with --fail); forumulate heartbeat --help
117
120
  heartbeat ping-url <monitor> Print that monitor's ping URL (it holds its secret)
121
+ heartbeat rotate <monitor> A new ping secret, same monitor; the old one works
122
+ [--overlap <seconds>] for the overlap (default 3600)
118
123
  orgs ensure <slug> [--name <n>] The organization, created only when missing; safe to
119
124
  [--external-ref <ref>] re-run (run it before the first plan/apply)
120
125
  domains setup <host> --space <s> What a domain still waits for: mode, pendingReason,
@@ -227,6 +232,9 @@ Flags:
227
232
  Exit status:
228
233
  0 ok 1 failed (verification mismatch, doctor FAIL) 2 usage
229
234
  3 auth (no token, 401, token not allowed) 4 not found
230
- 5 conflict (409/412, edited in the studio since your last publish)
235
+ 5 conflict (409/412, edited in the studio since your last publish or apply)
236
+ 6 outdated (this CLI is older than the oldest the API supports)
237
+
238
+ Every command's own --help ends with its guide. All guides: https://forumulate.com/guides
231
239
  `;
232
240
  //# sourceMappingURL=help.js.map
package/dist/help.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":";;;AAAA,2FAA2F;AAC9E,QAAA,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkOnB,CAAC"}
1
+ {"version":3,"file":"help.js","sourceRoot":"","sources":["../src/help.ts"],"names":[],"mappings":";;;AAAA,2FAA2F;AAC9E,QAAA,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0OnB,CAAC"}
@@ -1 +1 @@
1
- {"version":3,"file":"mdx.d.ts","sourceRoot":"","sources":["../../src/import/mdx.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,eAAO,MAAM,cAAc,UAM1B,CAAC;AAGF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAoDD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAyBpE;AAaD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,EACvD,IAAI,EAAE;IAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GAC3D,MAAM,CAmBR;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EACvB,IAAI,EAAE;IAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE,MAAM,CAqCR"}
1
+ {"version":3,"file":"mdx.d.ts","sourceRoot":"","sources":["../../src/import/mdx.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,eAAO,MAAM,cAAc,UAM1B,CAAC;AAGF,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAmDD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAkBpE;AAaD,wBAAgB,YAAY,CAC1B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,EACvD,IAAI,EAAE;IAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAAE,GAC3D,MAAM,CAmBR;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,EACvB,IAAI,EAAE;IAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,GACzE,MAAM,CAqCR"}
@@ -7,6 +7,8 @@ exports.runInitFromSite = runInitFromSite;
7
7
  const node_fs_1 = require("node:fs");
8
8
  const node_path_1 = require("node:path");
9
9
  const exit_codes_1 = require("../exit-codes");
10
+ const names_1 = require("../publish/names");
11
+ const fences_1 = require("../publish/fences");
10
12
  /**
11
13
  * MDX is converted by the API at every door (`apps/api/src/docs/import-mdx.ts`), so
12
14
  * nothing here rewrites a file. What was missing is knowing BEFORE publishing what it
@@ -36,8 +38,7 @@ function misplacedItems(text, file) {
36
38
  const out = [];
37
39
  const stack = [];
38
40
  // Blanked rather than removed, so offsets still give line numbers.
39
- const masked = text
40
- .replace(/^\s*(`{3,}|~{3,})[\s\S]*?^\s*\1\s*$/gm, (m) => m.replace(/[^\n]/g, ' '))
41
+ const masked = (0, fences_1.blankFencedCode)(text)
41
42
  .replace(/`[^`\n]*`/g, (m) => ' '.repeat(m.length));
42
43
  const lineAt = (at) => masked.slice(0, at).split('\n').length;
43
44
  const looseText = (from, to) => {
@@ -83,18 +84,8 @@ function misplacedItems(text, file) {
83
84
  function mdxProblems(text, file) {
84
85
  const out = [];
85
86
  const isMdx = /\.mdx$/i.test(file);
86
- let fence = null;
87
- text.split(/\r?\n/).forEach((raw, i) => {
88
- const open = /^\s*(`{3,}|~{3,})/.exec(raw);
89
- if (open) {
90
- if (!fence)
91
- fence = open[1];
92
- else if (open[1].startsWith(fence))
93
- fence = null;
94
- return;
95
- }
96
- if (fence)
97
- return;
87
+ // Fenced lines come back blank, so nothing below can match inside code.
88
+ (0, fences_1.blankFencedCode)(text).split(/\r?\n/).forEach((raw, i) => {
98
89
  if (/^(import|export)\s/.test(raw)) {
99
90
  if (!isMdx)
100
91
  out.push({ file, line: i + 1, what: `\`${raw.split(/\s/)[0]}\` statement` });
@@ -172,7 +163,7 @@ function runInitFromSite(root, flags, deps) {
172
163
  const pages = [];
173
164
  for (const f of folders) {
174
165
  const name = f.split(node_path_1.sep).pop().toLowerCase();
175
- const slug = name.replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '') || 'docs';
166
+ const slug = (0, names_1.slugify)(name, 'docs');
176
167
  const dir = (0, node_path_1.relative)(base, f).split(node_path_1.sep).join('/');
177
168
  if (name === 'blog' || name === 'posts')
178
169
  lines.push(` - { slug: ${slug}, name: ${slug}, type: BLOG, posts: { dir: ${dir} } }`);
@@ -1 +1 @@
1
- {"version":3,"file":"mdx.js","sourceRoot":"","sources":["../../src/import/mdx.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"mdx.js","sourceRoot":"","sources":["../../src/import/mdx.ts"],"names":[],"mappings":"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"}
@@ -13,14 +13,14 @@ const FOLDER = [
13
13
  ];
14
14
  const PLAN = [
15
15
  '--file', '--manifest', '--prune', '--diff', '--check', '--verbose', '--allow-unset-env', '--batch', '--secrets-file',
16
- '--env-file', '--vars-file', '--show-secrets', '--create-org',
16
+ '--env-file', '--vars-file', '--show-secrets', '--create-org', '--force',
17
17
  ];
18
18
  const KNOWN = {
19
19
  publish: FOLDER,
20
20
  sync: [...FOLDER, '--apply'],
21
21
  plan: PLAN,
22
22
  apply: PLAN,
23
- pull: [],
23
+ pull: ['--only', '--diff', '--kinds'],
24
24
  init: ['--from-site'],
25
25
  };
26
26
  /** The first flag this command does not take; undefined when all are known, or it keeps no list. */
@@ -1 +1 @@
1
- {"version":3,"file":"known-flags.js","sourceRoot":"","sources":["../src/known-flags.ts"],"names":[],"mappings":";;;AAuBA,kCAUC;AAjCD;;;GAGG;AACH,MAAM,MAAM,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AAChF,MAAM,MAAM,GAAG;IACb,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ;IACvG,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU;CAChF,CAAC;AACF,MAAM,IAAI,GAAG;IACX,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,mBAAmB,EAAE,SAAS,EAAE,gBAAgB;IACrH,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc;CAC9D,CAAC;AACF,MAAM,KAAK,GAA6B;IACtC,OAAO,EAAE,MAAM;IACf,IAAI,EAAE,CAAC,GAAG,MAAM,EAAE,SAAS,CAAC;IAC5B,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,CAAC,aAAa,CAAC;CACtB,CAAC;AAEF,oGAAoG;AACpG,SAAgB,WAAW,CAAC,GAAW,EAAE,IAAc,EAAE,KAAkB;IACzE,MAAM,KAAK,GACT,GAAG,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK;QACnC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;YAC1C,CAAC,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,CAAC;YACnE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACI,MAAM,WAAW,GAAG,CAAC,IAAc,EAAY,EAAE,CACtD,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACpB,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC;IACzD,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC,KAAK,aAAa,IAAI,CAAC,KAAK,YAAY;QACzC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC,CAAC,EAAE,CACT,CAAC;AAPS,QAAA,WAAW,eAOpB"}
1
+ {"version":3,"file":"known-flags.js","sourceRoot":"","sources":["../src/known-flags.ts"],"names":[],"mappings":";;;AAuBA,kCAUC;AAjCD;;;GAGG;AACH,MAAM,MAAM,GAAG,CAAC,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AAChF,MAAM,MAAM,GAAG;IACb,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ;IACvG,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU;CAChF,CAAC;AACF,MAAM,IAAI,GAAG;IACX,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,mBAAmB,EAAE,SAAS,EAAE,gBAAgB;IACrH,YAAY,EAAE,aAAa,EAAE,gBAAgB,EAAE,cAAc,EAAE,SAAS;CACzE,CAAC;AACF,MAAM,KAAK,GAA6B;IACtC,OAAO,EAAE,MAAM;IACf,IAAI,EAAE,CAAC,GAAG,MAAM,EAAE,SAAS,CAAC;IAC5B,IAAI,EAAE,IAAI;IACV,KAAK,EAAE,IAAI;IACX,IAAI,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAC;IACrC,IAAI,EAAE,CAAC,aAAa,CAAC;CACtB,CAAC;AAEF,oGAAoG;AACpG,SAAgB,WAAW,CAAC,GAAW,EAAE,IAAc,EAAE,KAAkB;IACzE,MAAM,KAAK,GACT,GAAG,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK;QACnC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,GAAG,KAAK,SAAS,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS;YAC1C,CAAC,CAAC,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,CAAC;YACnE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACnB,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;IAC/C,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC;AAED;;;;GAIG;AACI,MAAM,WAAW,GAAG,CAAC,IAAc,EAAY,EAAE,CACtD,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACpB,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC;IACzD,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/B,CAAC,CAAC,CAAC,KAAK,aAAa,IAAI,CAAC,KAAK,YAAY;QACzC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACrB,CAAC,CAAC,EAAE,CACT,CAAC;AAPS,QAAA,WAAW,eAOpB"}
@@ -0,0 +1,8 @@
1
+ /** Negative when `a` is older than `b`; 0 when equal or either is not a version. */
2
+ export declare function compareVersions(a: string, b: string): number;
3
+ /** null to carry on; EXIT.OUTDATED when this CLI is below the API's minimum. */
4
+ export declare function checkCliRelease(cli: {
5
+ recommended: string;
6
+ minimum: string;
7
+ } | undefined, err: (l: string) => void, version?: string): number | null;
8
+ //# sourceMappingURL=cli-release.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli-release.d.ts","sourceRoot":"","sources":["../../src/plan/cli-release.ts"],"names":[],"mappings":"AAoBA,oFAAoF;AACpF,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAM5D;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAC7B,GAAG,EAAE;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,EACzD,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,EACxB,OAAO,GAAE,MAAgB,GACxB,MAAM,GAAG,IAAI,CASf"}
@@ -0,0 +1,47 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.compareVersions = compareVersions;
4
+ exports.checkCliRelease = checkCliRelease;
5
+ const exit_codes_1 = require("../exit-codes");
6
+ const version_1 = require("../version");
7
+ /**
8
+ * What this CLI does with the API's `cli: {recommended, minimum}` (F-12).
9
+ *
10
+ * A pinned CLI had no way to learn it was behind. The manifest answer now
11
+ * carries the two release facts: behind `recommended` prints ONE line on
12
+ * stderr (stdout is a plan, often `--json`, that a script parses); behind
13
+ * `minimum` refuses with exit 6 before anything is written — the dry run is
14
+ * always the first request, so the refusal costs nothing.
15
+ *
16
+ * Its own compare rather than @forumulate/shared's: the CLI ships with the
17
+ * SDK and `yaml` only (packages/shared is not a dependency of the package).
18
+ */
19
+ function parts(v) {
20
+ const m = /^(\d+)\.(\d+)\.(\d+)/.exec(v);
21
+ return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
22
+ }
23
+ /** Negative when `a` is older than `b`; 0 when equal or either is not a version. */
24
+ function compareVersions(a, b) {
25
+ const x = parts(a);
26
+ const y = parts(b);
27
+ if (!x || !y)
28
+ return 0;
29
+ for (let i = 0; i < 3; i++)
30
+ if (x[i] !== y[i])
31
+ return x[i] - y[i];
32
+ return 0;
33
+ }
34
+ /** null to carry on; EXIT.OUTDATED when this CLI is below the API's minimum. */
35
+ function checkCliRelease(cli, err, version = version_1.VERSION) {
36
+ if (!cli)
37
+ return null;
38
+ const upgrade = `npx -y @forumulate/cli@${cli.recommended}`;
39
+ if (compareVersions(version, cli.minimum) < 0) {
40
+ err(`forumulate: this API supports @forumulate/cli ${cli.minimum} and later; you run ${version}. Nothing was written. Upgrade: ${upgrade}`);
41
+ return exit_codes_1.EXIT.OUTDATED;
42
+ }
43
+ if (compareVersions(version, cli.recommended) < 0)
44
+ err(`CLI ${cli.recommended} is available (you run ${version}): ${upgrade}`);
45
+ return null;
46
+ }
47
+ //# sourceMappingURL=cli-release.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli-release.js","sourceRoot":"","sources":["../../src/plan/cli-release.ts"],"names":[],"mappings":";;AAqBA,0CAMC;AAGD,0CAaC;AA3CD,8CAAqC;AACrC,wCAAqC;AAErC;;;;;;;;;;;GAWG;AACH,SAAS,KAAK,CAAC,CAAS;IACtB,MAAM,CAAC,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC/D,CAAC;AAED,oFAAoF;AACpF,SAAgB,eAAe,CAAC,CAAS,EAAE,CAAS;IAClD,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACnB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IACnB,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACvB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC,CAAE,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC;IACpE,OAAO,CAAC,CAAC;AACX,CAAC;AAED,gFAAgF;AAChF,SAAgB,eAAe,CAC7B,GAAyD,EACzD,GAAwB,EACxB,UAAkB,iBAAO;IAEzB,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,OAAO,GAAG,0BAA0B,GAAG,CAAC,WAAW,EAAE,CAAC;IAC5D,IAAI,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC9C,GAAG,CAAC,iDAAiD,GAAG,CAAC,OAAO,uBAAuB,OAAO,mCAAmC,OAAO,EAAE,CAAC,CAAC;QAC5I,OAAO,iBAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IACD,IAAI,eAAe,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC;QAAE,GAAG,CAAC,OAAO,GAAG,CAAC,WAAW,0BAA0B,OAAO,MAAM,OAAO,EAAE,CAAC,CAAC;IAC/H,OAAO,IAAI,CAAC;AACd,CAAC"}