gsxdsm 9fabc9d750 FN-6962: ignore hidden overlap paths by default ...

Hidden dot paths no longer create file-overlap blockers unless operators opt back into legacy behavior.

- Add the ignoreHiddenOverlapPaths project setting, schema default, API sanitization, and Settings UI toggle.
- Filter hidden dot segments from scheduler, gridlock, and self-healing overlap checks by default while preserving explicit ignore paths.
- Cover default and opt-out behavior across core parity, dashboard settings routes, scheduler, gridlock, and self-healing tests.
- Document the setting and add a patch changeset for the published CLI package.

Files changed:
 .changeset/fn-6962-hidden-overlap-paths.md         |   7 ++
 docs/settings-reference.md                         |   1 +
 .../core/src/__tests__/settings-parity.test.ts     |   7 ++
 packages/core/src/settings-schema.ts               |   1 +
 packages/core/src/types.ts                         |   7 ++
 .../dashboard/app/components/SettingsModal.tsx     |   4 +-
 .../components/__tests__/SettingsModal.test.tsx    |  69 ++++++++++++++
 .../settings/sections/SchedulingSection.tsx        |  10 ++
 .../src/__tests__/routes-settings.test.ts          |  30 ++++++
 packages/dashboard/src/routes.ts                   |   9 ++
 .../src/routes/register-settings-memory-routes.ts  |   6 +-
 .../engine/src/__tests__/gridlock-detector.test.ts |  32 +++++++
 .../__tests__/scheduler-overlap-starvation.test.ts | 102 ++++++++++++++++++++-
 packages/engine/src/__tests__/self-healing.test.ts |  24 +++++
 packages/engine/src/gridlock-detector.ts           |   5 +-
 packages/engine/src/scheduler.ts                   |  40 +++++---
 packages/engine/src/self-healing.ts                |   2 +-
 packages/i18n/locales/en/app.json                  |   2 +
 packages/i18n/locales/es/app.json                  |  11 ++-
 packages/i18n/locales/fr/app.json                  |  11 ++-
 packages/i18n/locales/ko/app.json                  |  11 ++-
 packages/i18n/locales/zh-CN/app.json               |  11 ++-
 packages/i18n/locales/zh-TW/app.json               |  11 ++-
 packages/i18n/src/resources.d.ts                   |   2 +
 24 files changed, 379 insertions(+), 36 deletions(-)

Fusion-Task-Id: FN-6962
Fusion-Task-Lineage: c79120d3-fd9e-439d-b2cf-439f9e2e6952

2026-06-25 08:35:44 -07:00

..

__tests__

FN-6962: ignore hidden overlap paths by default

2026-06-25 08:35:44 -07:00

auto-recovery-handlers

fix(engine): un-deadcode bootstrap-misbinding auto-recovery fallback

2026-05-23 02:29:38 -07:00

cli-agent

FN-6457: add ACP ask runner and bundled Claude bridge setup

2026-06-15 02:30:41 -07:00

experiment

FN-5782: wire branch groups into merge routing

2026-05-31 13:50:23 -07:00

external-integrations

feat(FN-5321): add evidence gap detector for external integration manifests

2026-05-20 15:54:44 -07:00

ipc

FN-5703: forward task:deleted events through in-process runtime

2026-05-29 20:05:14 -07:00

notification

FN-6093: fix ntfy workflow notification delivery

2026-06-09 12:50:26 -07:00

providers

FN-5638: migrate pi-ai and pi-coding-agent packages to @earendil-works scope

2026-05-28 21:23:48 -07:00

recovery

feat(FN-5349): add integration branch resolver with auto-recovery fallback

2026-05-21 12:04:58 -07:00

remote-access

feat(FN-5189): complete Step 3 — migrate supervised spawns

2026-05-19 17:19:02 -07:00

research

fix: Replace htmlUrl with url in gh search repos query

2026-05-23 22:09:25 -03:00

runtimes

Merge remote-tracking branch 'origin/main' into conflict-resolution-1718

2026-06-23 16:23:28 -07:00

sandbox

FN-6382: unquarantine stabilized flaky tests

2026-06-13 11:39:37 -07:00

