@teambit/harmony.content.cli-reference 2.0.1108 → 2.0.1109

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.
@@ -1,4 +1,4 @@
1
1
  ---
2
- description: 'Bit command synopses. Bit version: 1.13.247'
2
+ description: 'Bit command synopses. Bit version: 1.13.248'
3
3
  labels: ['cli', 'mdx', 'docs']
4
4
  ---
@@ -4998,10 +4998,15 @@
4998
4998
  "",
4999
4999
  "skip-cleanup",
5000
5000
  "Skip restoring the workspace (switching back to main) after export. Use when the workspace is discarded right after, e.g. an ephemeral CI container"
5001
+ ],
5002
+ [
5003
+ "",
5004
+ "skip-tasks <tasks>",
5005
+ "Comma-separated list of build/publish task names (or aspect-ids) to skip during snap, e.g. \"ExtractSchema,GeneratePreview,GenerateEnvTemplate,PublishComponents\". Speeds up PR builds by trading optional artifacts (schema/preview) and publishing for build time; they are produced on the final export to main"
5001
5006
  ]
5002
5007
  ],
5003
5008
  "description": "Exports a feature lane to Bit Cloud when a Pull Request is opened or updated.",
5004
- "extendedDescription": "Resolves the lane name from --lane or the current Git branch, validates it, and runs install, status, snap, and export. By default it then restores the workspace by switching back to main; pass --skip-cleanup to skip that restore when the workspace is about to be discarded (e.g. an ephemeral CI container). Use in pull-request CI pipelines after tests and before deploy.",
5009
+ "extendedDescription": "Resolves the lane name from --lane or the current Git branch, validates it, and runs install, status, snap, and export. By default it then restores the workspace by switching back to main; pass --skip-cleanup to skip that restore when the workspace is about to be discarded (e.g. an ephemeral CI container). PR builds run the full pipeline by default; to trade specific tasks for speed on a given PR, add a [skip-tasks: ...] token to the commit message (e.g. [skip-tasks: GeneratePreview,ExtractSchema]), which merges with any --skip-tasks flag. Use in pull-request CI pipelines after tests and before deploy.",
5005
5010
  "group": "collaborate",
5006
5011
  "private": false
5007
5012
  },
package/cli-reference.mdx CHANGED
@@ -419,17 +419,18 @@ Runs lint, build, and status checks to catch dependency drift or broken builds e
419
419
  **Usage**: `ci pr`
420
420
 
421
421
  **Description**: Exports a feature lane to Bit Cloud when a Pull Request is opened or updated.
