palmier 0.1.6 → 0.1.7

package/README.md

@@ -63,7 +63,10 @@ cat ~/.config/palmier/agent.json
 ## How It Works
 
 - The agent runs as a **systemd user service**, staying alive in the background.
-- Incoming tasks from the platform are stored as `TASK.md` files in a local `tasks/` directory.
+- The persistent process (`palmier serve`) is a NATS RPC handler. It derives the RPC method from the NATS subject (e.g., `...rpc.task.create` → `task.create`) and treats the message body as request parameters.
+- **Task IDs** are generated by the agent as UUIDs.
+- All RPC responses (`task.list`, `task.create`, `task.update`) return **flat task objects** — frontmatter fields at the top level, not nested under a `frontmatter` key.
+- Incoming tasks are stored as `TASK.md` files in a local `tasks/` directory.
 - Task execution spawns **Claude Code in a PTY**, giving the AI full CLI access within the project.
 - **Hooks** intercept Claude Code permission, confirmation, and input prompts, resolving them remotely via NATS KV so tasks can run unattended.
 

package/dist/commands/serve.js

@@ -1,3 +1,4 @@
+import { randomUUID } from "crypto";
 import { execSync } from "child_process";
 import * as fs from "fs";
 import { StringCodec } from "nats";
@@ -75,9 +76,6 @@ export async function serveCommand() {
             msg.respond(sc.encode(JSON.stringify(response)));
         }
     }
-    function toKebab(str) {
-        return str.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
-    }
     function flattenTask(task, status) {
         return { ...task.frontmatter, body: task.body, ...(status != null ? { status } : {}) };
     }
@@ -91,7 +89,7 @@ export async function serveCommand() {
             }
             case "task.create": {
                 const params = request.params;
-                const id = toKebab(params.name);
+                const id = randomUUID();
                 const taskDir = getTaskDir(config.projectRoot, id);
                 const task = {
                     frontmatter: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "palmier",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "Palmier agent CLI - provisions, executes tasks, and serves NATS RPC",
   "license": "ISC",
   "author": "Hongxu Cai",

package/src/commands/serve.ts

@@ -1,3 +1,4 @@
+import { randomUUID } from "crypto";
 import { execSync } from "child_process";
 import * as fs from "fs";
 import { StringCodec } from "nats";
@@ -86,10 +87,6 @@ export async function serveCommand(): Promise<void> {
     }
   }
 
-  function toKebab(str: string): string {
-    return str.trim().toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
-  }
-
   function flattenTask(task: ParsedTask, status?: unknown) {
     return { ...task.frontmatter, body: task.body, ...(status != null ? { status } : {}) };
   }
@@ -116,7 +113,7 @@ export async function serveCommand(): Promise<void> {
           body?: string;
         };
 
-        const id = toKebab(params.name);
+        const id = randomUUID();
         const taskDir = getTaskDir(config.projectRoot, id);
         const task = {
           frontmatter: {