@a5c-ai/git-a5c 1.0.2

package/README.md

@@ -0,0 +1,32 @@
+# @a5cforge/cli
+
+CLI for reading and writing a5cforge events.
+
+## Usage
+Installed as a `git` subcommand binary (`git-a5c`), so you can run:
+
+- `git a5c status`
+- `git a5c issue list`
+- `git a5c issue show <id>`
+- `git a5c pr list`
+- `git a5c pr show <prKey>`
+- `git a5c verify`
+- `git a5c journal`
+
+Common flags:
+- `--repo <path>`: override repo detection
+- `--treeish <ref>`: load snapshot from a commit/ref (default: `HEAD`)
+- `--inbox-ref <ref>`: include events from an inbox ref (repeatable)
+- `--json`: JSON output
+
+## Local install from this monorepo
+
+From the repo root:
+
+```bash
+pnpm -C packages/cli build
+pnpm -C packages/cli link --global
+git a5c help
+```
+
+

package/dist/args.d.ts

@@ -0,0 +1,39 @@
+export type ParsedArgs = {
+    flags: {
+        repo?: string;
+        treeish?: string;
+        json?: boolean;
+        inboxRefs?: string[];
+        since?: string;
+        limit?: number;
+        types?: string[];
+        entity?: string;
+        active?: boolean;
+        stageOnly?: boolean;
+        commit?: boolean;
+        message?: string;
+        title?: string;
+        body?: string;
+        id?: string;
+        commentId?: string;
+        reason?: string;
+        base?: string;
+        head?: string;
+        headRef?: string;
+        topic?: string;
+        by?: string;
+        op?: string;
+        agentId?: string;
+        ttlSeconds?: number;
+        task?: string;
+        env?: string;
+        rev?: string;
+        artifact?: string;
+        dispatchId?: string;
+        url?: string;
+        type?: string;
+    };
+    positionals: string[];
+};
+export declare function parseArgs(argv: string[]): ParsedArgs;
+//# sourceMappingURL=args.d.ts.map

package/dist/args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.d.ts","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,SAAS,CAAC,EAAE,OAAO,CAAC;QACpB,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,QAAQ,CAAC,EAAE,MAAM,CAAC;QAClB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,GAAG,CAAC,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,CAAC;IACF,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB,CAAC;AAEF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CA8CpD"}

package/dist/args.js

