@dataworks-technology/cli 1.2.0 → 1.3.0

package/.agents/plugins/marketplace.json

@@ -0,0 +1,20 @@
+{
+  "name": "dataworks-cli",
+  "interface": {
+    "displayName": "Dataworks CLI"
+  },
+  "plugins": [
+    {
+      "name": "dataworks",
+      "source": {
+        "source": "local",
+        "path": "./plugins/dataworks"
+      },
+      "policy": {
+        "installation": "AVAILABLE",
+        "authentication": "ON_INSTALL"
+      },
+      "category": "Data"
+    }
+  ]
+}

package/.claude-plugin/marketplace.json

@@ -0,0 +1,16 @@
+{
+  "name": "dataworks-cli",
+  "owner": {
+    "name": "Dataworks Technology"
+  },
+  "metadata": {
+    "description": "Official Dataworks CLI integrations for Claude Code"
+  },
+  "plugins": [
+    {
+      "name": "dataworks",
+      "source": "./plugins/dataworks",
+      "description": "Query Dataworks athlete metrics using the authenticated local CLI session"
+    }
+  ]
+}

package/README.md

@@ -22,6 +22,7 @@ The `dw` binary turns the public GraphQL contract published by `@dataworks-techn
 
 | Command               | Description                                                 |
 | --------------------- | ----------------------------------------------------------- |
+| `dw agents install`   | Install the Dataworks skill and MCP tools for AI agents     |
 | `dw auth ...`         | Log in, log out, and inspect the active UAT or Live session |
 | `dw autocomplete`     | Install shell completion for commands and flags             |
 | `dw data ...`         | Run schema-derived queries, mutations, and subscriptions    |
@@ -86,6 +87,23 @@ The `dw` binary turns the public GraphQL contract published by `@dataworks-techn
 
 Generated command documentation is available in [`docs/commands`](./docs/commands/README.md).
 
+5. **Enable Dataworks in Codex or Claude Code:**
+
+   ```sh
+   dw agents install
+   ```
+
+   This detects supported clients and installs the complete Dataworks plugin:
+   the metric-query skill plus its read-only `query_metrics` MCP server. Start a
+   new Codex thread after installation. In Claude Code, run `/reload-plugins` or
+   start a new session. To configure only one client, use
+   `dw agents install codex` or `dw agents install claude-code`.
+
+   Until setup is completed, interactive CLI use prints this reminder at most
+   once every 24 hours. It never appears with `--json`. Permanently hide it with
+   `dw agents reminder disable`, restore it with `dw agents reminder enable`, or
+   set `DW_NO_AGENT_REMINDER=1` for a single process or automation environment.
+
 ---
 
 ## Bash autocomplete
