@fixprompt/cli 0.0.1

package/README.md

@@ -0,0 +1,86 @@
+# @fixprompt/cli
+
+FixPrompt command-line tool. One subcommand for now: `deploy-start`, which posts a deploy marker to the broker so the dashboard knows what changed.
+
+## Install
+
+```bash
+npm install -g @fixprompt/cli
+```
+
+Or just one-shot it with no install:
+
+```bash
+npx @fixprompt/cli deploy-start --status success
+```
+
+## `fixprompt deploy-start`
+
+Tells the broker that a deploy just happened. Reads your `commit_sha` / `branch` / `repo` / `commit_message` automatically when run inside a git working tree or under one of these CI providers:
+
+- GitHub Actions (`GITHUB_SHA`, `GITHUB_REF_NAME`, `GITHUB_REPOSITORY`)
+- Vercel (`VERCEL_GIT_COMMIT_SHA`, `VERCEL_GIT_COMMIT_REF`, `VERCEL_GIT_REPO_*`)
+- Railway (`RAILWAY_GIT_COMMIT_SHA`, `RAILWAY_GIT_BRANCH`, …)
+
+### Auth
+
+Pass via env vars (preferred for CI):
+
+```bash
+export LOGHUB_SOURCE=my-app-prod    # from project creation
+export LOGHUB_KEY=k_...              # from project creation / Rotate Key
+```
+
+Or via flags:
+
+```bash
+fixprompt deploy-start \
+  --source my-app-prod \
+  --key k_... \
+  --status success
+```
+
+### Flags
+
+| flag | default | purpose |
+|------|---------|---------|
+| `--source <slug-prod>` | `$LOGHUB_SOURCE` / `$FIXPROMPT_SOURCE` | project source label |
+| `--key <k_...>` | `$LOGHUB_KEY` / `$FIXPROMPT_KEY` | ingest key |
+| `--endpoint <url>` | `$FIXPROMPT_ENDPOINT` or `https://geosloghub-production.up.railway.app` | broker URL |
+| `--status <state>` | `in_progress` | `in_progress` \| `success` \| `failed` |
+| `--commit-sha <sha>` | auto | override auto-detected commit |
+| `--branch <name>` | auto | override auto-detected branch |
+| `--message <text>` | auto | override auto-detected commit subject |
+
+### EAS / Expo
+
+In `eas-build-post-install` or a custom workflow step:
+
+```bash
+npx --yes @fixprompt/cli deploy-start --status success
+```
+
+EAS env vars (`EAS_BUILD_GIT_COMMIT_HASH`, `EAS_BUILD_GIT_BRANCH_NAME`) aren't recognised yet — pass them explicitly until V2:
+
+```bash
+npx --yes @fixprompt/cli deploy-start \
+  --status success \
+  --commit-sha "$EAS_BUILD_GIT_COMMIT_HASH" \
+  --branch "$EAS_BUILD_GIT_BRANCH_NAME"
+```
+
+### GitHub Actions
+
+Use the prebuilt composite action instead — same effect, less typing:
+
+```yaml
+- uses: geos/fixprompt-deploy@v1
+  with:
+    source: ${{ secrets.FIXPROMPT_SOURCE }}
+    key: ${{ secrets.FIXPROMPT_KEY }}
+    status: success
+```
+
+## License
+
+UNLICENSED (closed beta).

package/dist/cli.js

