@harness-engineering/orchestrator 0.8.2 → 0.8.4

package/dist/index.d.mts

@@ -296,11 +296,38 @@ declare class PRDetector {
      */
     hasOpenPRForIdentifier(identifier: string): Promise<boolean>;
     /**
-     * Filters out candidates that already have an open GitHub PR, running
-     * checks with limited concurrency to avoid overwhelming the GitHub API.
-     * For candidates with an externalId, searches for PRs linked to the
-     * GitHub issue. Falls back to `feat/<identifier>` branch lookup otherwise.
-     * Fail-open on API errors.
+     * GitHub closing keywords that link a PR to an issue it will close.
+     * @see https://docs.github.com/articles/closing-issues-using-keywords
+     */
+    private static readonly CLOSING_REF_RE;
+    /**
+     * Extracts the issue numbers a PR body declares it will close
+     * (e.g. `Closes #42`, `fixes #7`, `Resolves: #99`).
+     */
+    private parseClosingIssueNumbers;
+    /**
+     * Lists every open PR for a repo in a single `gh pr list` call and returns
+     * the set of issue numbers those PRs close (parsed from their bodies).
+     *
+     * This is the batched replacement for per-issue `gh pr list --search
+     * "closes #N"` queries. Every `gh pr list` form (search or plain list) is
+     * served by GitHub's GraphQL API and consumes from the shared ~5000/hr
+     * GraphQL budget, so issuing one query per candidate per tick exhausted the
+     * limit on busy boards. A single `--state open` list returns every open PR
+     * in one request regardless of candidate count, collapsing N calls into 1.
+     *
+     * Returns `null` if the check itself failed (gh missing, rate limited,
+     * network error) so callers can fail open rather than block real work.
+     */
+    fetchOpenPRClosures(owner: string, repo: string): Promise<Set<number> | null>;
+    /**
+     * Filters out candidates that already have an open GitHub PR.
+     *
+     * For GitHub-issue candidates the check is batched: one `gh pr list` per
+     * distinct repo (not one search per issue), parsing closing references
+     * locally. Candidates without a GitHub externalId fall back to a
+     * `feat/<identifier>` branch lookup, throttled to a few concurrent gh calls.
+     * Fail-open on API errors so a flaky/rate-limited GitHub never blocks work.
      */
     filterCandidatesWithOpenPRs(candidates: Issue[]): Promise<Issue[]>;
 }
@@ -1099,6 +1126,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 +1533,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 +2875,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

@@ -296,11 +296,38 @@ declare class PRDetector {
      */
     hasOpenPRForIdentifier(identifier: string): Promise<boolean>;
     /**
-     * Filters out candidates that already have an open GitHub PR, running
-     * checks with limited concurrency to avoid overwhelming the GitHub API.
-     * For candidates with an externalId, searches for PRs linked to the
-     * GitHub issue. Falls back to `feat/<identifier>` branch lookup otherwise.
-     * Fail-open on API errors.
+     * GitHub closing keywords that link a PR to an issue it will close.
+     * @see https://docs.github.com/articles/closing-issues-using-keywords
+     */
+    private static readonly CLOSING_REF_RE;
+    /**
+     * Extracts the issue numbers a PR body declares it will close
+     * (e.g. `Closes #42`, `fixes #7`, `Resolves: #99`).
+     */
+    private parseClosingIssueNumbers;
+    /**
+     * Lists every open PR for a repo in a single `gh pr list` call and returns
+     * the set of issue numbers those PRs close (parsed from their bodies).
+     *
+     * This is the batched replacement for per-issue `gh pr list --search
+     * "closes #N"` queries. Every `gh pr list` form (search or plain list) is
+     * served by GitHub's GraphQL API and consumes from the shared ~5000/hr
+     * GraphQL budget, so issuing one query per candidate per tick exhausted the
+     * limit on busy boards. A single `--state open` list returns every open PR
+     * in one request regardless of candidate count, collapsing N calls into 1.
+     *
+     * Returns `null` if the check itself failed (gh missing, rate limited,
+     * network error) so callers can fail open rather than block real work.
+     */
+    fetchOpenPRClosures(owner: string, repo: string): Promise<Set<number> | null>;
+    /**
+     * Filters out candidates that already have an open GitHub PR.
+     *
+     * For GitHub-issue candidates the check is batched: one `gh pr list` per
+     * distinct repo (not one search per issue), parsing closing references
+     * locally. Candidates without a GitHub externalId fall back to a
+     * `feat/<identifier>` branch lookup, throttled to a few concurrent gh calls.
+     * Fail-open on API errors so a flaky/rate-limited GitHub never blocks work.
      */
     filterCandidatesWithOpenPRs(candidates: Issue[]): Promise<Issue[]>;
 }
