@getcolter/cli 0.1.0

package/LICENSE

@@ -0,0 +1,38 @@
+Colter Proprietary License
+
+Copyright (c) 2025-2026 Amberhill (https://amberhill.xyz). All rights reserved.
+
+TERMS OF USE
+
+1. FREE USE. You may download, install, and use the Colter CLI ("Software")
+   free of charge for any lawful purpose, including commercial use.
+
+2. NO REDISTRIBUTION. You may not redistribute, sublicense, sell, or
+   otherwise transfer the Software or any portion of it to third parties,
+   except as installed via the official npm package or downloaded from
+   official distribution channels.
+
+3. NO MODIFICATION. You may not modify, reverse-engineer, decompile, or
+   create derivative works based on the Software.
+
+4. NO SOURCE CODE. The source code of the Software is proprietary and is
+   not provided under this license.
+
+5. TRADEMARKS. "Colter" and associated logos are trademarks of Amberhill.
+   You may not use these marks without prior written permission except to
+   refer to the Software.
+
+6. NO WARRANTY. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY
+   KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+   MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT.
+
+7. LIMITATION OF LIABILITY. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+   HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN
+   AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF, OR IN
+   CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+8. TERMINATION. This license is effective until terminated. It will terminate
+   automatically if you fail to comply with any term. Upon termination, you
+   must destroy all copies of the Software.
+
+For licensing inquiries: hello@amberhill.xyz

package/README.md

@@ -0,0 +1,71 @@
+# @getcolter/cli
+
+**Check if any online store works with AI shopping agents.**
+
+Colter tests both major agent commerce protocols in one command:
+
+- **UCP** (Universal Commerce Protocol) — product discovery, browsing, and purchase. Used by Gemini, AI Mode, Copilot, and others.
+- **ACP** (Agent Commerce Protocol) — checkout and payment. Used by ChatGPT, Operator, and others.
+
+Produces Evidence Packs: portable, redacted, replayable records of every verification.
+
+## Install
+
+```bash
+npm install -g @getcolter/cli
+```
+
+Or run directly:
+
+```bash
+npx @getcolter/cli check https://your-store.com
+```
+
+## Quick start
+
+```bash
+# Fast readiness scan
+colter check https://your-store.com
+
+# Full conformance test with Evidence Pack
+colter verify https://your-store.com
+
+# Batch check multiple stores
+colter check --batch stores.yaml
+```
+
+## What it checks
+
+| Protocol | What it does | Agents using it |
+|----------|-------------|-----------------|
+| **UCP** | Full-lifecycle commerce (discover, browse, cart, checkout) | Gemini, AI Mode, Copilot, Shopping Graph |
+| **ACP** | Agent checkout and payment | ChatGPT, Operator |
+
+## MCP server
+
+Colter includes an MCP server for AI agent integration:
+
+```json
+{
+  "mcpServers": {
+    "colter": {
+      "command": "colter",
+      "args": ["mcp", "--admin-tools"]
+    }
+  }
+}
+```
+
+## Platforms
+
+Pre-built binaries for macOS (ARM64, x64), Linux (x64, ARM64), and Windows (x64).
+
+## Links
+
+- [Documentation](https://agenticcom.ai/docs)
+- [GitHub](https://github.com/mfbahc/colter)
+- [Report an issue](https://github.com/mfbahc/colter/issues)
+
+## License
+
+Colter is free to use. See [LICENSE](./LICENSE) for terms.

package/cli/colter.js

@@ -0,0 +1,65 @@
+#!/usr/bin/env node
+
+"use strict";
+
+const { execFileSync } = require("child_process");
+const path = require("path");
+const os = require("os");
+const fs = require("fs");
+
+const PLATFORM_PACKAGES = {
+  "darwin-arm64": "@getcolter/cli-darwin-arm64",
+  "darwin-x64": "@getcolter/cli-darwin-x64",
+  "linux-x64": "@getcolter/cli-linux-x64",
+  "linux-arm64": "@getcolter/cli-linux-arm64",
+  "win32-x64": "@getcolter/cli-win32-x64",
+};
+
+function findBinary() {
+  const platform = os.platform();
+  const arch = os.arch();
+  const key = `${platform}-${arch}`;
+  const pkg = PLATFORM_PACKAGES[key];
+  const binaryName = platform === "win32" ? "colter.exe" : "colter";
+
+  // 1. Try platform-specific optional dependency
+  if (pkg) {
+    try {
+      const pkgDir = path.dirname(require.resolve(`${pkg}/package.json`));
+      const binPath = path.join(pkgDir, "bin", binaryName);
+      if (fs.existsSync(binPath)) return binPath;
+    } catch {}
+  }
+
+  // 2. Try system PATH
+  try {
+    const which = platform === "win32" ? "where" : "which";
+    const result = require("child_process")
+      .execSync(`${which} colter`, { encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] })
+      .trim();
+    if (result && fs.existsSync(result)) return result;
+  } catch {}
+
+  return null;
+}
+
+const binary = findBinary();
+
+if (!binary) {
+  const platform = os.platform();
+  const arch = os.arch();
+  console.error(
+    `Colter: no prebuilt binary for ${platform}-${arch}.\n\n` +
+    `Supported: darwin-arm64, darwin-x64, linux-x64, linux-arm64, win32-x64\n\n` +
+    `Install from source:\n` +
+    `  go install github.com/mfbahc/agentic-com/cmd/colter@latest\n\n` +
+    `Or download from: https://github.com/mfbahc/colter/releases`
+  );
+  process.exit(1);
+}
+
+try {
+  execFileSync(binary, process.argv.slice(2), { stdio: "inherit" });
+} catch (err) {
+  process.exit(err.status || 1);
+}

package/cli/postinstall.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+
+"use strict";
+
+// Verify the platform binary was installed correctly.
+// Exits cleanly (0) even on failure so npm install doesn't break.
+
+const os = require("os");
+const path = require("path");
+const fs = require("fs");
+
+const PLATFORM_PACKAGES = {
+  "darwin-arm64": "@getcolter/cli-darwin-arm64",
+  "darwin-x64": "@getcolter/cli-darwin-x64",
+  "linux-x64": "@getcolter/cli-linux-x64",
+  "linux-arm64": "@getcolter/cli-linux-arm64",
+  "win32-x64": "@getcolter/cli-win32-x64",
+};
+
+const platform = os.platform();
+const arch = os.arch();
+const key = `${platform}-${arch}`;
+const pkg = PLATFORM_PACKAGES[key];
+
+if (!pkg) {
+  console.warn(
+    `[colter] No prebuilt binary for ${platform}-${arch}. ` +
+    `Install via Go: go install github.com/mfbahc/agentic-com/cmd/colter@latest`
+  );
+  process.exit(0);
+}
+
+try {
+  const pkgDir = path.dirname(require.resolve(`${pkg}/package.json`));
+  const binaryName = platform === "win32" ? "colter.exe" : "colter";
+  const binPath = path.join(pkgDir, "bin", binaryName);
+
+  if (!fs.existsSync(binPath)) {
+    console.warn(`[colter] Binary not found at ${binPath}. Try reinstalling: npm install -g @getcolter/cli`);
+    process.exit(0);
+  }
+
+  // Ensure executable permissions on Unix
+  if (platform !== "win32") {
+    fs.chmodSync(binPath, 0o755);
+  }
+} catch {
+  console.warn(`[colter] Could not verify binary. The CLI may still work if colter is on your PATH.`);
+  process.exit(0);
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@getcolter/cli",
+  "version": "0.1.0",
+  "description": "Check if any online store works with AI shopping agents. Tests UCP (Universal Commerce) and ACP (Agent Commerce) protocols in one command.",
+  "keywords": [
+    "colter",
+    "agentic-commerce",
+    "ucp",
+    "acp",
+    "commerce-verification",
+    "agent-ready",
+    "evidence-packs",
+    "mcp-server",
+    "ai-shopping"
+  ],
+  "homepage": "https://agenticcom.ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mfbahc/colter.git"
+  },
+  "bugs": {
+    "url": "https://github.com/mfbahc/colter/issues"
+  },
+  "license": "SEE LICENSE IN LICENSE",
+  "author": {
+    "name": "Amberhill",
+    "url": "https://amberhill.xyz"
+  },
+  "bin": {
+    "colter": "./cli/colter.js"
+  },
+  "files": [
+    "cli/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "postinstall": "node cli/postinstall.js"
+  },
+  "optionalDependencies": {
+    "@getcolter/cli-darwin-arm64": "0.1.0",
+    "@getcolter/cli-darwin-x64": "0.1.0",
+    "@getcolter/cli-linux-x64": "0.1.0",
+    "@getcolter/cli-linux-arm64": "0.1.0",
+    "@getcolter/cli-win32-x64": "0.1.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}