@harness-engineering/orchestrator 0.8.2 → 0.8.3

package/dist/index.d.mts

@@ -1099,6 +1099,25 @@ declare class WorkspaceManager {
      * swallowed — dispatch should not be blocked by transient network issues.
      */
     private tryFetch;
+    /**
+     * Default paths seeded into a fresh worktree when {@link WorkspaceConfig.seedPaths}
+     * is unset — the artifacts produced by the brainstorm → orchestrator handoff.
+     */
+    private static readonly DEFAULT_SEED_PATHS;
+    /**
+     * Copies the configured seed paths from the root working tree into a
+     * freshly-created worktree, overlaying the committed checkout.
+     *
+     * A new worktree is based on a committed remote ref, so it does not contain
+     * uncommitted artifacts that exist only in the root working tree (a
+     * just-written proposal under `.harness/proposals/`, a promoted row in
+     * `docs/roadmap.md`). Seeding carries them over so a dispatched agent sees
+     * the same state the orchestrator dispatched from.
+     *
+     * Best-effort by design: a missing source is skipped, and a copy failure is
+     * swallowed — neither must ever block dispatch.
+     */
+    private seedWorkspace;
     /**
      * Resolves the ref that new worktrees should be based on.
      *
@@ -1487,6 +1506,18 @@ declare class BackendRouter {
     private validateReferences;
 }
 
+/**
+ * Derives the worktree seed paths from a workflow config when
+ * {@link WorkspaceConfig.seedPaths} is not set explicitly.
+ *
+ * A new worktree is checked out from a committed remote ref and therefore lacks
+ * the uncommitted artifacts of the brainstorm → orchestrator handoff. Seeding
+ * carries them over: the proposal directory, plus the roadmap file at its
+ * *configured* location — a roadmap tracker may point `filePath` somewhere
+ * other than the default `docs/roadmap.md`, and the default seed list would
+ * otherwise miss it.
+ */
+declare function deriveSeedPaths(config: WorkflowConfig): string[];
 /**
  * The central orchestrator that manages the lifecycle of coding agents.
  *
@@ -2817,4 +2848,4 @@ declare function emitProposalCreated(bus: EventEmitter, proposal: SkillProposal)
 declare function emitProposalApproved(bus: EventEmitter, proposal: SkillProposal): void;
 declare function emitProposalRejected(bus: EventEmitter, proposal: SkillProposal): void;
 
-export { type AgentUpdateEvent, AnalysisArchive, type AnalysisRecord, type ApplyEventResult, type ArtifactPresence, type AttemptStats, BUILT_IN_TASKS, BackendDefSchema, BackendRouter, type BackendRouterOptions, type BaseRefFallbackEvent, type BuildArchiveHooksOptions, ClaimManager, type ClaimManagerConfig, type CleanWorkspaceEffect, type CreateTokenInput, type CreateTokenResult, type CustomTaskValidationError, type DispatchEffect, type EmitLogEffect, type EscalateEffect, type ExecFileFn$1 as ExecFileFn, type FromConfigOptions, GateNotReadyError, type GateResult, GateRunError, type Highlight, type HighlightsInfo, type IndexedDoc, InteractionQueue, type LinearGraphQLExtension, LinearGraphQLStub, type LiveSession, LocalModelResolver, type LocalModelResolverOptions, MAX_ATTEMPTS, type MigrationResult, MockBackend, type NotificationSink, type NotificationSinkDeliverInput, ORCHESTRATOR_IDENTITY_FILE, Orchestrator, OrchestratorBackendFactory, type OrchestratorBackendFactoryOptions, type OrchestratorContext, type OrchestratorEvent, type OrchestratorState, PRDetector, type PRDetectorLogger, type PendingInteraction, type PersistedOutputEntry, PromotionError, type PromotionResult, PromptRenderer, type ProposalApprovedData, type ProposalCreatedData, type ProposalRejectedData, type PublishedIndex, type QueueInsertInput, type QueueRow, type QueueStats, RETRY_DELAYS_MS, type RateLimitSnapshot as RateLimitComputeSnapshot, type RateLimitConfig, type RateLimitSnapshot$1 as RateLimitSnapshot, type RegistryEntry, type ReleaseClaimEffect, type ResolverLogger, type RetryEntry, type RetryFiredEvent, RoadmapTrackerAdapter, RoutingConfigSchema, RoutingValueSchema, type RunAttemptPhase, type RunOrigin, type RunningEntry, type ScheduleRetryEffect, type SearchOptions, type SideEffect, SinkConfigError, SinkRegistry, type SkillCatalogEntry, SlackSink, type SlackSinkOptions, SqliteSearchIndex, type StallDetectedEvent, type StopEffect, type StreamManifest, StreamRecorder, type SummarizeContext, type SummarizeResult, type SyncMainOptions, type SyncMainResult, type SyncSkipReason, type TaskDefinition, TaskOutputStore, type TaskType, type TickEvent, TokenStore, type TokenTotals, type TriageConfig, type TriageDecision, type TriageSignals, type TriageSkill, type UpdateTokensEffect, type ValidateWorkflowConfigOptions, type ValidatedWorkflowConfig, WebhookQueue, type WorkerExitEvent, WorkflowLoader, WorkspaceHooks, WorkspaceManager, type WorkspaceManagerOptions, applyEvent, artifactPresenceFromIssue, buildArchiveHooks, calculateRetryDelay, canDispatch, computeRateLimitDelay, createBackend, createEmptyState, crossFieldRoutingIssues, defaultFetchModels, detectScopeTier, discoverSkillCatalog, discoverSkillCatalogNames, emitProposalApproved, emitProposalCreated, emitProposalRejected, extractHighlights, extractTitlePrefix, getAvailableSlots, getDefaultConfig, getPerStateCount, indexSessionDirectory, isEligible, isSummaryEnabled, launchTUI, loadPublishedIndex, migrateAgentConfig, normalizeFts5Query, normalizeLocalModel, openSearchIndex, promote, reconcile, reindexFromArchive, renderAnalysisComment, renderLlmSummaryMarkdown, renderPRComment, resolveEscalationConfig, resolveOrchestratorId, routeIssue, routingWarnings, runGate, savePublishedIndex, searchIndexPath, selectCandidates, sortCandidates, summarizeArchivedSession, syncMain, triageIssue, truncateForBudget, validateCustomTasks, validateWorkflowConfig, wireNotificationSinks, wrapAsEnvelope };
+export { type AgentUpdateEvent, AnalysisArchive, type AnalysisRecord, type ApplyEventResult, type ArtifactPresence, type AttemptStats, BUILT_IN_TASKS, BackendDefSchema, BackendRouter, type BackendRouterOptions, type BaseRefFallbackEvent, type BuildArchiveHooksOptions, ClaimManager, type ClaimManagerConfig, type CleanWorkspaceEffect, type CreateTokenInput, type CreateTokenResult, type CustomTaskValidationError, type DispatchEffect, type EmitLogEffect, type EscalateEffect, type ExecFileFn$1 as ExecFileFn, type FromConfigOptions, GateNotReadyError, type GateResult, GateRunError, type Highlight, type HighlightsInfo, type IndexedDoc, InteractionQueue, type LinearGraphQLExtension, LinearGraphQLStub, type LiveSession, LocalModelResolver, type LocalModelResolverOptions, MAX_ATTEMPTS, type MigrationResult, MockBackend, type NotificationSink, type NotificationSinkDeliverInput, ORCHESTRATOR_IDENTITY_FILE, Orchestrator, OrchestratorBackendFactory, type OrchestratorBackendFactoryOptions, type OrchestratorContext, type OrchestratorEvent, type OrchestratorState, PRDetector, type PRDetectorLogger, type PendingInteraction, type PersistedOutputEntry, PromotionError, type PromotionResult, PromptRenderer, type ProposalApprovedData, type ProposalCreatedData, type ProposalRejectedData, type PublishedIndex, type QueueInsertInput, type QueueRow, type QueueStats, RETRY_DELAYS_MS, type RateLimitSnapshot as RateLimitComputeSnapshot, type RateLimitConfig, type RateLimitSnapshot$1 as RateLimitSnapshot, type RegistryEntry, type ReleaseClaimEffect, type ResolverLogger, type RetryEntry, type RetryFiredEvent, RoadmapTrackerAdapter, RoutingConfigSchema, RoutingValueSchema, type RunAttemptPhase, type RunOrigin, type RunningEntry, type ScheduleRetryEffect, type SearchOptions, type SideEffect, SinkConfigError, SinkRegistry, type SkillCatalogEntry, SlackSink, type SlackSinkOptions, SqliteSearchIndex, type StallDetectedEvent, type StopEffect, type StreamManifest, StreamRecorder, type SummarizeContext, type SummarizeResult, type SyncMainOptions, type SyncMainResult, type SyncSkipReason, type TaskDefinition, TaskOutputStore, type TaskType, type TickEvent, TokenStore, type TokenTotals, type TriageConfig, type TriageDecision, type TriageSignals, type TriageSkill, type UpdateTokensEffect, type ValidateWorkflowConfigOptions, type ValidatedWorkflowConfig, WebhookQueue, type WorkerExitEvent, WorkflowLoader, WorkspaceHooks, WorkspaceManager, type WorkspaceManagerOptions, applyEvent, artifactPresenceFromIssue, buildArchiveHooks, calculateRetryDelay, canDispatch, computeRateLimitDelay, createBackend, createEmptyState, crossFieldRoutingIssues, defaultFetchModels, deriveSeedPaths, detectScopeTier, discoverSkillCatalog, discoverSkillCatalogNames, emitProposalApproved, emitProposalCreated, emitProposalRejected, extractHighlights, extractTitlePrefix, getAvailableSlots, getDefaultConfig, getPerStateCount, indexSessionDirectory, isEligible, isSummaryEnabled, launchTUI, loadPublishedIndex, migrateAgentConfig, normalizeFts5Query, normalizeLocalModel, openSearchIndex, promote, reconcile, reindexFromArchive, renderAnalysisComment, renderLlmSummaryMarkdown, renderPRComment, resolveEscalationConfig, resolveOrchestratorId, routeIssue, routingWarnings, runGate, savePublishedIndex, searchIndexPath, selectCandidates, sortCandidates, summarizeArchivedSession, syncMain, triageIssue, truncateForBudget, validateCustomTasks, validateWorkflowConfig, wireNotificationSinks, wrapAsEnvelope };

package/dist/index.d.ts

@@ -1099,6 +1099,25 @@ declare class WorkspaceManager {
      * swallowed — dispatch should not be blocked by transient network issues.
      */
     private tryFetch;
+    /**
+     * Default paths seeded into a fresh worktree when {@link WorkspaceConfig.seedPaths}
+     * is unset — the artifacts produced by the brainstorm → orchestrator handoff.
+     */
+    private static readonly DEFAULT_SEED_PATHS;
+    /**
+     * Copies the configured seed paths from the root working tree into a
+     * freshly-created worktree, overlaying the committed checkout.
+     *
+     * A new worktree is based on a committed remote ref, so it does not contain
+     * uncommitted artifacts that exist only in the root working tree (a
+     * just-written proposal under `.harness/proposals/`, a promoted row in
+     * `docs/roadmap.md`). Seeding carries them over so a dispatched agent sees
+     * the same state the orchestrator dispatched from.
+     *
+     * Best-effort by design: a missing source is skipped, and a copy failure is
+     * swallowed — neither must ever block dispatch.
+     */
+    private seedWorkspace;
     /**
      * Resolves the ref that new worktrees should be based on.
      *
@@ -1487,6 +1506,18 @@ declare class BackendRouter {
     private validateReferences;
 }
 
+/**
+ * Derives the worktree seed paths from a workflow config when
+ * {@link WorkspaceConfig.seedPaths} is not set explicitly.
+ *
+ * A new worktree is checked out from a committed remote ref and therefore lacks
+ * the uncommitted artifacts of the brainstorm → orchestrator handoff. Seeding
+ * carries them over: the proposal directory, plus the roadmap file at its
+ * *configured* location — a roadmap tracker may point `filePath` somewhere
+ * other than the default `docs/roadmap.md`, and the default seed list would
+ * otherwise miss it.
+ */
+declare function deriveSeedPaths(config: WorkflowConfig): string[];
 /**
  * The central orchestrator that manages the lifecycle of coding agents.
  *
@@ -2817,4 +2848,4 @@ declare function emitProposalCreated(bus: EventEmitter, proposal: SkillProposal)
 declare function emitProposalApproved(bus: EventEmitter, proposal: SkillProposal): void;
 declare function emitProposalRejected(bus: EventEmitter, proposal: SkillProposal): void;
 
-export { type AgentUpdateEvent, AnalysisArchive, type AnalysisRecord, type ApplyEventResult, type ArtifactPresence, type AttemptStats, BUILT_IN_TASKS, BackendDefSchema, BackendRouter, type BackendRouterOptions, type BaseRefFallbackEvent, type BuildArchiveHooksOptions, ClaimManager, type ClaimManagerConfig, type CleanWorkspaceEffect, type CreateTokenInput, type CreateTokenResult, type CustomTaskValidationError, type DispatchEffect, type EmitLogEffect, type EscalateEffect, type ExecFileFn$1 as ExecFileFn, type FromConfigOptions, GateNotReadyError, type GateResult, GateRunError, type Highlight, type HighlightsInfo, type IndexedDoc, InteractionQueue, type LinearGraphQLExtension, LinearGraphQLStub, type LiveSession, LocalModelResolver, type LocalModelResolverOptions, MAX_ATTEMPTS, type MigrationResult, MockBackend, type NotificationSink, type NotificationSinkDeliverInput, ORCHESTRATOR_IDENTITY_FILE, Orchestrator, OrchestratorBackendFactory, type OrchestratorBackendFactoryOptions, type OrchestratorContext, type OrchestratorEvent, type OrchestratorState, PRDetector, type PRDetectorLogger, type PendingInteraction, type PersistedOutputEntry, PromotionError, type PromotionResult, PromptRenderer, type ProposalApprovedData, type ProposalCreatedData, type ProposalRejectedData, type PublishedIndex, type QueueInsertInput, type QueueRow, type QueueStats, RETRY_DELAYS_MS, type RateLimitSnapshot as RateLimitComputeSnapshot, type RateLimitConfig, type RateLimitSnapshot$1 as RateLimitSnapshot, type RegistryEntry, type ReleaseClaimEffect, type ResolverLogger, type RetryEntry, type RetryFiredEvent, RoadmapTrackerAdapter, RoutingConfigSchema, RoutingValueSchema, type RunAttemptPhase, type RunOrigin, type RunningEntry, type ScheduleRetryEffect, type SearchOptions, type SideEffect, SinkConfigError, SinkRegistry, type SkillCatalogEntry, SlackSink, type SlackSinkOptions, SqliteSearchIndex, type StallDetectedEvent, type StopEffect, type StreamManifest, StreamRecorder, type SummarizeContext, type SummarizeResult, type SyncMainOptions, type SyncMainResult, type SyncSkipReason, type TaskDefinition, TaskOutputStore, type TaskType, type TickEvent, TokenStore, type TokenTotals, type TriageConfig, type TriageDecision, type TriageSignals, type TriageSkill, type UpdateTokensEffect, type ValidateWorkflowConfigOptions, type ValidatedWorkflowConfig, WebhookQueue, type WorkerExitEvent, WorkflowLoader, WorkspaceHooks, WorkspaceManager, type WorkspaceManagerOptions, applyEvent, artifactPresenceFromIssue, buildArchiveHooks, calculateRetryDelay, canDispatch, computeRateLimitDelay, createBackend, createEmptyState, crossFieldRoutingIssues, defaultFetchModels, detectScopeTier, discoverSkillCatalog, discoverSkillCatalogNames, emitProposalApproved, emitProposalCreated, emitProposalRejected, extractHighlights, extractTitlePrefix, getAvailableSlots, getDefaultConfig, getPerStateCount, indexSessionDirectory, isEligible, isSummaryEnabled, launchTUI, loadPublishedIndex, migrateAgentConfig, normalizeFts5Query, normalizeLocalModel, openSearchIndex, promote, reconcile, reindexFromArchive, renderAnalysisComment, renderLlmSummaryMarkdown, renderPRComment, resolveEscalationConfig, resolveOrchestratorId, routeIssue, routingWarnings, runGate, savePublishedIndex, searchIndexPath, selectCandidates, sortCandidates, summarizeArchivedSession, syncMain, triageIssue, truncateForBudget, validateCustomTasks, validateWorkflowConfig, wireNotificationSinks, wrapAsEnvelope };
+export { type AgentUpdateEvent, AnalysisArchive, type AnalysisRecord, type ApplyEventResult, type ArtifactPresence, type AttemptStats, BUILT_IN_TASKS, BackendDefSchema, BackendRouter, type BackendRouterOptions, type BaseRefFallbackEvent, type BuildArchiveHooksOptions, ClaimManager, type ClaimManagerConfig, type CleanWorkspaceEffect, type CreateTokenInput, type CreateTokenResult, type CustomTaskValidationError, type DispatchEffect, type EmitLogEffect, type EscalateEffect, type ExecFileFn$1 as ExecFileFn, type FromConfigOptions, GateNotReadyError, type GateResult, GateRunError, type Highlight, type HighlightsInfo, type IndexedDoc, InteractionQueue, type LinearGraphQLExtension, LinearGraphQLStub, type LiveSession, LocalModelResolver, type LocalModelResolverOptions, MAX_ATTEMPTS, type MigrationResult, MockBackend, type NotificationSink, type NotificationSinkDeliverInput, ORCHESTRATOR_IDENTITY_FILE, Orchestrator, OrchestratorBackendFactory, type OrchestratorBackendFactoryOptions, type OrchestratorContext, type OrchestratorEvent, type OrchestratorState, PRDetector, type PRDetectorLogger, type PendingInteraction, type PersistedOutputEntry, PromotionError, type PromotionResult, PromptRenderer, type ProposalApprovedData, type ProposalCreatedData, type ProposalRejectedData, type PublishedIndex, type QueueInsertInput, type QueueRow, type QueueStats, RETRY_DELAYS_MS, type RateLimitSnapshot as RateLimitComputeSnapshot, type RateLimitConfig, type RateLimitSnapshot$1 as RateLimitSnapshot, type RegistryEntry, type ReleaseClaimEffect, type ResolverLogger, type RetryEntry, type RetryFiredEvent, RoadmapTrackerAdapter, RoutingConfigSchema, RoutingValueSchema, type RunAttemptPhase, type RunOrigin, type RunningEntry, type ScheduleRetryEffect, type SearchOptions, type SideEffect, SinkConfigError, SinkRegistry, type SkillCatalogEntry, SlackSink, type SlackSinkOptions, SqliteSearchIndex, type StallDetectedEvent, type StopEffect, type StreamManifest, StreamRecorder, type SummarizeContext, type SummarizeResult, type SyncMainOptions, type SyncMainResult, type SyncSkipReason, type TaskDefinition, TaskOutputStore, type TaskType, type TickEvent, TokenStore, type TokenTotals, type TriageConfig, type TriageDecision, type TriageSignals, type TriageSkill, type UpdateTokensEffect, type ValidateWorkflowConfigOptions, type ValidatedWorkflowConfig, WebhookQueue, type WorkerExitEvent, WorkflowLoader, WorkspaceHooks, WorkspaceManager, type WorkspaceManagerOptions, applyEvent, artifactPresenceFromIssue, buildArchiveHooks, calculateRetryDelay, canDispatch, computeRateLimitDelay, createBackend, createEmptyState, crossFieldRoutingIssues, defaultFetchModels, deriveSeedPaths, detectScopeTier, discoverSkillCatalog, discoverSkillCatalogNames, emitProposalApproved, emitProposalCreated, emitProposalRejected, extractHighlights, extractTitlePrefix, getAvailableSlots, getDefaultConfig, getPerStateCount, indexSessionDirectory, isEligible, isSummaryEnabled, launchTUI, loadPublishedIndex, migrateAgentConfig, normalizeFts5Query, normalizeLocalModel, openSearchIndex, promote, reconcile, reindexFromArchive, renderAnalysisComment, renderLlmSummaryMarkdown, renderPRComment, resolveEscalationConfig, resolveOrchestratorId, routeIssue, routingWarnings, runGate, savePublishedIndex, searchIndexPath, selectCandidates, sortCandidates, summarizeArchivedSession, syncMain, triageIssue, truncateForBudget, validateCustomTasks, validateWorkflowConfig, wireNotificationSinks, wrapAsEnvelope };

package/dist/index.js

@@ -73,6 +73,7 @@ __export(index_exports, {
   createEmptyState: () => createEmptyState,
   crossFieldRoutingIssues: () => crossFieldRoutingIssues,
   defaultFetchModels: () => defaultFetchModels,
+  deriveSeedPaths: () => deriveSeedPaths,
   detectScopeTier: () => detectScopeTier,
   discoverSkillCatalog: () => discoverSkillCatalog,
   discoverSkillCatalogNames: () => discoverSkillCatalogNames,
@@ -2459,7 +2460,7 @@ var path8 = __toESM(require("path"));
 var import_node_child_process2 = require("child_process");
 var import_node_util2 = require("util");
 var import_types6 = require("@harness-engineering/types");
-var WorkspaceManager = class {
+var WorkspaceManager = class _WorkspaceManager {
   config;
   /** Absolute path to the git repository root (resolved lazily). */
   repoRoot = null;
@@ -2530,6 +2531,7 @@ var WorkspaceManager = class {
       await this.tryFetch(repoRoot);
       const baseRef = await this.resolveBaseRef(repoRoot);
       await this.git(["worktree", "add", "--detach", workspacePath, baseRef], repoRoot);
+      await this.seedWorkspace(workspacePath, repoRoot);
       return (0, import_types6.Ok)(workspacePath);
     } catch (error) {
       return (0, import_types6.Err)(error instanceof Error ? error : new Error(String(error)));
@@ -2546,6 +2548,44 @@ var WorkspaceManager = class {
     } catch {
     }
   }
+  /**
+   * Default paths seeded into a fresh worktree when {@link WorkspaceConfig.seedPaths}
+   * is unset — the artifacts produced by the brainstorm → orchestrator handoff.
+   */
+  static DEFAULT_SEED_PATHS = [".harness/proposals", "docs/roadmap.md"];
+  /**
+   * Copies the configured seed paths from the root working tree into a
+   * freshly-created worktree, overlaying the committed checkout.
+   *
+   * A new worktree is based on a committed remote ref, so it does not contain
+   * uncommitted artifacts that exist only in the root working tree (a
+   * just-written proposal under `.harness/proposals/`, a promoted row in
+   * `docs/roadmap.md`). Seeding carries them over so a dispatched agent sees
+   * the same state the orchestrator dispatched from.
+   *
+   * Best-effort by design: a missing source is skipped, and a copy failure is
+   * swallowed — neither must ever block dispatch.
+   */
+  async seedWorkspace(workspacePath, repoRoot) {
+    const seedPaths = this.config.seedPaths ?? _WorkspaceManager.DEFAULT_SEED_PATHS;
+    for (const entry of seedPaths) {
+      const rel = path8.isAbsolute(entry) ? path8.relative(repoRoot, entry).replaceAll("\\", "/") : entry;
+      if (!rel || rel === ".." || rel.startsWith("../") || path8.isAbsolute(rel)) {
+        continue;
+      }
+      const src = path8.join(repoRoot, rel);
+      try {
+        await fs9.access(src);
+      } catch {
+        continue;
+      }
+      const dest = path8.join(workspacePath, rel);
+      try {
+        await fs9.cp(src, dest, { recursive: true, force: true });
+      } catch {
+      }
+    }
+  }
   /**
    * Resolves the ref that new worktrees should be based on.
    *
@@ -12440,6 +12480,10 @@ function reportCycle(path24, next, errors, reported) {
 }
 
 // src/orchestrator.ts
+function deriveSeedPaths(config) {
+  const roadmapPath = config.tracker.kind === "roadmap" && config.tracker.filePath ? config.tracker.filePath : "docs/roadmap.md";
+  return [".harness/proposals", roadmapPath];
+}
 var Orchestrator = class extends import_node_events.EventEmitter {
   state;
   config;
@@ -12603,12 +12647,21 @@ var Orchestrator = class extends import_node_events.EventEmitter {
       );
     }
     this.tracker = overrides?.tracker || this.createTracker();
-    this.workspace = new WorkspaceManager(config.workspace, {
-      emitEvent: (event) => {
-        this.server?.broadcastMaintenance("maintenance:baseref_fallback", event);
-        this.emit("maintenance:baseref_fallback", event);
+    this.workspace = new WorkspaceManager(
+      {
+        ...config.workspace,
+        // Seed the brainstorm handoff artifacts into each fresh worktree. An
+        // explicit `seedPaths` wins; otherwise derive from the tracker config
+        // so a non-default roadmap location is still carried over.
+        seedPaths: config.workspace.seedPaths ?? deriveSeedPaths(config)
+      },
+      {
+        emitEvent: (event) => {
+          this.server?.broadcastMaintenance("maintenance:baseref_fallback", event);
+          this.emit("maintenance:baseref_fallback", event);
+        }
       }
-    });
+    );
     this.hooks = new WorkspaceHooks(config.hooks);
     this.renderer = new PromptRenderer();
     this.overrideBackend = overrides?.backend ?? null;
@@ -14770,6 +14823,7 @@ function buildArchiveHooks(opts) {
   createEmptyState,
   crossFieldRoutingIssues,
   defaultFetchModels,
+  deriveSeedPaths,
   detectScopeTier,
   discoverSkillCatalog,
   discoverSkillCatalogNames,

package/dist/index.mjs

@@ -2348,7 +2348,7 @@ import * as path8 from "path";
 import { execFile as execFile2 } from "child_process";
 import { promisify as promisify2 } from "util";
 import { Ok as Ok6, Err as Err4 } from "@harness-engineering/types";
-var WorkspaceManager = class {
+var WorkspaceManager = class _WorkspaceManager {
   config;
   /** Absolute path to the git repository root (resolved lazily). */
   repoRoot = null;
@@ -2419,6 +2419,7 @@ var WorkspaceManager = class {
       await this.tryFetch(repoRoot);
       const baseRef = await this.resolveBaseRef(repoRoot);
       await this.git(["worktree", "add", "--detach", workspacePath, baseRef], repoRoot);
+      await this.seedWorkspace(workspacePath, repoRoot);
       return Ok6(workspacePath);
     } catch (error) {
       return Err4(error instanceof Error ? error : new Error(String(error)));
@@ -2435,6 +2436,44 @@ var WorkspaceManager = class {
     } catch {
     }
   }
+  /**
+   * Default paths seeded into a fresh worktree when {@link WorkspaceConfig.seedPaths}
+   * is unset — the artifacts produced by the brainstorm → orchestrator handoff.
+   */
+  static DEFAULT_SEED_PATHS = [".harness/proposals", "docs/roadmap.md"];
+  /**
+   * Copies the configured seed paths from the root working tree into a
+   * freshly-created worktree, overlaying the committed checkout.
+   *
+   * A new worktree is based on a committed remote ref, so it does not contain
+   * uncommitted artifacts that exist only in the root working tree (a
+   * just-written proposal under `.harness/proposals/`, a promoted row in
+   * `docs/roadmap.md`). Seeding carries them over so a dispatched agent sees
+   * the same state the orchestrator dispatched from.
+   *
+   * Best-effort by design: a missing source is skipped, and a copy failure is
+   * swallowed — neither must ever block dispatch.
+   */
+  async seedWorkspace(workspacePath, repoRoot) {
+    const seedPaths = this.config.seedPaths ?? _WorkspaceManager.DEFAULT_SEED_PATHS;
+    for (const entry of seedPaths) {
+      const rel = path8.isAbsolute(entry) ? path8.relative(repoRoot, entry).replaceAll("\\", "/") : entry;
+      if (!rel || rel === ".." || rel.startsWith("../") || path8.isAbsolute(rel)) {
+        continue;
+      }
+      const src = path8.join(repoRoot, rel);
+      try {
+        await fs9.access(src);
+      } catch {
+        continue;
+      }
+      const dest = path8.join(workspacePath, rel);
+      try {
+        await fs9.cp(src, dest, { recursive: true, force: true });
+      } catch {
+      }
+    }
+  }
   /**
    * Resolves the ref that new worktrees should be based on.
    *
@@ -10738,7 +10777,7 @@ var StructuredLogger = class {
 
 // src/workspace/config-scanner.ts
 import { existsSync as existsSync6, readFileSync as readFileSync6 } from "fs";
-import { join as join15, relative } from "path";
+import { join as join15, relative as relative2 } from "path";
 import {
   scanForInjection,
   SecurityScanner,
@@ -10775,7 +10814,7 @@ async function scanSingleFile(filePath, targetDir, scanner) {
   findings.push(...mapSecurityFindings(secFindings, findings));
   const adjusted = adjustFindingSeverity(findings);
   return {
-    file: relative(targetDir, filePath).replaceAll("\\", "/"),
+    file: relative2(targetDir, filePath).replaceAll("\\", "/"),
     findings: adjusted,
     overallSeverity: computeOverallSeverity(adjusted)
   };
@@ -12411,6 +12450,10 @@ function reportCycle(path24, next, errors, reported) {
 }
 
 // src/orchestrator.ts
+function deriveSeedPaths(config) {
+  const roadmapPath = config.tracker.kind === "roadmap" && config.tracker.filePath ? config.tracker.filePath : "docs/roadmap.md";
+  return [".harness/proposals", roadmapPath];
+}
 var Orchestrator = class extends EventEmitter {
   state;
   config;
@@ -12574,12 +12617,21 @@ var Orchestrator = class extends EventEmitter {
       );
     }
     this.tracker = overrides?.tracker || this.createTracker();
-    this.workspace = new WorkspaceManager(config.workspace, {
-      emitEvent: (event) => {
-        this.server?.broadcastMaintenance("maintenance:baseref_fallback", event);
-        this.emit("maintenance:baseref_fallback", event);
+    this.workspace = new WorkspaceManager(
+      {
+        ...config.workspace,
+        // Seed the brainstorm handoff artifacts into each fresh worktree. An
+        // explicit `seedPaths` wins; otherwise derive from the tracker config
+        // so a non-default roadmap location is still carried over.
+        seedPaths: config.workspace.seedPaths ?? deriveSeedPaths(config)
+      },
+      {
+        emitEvent: (event) => {
+          this.server?.broadcastMaintenance("maintenance:baseref_fallback", event);
+          this.emit("maintenance:baseref_fallback", event);
+        }
       }
-    });
+    );
     this.hooks = new WorkspaceHooks(config.hooks);
     this.renderer = new PromptRenderer();
     this.overrideBackend = overrides?.backend ?? null;
@@ -14742,6 +14794,7 @@ export {
   createEmptyState,
   crossFieldRoutingIssues,
   defaultFetchModels,
+  deriveSeedPaths,
   detectScopeTier,
   discoverSkillCatalog,
   discoverSkillCatalogNames,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@harness-engineering/orchestrator",
-  "version": "0.8.2",
+  "version": "0.8.3",
   "description": "Orchestrator daemon for dispatching coding agents to issues",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -48,10 +48,10 @@
     "ws": "^8.21.0",
     "yaml": "^2.8.3",
     "zod": "^3.25.76",
-    "@harness-engineering/core": "0.30.0",
-    "@harness-engineering/graph": "0.11.0",
-    "@harness-engineering/intelligence": "0.3.0",
-    "@harness-engineering/types": "0.16.0"
+    "@harness-engineering/core": "0.30.1",
+    "@harness-engineering/graph": "0.11.1",
+    "@harness-engineering/types": "0.16.1",
+    "@harness-engineering/intelligence": "0.3.1"
   },
   "devDependencies": {
     "@asteasolutions/zod-to-openapi": "^7.3.0",