@guckdev/cli 0.1.0

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,228 @@
+#!/usr/bin/env node
+import { randomUUID } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { spawn } from "node:child_process";
+import { loadConfig, resolveStoreDir, getDefaultConfig, findRepoRoot, resolveCheckpointPath, redactEvent, appendEvent, } from "@guckdev/core";
+import { emit } from "@guckdev/sdk";
+import { startMcpServer } from "@guckdev/mcp";
+const printHelp = () => {
+    console.log(`Guck - MCP-first telemetry\n\nCommands:\n  init                 Create .guck.json and .guck.local.json\n  checkpoint           Write a .guck-checkpoint epoch timestamp\n  wrap --service <s> --session <id> -- <cmd...>\n                       Capture stdout/stderr and write JSONL\n  emit --service <s> --session <id>\n                       Read JSON events from stdin and append\n  mcp                  Start MCP server\n`);
+};
+const parseArgs = (argv) => {
+    const args = [...argv];
+    const opts = {};
+    const rest = [];
+    while (args.length > 0) {
+        const next = args.shift();
+        if (!next) {
+            break;
+        }
+        if (next === "--") {
+            rest.push(...args);
+            break;
+        }
+        if (next.startsWith("--")) {
+            const key = next.slice(2);
+            const value = args.shift();
+            if (!value) {
+                throw new Error(`Missing value for --${key}`);
+            }
+            opts[key] = value;
+            continue;
+        }
+        rest.push(next);
+    }
+    return { opts, rest };
+};
+const writeInitFiles = (rootDir) => {
+    const configPath = path.join(rootDir, ".guck.json");
+    const defaultConfig = getDefaultConfig();
+    const repoName = path.basename(rootDir);
+    const seededConfig = {
+        ...defaultConfig,
+        default_service: repoName || defaultConfig.default_service,
+    };
+    if (!fs.existsSync(configPath)) {
+        fs.writeFileSync(configPath, JSON.stringify(seededConfig, null, 2));
+        console.log(`Created ${configPath}`);
+    }
+    else {
+        console.log(`Config already exists: ${configPath}`);
+    }
+};
+const toLevel = (type) => type === "stderr" ? "error" : "info";
+const buildEvent = (type, message, base) => {
+    return {
+        id: randomUUID(),
+        ts: new Date().toISOString(),
+        level: toLevel(type),
+        type,
+        service: base.service,
+        run_id: base.run_id,
+        session_id: base.session_id,
+        message,
+        source: { kind: type },
+    };
+};
+const captureStream = (stream, type, base, storeDir, config, forward) => {
+    let buffer = "";
+    stream.on("data", (chunk) => {
+        const text = chunk.toString();
+        forward.write(chunk);
+        buffer += text;
+        const lines = buffer.split(/\r?\n/);
+        buffer = lines.pop() ?? "";
+        for (const line of lines) {
+            if (line.trim().length === 0) {
+                continue;
+            }
+            const event = buildEvent(type, line, base);
+            const redacted = redactEvent(config, event);
+            void appendEvent(storeDir, redacted);
+        }
+    });
+    stream.on("end", () => {
+        if (buffer.trim().length > 0) {
+            const event = buildEvent(type, buffer, base);
+            const redacted = redactEvent(config, event);
+            void appendEvent(storeDir, redacted);
+        }
+    });
+};
+const handleWrap = async (argv) => {
+    const { opts, rest } = parseArgs(argv);
+    if (rest.length === 0 || !rest[0]) {
+        console.error("wrap requires a command after --");
+        return 1;
+    }
+    const { config, rootDir } = loadConfig();
+    if (!config.enabled) {
+        console.log("Guck disabled via config/env; running command without capture.");
+        const child = spawn(rest[0], rest.slice(1), { stdio: "inherit" });
+        return new Promise((resolve) => {
+            child.on("exit", (code) => resolve(code ?? 0));
+        });
+    }
+    const runId = process.env.GUCK_RUN_ID ?? randomUUID();
+    const service = opts.service ?? config.default_service;
+    const session = opts.session ?? process.env.GUCK_SESSION_ID;
+    const storeDir = resolveStoreDir(config, rootDir);
+    const child = spawn(rest[0], rest.slice(1), {
+        stdio: ["inherit", "pipe", "pipe"],
+        env: {
+            ...process.env,
+            GUCK_RUN_ID: runId,
+            GUCK_SERVICE: service,
+            GUCK_WRAPPED: "1",
+            ...(session ? { GUCK_SESSION_ID: session } : {}),
+        },
+    });
+    const base = { service, run_id: runId, session_id: session };
+    if (child.stdout) {
+        captureStream(child.stdout, "stdout", base, storeDir, config, process.stdout);
+    }
+    if (child.stderr) {
+        captureStream(child.stderr, "stderr", base, storeDir, config, process.stderr);
+    }
+    return new Promise((resolve) => {
+        child.on("exit", (code) => resolve(code ?? 0));
+    });
+};
+const parseJsonInput = (input) => {
+    const trimmed = input.trim();
+    if (!trimmed) {
+        return [];
+    }
+    try {
+        const parsed = JSON.parse(trimmed);
+        if (Array.isArray(parsed)) {
+            return parsed;
+        }
+        return [parsed];
+    }
+    catch {
+        const lines = trimmed.split(/\r?\n/).filter(Boolean);
+        const items = [];
+        for (const line of lines) {
+            items.push(JSON.parse(line));
+        }
+        return items;
+    }
+};
+const handleEmit = async (argv) => {
+    const { opts } = parseArgs(argv);
+    const input = await new Promise((resolve) => {
+        let buffer = "";
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (chunk) => {
+            buffer += chunk;
+        });
+        process.stdin.on("end", () => resolve(buffer));
+    });
+    let items = [];
+    try {
+        items = parseJsonInput(input);
+    }
+    catch (error) {
+        console.error("Failed to parse JSON input", error);
+        return 1;
+    }
+    for (const item of items) {
+        if (item && typeof item === "object") {
+            const event = item;
+            if (opts.service && !event.service) {
+                event.service = opts.service;
+            }
+            if (opts.session && !event.session_id) {
+                event.session_id = opts.session;
+            }
+            await emit(event);
+        }
+    }
+    return 0;
+};
+const main = async () => {
+    const argv = process.argv.slice(2);
+    const command = argv[0];
+    if (!command || command === "help" || command === "--help" || command === "-h") {
+        printHelp();
+        return;
+    }
+    if (command === "init") {
+        const root = findRepoRoot(process.cwd());
+        writeInitFiles(root);
+        return;
+    }
+    if (command === "wrap") {
+        const exitCode = await handleWrap(argv.slice(1));
+        process.exitCode = exitCode;
+        return;
+    }
+    if (command === "emit") {
+        const exitCode = await handleEmit(argv.slice(1));
+        process.exitCode = exitCode;
+        return;
+    }
+    if (command === "checkpoint") {
+        const { rootDir, config } = loadConfig();
+        const storeDir = resolveStoreDir(config, rootDir);
+        const checkpointPath = resolveCheckpointPath(storeDir);
+        const value = Date.now();
+        fs.writeFileSync(checkpointPath, `${value}\n`, "utf8");
+        process.stdout.write(`${value}\n`);
+        return;
+    }
+    if (command === "mcp") {
+        await startMcpServer();
+        return;
+    }
+    console.error(`Unknown command: ${command}`);
+    printHelp();
+    process.exitCode = 1;
+};
+main().catch((error) => {
+    console.error(error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@guckdev/cli",
+  "version": "0.1.0",
+  "description": "CLI for Guck telemetry capture and MCP",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "guck": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "scripts",
+    "src",
+    "tsconfig.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "node scripts/ensure-deps.mjs && tsc -p tsconfig.json",
+    "build:watch": "tsc -p tsconfig.json --watch",
+    "dev": "node --watch dist/cli.js",
+    "prepare": "pnpm run build",
+    "test": "pnpm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@guckdev/sdk": "workspace:*",
+    "@guckdev/core": "workspace:*",
+    "@guckdev/mcp": "workspace:*"
+  },
+  "devDependencies": {
+    "@types/node": "25.2.2"
+  }
+}

package/scripts/ensure-deps.mjs

@@ -0,0 +1,30 @@
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { spawnSync } from "node:child_process";
+
+const deps = [
+  { name: "@guckdev/core", entry: "dist/index.js" },
+  { name: "@guckdev/sdk", entry: "dist/index.js" },
+  { name: "@guckdev/mcp", entry: "dist/index.js" },
+];
+
+const npmExecPath = process.env.npm_execpath;
+const run = (cwd, args) => {
+  const cmd = npmExecPath ? process.execPath : "pnpm";
+  const cmdArgs = npmExecPath ? [npmExecPath, ...args] : args;
+  const result = spawnSync(cmd, cmdArgs, { cwd, stdio: "inherit" });
+  if (result.status !== 0) {
+    process.exit(result.status ?? 1);
+  }
+};
+
+for (const dep of deps) {
+  const depDir = path.join(process.cwd(), "node_modules", dep.name);
+  if (!existsSync(depDir)) {
+    continue;
+  }
+  const entryPath = path.join(depDir, dep.entry);
+  if (!existsSync(entryPath)) {
+    run(depDir, ["run", "build"]);
+  }
+}

package/src/cli.ts

@@ -0,0 +1,272 @@
+#!/usr/bin/env node
+import { randomUUID } from "node:crypto";
+import fs from "node:fs";
+import path from "node:path";
+import { spawn } from "node:child_process";
+import {
+  loadConfig,
+  resolveStoreDir,
+  getDefaultConfig,
+  findRepoRoot,
+  resolveCheckpointPath,
+  redactEvent,
+  appendEvent,
+} from "@guckdev/core";
+import { GuckEvent, GuckLevel } from "@guckdev/core";
+import { emit } from "@guckdev/sdk";
+import { startMcpServer } from "@guckdev/mcp";
+
+const printHelp = (): void => {
+  console.log(`Guck - MCP-first telemetry\n\nCommands:\n  init                 Create .guck.json and .guck.local.json\n  checkpoint           Write a .guck-checkpoint epoch timestamp\n  wrap --service <s> --session <id> -- <cmd...>\n                       Capture stdout/stderr and write JSONL\n  emit --service <s> --session <id>\n                       Read JSON events from stdin and append\n  mcp                  Start MCP server\n`);
+};
+
+const parseArgs = (argv: string[]) => {
+  const args = [...argv];
+  const opts: Record<string, string> = {};
+  const rest: string[] = [];
+  while (args.length > 0) {
+    const next = args.shift();
+    if (!next) {
+      break;
+    }
+    if (next === "--") {
+      rest.push(...args);
+      break;
+    }
+    if (next.startsWith("--")) {
+      const key = next.slice(2);
+      const value = args.shift();
+      if (!value) {
+        throw new Error(`Missing value for --${key}`);
+      }
+      opts[key] = value;
+      continue;
+    }
+    rest.push(next);
+  }
+  return { opts, rest };
+};
+
+const writeInitFiles = (rootDir: string): void => {
+  const configPath = path.join(rootDir, ".guck.json");
+  const defaultConfig = getDefaultConfig();
+  const repoName = path.basename(rootDir);
+  const seededConfig = {
+    ...defaultConfig,
+    default_service: repoName || defaultConfig.default_service,
+  };
+
+  if (!fs.existsSync(configPath)) {
+    fs.writeFileSync(configPath, JSON.stringify(seededConfig, null, 2));
+    console.log(`Created ${configPath}`);
+  } else {
+    console.log(`Config already exists: ${configPath}`);
+  }
+};
+
+const toLevel = (type: "stdout" | "stderr"): GuckLevel =>
+  type === "stderr" ? "error" : "info";
+
+const buildEvent = (
+  type: "stdout" | "stderr",
+  message: string,
+  base: Pick<GuckEvent, "service" | "run_id" | "session_id">,
+): GuckEvent => {
+  return {
+    id: randomUUID(),
+    ts: new Date().toISOString(),
+    level: toLevel(type),
+    type,
+    service: base.service,
+    run_id: base.run_id,
+    session_id: base.session_id,
+    message,
+    source: { kind: type },
+  };
+};
+
+const captureStream = (
+  stream: NodeJS.ReadableStream,
+  type: "stdout" | "stderr",
+  base: Pick<GuckEvent, "service" | "run_id" | "session_id">,
+  storeDir: string,
+  config: ReturnType<typeof loadConfig>["config"],
+  forward: NodeJS.WriteStream,
+) => {
+  let buffer = "";
+  stream.on("data", (chunk: Buffer) => {
+    const text = chunk.toString();
+    forward.write(chunk);
+    buffer += text;
+    const lines = buffer.split(/\r?\n/);
+    buffer = lines.pop() ?? "";
+    for (const line of lines) {
+      if (line.trim().length === 0) {
+        continue;
+      }
+      const event = buildEvent(type, line, base);
+      const redacted = redactEvent(config, event);
+      void appendEvent(storeDir, redacted);
+    }
+  });
+  stream.on("end", () => {
+    if (buffer.trim().length > 0) {
+      const event = buildEvent(type, buffer, base);
+      const redacted = redactEvent(config, event);
+      void appendEvent(storeDir, redacted);
+    }
+  });
+};
+
+const handleWrap = async (argv: string[]): Promise<number> => {
+  const { opts, rest } = parseArgs(argv);
+  if (rest.length === 0 || !rest[0]) {
+    console.error("wrap requires a command after --");
+    return 1;
+  }
+
+  const { config, rootDir } = loadConfig();
+  if (!config.enabled) {
+    console.log("Guck disabled via config/env; running command without capture.");
+    const child = spawn(rest[0], rest.slice(1), { stdio: "inherit" });
+    return new Promise((resolve) => {
+      child.on("exit", (code: number | null) => resolve(code ?? 0));
+    });
+  }
+
+  const runId = process.env.GUCK_RUN_ID ?? randomUUID();
+  const service = opts.service ?? config.default_service;
+  const session = opts.session ?? process.env.GUCK_SESSION_ID;
+  const storeDir = resolveStoreDir(config, rootDir);
+
+  const child = spawn(rest[0], rest.slice(1), {
+    stdio: ["inherit", "pipe", "pipe"],
+    env: {
+      ...process.env,
+      GUCK_RUN_ID: runId,
+      GUCK_SERVICE: service,
+      GUCK_WRAPPED: "1",
+      ...(session ? { GUCK_SESSION_ID: session } : {}),
+    },
+  });
+
+  const base = { service, run_id: runId, session_id: session };
+  if (child.stdout) {
+    captureStream(child.stdout, "stdout", base, storeDir, config, process.stdout);
+  }
+  if (child.stderr) {
+    captureStream(child.stderr, "stderr", base, storeDir, config, process.stderr);
+  }
+
+  return new Promise((resolve) => {
+    child.on("exit", (code: number | null) => resolve(code ?? 0));
+  });
+};
+
+const parseJsonInput = (input: string): unknown[] => {
+  const trimmed = input.trim();
+  if (!trimmed) {
+    return [];
+  }
+  try {
+    const parsed = JSON.parse(trimmed);
+    if (Array.isArray(parsed)) {
+      return parsed;
+    }
+    return [parsed];
+  } catch {
+    const lines = trimmed.split(/\r?\n/).filter(Boolean);
+    const items: unknown[] = [];
+    for (const line of lines) {
+      items.push(JSON.parse(line));
+    }
+    return items;
+  }
+};
+
+const handleEmit = async (argv: string[]): Promise<number> => {
+  const { opts } = parseArgs(argv);
+  const input = await new Promise<string>((resolve) => {
+    let buffer = "";
+    process.stdin.setEncoding("utf8");
+    process.stdin.on("data", (chunk: string) => {
+      buffer += chunk;
+    });
+    process.stdin.on("end", () => resolve(buffer));
+  });
+
+  let items: unknown[] = [];
+  try {
+    items = parseJsonInput(input);
+  } catch (error) {
+    console.error("Failed to parse JSON input", error);
+    return 1;
+  }
+
+  for (const item of items) {
+    if (item && typeof item === "object") {
+      const event = item as Partial<GuckEvent>;
+      if (opts.service && !event.service) {
+        event.service = opts.service;
+      }
+      if (opts.session && !event.session_id) {
+        event.session_id = opts.session;
+      }
+      await emit(event);
+    }
+  }
+
+  return 0;
+};
+
+const main = async (): Promise<void> => {
+  const argv = process.argv.slice(2);
+  const command = argv[0];
+
+  if (!command || command === "help" || command === "--help" || command === "-h") {
+    printHelp();
+    return;
+  }
+
+  if (command === "init") {
+    const root = findRepoRoot(process.cwd());
+    writeInitFiles(root);
+    return;
+  }
+
+  if (command === "wrap") {
+    const exitCode = await handleWrap(argv.slice(1));
+    process.exitCode = exitCode;
+    return;
+  }
+
+  if (command === "emit") {
+    const exitCode = await handleEmit(argv.slice(1));
+    process.exitCode = exitCode;
+    return;
+  }
+
+  if (command === "checkpoint") {
+    const { rootDir, config } = loadConfig();
+    const storeDir = resolveStoreDir(config, rootDir);
+    const checkpointPath = resolveCheckpointPath(storeDir);
+    const value = Date.now();
+    fs.writeFileSync(checkpointPath, `${value}\n`, "utf8");
+    process.stdout.write(`${value}\n`);
+    return;
+  }
+
+  if (command === "mcp") {
+    await startMcpServer();
+    return;
+  }
+
+  console.error(`Unknown command: ${command}`);
+  printHelp();
+  process.exitCode = 1;
+};
+
+main().catch((error) => {
+  console.error(error);
+  process.exitCode = 1;
+});

package/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "rootDir": "src",
+    "outDir": "dist",
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true,
+    "strict": true,
+    "noUncheckedIndexedAccess": true,
+    "esModuleInterop": true,
+    "forceConsistentCasingInFileNames": true,
+    "skipLibCheck": true,
+    "types": ["node"]
+  },
+  "include": ["src/**/*.ts"]
+}