docs: TP-056 — Windows CI red (adapter path tests + cmd timeout), pre-v0.8

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>

Author: nachiket

docs/.docops/counters.json

@@ -3,6 +3,6 @@
   "next": {
     "ADR": 37,
     "CTX": 8,
-    "TP": 56
+    "TP": 57
   }
 }

docs/.index.json

@@ -1,5 +1,5 @@
 {
-  "generated_at": "2026-07-14T04:17:38Z",
+  "generated_at": "2026-07-14T04:21:25Z",
   "version": 1,
   "docs": [
     {
@@ -1481,8 +1481,8 @@
       ],
       "summary": "ADR-0029 (command-surface tiering) declared three audiences — slash, skills, CLI — and assigned skills to the LLM-NL-dispatch tier with the shape \"Many, granular.\" The implication taken at the time wa…",
       "word_count": 668,
-      "last_touched": "2026-04-30T09:16:34Z",
-      "age_days": 74,
+      "last_touched": "2026-07-14T04:19:14Z",
+      "age_days": 0,
       "referenced_by": [
         {
           "id": "ADR-0033",
@@ -1602,7 +1602,7 @@
       ],
       "summary": "Zoov exiled a third of its doc tree (research/, operations/, resources/, original/) outside the DocOps graph (CTX-007 F4). Those folders held real project knowledge, but forcing them into CTX would ha…",
       "word_count": 442,
-      "last_touched": "2026-07-14T04:02:45Z",
+      "last_touched": "2026-07-14T04:19:14Z",
       "age_days": 0,
       "referenced_by": [
         {
@@ -1628,7 +1628,7 @@
       ],
       "summary": "Zoov showed that fields which are always empty or always identical teach agents that frontmatter doesn't matter (CTX-007 F6): every ADR carried `tags: []` or copy-pasted tag lists nobody queried, `cov…",
       "word_count": 335,
-      "last_touched": "2026-07-14T04:17:37Z",
+      "last_touched": "2026-07-14T04:19:14Z",
       "age_days": 0,
       "referenced_by": [
         {
@@ -1736,6 +1736,10 @@
         {
           "id": "TP-046",
           "edge": "requires"
+        },
+        {
+          "id": "TP-056",
+          "edge": "requires"
         }
       ],
       "stale": false
@@ -1749,7 +1753,7 @@
       "type": "memo",
       "summary": "Zoov is the first large external dogfood of DocOps: 86 indexed docs (11 CTX, 37 ADR, 38 TP) over ~6 weeks of heavy agent-driven development, plus four folders the taxonomy never absorbed. This memo re…",
       "word_count": 748,
-      "last_touched": "2026-07-13T17:49:11Z",
+      "last_touched": "2026-07-14T04:19:14Z",
       "age_days": 0,
       "referenced_by": [
         {
@@ -2725,8 +2729,8 @@
       ],
       "summary": "- Phase 1 (`cf3a2c7`) — `Harness` interface + registry; Claude/Cursor   adapters. Byte-identical output. - Phase 2 (`daa00b6`) — OpenCode adapter + layout-aware writer   (`planHarness`, frontmatter pa…",
       "word_count": 1389,
-      "last_touched": "2026-04-24T03:10:20Z",
-      "age_days": 81,
+      "last_touched": "2026-07-14T04:19:14Z",
+      "age_days": 0,
       "checklist": {
         "done": 24,
         "total": 24
@@ -3004,7 +3008,7 @@
       ],
       "summary": "`templates/skills/docops/cookbook/close.md`, `SKILL.md`, `progress.md`, `graph.md` instruct agents to edit `task_status:` — the computed index field — instead of the source frontmatter key `status:` (…",
       "word_count": 108,
-      "last_touched": "2026-07-13T17:54:53Z",
+      "last_touched": "2026-07-14T04:19:14Z",
       "age_days": 0,
       "stale": false
     },
@@ -3023,7 +3027,7 @@
       ],
       "summary": "Zoov had 8 of 15 draft ADRs with `implementation: done` and nothing flagged it (CTX-007 F1). The index already computes implementation per ADR-0010 — surface the contradiction.",
       "word_count": 118,
-      "last_touched": "2026-07-14T03:27:39Z",
+      "last_touched": "2026-07-14T04:19:14Z",
       "age_days": 0,
       "stale": false
     },
@@ -3042,7 +3046,7 @@
       ],
       "summary": "No CLI verb mutates status; closing is a hand-edit, which is why statuses rot (CTX-007 F1). Add atomic transition verbs.",
       "word_count": 108,
-      "last_touched": "2026-07-14T03:34:43Z",
+      "last_touched": "2026-07-14T04:19:14Z",
       "age_days": 0,
       "stale": false
     },
@@ -3061,7 +3065,7 @@
       ],
       "summary": "Big tasks grow in-body phase trackers the index can't see, and get marked done with open work (CTX-007 F3). Legitimize the pattern instead of adding a subtask schema.",
       "word_count": 113,