@@ -96,10 +114,61 @@ Generate the completion cache and print the one-time Bash setup instructions:
 dw autocomplete bash
 ```
 
+Global npm installs and upgrades run this command automatically. It prepares the
+latest completion cache and prints the setup instruction, but does not edit your
+shell startup files. If npm cannot access the shell cache, installation still
+succeeds and you can retry with `dw autocomplete bash`.
+
 After following the displayed instruction and reloading Bash, press Tab to
 complete `dw` command names and flags. Run `dw autocomplete --refresh-cache`
 after installing a release that adds commands.
 
+## AI agent metric queries
+
+The package includes a focused, read-only MCP server with one tool:
+`query_metrics`. It uses the same OS-backed login session and selected tenant as
+`dw`, resolves an athlete by exact ID or unique name, maps common metric aliases,
+polls asynchronous Data Explorer queries, and returns normalized structured
+rows. GPS values include decoded latitude and longitude; heart-rate values use
+numeric BPM when valid.
+
+The simplest setup for Codex and Claude Code is:
+
+```sh
+dw agents install
+```
+
+The command is safe to rerun after upgrades. It installs or updates the complete
+Dataworks plugin for each detected client and reports the reload or restart step.
+If an old marketplace registration points to a different CLI installation, rerun
+with `--force`.
+
+Successful setup automatically disables the periodic CLI reminder. To opt out
+without installing an agent integration, run `dw agents reminder disable`.
+
+Other MCP clients can launch the installed `dw-mcp` binary directly:
+
+```json
+{
+  "mcpServers": {
+    "dataworks": {
+      "command": "dw-mcp",
+      "args": []
+    }
+  }
+}
+```
+
+The npm package ships a cross-compatible Codex and Claude Code plugin at
+`plugins/dataworks`. Its focused skill turns requests such as “give me the last
+30 GPS values for James Haigh” into a `query_metrics` call. The tool accepts
+exactly one of `athlete_id` or `athlete_name`, plus `metric`; optional inputs are
+`limit`, `order`, `from`, `to`, `event_id`, `dataset_datasource_id`,
+`tenant_id`, `metric_category`, and `timeout_ms`.
+
+The server never performs mutations. If name resolution is ambiguous, it
+returns candidates and requires an explicit athlete ID rather than guessing.
+
 ---
 
 ## Output and Safety

package/bin/mcp.js

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+import { runDataworksMcpServer } from "../dist/mcp/main.js";
+
+runDataworksMcpServer().catch((error) => {
+  process.stderr.write(
+    `Dataworks MCP server failed: ${error instanceof Error ? error.message : String(error)}\n`,
+  );
+  process.exitCode = 1;
+});

package/bin/postinstall.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+import { spawnSync } from "node:child_process";
+import { fileURLToPath } from "node:url";
+
+// npm runs postinstall for both first-time global installs and global upgrades.
+// Avoid writing shell caches when this package is only a project dependency.
+if (
+  process.env.npm_config_global === "true" ||
+  process.env.npm_config_location === "global"
+) {
+  const runPath = fileURLToPath(new URL("./run.js", import.meta.url));
+  const result = spawnSync(process.execPath, [runPath, "autocomplete", "bash"], {
+    stdio: "inherit",
+  });
+  if (result.error || result.status !== 0) {
+    process.stderr.write(
+      "Dataworks CLI installed, but Bash autocomplete setup could not be prepared. Run `dw autocomplete bash` to retry.\n",
+    );
+  }
+  process.stdout.write(
+    "To use Dataworks from Codex or Claude Code, run `dw agents install` once.\n",
+  );
+}

package/dist/commands/agents/install.d.ts

@@ -0,0 +1,17 @@
+import { DataworksCommand } from "../../lib/command.js";
+export default class AgentsInstall extends DataworksCommand {
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static args: {
+        client: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static flags: {
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=install.d.ts.map

package/dist/commands/agents/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../../src/commands/agents/install.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AASxD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,gBAAgB;IACzD,OAAgB,WAAW,SAC2D;IACtF,OAAgB,QAAQ;;;QAiBtB;IACF,OAAgB,IAAI;;MAMlB;IACF,OAAgB,KAAK;;;MAKnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CA4BlC"}

package/dist/commands/agents/install.js

@@ -0,0 +1,57 @@
+import { Args, Flags } from "@oclif/core";
+import { DataworksCommand } from "../../lib/command.js";
+import { installAgentIntegration, supportedAgentClients, } from "../../lib/agent-install.js";
+import { writeResult } from "../../lib/output.js";
+import { configureAgentReminder } from "../../lib/agent-reminder.js";
+export default class AgentsInstall extends DataworksCommand {
+    static description = "Install the Dataworks skill and query_metrics MCP server for Codex or Claude Code";
+    static examples = [
+        {
+            description: "Set up every supported agent client found on this machine",
+            command: "dw agents install",
+        },
+        {
+            description: "Set up Codex only",
+            command: "dw agents install codex",
+        },
+        {
+            description: "Set up Claude Code only",
+            command: "dw agents install claude-code",
+        },
+        {
+            description: "Replace a stale Dataworks marketplace registration",
+            command: "dw agents install codex --force",
+        },
+    ];
+    static args = {
+        client: Args.string({
+            description: "Agent client to configure; omit to detect and configure both",
+            options: ["codex", "claude-code"],
+            required: false,
+        }),
+    };
+    static flags = {
+        force: Flags.boolean({
+            description: "Replace an existing Dataworks marketplace registration",
+        }),
+        json: Flags.boolean({ description: "Emit stable JSON output" }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(AgentsInstall);
+        const clients = args.client ? [args.client] : supportedAgentClients;
+        const results = clients.map((client) => installAgentIntegration(client, { force: flags.force }));
+        if (results.some(({ status }) => status === "installed" || status === "updated")) {
+            await configureAgentReminder("configured");
+        }
+        writeResult({ integrations: results }, {
+            json: flags.json,
+            meta: {
+                restartRequired: results.some(({ status }) => status === "installed" || status === "updated"),
+            },
+        });
+        if (results.every(({ status }) => status === "unavailable" || status === "failed")) {
+            process.exitCode = 1;
+        }
+    }
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/agents/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../../../src/commands/agents/install.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EACL,uBAAuB,EACvB,qBAAqB,GAEtB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAErE,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,gBAAgB;IACzD,MAAM,CAAU,WAAW,GACzB,mFAAmF,CAAC;IACtF,MAAM,CAAU,QAAQ,GAAG;QACzB;YACE,WAAW,EAAE,2DAA2D;YACxE,OAAO,EAAE,mBAAmB;SAC7B;QACD;YACE,WAAW,EAAE,mBAAmB;YAChC,OAAO,EAAE,yBAAyB;SACnC;QACD;YACE,WAAW,EAAE,yBAAyB;YACtC,OAAO,EAAE,+BAA+B;SACzC;QACD;YACE,WAAW,EAAE,oDAAoD;YACjE,OAAO,EAAE,iCAAiC;SAC3C;KACF,CAAC;IACF,MAAM,CAAU,IAAI,GAAG;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;YAClB,WAAW,EAAE,8DAA8D;YAC3E,OAAO,EAAE,CAAC,OAAO,EAAE,aAAa,CAAC;YACjC,QAAQ,EAAE,KAAK;SAChB,CAAC;KACH,CAAC;IACF,MAAM,CAAU,KAAK,GAAG;QACtB,KAAK,EAAE,KAAK,CAAC,OAAO,CAAC;YACnB,WAAW,EAAE,wDAAwD;SACtE,CAAC;QACF,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC;KAChE,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;QACxD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAqB,CAAC,CAAC,CAAC,CAAC,qBAAqB,CAAC;QACnF,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACrC,uBAAuB,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CACxD,CAAC;QACF,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,SAAS,CAAC,EAAE,CAAC;YACjF,MAAM,sBAAsB,CAAC,YAAY,CAAC,CAAC;QAC7C,CAAC;QAED,WAAW,CACT,EAAE,YAAY,EAAE,OAAO,EAAE,EACzB;YACE,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE;gBACJ,eAAe,EAAE,OAAO,CAAC,IAAI,CAC3B,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,KAAK,WAAW,IAAI,MAAM,KAAK,SAAS,CAC/D;aACF;SACF,CACF,CAAC;QAEF,IACE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,KAAK,aAAa,IAAI,MAAM,KAAK,QAAQ,CAAC,EAC9E,CAAC;YACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACvB,CAAC;IACH,CAAC"}

package/dist/commands/agents/reminder.d.ts

@@ -0,0 +1,16 @@
+import { DataworksCommand } from "../../lib/command.js";
+export default class AgentsReminder extends DataworksCommand {
+    static description: string;
+    static examples: {
+        description: string;
+        command: string;
+    }[];
+    static args: {
+        action: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}
+//# sourceMappingURL=reminder.d.ts.map

package/dist/commands/agents/reminder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reminder.d.ts","sourceRoot":"","sources":["../../../src/commands/agents/reminder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AASxD,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,gBAAgB;IAC1D,OAAgB,WAAW,SACwC;IACnE,OAAgB,QAAQ;;;QAatB;IACF,OAAgB,IAAI;;MAMlB;IACF,OAAgB,KAAK;;MAEnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAiBlC"}

package/dist/commands/agents/reminder.js

@@ -0,0 +1,45 @@
+import { Args, Flags } from "@oclif/core";
+import { DataworksCommand } from "../../lib/command.js";
+import { configureAgentReminder, readAgentReminderPreferences, } from "../../lib/agent-reminder.js";
+import { writeResult } from "../../lib/output.js";
+export default class AgentsReminder extends DataworksCommand {
+    static description = "Inspect, disable, or enable the Dataworks agent setup reminder";
+    static examples = [
+        {
+            description: "Permanently hide the agent setup reminder",
+            command: "dw agents reminder disable",
+        },
+        {
+            description: "Show the reminder again when setup is incomplete",
+            command: "dw agents reminder enable",
+        },
+        {
+            description: "Inspect the current reminder state",
+            command: "dw agents reminder status --json",
+        },
+    ];
+    static args = {
+        action: Args.string({
+            description: "Reminder action",
+            options: ["status", "disable", "enable"],
+            default: "status",
+        }),
+    };
+    static flags = {
+        json: Flags.boolean({ description: "Emit stable JSON output" }),
+    };
+    async run() {
+        const { args, flags } = await this.parse(AgentsReminder);
+        const action = args.action;
+        const reminder = action === "status"
+            ? await readAgentReminderPreferences()
+            : await configureAgentReminder(action);
+        writeResult({
+            reminder: {
+                ...reminder,
+                enabled: !reminder.disabled && !reminder.configured,
+            },
+        }, { json: flags.json });
+    }
+}
+//# sourceMappingURL=reminder.js.map

package/dist/commands/agents/reminder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reminder.js","sourceRoot":"","sources":["../../../src/commands/agents/reminder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EACL,sBAAsB,EACtB,4BAA4B,GAC7B,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAIlD,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,gBAAgB;IAC1D,MAAM,CAAU,WAAW,GACzB,gEAAgE,CAAC;IACnE,MAAM,CAAU,QAAQ,GAAG;QACzB;YACE,WAAW,EAAE,2CAA2C;YACxD,OAAO,EAAE,4BAA4B;SACtC;QACD;YACE,WAAW,EAAE,kDAAkD;YAC/D,OAAO,EAAE,2BAA2B;SACrC;QACD;YACE,WAAW,EAAE,oCAAoC;YACjD,OAAO,EAAE,kCAAkC;SAC5C;KACF,CAAC;IACF,MAAM,CAAU,IAAI,GAAG;QACrB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;YAClB,WAAW,EAAE,iBAAiB;YAC9B,OAAO,EAAE,CAAC,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAC;YACxC,OAAO,EAAE,QAAQ;SAClB,CAAC;KACH,CAAC;IACF,MAAM,CAAU,KAAK,GAAG;QACtB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC;KAChE,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAwB,CAAC;QAC7C,MAAM,QAAQ,GACZ,MAAM,KAAK,QAAQ;YACjB,CAAC,CAAC,MAAM,4BAA4B,EAAE;YACtC,CAAC,CAAC,MAAM,sBAAsB,CAAC,MAAM,CAAC,CAAC;QAC3C,WAAW,CACT;YACE,QAAQ,EAAE;gBACR,GAAG,QAAQ;gBACX,OAAO,EAAE,CAAC,QAAQ,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,UAAU;aACpD;SACF,EACD,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CACrB,CAAC;IACJ,CAAC"}

package/dist/commands/commands.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/commands/commands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAoBrD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,gBAAgB;IACpD,OAAgB,WAAW,SACgC;IAC3D,OAAgB,KAAK;;MAEnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAiBlC"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/commands/commands.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAsBrD,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,gBAAgB;IACpD,OAAgB,WAAW,SACgC;IAC3D,OAAgB,KAAK;;MAEnB;IAEW,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAiBlC"}

package/dist/commands/commands.js

@@ -3,6 +3,8 @@ import { DataworksCommand } from "../lib/command.js";
 import { operations } from "../generated/operations.js";
 import { writeResult } from "../lib/output.js";
 const builtIns = [
+    "agents install",
+    "agents reminder",
     "auth login",
     "auth logout",
     "auth status",

package/dist/commands/commands.js.map

@@ -1 +1 @@
-{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/commands/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,QAAQ,GAAG;IACf,YAAY;IACZ,aAAa;IACb,aAAa;IACb,cAAc;IACd,UAAU;IACV,kBAAkB;IAClB,gBAAgB;IAChB,eAAe;IACf,mBAAmB;IACnB,QAAQ;IACR,cAAc;IACd,aAAa;IACb,eAAe;CAChB,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,gBAAgB;IACpD,MAAM,CAAU,WAAW,GACzB,wDAAwD,CAAC;IAC3D,MAAM,CAAU,KAAK,GAAG;QACtB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC;KAChE,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG;YACX,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,EAAE,EAAE,CAAC,CAAC;YACnE,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBACxC,OAAO,EAAE,MAAM,SAAS,CAAC,OAAO,EAAE;gBAClC,SAAS,EAAE,SAAS,CAAC,IAAI;gBACzB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,SAAS,EAAE,SAAS,CAAC,SAAS;aAC/B,CAAC,CAAC;SACJ,CAAC;QACF,WAAW,CAAC,IAAI,EAAE;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,EAAE,cAAc,EAAE,UAAU,CAAC,MAAM,EAAE;SAC5C,CAAC,CAAC;IACL,CAAC"}
+{"version":3,"file":"commands.js","sourceRoot":"","sources":["../../src/commands/commands.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,QAAQ,GAAG;IACf,gBAAgB;IAChB,iBAAiB;IACjB,YAAY;IACZ,aAAa;IACb,aAAa;IACb,cAAc;IACd,UAAU;IACV,kBAAkB;IAClB,gBAAgB;IAChB,eAAe;IACf,mBAAmB;IACnB,QAAQ;IACR,cAAc;IACd,aAAa;IACb,eAAe;CAChB,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,QAAS,SAAQ,gBAAgB;IACpD,MAAM,CAAU,WAAW,GACzB,wDAAwD,CAAC;IAC3D,MAAM,CAAU,KAAK,GAAG;QACtB,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,yBAAyB,EAAE,CAAC;KAChE,CAAC;IAEK,KAAK,CAAC,GAAG;QACd,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAC7C,MAAM,IAAI,GAAG;YACX,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,OAAO,EAAE,EAAE,CAAC,CAAC;YACnE,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;gBACxC,OAAO,EAAE,MAAM,SAAS,CAAC,OAAO,EAAE;gBAClC,SAAS,EAAE,SAAS,CAAC,IAAI;gBACzB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,IAAI,EAAE,SAAS,CAAC,IAAI;gBACpB,SAAS,EAAE,SAAS,CAAC,SAAS;aAC/B,CAAC,CAAC;SACJ,CAAC;QACF,WAAW,CAAC,IAAI,EAAE;YAChB,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,EAAE,cAAc,EAAE,UAAU,CAAC,MAAM,EAAE;SAC5C,CAAC,CAAC;IACL,CAAC"}

package/dist/lib/agent-install.d.ts

@@ -0,0 +1,24 @@
+export type AgentClient = "codex" | "claude-code";
+export type AgentInstallStatus = "installed" | "updated" | "unavailable" | "failed";
+export interface AgentInstallResult {
+    client: AgentClient;
+    status: AgentInstallStatus;
+    message: string;
+    nextStep: string;
+}
+export interface ProcessResult {
+    status: number | null;
+    stdout: string;
+    stderr: string;
+    error?: Error;
+}
+export type ProcessRunner = (command: string, args: readonly string[]) => ProcessResult;
+export interface AgentInstallOptions {
+    force?: boolean;
+    packageRoot?: string;
+    run?: ProcessRunner;
+}
+export declare const supportedAgentClients: readonly AgentClient[];
+export declare function dataworksPackageRoot(): string;
+export declare function installAgentIntegration(client: AgentClient, options?: AgentInstallOptions): AgentInstallResult;
+//# sourceMappingURL=agent-install.d.ts.map

package/dist/lib/agent-install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-install.d.ts","sourceRoot":"","sources":["../../src/lib/agent-install.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,aAAa,CAAC;AAClD,MAAM,MAAM,kBAAkB,GAAG,WAAW,GAAG,SAAS,GAAG,aAAa,GAAG,QAAQ,CAAC;AAEpF,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,WAAW,CAAC;IACpB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,KAAK,aAAa,CAAC;AAExF,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,aAAa,CAAC;CACrB;AAKD,eAAO,MAAM,qBAAqB,EAAE,SAAS,WAAW,EAA6B,CAAC;AAEtF,wBAAgB,oBAAoB,IAAI,MAAM,CAE7C;AA0PD,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,WAAW,EACnB,OAAO,GAAE,mBAAwB,GAChC,kBAAkB,CAUpB"}

package/dist/lib/agent-install.js

@@ -0,0 +1,196 @@
+import { spawnSync } from "node:child_process";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const marketplaceName = "dataworks-cli";
+const pluginId = `dataworks@${marketplaceName}`;
+export const supportedAgentClients = ["codex", "claude-code"];
+export function dataworksPackageRoot() {
+    return fileURLToPath(new URL("../../", import.meta.url));
+}
+function defaultRunner(command, args) {
+    const result = spawnSync(command, [...args], {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    return {
+        status: result.status,
+        stdout: result.stdout ?? "",
+        stderr: result.stderr ?? "",
+        error: result.error,
+    };
+}
+function executable(client) {
+    return client === "codex" ? "codex" : "claude";
+}
+function failureMessage(result) {
+    return (result.stderr.trim() ||
+        result.stdout.trim() ||
+        result.error?.message ||
+        "The client command failed without an error message.");
+}
+function parseJson(value) {
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return undefined;
+    }
+}
+function codexMarketplaceRoot(payload) {
+    if (!payload || typeof payload !== "object")
+        return undefined;
+    const marketplaces = payload.marketplaces;
+    if (!Array.isArray(marketplaces))
+        return undefined;
+    const entry = marketplaces.find((candidate) => !!candidate &&
+        typeof candidate === "object" &&
+        candidate.name === marketplaceName);
+    return entry?.root;
+}
+function claudeMarketplace(payload) {
+    if (!Array.isArray(payload))
+        return { exists: false };
+    const entry = payload.find((candidate) => !!candidate &&
+        typeof candidate === "object" &&
+        candidate.name === marketplaceName);
+    return {
+        exists: !!entry,
+        root: entry?.path ?? entry?.installLocation,
+    };
+}
+function pluginIsInstalled(client, payload) {
+    const entries = client === "codex" && payload && typeof payload === "object"
+        ? payload.installed
+        : payload;
+    if (!Array.isArray(entries))
+        return false;
+    return entries.some((entry) => {
+        if (!entry || typeof entry !== "object")
+            return false;
+        const item = entry;
+        return (item.id === pluginId ||
+            item.pluginId === pluginId ||
+            (item.name === "dataworks" &&
+                (item.marketplace === marketplaceName ||
+                    item.marketplaceName === marketplaceName)));
+    });
+}
+function unavailable(client) {
+    const binary = executable(client);
+    return {
+        client,
+        status: "unavailable",
+        message: `${binary} is not installed or is not available on PATH.`,
+        nextStep: `Install ${client === "codex" ? "Codex" : "Claude Code"}, then run \`dw agents install ${client}\` again.`,
+    };
+}
+function failed(client, result, nextStep) {
+    return {
+        client,
+        status: "failed",
+        message: failureMessage(result),
+        nextStep,
+    };
+}
+function installCodex(options) {
+    const { run, packageRoot, force } = options;
+    const list = run("codex", ["plugin", "marketplace", "list", "--json"]);
+    if (list.status !== 0) {
+        return failed("codex", list, "Run `codex plugin marketplace list` to inspect the Codex plugin configuration, then retry.");
+    }
+    const listedRoot = codexMarketplaceRoot(parseJson(list.stdout));
+    const currentRoot = listedRoot ? resolve(listedRoot) : undefined;
+    if (currentRoot && currentRoot !== packageRoot) {
+        if (!force) {
+            return {
+                client: "codex",
+                status: "failed",
+                message: `The ${marketplaceName} marketplace already points to ${currentRoot}.`,
+                nextStep: "Run `dw agents install codex --force` to replace the stale marketplace registration.",
+            };
+        }
+        const remove = run("codex", ["plugin", "marketplace", "remove", marketplaceName]);
+        if (remove.status !== 0) {
+            return failed("codex", remove, "Run `codex plugin marketplace list` to inspect the conflicting registration.");
+        }
+    }
+    if (!currentRoot || currentRoot !== packageRoot) {
+        const addMarketplace = run("codex", [
+            "plugin",
+            "marketplace",
+            "add",
+            packageRoot,
+            "--json",
+        ]);
+        if (addMarketplace.status !== 0) {
+            return failed("codex", addMarketplace, `Run \`codex plugin marketplace add ${packageRoot}\`, then retry.`);
+        }
+    }
+    const before = run("codex", ["plugin", "list", "--json"]);
+    const alreadyInstalled = before.status === 0 && pluginIsInstalled("codex", parseJson(before.stdout));
+    const install = run("codex", ["plugin", "add", pluginId, "--json"]);
+    if (install.status !== 0) {
+        return failed("codex", install, `Run \`codex plugin add ${pluginId}\`, then retry.`);
+    }
+    return {
+        client: "codex",
+        status: alreadyInstalled ? "updated" : "installed",
+        message: "The Dataworks skill and query_metrics MCP server are enabled.",
+        nextStep: "Start a new Codex thread before asking a Dataworks metrics question.",
+    };
+}
+function installClaudeCode(options) {
+    const { run, packageRoot, force } = options;
+    const list = run("claude", ["plugin", "marketplace", "list", "--json"]);
+    if (list.status !== 0) {
+        return failed("claude-code", list, "Run `claude plugin marketplace list --json` to inspect the Claude Code plugin configuration, then retry.");
+    }
+    const marketplace = claudeMarketplace(parseJson(list.stdout));
+    const currentRoot = marketplace.root ? resolve(marketplace.root) : undefined;
+    if (marketplace.exists && currentRoot && currentRoot !== packageRoot && !force) {
+        return {
+            client: "claude-code",
+            status: "failed",
+            message: `The ${marketplaceName} marketplace already points to ${currentRoot}.`,
+            nextStep: "Run `dw agents install claude-code --force` to replace the stale marketplace registration.",
+        };
+    }
+    if (marketplace.exists && force) {
+        const remove = run("claude", ["plugin", "marketplace", "remove", marketplaceName]);
+        if (remove.status !== 0) {
+            return failed("claude-code", remove, "Run `claude plugin marketplace list --json` to inspect the conflicting registration.");
+        }
+    }
+    if (!marketplace.exists || force) {
+        const addMarketplace = run("claude", ["plugin", "marketplace", "add", packageRoot]);
+        if (addMarketplace.status !== 0) {
+            return failed("claude-code", addMarketplace, `Run \`claude plugin marketplace add ${packageRoot}\`, then retry.`);
+        }
+    }
+    const before = run("claude", ["plugin", "list", "--json"]);
+    const alreadyInstalled = before.status === 0 && pluginIsInstalled("claude-code", parseJson(before.stdout));
+    const action = alreadyInstalled ? "update" : "install";
+    const install = run("claude", ["plugin", action, pluginId, "--scope", "user"]);
+    if (install.status !== 0) {
+        return failed("claude-code", install, `Run \`claude plugin ${action} ${pluginId} --scope user\`, then retry.`);
+    }
+    return {
+        client: "claude-code",
+        status: alreadyInstalled ? "updated" : "installed",
+        message: "The Dataworks skill and query_metrics MCP server are enabled.",
+        nextStep: "Run `/reload-plugins` in Claude Code, or start a new session.",
+    };
+}
+export function installAgentIntegration(client, options = {}) {
+    const resolved = {
+        force: options.force ?? false,
+        packageRoot: resolve(options.packageRoot ?? dataworksPackageRoot()),
+        run: options.run ?? defaultRunner,
+    };
+    const binary = executable(client);
+    const detected = resolved.run(binary, ["--version"]);
+    if (detected.status !== 0 || detected.error)
+        return unavailable(client);
+    return client === "codex" ? installCodex(resolved) : installClaudeCode(resolved);
+}
+//# sourceMappingURL=agent-install.js.map

