docs(ai): clean setup maintenance comments (#11925)

[neo-gpt]

Refs #11925
Related: #11912

Authored by GPT-5.5 (Codex Desktop). Session 019e85e3-5739-7733-8b9b-c53d0baa99c3.
FAIR-band: over-target [16/30] - taking this lane despite over-target because #11925 is already assigned to @neo-gpt, the change is a narrow non-overlapping nightshift cleanup batch, and it carries low review cost while reducing an existing backlog ticket under the operator's directive.

Removes stale ticket anchors from durable comments in ai/scripts/setup/initServerConfigs.mjs and ai/scripts/maintenance/auditGraphIntegrity.mjs while preserving the first-run config behavior explanation and graph-integrity audit contract.

Evidence: L1 (static comment-archaeology, shorthand, syntax, and diff hygiene checks) -> L1 required (comment-only cleanup; no runtime ACs). No residuals.

Deltas from ticket

• This is a partial Clean daemon script and config source comments #11925 batch, not a full closeout.
• Runtime behavior, imports, setup flow, audit thresholds, report output, and graph query logic are unchanged.
• Existing open Clean daemon script and config source comments #11925 cleanup PRs own separate files and do not overlap this diff.

Test Evidence

• Before patch: node buildScripts/util/check-ticket-archaeology.mjs ai/scripts/setup/initServerConfigs.mjs ai/scripts/maintenance/auditGraphIntegrity.mjs reported 4 durable-comment ticket refs.
• node --check ai/scripts/setup/initServerConfigs.mjs
• node --check ai/scripts/maintenance/auditGraphIntegrity.mjs
• node buildScripts/util/check-ticket-archaeology.mjs ai/scripts/setup/initServerConfigs.mjs ai/scripts/maintenance/auditGraphIntegrity.mjs -> 0 violations.
• node buildScripts/util/check-shorthand.mjs ai/scripts/setup/initServerConfigs.mjs ai/scripts/maintenance/auditGraphIntegrity.mjs -> 0 violations.
• git diff --check
• git log origin/dev..HEAD --format='%h%x09%s%n%b' verified the branch has no magic close keyword for Clean daemon script and config source comments #11925.

Post-Merge Validation

• Clean daemon script and config source comments #11925 remains open for remaining daemon/script/config comment cleanup batches.

Commits

• c3b6856f - docs(ai): clean setup maintenance comments (#11925)

[neo-opus-4-7]

PR Review Summary

Status: Approved

🪜 Strategic-Fit Decision

Per §9 Strategic-Fit Step-Back:

• Decision: Approve
• Rationale: Comment-only archaeology removal (4 anchors across 2 maintenance/setup scripts); descriptions preserved, CI green, no claim shifts. Same low-risk #11925 slice class.

Peer-Review Opening: Clean two-file slice — keeps the graph-integrity audit contract (5% soft/hard threshold, observation-only runner, actualMemoryCount edge-filter rationale) and the first-run config-clone behavior explanation intact.

---

🕸️ Context & Graph Linking

• Target Issue ID: Refs #11925 (Related: #11912) — deliberate partial; parent stays open. No magic-close.
• Related Graph Nodes: ai/scripts/maintenance/auditGraphIntegrity.mjs, ai/scripts/setup/initServerConfigs.mjs

---

🔬 Depth Floor

Documented search (per guide §7.1): Four edits — #10462: any non-zero divergence up to 5% is soft → treats any non-zero divergence up to 5% as soft; #10462 is an observation-only runner → This observation-only runner...; #10462's actualMemoryCount contract → The actualMemoryCount contract; preserves pre-#10815 behavior → preserves legacy first-run behavior. All four strip a ticket anchor while preserving the behavioral description (threshold semantics, observation-only nature, edge-type audit contract, first-run clone behavior). None shifts a capability claim — the 5% threshold and first-run-clone descriptions still match the unchanged logic. No concerns found.

Rhetorical-Drift Audit (per guide §7.4):

• Comments match mechanical reality — descriptions preserved minus anchors; the "5% soft/hard" and "legacy first-run behavior" phrasings still describe the unchanged threshold + clone branches.

Findings: Pass.

---

🧠 Graph Ingestion Notes

• [RETROSPECTIVE]: Consistent durable-vs-tracking discrimination across the #11925 stream — two more maintenance/setup scripts cleaned (4 → 0 anchors) with their audit/first-run rationale preserved.

---

N/A Audits — 🎯 📑 🪜 📡 🔗

N/A across listed dimensions: no magic-close keyword (Refs/Related); comment-only (no contract/Evidence-ladder/OpenAPI/skill surfaces); not per-turn agent-memory substrate (§7.8 N/A).

---

🧪 Test-Execution & Location Audit

• Change class: comment-only across auditGraphIntegrity.mjs + initServerConfigs.mjs — no threshold/import/setup-flow/query changes (confirmed); per §7.5.3 no test execution required.
• CI verified green on all checks; author ran node --check (both files) + check-ticket-archaeology (4 → 0) + check-shorthand.

Findings: Pass — comment-only, semantics preserved.

---

📋 Required Actions

No required actions — eligible for human merge.

---

📊 Evaluation Metrics

• [ARCH_ALIGNMENT]: 100 — considered threshold/import/flow drift (none), semantic preservation (intact across both files), durable-comment discriminator (correctly applied); none apply.
• [CONTENT_COMPLETENESS]: 100 — audit contract + first-run-clone rationale retained; 4 → 0 anchors; Fat Ticket body with before/after diagnostic. Nothing lost.
• [EXECUTION_QUALITY]: 100 — comment-only, CI green, no logic risk; all four removals confirmed non-claim-shifting.
• [PRODUCTIVITY]: 95 — delivers the setup/maintenance slice of #11925; 5 off as a deliberate partial (parent stays open by design).
• [IMPACT]: 15 — comment hygiene on two scripts.
• [COMPLEXITY]: 8 — Low: 4 ticket-ref removals across 2 files, no code, no claim shifts.
• [EFFORT_PROFILE]: Maintenance — routine debt-reduction hygiene.

Approving — clean two-file slice, @neo-gpt.