@@ -0,0 +1,238 @@
+#!/usr/bin/env node
+
+// src/detect.ts
+import { execSync } from "child_process";
+function git(args) {
+  try {
+    return execSync(`git ${args}`, {
+      stdio: ["ignore", "pipe", "ignore"]
+    }).toString().trim();
+  } catch {
+    return null;
+  }
+}
+function gitRemoteToRepoUrl(remoteUrl) {
+  if (!remoteUrl) return { repo: null, webBase: null };
+  const sshMatch = remoteUrl.match(/git@([^:]+):(.+?)(\.git)?$/);
+  if (sshMatch) {
+    const [, host, slug] = sshMatch;
+    return { repo: slug, webBase: `https://${host}/${slug}` };
+  }
+  const httpsMatch = remoteUrl.match(/^https?:\/\/([^/]+)\/(.+?)(\.git)?$/);
+  if (httpsMatch) {
+    const [, host, slug] = httpsMatch;
+    return { repo: slug, webBase: `https://${host}/${slug}` };
+  }
+  return { repo: null, webBase: null };
+}
+function detectFromCi() {
+  const env = process.env;
+  if (env.GITHUB_ACTIONS === "true") {
+    return {
+      provider: "github-actions",
+      commit_sha: env.GITHUB_SHA ?? "",
+      branch: env.GITHUB_REF_NAME ?? null,
+      repo: env.GITHUB_REPOSITORY ?? null,
+      commit_url: env.GITHUB_SERVER_URL && env.GITHUB_REPOSITORY && env.GITHUB_SHA ? `${env.GITHUB_SERVER_URL}/${env.GITHUB_REPOSITORY}/commit/${env.GITHUB_SHA}` : null
+    };
+  }
+  if (env.VERCEL === "1" || env.VERCEL === "true") {
+    return {
+      provider: "vercel",
+      commit_sha: env.VERCEL_GIT_COMMIT_SHA ?? "",
+      branch: env.VERCEL_GIT_COMMIT_REF ?? null,
+      repo: env.VERCEL_GIT_REPO_OWNER && env.VERCEL_GIT_REPO_SLUG ? `${env.VERCEL_GIT_REPO_OWNER}/${env.VERCEL_GIT_REPO_SLUG}` : null,
+      commit_message: env.VERCEL_GIT_COMMIT_MESSAGE ?? null
+    };
+  }
+  if (env.RAILWAY_ENVIRONMENT) {
+    return {
+      provider: "railway",
+      commit_sha: env.RAILWAY_GIT_COMMIT_SHA ?? "",
+      branch: env.RAILWAY_GIT_BRANCH ?? null,
+      repo: env.RAILWAY_GIT_REPO_OWNER && env.RAILWAY_GIT_REPO_NAME ? `${env.RAILWAY_GIT_REPO_OWNER}/${env.RAILWAY_GIT_REPO_NAME}` : null,
+      commit_message: env.RAILWAY_GIT_COMMIT_MESSAGE ?? null
+    };
+  }
+  return {};
+}
+function detectFromGit() {
+  const sha = git("rev-parse HEAD");
+  const branch = git("rev-parse --abbrev-ref HEAD");
+  const remote = git("config --get remote.origin.url");
+  const message = git("log -1 --pretty=format:%s");
+  const { repo, webBase } = gitRemoteToRepoUrl(remote);
+  return {
+    provider: "manual",
+    commit_sha: sha ?? "",
+    branch: branch ?? null,
+    repo: repo ?? null,
+    commit_message: message ?? null,
+    commit_url: webBase && sha ? `${webBase}/commit/${sha}` : null
+  };
+}
+function detectContext() {
+  const ci = detectFromCi();
+  const ciHasSha = typeof ci.commit_sha === "string" && ci.commit_sha.length > 0;
+  const git2 = detectFromGit();
+  const merged = {
+    provider: ci.provider ?? git2.provider ?? "manual",
+    commit_sha: (ciHasSha ? ci.commit_sha : git2.commit_sha) ?? "",
+    branch: ci.branch ?? git2.branch ?? null,
+    repo: ci.repo ?? git2.repo ?? null,
+    commit_message: ci.commit_message ?? git2.commit_message ?? null,
+    commit_url: ci.commit_url ?? git2.commit_url ?? null
+  };
+  return merged;
+}
+
+// src/version.ts
+var CLI_NAME = "@fixprompt/cli";
+var CLI_VERSION = "0.0.1";
+
+// src/cli.ts
+var DEFAULT_ENDPOINT = "https://geosloghub-production.up.railway.app";
+function parseArgs(argv) {
+  const flags = {};
+  const positional = [];
+  let i = 0;
+  const command = argv[0] ?? "help";
+  for (i = 1; i < argv.length; i++) {
+    const tok = argv[i];
+    if (tok.startsWith("--")) {
+      const eq = tok.indexOf("=");
+      if (eq !== -1) {
+        flags[tok.slice(2, eq)] = tok.slice(eq + 1);
+      } else {
+        const next = argv[i + 1];
+        if (next && !next.startsWith("--")) {
+          flags[tok.slice(2)] = next;
+          i++;
+        } else {
+          flags[tok.slice(2)] = true;
+        }
+      }
+    } else {
+      positional.push(tok);
+    }
+  }
+  return { command, flags, positional };
+}
+function helpText() {
+  return `${CLI_NAME} v${CLI_VERSION}
+
+Usage:
+  fixprompt deploy-start [options]
+  fixprompt help
+
+deploy-start options:
+  --source <slug>     LOGHUB_SOURCE (default: $LOGHUB_SOURCE or $FIXPROMPT_SOURCE env)
+  --key <k_...>       LOGHUB_KEY    (default: $LOGHUB_KEY or $FIXPROMPT_KEY env)
+  --endpoint <url>    Broker URL    (default: $FIXPROMPT_ENDPOINT or ${DEFAULT_ENDPOINT})
+  --status <state>    in_progress | success | failed (default: in_progress)
+  --commit-sha <sha>  Override auto-detected commit
+  --branch <name>     Override auto-detected branch
+  --message <text>    Override auto-detected commit subject
+
+Auto-detected CI providers: GitHub Actions, Vercel, Railway.
+`;
+}
+function readSource(flags) {
+  const v = flags.source ?? process.env.LOGHUB_SOURCE ?? process.env.FIXPROMPT_SOURCE;
+  if (!v) {
+    console.error("Missing --source (or $LOGHUB_SOURCE / $FIXPROMPT_SOURCE)");
+    process.exit(1);
+  }
+  return v;
+}
+function readKey(flags) {
+  const v = flags.key ?? process.env.LOGHUB_KEY ?? process.env.FIXPROMPT_KEY;
+  if (!v) {
+    console.error("Missing --key (or $LOGHUB_KEY / $FIXPROMPT_KEY)");
+    process.exit(1);
+  }
+  return v;
+}
+function readEndpoint(flags) {
+  const v = flags.endpoint ?? process.env.FIXPROMPT_ENDPOINT ?? DEFAULT_ENDPOINT;
+  return v.replace(/\/$/, "");
+}
+async function deployStart(args) {
+  const source = readSource(args.flags);
+  const key = readKey(args.flags);
+  const endpoint = readEndpoint(args.flags);
+  const status = args.flags.status ?? "in_progress";
+  const ctx = detectContext();
+  const commit_sha = args.flags["commit-sha"] ?? ctx.commit_sha;
+  if (!commit_sha) {
+    console.error(
+      "Could not detect a commit_sha. Run inside a git working tree or pass --commit-sha."
+    );
+    process.exit(1);
+  }
+  const payload = {
+    commit_sha,
+    branch: args.flags.branch ?? ctx.branch,
+    repo: ctx.repo,
+    provider: ctx.provider,
+    commit_message: args.flags.message ?? ctx.commit_message,
+    commit_url: ctx.commit_url,
+    fixprompt_version: CLI_VERSION,
+    status
+  };
+  const url = `${endpoint}/deployments`;
+  const res = await fetch(url, {
+    method: "POST",
+    headers: {
+      "Content-Type": "application/json",
+      "x-loghub-source": source,
+      "x-loghub-key": key
+    },
+    body: JSON.stringify(payload)
+  });
+  const text = await res.text();
+  if (!res.ok) {
+    console.error(`\u2717 ${res.status} ${res.statusText}: ${text}`);
+    process.exit(1);
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(text);
+  } catch {
+    parsed = { raw: text };
+  }
+  console.log(
+    `\u2713 Deploy marker sent \u2014 ${commit_sha.slice(0, 7)} on ${payload.branch ?? "?"} via ${payload.provider}`
+  );
+  if (parsed.id) console.log(`  deployment_id: ${parsed.id}`);
+}
+async function main() {
+  const args = parseArgs(process.argv.slice(2));
+  switch (args.command) {
+    case "deploy-start":
+      await deployStart(args);
+      break;
+    case "help":
+    case "--help":
+    case "-h":
+      console.log(helpText());
+      break;
+    case "version":
+    case "--version":
+    case "-v":
+      console.log(`${CLI_NAME} v${CLI_VERSION}`);
+      break;
+    default:
+      console.error(`Unknown command: ${args.command}
+`);
+      console.error(helpText());
+      process.exit(1);
+  }
+}
+main().catch((err) => {
+  console.error(`fatal: ${err.message ?? err}`);
+  process.exit(1);
+});
+export {
+  deployStart
+};

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@fixprompt/cli",
+  "version": "0.0.1",
+  "description": "FixPrompt CLI — annotate deployments and ship them to the broker so the dashboard knows what changed.",
+  "license": "UNLICENSED",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Geos-LLC/FixPrompt.git",
+    "directory": "cli"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "bin": {
+    "fixprompt": "dist/cli.js"
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit",
+    "prepare": "npm run build",
+    "prepublishOnly": "npm run typecheck && npm run test && npm run build"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsup": "^8.3.5",
+    "typescript": "^5.4.0",
+    "vitest": "^2.1.0"
+  }
+}