harnery 0.0.1 → 0.2.0

package/dist/core/agents/state/council.js

@@ -0,0 +1,216 @@
+/**
+ * Council manifest mutations: lifecycle helpers for the council-* actions.
+ *
+ * A council is a multi-round debate among agents recorded at
+ * `.harnery/councils/<id>.json` (manifest) plus `.harnery/councils/<id>/round-N/<member>.md`
+ * (contributions). Archive moves both into `.harnery/councils/archive/`.
+ *
+ * This module owns: lifecycle (advance, close, archive, unarchive, delete)
+ * and steward reassignment. Council CREATION + contribution writes stay
+ * separate (operator-side, harness-agnostic).
+ */
+import { cpSync, existsSync, mkdirSync, readFileSync, renameSync, rmSync, writeFileSync, } from "node:fs";
+import { dirname, join } from "node:path";
+function nowIsoSeconds() {
+    return new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
+}
+function atomicWriteText(path, content) {
+    mkdirSync(dirname(path), { recursive: true });
+    const tmp = `${path}.tmp.${process.pid}`;
+    writeFileSync(tmp, content, "utf8");
+    renameSync(tmp, path);
+}
+function councilsDir(coordRoot) {
+    return join(coordRoot, ".harnery", "councils");
+}
+function archiveDir(coordRoot) {
+    return join(councilsDir(coordRoot), "archive");
+}
+function readManifest(path) {
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        return null;
+    }
+}
+export function advanceCouncil(coordRoot, councilId, opts = {}) {
+    const manifestPath = join(councilsDir(coordRoot), `${councilId}.json`);
+    const manifest = readManifest(manifestPath);
+    if (!manifest)
+        return { ok: false, reason: `no manifest at ${manifestPath}` };
+    if (manifest.status !== "active") {
+        return { ok: false, reason: `council is ${manifest.status}, not active` };
+    }
+    const cur = manifest.current_round;
+    if (!opts.force) {
+        const roundDir = join(councilsDir(coordRoot), councilId, `round-${cur}`);
+        const memberIds = Array.isArray(manifest.member_ids) ? manifest.member_ids : [];
+        for (const [i, member] of manifest.members.entries()) {
+            // Contribution filename drifted across schema versions: v1 wrote
+            // <agent-Name>.md, v2 (member_ids in the manifest) writes <uuid>.md.
+            // Accept either so lifecycle works on both generations of council.
+            const candidates = [join(roundDir, `${member}.md`)];
+            if (memberIds[i])
+                candidates.push(join(roundDir, `${memberIds[i]}.md`));
+            if (!candidates.some((p) => existsSync(p))) {
+                return {
+                    ok: false,
+                    reason: `pending members in round ${cur} (incl. ${member}); pass --force to skip`,
+                    pendingMember: member,
+                };
+            }
+        }
+    }
+    const next = cur + 1;
+    const nextDir = join(councilsDir(coordRoot), councilId, `round-${next}`);
+    mkdirSync(nextDir, { recursive: true });
+    const updated = {
+        ...manifest,
+        current_round: next,
+        round_status: "open",
+    };
+    atomicWriteText(manifestPath, JSON.stringify(updated, null, 2));
+    return { ok: true };
+}
+export function closeCouncil(coordRoot, councilId) {
+    const manifestPath = join(councilsDir(coordRoot), `${councilId}.json`);
+    const manifest = readManifest(manifestPath);
+    if (!manifest)
+        return { ok: false, reason: `no manifest at ${manifestPath}` };
+    if (manifest.status === "archived")
+        return { ok: false, reason: "council is already archived" };
+    const updated = {
+        ...manifest,
+        status: "closed",
+        closed_at: nowIsoSeconds(),
+    };
+    atomicWriteText(manifestPath, JSON.stringify(updated, null, 2));
+    return { ok: true };
+}
+export function archiveCouncil(coordRoot, councilId) {
+    const manifestPath = join(councilsDir(coordRoot), `${councilId}.json`);
+    const manifest = readManifest(manifestPath);
+    if (!manifest)
+        return { ok: false, reason: `no manifest at ${manifestPath}` };
+    const archived = {
+        ...manifest,
+        status: "archived",
+        archived_at: nowIsoSeconds(),
+    };
+    const archivedManifest = join(archiveDir(coordRoot), `${councilId}.json`);
+    const archivedBody = join(archiveDir(coordRoot), councilId);
+    const activeBody = join(councilsDir(coordRoot), councilId);
+    mkdirSync(archiveDir(coordRoot), { recursive: true });
+    atomicWriteText(manifestPath, JSON.stringify(archived, null, 2));
+    try {
+        renameSync(manifestPath, archivedManifest);
+    }
+    catch {
+        /* idempotent; manifest may already be in archive */
+    }
+    if (existsSync(activeBody)) {
+        if (existsSync(archivedBody)) {
+            rmSync(activeBody, { recursive: true, force: true });
+        }
+        else {
+            try {
+                renameSync(activeBody, archivedBody);
+            }
+            catch {
+                // cross-device or permissions: fall back to copy + remove.
+                cpSync(activeBody, archivedBody, { recursive: true });
+                rmSync(activeBody, { recursive: true, force: true });
+            }
+        }
+    }
+    return { ok: true };
+}
+export function unarchiveCouncil(coordRoot, councilId) {
+    const archivedManifest = join(archiveDir(coordRoot), `${councilId}.json`);
+    const activeManifest = join(councilsDir(coordRoot), `${councilId}.json`);
+    if (!existsSync(archivedManifest)) {
+        return { ok: false, reason: `no archived manifest at ${archivedManifest}` };
+    }
+    if (existsSync(activeManifest)) {
+        return { ok: false, reason: "active manifest already exists; refusing to clobber" };
+    }
+    const manifest = readManifest(archivedManifest);
+    if (!manifest)
+        return { ok: false, reason: `couldn't parse ${archivedManifest}` };
+    const restored = { ...manifest };
+    restored.archived_at = undefined;
+    restored.status = manifest.closed_at ? "closed" : "active";
+    atomicWriteText(archivedManifest, JSON.stringify(restored, null, 2));
+    try {
+        renameSync(archivedManifest, activeManifest);
+    }
+    catch {
+        /* ignore; idempotent */
+    }
+    const archivedBody = join(archiveDir(coordRoot), councilId);
+    const activeBody = join(councilsDir(coordRoot), councilId);
+    if (existsSync(archivedBody)) {
+        if (existsSync(activeBody)) {
+            rmSync(archivedBody, { recursive: true, force: true });
+        }
+        else {
+            try {
+                renameSync(archivedBody, activeBody);
+            }
+            catch {
+                cpSync(archivedBody, activeBody, { recursive: true });
+                rmSync(archivedBody, { recursive: true, force: true });
+            }
+        }
+    }
+    return { ok: true };
+}
+export function deleteCouncil(coordRoot, councilId) {
+    const archivedManifest = join(archiveDir(coordRoot), `${councilId}.json`);
+    const activeManifest = join(councilsDir(coordRoot), `${councilId}.json`);
+    if (existsSync(activeManifest)) {
+        return {
+            ok: false,
+            reason: `council ${councilId} is not archived; archive first`,
+        };
+    }
+    if (!existsSync(archivedManifest)) {
+        return { ok: false, reason: `no archived manifest at ${archivedManifest}` };
+    }
+    const archivedBody = join(archiveDir(coordRoot), councilId);
+    rmSync(archivedManifest, { force: true });
+    if (existsSync(archivedBody)) {
+        rmSync(archivedBody, { recursive: true, force: true });
+    }
+    return { ok: true };
+}
+export function setCouncilSteward(coordRoot, councilId, newSteward, newStewardId) {
+    const manifestPath = join(councilsDir(coordRoot), `${councilId}.json`);
+    const manifest = readManifest(manifestPath);
+    if (!manifest)
+        return { ok: false, reason: `no manifest at ${manifestPath}` };
+    if (manifest.status === "archived") {
+        return { ok: false, reason: "council is archived (read-only)" };
+    }
+    if (newSteward && !/^agent-[A-Za-z][A-Za-z0-9_-]*$/.test(newSteward)) {
+        return {
+            ok: false,
+            reason: `invalid steward "${newSteward}" (must match agent-[A-Za-z][A-Za-z0-9_-]*)`,
+        };
+    }
+    const updated = { ...manifest };
+    if (!newSteward) {
+        updated.steward = undefined;
+        updated.steward_id = undefined;
+    }
+    else {
+        updated.steward = newSteward;
+        if (newStewardId)
+            updated.steward_id = newStewardId;
+    }
+    atomicWriteText(manifestPath, JSON.stringify(updated, null, 2));
+    return { ok: true };
+}

