@datagusto/cli 0.0.0-stage → 0.1.0

package/dist/adapters/claude-settings.js

@@ -0,0 +1,115 @@
+// ---------------------------------------------------------------------------
+// dg CLI - hook entries in ~/.claude/settings.json
+// ---------------------------------------------------------------------------
+//
+// The hooks the plugin declares in hooks/hooks.json are merged into the
+// user's settings, which is how Claude Code gets to run them. This file
+// belongs to the user, so (ADR-0003 TR-5):
+//
+//   - a file that isn't valid JSON is never rewritten
+//   - only entries whose command points into a dg-owned folder are added or
+//     removed; everything else is written back as it was read
+//   - a symlinked settings.json (dotfile managers) is written through, not
+//     replaced, and the file keeps its mode
+import { readFile, realpath, stat } from "node:fs/promises";
+import { dirname } from "node:path";
+import { ensureDir, writeFileAtomic } from "../fs/atomic.js";
+import { AdapterError } from "./types.js";
+export async function readSettings(path) {
+    let realPath;
+    try {
+        realPath = await realpath(path);
+    }
+    catch (err) {
+        if (err.code !== "ENOENT")
+            throw err;
+        return { path, realPath: path, exists: false, mode: 0o644, data: {} };
+    }
+    const raw = await readFile(realPath, "utf8");
+    let data = {};
+    if (raw.trim() !== "") {
+        try {
+            data = JSON.parse(raw);
+        }
+        catch {
+            throw new AdapterError(`${path} isn't valid JSON, so dg won't edit it. Fix the file (Claude Code's /doctor can help), then run this again.`);
+        }
+    }
+    if (typeof data !== "object" || data === null || Array.isArray(data)) {
+        throw new AdapterError(`${path} isn't a JSON object, so dg won't edit it. Fix the file, then run this again.`);
+    }
+    hooksOf(data, path); // validate the shape up front
+    return { path, realPath, exists: true, mode: (await stat(realPath)).mode & 0o777, data: data };
+}
+export async function writeSettings(file) {
+    // ~/.claude belongs to Claude Code; create it if needed but don't chmod it.
+    if (!file.exists)
+        await ensureDirLoose(dirname(file.realPath));
+    await writeFileAtomic(file.realPath, JSON.stringify(file.data, null, 2) + "\n", { mode: file.mode });
+}
+/** Remove every handler whose command `isOurs`; returns how many went. */
+export function removeHooks(file, isOurs) {
+    const hooks = hooksOf(file.data, file.path);
+    if (!hooks)
+        return 0;
+    let removed = 0;
+    for (const [event, groups] of Object.entries(hooks)) {
+        const kept = [];
+        for (const group of groups) {
+            const handlers = group.hooks.filter((h) => !(typeof h.command === "string" && isOurs(h.command)));
+            removed += group.hooks.length - handlers.length;
+            // Drop a group only if we emptied it; leave the user's own empty groups.
+            if (handlers.length > 0 || group.hooks.length === 0)
+                kept.push({ ...group, hooks: handlers });
+        }
+        if (kept.length > 0)
+            hooks[event] = kept;
+        else
+            delete hooks[event];
+    }
+    if (removed > 0 && Object.keys(hooks).length === 0)
+        delete file.data.hooks;
+    return removed;
+}
+/** Append `add`'s matcher groups after whatever each event already has. */
+export function addHooks(file, add) {
+    const hooks = hooksOf(file.data, file.path) ?? {};
+    for (const [event, groups] of Object.entries(add)) {
+        hooks[event] = [...(hooks[event] ?? []), ...groups];
+    }
+    file.data.hooks = hooks;
+}
+/** Events that have at least one handler whose command `isOurs`. */
+export function eventsWithHooks(file, isOurs) {
+    const hooks = hooksOf(file.data, file.path) ?? {};
+    return Object.keys(hooks).filter((event) => hooks[event].some((g) => g.hooks.some((h) => typeof h.command === "string" && isOurs(h.command))));
+}
+// -- Internal helpers ---------------------------------------------------------
+function hooksOf(data, path) {
+    const hooks = data.hooks;
+    if (hooks === undefined)
+        return undefined;
+    const bad = () => new AdapterError(`The "hooks" section of ${path} isn't in the format Claude Code expects, so dg won't edit it.`);
+    if (typeof hooks !== "object" || hooks === null || Array.isArray(hooks))
+        throw bad();
+    for (const groups of Object.values(hooks)) {
+        if (!Array.isArray(groups))
+            throw bad();
+        for (const g of groups) {
+            if (typeof g !== "object" || g === null || !Array.isArray(g.hooks))
+                throw bad();
+        }
+    }
+    return hooks;
+}
+async function ensureDirLoose(dir) {
+    try {
+        if ((await stat(dir)).isDirectory())
+            return;
+    }
+    catch {
+        // missing: create below
+    }
+    await ensureDir(dir, 0o755);
+}
+//# sourceMappingURL=claude-settings.js.map