package/dist/lib/agent-install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-install.js","sourceRoot":"","sources":["../../src/lib/agent-install.ts"],"names":[],"mappings":"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"}

package/dist/lib/agent-reminder.d.ts

@@ -0,0 +1,17 @@
+export interface AgentReminderPreferences {
+    disabled: boolean;
+    configured: boolean;
+    lastShownAt?: string;
+}
+export interface AgentReminderContext {
+    argv: readonly string[];
+    isTTY: boolean;
+    now?: Date;
+    disabledByEnvironment?: boolean;
+}
+export declare function agentReminderPath(): string;
+export declare function readAgentReminderPreferences(): Promise<AgentReminderPreferences>;
+export declare function shouldShowAgentReminder(preferences: AgentReminderPreferences, context: AgentReminderContext): boolean;
+export declare function maybeShowAgentReminder(argv: readonly string[]): Promise<void>;
+export declare function configureAgentReminder(action: "disable" | "enable" | "configured"): Promise<AgentReminderPreferences>;
+//# sourceMappingURL=agent-reminder.d.ts.map

package/dist/lib/agent-reminder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-reminder.d.ts","sourceRoot":"","sources":["../../src/lib/agent-reminder.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,OAAO,CAAC;IAClB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,IAAI,CAAC;IACX,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAOD,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,wBAAsB,4BAA4B,IAAI,OAAO,CAAC,wBAAwB,CAAC,CAetF;AAYD,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,wBAAwB,EACrC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAUT;AAED,wBAAsB,sBAAsB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBnF;AAED,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,SAAS,GAAG,QAAQ,GAAG,YAAY,GAC1C,OAAO,CAAC,wBAAwB,CAAC,CAUnC"}