Skip to content

chore: ignore the local live-provider probes - #1007

Merged
simonoppowa merged 1 commit into
developfrom
chore/ignore-live-probe-scripts
Sep 1, 2026
Merged

chore: ignore the local live-provider probes#1007
simonoppowa merged 1 commit into
developfrom
chore/ignore-live-probe-scripts

Conversation

@simonoppowa

Copy link
Copy Markdown
Owner

Seven probe scripts have been sitting untracked in tool/live_model_compare, live_openai, live_openai_client_check, live_openrouter, live_own_server, live_routing_policy and verify_openai_key. They surfaced in the pre-merge audit of #988, where gh warned about "7 uncommitted changes" on every command run against the release branch.

They read a key from a file path passed as an argument rather than embedding one, and the only key-shaped literal in them is 64 zeros — so the exposure was never a leaked key. The risk is narrower and duller: a git add -A sweeping an ad-hoc script into a release branch, and seven files that are neither wanted nor ignored making that easier rather than harder.

tool/policy_snapshot.dart is a committed tool and stays tracked. The pattern is scoped to the probes, and git check-ignore confirms both halves:

.gitignore:75:tool/live_*.dart          tool/live_openai.dart
.gitignore:76:tool/verify_openai_key.dart   tool/verify_openai_key.dart
tool/policy_snapshot.dart               → not ignored

The one link that had to move

docs/ai-model-candidates.md listed tool/live_routing_policy.dart under "In-repo files cited" as a relative link. That was already a 404 on github.com while the file was merely untracked; once it is ignored, the heading is wrong as well as the link. It is now named in a sentence that says why it is not committed, and the two remaining entries under that heading are both real committed files.

The other two references to these scripts — docs/ai-openai-behavioural-screen.md:14 and :192 — are code spans inside command examples, never links, and are untouched.

Verified

test/unit_test/ai_architecture_doc_test.dart passes; no heading changed, so no anchor moved. git status is clean with the probes present on disk.

Seven probe scripts sat untracked in `tool/` through the whole 2.2.0
release: `live_model_compare`, `live_openai`, `live_openai_client_check`,
`live_openrouter`, `live_own_server`, `live_routing_policy` and
`verify_openai_key`. They take a key as a file-path argument rather than
embedding one, so the exposure was never the key. The risk is a `git add
-A` sweeping an ad-hoc script into a release branch, and `git status`
listing seven files that are neither wanted nor ignored makes that
easier, not harder.

`tool/policy_snapshot.dart` is a committed tool and stays tracked; the
pattern is scoped to the probes.

`docs/ai-model-candidates.md` listed `tool/live_routing_policy.dart`
under "In-repo files cited" as a link, which resolved to a 404 on
github.com and now would not even be a file the repo could contain. It
is named there instead, with a line saying why it is not committed. The
two other references to these scripts are code spans in command
examples, which were never links.
Copilot AI lite review requested due to automatic review settings September 1, 2026 19:14

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

🟢 Approval recommended

Changes are narrowly scoped to ignore rules and documentation cleanup, and the updated docs no longer link to an intentionally uncommitted local probe.

Pull request overview

This PR prevents locally-created “live provider probe” Dart scripts under tool/ from showing up as untracked changes (and from being accidentally committed), while keeping the one intentionally-tracked tool (tool/policy_snapshot.dart) unaffected. It also updates documentation to stop linking to a probe script that is intentionally not committed.

Changes:

  • Add .gitignore rules for tool/live_*.dart and tool/verify_openai_key.dart.
  • Replace a broken in-repo link in docs/ai-model-candidates.md with a non-linked mention explaining why the probe is not committed.
File summaries
File Description
docs/ai-model-candidates.md Removes the broken link to an untracked probe script and documents why it’s referenced but not committed.
.gitignore Ignores local live-provider probe scripts while leaving tool/policy_snapshot.dart tracked.
Review details
  • Files reviewed: 1/2 changed files
  • Comments generated: 0
  • Review effort level: Lite

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

@simonoppowa
simonoppowa merged commit 7c67c6e into develop Sep 1, 2026
14 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants