agentplane 0.2.5 → 0.2.12

package/dist/commands/verify.spec.js

@@ -0,0 +1,96 @@
+import { usageError } from "../cli/spec/errors.js";
+export const verifySpec = {
+    id: ["verify"],
+    group: "Lifecycle",
+    summary: "Record a verification outcome for a task (record-only; does not execute commands).",
+    args: [
+        {
+            name: "task-id",
+            required: true,
+            valueHint: "<task-id>",
+            description: "Existing task id.",
+        },
+    ],
+    options: [
+        {
+            kind: "boolean",
+            name: "ok",
+            default: false,
+            description: "Record an OK verification outcome.",
+        },
+        {
+            kind: "boolean",
+            name: "rework",
+            default: false,
+            description: "Record a needs-rework verification outcome.",
+        },
+        {
+            kind: "string",
+            name: "by",
+            valueHint: "<id>",
+            required: true,
+            description: "Verifier id (e.g. REVIEWER).",
+        },
+        {
+            kind: "string",
+            name: "note",
+            valueHint: "<text>",
+            required: true,
+            description: "Short note describing the verification outcome.",
+        },
+        {
+            kind: "string",
+            name: "details",
+            valueHint: "<text>",
+            description: "Optional free-form details (mutually exclusive with --file).",
+        },
+        {
+            kind: "string",
+            name: "file",
+            valueHint: "<path>",
+            description: "Read details from a file path (mutually exclusive with --details).",
+        },
+        { kind: "boolean", name: "quiet", default: false, description: "Suppress output." },
+    ],
+    examples: [
+        {
+            cmd: 'agentplane verify 202602030608-F1Q8AB --ok --by REVIEWER --note "Looks good" --quiet',
+            why: "Record an OK verification outcome.",
+        },
+        {
+            cmd: 'agentplane verify 202602030608-F1Q8AB --rework --by REVIEWER --note "Needs changes" --details "Missing tests"',
+            why: "Record a needs-rework outcome with details.",
+        },
+    ],
+    validateRaw: (raw) => {
+        const ok = raw.opts.ok === true;
+        const rework = raw.opts.rework === true;
+        if (ok === rework) {
+            throw usageError({
+                spec: verifySpec,
+                command: "verify",
+                message: "Exactly one of --ok or --rework must be provided.",
+            });
+        }
+        if (typeof raw.opts.details === "string" && typeof raw.opts.file === "string") {
+            throw usageError({
+                spec: verifySpec,
+                command: "verify",
+                message: "Options --details and --file are mutually exclusive.",
+            });
+        }
+    },
+    parse: (raw) => {
+        const ok = raw.opts.ok === true;
+        const state = ok ? "ok" : "needs_rework";
+        return {
+            taskId: typeof raw.args["task-id"] === "string" ? raw.args["task-id"] : "",
+            state,
+            by: raw.opts.by,
+            note: raw.opts.note,
+            details: raw.opts.details,
+            file: raw.opts.file,
+            quiet: raw.opts.quiet === true,
+        };
+    },
+};

package/dist/policy/rules/commit-subject.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"commit-subject.d.ts","sourceRoot":"","sources":["../../../src/policy/rules/commit-subject.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,CAkClE"}
+{"version":3,"file":"commit-subject.d.ts","sourceRoot":"","sources":["../../../src/policy/rules/commit-subject.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,YAAY,CAmBlE"}

package/dist/policy/rules/commit-subject.js

@@ -5,21 +5,9 @@ export function commitSubjectRule(ctx) {
     if (!subject) {
         return { ok: false, errors: [gitError("Commit message subject is empty")], warnings: [] };
     }
-    const taskId = (ctx.taskId ?? "").trim();
-    if (!taskId) {
-        return {
-            ok: false,
-            errors: [
-                gitError(ctx.action === "hook_commit_msg"
-                    ? "AGENTPLANE_TASK_ID is required (use `agentplane commit ...`)"
-                    : "Task id is required for commit subject validation"),
-            ],
-            warnings: [],
-        };
-    }
     const policy = validateCommitSubject({
         subject,
-        taskId,
+        taskId: (ctx.taskId ?? "").trim() || undefined,
         genericTokens: ctx.config.commit.generic_tokens,
     });
     if (!policy.ok) {

package/dist/shared/agent-emoji.d.ts

@@ -0,0 +1,5 @@
+export declare function resolveCommitEmojiForAgent(opts: {
+    agentsDirAbs: string;
+    agentId: string;
+}): Promise<string>;
+//# sourceMappingURL=agent-emoji.d.ts.map

package/dist/shared/agent-emoji.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-emoji.d.ts","sourceRoot":"","sources":["../../src/shared/agent-emoji.ts"],"names":[],"mappings":"AAmCA,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACrD,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,MAAM,CAAC,CAmBlB"}

package/dist/shared/agent-emoji.js

@@ -0,0 +1,50 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+import { fileExists } from "../cli/fs-utils.js";
+const FALLBACK_EMOJIS = ["🧭", "🧠", "🏗️", "🧪", "🛠️", "🔧", "🧩", "🔍", "📦"];
+const WELL_KNOWN_AGENT_EMOJI = {
+    ORCHESTRATOR: "🧭",
+    PLANNER: "🧠",
+    CREATOR: "🏗️",
+    INTEGRATOR: "🧩",
+    TESTER: "🧪",
+    CODER: "🛠️",
+};
+function stableHash32(input) {
+    // Simple, stable FNV-1a 32-bit hash (good enough for deterministic emoji selection).
+    // FNV-1a offset basis / prime in decimal to avoid numeric-separator style lint quirks.
+    let h = 2_166_136_261;
+    for (const ch of input) {
+        const cp = ch.codePointAt(0) ?? 0;
+        h ^= cp;
+        h = Math.imul(h, 16_777_619);
+    }
+    return h >>> 0;
+}
+function fallbackEmojiForAgentId(agentId) {
+    const wellKnown = WELL_KNOWN_AGENT_EMOJI[agentId];
+    if (wellKnown)
+        return wellKnown;
+    const idx = stableHash32(agentId) % FALLBACK_EMOJIS.length;
+    return FALLBACK_EMOJIS[idx] ?? "🧩";
+}
+export async function resolveCommitEmojiForAgent(opts) {
+    const agentId = opts.agentId.trim();
+    if (!agentId)
+        return "🧩";
+    // Allow users to override the emoji per agent by adding `commit_emoji` to the agent json file.
+    const agentPath = path.join(opts.agentsDirAbs, `${agentId}.json`);
+    if (await fileExists(agentPath)) {
+        try {
+            const text = await readFile(agentPath, "utf8");
+            const parsed = JSON.parse(text);
+            const emoji = parsed && typeof parsed.commit_emoji === "string" ? parsed.commit_emoji.trim() : "";
+            if (emoji)
+                return emoji;
+        }
+        catch {
+            // ignore; fallback below
+        }
+    }
+    return fallbackEmojiForAgentId(agentId);
+}

package/dist/shared/direct-work-lock.d.ts

@@ -0,0 +1,10 @@
+export type DirectWorkLock = {
+    task_id: string;
+    agent: string;
+    slug: string;
+    branch: string;
+    started_at: string;
+};
+export declare function directWorkLockPath(agentplaneDir: string): string;
+export declare function readDirectWorkLock(agentplaneDir: string): Promise<DirectWorkLock | null>;
+//# sourceMappingURL=direct-work-lock.d.ts.map

package/dist/shared/direct-work-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direct-work-lock.d.ts","sourceRoot":"","sources":["../../src/shared/direct-work-lock.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM,CAEhE;AAED,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAkB9F"}

package/dist/shared/direct-work-lock.js

@@ -0,0 +1,24 @@
+import { readFile } from "node:fs/promises";
+import path from "node:path";
+export function directWorkLockPath(agentplaneDir) {
+    return path.join(agentplaneDir, "cache", "direct-work.json");
+}
+export async function readDirectWorkLock(agentplaneDir) {
+    try {
+        const text = await readFile(directWorkLockPath(agentplaneDir), "utf8");
+        const parsed = JSON.parse(text);
+        if (!parsed || typeof parsed !== "object")
+            return null;
+        if (typeof parsed.task_id !== "string" ||
+            typeof parsed.agent !== "string" ||
+            typeof parsed.slug !== "string" ||
+            typeof parsed.branch !== "string" ||
+            typeof parsed.started_at !== "string") {
+            return null;
+        }
+        return parsed;
+    }
+    catch {
+        return null;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentplane",
-  "version": "0.2.5",
+  "version": "0.2.12",
   "description": "Agent Plane CLI for task workflows, recipes, and project automation.",
   "keywords": [
     "agentplane",
@@ -54,7 +54,7 @@
     "prepublishOnly": "npm run prepack"
   },
   "dependencies": {
-    "@agentplaneorg/core": "0.2.5",
+    "@agentplaneorg/core": "0.2.6",
     "yauzl": "^2.10.0"
   },
   "devDependencies": {