allorc-app-cli 0.1.0

package/README.md

@@ -0,0 +1,96 @@
+# allorc-app-cli
+
+Go-based CLI that combines the current MCP and trigger publishing workflows into one package.
+
+## Status
+
+- Primary distribution target: npm
+- Python packaging: scaffold only for later work
+- Existing `klasto` and `klasto-trigger-cli` packages are left untouched in this repo
+
+## Commands
+
+```powershell
+allorc init
+allorc validate
+allorc --profile dev publish --dry-run
+allorc --profile dev publish
+allorc --profile prod publish --only mcp
+allorc --profile prod publish --only trigger
+```
+
+## Local dev endpoints
+
+The merged package now follows the same local values already used in the older packages:
+
+- MCP local host: `http://localhost:9000`
+- Trigger local API base URL: `http://127.0.0.1:8090/api/v1`
+- Trigger local host header: `clastines-server.localhost`
+
+Those values are prefilled in the generated `.env.dev`.
+
+## Combined manifest
+
+Create `allorc-app.json`:
+
+```json
+{
+  "name": "my-allorc-app",
+  "version": "0.1.0",
+  "env": {
+    "dev": ".env.dev",
+    "prod": ".env.prod"
+  },
+  "mcp": {
+    "enabled": true,
+    "manifest": "clastines-toolkit.json"
+  },
+  "trigger": {
+    "enabled": true,
+    "manifest": "clastines-trigger.json"
+  }
+}
+```
+
+`publish` reads this manifest, loads the selected env file, validates the referenced manifests, then publishes both enabled components unless `--only` narrows the scope.
+
+## Scaffold output
+
+`allorc init` creates:
+
+- `allorc-app.json`
+- `clastines-toolkit.json`
+- `clastines-trigger.json`
+- `.env.dev`
+- `.env.prod`
+- `package.json`
+- `tsconfig.json`
+- `src/server.ts`
+- `.allorc/identity.json`
+
+## Build the Go CLI
+
+From this directory:
+
+```powershell
+go build -o .\allorc.exe .\cmd\allorc-app-cli
+```
+
+## npm packaging
+
+The npm wrapper lives in `packages/npm`, but the repo root now contains the publishable `package.json` so you can publish directly from `allorc-app-cli`.
+
+Typical flow:
+
+```powershell
+go build -o .\allorc.exe .\cmd\allorc-app-cli
+npm run stage-binary -- --source .\allorc.exe --target win32-x64
+npm run check-binaries
+npm publish
+```
+
+For a real public release, stage all supported platform binaries before publishing.
+
+## Python packaging
+
+The Python scaffold lives in `packages/pip`. It is intentionally not wired for binary shipping yet; the folder exists to keep the future wheel and sdist work scoped and documented.

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "allorc-app-cli",
+  "version": "0.1.0",
+  "description": "npm wrapper for the Allorc App Go CLI",
+  "private": false,
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "bin": {
+    "allorc": "packages/npm/bin/allorc.js",
+    "allorc-app-cli": "packages/npm/bin/allorc.js"
+  },
+  "files": [
+    "README.md",
+    "packages/npm/bin",
+    "packages/npm/dist"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "stage-binary": "node .\\packages\\npm\\scripts\\stage-binary.js",
+    "check-binaries": "node .\\packages\\npm\\scripts\\check-binaries.js",
+    "prepack": "npm run check-binaries"
+  },
+  "keywords": [
+    "allorc",
+    "clastines",
+    "mcp",
+    "trigger",
+    "cli",
+    "go"
+  ]
+}

package/packages/npm/README.md

@@ -0,0 +1,61 @@
+# allorc-app-cli
+
+npm wrapper for the Go-based `allorc` CLI.
+
+## Recommended command name
+
+The package exposes both of these commands:
+
+```powershell
+allorc --help
+allorc-app-cli --help
+```
+
+`allorc` is the better npm-facing command because it is shorter and easier to script.
+
+## Local dev defaults
+
+For the generated project scaffold, the npm-distributed CLI expects:
+
+- MCP local host at `http://localhost:9000`
+- Trigger local base URL at `http://127.0.0.1:8090/api/v1`
+- Trigger host override `clastines-server.localhost`
+
+## Packaging flow
+
+Build the Go binaries from the package root:
+
+```powershell
+go build -o .\allorc.exe .\cmd\allorc-app-cli
+```
+
+Cross-compile examples:
+
+```powershell
+$env:GOOS='linux'
+$env:GOARCH='amd64'
+go build -o .\allorc-linux .\cmd\allorc-app-cli
+Remove-Item Env:GOOS
+Remove-Item Env:GOARCH
+
+$env:GOOS='darwin'
+$env:GOARCH='arm64'
+go build -o .\allorc-darwin .\cmd\allorc-app-cli
+Remove-Item Env:GOOS
+Remove-Item Env:GOARCH
+```
+
+Stage them into the npm package:
+
+```powershell
+npm run stage-binary -- --source ..\..\allorc.exe --target win32-x64
+npm run stage-binary -- --source ..\..\allorc-linux --target linux-x64
+npm run stage-binary -- --source ..\..\allorc-darwin --target darwin-arm64
+```
+
+Verify contents:
+
+```powershell
+npm run check-binaries
+npm pack --dry-run
+```

package/packages/npm/bin/allorc.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("node:child_process");
+const { existsSync } = require("node:fs");
+const { join } = require("node:path");
+
+const platform = process.platform;
+const arch = process.arch;
+const rootDir = join(__dirname, "..");
+
+function resolveBinaryPath() {
+  const envOverride = process.env.ALLORC_APP_CLI_BINARY;
+  if (envOverride) {
+    return envOverride;
+  }
+
+  const extension = platform === "win32" ? ".exe" : "";
+  return join(rootDir, "dist", `${platform}-${arch}`, `allorc${extension}`);
+}
+
+const binaryPath = resolveBinaryPath();
+
+if (!existsSync(binaryPath)) {
+  const targetDir = join(rootDir, "dist", `${platform}-${arch}`);
+  console.error("Missing packaged binary for this platform.");
+  console.error(`Expected: ${binaryPath}`);
+  console.error("");
+  console.error("Build and stage the Go binary before publishing:");
+  console.error(`  go build -o allorc${platform === "win32" ? ".exe" : ""} .\\cmd\\allorc-app-cli`);
+  console.error(`  npm run stage-binary -- --source <path-to-built-binary> --target ${platform}-${arch}`);
+  console.error("");
+  console.error("Or run with an explicit binary path using ALLORC_APP_CLI_BINARY.");
+  console.error(`Target directory: ${targetDir}`);
+  process.exit(1);
+}
+
+const result = spawnSync(binaryPath, process.argv.slice(2), { stdio: "inherit" });
+
+if (result.error) {
+  console.error(result.error.message);
+  process.exit(1);
+}
+
+if (typeof result.status === "number") {
+  process.exit(result.status);
+}
+
+process.exit(1);