package/dist/adapters/claude-settings.js.map

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

package/dist/adapters/index.d.ts

@@ -0,0 +1,10 @@
+import type { AdapterContext, AgentAdapter, AgentName } from "./types.js";
+/** The adapter for `agent`, or undefined if it isn't built yet. */
+export declare function getAdapter(agent: AgentName): AgentAdapter | undefined;
+export declare function notSupportedYet(agent: AgentName): string;
+export declare function adapterContext(cliVersion: string, workspace?: string): AdapterContext;
+/**
+ * `--workspace` (default: the current directory) as an absolute path with
+ * symlinks resolved, so the ledger has one entry per folder.
+ */
+export declare function resolveWorkspace(flag: string | undefined): Promise<string>;

package/dist/adapters/index.js

@@ -0,0 +1,37 @@
+import { realpath } from "node:fs/promises";
+import { homedir } from "node:os";
+import { resolve } from "node:path";
+import { defaultVendorDir } from "../vendor.js";
+import { ClaudeCodeAdapter } from "./claude-code.js";
+import { KiroAdapter } from "./kiro.js";
+/** The adapter for `agent`, or undefined if it isn't built yet. */
+export function getAdapter(agent) {
+    switch (agent) {
+        case "claude-code":
+            return new ClaudeCodeAdapter();
+        case "kiro":
+            return new KiroAdapter();
+        case "codex":
+            return undefined;
+    }
+}
+export function notSupportedYet(agent) {
+    return `Connecting ${agent} isn't supported yet; it's coming in a later release. Today dg can connect: claude-code, kiro.`;
+}
+export function adapterContext(cliVersion, workspace) {
+    return { homeDir: homedir(), workspace, cliVersion, vendorDir: defaultVendorDir(), env: process.env };
+}
+/**
+ * `--workspace` (default: the current directory) as an absolute path with
+ * symlinks resolved, so the ledger has one entry per folder.
+ */
+export async function resolveWorkspace(flag) {
+    const dir = resolve(flag ?? process.cwd());
+    try {
+        return await realpath(dir);
+    }
+    catch {
+        return dir; // missing: detect() explains
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/adapters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/adapters/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAGxC,mEAAmE;AACnE,MAAM,UAAU,UAAU,CAAC,KAAgB;IACzC,QAAQ,KAAK,EAAE,CAAC;QACd,KAAK,aAAa;YAChB,OAAO,IAAI,iBAAiB,EAAE,CAAC;QACjC,KAAK,MAAM;YACT,OAAO,IAAI,WAAW,EAAE,CAAC;QAC3B,KAAK,OAAO;YACV,OAAO,SAAS,CAAC;IACrB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,KAAgB;IAC9C,OAAO,cAAc,KAAK,gGAAgG,CAAC;AAC7H,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,UAAkB,EAAE,SAAkB;IACnE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,gBAAgB,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;AACxG,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAwB;IAC7D,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC3C,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC7B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,GAAG,CAAC,CAAC,6BAA6B;IAC3C,CAAC;AACH,CAAC"}

package/dist/adapters/kiro-agent.d.ts

@@ -0,0 +1,29 @@
+/** `hooks` in an agent config: event → hook entries. */
+export type AgentHooks = Record<string, AgentHook[]>;
+export interface AgentHook {
+    command?: unknown;
+    [key: string]: unknown;
+}
+export interface AgentFile {
+    /** The path as given. */
+    path: string;
+    /** Where writes go: the symlink target if `path` is a symlink. */
+    realPath: string;
+    exists: boolean;
+    mode: number;
+    /** sha256 of the file as read; undefined when it doesn't exist. */
+    hash?: string;
+    data: Record<string, unknown>;
+}
+export declare function hashText(text: string): string;
+export declare function serializeAgent(data: Record<string, unknown>): string;
+export declare function readAgentFile(path: string): Promise<AgentFile>;
+export declare function writeAgentFile(file: AgentFile, text: string): Promise<void>;
+/** Remove every entry whose command `isOurs`; returns how many went. */
+export declare function removeAgentHooks(data: Record<string, unknown>, isOurs: (command: string) => boolean, path?: string): number;
+/** Append `add`'s entries after whatever each event already has. */
+export declare function addAgentHooks(data: Record<string, unknown>, add: AgentHooks, path?: string): void;
+/** Events that have at least one entry whose command `isOurs`. */
+export declare function eventsWithAgentHooks(data: Record<string, unknown>, isOurs: (command: string) => boolean, path?: string): string[];
+/** The `hooks` of a config dg bundles; throws if it has none. */
+export declare function agentHooks(data: Record<string, unknown>, path: string): AgentHooks;

package/dist/adapters/kiro-agent.js

@@ -0,0 +1,124 @@
+// ---------------------------------------------------------------------------
+// dg CLI - hook entries in a Kiro agent config (.kiro/agents/kiro_default.json)
+// ---------------------------------------------------------------------------
+//
+// Kiro CLI's default engine doesn't read .kiro/hooks/. It takes hooks from
+// the config of the agent a session runs, and a workspace file named after
+// the built-in default agent takes that agent's place. So the plugin's hooks
+// go into <workspace>/.kiro/agents/kiro_default.json:
+//
+//   "hooks": { "preToolUse": [{ "command": "node dist/index.js", … }], … }
+//
+// When that file is already there it belongs to the user (ADR-0003 TR-5),
+// and is treated like Claude Code's settings.json (see claude-settings.ts):
+//
+//   - a file that isn't valid JSON is never rewritten
+//   - only entries that run the plugin's command are added or removed;
+//     everything else is written back as it was read
+//   - a symlinked file is written through, not replaced, and keeps its mode
+import { createHash } from "node:crypto";
+import { readFile, realpath, stat } from "node:fs/promises";
+import { writeFileAtomic } from "../fs/atomic.js";
+import { AdapterError } from "./types.js";
+export function hashText(text) {
+    return createHash("sha256").update(text, "utf8").digest("hex");
+}
+export function serializeAgent(data) {
+    return JSON.stringify(data, null, 2) + "\n";
+}
+export async function readAgentFile(path) {
+    let realPath;
+    try {
+        realPath = await realpath(path);
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === "ENOTDIR") {
+            throw new AdapterError(`${path} can't be created because one of its parent folders is a file. Move that file away, then run this again.`);
+        }
+        if (code !== "ENOENT")
+            throw err;
+        return { path, realPath: path, exists: false, mode: 0o644, data: {} };
+    }
+    const raw = await readFile(realPath, "utf8");
+    let data;
+    try {
+        data = JSON.parse(raw);
+    }
+    catch {
+        throw new AdapterError(`${path} isn't valid JSON, so dg won't edit it. Fix the file (\`kiro-cli agent validate --path ${path}\` shows what's wrong), then run this again.`);
+    }
+    if (typeof data !== "object" || data === null || Array.isArray(data)) {
+        throw new AdapterError(`${path} isn't a JSON object, so dg won't edit it. Fix the file, then run this again.`);
+    }
+    hooksOf(data, path); // validate the shape up front
+    return {
+        path,
+        realPath,
+        exists: true,
+        mode: (await stat(realPath)).mode & 0o777,
+        hash: hashText(raw),
+        data: data,
+    };
+}
+export async function writeAgentFile(file, text) {
+    await writeFileAtomic(file.realPath, text, { mode: file.mode });
+}
+/** Remove every entry whose command `isOurs`; returns how many went. */
+export function removeAgentHooks(data, isOurs, path = "") {
+    const hooks = hooksOf(data, path);
+    if (!hooks)
+        return 0;
+    let removed = 0;
+    for (const [event, entries] of Object.entries(hooks)) {
+        const kept = entries.filter((h) => !(typeof h.command === "string" && isOurs(h.command)));
+        removed += entries.length - kept.length;
+        // Drop an event only if we emptied it; leave the user's own empty lists.
+        if (kept.length > 0 || entries.length === 0)
+            hooks[event] = kept;
+        else
+            delete hooks[event];
+    }
+    if (removed > 0 && Object.keys(hooks).length === 0)
+        delete data.hooks;
+    return removed;
+}
+/** Append `add`'s entries after whatever each event already has. */
+export function addAgentHooks(data, add, path = "") {
+    const hooks = hooksOf(data, path) ?? {};
+    for (const [event, entries] of Object.entries(add)) {
+        hooks[event] = [...(hooks[event] ?? []), ...entries.map((e) => ({ ...e }))];
+    }
+    data.hooks = hooks;
+}
+/** Events that have at least one entry whose command `isOurs`. */
+export function eventsWithAgentHooks(data, isOurs, path = "") {
+    const hooks = hooksOf(data, path) ?? {};
+    return Object.keys(hooks).filter((event) => hooks[event].some((h) => typeof h.command === "string" && isOurs(h.command)));
+}
+/** The `hooks` of a config dg bundles; throws if it has none. */
+export function agentHooks(data, path) {
+    const hooks = hooksOf(data, path);
+    if (!hooks || Object.keys(hooks).length === 0)
+        throw new AdapterError(`${path} has no hooks.`);
+    return hooks;
+}
+// -- Internal helpers ---------------------------------------------------------
+function hooksOf(data, path) {
+    const hooks = data.hooks;
+    if (hooks === undefined)
+        return undefined;
+    const bad = () => new AdapterError(`The "hooks" section of ${path} isn't in the format Kiro expects, so dg won't edit it.`);
+    if (typeof hooks !== "object" || hooks === null || Array.isArray(hooks))
+        throw bad();
+    for (const entries of Object.values(hooks)) {
+        if (!Array.isArray(entries))
+            throw bad();
+        for (const e of entries) {
+            if (typeof e !== "object" || e === null || Array.isArray(e))
+                throw bad();
+        }
+    }
+    return hooks;
+}
+//# sourceMappingURL=kiro-agent.js.map

package/dist/adapters/kiro-agent.js.map

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

package/dist/adapters/kiro.d.ts

@@ -0,0 +1,24 @@
+import { type ApiResult, type WhoamiResponse } from "../api/client.js";
+import type { InstallRecord } from "../state/installs.js";
+import { type AdapterContext, type AgentAdapter, type ClearResult, type DetectResult, type DoctorReport, type InstallPlan, type PluginConnection } from "./types.js";
+export interface KiroAdapterDeps {
+    whoami?: (serverUrl: string, apiKey: string) => Promise<ApiResult<WhoamiResponse>>;
+    /** Whether git ignores `file` in `workspace`; undefined if that can't be told. */
+    gitIgnores?: (workspace: string, file: string, env: NodeJS.ProcessEnv) => Promise<boolean | undefined>;
+}
+export declare class KiroAdapter implements AgentAdapter {
+    readonly name: "kiro";
+    readonly displayName = "Kiro";
+    readonly perWorkspace = true;
+    private readonly whoami;
+    private readonly gitIgnores;
+    constructor(deps?: KiroAdapterDeps);
+    detect(ctx: AdapterContext): Promise<DetectResult>;
+    preflight(ctx: AdapterContext): Promise<void>;
+    plan(ctx: AdapterContext, _conn: PluginConnection): Promise<InstallPlan>;
+    apply(ctx: AdapterContext, _plan: InstallPlan, conn: PluginConnection): Promise<InstallRecord>;
+    clear(ctx: AdapterContext, record: InstallRecord): Promise<ClearResult>;
+    doctor(ctx: AdapterContext, record: InstallRecord): Promise<DoctorReport>;
+    installedServerUrl(ctx: AdapterContext): Promise<string | undefined>;
+    nextSteps(ctx: AdapterContext): string[];
+}