fixlab-windows-background-probes
Skill0 starsChanged 59 days agoMITView on GitHub
Diagnose brief Git windows during idle FixLab polling and keep background repository probes hidden on Windows.
In this repository5 other files it gives its agents.
- AGENTS.mdAGENTS.md
- dashboard/AGENTS.mdAGENTS.md
- .github/copilot-instructions.mdCopilot instructions
- codeblend-ai-compositeSkill
- fixlab-job-scoped-post-approvalSkill
The file
We split this skill into the rules it gives an agent
8 rules. About 0 are common, 5 are distinctive, and 3 are very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈5
Distinctive · estimate
This author's own choices. Worth a look.
3
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 10
Use when Git console windows flash during idle dashboard/chat polling, or when adding background repository probes to those paths.
- Very specific: line 21
Keep windowsHide: true and shell: false on both background spawnSync helpers:
- Distinctive: line 30
Do not disable polling or change the owned executor's containment behavior to hide windows created by a different background helper.
- Very specific: line 35
Keep fixture requests separate from the runtime's global fetch pool and its /api/session self-probes.
- Distinctive: line 48
Do not treat a separately passing rerun as proof that the full suite passed, or increase retries, deadlines or concurrency to conceal a …
- Distinctive: line 54
Run the existing regression in PowerShell:
- Very specific: line 65
Run npm run validate for implementation changes.
- Distinctive: line 73
Do not hide intended interactive terminals, bypass permissions, or stop unrelated Git processes.
≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
FixLab Windows background probes
When to use
Use when Git console windows flash during idle dashboard/chat polling, or when adding background repository probes to those paths. Also use for loopback connection resets in same-process tests around Git work or dashboard restarts.
Verified solution
The chat polls /api/status once per second by default. Repository inspection
prunes owned artifacts, which resolves the Git artifact root. Cache inspection
has a separate Git helper. Either helper can open a brief Windows console even
when no job or executor is running.
Keep windowsHide: true and shell: false on both background spawnSync helpers:
- Artifact-root Git helper:
runGit, reached throughpruneArtifactDirectoriesandresolveArtifactRoot. - Dashboard Git helper:
runGit, used bycreateCacheContext;/api/statuscallsinspectRepository. - Chat polling:
runChat.
Preserve command arguments, output handling and existing ownership checks. Do not disable polling or change the owned executor's containment behavior to hide windows created by a different background helper.
Same-process HTTP fixtures
Keep fixture requests separate from the runtime's global fetch pool and its
/api/session self-probes. Blocking Git work or restarting a server can expose
stale pooled sockets. The dashboard server suite's jsonRequest uses
node:http with agent: false, preserving real HTTP without retries. A
Connection: close header alone can still select an already pooled socket.
The socket-isolation regression verifies distinct fixture/probe connections, GET/POST methods, JSON payloads, headers and status codes:
node --test --test-name-pattern="dashboard JSON fixtures isolate|connected Copilot recovery reuses|shared dashboard jobs refresh develop|idle finalization retains" test\dashboard-server.test.jsDo not treat a separately passing rerun as proof that the full suite passed, or increase retries, deadlines or concurrency to conceal a failure.
Validation
Working directory: . from the FixLab repository root, containing package.json.
Run the existing regression in PowerShell:
node --test --test-name-pattern="idle status polling and cache inspection hide their Git windows" test\dashboard-server.test.jsThe regression performs real HTTP
status polling and cache inspection, checks native Git spawn options, and
verifies idle polling never starts an executor. Its builtin-module spy must be
restored in finally, including syncBuiltinESMExports().
Run npm run validate for implementation changes. On Windows,
pwsh -NoLogo -NoProfile -File scripts\validate.ps1 runs that same required gate
while temporarily preventing idle sleep.
Pitfalls
An interactive executor's console settings do not cover every independent Git probe. Inspect the actual polling path before changing process-launch code. Do not hide intended interactive terminals, bypass permissions, or stop unrelated Git processes.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