spec-validation

FN-6350: accept labeled external integration evidence

2026-06-13 04:54:59 -07:00

test

…

types/node-pty

feat(engine): extract shared PTY native-asset loader and redactSecrets (U16)

2026-06-04 22:53:02 -07:00

active-session-registry.ts

feat(workspace): Phase D U1 — workspace-aware self-healing

2026-06-22 01:37:59 -07:00

agent-action-gate.ts

…

agent-assignment.ts

FN-5941: stop missions stalling on incompatible/custom-role agents

2026-06-03 17:14:42 -07:00

agent-heartbeat.ts

FN-6954: reconcile stale parked task assignments

2026-06-23 10:30:50 -07:00

agent-instructions.ts

…

agent-logger.ts

FN-6963: disable tool output log details by default

2026-06-23 23:35:33 -07:00

agent-memory-index.ts

…

agent-reflection.ts

…

agent-runtime.ts

feat(engine): load CE skills + spawn + conventions on the graph-step path (U8/U1/U2/U3/U9)

2026-06-20 22:47:39 -07:00

agent-self-improve.ts

…

agent-session-helpers.ts

FN-6228: prioritize project model overrides

2026-06-11 20:44:52 -07:00

agent-tools.ts

Merge remote-tracking branch 'origin/main' into conflict-resolution-1718

2026-06-23 16:23:28 -07:00

agent-user-comments.ts

FN-6915: surface user comments in agent prompts

2026-06-22 03:34:15 -07:00

already-merged-detector.ts

