@witchpot/gmc 0.2.1 → 0.3.0

package/CHANGELOG.md

@@ -4,6 +4,28 @@ All notable changes to the Game Market Copilot CLI will be recorded here.
 
 ## Unreleased
 
+## 0.3.0 - 2026-07-05
+
+- Added `gmc tags` for tag taxonomy discovery: `gmc tags` lists the full
+  slug/name dictionary and `gmc tags --q <term> [--limit <number>]` searches
+  it. The endpoint is anonymous and unmetered, so agents can resolve a genre
+  or keyword to valid tag slugs before spending quota on `--tags` filters.
+- Split shared, pure composition and analytics helpers (resolve/cohort/
+  showcase composers, deadline filtering) out of the CLI workflow layer and
+  into the new `@witchpot/gmc-core` package, now a published dependency of
+  this CLI. No command-facing behavior change.
+- This release rides on server-side additions already live in the API:
+  - Tag filters on games search/count/aggregate/benchmark, review patterns,
+    and the marketing/creators/cohort/showcases workflows now validate and
+    canonicalize `--tags` slugs, rejecting unknown ones with a 400
+    `INVALID_TAG` error carrying `details.unknown_tags` and
+    `details.suggestions`. `gmc tags` is the recommended preflight for
+    resolving valid slugs before hitting these filters.
+  - The `market_aggregate` MCP tool gained `segment_filter`, which narrows
+    the base filter (AND) and reports `segment.matched`/`segment.ratio`
+    against the base cohort at no extra credit cost (not yet combinable
+    with `group_by`).
+
 ## 0.2.1 - 2026-07-04
 
 - Updated `gmc update` to recommend the public `latest` npm dist-tag instead

package/README.md