-      "last_touched": "2026-07-14T03:38:35Z",
+      "last_touched": "2026-07-14T04:19:14Z",
       "age_days": 0,
       "checklist": {
         "done": 5,
@@ -3084,7 +3088,7 @@
       ],
       "summary": "`internal/audit/rules.go` and `internal/state/state.go computeAttention()` implement the same conditions twice with a severity mismatch (accepted-no-tasks: error vs warn) (CTX-007 F8).",
       "word_count": 102,
-      "last_touched": "2026-07-14T03:25:27Z",
+      "last_touched": "2026-07-14T04:19:14Z",
       "age_days": 0,
       "stale": false
     },
@@ -3103,7 +3107,7 @@
       ],
       "summary": "Superseding is expensive, amending is one command, so decision changes get mislabeled as clarifications (CTX-007 F5). Invert the gradient and enforce ADR-0025's hard rule mechanically.",
       "word_count": 298,
-      "last_touched": "2026-07-14T03:50:16Z",
+      "last_touched": "2026-07-14T04:19:14Z",
       "age_days": 0,
       "stale": false
     },
@@ -3123,7 +3127,7 @@
       ],
       "summary": "Zoov exiled a third of its doc tree (research/, operations/, resources/, original/) outside the graph (CTX-007 F4). Add a lightweight tier: docs indexed by path, citable in `related:`/`requires:`, but…",
       "word_count": 132,
-      "last_touched": "2026-07-14T04:02:46Z",
+      "last_touched": "2026-07-14T04:19:14Z",
       "age_days": 0,
       "stale": false
     },
@@ -3143,8 +3147,30 @@
       ],
       "summary": "Fields that are always empty or always identical are boilerplate that teaches agents frontmatter doesn't matter (CTX-007 F6). Per ADR-0002, removing/ defaulting schema fields is a schema-change event …",
       "word_count": 112,
-      "last_touched": "2026-07-14T04:17:38Z",
+      "last_touched": "2026-07-14T04:19:14Z",
+      "age_days": 0,
+      "stale": false
+    },
+    {
+      "id": "TP-056",
+      "kind": "TP",
+      "folder": "docs/tasks",
+      "path": "docs/tasks/TP-056-fix-windows-ci-adapter-path-separator-test-failure.md",
+      "title": "Fix Windows CI: adapter path-separator test failures + cmd test timeout",
+      "task_status": "backlog",
+      "priority": "p2",
+      "assignee": "unassigned",
+      "requires": [
+        "CTX-006"
+      ],
+      "summary": "CI on windows-latest has been red since ~2026-07-13 (run 29268534895), before the v0.8 work landed. Two distinct breakages:",
+      "word_count": 128,
+      "last_touched": "2026-07-14T04:21:25Z",
       "age_days": 0,
+      "checklist": {
+        "done": 0,
+        "total": 3
+      },
       "stale": false
     }
   ],

docs/STATE.md

@@ -6,7 +6,7 @@
 
 - Context: 7 active · 0 superseded
 - ADRs: 33 accepted · 3 draft · 0 superseded (35 `coverage: required`, 1 `coverage: not-needed`)
-- Tasks: 8 backlog · 0 active · 0 blocked · 47 done
+- Tasks: 9 backlog · 0 active · 0 blocked · 47 done
 
 ## Needs attention
 
@@ -21,6 +21,7 @@
 
 ## Recent activity
 
+- 2026-07-14 1f1ed45 docs: CTX-007 zoov-scale audit — ADR-0035/0036 accepted, TP-048..TP-055 closed
 - 2026-07-13 8034895 docs: draft ADR-0034 (task-ID commit subjects as activity signal) + TP-047
 - 2026-07-13 4371ca5 docs: CTX-006 testing-layers memo + TP-046 eval-suite follow-up task
 - 2026-07-13 35d65e2 fix(release): brew beta formula is docops-beta — @beta generates invalid Ruby

docs/tasks/TP-056-fix-windows-ci-adapter-path-separator-test-failure.md

@@ -0,0 +1,31 @@
+---
+title: 'Fix Windows CI: adapter path-separator test failures + cmd test timeout'
+status: backlog
+priority: p2
+assignee: unassigned
+requires: [CTX-006]
+---
+
+## Goal
+
+CI on windows-latest has been red since ~2026-07-13 (run 29268534895),
+before the v0.8 work landed. Two distinct breakages:
+
+1. `internal/upgrader` adapter tests fail on Windows — golden-file /
+   path-convention assertions (`TestCodexAdapter_*`, `TestOpenCodeAdapter_*`,
+   `TestClaudeAdapter_PathConvention`, `TestCursorAdapter_PathConvention`,
+   `TestRun_AddsNewSkillRemovesStaleRefreshesChanged`) — almost certainly
+   `\` vs `/` separators in expected paths.
+2. `cmd/docops` package panics: "test timed out after 10m0s" — some test
+   hangs on Windows (log shows a refresh FAIL followed by the hang).
+
+## Acceptance
+
+- [ ] windows-latest CI green on dev
+- [ ] root cause of the 10m hang identified and fixed (not just skipped)
+- [ ] adapter tests use filepath-aware comparisons
+
+## Notes
+
+Does not gate releases (goreleaser runs on ubuntu only) but hides real
+regressions on a supported platform (scoop channel ships Windows builds).