@adhdev/daemon-core 0.9.82-rc.522 → 0.9.82-rc.524

package/dist/mesh/mesh-queue-assignment.d.ts

@@ -170,6 +170,19 @@ export declare function maybeAutoFastForwardIdleNode(components: DaemonComponent
  * nodes are the sole continuous target.
  */
 export declare function runContinuousAutoFastForwardScan(components: DaemonComponents, mesh: any): Promise<void>;
+/**
+ * DS3: drain and act on `coordinator_catchup` markers queued by a remote node's Refinery
+ * after it pushed the base branch to origin. The originating coordinator is THIS daemon;
+ * its local base checkout is now behind origin. Bring it up to date with a guarded ff-only
+ * merge — but ONLY when the coordinator base node has no active mesh work (busy → leave the
+ * marker for the next idle tick) and fastForwardMeshNode's own clean/ahead=0/behind>0 gate
+ * is satisfied (ahead/diverged/dirty → it returns a structured block, never a rebase).
+ *
+ * These markers are drained on a DEDICATED event-name filter so they never reach the
+ * coordinator chat-injection path (they are actions, not messages). A busy/blocked node
+ * re-queues the marker so a later idle tick retries; a successful/no-op ff consumes it.
+ */
+export declare function runPendingCoordinatorCatchupScan(components: DaemonComponents, mesh: any): Promise<void>;
 export declare function runIdleMaintenanceThenAssignQueue(components: DaemonComponents, args: {
     meshId: string;
     nodeId: string;

package/dist/mesh/mesh-refine-gates.d.ts

@@ -12,6 +12,7 @@
  * (erased at compile time — no runtime import cycle).
  */
 import type { ChangedPackageClassification } from '../git/git-status.js';
+import type { MeshRefineValidationScope } from '../mesh/refine-config.js';
 import type { WorktreeBootstrapState } from '../mesh/worktree-bootstrap-config.js';
 import type { CommandRouterResult } from '../commands/router.js';
 export type MeshCoordinatorConfigFormat = 'claude_mcp_json' | 'hermes_config_yaml';
@@ -64,8 +65,12 @@ type MeshRefineValidationSummary = {
     changeImpact?: {
         isDaemonAffecting: boolean;
         affectedPackages: string[];
+        /** DOCS-ROOT: three-way change area ('none' | 'web' | 'daemon') when known. */
+        changeArea?: MeshRefineValidationScope;
         /** displayCommands skipped because the daemon scope is unaffected. */
         skippedDaemonCommands?: string[];
+        /** DOCS-ROOT: displayCommands skipped because the change-area scope excluded them. */
+        skippedScopeCommands?: string[];
     };
 };
 type MeshRefineStageStatus = 'passed' | 'failed' | 'skipped';

package/dist/mesh/refine-config.d.ts

@@ -1,5 +1,20 @@
 export declare const MESH_REFINE_VALIDATION_CATEGORIES: readonly ["typecheck", "test", "lint", "build"];
 export type MeshRefineValidationCategory = typeof MESH_REFINE_VALIDATION_CATEGORIES[number];
+/**
+ * DOCS-ROOT: change-impact scope for a validation command. Mirrors ChangeImpactKind
+ * (git-status) so a command can declare WHICH change areas it should run in:
+ *   'daemon' — run when a daemon-runtime package changed,
+ *   'web'    — run when a web package changed,
+ *   'none'   — run when ONLY docs/markers changed (a docs-only branch).
+ * A command with NO `scopes` runs in every area (backward-compatible: the full set
+ * runs as before). This lets a repo declare a light docs-only profile — e.g. a
+ * `docs:verify` command scoped `['none']` — that runs on a docs-only branch while the
+ * heavy typecheck/test commands (implicitly all-areas, or scoped ['web','daemon'])
+ * are skipped. The scoping is applied only when the branch's changeArea is known;
+ * fail-open (unknown change area → every command runs).
+ */
+export declare const MESH_REFINE_VALIDATION_SCOPES: readonly ["none", "web", "daemon"];
+export type MeshRefineValidationScope = typeof MESH_REFINE_VALIDATION_SCOPES[number];
 export interface RepoMeshRefineValidationCommandConfig {
     /** Executable name or a whitespace-tokenized command string. Never executed through a shell. */
     command: string;
@@ -10,6 +25,12 @@ export interface RepoMeshRefineValidationCommandConfig {
     timeoutMs?: number;
     outputLimitBytes?: number;
     env?: Record<string, string>;
+    /**
+     * DOCS-ROOT: change-impact scopes this command runs in ('none' | 'web' | 'daemon').
+     * Omitted → runs in every area (backward-compatible). Empty array is treated the
+     * same as omitted (runs everywhere) rather than "runs nowhere".
+     */
+    scopes?: MeshRefineValidationScope[];
 }
 export interface RepoMeshRefineConfig {
     version: 1;
@@ -50,6 +71,8 @@ export interface MeshRefineValidationCommandPlan {
     timeoutMs?: number;
     outputLimitBytes?: number;
     env?: Record<string, string>;
+    /** DOCS-ROOT: normalized change-impact scopes; absent → runs in every area. */
+    scopes?: MeshRefineValidationScope[];
 }
 export interface MeshRefineConfigLoadResult {
     config?: RepoMeshRefineConfig;
@@ -142,6 +165,13 @@ export declare const MESH_REFINE_CONFIG_SCHEMA: {
                                     readonly type: "string";
                                 };
                             };
+                            readonly scopes: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly enum: readonly ["none", "web", "daemon"];
+                                };
+                                readonly description: "DOCS-ROOT: change-impact scopes this command runs in ('none'=docs-only, 'web', 'daemon'). Omitted/empty → runs in every area.";
+                            };
                         };
                     };
                 };
@@ -186,6 +216,12 @@ export declare const MESH_REFINE_CONFIG_SCHEMA: {
                                     readonly type: "string";
                                 };
                             };
+                            readonly scopes: {
+                                readonly type: "array";
+                                readonly items: {
+                                    readonly enum: readonly ["none", "web", "daemon"];
+                                };
+                            };
                         };
                     };
                 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adhdev/daemon-core",
-  "version": "0.9.82-rc.522",
+  "version": "0.9.82-rc.524",
   "description": "ADHDev daemon core — CDP, IDE detection, providers, command execution",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -47,8 +47,8 @@
   "author": "vilmire",
   "license": "AGPL-3.0-or-later",
   "dependencies": {
-    "@adhdev/mesh-shared": "0.9.82-rc.522",
-    "@adhdev/session-host-core": "0.9.82-rc.522",
+    "@adhdev/mesh-shared": "0.9.82-rc.524",
+    "@adhdev/session-host-core": "0.9.82-rc.524",
     "@agentclientprotocol/sdk": "^0.16.1",
     "ajv": "^8.20.0",
     "ajv-formats": "^3.0.1",