@@ -1099,6 +1126,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 +1533,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 +2875,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,
@@ -1340,7 +1341,7 @@ var ClaimManager = class {
 // src/core/pr-detector.ts
 var import_node_child_process = require("child_process");
 var import_node_util = require("util");
-var PRDetector = class {
+var PRDetector = class _PRDetector {
   logger;
   execFileFn;
   projectRoot;
@@ -1456,35 +1457,124 @@ var PRDetector = class {
     }
   }
   /**
-   * Filters out candidates that already have an open GitHub PR, running
-   * checks with limited concurrency to avoid overwhelming the GitHub API.
-   * For candidates with an externalId, searches for PRs linked to the
-   * GitHub issue. Falls back to `feat/<identifier>` branch lookup otherwise.
-   * Fail-open on API errors.
+   * GitHub closing keywords that link a PR to an issue it will close.
+   * @see https://docs.github.com/articles/closing-issues-using-keywords
+   */
+  static CLOSING_REF_RE = /\b(?:close[sd]?|fix(?:e[sd])?|resolve[sd]?)[\s:]+#(\d+)/gi;
+  /**
+   * Extracts the issue numbers a PR body declares it will close
+   * (e.g. `Closes #42`, `fixes #7`, `Resolves: #99`).
+   */
+  parseClosingIssueNumbers(body) {
+    const nums = [];
+    for (const match of body.matchAll(_PRDetector.CLOSING_REF_RE)) {
+      nums.push(parseInt(match[1], 10));
+    }
+    return nums;
+  }
+  /**
+   * Lists every open PR for a repo in a single `gh pr list` call and returns
+   * the set of issue numbers those PRs close (parsed from their bodies).
+   *
+   * This is the batched replacement for per-issue `gh pr list --search
+   * "closes #N"` queries. Every `gh pr list` form (search or plain list) is
+   * served by GitHub's GraphQL API and consumes from the shared ~5000/hr
+   * GraphQL budget, so issuing one query per candidate per tick exhausted the
+   * limit on busy boards. A single `--state open` list returns every open PR
+   * in one request regardless of candidate count, collapsing N calls into 1.
+   *
+   * Returns `null` if the check itself failed (gh missing, rate limited,
+   * network error) so callers can fail open rather than block real work.
+   */
+  async fetchOpenPRClosures(owner, repo) {
+    try {
+      const exec = (0, import_node_util.promisify)(this.execFileFn);
+      const { stdout } = await exec(
+        "gh",
+        [
+          "pr",
+          "list",
+          "--repo",
+          `${owner}/${repo}`,
+          "--state",
+          "open",
+          "--json",
+          "body",
+          "--limit",
+          "200"
+        ],
+        {
+          cwd: this.projectRoot,
+          timeout: 15e3
+        }
+      );
+      const prs = JSON.parse(stdout);
+      const closed = /* @__PURE__ */ new Set();
+      for (const pr of prs) {
+        for (const n of this.parseClosingIssueNumbers(pr.body ?? "")) closed.add(n);
+      }
+      return closed;
+    } catch (err) {
+      this.logger.debug(`Failed to list open PRs for ${owner}/${repo}`, {
+        error: String(err)
+      });
+      return null;
+    }
+  }
+  /**
+   * Filters out candidates that already have an open GitHub PR.
+   *
+   * For GitHub-issue candidates the check is batched: one `gh pr list` per
+   * distinct repo (not one search per issue), parsing closing references
+   * locally. Candidates without a GitHub externalId fall back to a
+   * `feat/<identifier>` branch lookup, throttled to a few concurrent gh calls.
+   * Fail-open on API errors so a flaky/rate-limited GitHub never blocks work.
    */
   async filterCandidatesWithOpenPRs(candidates) {
+    const repos = /* @__PURE__ */ new Map();
+    for (const candidate of candidates) {
+      const parsed = candidate.externalId ? this.parseExternalId(candidate.externalId) : null;
+      if (parsed) repos.set(`${parsed.owner}/${parsed.repo}`, parsed);
+    }
+    const repoClosures = /* @__PURE__ */ new Map();
+    await Promise.all(
+      [...repos.values()].map(async ({ owner, repo }) => {
+        repoClosures.set(`${owner}/${repo}`, await this.fetchOpenPRClosures(owner, repo));
+      })
+    );
+    const identifierCandidates = candidates.filter(
+      (c) => !(c.externalId && this.parseExternalId(c.externalId))
+    );
+    const identifiersWithOpenPR = /* @__PURE__ */ new Set();
     const concurrency = 3;
-    const results = [];
-    for (let i = 0; i < candidates.length; i += concurrency) {
-      const batch = candidates.slice(i, i + concurrency);
-      const batchResults = await Promise.allSettled(
-        batch.map(async (candidate) => {
-          const hasOpenPR = candidate.externalId ? await this.hasOpenPRForExternalId(candidate.externalId) : await this.hasOpenPRForIdentifier(candidate.identifier);
-          return { candidate, hasOpenPR };
-        })
+    for (let i = 0; i < identifierCandidates.length; i += concurrency) {
+      const batch = identifierCandidates.slice(i, i + concurrency);
+      const settled = await Promise.allSettled(
+        batch.map(async (c) => ({
+          identifier: c.identifier,
+          hasOpenPR: await this.hasOpenPRForIdentifier(c.identifier)
+        }))
       );
-      results.push(...batchResults);
+      for (const result of settled) {
+        if (result.status === "fulfilled" && result.value.hasOpenPR) {
+          identifiersWithOpenPR.add(result.value.identifier);
+        }
+      }
     }
     const filtered = [];
-    for (let i = 0; i < results.length; i++) {
-      const result = results[i];
-      if (!result || result.status === "rejected") {
-        filtered.push(candidates[i]);
-        continue;
+    for (const candidate of candidates) {
+      const parsed = candidate.externalId ? this.parseExternalId(candidate.externalId) : null;
+      let hasOpenPR;
+      let via;
+      if (parsed) {
+        const closures = repoClosures.get(`${parsed.owner}/${parsed.repo}`);
+        hasOpenPR = closures ? closures.has(parsed.number) : false;
+        via = `externalId ${candidate.externalId}`;
+      } else {
+        hasOpenPR = identifiersWithOpenPR.has(candidate.identifier);
+        via = `feat/${candidate.identifier}`;
       }
-      const { candidate, hasOpenPR } = result.value;
       if (hasOpenPR) {
-        const via = candidate.externalId ? `externalId ${candidate.externalId}` : `feat/${candidate.identifier}`;
         this.logger.info(`Skipping ${candidate.title}: open PR exists (${via})`);
       } else {
         filtered.push(candidate);
@@ -2308,7 +2398,8 @@ var RoadmapTrackerAdapter = class {
       if (!target) return (0, import_types4.Ok)(void 0);
       const normalizedTerminal = this.config.terminalStates.map((s) => s.toLowerCase());
       if (normalizedTerminal.includes(target.status.toLowerCase())) return (0, import_types4.Ok)(void 0);
-      target.status = terminal;
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      (0, import_core.setStatus)(roadmap, target, terminal, now.slice(0, 10));
       await fs8.writeFile(this.config.filePath, (0, import_core.serializeRoadmap)(roadmap), "utf-8");
       return (0, import_types4.Ok)(void 0);
     } catch (error) {
@@ -2329,15 +2420,15 @@ var RoadmapTrackerAdapter = class {
       const roadmap = roadmapResult.value;
       const target = this.findFeatureById(roadmap.milestones, issueId);
       if (!target) return (0, import_types4.Ok)(void 0);
-      if (target.assignee != null && target.assignee !== orchestratorId) {
+      if (!(0, import_core.isClaimableBy)(target, orchestratorId)) {
         return (0, import_types4.Ok)(void 0);
       }
       if (target.status === "in-progress" && target.assignee === orchestratorId) {
         return (0, import_types4.Ok)(void 0);
       }
-      target.status = "in-progress";
-      target.assignee = orchestratorId;
-      target.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      (0, import_core.claim)(roadmap, target, orchestratorId, now.slice(0, 10));
+      target.updatedAt = now;
       await fs8.writeFile(this.config.filePath, (0, import_core.serializeRoadmap)(roadmap), "utf-8");
       return (0, import_types4.Ok)(void 0);
     } catch (error) {
@@ -2364,8 +2455,8 @@ var RoadmapTrackerAdapter = class {
       if (this.config.activeStates.includes(target.status) && target.assignee === null) {
         return (0, import_types4.Ok)(void 0);
       }
-      target.status = activeState;
-      target.assignee = null;
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      (0, import_core.setStatus)(roadmap, target, activeState, now.slice(0, 10));
       target.updatedAt = null;
       await fs8.writeFile(this.config.filePath, (0, import_core.serializeRoadmap)(roadmap), "utf-8");
       return (0, import_types4.Ok)(void 0);
@@ -2459,7 +2550,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 +2621,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 +2638,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 +12570,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 +12737,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 +14913,7 @@ function buildArchiveHooks(opts) {
   createEmptyState,
   crossFieldRoutingIssues,
   defaultFetchModels,
+  deriveSeedPaths,
   detectScopeTier,
   discoverSkillCatalog,
   discoverSkillCatalogNames,

package/dist/index.mjs

@@ -1219,7 +1219,7 @@ var ClaimManager = class {
 // src/core/pr-detector.ts
 import { execFile } from "child_process";
 import { promisify } from "util";
-var PRDetector = class {
+var PRDetector = class _PRDetector {
   logger;
   execFileFn;
   projectRoot;
@@ -1335,35 +1335,124 @@ var PRDetector = class {
     }
   }
   /**
-   * Filters out candidates that already have an open GitHub PR, running
-   * checks with limited concurrency to avoid overwhelming the GitHub API.
-   * For candidates with an externalId, searches for PRs linked to the
-   * GitHub issue. Falls back to `feat/<identifier>` branch lookup otherwise.
-   * Fail-open on API errors.
+   * GitHub closing keywords that link a PR to an issue it will close.
+   * @see https://docs.github.com/articles/closing-issues-using-keywords
+   */
+  static CLOSING_REF_RE = /\b(?:close[sd]?|fix(?:e[sd])?|resolve[sd]?)[\s:]+#(\d+)/gi;
+  /**
+   * Extracts the issue numbers a PR body declares it will close
+   * (e.g. `Closes #42`, `fixes #7`, `Resolves: #99`).
+   */
+  parseClosingIssueNumbers(body) {
+    const nums = [];
+    for (const match of body.matchAll(_PRDetector.CLOSING_REF_RE)) {
+      nums.push(parseInt(match[1], 10));
+    }
+    return nums;
+  }
+  /**
+   * Lists every open PR for a repo in a single `gh pr list` call and returns
+   * the set of issue numbers those PRs close (parsed from their bodies).
+   *
+   * This is the batched replacement for per-issue `gh pr list --search
+   * "closes #N"` queries. Every `gh pr list` form (search or plain list) is
+   * served by GitHub's GraphQL API and consumes from the shared ~5000/hr
+   * GraphQL budget, so issuing one query per candidate per tick exhausted the
+   * limit on busy boards. A single `--state open` list returns every open PR
+   * in one request regardless of candidate count, collapsing N calls into 1.
+   *
+   * Returns `null` if the check itself failed (gh missing, rate limited,
+   * network error) so callers can fail open rather than block real work.
+   */
+  async fetchOpenPRClosures(owner, repo) {
+    try {
+      const exec = promisify(this.execFileFn);
+      const { stdout } = await exec(
+        "gh",
+        [
+          "pr",
+          "list",
+          "--repo",
+          `${owner}/${repo}`,
+          "--state",
+          "open",
+          "--json",
+          "body",
+          "--limit",
+          "200"
+        ],
+        {
+          cwd: this.projectRoot,
+          timeout: 15e3
+        }
+      );
+      const prs = JSON.parse(stdout);
+      const closed = /* @__PURE__ */ new Set();
+      for (const pr of prs) {
+        for (const n of this.parseClosingIssueNumbers(pr.body ?? "")) closed.add(n);
+      }
+      return closed;
+    } catch (err) {
+      this.logger.debug(`Failed to list open PRs for ${owner}/${repo}`, {
+        error: String(err)
+      });
+      return null;
+    }
+  }
+  /**
+   * Filters out candidates that already have an open GitHub PR.
+   *
+   * For GitHub-issue candidates the check is batched: one `gh pr list` per
+   * distinct repo (not one search per issue), parsing closing references
+   * locally. Candidates without a GitHub externalId fall back to a
+   * `feat/<identifier>` branch lookup, throttled to a few concurrent gh calls.
+   * Fail-open on API errors so a flaky/rate-limited GitHub never blocks work.
    */
   async filterCandidatesWithOpenPRs(candidates) {
+    const repos = /* @__PURE__ */ new Map();
+    for (const candidate of candidates) {
+      const parsed = candidate.externalId ? this.parseExternalId(candidate.externalId) : null;
+      if (parsed) repos.set(`${parsed.owner}/${parsed.repo}`, parsed);
+    }
+    const repoClosures = /* @__PURE__ */ new Map();
+    await Promise.all(
+      [...repos.values()].map(async ({ owner, repo }) => {
+        repoClosures.set(`${owner}/${repo}`, await this.fetchOpenPRClosures(owner, repo));
+      })
+    );
+    const identifierCandidates = candidates.filter(
+      (c) => !(c.externalId && this.parseExternalId(c.externalId))
+    );
+    const identifiersWithOpenPR = /* @__PURE__ */ new Set();
     const concurrency = 3;
-    const results = [];
-    for (let i = 0; i < candidates.length; i += concurrency) {
-      const batch = candidates.slice(i, i + concurrency);
-      const batchResults = await Promise.allSettled(
-        batch.map(async (candidate) => {
-          const hasOpenPR = candidate.externalId ? await this.hasOpenPRForExternalId(candidate.externalId) : await this.hasOpenPRForIdentifier(candidate.identifier);
-          return { candidate, hasOpenPR };
-        })
+    for (let i = 0; i < identifierCandidates.length; i += concurrency) {
+      const batch = identifierCandidates.slice(i, i + concurrency);
+      const settled = await Promise.allSettled(
+        batch.map(async (c) => ({
+          identifier: c.identifier,
+          hasOpenPR: await this.hasOpenPRForIdentifier(c.identifier)
+        }))
       );
-      results.push(...batchResults);
+      for (const result of settled) {
+        if (result.status === "fulfilled" && result.value.hasOpenPR) {
+          identifiersWithOpenPR.add(result.value.identifier);
+        }
+      }
     }
     const filtered = [];
-    for (let i = 0; i < results.length; i++) {
-      const result = results[i];
-      if (!result || result.status === "rejected") {
-        filtered.push(candidates[i]);
-        continue;
+    for (const candidate of candidates) {
+      const parsed = candidate.externalId ? this.parseExternalId(candidate.externalId) : null;
+      let hasOpenPR;
+      let via;
+      if (parsed) {
+        const closures = repoClosures.get(`${parsed.owner}/${parsed.repo}`);
+        hasOpenPR = closures ? closures.has(parsed.number) : false;
+        via = `externalId ${candidate.externalId}`;
+      } else {
+        hasOpenPR = identifiersWithOpenPR.has(candidate.identifier);
+        via = `feat/${candidate.identifier}`;
       }
-      const { candidate, hasOpenPR } = result.value;
       if (hasOpenPR) {
-        const via = candidate.externalId ? `externalId ${candidate.externalId}` : `feat/${candidate.identifier}`;
         this.logger.info(`Skipping ${candidate.title}: open PR exists (${via})`);
       } else {
         filtered.push(candidate);
@@ -2124,7 +2213,10 @@ import * as fs8 from "fs/promises";
 import { createHash as createHash2 } from "crypto";
 import {
   parseRoadmap,
-  serializeRoadmap
+  serializeRoadmap,
+  claim as claimFeature,
+  setStatus as setFeatureStatus,
+  isClaimableBy
 } from "@harness-engineering/core";
 import {
   Ok as Ok4,
@@ -2197,7 +2289,8 @@ var RoadmapTrackerAdapter = class {
       if (!target) return Ok4(void 0);
       const normalizedTerminal = this.config.terminalStates.map((s) => s.toLowerCase());
       if (normalizedTerminal.includes(target.status.toLowerCase())) return Ok4(void 0);
-      target.status = terminal;
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      setFeatureStatus(roadmap, target, terminal, now.slice(0, 10));
       await fs8.writeFile(this.config.filePath, serializeRoadmap(roadmap), "utf-8");
       return Ok4(void 0);
     } catch (error) {
@@ -2218,15 +2311,15 @@ var RoadmapTrackerAdapter = class {
       const roadmap = roadmapResult.value;
       const target = this.findFeatureById(roadmap.milestones, issueId);
       if (!target) return Ok4(void 0);
-      if (target.assignee != null && target.assignee !== orchestratorId) {
+      if (!isClaimableBy(target, orchestratorId)) {
         return Ok4(void 0);
       }
       if (target.status === "in-progress" && target.assignee === orchestratorId) {
         return Ok4(void 0);
       }
-      target.status = "in-progress";
-      target.assignee = orchestratorId;
-      target.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      claimFeature(roadmap, target, orchestratorId, now.slice(0, 10));
+      target.updatedAt = now;
       await fs8.writeFile(this.config.filePath, serializeRoadmap(roadmap), "utf-8");
       return Ok4(void 0);
     } catch (error) {
@@ -2253,8 +2346,8 @@ var RoadmapTrackerAdapter = class {
       if (this.config.activeStates.includes(target.status) && target.assignee === null) {
         return Ok4(void 0);
       }
-      target.status = activeState;
-      target.assignee = null;
+      const now = (/* @__PURE__ */ new Date()).toISOString();
+      setFeatureStatus(roadmap, target, activeState, now.slice(0, 10));
       target.updatedAt = null;
       await fs8.writeFile(this.config.filePath, serializeRoadmap(roadmap), "utf-8");
       return Ok4(void 0);
@@ -2348,7 +2441,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 +2512,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 +2529,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 +10870,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 +10907,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 +12543,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 +12710,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 +14887,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.4",
   "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.31.0",
+    "@harness-engineering/graph": "0.11.1",
+    "@harness-engineering/intelligence": "0.3.1",
+    "@harness-engineering/types": "0.16.1"
   },
   "devDependencies": {
     "@asteasolutions/zod-to-openapi": "^7.3.0",