@afokapu/atdd-flow 0.2.1 → 0.2.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@afokapu/atdd-flow",
-  "version": "0.2.1",
+  "version": "0.2.3",
   "description": "Filesystem-first Desk registry for projects, seats, tasks, threads, and handoffs.",
   "type": "module",
   "bin": {

package/src/adapters.ts

@@ -24,13 +24,14 @@ export function discoverAddress(application: string, environment: Environment =
   return discover();
 }
 
-export function notificationCommand(application: string, address: string, notice: string): string[] | undefined {
+export function notificationCommand(application: string, address: string, notice: string, herdrSession?: string): string[] | undefined {
   const commands: Record<string, () => string[] | undefined> = {
     tmux: () => ["tmux", "send-keys", "-t", address, notice, "Enter"],
-    // A Herdr pane id is the canonical runtime address. `pane send-text` is
-    // supported by both standalone Herdr and TUIOS's embedded Herdr server;
-    // `agent send` is not available on every embedded-server version.
-    herdr: () => ["herdr", "pane", "send-text", address, notice],
+    // Herdr resolves the live agent from its stable pane address and submits
+    // an ordered prompt through its agent-control API. Do not fall back to
+    // pane text injection: a Desk message remains durable when an older host
+    // cannot provide agent.prompt.
+    herdr: () => ["herdr", ...(herdrSession ? ["--session", herdrSession] : []), "agent", "prompt", address, notice],
     tuios: () => {
       const separator = address.indexOf("/");
       if (separator < 1 || separator === address.length - 1) return undefined;
@@ -81,8 +82,8 @@ export function launchedAddress(application: string, placement: string, output:
   return `${placement}/${window}`;
 }
 
-export async function notify(application: string, address: string, notice: string) {
-  const command = notificationCommand(application, address, notice);
+export async function notify(application: string, address: string, notice: string, herdrSession?: string) {
+  const command = notificationCommand(application, address, notice, herdrSession);
   if (!command) return;
   await run(command, true);
 }

package/src/core.ts

@@ -14,6 +14,8 @@ export type Desk = {
   schema: "atdd-workflow/desk/v1";
   desk: string;
   application: string;
+  /** Native Herdr session used for Desk notifications when application is herdr. */
+  herdr_session?: string;
   /** Named commands that model portfolio entries may resolve through. */
   executables?: Record<string, string>;
   aliases?: Record<string, string>;

package/src/reviews.ts

@@ -360,7 +360,7 @@ export async function launchBehavioralReview(
   const nativeAddress = launchedAddress(application, placement, output);
   await bind(root, reviewer.address, ["--application", application, "--address", nativeAddress], modelId);
   try {
-    await notify(application, nativeAddress, reviewerNotice(projectName, taskId, attempt, conventionSource.text));
+    await notify(application, nativeAddress, reviewerNotice(projectName, taskId, attempt, conventionSource.text), config.herdr_session);
   } catch (error) {
     console.warn(`Behavioral review notification for ${reviewer.address} was not delivered: ${(error as Error).message}`);
   }

package/src/seats.ts

@@ -36,6 +36,9 @@ export function resolveExecutable(config: Desk, agent: string) {
 }
 
 export async function init(root: string, name: string, args: string[]) {
+  if (await exists(paths(root).desk)) {
+    throw new Error(`Desk registry already exists at ${paths(root).desk}; refusing to overwrite it. Use an existing Desk command, or choose a new directory.`);
+  }
   const config = { schema: "atdd-workflow/desk/v1" as const, desk: name, application: "tuios", executables: defaultExecutables() };
   await Promise.all([mkdir(paths(root).work, { recursive: true }), mkdir(paths(root).threads, { recursive: true })]);
   await Promise.all([atomicYaml(paths(root).desk, config), atomicYaml(paths(root).models, defaultModels())]);
@@ -161,7 +164,7 @@ async function chooseLaunchModel(root: string, config: Desk, record: Seat, portf
 }
 
 export const launchNotice = (address: string) =>
-  `SYSTEM: you are ${address}. Read your durable seat and assigned task with: atdd-flow open ${address}. Continue assigned in_progress work until it is review-ready or explicitly blocked.`;
+  `SYSTEM: you are ${address}. Read your durable seat and assigned task with: atdd-flow open ${address}. Use the installed atdd-flow command; never use bunx to replace it or run atdd-flow init against an existing Desk. If your native pane binding differs from the Desk record, report it to the operator or coordinator. Continue assigned in_progress work until it is review-ready or explicitly blocked.`;
 
 export async function launch(root: string, address: string, args: string[]) {
   const resolved = await canonicalAddress(root, address);
@@ -191,7 +194,7 @@ export async function launch(root: string, address: string, args: string[]) {
   const nativeAddress = launchedAddress(application, placement, output);
   await bind(root, resolved, ["--application", application, "--address", nativeAddress], selectedModel);
   const notice = launchNotice(resolved);
-  try { await notify(application, nativeAddress, notice); }
+  try { await notify(application, nativeAddress, notice, config.herdr_session); }
   catch (error) { console.warn(`Launch notification for ${resolved} was not delivered: ${(error as Error).message}`); }
 }
 

package/src/threads.ts

@@ -1,7 +1,7 @@
 import { readdir } from "node:fs/promises";
 import { notify } from "./adapters";
 import {
-  atomicYaml, canonicalAddress, has, id, now, paths, project, readYaml,
+  atomicYaml, canonicalAddress, desk, has, id, now, paths, project, readYaml,
   required, seat, words,
 } from "./core";
 
@@ -69,7 +69,7 @@ async function inject(root: string, address: string, message: Message, threadId:
   if (!nativeAddress) return;
   const file = paths(root).message(threadId, message.id);
   const notice = `SYSTEM: new thread mail ${message.id} from ${message.from}. Read ${file}`;
-  try { await notify(runtime.application, nativeAddress, notice); }
+  try { await notify(runtime.application, nativeAddress, notice, (await desk(root)).herdr_session); }
   catch (error) { console.warn(`Notification for ${address} was not delivered: ${(error as Error).message}`); }
 }