@teambit/ci 0.0.0-031a1d30cdf91fc70af4ca36aa0be18827e410d1

package/ci.docs.mdx

@@ -0,0 +1,117 @@
+---
+description: 'Aspect that eases the Bit workflow in CI'
+labels: ['aspect', 'ci']
+---
+
+# Bit CI
+
+Bit's **`bit ci`** commands (plus one BVM enhancement) wrap several routine Bit tasks into single-purpose scripts so your CI pipelines stay short, readable and consistent.
+
+| Command                           | Purpose                                               | Typical CI Stage       |
+| --------------------------------- | ----------------------------------------------------- | ---------------------- |
+| [`bit ci verify`](#bit-ci-verify) | Lint + build gate on every commit                     | pre-push / commit hook |
+| [`bit ci pr`](#bit-ci-pr)         | Snap + export a feature lane when a PR opens/updates  | pull-request pipeline  |
+| [`bit ci merge`](#bit-ci-merge)   | Tag + export new semantic versions on merge to `main` | merge-to-main pipeline |
+
+---
+
+## `bit ci verify`
+
+|                  |                                                   |
+| ---------------- | ------------------------------------------------- |
+| **Syntax**       | `bit ci verify`                                   |
+| **What it does** | Ensures the component passes CI on every commit   |
+| **Runs**         | `bit install && bit status --strict && bit build` |
+
+### When to run
+
+- Every commit that **is not** part of an open Pull Request (e.g. a pre-push hook).
+- As an early CI job to fail fast on dependency drift or broken builds.
+
+### Exit behaviour
+
+The command stops at the first failing step (`status`, then `build`) and returns a non-zero exit code.
+
+---
+
+## `bit ci pr`
+
+Export a lane to Bit Cloud whenever a Pull Request is opened or updated.
+
+```bash
+bit ci pr [--message <string>] [--build] [--lane <string>]
+```
+
+| Flag        | Shorthand | Description                                                                               |
+| ----------- | --------- | ----------------------------------------------------------------------------------------- |
+| `--message` | `-m`      | Changelog entry. If omitted, tries the latest Git commit message (fails if unavailable).  |
+| `--build`   | `-b`      | Build locally before export. If absent, Ripple-CI builds the components.                  |
+| `--lane`    | `-l`      | Explicit lane name. Falls back to the current Git branch name. Performs input validation. |
+
+### Internal flow (fail-fast on any step)
+
+1. **Resolve lane name**
+   - From `--lane` or current Git branch.
+   - If the lane doesn’t exist remotely, create it; otherwise, `bit lane checkout <lane>`.
+2. **Run wrapped Bit commands**
+
+   ```bash
+   bit install
+   bit status --strict
+   bit lane create <lane>      # no-op if already exists
+   bit snap --message "<msg>" --build
+   bit export
+   ```
+
+3. **Clean-up**
+
+   ```bash
+   bit lane switch main   # leaves .bitmap unchanged in the working tree
+   ```
+
+### Typical CI placement
+
+Run on the _pull-request_ event after tests but before any deploy step.
+
+---
+
+## `bit ci merge`
+
+Publishes new semantic versions after a PR merges to `main`.
+
+```bash
+bit ci merge [--message <string>] [--build]
+```
+
+| Flag        | Shorthand | Description                                                                                           |
+| ----------- | --------- | ----------------------------------------------------------------------------------------------------- |
+| `--message` | `-m`      | Changelog entry (defaults to last Git commit message).                                                |
+| `--build`   | `-b`      | Build locally (otherwise Ripple-CI does it). Required if workspace contains _soft-tagged_ components. |
+
+### Internal flow
+
+1. **Ensure main lane**
+
+   ```bash
+   bit lane switch main   # preserves working tree files
+   ```
+
+2. **Tag, build, export**
+
+   ```bash
+   bit install
+   bit tag --message "<msg>" --build --persist   # --persist only if soft tags exist
+   bit export
+   ```
+
+3. **Archive remote lane** (house-keeping).
+4. **Commit lock-file updates**
+
+   ```bash
+   git add .bitmap pnpm-lock.yaml
+   git commit -m "chore(release): sync bitmap + lockfile"
+   ```
+
+### CI hint
+
+Gate this step behind a branch-protection rule so only fast-forward merges trigger a release.

package/commands/merge.cmd.ts

@@ -0,0 +1,36 @@
+import type { Command, CommandOptions } from '@teambit/cli';
+import type { Logger } from '@teambit/logger';
+import { OutsideWorkspaceError, type Workspace } from '@teambit/workspace';
+import { CiMain } from '../ci.main.runtime';
+
+type Options = {
+  message?: string;
+  build?: boolean;
+  strict?: boolean;
+};
+
+export class CiMergeCmd implements Command {
+  name = 'merge';
+  description = 'Merges a PR';
+  group = 'collaborate';
+
+  options: CommandOptions = [
+    ['m', 'message <message>', 'If set, use it as the snap message, if not, try and grab from git-commit-message'],
+    ['b', 'build', 'Set to true to build the app locally, false (default) will build on Ripple CI'],
+    ['s', 'strict', 'Set to true to fail on warnings as well as errors, false (default) only fails on errors'],
+  ];
+
+  constructor(
+    private workspace: Workspace,
+    private logger: Logger,
+    private ci: CiMain
+  ) {}
+
+  async report(args: unknown, options: Options) {
+    this.logger.console('\n\n');
+    this.logger.console('🚀 Initializing Merge command');
+    if (!this.workspace) throw new OutsideWorkspaceError();
+
+    return this.ci.mergePr({ message: options.message, build: options.build, strict: options.strict });
+  }
+}

package/commands/pr.cmd.ts

@@ -0,0 +1,70 @@
+import type { Command, CommandOptions } from '@teambit/cli';
+import type { Logger } from '@teambit/logger';
+import { OutsideWorkspaceError, type Workspace } from '@teambit/workspace';
+import type { CiMain } from '../ci.main.runtime';
+
+type Options = {
+  message?: string;
+  build?: boolean;
+  lane?: string;
+  strict?: boolean;
+};
+
+export class CiPrCmd implements Command {
+  name = 'pr';
+  description = 'This command is meant to run when a PR was open/updated and meant to export a lane to bit-cloud.';
+  group = 'collaborate';
+
+  options: CommandOptions = [
+    ['m', 'message <message>', 'If set, set it as the snap message, if not, try and grab from git-commit-message'],
+    ['l', 'lane <lane>', 'If set, use as the lane name, if not available, grab from git-branch name'],
+    ['b', 'build', 'Set to true to build the app locally, false (default) will build on Ripple CI'],
+    ['s', 'strict', 'Set to true to fail on warnings as well as errors, false (default) only fails on errors'],
+  ];
+
+  constructor(
+    private workspace: Workspace,
+    private logger: Logger,
+    private ci: CiMain
+  ) {}
+
+  async report(args: unknown, options: Options) {
+    this.logger.console('\n\n');
+    this.logger.console('🚀 Initializing PR command');
+    if (!this.workspace) throw new OutsideWorkspaceError();
+
+    let branch: string;
+    let message: string;
+
+    if (options.lane) {
+      branch = options.lane;
+    } else {
+      const currentBranch = await this.ci.getBranchName().catch((e) => {
+        throw new Error(`Failed to get branch name from Git: ${e.toString()}`);
+      });
+      if (!currentBranch) {
+        throw new Error('Failed to get branch name');
+      }
+      // Sanitize branch name to make it valid for Bit lane IDs by replacing slashes with dashes
+      const sanitizedBranch = currentBranch.replace(/\//g, '-');
+      branch = `${this.workspace.defaultScope}/${sanitizedBranch}`;
+    }
+
+    if (options.message) {
+      message = options.message;
+    } else {
+      const commitMessage = await this.ci.getGitCommitMessage();
+      if (!commitMessage) {
+        throw new Error('Failed to get commit message');
+      }
+      message = commitMessage;
+    }
+
+    return this.ci.snapPrCommit({
+      branch,
+      message,
+      build: options.build,
+      strict: options.strict,
+    });
+  }
+}

package/commands/verify.cmd.ts

@@ -0,0 +1,25 @@
+import type { Command, CommandOptions } from '@teambit/cli';
+import type { Logger } from '@teambit/logger';
+import { OutsideWorkspaceError, type Workspace } from '@teambit/workspace';
+import { CiMain } from '../ci.main.runtime';
+
+export class CiVerifyCmd implements Command {
+  name = 'verify';
+  description = 'CI commands';
+  group = 'development';
+
+  options: CommandOptions = [];
+
+  constructor(
+    private workspace: Workspace,
+    private logger: Logger,
+    private ci: CiMain
+  ) {}
+
+  async report() {
+    this.logger.console('\n\n🚀 Initializing Verify command');
+    if (!this.workspace) throw new OutsideWorkspaceError();
+
+    return this.ci.verifyWorkspaceStatus();
+  }
+}

package/dist/ci.aspect.d.ts

@@ -0,0 +1,3 @@
+import { Aspect } from '@teambit/harmony';
+export declare const CiAspect: Aspect;
+export default CiAspect;

package/dist/ci.aspect.js

@@ -0,0 +1,19 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = exports.CiAspect = void 0;
+function _harmony() {
+  const data = require("@teambit/harmony");
+  _harmony = function () {
+    return data;
+  };
+  return data;
+}
+const CiAspect = exports.CiAspect = _harmony().Aspect.create({
+  id: 'teambit.git/ci'
+});
+var _default = exports.default = CiAspect;
+
+//# sourceMappingURL=ci.aspect.js.map

package/dist/ci.aspect.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_harmony","data","require","CiAspect","exports","Aspect","create","id","_default","default"],"sources":["ci.aspect.ts"],"sourcesContent":["import { Aspect } from '@teambit/harmony';\n\nexport const CiAspect = Aspect.create({\n  id: 'teambit.git/ci',\n});\n\nexport default CiAspect;\n"],"mappings":";;;;;;AAAA,SAAAA,SAAA;EAAA,MAAAC,IAAA,GAAAC,OAAA;EAAAF,QAAA,YAAAA,CAAA;IAAA,OAAAC,IAAA;EAAA;EAAA,OAAAA,IAAA;AAAA;AAEO,MAAME,QAAQ,GAAAC,OAAA,CAAAD,QAAA,GAAGE,iBAAM,CAACC,MAAM,CAAC;EACpCC,EAAE,EAAE;AACN,CAAC,CAAC;AAAC,IAAAC,QAAA,GAAAJ,OAAA,CAAAK,OAAA,GAEYN,QAAQ","ignoreList":[]}

package/dist/ci.cmd.d.ts

@@ -0,0 +1,17 @@
+import type { Command, CommandOptions } from '@teambit/cli';
+import type { Logger } from '@teambit/logger';
+import type { Workspace } from '@teambit/workspace';
+export declare class CiCmd implements Command {
+    private workspace;
+    private logger;
+    name: string;
+    description: string;
+    group: string;
+    options: CommandOptions;
+    commands: Command[];
+    constructor(workspace: Workspace, logger: Logger);
+    report(): Promise<{
+        code: number;
+        data: string;
+    }>;
+}

package/dist/ci.cmd.js

@@ -0,0 +1,29 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.CiCmd = void 0;
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+class CiCmd {
+  constructor(workspace, logger) {
+    this.workspace = workspace;
+    this.logger = logger;
+    _defineProperty(this, "name", 'ci <sub-command>');
+    _defineProperty(this, "description", 'CI commands');
+    _defineProperty(this, "group", 'collaborate');
+    _defineProperty(this, "options", []);
+    _defineProperty(this, "commands", []);
+  }
+  async report() {
+    return {
+      code: 1,
+      data: '[ci] not implemented'
+    };
+  }
+}
+exports.CiCmd = CiCmd;
+
+//# sourceMappingURL=ci.cmd.js.map

package/dist/ci.cmd.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["CiCmd","constructor","workspace","logger","_defineProperty","report","code","data","exports"],"sources":["ci.cmd.ts"],"sourcesContent":["import type { Command, CommandOptions } from '@teambit/cli';\nimport type { Logger } from '@teambit/logger';\nimport type { Workspace } from '@teambit/workspace';\n\nexport class CiCmd implements Command {\n  name = 'ci <sub-command>';\n  description = 'CI commands';\n  group = 'collaborate';\n\n  options: CommandOptions = [];\n  commands: Command[] = [];\n\n  constructor(\n    private workspace: Workspace,\n    private logger: Logger\n  ) {}\n\n  async report() {\n    return { code: 1, data: '[ci] not implemented' };\n  }\n}\n"],"mappings":";;;;;;;;;AAIO,MAAMA,KAAK,CAAoB;EAQpCC,WAAWA,CACDC,SAAoB,EACpBC,MAAc,EACtB;IAAA,KAFQD,SAAoB,GAApBA,SAAoB;IAAA,KACpBC,MAAc,GAAdA,MAAc;IAAAC,eAAA,eATjB,kBAAkB;IAAAA,eAAA,sBACX,aAAa;IAAAA,eAAA,gBACnB,aAAa;IAAAA,eAAA,kBAEK,EAAE;IAAAA,eAAA,mBACN,EAAE;EAKrB;EAEH,MAAMC,MAAMA,CAAA,EAAG;IACb,OAAO;MAAEC,IAAI,EAAE,CAAC;MAAEC,IAAI,EAAE;IAAuB,CAAC;EAClD;AACF;AAACC,OAAA,CAAAR,KAAA,GAAAA,KAAA","ignoreList":[]}

package/dist/ci.docs.mdx

@@ -0,0 +1,117 @@
+---
+description: 'Aspect that eases the Bit workflow in CI'
+labels: ['aspect', 'ci']
+---
+
+# Bit CI
+
+Bit's **`bit ci`** commands (plus one BVM enhancement) wrap several routine Bit tasks into single-purpose scripts so your CI pipelines stay short, readable and consistent.
+
+| Command                           | Purpose                                               | Typical CI Stage       |
+| --------------------------------- | ----------------------------------------------------- | ---------------------- |
+| [`bit ci verify`](#bit-ci-verify) | Lint + build gate on every commit                     | pre-push / commit hook |
+| [`bit ci pr`](#bit-ci-pr)         | Snap + export a feature lane when a PR opens/updates  | pull-request pipeline  |
+| [`bit ci merge`](#bit-ci-merge)   | Tag + export new semantic versions on merge to `main` | merge-to-main pipeline |
+
+---
+
+## `bit ci verify`
+
+|                  |                                                   |
+| ---------------- | ------------------------------------------------- |
+| **Syntax**       | `bit ci verify`                                   |
+| **What it does** | Ensures the component passes CI on every commit   |
+| **Runs**         | `bit install && bit status --strict && bit build` |
+
+### When to run
+
+- Every commit that **is not** part of an open Pull Request (e.g. a pre-push hook).
+- As an early CI job to fail fast on dependency drift or broken builds.
+
+### Exit behaviour
+
+The command stops at the first failing step (`status`, then `build`) and returns a non-zero exit code.
+
+---
+
+## `bit ci pr`
+
+Export a lane to Bit Cloud whenever a Pull Request is opened or updated.
+
+```bash
+bit ci pr [--message <string>] [--build] [--lane <string>]
+```
+
+| Flag        | Shorthand | Description                                                                               |
+| ----------- | --------- | ----------------------------------------------------------------------------------------- |
+| `--message` | `-m`      | Changelog entry. If omitted, tries the latest Git commit message (fails if unavailable).  |
+| `--build`   | `-b`      | Build locally before export. If absent, Ripple-CI builds the components.                  |
+| `--lane`    | `-l`      | Explicit lane name. Falls back to the current Git branch name. Performs input validation. |
+
+### Internal flow (fail-fast on any step)
+
+1. **Resolve lane name**
+   - From `--lane` or current Git branch.
+   - If the lane doesn’t exist remotely, create it; otherwise, `bit lane checkout <lane>`.
+2. **Run wrapped Bit commands**
+
+   ```bash
+   bit install
+   bit status --strict
+   bit lane create <lane>      # no-op if already exists
+   bit snap --message "<msg>" --build
+   bit export
+   ```
+
+3. **Clean-up**
+
+   ```bash
+   bit lane switch main   # leaves .bitmap unchanged in the working tree
+   ```
+
+### Typical CI placement
+
+Run on the _pull-request_ event after tests but before any deploy step.
+
+---
+
+## `bit ci merge`
+
+Publishes new semantic versions after a PR merges to `main`.
+
+```bash
+bit ci merge [--message <string>] [--build]
+```
+
+| Flag        | Shorthand | Description                                                                                           |
+| ----------- | --------- | ----------------------------------------------------------------------------------------------------- |
+| `--message` | `-m`      | Changelog entry (defaults to last Git commit message).                                                |
+| `--build`   | `-b`      | Build locally (otherwise Ripple-CI does it). Required if workspace contains _soft-tagged_ components. |
+
+### Internal flow
+
+1. **Ensure main lane**
+
+   ```bash
+   bit lane switch main   # preserves working tree files
+   ```
+
+2. **Tag, build, export**
+
+   ```bash
+   bit install
+   bit tag --message "<msg>" --build --persist   # --persist only if soft tags exist
+   bit export
+   ```
+
+3. **Archive remote lane** (house-keeping).
+4. **Commit lock-file updates**
+
+   ```bash
+   git add .bitmap pnpm-lock.yaml
+   git commit -m "chore(release): sync bitmap + lockfile"
+   ```
+
+### CI hint
+
+Gate this step behind a branch-protection rule so only fast-forward merges trigger a release.

package/dist/ci.main.runtime.d.ts

@@ -0,0 +1,64 @@
+import type { RuntimeDefinition } from '@teambit/harmony';
+import { type CLIMain } from '@teambit/cli';
+import { type LoggerMain, type Logger } from '@teambit/logger';
+import { type Workspace } from '@teambit/workspace';
+import { type BuilderMain } from '@teambit/builder';
+import { type StatusMain } from '@teambit/status';
+import { type LanesMain } from '@teambit/lanes';
+import { type SnappingMain } from '@teambit/snapping';
+import { type ExportMain } from '@teambit/export';
+import { type ImporterMain } from '@teambit/importer';
+import { type CheckoutMain } from '@teambit/checkout';
+export declare class CiMain {
+    private workspace;
+    private builder;
+    private status;
+    private lanes;
+    private snapping;
+    private exporter;
+    private importer;
+    private checkout;
+    private logger;
+    static runtime: RuntimeDefinition;
+    static dependencies: any;
+    static slots: any;
+    constructor(workspace: Workspace, builder: BuilderMain, status: StatusMain, lanes: LanesMain, snapping: SnappingMain, exporter: ExportMain, importer: ImporterMain, checkout: CheckoutMain, logger: Logger);
+    static provider([cli, workspace, loggerAspect, builder, status, lanes, snapping, exporter, importer, checkout,]: [
+        CLIMain,
+        Workspace,
+        LoggerMain,
+        BuilderMain,
+        StatusMain,
+        LanesMain,
+        SnappingMain,
+        ExportMain,
+        ImporterMain,
+        CheckoutMain
+    ]): Promise<CiMain>;
+    getBranchName(): Promise<string>;
+    getDefaultBranchName(): Promise<string>;
+    getGitCommitMessage(): Promise<string | null>;
+    private verifyWorkspaceStatusInternal;
+    private switchToLane;
+    verifyWorkspaceStatus(): Promise<{
+        code: number;
+        data: string;
+    }>;
+    snapPrCommit({ branch, message, build, strict, }: {
+        branch: string;
+        message: string;
+        build: boolean | undefined;
+        strict: boolean | undefined;
+    }): Promise<string | {
+        code: number;
+        data: string;
+    }>;
+    mergePr({ message: argMessage, build, strict }: {
+        message?: string;
+        build?: boolean;
+        strict?: boolean;
+    }): Promise<{
+        code: number;
+        data: string;
+    }>;
+}