@witchpot/gmc 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -2,7 +2,18 @@
 
 All notable changes to the Game Market Copilot CLI will be recorded here.
 
-## 0.1.0 - Unreleased
+## 0.1.2 - Unreleased
+
+- Fixed the npm executable entrypoint so `gmc` runs correctly through npm,
+  Volta, and other package-manager shims.
+- Added packed-tarball smoke validation for actual CLI stdout to catch silent
+  executable startup regressions.
+
+## 0.1.1 - 2026-06-01
+
+- Updated npm package description and README introduction for public beta users.
+
+## 0.1.0 - 2026-06-01
 
 - Added the initial JSON-first `gmc` command set for status, schema, Steam game
   search, resolve, detail, analysis, topics, compare, benchmark, review

package/README.md

@@ -1,30 +1,26 @@
 # Game Market Copilot CLI
 
-`gmc` is the JSON-first command line client for Game Market Copilot. It wraps
-stable `/api/v1` endpoints so Codex, Claude Code, and other agents can answer
-market questions from bounded API evidence instead of reading Supabase directly.
+`gmc` lets you use Game Market Copilot from your terminal or coding agent to
+research Steam games, compare peers, review market signals, and find relevant
+showcases.
 
 ## Install
 
-The CLI package is published to npm with a public package and beta dist-tag. If
-the beta package has not been published in the current environment yet, run from
-this repository:
+Install the beta CLI:
 
 ```bash
-npm run gmc -- --help
+npm install -g @witchpot/gmc@beta
+gmc --version
 ```
 
-The package name for beta distribution is `@witchpot/gmc` with the
-`gmc` binary. Before publishing a beta build, run:
+Or run it without a global install:
 
 ```bash
-npm run gmc:release:check
-npm run gmc:publish:beta:dry-run
-npm run gmc:publish:beta
+npx @witchpot/gmc@beta --version
 ```
 
-Closed-beta setup details live in
-[`docs/closed-beta-onboarding.md`](../../docs/closed-beta-onboarding.md).
+A fuller user guide lives in
+[`docs/gmc-cli-user-guide.md`](../../docs/gmc-cli-user-guide.md).
 
 Closed-beta access is controlled by GMC API credentials, not npm package
 visibility. Installing the public package does not grant access to paid or beta

package/bin/gmc.mjs

@@ -1,50 +1,5 @@
 #!/usr/bin/env node
 
-import { isCliEntryPoint, runCliEntryPoint } from "../src/main.js";
+import { runCliEntryPoint } from "../src/main.js";
 
-export { BOOLEAN_OPTIONS, matches, parseArgs } from "../src/args.js";
-export {
-  buildLoginUrl,
-  exchangeAuthorizationCode,
-  extractCredentialFromTokenPayload,
-  runBrowserLogin
-} from "../src/browser-login.js";
-export { handleLocalCommand, loadConfig, parseBaseUrl } from "../src/config.js";
-export {
-  CLI_BETA_PACKAGE_NAME,
-  CLI_PACKAGE_NAME,
-  CLI_VERSION,
-  PROVISIONAL_BETA_COMMANDS,
-  SUPPORTED_BETA_COMMANDS
-} from "../src/constants.js";
-export { writeJsonError } from "../src/output.js";
-export { applyFieldsProjection, applyOutputProjection } from "../src/projection.js";
-export {
-  buildRequest,
-  buildRequestHeaders,
-  createRequestUrl,
-  filterShowcasesByDeadline
-} from "../src/requests.js";
-export {
-  buildHttpApiError,
-  buildNonJsonApiError,
-  composeBenchmarkPayload,
-  composeCampaignSignalsPayload,
-  composeCohortEvidencePayload,
-  composeComparePayload,
-  composeReviewPatternsPayload,
-  composeResolvePayload,
-  composeShowcaseFitPayload,
-  executeRequestPlan
-} from "../src/workflows.js";
-export {
-  buildCliAuthStatus,
-  enrichAuthStatusOutput,
-  isCliEntryPoint,
-  main,
-  runCliEntryPoint
-} from "../src/main.js";
-
-if (isCliEntryPoint(import.meta.url)) {
-  runCliEntryPoint();
-}
+runCliEntryPoint();

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@witchpot/gmc",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "private": false,
-  "description": "JSON-first CLI for Game Market Copilot API and agent workflows.",
+  "description": "Command line tools for Game Market Copilot market research.",
   "license": "UNLICENSED",
   "repository": {
     "type": "git",
@@ -14,6 +14,11 @@
     "url": "https://gamemarketcopilot.com"
   },
   "type": "module",
+  "main": "./src/index.js",
+  "exports": {
+    ".": "./src/index.js",
+    "./package.json": "./package.json"
+  },
   "bin": {
     "gmc": "bin/gmc.mjs"
   },

package/scripts/check-release-readiness.mjs

