@adhdev/daemon-core 0.9.76-rc.56 → 0.9.76-rc.58

package/dist/repo-mesh-types.d.ts

@@ -56,12 +56,24 @@ export interface RepoMeshPolicy {
      */
     sessionCleanupOnNodeRemove?: RepoMeshSessionCleanupMode;
 }
+export interface RepoMeshRelatedRepo {
+    /** Stable display label for an explicitly configured associated checkout. */
+    label: string;
+    /** Absolute checkout/workspace path for git freshness probes. */
+    workspace: string;
+}
 export interface RepoMeshNodePolicy {
     readOnly?: boolean;
     canPush?: boolean;
     maxConcurrentSessions?: number;
     /** Ordered provider preference used when mesh_launch_session omits an explicit type. */
     providerPriority?: string[];
+    /**
+     * Optional associated/external repos that must be checked alongside this node.
+     * These are explicit policy/config entries only; Repo Mesh does not auto-discover
+     * sibling paths so freshness checks stay fail-closed and non-surprising.
+     */
+    relatedRepos?: RepoMeshRelatedRepo[];
 }
 export declare const DEFAULT_MESH_POLICY: RepoMeshPolicy;
 export interface RepoMeshNodeCapabilities {
@@ -162,6 +174,8 @@ export interface LocalMeshNodeEntry {
     worktreeBranch?: string;
     /** Node ID this worktree was cloned from */
     clonedFromNodeId?: string;
+    /** Optional associated/external repos configured as node metadata. */
+    relatedRepos?: RepoMeshRelatedRepo[];
 }
 export interface RepoMeshStatus {
     meshId: string;

package/dist/types.d.ts

@@ -42,6 +42,15 @@ export interface ChatMessage {
     /** Optional: fiber metadata */
     _type?: string;
     _sub?: string;
+    /** Transcript visibility/audience contract for separating chat-visible content from internal/debug runtime rows. */
+    visibility?: 'visible' | 'user' | 'chat' | 'hidden' | 'debug' | 'internal' | (string & {});
+    transcriptVisibility?: 'visible' | 'user' | 'chat' | 'hidden' | 'debug' | 'internal' | (string & {});
+    audience?: 'chat' | 'debug' | 'trace' | 'internal' | (string & {});
+    source?: 'assistant_text' | 'tool_call' | 'terminal_command' | 'runtime_activity' | 'runtime_status' | 'provider_chrome' | 'control' | (string & {});
+    userFacing?: boolean;
+    internal?: boolean;
+    isInternal?: boolean;
+    debug?: boolean;
     /** Meta information for thought/terminal logs etc */
     meta?: {
         label?: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adhdev/daemon-core",
-  "version": "0.9.76-rc.56",
+  "version": "0.9.76-rc.58",
   "description": "ADHDev daemon core — CDP, IDE detection, providers, command execution",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/src/index.ts

@@ -88,6 +88,7 @@ export type {
   RepoMeshNodeHealth,
   RepoMeshPolicy,
   RepoMeshNodePolicy,
+  RepoMeshRelatedRepo,
   RepoMeshNodeCapabilities,
   DetectedCommand,
   ProjectContextSnapshot,

package/src/mesh/coordinator-prompt.ts

@@ -145,8 +145,8 @@ const WORKFLOW_SECTION = `## Orchestration Workflow
    b. If you need branch isolation for parallel work, call \`mesh_clone_node\` to create a worktree node first.
    c. If no session exists, call \`mesh_launch_session\` to start one.
    d. Call \`mesh_send_task\` with a **complete, self-contained** instruction that includes all context the agent needs (file paths, line numbers, what to change, why). Do not send partial instructions expecting future follow-up.
-4. **Monitor** — Periodically call \`mesh_read_chat\` to check progress. Handle approvals via \`mesh_approve\`.
-5. **Verify** — When a task reports completion, call \`mesh_git_status\` to verify changes were made.
+4. **Monitor** — Prefer event-driven completion/status notifications. Do **not** poll \`mesh_read_chat\` repeatedly just because the delegated session has not produced a final assistant message yet; tool/terminal activity means work may still be in progress. Use at most one compact \`mesh_read_chat\` check after a completion/approval signal, an explicit user status request, or a real timeout/stall. Handle approvals via \`mesh_approve\`.
+5. **Verify** — When a task reports completion or git work is visible, call \`mesh_git_status\` to verify changes were made.
 6. **Checkpoint** — Call \`mesh_checkpoint\` to save the work.
 7. **Clean up** — Remove worktree nodes via \`mesh_remove_node\` after their work is merged or no longer needed.
 8. **Report** — Summarize what was done, what changed, and any issues.`;
@@ -162,8 +162,8 @@ function buildRulesSection(coordinatorCliType?: string): string {
 - **Delegate analysis too.** If you need to understand a bug or explore the codebase, send that investigation as a task to a node. Do not do it yourself.
 - **Respect explicit provider requests.** If the user names an agent/provider, pass the matching provider type to \`mesh_launch_session\`: Hermes → \`hermes-cli\`, Claude Code/Claude → \`claude-cli\`, Codex → \`codex-cli\`, Gemini → \`gemini-cli\`. Never substitute \`claude-cli\` just because the coordinator itself is Claude Code.
 - **Front-load the task message.** When calling \`mesh_send_task\`, include everything the agent needs: what files to touch, what the problem is, what the fix should look like. The agent won't ask follow-up questions.
-- **Don't inspect code.** Trust the agent's output. Verify via \`mesh_git_status\`, not by reading source files.
-- **Don't over-parallelize.** Start with 1-2 concurrent tasks. Scale up if they succeed.
+- **Don't inspect code.** Treat delegated agent summaries as self-reports, not verification. Verify side effects via \`mesh_git_status\` (including related repo freshness when configured), not by reading source files.
+- **Don't over-parallelize.** Start with 1-2 concurrent tasks. Scale up if they succeed. Never launch a duplicate session or second worker solely because \`mesh_read_chat\` has no final assistant message while the delegated session is still showing tool/terminal activity.
 - **Handle failures gracefully.** If a task fails, read the chat to understand why, then retry or reassign.
 - **Keep the user informed.** Report progress after each delegation round — one or two sentences, not a narration.
 - **Respect node capabilities.** Don't send build tasks to read-only nodes. Don't push from nodes that aren't allowed to.

package/src/providers/chat-message-normalization.ts

@@ -183,11 +183,16 @@ function readStringField(value: unknown): string {
   return typeof value === 'string' ? value.trim().toLowerCase() : '';
 }
 
+function readVisibilityField(message: ChatMessage, meta: Record<string, unknown> | null): string {
+  const record = message as ChatMessage & Record<string, unknown>;
+  return readStringField(record.visibility ?? record.transcriptVisibility ?? meta?.visibility ?? meta?.transcriptVisibility);
+}
+
 function isExplicitlyHiddenFromTranscript(message: ChatMessage, meta: Record<string, unknown> | null): boolean {
   const record = message as ChatMessage & Record<string, unknown>;
-  const visibility = readStringField(record.visibility || meta?.visibility || meta?.transcriptVisibility);
-  const audience = readStringField(record.audience || meta?.audience);
-  const source = readStringField(record.source || meta?.source);
+  const visibility = readVisibilityField(message, meta);
+  const audience = readStringField(record.audience ?? meta?.audience);
+  const source = readStringField(record.source ?? meta?.source);
 
   return visibility === 'hidden'
     || visibility === 'debug'
@@ -196,6 +201,7 @@ function isExplicitlyHiddenFromTranscript(message: ChatMessage, meta: Record<str
     || audience === 'trace'
     || audience === 'internal'
     || source === 'runtime_status'
+    || source === 'runtime_activity'
     || source === 'provider_chrome'
     || source === 'control'
     || record.internal === true
@@ -210,10 +216,11 @@ function isExplicitlyHiddenFromTranscript(message: ChatMessage, meta: Record<str
 
 function isExplicitlyVisibleInTranscript(message: ChatMessage, meta: Record<string, unknown> | null): boolean {
   const record = message as ChatMessage & Record<string, unknown>;
-  const visibility = readStringField(record.visibility || meta?.visibility || meta?.transcriptVisibility);
-  const audience = readStringField(record.audience || meta?.audience);
+  const visibility = readVisibilityField(message, meta);
+  const audience = readStringField(record.audience ?? meta?.audience);
   return visibility === 'visible'
     || visibility === 'user'
+    || visibility === 'chat'
     || audience === 'chat'
     || record.userFacing === true
     || meta?.userFacing === true;

package/src/providers/read-chat-contract.ts

@@ -77,6 +77,14 @@ function validateMessage(message: unknown, source: string, index: number): ChatM
   if (typeof message.senderName === 'string') normalized.senderName = message.senderName
   if (typeof (message as any)._type === 'string') normalized._type = (message as any)._type
   if (typeof (message as any)._sub === 'string') normalized._sub = (message as any)._sub
+  if (typeof (message as any).visibility === 'string') normalized.visibility = (message as any).visibility
+  if (typeof (message as any).transcriptVisibility === 'string') normalized.transcriptVisibility = (message as any).transcriptVisibility
+  if (typeof (message as any).audience === 'string') normalized.audience = (message as any).audience
+  if (typeof (message as any).source === 'string') normalized.source = (message as any).source
+  if (typeof (message as any).userFacing === 'boolean') normalized.userFacing = (message as any).userFacing
+  if (typeof (message as any).internal === 'boolean') normalized.internal = (message as any).internal
+  if (typeof (message as any).isInternal === 'boolean') normalized.isInternal = (message as any).isInternal
+  if (typeof (message as any).debug === 'boolean') normalized.debug = (message as any).debug
 
   return normalized
 }

package/src/repo-mesh-types.ts

@@ -73,12 +73,25 @@ export interface RepoMeshPolicy {
     sessionCleanupOnNodeRemove?: RepoMeshSessionCleanupMode;
 }
 
+export interface RepoMeshRelatedRepo {
+    /** Stable display label for an explicitly configured associated checkout. */
+    label: string;
+    /** Absolute checkout/workspace path for git freshness probes. */
+    workspace: string;
+}
+
 export interface RepoMeshNodePolicy {
     readOnly?: boolean;
     canPush?: boolean;
     maxConcurrentSessions?: number;
     /** Ordered provider preference used when mesh_launch_session omits an explicit type. */
     providerPriority?: string[];
+    /**
+     * Optional associated/external repos that must be checked alongside this node.
+     * These are explicit policy/config entries only; Repo Mesh does not auto-discover
+     * sibling paths so freshness checks stay fail-closed and non-surprising.
+     */
+    relatedRepos?: RepoMeshRelatedRepo[];
 }
 
 export const DEFAULT_MESH_POLICY: RepoMeshPolicy = {
@@ -204,6 +217,8 @@ export interface LocalMeshNodeEntry {
     worktreeBranch?: string;
     /** Node ID this worktree was cloned from */
     clonedFromNodeId?: string;
+    /** Optional associated/external repos configured as node metadata. */
+    relatedRepos?: RepoMeshRelatedRepo[];
 }
 
 // ─── Mesh Status (runtime, not persisted) ───────

package/src/types.ts

@@ -49,6 +49,15 @@ export interface ChatMessage {
   /** Optional: fiber metadata */
   _type?: string;
   _sub?: string;
+  /** Transcript visibility/audience contract for separating chat-visible content from internal/debug runtime rows. */
+  visibility?: 'visible' | 'user' | 'chat' | 'hidden' | 'debug' | 'internal' | (string & {});
+  transcriptVisibility?: 'visible' | 'user' | 'chat' | 'hidden' | 'debug' | 'internal' | (string & {});
+  audience?: 'chat' | 'debug' | 'trace' | 'internal' | (string & {});
+  source?: 'assistant_text' | 'tool_call' | 'terminal_command' | 'runtime_activity' | 'runtime_status' | 'provider_chrome' | 'control' | (string & {});
+  userFacing?: boolean;
+  internal?: boolean;
+  isInternal?: boolean;
+  debug?: boolean;
   /** Meta information for thought/terminal logs etc */
   meta?: { label?: string; isRunning?: boolean } | Record<string, any>;
   /** Sender name for shared sessions */