422
- Resolves the lane name from --lane or the current Git branch, validates it, and runs install, status, snap, and export. By default it then restores the workspace by switching back to main; pass --skip-cleanup to skip that restore when the workspace is about to be discarded (e.g. an ephemeral CI container). Use in pull-request CI pipelines after tests and before deploy.
423
-
424
- | **Option** | **Option alias** | **Description** |
425
- | --------------------- | :--------------: | --------------------------------------------------------------------------------------------------------------------------------------------------- |
426
- | `--message <message>` | `-m` | If set, set it as the snap message, if not, try and grab from git-commit-message |
427
- | `--lane <lane>` | `-l` | If set, use as the lane name, if not available, grab from git-branch name |
428
- | `--build` | `-b` | Set to true to build the app locally, false (default) will build on Ripple CI |
429
- | `--strict` | `-s` | Set to true to fail on warnings as well as errors, false (default) only fails on errors |
430
- | `--dry-run` | `-d` | Run the full pipeline but skip exporting to remote (build runs only if --build is set) |
431
- | `--keep-lane` | | Reuse the same remote lane across PR commits (preserves lane history and cloud UI edits) instead of recreating it on every run |
432
- | `--skip-cleanup` | | Skip restoring the workspace (switching back to main) after export. Use when the workspace is discarded right after, e.g. an ephemeral CI container |
422
+ Resolves the lane name from --lane or the current Git branch, validates it, and runs install, status, snap, and export. By default it then restores the workspace by switching back to main; pass --skip-cleanup to skip that restore when the workspace is about to be discarded (e.g. an ephemeral CI container). PR builds run the full pipeline by default; to trade specific tasks for speed on a given PR, add a [skip-tasks: ...] token to the commit message (e.g. [skip-tasks: GeneratePreview,ExtractSchema]), which merges with any --skip-tasks flag. Use in pull-request CI pipelines after tests and before deploy.
423
+
424
+ | **Option** | **Option alias** | **Description** |
425
+ | ---------------------- | :--------------: | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
426
+ | `--message <message>` | `-m` | If set, set it as the snap message, if not, try and grab from git-commit-message |
427
+ | `--lane <lane>` | `-l` | If set, use as the lane name, if not available, grab from git-branch name |
428
+ | `--build` | `-b` | Set to true to build the app locally, false (default) will build on Ripple CI |
429
+ | `--strict` | `-s` | Set to true to fail on warnings as well as errors, false (default) only fails on errors |
430
+ | `--dry-run` | `-d` | Run the full pipeline but skip exporting to remote (build runs only if --build is set) |
431
+ | `--keep-lane` | | Reuse the same remote lane across PR commits (preserves lane history and cloud UI edits) instead of recreating it on every run |
432
+ | `--skip-cleanup` | | Skip restoring the workspace (switching back to main) after export. Use when the workspace is discarded right after, e.g. an ephemeral CI container |
433
+ | `--skip-tasks <tasks>` | | Comma-separated list of build/publish task names (or aspect-ids) to skip during snap, e.g. "ExtractSchema,GeneratePreview,GenerateEnvTemplate,PublishComponents". Speeds up PR builds by trading optional artifacts (schema/preview) and publishing for build time; they are produced on the final export to main |
433
434
 
434
435
  ### ci merge
435
436
 
@@ -1,4 +1,4 @@
1
1
  ---
2
- description: 'Bit command synopses. Bit version: 1.13.247'
2
+ description: 'Bit command synopses. Bit version: 1.13.248'
3
3
  labels: ['cli', 'mdx', 'docs']
4
4
  ---
@@ -4998,10 +4998,15 @@
4998
4998
  "",
4999
4999
  "skip-cleanup",
5000
5000
  "Skip restoring the workspace (switching back to main) after export. Use when the workspace is discarded right after, e.g. an ephemeral CI container"
5001
+ ],
5002
+ [
5003
+ "",
5004
+ "skip-tasks <tasks>",
5005
+ "Comma-separated list of build/publish task names (or aspect-ids) to skip during snap, e.g. \"ExtractSchema,GeneratePreview,GenerateEnvTemplate,PublishComponents\". Speeds up PR builds by trading optional artifacts (schema/preview) and publishing for build time; they are produced on the final export to main"
5001
5006
  ]
5002
5007
  ],
5003
5008
  "description": "Exports a feature lane to Bit Cloud when a Pull Request is opened or updated.",
5004
- "extendedDescription": "Resolves the lane name from --lane or the current Git branch, validates it, and runs install, status, snap, and export. By default it then restores the workspace by switching back to main; pass --skip-cleanup to skip that restore when the workspace is about to be discarded (e.g. an ephemeral CI container). Use in pull-request CI pipelines after tests and before deploy.",
5009
+ "extendedDescription": "Resolves the lane name from --lane or the current Git branch, validates it, and runs install, status, snap, and export. By default it then restores the workspace by switching back to main; pass --skip-cleanup to skip that restore when the workspace is about to be discarded (e.g. an ephemeral CI container). PR builds run the full pipeline by default; to trade specific tasks for speed on a given PR, add a [skip-tasks: ...] token to the commit message (e.g. [skip-tasks: GeneratePreview,ExtractSchema]), which merges with any --skip-tasks flag. Use in pull-request CI pipelines after tests and before deploy.",
5005
5010
  "group": "collaborate",
5006
5011
  "private": false
5007
5012
  },