package/dist/core/agents/state/heartbeat-projector.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Heartbeat projector. Reads canonical events from the consumer and projects
+ * them into per-owner state files under `.harnery/active/<id>.json`, the same
+ * canonical location every reader (this library, hooks, the web UI, etc.)
+ * expects.
+ *
+ * Projection writes a single file, additively merged with any existing body
+ * so writes from sibling tools (e.g. `agent-coord set-task` that doesn't go
+ * through the canonical event stream) survive each projector run.
+ */
+import type { CanonicalEvent } from "../events/consume.js";
+export interface V2Heartbeat {
+    instance_id: string;
+    session_id: string;
+    harness: string;
+    agent_id?: string;
+    name?: string;
+    kind?: "session" | "subagent" | "transient";
+    model?: string;
+    platform?: string;
+    subagent_call_id?: string;
+    parent_session_id?: string;
+    started_at?: string;
+    last_heartbeat: string;
+    last_tool?: string;
+    last_tool_target?: string;
+    last_tool_at?: string;
+    task?: string;
+    task_updated_at?: string;
+    last_status_at?: string;
+    presence?: "mobile" | "office";
+    last_intent?: string;
+    last_intent_source?: string;
+    last_turn_id?: string;
+    last_user_prompt_at?: string;
+    last_turn_stop_at?: string;
+    last_turn_status_box_present?: boolean;
+    ended_at?: string;
+    clean_exit?: boolean;
+    files_touched?: string[];
+    turn_summary?: string;
+    turn_summary_updated_at?: string;
+    /** ULID of the last event applied for this owner; idempotency anchor. */
+    last_event_id: string;
+    /** Count of events applied for this owner since the projector first saw it. */
+    events_applied: number;
+    /** Internal projection metadata. */
+    v2_meta: {
+        schema_version: 1;
+        first_seen: string;
+        last_projected: string;
+    };
+}
+export declare function projectHeartbeats(coordRoot: string, events: readonly CanonicalEvent[]): {
+    written: string[];
+    perOwner: Record<string, V2Heartbeat>;
+};
+export declare function heartbeatPath(coordRoot: string, instanceId: string): string;
+//# sourceMappingURL=heartbeat-projector.d.ts.map

package/dist/core/agents/state/heartbeat-projector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"heartbeat-projector.d.ts","sourceRoot":"","sources":["../../../../src/core/agents/state/heartbeat-projector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,WAAW,CAAC;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,4BAA4B,CAAC,EAAE,OAAO,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,yEAAyE;IACzE,aAAa,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,cAAc,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,OAAO,EAAE;QACP,cAAc,EAAE,CAAC,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,SAAS,cAAc,EAAE,GAChC;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAA;CAAE,CAoD9D;AA8VD,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE3E"}