@@ -0,0 +1,79 @@
+export function parseArgs(argv) {
+    const args = [...argv];
+    const flags = {};
+    const positionals = [];
+    while (args.length) {
+        const a = args.shift();
+        if (a === "--repo")
+            flags.repo = args.shift();
+        else if (a === "--treeish")
+            flags.treeish = args.shift();
+        else if (a === "--json")
+            flags.json = true;
+        else if (a === "--inbox-ref") {
+            const v = args.shift();
+            flags.inboxRefs ??= [];
+            flags.inboxRefs.push(v);
+        }
+        else if (a === "--since")
+            flags.since = args.shift();
+        else if (a === "--limit")
+            flags.limit = Number(args.shift());
+        else if (a === "--types")
+            flags.types = args.shift().split(",").map((s) => s.trim()).filter(Boolean);
+        else if (a === "--entity")
+            flags.entity = args.shift();
+        else if (a === "--active")
+            flags.active = true;
+        else if (a === "--stage-only")
+            flags.stageOnly = true;
+        else if (a === "--commit")
+            flags.commit = true;
+        else if (a === "--message" || a === "-m")
+            flags.message = args.shift();
+        else if (a === "--title")
+            flags.title = args.shift();
+        else if (a === "--body")
+            flags.body = args.shift();
+        else if (a === "--id")
+            flags.id = args.shift();
+        else if (a === "--comment-id")
+            flags.commentId = args.shift();
+        else if (a === "--reason")
+            flags.reason = args.shift();
+        else if (a === "--base")
+            flags.base = args.shift();
+        else if (a === "--head")
+            flags.head = args.shift();
+        else if (a === "--head-ref")
+            flags.headRef = args.shift();
+        else if (a === "--topic")
+            flags.topic = args.shift();
+        else if (a === "--by")
+            flags.by = args.shift();
+        else if (a === "--op")
+            flags.op = args.shift();
+        else if (a === "--agent-id")
+            flags.agentId = args.shift();
+        else if (a === "--ttl-seconds")
+            flags.ttlSeconds = Number(args.shift());
+        else if (a === "--task")
+            flags.task = args.shift();
+        else if (a === "--env")
+            flags.env = args.shift();
+        else if (a === "--rev")
+            flags.rev = args.shift();
+        else if (a === "--artifact")
+            flags.artifact = args.shift();
+        else if (a === "--dispatch-id")
+            flags.dispatchId = args.shift();
+        else if (a === "--url")
+            flags.url = args.shift();
+        else if (a === "--type")
+            flags.type = args.shift();
+        else
+            positionals.push(a);
+    }
+    return { flags, positionals };
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../src/args.ts"],"names":[],"mappings":"AAsCA,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IACvB,MAAM,KAAK,GAAwB,EAAE,CAAC;IACtC,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACnB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;QACxB,IAAI,CAAC,KAAK,QAAQ;YAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aAC1C,IAAI,CAAC,KAAK,WAAW;YAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aACrD,IAAI,CAAC,KAAK,QAAQ;YAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC;aACtC,IAAI,CAAC,KAAK,aAAa,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;YACxB,KAAK,CAAC,SAAS,KAAK,EAAE,CAAC;YACvB,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1B,CAAC;aAAM,IAAI,CAAC,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aACnD,IAAI,CAAC,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAG,CAAC,CAAC;aACzD,IAAI,CAAC,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;aACjG,IAAI,CAAC,KAAK,UAAU;YAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aACnD,IAAI,CAAC,KAAK,UAAU;YAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;aAC1C,IAAI,CAAC,KAAK,cAAc;YAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC;aACjD,IAAI,CAAC,KAAK,UAAU;YAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;aAC1C,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,KAAK,IAAI;YAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aACnE,IAAI,CAAC,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aACjD,IAAI,CAAC,KAAK,QAAQ;YAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aAC/C,IAAI,CAAC,KAAK,MAAM;YAAE,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aAC3C,IAAI,CAAC,KAAK,cAAc;YAAE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aAC1D,IAAI,CAAC,KAAK,UAAU;YAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aACnD,IAAI,CAAC,KAAK,QAAQ;YAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aAC/C,IAAI,CAAC,KAAK,QAAQ;YAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aAC/C,IAAI,CAAC,KAAK,YAAY;YAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aACtD,IAAI,CAAC,KAAK,SAAS;YAAE,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aACjD,IAAI,CAAC,KAAK,MAAM;YAAE,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aAC3C,IAAI,CAAC,KAAK,MAAM;YAAE,KAAK,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aAC3C,IAAI,CAAC,KAAK,YAAY;YAAE,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aACtD,IAAI,CAAC,KAAK,eAAe;YAAE,KAAK,CAAC,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAG,CAAC,CAAC;aACpE,IAAI,CAAC,KAAK,QAAQ;YAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aAC/C,IAAI,CAAC,KAAK,OAAO;YAAE,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aAC7C,IAAI,CAAC,KAAK,OAAO;YAAE,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aAC7C,IAAI,CAAC,KAAK,YAAY;YAAE,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aACvD,IAAI,CAAC,KAAK,eAAe;YAAE,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aAC5D,IAAI,CAAC,KAAK,OAAO;YAAE,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;aAC7C,IAAI,CAAC,KAAK,QAAQ;YAAE,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,KAAK,EAAG,CAAC;;YAC/C,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;AAChC,CAAC"}

package/dist/bin/git-a5c.d.ts

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

package/dist/bin/git-a5c.d.ts.map

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

package/dist/bin/git-a5c.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+import { runCli } from "../run.js";
+runCli(process.argv.slice(2))
+    .then((code) => {
+    process.exitCode = code;
+})
+    .catch((e) => {
+    // Keep output minimal and deterministic.
+    process.stderr.write(String(e?.message ?? e) + "\n");
+    process.exitCode = 1;
+});
+//# sourceMappingURL=git-a5c.js.map

package/dist/bin/git-a5c.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-a5c.js","sourceRoot":"","sources":["../../src/bin/git-a5c.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;KAC1B,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE;IACb,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;AAC1B,CAAC,CAAC;KACD,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE;IACX,yCAAyC;IACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,OAAO,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACrD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/commands/agent.d.ts

@@ -0,0 +1,3 @@
+import type { CommandArgs } from "./types.js";
+export declare function handleAgent(args: CommandArgs): Promise<number | undefined>;
+//# sourceMappingURL=agent.d.ts.map

package/dist/commands/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/commands/agent.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAY9C,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAyDhF"}

package/dist/commands/agent.js

@@ -0,0 +1,61 @@
+import { git, gitConfigGet } from "../git.js";
+import { HlcClock, UlidGenerator, loadHlcState, saveHlcState, stageFiles, writeAgentHeartbeat, writeAgentDispatchCreated } from "@a5cforge/sdk";
+export async function handleAgent(args) {
+    if (args.positionals[0] !== "agent")
+        return;
+    const sub = args.positionals[1];
+    const actor = process.env.A5C_ACTOR ?? (await gitConfigGet(args.repoRoot, "user.name")) ?? "unknown";
+    const persisted = (await loadHlcState(actor)) ?? { wallMs: 0, counter: 0 };
+    const clock = new HlcClock(persisted);
+    let nonce = 0;
+    const ctx = { repoRoot: args.repoRoot, actor, clock, nextNonce: () => String(++nonce).padStart(4, "0") };
+    if (sub === "heartbeat") {
+        const agentId = args.flags.agentId ?? actor;
+        const ttlSeconds = args.flags.ttlSeconds ?? 120;
+        const time = new Date(args.nowMs()).toISOString();
+        const status = args.flags.message ?? undefined;
+        const entityId = args.flags.entity;
+        const entity = entityId ? { type: entityId.startsWith("pr-") ? "pr" : "issue", id: entityId } : undefined;
+        const res = await writeAgentHeartbeat(ctx, { agentId, ttlSeconds, status, entity, time });
+        await saveHlcState(actor, clock.now());
+        if (args.flags.stageOnly || args.flags.commit)
+            await stageFiles(args.repoRoot, [res.path]);
+        if (args.flags.commit) {
+            const msg = args.flags.message ?? `a5c: agent heartbeat ${agentId}`;
+            await git(["-c", "user.name=a5c", "-c", "user.email=a5c@example.invalid", "commit", "-m", msg], args.repoRoot);
+        }
+        args.io.writeLine(args.io.out, res.path);
+        return 0;
+    }
+    if (sub === "dispatch") {
+        const entityId = args.flags.entity;
+        if (!entityId) {
+            args.io.writeLine(args.io.err, "usage: git a5c agent dispatch --entity <issueId|prKey> [--dispatch-id ...] [--task ...]");
+            return 2;
+        }
+        const dispatchId = args.flags.dispatchId ?? `d-${new UlidGenerator().generate()}`;
+        const time = new Date(args.nowMs()).toISOString();
+        const entity = { type: entityId.startsWith("pr-") ? "pr" : "issue", id: entityId };
+        const agentId = args.flags.agentId ?? actor;
+        const res = await writeAgentDispatchCreated(ctx, {
+            dispatchId,
+            agentId,
+            entity,
+            task: args.flags.task,
+            params: undefined,
+            time
+        });
+        await saveHlcState(actor, clock.now());
+        if (args.flags.stageOnly || args.flags.commit)
+            await stageFiles(args.repoRoot, [res.path]);
+        if (args.flags.commit) {
+            const msg = args.flags.message ?? `a5c: agent dispatch ${dispatchId}`;
+            await git(["-c", "user.name=a5c", "-c", "user.email=a5c@example.invalid", "commit", "-m", msg], args.repoRoot);
+        }
+        args.io.writeLine(args.io.out, res.path);
+        return 0;
+    }
+    args.io.writeLine(args.io.err, "usage: git a5c agent heartbeat|dispatch ...");
+    return 2;
+}
+//# sourceMappingURL=agent.js.map

package/dist/commands/agent.js.map

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

package/dist/commands/block.d.ts

@@ -0,0 +1,3 @@
+import type { CommandArgs } from "./types.js";
+export declare function handleBlock(args: CommandArgs): Promise<number | undefined>;
+//# sourceMappingURL=block.d.ts.map

package/dist/commands/block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../src/commands/block.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA2BhF"}

package/dist/commands/block.js

@@ -0,0 +1,33 @@
+import { git, gitConfigGet } from "../git.js";
+import { HlcClock, loadHlcState, saveHlcState, stageFiles, writeDepChanged } from "@a5cforge/sdk";
+export async function handleBlock(args) {
+    if (args.positionals[0] !== "block")
+        return;
+    // git a5c block <entityId> --by <issueOrPrId> [--op add|remove]
+    const entityId = args.positionals[1];
+    const byId = args.flags.by;
+    const op = args.flags.op ?? "add";
+    if (!entityId || !byId) {
+        args.io.writeLine(args.io.err, "usage: git a5c block <entityId> --by <issue|pr> [--op add|remove]");
+        return 2;
+    }
+    const entity = { type: entityId.startsWith("pr-") ? "pr" : "issue", id: entityId };
+    const by = { type: byId.startsWith("pr-") ? "pr" : "issue", id: byId };
+    const actor = process.env.A5C_ACTOR ?? (await gitConfigGet(args.repoRoot, "user.name")) ?? "unknown";
+    const time = new Date(args.nowMs()).toISOString();
+    const persisted = (await loadHlcState(actor)) ?? { wallMs: 0, counter: 0 };
+    const clock = new HlcClock(persisted);
+    let nonce = 0;
+    const ctx = { repoRoot: args.repoRoot, actor, clock, nextNonce: () => String(++nonce).padStart(4, "0") };
+    const res = await writeDepChanged(ctx, { entity, op, by, note: args.flags.message, time });
+    await saveHlcState(actor, clock.now());
+    if (args.flags.stageOnly || args.flags.commit)
+        await stageFiles(args.repoRoot, [res.path]);
+    if (args.flags.commit) {
+        const msg = args.flags.message ?? `a5c: dep ${op} ${entityId}`;
+        await git(["-c", "user.name=a5c", "-c", "user.email=a5c@example.invalid", "commit", "-m", msg], args.repoRoot);
+    }
+    args.io.writeLine(args.io.out, res.path);
+    return 0;
+}
+//# sourceMappingURL=block.js.map

package/dist/commands/block.js.map

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

package/dist/commands/gate.d.ts

@@ -0,0 +1,3 @@
+import type { CommandArgs } from "./types.js";
+export declare function handleGate(args: CommandArgs): Promise<number | undefined>;
+//# sourceMappingURL=gate.d.ts.map

package/dist/commands/gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../../src/commands/gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,wBAAsB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAyB/E"}

package/dist/commands/gate.js

@@ -0,0 +1,31 @@
+import { git, gitConfigGet } from "../git.js";
+import { HlcClock, loadHlcState, saveHlcState, stageFiles, writeGateChanged } from "@a5cforge/sdk";
+export async function handleGate(args) {
+    if (args.positionals[0] !== "gate")
+        return;
+    const sub = args.positionals[1];
+    const entityId = args.positionals[2];
+    if (!sub || !entityId) {
+        args.io.writeLine(args.io.err, "usage: git a5c gate needs-human|clear <entityId> [--topic t] [-m msg]");
+        return 2;
+    }
+    const entity = { type: entityId.startsWith("pr-") ? "pr" : "issue", id: entityId };
+    const needsHuman = sub === "needs-human";
+    const actor = process.env.A5C_ACTOR ?? (await gitConfigGet(args.repoRoot, "user.name")) ?? "unknown";
+    const time = new Date(args.nowMs()).toISOString();
+    const persisted = (await loadHlcState(actor)) ?? { wallMs: 0, counter: 0 };
+    const clock = new HlcClock(persisted);
+    let nonce = 0;
+    const ctx = { repoRoot: args.repoRoot, actor, clock, nextNonce: () => String(++nonce).padStart(4, "0") };
+    const res = await writeGateChanged(ctx, { entity, needsHuman, topic: args.flags.topic, message: args.flags.message, time });
+    await saveHlcState(actor, clock.now());
+    if (args.flags.stageOnly || args.flags.commit)
+        await stageFiles(args.repoRoot, [res.path]);
+    if (args.flags.commit) {
+        const msg = args.flags.message ?? `a5c: gate ${sub} ${entityId}`;
+        await git(["-c", "user.name=a5c", "-c", "user.email=a5c@example.invalid", "commit", "-m", msg], args.repoRoot);
+    }
+    args.io.writeLine(args.io.out, res.path);
+    return 0;
+}
+//# sourceMappingURL=gate.js.map

package/dist/commands/gate.js.map

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

package/dist/commands/help.d.ts

@@ -0,0 +1,3 @@
+import type { CommandArgs } from "./types.js";
+export declare function handleHelp(args: CommandArgs): number | undefined;
+//# sourceMappingURL=help.d.ts.map

package/dist/commands/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAiChE"}

package/dist/commands/help.js

@@ -0,0 +1,35 @@
+export function handleHelp(args) {
+    const cmd = args.positionals[0] ?? "help";
+    if (cmd !== "help" && cmd !== "--help" && cmd !== "-h")
+        return;
+    const { writeLine } = args.io;
+    const out = args.io.out;
+    writeLine(out, "git a5c <command> [--json] [--treeish <ref>] [--repo <path>] [--inbox-ref <ref>...]");
+    writeLine(out, "");
+    writeLine(out, "Commands:");
+    writeLine(out, "  status");
+    writeLine(out, "  issue list");
+    writeLine(out, "  issue show <id>");
+    writeLine(out, "  issue new --title <t> [--body <b>] [--stage-only|--commit]");
+    writeLine(out, "  issue comment <id> -m <text> [--comment-id <id>] [--stage-only|--commit]");
+    writeLine(out, "  issue edit-comment <commentId> --id <issueId> -m <text> [--stage-only|--commit]");
+    writeLine(out, "  issue redact-comment <commentId> --id <issueId> [--reason <r>] [--stage-only|--commit]");
+    writeLine(out, "  pr list");
+    writeLine(out, "  pr show <prKey>");
+    writeLine(out, "  pr propose --base <ref> --head <ref> --title <t> [--body <b>] [--stage-only|--commit]");
+    writeLine(out, "  pr request --base <ref> --title <t> [--body <b>] [--stage-only|--commit]");
+    writeLine(out, "  pr claim <prKey> --head-ref <ref> [-m <msg>] [--stage-only|--commit]");
+    writeLine(out, "  pr bind-head <prKey> --head-ref <ref> [-m <msg>] [--stage-only|--commit]");
+    writeLine(out, "  block <entityId> --by <issue|pr> [--op add|remove] [-m <note>] [--stage-only|--commit]");
+    writeLine(out, "  gate needs-human <entityId> [--topic <t>] [-m <msg>] [--stage-only|--commit]");
+    writeLine(out, "  gate clear <entityId> [-m <msg>] [--stage-only|--commit]");
+    writeLine(out, "  agent heartbeat [--agent-id <id>] [--ttl-seconds N] [--entity <id>] [-m <status>] [--stage-only|--commit]");
+    writeLine(out, "  ops deploy --entity <id> [--artifact <uri>] [-m <status>] [--stage-only|--commit]");
+    writeLine(out, "  verify");
+    writeLine(out, "  journal [--since <2h|2025-...>] [--limit N] [--types a,b] [--entity <id>] [--active]");
+    writeLine(out, "  hooks install|uninstall");
+    writeLine(out, "  webhook status");
+    writeLine(out, "  webhook test --url <url> [--type <type>]");
+    return 0;
+}
+//# sourceMappingURL=help.js.map

package/dist/commands/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,UAAU,CAAC,IAAiB;IAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC;IAC1C,IAAI,GAAG,KAAK,MAAM,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO;IAE/D,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,EAAE,CAAC;IAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC;IACxB,SAAS,CAAC,GAAG,EAAE,qFAAqF,CAAC,CAAC;IACtG,SAAS,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACnB,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAC5B,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC3B,SAAS,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;IAC/B,SAAS,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;IACpC,SAAS,CAAC,GAAG,EAAE,8DAA8D,CAAC,CAAC;IAC/E,SAAS,CAAC,GAAG,EAAE,4EAA4E,CAAC,CAAC;IAC7F,SAAS,CAAC,GAAG,EAAE,mFAAmF,CAAC,CAAC;IACpG,SAAS,CAAC,GAAG,EAAE,0FAA0F,CAAC,CAAC;IAC3G,SAAS,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;IAC5B,SAAS,CAAC,GAAG,EAAE,mBAAmB,CAAC,CAAC;IACpC,SAAS,CAAC,GAAG,EAAE,yFAAyF,CAAC,CAAC;IAC1G,SAAS,CAAC,GAAG,EAAE,4EAA4E,CAAC,CAAC;IAC7F,SAAS,CAAC,GAAG,EAAE,wEAAwE,CAAC,CAAC;IACzF,SAAS,CAAC,GAAG,EAAE,4EAA4E,CAAC,CAAC;IAC7F,SAAS,CAAC,GAAG,EAAE,0FAA0F,CAAC,CAAC;IAC3G,SAAS,CAAC,GAAG,EAAE,gFAAgF,CAAC,CAAC;IACjG,SAAS,CAAC,GAAG,EAAE,4DAA4D,CAAC,CAAC;IAC7E,SAAS,CAAC,GAAG,EAAE,6GAA6G,CAAC,CAAC;IAC9H,SAAS,CAAC,GAAG,EAAE,qFAAqF,CAAC,CAAC;IACtG,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC3B,SAAS,CAAC,GAAG,EAAE,wFAAwF,CAAC,CAAC;IACzG,SAAS,CAAC,GAAG,EAAE,2BAA2B,CAAC,CAAC;IAC5C,SAAS,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC;IACnC,SAAS,CAAC,GAAG,EAAE,4CAA4C,CAAC,CAAC;IAC7D,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/hooks.d.ts

@@ -0,0 +1,3 @@
+import type { CommandArgs } from "./types.js";
+export declare function handleHooks(args: CommandArgs): Promise<number | undefined>;
+//# sourceMappingURL=hooks.d.ts.map

package/dist/commands/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/commands/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI9C,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAiChF"}

package/dist/commands/hooks.js

@@ -0,0 +1,40 @@
+import fs from "node:fs/promises";
+import { gitPath } from "../git.js";
+export async function handleHooks(args) {
+    if (args.positionals[0] !== "hooks")
+        return;
+    const sub = args.positionals[1];
+    if (sub !== "install" && sub !== "uninstall") {
+        args.io.writeLine(args.io.err, "usage: git a5c hooks install|uninstall");
+        return 2;
+    }
+    const hooksDir = await gitPath(args.repoRoot, "hooks");
+    const hookFiles = ["post-commit", "post-merge"];
+    if (sub === "uninstall") {
+        for (const f of hookFiles) {
+            try {
+                const p = `${hooksDir}/${f}`;
+                const cur = await fs.readFile(p, "utf8");
+                if (cur.includes("A5C-HOOK-MANAGED: yes")) {
+                    await fs.unlink(p);
+                }
+            }
+            catch { }
+        }
+        args.io.writeLine(args.io.out, "ok");
+        return 0;
+    }
+    const script = `#!/bin/sh\n# a5cforge hook (generated)\n# A5C-HOOK-MANAGED: yes\n# Keep it quiet; write last journal to .git\nif command -v git >/dev/null 2>&1; then\n  git a5c journal --since 2h --limit 20 --json > "$(git rev-parse --git-path a5c-last-journal.json)" 2>/dev/null || true\nfi\nexit 0\n`;
+    await fs.mkdir(hooksDir, { recursive: true });
+    for (const f of hookFiles) {
+        const p = `${hooksDir}/${f}`;
+        await fs.writeFile(p, script, "utf8");
+        try {
+            await fs.chmod(p, 0o755);
+        }
+        catch { }
+    }
+    args.io.writeLine(args.io.out, "ok");
+    return 0;
+}
+//# sourceMappingURL=hooks.js.map

package/dist/commands/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../src/commands/hooks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAiB;IACjD,IAAI,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO;QAAE,OAAO;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAChC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;QAC7C,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,wCAAwC,CAAC,CAAC;QACzE,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC;IAChD,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;QACxB,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,CAAC,GAAG,GAAG,QAAQ,IAAI,CAAC,EAAE,CAAC;gBAC7B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;gBACzC,IAAI,GAAG,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC;oBAC1C,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;gBACrB,CAAC;YACH,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACZ,CAAC;QACD,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QACrC,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,MAAM,GAAG,+RAA+R,CAAC;IAC/S,MAAM,EAAE,CAAC,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,KAAK,MAAM,CAAC,IAAI,SAAS,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,GAAG,QAAQ,IAAI,CAAC,EAAE,CAAC;QAC7B,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QACtC,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC,CAAA,CAAC;IACZ,CAAC;IACD,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACrC,OAAO,CAAC,CAAC;AACX,CAAC"}

package/dist/commands/issue.d.ts

@@ -0,0 +1,3 @@
+import type { CommandArgs } from "./types.js";
+export declare function handleIssue(args: CommandArgs): Promise<number | undefined>;
+//# sourceMappingURL=issue.d.ts.map

package/dist/commands/issue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issue.d.ts","sourceRoot":"","sources":["../../src/commands/issue.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAgB9C,wBAAsB,WAAW,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CA+HhF"}

package/dist/commands/issue.js

@@ -0,0 +1,134 @@
+import { git, gitConfigGet } from "../git.js";
+import { HlcClock, UlidGenerator, loadHlcState, saveHlcState, stageFiles, listIssues, renderIssue, writeIssueCreated, writeCommentCreated, writeCommentEdited, writeCommentRedacted } from "@a5cforge/sdk";
+export async function handleIssue(args) {
+    if (args.positionals[0] !== "issue")
+        return;
+    const sub = args.positionals[1];
+    if (sub === "list") {
+        const ids = listIssues(args.snap);
+        if (args.flags.json)
+            args.io.writeLine(args.io.out, JSON.stringify(ids, null, 2));
+        else
+            ids.forEach((id) => args.io.writeLine(args.io.out, id));
+        return 0;
+    }
+    if (sub === "show") {
+        const id = args.positionals[2];
+        if (!id)
+            throw new Error("missing issue id");
+        const issue = renderIssue(args.snap, id);
+        if (!issue) {
+            args.io.writeLine(args.io.err, `not found: ${id}`);
+            return 2;
+        }
+        if (args.flags.json)
+            args.io.writeLine(args.io.out, JSON.stringify(issue, null, 2));
+        else {
+            args.io.writeLine(args.io.out, `${issue.issueId}: ${issue.title}`);
+            if (issue.body)
+                args.io.writeLine(args.io.out, issue.body);
+            args.io.writeLine(args.io.out, `comments: ${issue.comments.length}`);
+        }
+        return 0;
+    }
+    if (sub === "new") {
+        const title = args.flags.title;
+        if (!title) {
+            args.io.writeLine(args.io.err, "missing --title");
+            return 2;
+        }
+        const actor = process.env.A5C_ACTOR ?? (await gitConfigGet(args.repoRoot, "user.name")) ?? "unknown";
+        const issueId = args.flags.id ?? `issue-${new UlidGenerator().generate()}`;
+        const time = new Date(args.nowMs()).toISOString();
+        const persisted = (await loadHlcState(actor)) ?? { wallMs: 0, counter: 0 };
+        const clock = new HlcClock(persisted);
+        let nonce = 0;
+        const ctx = { repoRoot: args.repoRoot, actor, clock, nextNonce: () => String(++nonce).padStart(4, "0") };
+        const res = await writeIssueCreated(ctx, { issueId, title, body: args.flags.body, time });
+        await saveHlcState(actor, clock.now());
+        if (args.flags.stageOnly || args.flags.commit)
+            await stageFiles(args.repoRoot, [res.path]);
+        if (args.flags.commit) {
+            const msg = args.flags.message ?? `a5c: issue new ${issueId}`;
+            await git(["-c", "user.name=a5c", "-c", "user.email=a5c@example.invalid", "commit", "-m", msg], args.repoRoot);
+        }
+        args.io.writeLine(args.io.out, issueId);
+        return 0;
+    }
+    if (sub === "comment") {
+        const id = args.positionals[2];
+        const body = args.flags.message ?? args.flags.body;
+        if (!id || !body) {
+            args.io.writeLine(args.io.err, "usage: git a5c issue comment <id> -m <text>");
+            return 2;
+        }
+        const actor = process.env.A5C_ACTOR ?? (await gitConfigGet(args.repoRoot, "user.name")) ?? "unknown";
+        const commentId = args.flags.commentId ?? `c-${new UlidGenerator().generate()}`;
+        const time = new Date(args.nowMs()).toISOString();
+        const persisted = (await loadHlcState(actor)) ?? { wallMs: 0, counter: 0 };
+        const clock = new HlcClock(persisted);
+        let nonce = 0;
+        const ctx = { repoRoot: args.repoRoot, actor, clock, nextNonce: () => String(++nonce).padStart(4, "0") };
+        const res = await writeCommentCreated(ctx, { entity: { type: "issue", id }, commentId, body: String(body), time });
+        await saveHlcState(actor, clock.now());
+        if (args.flags.stageOnly || args.flags.commit)
+            await stageFiles(args.repoRoot, [res.path]);
+        if (args.flags.commit) {
+            const msg = args.flags.message ?? `a5c: issue comment ${id}`;
+            await git(["-c", "user.name=a5c", "-c", "user.email=a5c@example.invalid", "commit", "-m", msg], args.repoRoot);
+        }
+        args.io.writeLine(args.io.out, commentId);
+        return 0;
+    }
+    if (sub === "edit-comment") {
+        const commentId = args.positionals[2] ?? args.flags.commentId;
+        const body = args.flags.message ?? args.flags.body;
+        const id = args.flags.id; // entity id required for now
+        if (!commentId || !body || !id) {
+            args.io.writeLine(args.io.err, "usage: git a5c issue edit-comment <commentId> --id <issueId> -m <text>");
+            return 2;
+        }
+        const actor = process.env.A5C_ACTOR ?? (await gitConfigGet(args.repoRoot, "user.name")) ?? "unknown";
+        const time = new Date(args.nowMs()).toISOString();
+        const persisted = (await loadHlcState(actor)) ?? { wallMs: 0, counter: 0 };
+        const clock = new HlcClock(persisted);
+        let nonce = 0;
+        const ctx = { repoRoot: args.repoRoot, actor, clock, nextNonce: () => String(++nonce).padStart(4, "0") };
+        const res = await writeCommentEdited(ctx, { entity: { type: "issue", id }, commentId, body: String(body), time });
+        await saveHlcState(actor, clock.now());
+        if (args.flags.stageOnly || args.flags.commit)
+            await stageFiles(args.repoRoot, [res.path]);
+        if (args.flags.commit) {
+            const msg = args.flags.message ?? `a5c: issue edit-comment ${id} ${commentId}`;
+            await git(["-c", "user.name=a5c", "-c", "user.email=a5c@example.invalid", "commit", "-m", msg], args.repoRoot);
+        }
+        args.io.writeLine(args.io.out, res.path);
+        return 0;
+    }
+    if (sub === "redact-comment") {
+        const commentId = args.positionals[2] ?? args.flags.commentId;
+        const id = args.flags.id;
+        if (!commentId || !id) {
+            args.io.writeLine(args.io.err, "usage: git a5c issue redact-comment <commentId> --id <issueId> [--reason ...]");
+            return 2;
+        }
+        const actor = process.env.A5C_ACTOR ?? (await gitConfigGet(args.repoRoot, "user.name")) ?? "unknown";
+        const time = new Date(args.nowMs()).toISOString();
+        const persisted = (await loadHlcState(actor)) ?? { wallMs: 0, counter: 0 };
+        const clock = new HlcClock(persisted);
+        let nonce = 0;
+        const ctx = { repoRoot: args.repoRoot, actor, clock, nextNonce: () => String(++nonce).padStart(4, "0") };
+        const res = await writeCommentRedacted(ctx, { entity: { type: "issue", id }, commentId, reason: args.flags.reason, time });
+        await saveHlcState(actor, clock.now());
+        if (args.flags.stageOnly || args.flags.commit)
+            await stageFiles(args.repoRoot, [res.path]);
+        if (args.flags.commit) {
+            const msg = args.flags.message ?? `a5c: issue redact-comment ${id} ${commentId}`;
+            await git(["-c", "user.name=a5c", "-c", "user.email=a5c@example.invalid", "commit", "-m", msg], args.repoRoot);
+        }
+        args.io.writeLine(args.io.out, res.path);
+        return 0;
+    }
+    return;
+}
+//# sourceMappingURL=issue.js.map