agentleFS
MicrosoftKnown publishermicrosoft/FixLab/.github/skills/fixlab-windows-background-probes/SKILL.md

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.

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
  1. Distinctive:

    Use when Git console windows flash during idle dashboard/chat polling, or when adding background repository probes to those paths.

    line 10
  2. Very specific:

    Keep windowsHide: true and shell: false on both background spawnSync helpers:

    line 21
  3. Distinctive:

    Do not disable polling or change the owned executor's containment behavior to hide windows created by a different background helper.

    line 30
  4. Very specific:

    Keep fixture requests separate from the runtime's global fetch pool and its /api/session self-probes.

    line 35
  5. Distinctive:

    Do not treat a separately passing rerun as proof that the full suite passed, or increase retries, deadlines or concurrency to conceal a …

    line 48
  6. Distinctive:

    Run the existing regression in PowerShell:

    line 54
  7. Very specific:

    Run npm run validate for implementation changes.

    line 65
  8. Distinctive:

    Do not hide intended interactive terminals, bypass permissions, or stop unrelated Git processes.

    line 73

≈ “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.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

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 through pruneArtifactDirectories and resolveArtifactRoot.
  • Dashboard Git helper: runGit, used by createCacheContext; /api/status calls inspectRepository.
  • 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.js

Do 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.js

The 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.

Download now (ZIP)

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
What did you use it for? e.g. Reviewing pull requests in a Rails app

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.