@dataworks-technology/cli 1.2.0 → 1.4.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    |
@@ -39,6 +40,12 @@ The `dw` binary turns the public GraphQL contract published by `@dataworks-techn
 - [Node.js](https://nodejs.org/) 22 or newer to run the published CLI
 - A Dataworks account
 - [Bun](https://bun.sh/) for repository development
+- For repository development only: AWS credentials with CodeArtifact read access.
+  `bun install` runs a `preinstall` hook that fetches a token for the private
+  `@dataworks/sdk` devDependency, which supplies the metric catalogue. Use
+  `AWS_PROFILE=your-profile-name bun install` for a non-default profile, and
+  `bun run sdk` to refresh an expired token. Installing the published CLI needs
+  none of this.
 
 ---
 
@@ -86,6 +93,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 +120,66 @@ 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, resolves metric names
+against the canonical Dataworks catalogue, 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.
+
+Metric wording is matched case-, space-, hyphen- and underscore-insensitively,
+so “Heart Rate” resolves to `heartrate`, alongside aliases such as `gps`, `hr`,
+and `watts`. An unrecognized name returns the closest canonical candidates
+rather than a bare rejection.
+
+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
@@ -206,6 +286,7 @@ an array; default table output performs that decoding for humans.
 | Command                         | Description                                                         |
 | ------------------------------- | ------------------------------------------------------------------- |
 | `bun install --frozen-lockfile` | Install development dependencies                                    |
+| `bun run sdk`                   | Refresh the CodeArtifact token used to fetch `@dataworks/sdk`       |
 | `bun run dev --help`            | Run the TypeScript development CLI                                  |
 | `bun run generate`              | Regenerate schema-derived commands and Markdown                     |
 | `bun run generate:check`        | Verify generated files are current                                  |
@@ -223,9 +304,11 @@ The Data Engine SDK publishes a filtered public GraphQL schema and a versioned c
 
 Files under `src/generated/`, `src/commands/data/`, and `docs/commands/` are generated. Change [`schema/operation-overrides.json`](./schema/operation-overrides.json), [`scripts/generate-commands.ts`](./scripts/generate-commands.ts), or the upstream public schema instead of editing generated files.
 
-The daily SDK maintenance workflow checks npm for a new `@dataworks-technology/data` version. Deterministic generation runs first; if compatibility work is required, a constrained LiteLLM maintenance agent prepares a draft pull request for human review.
+Canonical metric names are generated the same way. [`scripts/generate-metrics.ts`](./scripts/generate-metrics.ts) reads `metricConfig` from the private `@dataworks/sdk` devDependency and emits `src/generated/metrics.ts` and the catalogue block in the `query-dataworks-metrics` skill. To add a metric, change the SDK — not the generated files, and not the alias layer in `src/lib/metric-names.ts`.
+
+The daily SDK maintenance workflow checks for new `@dataworks-technology/data` and `@dataworks/sdk` versions. Deterministic generation runs first; if compatibility work is required, a constrained LiteLLM maintenance agent prepares a draft pull request for human review.
 
-See [architecture](./docs/architecture.md), [automated SDK maintenance](./docs/maintenance.md), [security](./docs/security.md), and [releasing](./docs/releasing.md) for details.
+See [architecture](./docs/architecture.md), [contributing](./docs/contributing.md), [automated SDK maintenance](./docs/maintenance.md), [security](./docs/security.md), and [releasing](./docs/releasing.md) for details.
 
 ---
 

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/generated/metrics.d.ts

@@ -0,0 +1,15 @@
+/** Metric categories accepted by the Data Explorer API. */
+export type MetricCategory = "METRICS_TYPE_A" | "METRICS_TYPE_B" | "METRICS_TYPE_C";
+/** Canonical metric names, grouped by Data Explorer category. */
+export declare const metricCategories: {
+    METRICS_TYPE_A: string[];
+    METRICS_TYPE_B: string[];
+    METRICS_TYPE_C: string[];
+};
+/** Human-readable label per canonical metric name. */
+export declare const metricLabels: Record<string, string>;
+/** Every canonical metric name, in catalogue order. */
+export declare const allMetricNames: readonly string[];
+/** Category lookup for a canonical metric name. */
+export declare const metricCategoryByName: Record<string, MetricCategory>;
+//# sourceMappingURL=metrics.d.ts.map

package/dist/generated/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../../src/generated/metrics.ts"],"names":[],"mappings":"AAGA,2DAA2D;AAC3D,MAAM,MAAM,cAAc,GAAG,gBAAgB,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAEpF,iEAAiE;AACjE,eAAO,MAAM,gBAAgB;;;;CA4CwB,CAAC;AAEtD,sDAAsD;AACtD,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAsC/C,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAA2C,CAAC;AAExF,mDAAmD;AACnD,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAsC/D,CAAC"}

package/dist/generated/metrics.js

@@ -0,0 +1,131 @@
+// Generated by scripts/generate-metrics.ts from @dataworks/sdk@3.5.0. Do not edit.
+// Canonical source: Dataworks-SDK/src/shared/metricConfig.ts
+/** Canonical metric names, grouped by Data Explorer category. */
+export const metricCategories = {
+    "METRICS_TYPE_A": [
+        "latlong",
+        "net-time",
+        "checkpoint-time",
+        "leg-time",
+        "sub-time",
+        "checkpoint",
+        "segment",
+        "distance",
+        "distance-swim",
+        "distance-bike",
+        "distance-run",
+        "lap",
+        "sector",
+        "status",
+        "is-drafting",
+        "total-drafting-seconds",
+        "heading-degrees",
+        "yoyo-count"
+    ],
+    "METRICS_TYPE_B": [
+        "speed",
+        "location-speed",
+        "altitude",
+        "cadence-cycling",
+        "cadence",
+        "active-energy-burned",
+        "horizontal-accuracy",
+        "gap-to-leader",
+        "gap-to-ahead",
+        "time-to-leader",
+        "rank",
+        "speed-bike",
+        "pace",
+        "pace-swim",
+        "pace-run"
+    ],
+    "METRICS_TYPE_C": [
+        "heartrate",
+        "power",
+        "power-cycling",
+        "pwr_instant"
+    ]
+};
+/** Human-readable label per canonical metric name. */
+export const metricLabels = {
+    "latlong": "GPS",
+    "net-time": "Net Time (s)",
+    "checkpoint-time": "Checkpoint Time (s)",
+    "leg-time": "Leg Time (s)",
+    "sub-time": "Sub Time (s)",
+    "checkpoint": "Checkpoint",
+    "segment": "Segment",
+    "distance": "Distance (km)",
+    "distance-swim": "Swim Distance (km)",
+    "distance-bike": "Bike Distance (km)",
+    "distance-run": "Run Distance (km)",
+    "lap": "Lap",
+    "sector": "Sector",
+    "status": "Status",
+    "is-drafting": "is-drafting",
+    "total-drafting-seconds": "total-drafting-seconds",
+    "heading-degrees": "heading-degrees",
+    "yoyo-count": "yoyo-count",
+    "speed": "Speed (km/h)",
+    "location-speed": "Location Speed",
+    "altitude": "Altitude",
+    "cadence-cycling": "Cadence (Cycling)",
+    "cadence": "Cadence",
+    "active-energy-burned": "Active Energy Burned",
+    "horizontal-accuracy": "Horizontal Accuracy",
+    "gap-to-leader": "gap-to-leader",
+    "gap-to-ahead": "gap-to-ahead",
+    "time-to-leader": "Time to Leader (s)",
+    "rank": "Rank",
+    "speed-bike": "Bike Speed (km/h)",
+    "pace": "Pace (sec/km)",
+    "pace-swim": "Swim Pace (sec/km)",
+    "pace-run": "Run Pace (sec/km)",
+    "heartrate": "Heart Rate",
+    "power": "Power",
+    "power-cycling": "Power (Cycling)",
+    "pwr_instant": "Power Instant"
+};
+/** Every canonical metric name, in catalogue order. */
+export const allMetricNames = Object.values(metricCategories).flat();
+/** Category lookup for a canonical metric name. */
+export const metricCategoryByName = {
+    "latlong": "METRICS_TYPE_A",
+    "net-time": "METRICS_TYPE_A",
+    "checkpoint-time": "METRICS_TYPE_A",
+    "leg-time": "METRICS_TYPE_A",
+    "sub-time": "METRICS_TYPE_A",
+    "checkpoint": "METRICS_TYPE_A",
+    "segment": "METRICS_TYPE_A",
+    "distance": "METRICS_TYPE_A",
+    "distance-swim": "METRICS_TYPE_A",
+    "distance-bike": "METRICS_TYPE_A",
+    "distance-run": "METRICS_TYPE_A",
+    "lap": "METRICS_TYPE_A",
+    "sector": "METRICS_TYPE_A",
+    "status": "METRICS_TYPE_A",
+    "is-drafting": "METRICS_TYPE_A",
+    "total-drafting-seconds": "METRICS_TYPE_A",
+    "heading-degrees": "METRICS_TYPE_A",
+    "yoyo-count": "METRICS_TYPE_A",
+    "speed": "METRICS_TYPE_B",
+    "location-speed": "METRICS_TYPE_B",
+    "altitude": "METRICS_TYPE_B",
+    "cadence-cycling": "METRICS_TYPE_B",
+    "cadence": "METRICS_TYPE_B",
+    "active-energy-burned": "METRICS_TYPE_B",
+    "horizontal-accuracy": "METRICS_TYPE_B",
+    "gap-to-leader": "METRICS_TYPE_B",
+    "gap-to-ahead": "METRICS_TYPE_B",
+    "time-to-leader": "METRICS_TYPE_B",
+    "rank": "METRICS_TYPE_B",
+    "speed-bike": "METRICS_TYPE_B",
+    "pace": "METRICS_TYPE_B",
+    "pace-swim": "METRICS_TYPE_B",
+    "pace-run": "METRICS_TYPE_B",
+    "heartrate": "METRICS_TYPE_C",
+    "power": "METRICS_TYPE_C",
+    "power-cycling": "METRICS_TYPE_C",
+    "pwr_instant": "METRICS_TYPE_C"
+};
+//# sourceMappingURL=metrics.js.map

package/dist/generated/metrics.js.map

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

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"}