@@ -9,6 +9,7 @@ const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf8"));
 
 const requiredFiles = [
   "bin/gmc.mjs",
+  "src/index.js",
   "src/main.js",
   "src/requests.js",
   "src/workflows.js",
@@ -26,6 +27,7 @@ const forbiddenPatterns = [
 
 const sourceFiles = [
   "bin/gmc.mjs",
+  "src/index.js",
   "src/args.js",
   "src/browser-login.js",
   "src/config.js",
@@ -56,6 +58,14 @@ if (packageJson.bin?.gmc !== "bin/gmc.mjs") {
   failures.push("bin.gmc must point to bin/gmc.mjs.");
 }
 
+if (packageJson.main !== "./src/index.js") {
+  failures.push("main must point to ./src/index.js.");
+}
+
+if (packageJson.exports?.["."] !== "./src/index.js") {
+  failures.push("exports['.'] must point to ./src/index.js.");
+}
+
 for (const required of requiredFileGlobs) {
   if (!packageJson.files?.includes(required)) {
     failures.push(`package.json files must include ${required}.`);

package/scripts/smoke-pack.mjs

@@ -48,8 +48,22 @@ try {
   const binName = process.platform === "win32" ? "gmc.cmd" : "gmc";
   const gmcBin = path.join(workDir, "node_modules", ".bin", binName);
   const configPath = path.join(projectDir, "config.json");
-  run(gmcBin, ["--help"], { env: { GMC_CONFIG_PATH: configPath } });
-  run(gmcBin, ["config", "get", "--json"], { env: { GMC_CONFIG_PATH: configPath } });
+  const helpResult = run(gmcBin, ["--help"], {
+    env: { GMC_CONFIG_PATH: configPath },
+    capture: true
+  });
+  if (!helpResult.stdout.includes("Game Market Copilot CLI") || !helpResult.stdout.includes("gmc --version")) {
+    throw new Error("Packed gmc --help did not print the expected help text");
+  }
+
+  const configResult = run(gmcBin, ["config", "get", "--json"], {
+    env: { GMC_CONFIG_PATH: configPath },
+    capture: true
+  });
+  const configPayload = JSON.parse(configResult.stdout);
+  if (configPayload?.data?.configPath !== configPath || configPayload?.data?.authMode !== "anonymous") {
+    throw new Error("Packed gmc config get --json did not print the expected config payload");
+  }
 } finally {
   rmSync(workDir, { recursive: true, force: true });
 }

package/src/constants.js

@@ -8,7 +8,7 @@ export const EXIT_API = 4;
 
 export const CLI_PACKAGE_NAME = "@witchpot/gmc";
 export const CLI_BETA_PACKAGE_NAME = "@witchpot/gmc";
-export const CLI_VERSION = "0.1.0";
+export const CLI_VERSION = "0.1.2";
 
 export const DEFAULT_API_BASE_URL = "https://gamemarketcopilot.com";
 export const DEFAULT_CONFIG_PATH = path.join(homedir(), ".config", "gmc", "config.json");

package/src/index.js

@@ -0,0 +1,41 @@
+export { BOOLEAN_OPTIONS, matches, parseArgs } from "./args.js";
+export {
+  buildLoginUrl,
+  exchangeAuthorizationCode,
+  extractCredentialFromTokenPayload,
+  runBrowserLogin
+} from "./browser-login.js";
+export { handleLocalCommand, loadConfig, parseBaseUrl } from "./config.js";
+export {
+  CLI_BETA_PACKAGE_NAME,
+  CLI_PACKAGE_NAME,
+  CLI_VERSION,
+  PROVISIONAL_BETA_COMMANDS,
+  SUPPORTED_BETA_COMMANDS
+} from "./constants.js";
+export { writeJsonError } from "./output.js";
+export { applyFieldsProjection, applyOutputProjection } from "./projection.js";
+export {
+  buildRequest,
+  buildRequestHeaders,
+  createRequestUrl,
+  filterShowcasesByDeadline
+} from "./requests.js";
+export {
+  buildCliAuthStatus,
+  enrichAuthStatusOutput,
+  main,
+  runCliEntryPoint
+} from "./main.js";
+export {
+  buildHttpApiError,
+  buildNonJsonApiError,
+  composeBenchmarkPayload,
+  composeCampaignSignalsPayload,
+  composeCohortEvidencePayload,
+  composeComparePayload,
+  composeReviewPatternsPayload,
+  composeResolvePayload,
+  composeShowcaseFitPayload,
+  executeRequestPlan
+} from "./workflows.js";

package/src/main.js

@@ -1,4 +1,3 @@
-import { pathToFileURL } from "node:url";
 import {
   CLI_PACKAGE_NAME,
   CLI_VERSION,
@@ -89,10 +88,6 @@ export function runCliEntryPoint() {
   });
 }
 
-export function isCliEntryPoint(importMetaUrl, argvEntry = process.argv[1]) {
-  return Boolean(argvEntry && importMetaUrl === pathToFileURL(argvEntry).href);
-}
-
 export function enrichAuthStatusOutput(payload, config) {
   if (!payload || typeof payload !== "object" || !payload.data || typeof payload.data !== "object") {
     return payload;