fix(FN-branch-group): address PR review feedback (#1357)

2026-06-03 13:51:13 -07:00

auth-storage.ts

fix(auth): refresh expired Claude OAuth tokens

2026-06-13 23:20:06 -07:00

auto-claim-snapshot.ts

FN-6873: exclude archived tasks from auto-claim scans

2026-06-21 16:23:42 -07:00

auto-merge-fact-providers.ts

feat(engine): add workflow extension plugin seams

2026-06-07 20:43:44 -07:00

auto-merge-finalization.ts

FN-6949: fix auto-merge lifecycle finalization

2026-06-22 23:18:28 -07:00

auto-recovery.ts

feat(FN-5348): remove cwd-main integration mode fallback

2026-05-21 12:49:50 -07:00

backlog-pressure-reporter.ts

feat(FN-5009): merge fusion/fn-5009

2026-05-18 12:31:21 -07:00

base-commit-capture.ts

fix(review): address PR #1717 Phase C merge-loop review feedback

2026-06-22 03:04:21 -07:00

branch-attribution.ts

fix(FN-5304): guard against silent no-op landed-file attribution mismatches

2026-05-20 08:23:40 -07:00

branch-autocorrect.ts

fix(FN-5456): tidy autocorrect shell quoting and disambiguate checkout

2026-05-23 00:03:12 -07:00

branch-conflicts.ts

FN-6139: remove unused _baseSha parameter

2026-06-09 15:21:39 -07:00

claude-acp-enable.ts

fix(review): address PR #1681 feedback (acp.active accuracy + FNXC comments)

2026-06-15 12:34:44 -07:00

cli-agent-ask.ts

FN-6457: add ACP ask runner and bundled Claude bridge setup

2026-06-15 02:30:41 -07:00

cli-agent-validator.ts

FN-6457: add ACP ask runner and bundled Claude bridge setup

2026-06-15 02:30:41 -07:00

code-node-runner.ts

fix: address PR review feedback (#1424)

2026-06-04 16:16:50 -07:00

concurrency.ts

FN-6423: fix scheduler capacity accounting

2026-06-13 21:23:39 -07:00

context-limit-detector.ts

…

cron-runner.ts

FN-6613: inject skills into agent session lanes

2026-06-17 21:12:53 -07:00

custom-providers.ts

FN-5833: fix custom Responses API model lookup

2026-06-01 08:23:02 -07:00

dependency-blocked-todo-reporter.ts

fix(FN-5091): harden maxAutoMergeRetries settings parsing

2026-05-19 03:21:18 -07:00

effective-node.ts

…

effective-settings.ts

feat(engine): per-task effective workflow settings — resolver, two-tier entry merge, fallback alignment

2026-06-04 22:37:51 -07:00

engine-errors.ts

fix: address PR review feedback (#1467)

2026-06-07 23:03:38 -07:00

engine-singleton-lock.ts

feat(engine): guard one engine per project per machine

2026-05-19 22:50:39 -07:00

ephemeral-worker-manager.ts

…

error-classifier.ts

…

eval-followups.ts

feat(FN-5232): add deterministic verification-followup deduplication to pre

2026-05-19 19:28:05 -07:00

evaluator-evidence.ts

FN-5697: retry transient auto-merge failures and fix migration versioning

2026-05-29 10:23:59 -07:00

evaluator.ts

…

executor.ts

fix(workspace): persist workspaceWorktrees and isolate concurrent session leases

2026-06-24 15:13:43 -07:00

experiment-executor.ts

…

fallback-model-observer.ts

…

gating-classifications.ts

FN-6778: add agent artifact registry tools

2026-06-22 03:34:14 -07:00

goal-anchoring-audit.ts

FN-5758: add cited-goal audit aggregation and runtime route

2026-05-30 22:53:24 -07:00

goal-context-injector.ts

FN-5651: add single-seam goal-context injector for system prompts

2026-05-29 07:11:00 -07:00

goal-injection-diagnostics.ts

FN-5959: bridge task goal provenance from mission links

2026-06-03 15:32:29 -07:00

gridlock-detector.ts

FN-6962: ignore hidden overlap paths by default

2026-06-25 08:35:44 -07:00

group-merge-coordinator.ts

fix(FN-branch-group): repair CI failures — execFile mock compatibility, TaskCard narrowing, e2e memo race

2026-06-03 17:57:00 -07:00

heartbeat-procedure-resolver.ts

…

heartbeat-prompt-trim.ts

…

hold-release.ts

FN-6952: repair workflow-column lifecycle regressions

2026-06-23 08:21:10 -07:00

hybrid-executor-gate.ts

perf(dashboard): speed up startup and eliminate API request storms

2026-05-26 21:57:31 -07:00

hybrid-executor.ts

…

index.ts

Merge remote-tracking branch 'origin/main' into latest-1718

2026-06-23 17:41:30 -07:00

integration-branch.ts

feat(FN-5349): add integration branch resolver with auto-recovery fallback

2026-05-21 12:04:58 -07:00

interactive-ai-session.ts

FN-6689: route planning executor selection

2026-06-19 01:56:52 -07:00

logger.ts

feat(pr): node-agnostic PR reconcile + hold-release firing (U4)

2026-06-05 20:05:29 -07:00

merge-dependency-sync.ts

FN-6420: run dependency sync in AI merge worktrees

2026-06-13 21:09:12 -07:00

merge-trait.ts

fix(dashboard): polish workflow and chrome defaults

2026-06-22 19:48:50 -07:00

merger-ai.ts

fix(workspace): make per-repo land resilient to a sub-repo dependency-sync failure

2026-06-24 17:15:38 -07:00

merger-audit-recovery.ts

…

merger-auto-prerebase.ts

fix(FN-5627): always rebase behind branches before squash (safety fallback)

2026-05-28 15:04:41 -07:00

merger-bare-subject.ts

fix(engine): harden merge finalize SQLite bind and recover bare merge subjects

2026-05-26 21:57:31 -07:00

merger-diff-volume-gate.ts

…

merger-integration-worktree.ts

FN-6278: preflight reusable merge worktree cwd

2026-06-11 20:27:29 -07:00

merger-orphan-rehome.ts

feat(merger): auto-rehome FF-recoverable orphan commits in contamination recovery

2026-05-23 09:59:50 -07:00

merger-overlap-guard.ts

…

merger-ref-update-advance.ts

fix(FN-5627): close merger TOCTOU + add fast-path reachability gate

2026-05-28 13:02:30 -07:00

merger-scope-auto-widen.ts

feat(FN-5226): add scope auto-widen layer 2.5 to merger for attribution-bas

2026-05-21 16:30:31 -07:00

merger-squash-audit.ts

…

merger.ts

Merge remote-tracking branch 'origin/main' into conflict-resolution-1718

2026-06-23 16:23:28 -07:00

mesh-lease-manager.ts

…

mission-autopilot.ts

FN-5941: stop missions stalling on incompatible/custom-role agents

2026-06-03 17:14:42 -07:00

mission-execution-loop.ts

fix(engine): clear Lint and Gate failures after main merge

2026-06-13 16:16:52 -07:00

mission-feature-sync.ts

FN-5715: gate mission feature completion on assertion validation

2026-05-30 09:43:02 -07:00

mission-verification-app-harness.ts

fix(engine): clear Lint and Gate failures after main merge

2026-06-13 16:16:52 -07:00

mission-verification.ts

fix(engine): correct parameter order in runVerificationCommand after merge

2026-06-19 23:50:37 +00:00

node-dispatch-validation.ts

…

node-health-monitor.ts

…

node-routing-policy.ts

…

notifier.ts

FN-6093: fix ntfy workflow notification delivery

2026-06-09 12:50:26 -07:00

peer-exchange-service.ts

…

permanent-agent-gating.ts

…

pi.ts

feat(#1675): add X-Session-Id and X-Session-Affinity routing headers to LLM requests

2026-06-23 17:31:52 -07:00

plugin-parser-adapter.ts

feat(engine): U12e+U14 — parse-steps node handler, plugin parser adapter, code node runner (esbuild + child-process harness)

2026-06-04 12:44:43 -07:00

plugin-runner.ts

fix(engine): address workflow extension PR feedback

2026-06-07 21:19:10 -07:00

plugin-trait-adapter.ts

fix(core): shared workflow-IR resolver, prod branch persistence + pruning, latest-run JOIN, sweep reservation-leak fix (#1402 #1407 #1412 #1413)

2026-06-04 07:34:02 -07:00

plugin-workflow-extension-adapter.ts

fix(engine): address workflow extension PR feedback

2026-06-07 21:19:10 -07:00

pr-comment-handler.ts

feat(FN-5232): add deterministic verification-followup deduplication to pre

2026-05-19 19:28:05 -07:00

pr-monitor-gh.ts

…

pr-monitor.ts

…

pr-nodes.ts

feat(pr): U18 — surface + gate auto-resolution of PR review comments

2026-06-15 19:44:17 -07:00

pr-reconcile.ts

feat(pr): node-agnostic PR reconcile + hold-release firing (U4)

2026-06-05 20:05:29 -07:00

pr-response-run-ops.ts

fix(review): apply autofix feedback

2026-06-05 22:49:39 -07:00

pr-response-run.ts

feat(pr): security-hardened review-response run — pr-respond body (U5)

2026-06-05 20:20:25 -07:00

project-engine-manager.ts

Address PR review feedback (#1704): clear stale external marker on acquire

2026-06-21 03:32:53 -07:00

project-engine.ts

Merge remote-tracking branch 'origin/main' into latest4-1718

2026-06-23 20:58:31 -07:00

project-manager.ts

FN-5703: forward task:deleted events through in-process runtime

2026-05-29 20:05:14 -07:00

project-runtime.ts

merge: main (workflow editor 109 / cli_sessions 110-111 / workflow_settings 112) — renumber PR-entity migration to 113, union core exports, TaskCard prNode + cliSessionState badges, executor PrNodeDeps + CliAgentRuntime options

2026-06-05 23:06:46 -07:00

prompt-layers.ts

FN-6235: source reviewer prompts from workflow IR

2026-06-11 21:00:23 -07:00

pty-native.ts

feat(engine): extract shared PTY native-asset loader and redactSecrets (U16)

2026-06-04 22:53:02 -07:00

rate-limit-retry.ts

…

recovery-policy.ts

…

research-dispatcher.ts

…

research-orchestrator.ts

fix(engine): normalize dashboard research providers

2026-06-12 15:57:12 -07:00

research-step-runner.ts

…

restart-recovery-coordinator.ts

perf(dashboard): cache gh CLI checks and defer SQLite integrity scan

2026-05-26 23:41:28 -07:00

retry-burned-logger.ts

…

retry-with-backoff.ts

fix: address PR review feedback (#1467)

2026-06-07 23:03:38 -07:00

reviewer.ts

FN-6915: surface user comments in agent prompts

2026-06-22 03:34:15 -07:00

room-ambiguity.ts

…

room-coordination.ts

feat(FN-5425): add coordination notice system for multi-agent room task fil

2026-05-21 00:17:33 -07:00

routine-runner.ts

…

routine-scheduler.ts

…

run-audit.ts

FN-6943: add worktree file copy settings

2026-06-25 08:34:44 -07:00

run-verification-tool.ts

fix(FN-5048): direct agent + tool verification away from full workspace suite

2026-06-21 10:50:48 -07:00

runtime-primitives.ts

feat(FN-6035): route execution through workflow primitives

2026-06-08 19:13:14 -07:00

runtime-resolution.ts

FN-5638: migrate pi-ai and pi-coding-agent packages to @earendil-works scope

2026-05-28 21:23:48 -07:00

scheduler.ts

FN-6962: ignore hidden overlap paths by default

2026-06-25 08:35:44 -07:00

secrets-env-writer.ts

chore: minor cleanups — docs index, test-project fixture, empty catches, triage timestamp guard

2026-05-19 14:22:11 -07:00

self-healing.ts

FN-6962: ignore hidden overlap paths by default

2026-06-25 08:35:44 -07:00

session-skill-context.ts

…

session-token-usage.ts

FN-6746: attribute token analytics per runtime model

2026-06-19 16:47:34 -07:00

shell-utils.ts

…

skill-resolver.ts

FN-6140: downgrade missing skill diagnostics to info

2026-06-09 15:50:53 -07:00

smart-pull.ts

feat(engine): export smartPull() library for stash-aware fast-forward

2026-05-23 14:26:57 -07:00

spec-staleness.ts

fix(engine): preserve parked progress through stale-spec checks

2026-05-30 21:53:00 -07:00

stale-task-reporter.ts

…

step-integration.ts

fix(review): apply code-review fixes — runId/foreachNodeId wiring, worktree-leak cleanup, rework re-execution, instance pruning, SIGKILL fallback, type dedup, board memo split, agent-native field-schema context + fn_workflow_get

2026-06-04 14:01:55 -07:00

step-runner.ts

FN-6607: align step tools with zero-based prompt steps

2026-06-17 19:52:20 -07:00

step-session-executor.ts

FN-6746: attribute token analytics per runtime model

2026-06-19 16:47:34 -07:00

streaming-delta.ts

FN-5803: normalize streamed sentence spacing across message boundaries

2026-05-31 23:24:53 -07:00

stuck-task-detector.ts

FN-6598: suppress stuck detection during verification

2026-06-18 00:39:01 -07:00

task-agent-sync.ts

FN-6954: reconcile stale parked task assignments

2026-06-23 10:30:50 -07:00

task-completion.ts

…

token-budget-enforcer.ts

…

token-cap-detector.ts

FN-5638: migrate pi-ai and pi-coding-agent packages to @earendil-works scope

2026-05-28 21:23:48 -07:00

tool-availability.ts

FN-5638: migrate pi-ai and pi-coding-agent packages to @earendil-works scope

2026-05-28 21:23:48 -07:00

transient-error-detector.ts

FN-6594: classify Codex transcript desync as non-continuable

2026-06-17 15:11:55 -07:00

transient-merge-error-classifier.ts

FN-6246: move AI merge clean rooms into repo storage

2026-06-12 06:49:29 -07:00

triage-preflight.ts

…

triage-release-authorization.ts

FN-6481: require release triage authorization

2026-06-16 15:08:24 -07:00

triage.ts

feat(FN-783): complete Step 3 — shared write-scope classification

2026-06-25 03:44:21 -07:00

unlinked-missions-advisory-reporter.ts

FN-6050: stop re-emitting existing mission advisories

2026-06-09 03:53:34 -07:00

usage-limit-detector.ts

…

verification-followup-dedup.ts

feat(FN-5232): add deterministic verification-followup deduplication to pre

2026-05-19 19:28:05 -07:00

verification-utils.ts

fix(engine): correct parameter order in runVerificationCommand after merge

2026-06-19 23:50:37 +00:00

web-fetch.ts

…

workflow-authoritative-driver.ts

FN-6971: retire dual-observe cutover gating

2026-06-24 23:32:52 -07:00

workflow-graph-branches.ts

fix(core): shared workflow-IR resolver, prod branch persistence + pruning, latest-run JOIN, sweep reservation-leak fix (#1402 #1407 #1412 #1413)

2026-06-04 07:34:02 -07:00

workflow-graph-executor.ts

Merge remote-tracking branch 'origin/main' into conflict-resolution-1712

2026-06-23 15:44:52 -07:00

workflow-graph-foreach.ts

FN-6087: skip completed foreach steps on resume

2026-06-09 09:00:46 -07:00

workflow-graph-loop.ts

feat(FN-6880): execute optional-group run-once-or-bypass in graph executor (U2)

2026-06-21 18:25:54 -07:00

workflow-graph-task-runner.ts

fix(dashboard): polish workflow and chrome defaults

2026-06-22 19:48:50 -07:00

workflow-merge-nodes.ts

fix(FN-000): harden workflow merge classification

2026-06-11 08:43:27 -07:00

workflow-node-handlers.ts

feat(FN-000): extract workflow merge node capability

2026-06-11 08:43:27 -07:00

workflow-parity-observer.ts

FN-5768: add dual-observe workflow parity instrumentation

2026-05-31 08:32:01 -07:00

workflow-step-tool-policy.ts

FN-5638: migrate pi-ai and pi-coding-agent packages to @earendil-works scope

2026-05-28 21:23:48 -07:00

workflow-task-runtime.ts

fix(dashboard): polish workflow and chrome defaults

2026-06-22 19:48:50 -07:00

workflow-work-processor.ts

fix(FN-000): keep workflow processor cleanup best effort

2026-06-11 08:43:28 -07:00

workflow-work-scheduler.ts

feat(FN-000): claim workflow work in scheduler substrate

2026-06-09 20:44:45 -07:00

workspace-land-predicate.ts

fix(review): Phase D self-healing hardening — finalize-site audit, lease/TOCTOU safety

2026-06-22 02:19:17 -07:00

workspace-paths.ts

fix(review): Phase B workspace hardening — fail-closed scope guard, review conjunction, .changeset carve-out

2026-06-21 23:02:46 -07:00

worktree-acquisition.ts

FN-6943: add worktree file copy settings

2026-06-25 08:34:44 -07:00

worktree-backend.ts

fix(FN-343): address follow-up review findings

2026-06-12 15:51:50 -07:00

worktree-copy-files.ts

FN-6943: add worktree file copy settings

2026-06-25 08:34:44 -07:00

worktree-db-hydrate.ts

FN-6777: add artifact registry storage

2026-06-21 09:00:40 -07:00

worktree-desktop-artifacts.ts

…

worktree-hooks.ts

feat(FN-5519): merge fusion/fn-5519

2026-05-22 22:43:26 -07:00

worktree-names.ts

feat(engine): U10 — parallel step execution: dependency scheduler, per-instance worktrees, ordered integration, conflict→rework (KTD-11)

2026-06-04 13:04:15 -07:00

worktree-paths.ts

FN-6295: move AI merge clean rooms into worktrees

2026-06-12 12:49:34 -07:00

worktree-pool.ts

FN-6922: guard worktree acquisition returns from repo root

2026-06-22 19:11:08 -07:00

worktree-prune.ts

feat(FN-5058): merge fusion/fn-5058

2026-05-18 11:01:32 -07:00

worktree-ref-sync.ts

fix(engine,dashboard): close 7 review findings on merger auto-sync

2026-05-23 15:13:17 -07:00

worktree-stale-lock.ts

…

worktree-stale-registration.ts

feat(FN-5063): merge fusion/fn-5063

2026-05-18 15:51:01 -07:00

worktrunk-failure-handler.ts

…

worktrunk-installer.ts

feat(FN-5321): add evidence gap detector for external integration manifests

2026-05-20 15:54:44 -07:00