@voybio/ace-swarm 0.1.0

package/dist/git-ops.js

@@ -0,0 +1,238 @@
+/**
+ * Git operations module – wraps git CLI for rollback, audit trail,
+ * and workspace state management.
+ */
+import { existsSync, writeFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { spawnSync } from "node:child_process";
+import { WORKSPACE_ROOT } from "./helpers.js";
+// ────────────────────────────────────────────────────────────────────
+// Core git wrapper
+// ────────────────────────────────────────────────────────────────────
+function git(...args) {
+    const res = spawnSync("git", args, {
+        cwd: WORKSPACE_ROOT,
+        encoding: "utf-8",
+        timeout: 30_000,
+        maxBuffer: 4 * 1024 * 1024,
+    });
+    return {
+        ok: res.status === 0,
+        stdout: res.stdout ?? "",
+        stderr: res.stderr ?? "",
+    };
+}
+export function isGitRepo() {
+    return git("rev-parse", "--is-inside-work-tree").ok;
+}
+// ────────────────────────────────────────────────────────────────────
+// git status
+// ────────────────────────────────────────────────────────────────────
+export function gitStatus() {
+    if (!isGitRepo()) {
+        return {
+            ok: false,
+            is_repo: false,
+            clean: false,
+            staged: [],
+            unstaged: [],
+            untracked: [],
+            branch: "",
+            output: "",
+            error: "Not a git repository. Run git_init or git init first.",
+        };
+    }
+    const branchResult = git("branch", "--show-current");
+    const branch = branchResult.stdout.trim();
+    const statusResult = git("status", "--porcelain=v1");
+    if (!statusResult.ok) {
+        return {
+            ok: false,
+            is_repo: true,
+            clean: false,
+            staged: [],
+            unstaged: [],
+            untracked: [],
+            branch,
+            output: statusResult.stderr,
+            error: "git status failed",
+        };
+    }
+    const lines = statusResult.stdout
+        .split(/\r?\n/)
+        .filter((l) => l.length > 0);
+    const staged = [];
+    const unstaged = [];
+    const untracked = [];
+    for (const line of lines) {
+        const indexStatus = line[0] ?? " ";
+        const workStatus = line[1] ?? " ";
+        const file = line.slice(3);
+        if (indexStatus === "?" && workStatus === "?") {
+            untracked.push(file);
+        }
+        else {
+            if (indexStatus !== " " && indexStatus !== "?")
+                staged.push(file);
+            if (workStatus !== " " && workStatus !== "?")
+                unstaged.push(file);
+        }
+    }
+    return {
+        ok: true,
+        is_repo: true,
+        clean: lines.length === 0,
+        staged,
+        unstaged,
+        untracked,
+        branch,
+        output: statusResult.stdout,
+    };
+}
+// ────────────────────────────────────────────────────────────────────
+// git commit
+// ────────────────────────────────────────────────────────────────────
+export function gitCommit(message, paths) {
+    if (!isGitRepo()) {
+        return {
+            ok: false,
+            message,
+            files_committed: 0,
+            output: "",
+            error: "Not a git repository",
+        };
+    }
+    // Stage files
+    const addArgs = paths && paths.length > 0 ? paths : ["-A"];
+    const addResult = git("add", ...addArgs);
+    if (!addResult.ok) {
+        return {
+            ok: false,
+            message,
+            files_committed: 0,
+            output: addResult.stderr,
+            error: `git add failed: ${addResult.stderr.slice(0, 200)}`,
+        };
+    }
+    // Check for staged changes
+    const status = git("diff", "--cached", "--name-only");
+    const stagedFiles = status.stdout
+        .split(/\r?\n/)
+        .filter((l) => l.length > 0);
+    if (stagedFiles.length === 0) {
+        return {
+            ok: true,
+            message,
+            files_committed: 0,
+            output: "Nothing to commit (working tree clean)",
+        };
+    }
+    const commitResult = git("commit", "-m", message);
+    if (!commitResult.ok) {
+        return {
+            ok: false,
+            message,
+            files_committed: 0,
+            output: commitResult.stderr,
+            error: `git commit failed: ${commitResult.stderr.slice(0, 200)}`,
+        };
+    }
+    const hashResult = git("rev-parse", "--short", "HEAD");
+    const hash = hashResult.stdout.trim();
+    return {
+        ok: true,
+        hash,
+        message,
+        files_committed: stagedFiles.length,
+        output: commitResult.stdout,
+    };
+}
+// ────────────────────────────────────────────────────────────────────
+// git diff
+// ────────────────────────────────────────────────────────────────────
+export function gitDiff(path, staged) {
+    if (!isGitRepo()) {
+        return {
+            ok: false,
+            diff: "",
+            files_changed: 0,
+            insertions: 0,
+            deletions: 0,
+            stat: "",
+            error: "Not a git repository",
+        };
+    }
+    const baseArgs = staged ? ["diff", "--staged"] : ["diff"];
+    const statArgs = [...baseArgs, "--stat"];
+    const fullArgs = [...baseArgs];
+    if (path) {
+        statArgs.push("--", path);
+        fullArgs.push("--", path);
+    }
+    const statResult = git(...statArgs);
+    const fullResult = git(...fullArgs);
+    let files_changed = 0;
+    let insertions = 0;
+    let deletions = 0;
+    const statLine = statResult.stdout
+        .split(/\r?\n/)
+        .find((l) => l.includes("changed"));
+    if (statLine) {
+        const fc = statLine.match(/(\d+) files? changed/);
+        const ins = statLine.match(/(\d+) insertions?/);
+        const del = statLine.match(/(\d+) deletions?/);
+        files_changed = fc ? parseInt(fc[1] ?? "0", 10) : 0;
+        insertions = ins ? parseInt(ins[1] ?? "0", 10) : 0;
+        deletions = del ? parseInt(del[1] ?? "0", 10) : 0;
+    }
+    return {
+        ok: true,
+        diff: fullResult.stdout.slice(0, 8000),
+        files_changed,
+        insertions,
+        deletions,
+        stat: statResult.stdout.slice(0, 2000),
+    };
+}
+// ────────────────────────────────────────────────────────────────────
+// git log
+// ────────────────────────────────────────────────────────────────────
+export function gitLog(limit = 20) {
+    if (!isGitRepo()) {
+        return { ok: false, entries: [], error: "Not a git repository" };
+    }
+    const result = git("log", `--max-count=${limit}`, "--format=%H|%aI|%s");
+    if (!result.ok) {
+        return { ok: false, entries: [], error: result.stderr.slice(0, 500) };
+    }
+    const entries = result.stdout
+        .split(/\r?\n/)
+        .filter((l) => l.length > 0)
+        .map((line) => {
+        const [hash = "", date = "", ...rest] = line.split("|");
+        return { hash, date, message: rest.join("|") };
+    });
+    return { ok: true, entries };
+}
+// ────────────────────────────────────────────────────────────────────
+// git init (if not already a repo)
+// ────────────────────────────────────────────────────────────────────
+export function gitInitIfNeeded() {
+    if (isGitRepo())
+        return { ok: true, initialized: false };
+    const init = git("init");
+    if (!init.ok)
+        return { ok: false, initialized: false, error: init.stderr };
+    const gitignorePath = resolve(WORKSPACE_ROOT, ".gitignore");
+    if (!existsSync(gitignorePath)) {
+        writeFileSync(gitignorePath, [
+            "node_modules/",
+            "dist/",
+            ".DS_Store",
+            "*.tmp",
+            ".ace-staging/",
+        ].join("\n"), "utf-8");
+    }
+    return { ok: true, initialized: true };
+}
+//# sourceMappingURL=git-ops.js.map

package/dist/handoff-registry.d.ts

@@ -0,0 +1,71 @@
+export type HandoffLifecycleStatus = "open" | "accepted" | "blocked" | "completed";
+export interface HandoffLifecycleEvent {
+    timestamp_utc: string;
+    status: HandoffLifecycleStatus;
+    actor: string;
+    note?: string;
+}
+export interface HandoffRecord {
+    handoff_id: string;
+    created_at: string;
+    updated_at: string;
+    from: string;
+    to: string;
+    title: string;
+    task_type?: string;
+    priority?: string;
+    source_file?: string;
+    status: HandoffLifecycleStatus;
+    history: HandoffLifecycleEvent[];
+}
+export interface HandoffRegistryFile {
+    version: 1;
+    updated_at: string;
+    handoffs: Record<string, HandoffRecord>;
+}
+export interface RegisterHandoffInput {
+    handoff_id: string;
+    from: string;
+    to: string;
+    title: string;
+    task_type?: string;
+    priority?: string;
+    source_file?: string;
+    actor?: string;
+    note?: string;
+}
+export interface AcknowledgeHandoffInput {
+    handoff_id: string;
+    status: HandoffLifecycleStatus;
+    actor?: string;
+    note?: string;
+}
+export interface HandoffAckResult {
+    ok: boolean;
+    error?: string;
+    allowed?: HandoffLifecycleStatus[];
+    previous_status?: HandoffLifecycleStatus;
+    record?: HandoffRecord;
+    path: string;
+}
+export declare function readHandoffRegistry(): HandoffRegistryFile;
+export declare function registerHandoff(input: RegisterHandoffInput): {
+    record: HandoffRecord;
+    path: string;
+    duplicate?: boolean;
+};
+export declare function acknowledgeHandoff(input: AcknowledgeHandoffInput): HandoffAckResult;
+export declare function getHandoffRegistryPath(): string;
+/**
+ * Concurrency-safe variant of registerHandoff.
+ */
+export declare function registerHandoffSafe(input: RegisterHandoffInput): Promise<{
+    record: HandoffRecord;
+    path: string;
+    duplicate?: boolean;
+}>;
+/**
+ * Concurrency-safe variant of acknowledgeHandoff.
+ */
+export declare function acknowledgeHandoffSafe(input: AcknowledgeHandoffInput): Promise<HandoffAckResult>;
+//# sourceMappingURL=handoff-registry.d.ts.map