@@ -91,6 +91,7 @@ Re-run install/print after `npm update` to pick up newer skill versions.
 
 ```bash
 gmc schema --json
+gmc tags --q roguelike --json
 gmc update --json
 gmc games search --source steam --release-year 2025 --reviews-min 1000 --fields title,appid,rating,reviews --json
 gmc games aggregate --source steam --release-year 2025 --metric count,median_reviews --group-by release_year --reviews-min 1000 --json
@@ -107,6 +108,7 @@ when using output in agent answers.
 - `gmc status`
 - `gmc auth status`
 - `gmc schema`
+- `gmc tags`
 - `gmc games search`
 - `gmc games count`
 - `gmc games aggregate`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@witchpot/gmc",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "private": false,
   "description": "Command line tools for Game Market Copilot market research.",
   "license": "UNLICENSED",
@@ -27,6 +27,9 @@
   "engines": {
     "node": ">=20.9.0"
   },
+  "dependencies": {
+    "@witchpot/gmc-core": "^0.1.0"
+  },
   "files": [
     "bin",
     "src",

package/src/args.js

@@ -49,6 +49,7 @@ function isCommandToken(command, token) {
     return [
       "status",
       "schema",
+      "tags",
       "games",
       "reviews",
       "campaigns",

package/src/constants.js

@@ -7,7 +7,7 @@ export const EXIT_CONFIG = 3;
 export const EXIT_API = 4;
 
 export const CLI_PACKAGE_NAME = "@witchpot/gmc";
-export const CLI_VERSION = "0.2.1";
+export const CLI_VERSION = "0.3.0";
 
 export const DEFAULT_API_BASE_URL = "https://gamemarketcopilot.com";
 export const DEFAULT_CONFIG_PATH = path.join(homedir(), ".config", "gmc", "config.json");
@@ -16,6 +16,8 @@ export const SUPPORTED_BETA_COMMANDS = [
   "gmc status --json",
   "gmc auth status --json",
   "gmc schema --json",
+  "gmc tags --json",
+  "gmc tags --q <term> --json",
   "gmc --version",
   "gmc update --json",
   "gmc skill install --json",
@@ -53,14 +55,7 @@ export const PROVISIONAL_BETA_COMMANDS = [
 ];
 
 export const COMPARE_FOCUSES = ["overview", "market", "reviews", "marketing", "audience", "showcases"];
-export const COMPARE_FOCUS_SECTIONS = {
-  overview: [],
-  market: [],
-  reviews: ["reviews"],
-  marketing: ["marketing", "creators", "media"],
-  audience: ["reviews", "coverage", "creators"],
-  showcases: ["showcases"]
-};
+export { COMPARE_FOCUS_SECTIONS } from "@witchpot/gmc-core";
 
 export const DEFAULT_BENCHMARK_LIMIT = "20";
 export const DEFAULT_CAMPAIGN_SIGNALS_LIMIT = "30";

package/src/help.js

@@ -25,6 +25,8 @@ Usage:
   gmc skill print --format agents-md
   gmc skill status --json
   gmc schema --json
+  gmc tags --json
+  gmc tags --q <term> --limit <number> --json
   gmc lists --json
   gmc lists create --name <name> --kind manual --json
   gmc lists games <id> --json
@@ -56,6 +58,19 @@ Usage:
   gmc showcases fit --source steam <externalId> --deadline-before <YYYY-MM-DD> --json
   gmc showcases patterns --source steam --tags <tag_slug[,tag_slug...]> --json
 
+Tag taxonomy:
+  gmc tags --json                    List the full tag dictionary (slug, name).
+  gmc tags --q <term> --json         Search tags by free-text term.
+  gmc tags --q <term> --limit <number> --json
+                                      Cap the number of matches, 1-500 (default 50).
+
+  Commands that filter by --tags (games search/count/aggregate/benchmark,
+  reviews patterns, marketing/creators/cohort/showcases workflows) reject
+  unknown tag slugs with a 400 INVALID_TAG error and a
+  details.unknown_tags / details.suggestions payload. Run gmc tags --q
+  <term> first to resolve a genre or keyword to valid slugs before
+  building a --tags filter.
+
 Binary aliases:
   gmcp and game-market-copilot run the same CLI. Use them when a shell
   alias shadows gmc (Oh My Zsh's git plugin defines gmc as

package/src/requests.js

@@ -14,6 +14,9 @@ import {
 } from "./constants.js";
 import { matches } from "./args.js";
 import { writeJsonError } from "./output.js";
+import { filterShowcasesByDeadline } from "@witchpot/gmc-core";
+
+export { filterShowcasesByDeadline };
 
 export function buildRequest(command, options, positional) {
   if (matches(command, ["status"])) {
@@ -37,6 +40,17 @@ export function buildRequest(command, options, positional) {
     };
   }
 
+  if (matches(command, ["tags"])) {
+    const q = options.q ?? options.query;
+    return {
+      path: "/api/v1/tags",
+      query: {
+        ...(q != null ? { q } : {}),
+        ...pickQuery(options, { limit: "limit" })
+      }
+    };
+  }
+
   if (matches(command, ["lists"])) {
     return {
       path: "/api/v1/lists",
@@ -886,18 +900,3 @@ function normalizeTagSlugCsv(value) {
     .filter(Boolean)
     .join(",");
 }
-
-export function filterShowcasesByDeadline(payload, deadlineBefore) {
-  if (!payload || !Array.isArray(payload.data)) return payload;
-  return {
-    ...payload,
-    data: payload.data.filter((showcase) => {
-      if (!showcase || typeof showcase !== "object" || !showcase.deadline) return false;
-      return String(showcase.deadline) <= deadlineBefore;
-    }),
-    warnings: [
-      ...(payload.warnings ?? []),
-      "deadline-before was applied client-side by the gmc CLI"
-    ]
-  };
-}

package/src/requests.test.js

@@ -39,6 +39,41 @@ test("games success-report forwards locale", () => {
   assert.deepEqual(request.query, { locale: "ja" });
 });
 
+test("tags builds the full-dictionary request plan", () => {
+  const request = buildRequestFromArgv(["tags", "--json"]);
+
+  assert.equal(request.path, "/api/v1/tags");
+  assert.deepEqual(request.query, {});
+});
+
+test("tags forwards --q as the q query param", () => {
+  const request = buildRequestFromArgv(["tags", "--q", "roguelike", "--json"]);
+
+  assert.equal(request.path, "/api/v1/tags");
+  assert.deepEqual(request.query, { q: "roguelike" });
+});
+
+test("tags accepts --query as an alias for --q", () => {
+  const request = buildRequestFromArgv(["tags", "--query", "roguelike", "--json"]);
+
+  assert.equal(request.path, "/api/v1/tags");
+  assert.deepEqual(request.query, { q: "roguelike" });
+});
+
+test("tags forwards --limit alongside --q", () => {
+  const request = buildRequestFromArgv([
+    "tags",
+    "--q",
+    "deck",
+    "--limit",
+    "10",
+    "--json"
+  ]);
+
+  assert.equal(request.path, "/api/v1/tags");
+  assert.deepEqual(request.query, { q: "deck", limit: "10" });
+});
+
 test("games detail request plan stays unchanged", () => {
   const request = buildRequestFromArgv([
     "games",