@indigoai-us/hq-cli 5.325.0 → 5.326.0

package/dist/lib/mcp/tools.js

@@ -0,0 +1,82 @@
+/**
+ * Tool surface of `hq mcp serve` (hq-anywhere US-011).
+ *
+ * The hq-mcp tools come from src/lib/mcp/hq-mcp-tools.generated.ts, which
+ * scripts/generate-hq-mcp-tools.mjs builds from repos/public/hq-mcp. The four
+ * daemon-native tools are defined here. Names use underscores because
+ * Anthropic and OpenAI tool names reject dots (hq.resolve_company is exposed
+ * as hq_resolve_company).
+ *
+ * hqd answers every one of these through the `mcp.call` op, so a subagent
+ * without MCP can call the same tool with
+ * `hq daemon call mcp.call --json '{"name":"hq_journal_append","arguments":{...}}'`.
+ */
+import { HQ_MCP_TOOLS } from "./hq-mcp-tools.generated.js";
+import { HOSTED_SEARCH_FETCH_TOOLS } from "./hosted-search-tools.js";
+const companyProp = { type: "string", description: "Company slug. Defaults to the company linked to cwd." };
+const cwdProp = { type: "string", description: "Directory to resolve the company from. Defaults to the server's working directory." };
+export const HQD_NATIVE_TOOLS = [
+    {
+        name: "hq_resolve_company",
+        description: "Returns the HQ company linked to a directory (registry from `hq link`), with the matched repo path.",
+        inputSchema: { type: "object", properties: { cwd: cwdProp }, additionalProperties: false },
+    },
+    {
+        name: "hq_policy_check",
+        description: "Runs the HQ policy engine for a proposed tool call and returns allow/block plus any policy context to inject. Fails closed when the engine errors.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                tool: { type: "string", description: "Tool name the policy is checked for, e.g. Bash or Write" },
+                input: { type: "object", description: "The tool input, e.g. {\"command\": \"git push\"}" },
+                event: { type: "string", description: "Hook event, default PreToolUse" },
+                company: companyProp,
+                cwd: cwdProp,
+                sessionId: { type: "string" },
+            },
+            required: ["tool"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "hq_journal_append",
+        description: "Appends a line to a project's active HQ journal under a section heading.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                project: { type: "string", description: "Project slug under companies/<company>/projects" },
+                section: { type: "string", enum: ["decisions", "open", "findings", "rejected"], description: "Journal section" },
+                text: { type: "string", description: "The line to append" },
+                company: companyProp,
+                cwd: cwdProp,
+            },
+            required: ["project", "section", "text"],
+            additionalProperties: false,
+        },
+    },
+    {
+        name: "hq_run_worker",
+        description: "Dispatches an HQ worker skill through the /run command in a detached headless session. Returns the pid and log path; it does not wait for the worker to finish.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                worker: { type: "string", description: "Worker id from core/workers/registry.yaml or a company registry" },
+                skill: { type: "string", description: "Skill name on that worker" },
+                args: { type: "string", description: "Free-text arguments passed to the skill" },
+                company: companyProp,
+                cwd: cwdProp,
+            },
+            required: ["worker"],
+            additionalProperties: false,
+        },
+    },
+];
+export const HQD_NATIVE_TOOL_NAMES = new Set(HQD_NATIVE_TOOLS.map((t) => t.name));
+/** Every tool `hq mcp serve` lists: the four native tools, then the hq-mcp set. */
+export const HQ_MCP_HOSTED_TOOLS = [...HQ_MCP_TOOLS, ...HOSTED_SEARCH_FETCH_TOOLS];
+export const MCP_TOOLS = [
+    ...HQD_NATIVE_TOOLS,
+    ...HQ_MCP_HOSTED_TOOLS.filter((t) => !HQD_NATIVE_TOOL_NAMES.has(t.name)),
+];
+export const HQ_MCP_TOOL_NAMES = new Set(HQ_MCP_HOSTED_TOOLS.map((t) => t.name));
+//# sourceMappingURL=tools.js.map

package/dist/lib/mcp/types.d.ts

@@ -0,0 +1,6 @@
+export interface McpToolDefinition {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/mcp/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/utils/is-main-module.d.ts

@@ -0,0 +1,3 @@
+/** Compare executable and module paths after resolving npm-style symlinks. */
+export declare function isMainModule(moduleUrl: string, argvEntryPath?: string | undefined): boolean;
+//# sourceMappingURL=is-main-module.d.ts.map

package/dist/utils/is-main-module.js

@@ -0,0 +1,19 @@
+import { realpathSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+/** Compare executable and module paths after resolving npm-style symlinks. */
+export function isMainModule(moduleUrl, argvEntryPath = process.argv[1]) {
+    if (!argvEntryPath)
+        return false;
+    const modulePath = fileURLToPath(moduleUrl);
+    const invokedPath = path.resolve(argvEntryPath);
+    try {
+        return realpathSync(modulePath) === realpathSync(invokedPath);
+    }
+    catch {
+        // Direct invocation still works if path canonicalization is unavailable;
+        // an unresolved symlink does not get treated as the module entry point.
+        return modulePath === invokedPath;
+    }
+}
+//# sourceMappingURL=is-main-module.js.map

package/dist/utils/staged-npm-install.js

@@ -3,6 +3,7 @@ import { randomBytes } from "node:crypto";
 import os from "node:os";
 import path from "node:path";
 import { fileURLToPath } from "node:url";
+import { isMainModule } from "./is-main-module.js";
 const PACKAGE_NAME = "@indigoai-us/hq-cli";
 const RANDOM_HEX_BYTES = 6;
 function packageRoot(prefix, platform) {
@@ -239,7 +240,7 @@ export function activateStagedNpmPackage(prefix, stagePrefix, platform = process
             bestEffortRemove(backupPackage);
     }
 }
-if (process.argv[1] && path.resolve(process.argv[1]) === fileURLToPath(import.meta.url) && process.argv[2] === "--activate") {
+if (isMainModule(import.meta.url) && process.argv[2] === "--activate") {
     const [prefix, stagePrefix, platform] = process.argv.slice(3);
     if (!prefix || !stagePrefix) {
         console.error("usage: staged-npm-install.js --activate <prefix> <stage-prefix> [platform]");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@indigoai-us/hq-cli",
-  "version": "5.325.0",
+  "version": "5.326.0",
   "description": "HQ by Indigo management CLI — modules and cloud sync",
   "main": "dist/index.js",
   "bin": {
@@ -31,6 +31,7 @@
     "lint": "eslint .",
     "pretest": "node scripts/generate-dsn.mjs && node scripts/build-flag-registry-worker.mjs",
     "test": "vitest run",
+    "gen:hq-mcp-tools": "node scripts/generate-hq-mcp-tools.mjs",
     "test:db": "vitest run src/lib/db test/commands/db.test.ts test/commands/db-tenant-isolation.test.ts",
     "test:e2e": "vitest run --config vitest.e2e.config.ts",
     "coverage": "vitest run --coverage --coverage.reporter=text-summary --coverage.reporter=json-summary",
@@ -46,6 +47,7 @@
     "@aws-sdk/client-s3": "^3.1049.0",
     "@indigoai-us/hq-cloud": "~6.18.33",
     "@indigoai-us/hq-flags-client": "^0.1.2",
+    "@modelcontextprotocol/sdk": "1.29.0",
     "@sentry/node": "^10.49.0",
     "@tobilu/qmd": "2.5.3",
     "ajv": "^8.20.0",