datagrok-tools 6.7.7 → 6.7.8

package/.devcontainer/PACKAGES_DEV.md

@@ -66,7 +66,7 @@ Host machine
 │  │    │       └── <folder>/     ← bind mount of user's repo   │  │
 │  │    ├── /var/run/docker.sock  ← host Docker for stand mgmt  │  │
 │  │    ├── entrypoint.sh         ← bind-mounted from tools/    │  │
-│  │    ├── Claude Code + MCP plugins (Jira, GitHub)            │  │
+│  │    ├── Claude Code + MCP plugins (GitHub, Jira)            │  │
 │  │    ├── Playwright + Chrome for testing                     │  │
 │  │    └── grok CLI for build/publish/test                     │  │
 │  └────────────────────────────────────────────────────────────┘  │
@@ -197,15 +197,25 @@ Based on `node:22-bookworm-slim`. Pre-installed:
 
 Runs as **root** in compose (entrypoint drops to `node` user for the main process).
 
-## MCP plugins: Jira and GitHub
+## MCP plugins: GitHub and Jira
 
 The agent uses MCP plugins to search for similar issues, read context, and update
-status. Set tokens in `.env` or the agent will ask interactively on first use.
+status. Tickets are GitHub issues (`datagrok-ai/public`); Jira holds only read-only
+`GROK-NNNNN` history. Set tokens in `.env` or the agent will ask interactively on first use.
 
-### Jira (Atlassian)
+### GitHub
 
 ```bash
 # Inside tools-dev, register the MCP server:
+claude mcp add github -s user -- \
+  npx -y @modelcontextprotocol/server-github
+```
+
+Requires `GITHUB_TOKEN` in the environment (already passed from `.env`).
+
+### Jira (optional, read-only history)
+
+```bash
 claude mcp add mcp-atlassian -s user -- \
   npx -y mcp-atlassian \
   --jira-url "$JIRA_URL" \
@@ -213,15 +223,6 @@ claude mcp add mcp-atlassian -s user -- \
   --jira-token "$JIRA_TOKEN"
 ```
 
-### GitHub
-
-```bash
-claude mcp add github -s user -- \
-  npx -y @modelcontextprotocol/server-github
-```
-
-Requires `GITHUB_TOKEN` in the environment (already passed from `.env`).
-
 ## Testing
 
 ### grok test (Puppeteer-based)

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> datagrok-tools@6.7.7 build /home/runner/work/public/public/tools
+> datagrok-tools@6.7.8 build /home/runner/work/public/public/tools
 > node build.js
 
 Successfully compiled 51 files with Babel.

package/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Datagrok-tools changelog
 
+## 6.7.8 (2026-10-13)
+
+* Fixed `grok api` (and every command other than `grok s`) exiting with code 1 and its usage text in 6.7.7: the new `--send-email` flag reached every command as `send-email: false`, which `grok api` rejected as an unknown option
+
 ## 6.7.7 (2026-10-09)
 
 * GROK-21156: `grok s users invite [<email>] [--prefix <P>] [--send-email]`: invites a user and prints a link that logs them in (no email sent; the email may be omitted); `--prefix` starts the code with `<P>`; `--send-email` mails the invitation instead

package/CLAUDE.md

@@ -220,7 +220,7 @@ Based on `node:22-bookworm-slim`. Pre-installed:
 | `demo` | + world, test_db, northwind |
 | `full` | + grok_spawner, JKG, demo DBs |
 
-See `.devcontainer/PACKAGES_DEV.md` for detailed usage docs, architecture diagram, MCP plugin setup (Jira/GitHub), and troubleshooting.
+See `.devcontainer/PACKAGES_DEV.md` for detailed usage docs, architecture diagram, MCP plugin setup (GitHub/Jira), and troubleshooting.
 
 ### `grok server` / `grok s` Command
 

package/GROK_S.md

@@ -626,9 +626,12 @@ entities shared with that account, and the target's own users never get their co
 
 ```bash
 grok s pull --since 10y --type project,connection,query,script,group,layout   --out ./bundle --host dev --admin
-grok s push ./bundle --host prod --admin --on-conflict skip
+grok s push ./bundle --host prod --admin --on-conflict adopt
 ```
 
+`adopt` keeps one copy of what both instances already have, such as shared groups and spaces;
+`skip` would leave them alone and fail everything in the bundle that points at them.
+
 **Move a whole instance one space at a time.** Placement is exclusive on the server — one project
 holding an entity takes it from every other — so a single bundle carrying every space has its
 projects competing, and a stand-sized push spends its time taking rows back off each other. Scoped

package/README.md

@@ -106,7 +106,8 @@ For more information on configuring connections, refer to the [Connections](http
   `config.yaml`): `grok report fetch <instance> <number>` downloads the report zip, `grok report read
   <zip|json|instance number>` prints one normalized JSON object (flags `--extract-screenshot`,
   `--extract-d42`, `--extract-client-log`), `grok report resolve <instance> <number>` marks it resolved.
-  `ticket`, `comment`, `label`, `attach` talk to JIRA with `JIRA_TOKEN`. See `grok report --help`.
+  `ticket`, `comment`, `label`, `attach` talk to JIRA with `JIRA_TOKEN`; porting them to GitHub Issues
+  is pending. See `grok report --help`.
 - `check` checks package content (function signatures, import statements of external modules,
   etc.). The check is also run during package publication.
 - `init` modifies a package template by adding config files for linters, IDE, and so on

package/bin/grok.js

@@ -1,7 +1,10 @@
 #!/usr/bin/env node
+// minimist sets every boolean option to false when it is absent, and commands such as `grok api`
+// reject any key they do not expect — so each boolean reaches only the commands that read it.
+const commandBooleans = {dartium: ['test', 'stresstest'], 'send-email': ['server', 's']};
 const argv = require('minimist')(process.argv.slice(2), {
   alias: {k: 'key', h: 'help', r: 'recursive'},
-  boolean: ['dartium', 'send-email'],
+  boolean: Object.keys(commandBooleans),
   // keep versions verbatim — minimist would coerce '1.10' to the number 1.1
   string: ['version', 'prefix'],
 });
@@ -59,8 +62,9 @@ function printUsage(command) {
 }
 
 const command = argv['_'][0];
-if (command !== 'test' && command !== 'stresstest')
-  delete argv.dartium;
+for (const [flag, owners] of Object.entries(commandBooleans))
+  if (!owners.includes(command))
+    delete argv[flag];
 if (command in commands) {
   try {
     if (argv['help']) {

package/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "https://github.com/datagrok-ai/public.git"
   },
-  "version": "6.7.7",
+  "version": "6.7.8",
   "description": "Utility to upload and publish packages to Datagrok",
   "homepage": "https://github.com/datagrok-ai/public/tree/master/tools#readme",
   "dependencies": {
@@ -90,7 +90,7 @@
     "update:ivp-parser": "esbuild plugins/ivp-parser.entry.mjs --bundle --format=cjs --platform=node --alias:diff-grok=../libraries/compute-utils/node_modules/diff-grok --outfile=plugins/ivp-parser.bundle.cjs",
     "debug-source-map": "node build.js --source-maps",
     "test": "vitest run --project unit",
-    "test:server": "vitest run --project unit bin/__tests__/node-dapi bin/__tests__/server bin/__tests__/migrate bin/__tests__/keypair",
+    "test:server": "vitest run --project unit bin/__tests__/node-dapi bin/__tests__/server bin/__tests__/migrate bin/__tests__/keypair bin/__tests__/grok-cli",
     "test:watch": "vitest --project unit",
     "test:integration": "vitest run --project integration",
     "test:all": "vitest run"