@composal/cli 0.0.0-stage → 1.17.63

package/README.md

@@ -1,3 +1,105 @@
-# Temporary Holding Version
+<div align="center">
+  <a href="https://composal.ai">
+    <img src="https://raw.githubusercontent.com/ComposalAI/cli/main/assets/composal-silver-sticker.svg" width="320" alt="Composal silver foil sticker">
+  </a>
+  <h1>Composal CLI</h1>
+  <p><strong>Verify changes. Ship apps. Equip your agents.</strong></p>
+  <p>
+    <a href="https://www.npmjs.com/package/@composal/cli">npm</a> ·
+    <a href="https://github.com/ComposalAI/cli">GitHub</a> ·
+    <a href="https://composal.ai/docs">Documentation</a> ·
+    <a href="https://composal.ai">Composal</a>
+  </p>
+</div>
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+---
+
+`com` brings Composal to your terminal and coding agents. Verify real user journeys,
+deploy applications, manage secrets, and connect your agent to the same tools you
+use to ship.
+
+## Install
+
+With **Node.js 18 or newer**:
+
+```sh
+npm install -g @composal/cli
+```
+
+Prefer the standalone installer? No Node.js required:
+
+```sh
+curl -fsSL https://dl.composal.ai/install.sh | sh
+```
+
+Both options install the `com` command. Supported platforms are **macOS Apple
+Silicon** and **Linux x64 with glibc**. On Windows, use an x64 WSL distribution.
+
+You can also run without a global installation:
+
+```sh
+npx @composal/cli --help
+```
+
+For a project, install with `npm install --save-dev @composal/cli` and run `npx com`.
+Pin a version with `npm install -g @composal/cli@<version>`.
+
+## Get started
+
+```sh
+com login
+com whoami
+com --help
+```
+
+Follow the [quickstart](https://composal.ai/docs/quickstart) to connect your account
+and run your first commands.
+
+## What you can do
+
+| | From your terminal |
+| --- | --- |
+| **[Verify](https://composal.ai/docs/verify)** | Test real browser journeys and inspect screenshots, recordings, and traces. |
+| **[Ship applications](https://composal.ai/docs/hosting)** | Deploy apps, manage services and preview environments, and inspect logs. |
+| **[Manage secrets](https://composal.ai/docs/cli)** | Store and retrieve secrets, or run commands with secrets injected into their environment. |
+| **[Equip your agents](https://composal.ai/docs/agents)** | Set up Composal skills and MCP tools for your coding agent. |
+
+Explore commands with `com verify --help`, `com deploy --help`, and
+`com secrets --help`. The [CLI reference](https://composal.ai/docs/cli) covers the
+full command set.
+
+### Connect your coding agent
+
+For Codex, install the skills and configure MCP together:
+
+```sh
+com setup --targets codex --mcp
+```
+
+Run `com setup --help` for other supported agents and setup options.
+
+## Stay up to date
+
+For a global npm installation:
+
+```sh
+npm install -g @composal/cli@latest
+```
+
+For a project installation, run `npm install --save-dev @composal/cli@latest`.
+
+For the standalone installer:
+
+```sh
+com update
+```
+
+## Explore Composal
+
+- [Quickstart](https://composal.ai/docs/quickstart) — install, sign in, and get started.
+- [CLI reference](https://composal.ai/docs/cli) — commands and examples.
+- [Verify](https://composal.ai/docs/verify) — browser testing for your application.
+- [Hosting](https://composal.ai/docs/hosting) — deploy and operate your apps.
+- [Agent setup](https://composal.ai/docs/agents) — bring Composal to your coding workflow.
+
+Found an issue or have an idea? [Let us know](https://github.com/ComposalAI/cli/issues).

package/bin/com.cjs

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+'use strict';
+
+const { spawn } = require('node:child_process');
+const path = require('node:path');
+
+function binaryForPlatform(platform = process.platform, arch = process.arch) {
+  const target = `${platform}-${arch}`;
+  if (!['linux-x64', 'darwin-arm64'].includes(target)) {
+    throw new Error(
+      `Composal does not support ${target}. Use Linux x64 (including Windows WSL) or macOS Apple Silicon.`,
+    );
+  }
+  return path.join(__dirname, target, 'com');
+}
+
+function main(args = process.argv.slice(2)) {
+  if (args[0] === 'update' && !args.includes('--help') && !args.includes('-h')) {
+    console.error(
+      'This installation is managed by npm. Update with:\n' +
+        '  npm install -g @composal/cli@latest   # global install\n' +
+        '  npm install @composal/cli@latest      # project install\n' +
+        'Or run the latest version with npx @composal/cli@latest.',
+    );
+    process.exitCode = 1;
+    return;
+  }
+
+  let binary;
+  try {
+    binary = binaryForPlatform();
+  } catch (error) {
+    console.error(error.message);
+    process.exitCode = 1;
+    return;
+  }
+
+  const child = spawn(binary, args, { stdio: 'inherit' });
+  const handlers = new Map();
+  for (const signal of ['SIGINT', 'SIGTERM', 'SIGHUP']) {
+    const handler = () => child.kill(signal);
+    handlers.set(signal, handler);
+    process.on(signal, handler);
+  }
+  const cleanup = () => {
+    for (const [signal, handler] of handlers) process.removeListener(signal, handler);
+  };
+  child.on('error', (error) => {
+    cleanup();
+    console.error(`Could not start Composal: ${error.message}. Reinstall @composal/cli.`);
+    process.exitCode = 1;
+  });
+  child.on('exit', (code, signal) => {
+    cleanup();
+    if (signal) process.kill(process.pid, signal);
+    else process.exitCode = code;
+  });
+}
+
+module.exports = { binaryForPlatform, main };
+if (require.main === module) main();

package/package.json

@@ -1,6 +1,55 @@
 {
   "name": "@composal/cli",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.17.63",
+  "description": "Composal CLI for Verify, hosted apps, deployments, secrets, and agent setup",
+  "keywords": [
+    "composal",
+    "cli",
+    "developer-tools",
+    "ai-agents",
+    "browser-testing",
+    "e2e-testing",
+    "test-automation",
+    "verification",
+    "deployments",
+    "hosting",
+    "secrets",
+    "mcp"
+  ],
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/ComposalAI/cli#readme",
+  "bugs": {
+    "url": "https://github.com/ComposalAI/cli/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ComposalAI/vex.git",
+    "directory": "npm/com-cli"
+  },
+  "bin": {
+    "com": "bin/com.cjs"
+  },
+  "files": [
+    "bin",
+    "release.json",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux"
+  ],
+  "cpu": [
+    "arm64",
+    "x64"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "composal": {
+    "commit_sha": "8842a3a290868d88e96da16fbc6c57447e97c60f"
+  }
+}

package/release.json

@@ -0,0 +1,29 @@
+{
+  "product": "com",
+  "version": "1.17.63",
+  "commit_sha": "8842a3a290868d88e96da16fbc6c57447e97c60f",
+  "platforms": {
+    "linux-amd64": {
+      "name": "com",
+      "version": "1.17.63",
+      "channel": "release",
+      "commit_sha": "8842a3a290868d88e96da16fbc6c57447e97c60f",
+      "short_sha": "8842a3a29086",
+      "platform": "linux-amd64",
+      "binary": "com",
+      "sha256": "bc8783d2a72308f7a31a9fb766c716370fc6261e732c7deedacc024beb6294e1",
+      "companions": []
+    },
+    "darwin-arm64": {
+      "name": "com",
+      "binary": "com",
+      "version": "1.17.63",
+      "channel": "release",
+      "commit_sha": "8842a3a290868d88e96da16fbc6c57447e97c60f",
+      "short_sha": "8842a3a29086",
+      "platform": "darwin-arm64",
+      "sha256": "06ce2f38b4c9231e21ecd4834eca832a430fccf88c04613d9668d610cd2fe4d6",
+      "companions": []
+    }
+  }
+}