@webex/contact-center 3.13.0-next.1 → 3.13.0-next.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (84) hide show
  1. package/.repo-context.json +704 -0
  2. package/.sdd/manifest.json +1065 -339
  3. package/AGENTS.md +935 -60
  4. package/dist/webex.js +1 -1
  5. package/docs/adr/0001-spec-source-policy.md +97 -0
  6. package/{ai-docs/features/consult-transfer-list-policy/spec/feature-spec.md → docs/adr/0002-consult-transfer-list-policy.md} +227 -244
  7. package/docs/adr/0003-repo-standards-migration.md +104 -0
  8. package/docs/adr/index.md +35 -0
  9. package/docs/architecture.md +460 -0
  10. package/docs/getting-started.md +142 -0
  11. package/docs/index.md +53 -0
  12. package/docs/specs/README.md +98 -0
  13. package/package.json +10 -9
  14. package/schemas/repo-context.schema.json +796 -0
  15. package/src/docs/README.md +727 -0
  16. package/src/metrics/docs/README.md +710 -0
  17. package/src/services/agent/docs/README.md +673 -0
  18. package/src/services/config/docs/README.md +530 -0
  19. package/src/services/core/docs/README.md +993 -0
  20. package/src/services/docs/README.md +765 -0
  21. package/src/services/task/docs/README.md +1569 -0
  22. package/src/services/task/state-machine/docs/README.md +1388 -0
  23. package/src/utils/AGENTS.md +6 -4
  24. package/src/utils/docs/README.md +413 -0
  25. package/umd/contact-center.min.js +2 -2
  26. package/umd/contact-center.min.js.map +1 -1
  27. package/ai-docs/ARCHITECTURE.md +0 -168
  28. package/ai-docs/CONTRACTS.md +0 -64
  29. package/ai-docs/GETTING_STARTED.md +0 -168
  30. package/ai-docs/GLOSSARY.md +0 -43
  31. package/ai-docs/README.md +0 -138
  32. package/ai-docs/REVIEW_CHECKLIST.md +0 -41
  33. package/ai-docs/RULES.md +0 -444
  34. package/ai-docs/SECURITY.md +0 -52
  35. package/ai-docs/SERVICE_STATE.md +0 -52
  36. package/ai-docs/SPEC_INDEX.md +0 -65
  37. package/ai-docs/adr/0001-spec-source-policy.md +0 -55
  38. package/ai-docs/adr/README.md +0 -8
  39. package/ai-docs/adr/_adr-template.md +0 -31
  40. package/ai-docs/contact-center-spec.md +0 -388
  41. package/ai-docs/features/contact-owner-change-refactor.md +0 -78
  42. package/ai-docs/features/generated-spec-conformance-fidelity-remediation/spec/feature-spec.md +0 -117
  43. package/ai-docs/features/residual-warning-coverage-completion/spec/feature-spec.md +0 -203
  44. package/ai-docs/features/validator-code-fidelity-drift-fix/spec/feature-spec.md +0 -315
  45. package/ai-docs/patterns/event-driven-patterns.md +0 -485
  46. package/ai-docs/patterns/testing-patterns.md +0 -480
  47. package/ai-docs/patterns/typescript-patterns.md +0 -365
  48. package/ai-docs/templates/README.md +0 -102
  49. package/ai-docs/templates/documentation/create-agents-md.md +0 -240
  50. package/ai-docs/templates/documentation/create-architecture-md.md +0 -295
  51. package/ai-docs/templates/existing-service/bug-fix.md +0 -254
  52. package/ai-docs/templates/existing-service/feature-enhancement.md +0 -450
  53. package/ai-docs/templates/new-method/00-master.md +0 -80
  54. package/ai-docs/templates/new-method/01-requirements.md +0 -232
  55. package/ai-docs/templates/new-method/02-implementation.md +0 -295
  56. package/ai-docs/templates/new-method/03-tests.md +0 -201
  57. package/ai-docs/templates/new-method/04-validation.md +0 -141
  58. package/ai-docs/templates/new-service/00-master.md +0 -109
  59. package/ai-docs/templates/new-service/01-pre-questions.md +0 -159
  60. package/ai-docs/templates/new-service/02-code-generation.md +0 -346
  61. package/ai-docs/templates/new-service/03-integration.md +0 -178
  62. package/ai-docs/templates/new-service/04-test-generation.md +0 -205
  63. package/ai-docs/templates/new-service/05-validation.md +0 -145
  64. package/src/metrics/ai-docs/AGENTS.md +0 -350
  65. package/src/metrics/ai-docs/ARCHITECTURE.md +0 -338
  66. package/src/metrics/ai-docs/metrics-spec.md +0 -971
  67. package/src/services/agent/ai-docs/AGENTS.md +0 -240
  68. package/src/services/agent/ai-docs/ARCHITECTURE.md +0 -304
  69. package/src/services/agent/ai-docs/agent-spec.md +0 -505
  70. package/src/services/ai-docs/AGENTS.md +0 -386
  71. package/src/services/ai-docs/services-spec.md +0 -512
  72. package/src/services/config/ai-docs/AGENTS.md +0 -250
  73. package/src/services/config/ai-docs/ARCHITECTURE.md +0 -413
  74. package/src/services/config/ai-docs/config-spec.md +0 -669
  75. package/src/services/core/ai-docs/AGENTS.md +0 -381
  76. package/src/services/core/ai-docs/ARCHITECTURE.md +0 -698
  77. package/src/services/core/ai-docs/core-spec.md +0 -797
  78. package/src/services/task/ai-docs/AGENTS.md +0 -457
  79. package/src/services/task/ai-docs/ARCHITECTURE.md +0 -595
  80. package/src/services/task/ai-docs/task-spec.md +0 -1501
  81. package/src/services/task/state-machine/ai-docs/AGENTS.md +0 -460
  82. package/src/services/task/state-machine/ai-docs/ARCHITECTURE.md +0 -1156
  83. package/src/services/task/state-machine/ai-docs/task-state-machine-spec.md +0 -2247
  84. package/src/utils/ai-docs/utils-spec.md +0 -391
@@ -11,52 +11,192 @@
11
11
  },
12
12
  "topology": "Orchestrator-plus-components",
13
13
  "commands": {
14
+ "install": {
15
+ "command": "yarn",
16
+ "source_file": "../../../.github/workflows/deploy.yml",
17
+ "role": "install"
18
+ },
14
19
  "compile": {
15
20
  "command": "yarn workspace @webex/contact-center compile",
16
- "source_file": "packages/@webex/contact-center/package.json",
17
- "verified_at": "2026-08-05T10:53:14Z"
21
+ "source_file": "package.json",
22
+ "role": "compile"
18
23
  },
19
24
  "build": {
20
25
  "command": "yarn workspace @webex/contact-center build:src",
21
- "source_file": "package.json"
26
+ "source_file": "package.json",
27
+ "role": "package"
28
+ },
29
+ "types": {
30
+ "command": "yarn workspace @webex/contact-center build",
31
+ "source_file": "package.json",
32
+ "role": "other"
22
33
  },
23
34
  "unit-test": {
24
35
  "command": "yarn workspace @webex/contact-center test:unit",
25
- "source_file": "packages/@webex/contact-center/package.json",
26
- "verified_at": "2026-08-05T10:53:14Z"
36
+ "source_file": "package.json",
37
+ "role": "unit-test"
38
+ },
39
+ "lint": {
40
+ "command": "yarn workspace @webex/contact-center test:style",
41
+ "source_file": "package.json",
42
+ "role": "lint"
27
43
  },
28
- "test": {
44
+ "test-all": {
29
45
  "command": "yarn workspace @webex/contact-center test",
46
+ "source_file": "package.json",
47
+ "role": "other"
48
+ },
49
+ "e2e": {
50
+ "command": "yarn workspace @webex/contact-center test:e2e",
51
+ "source_file": "package.json",
52
+ "role": "e2e"
53
+ },
54
+ "fix-lint": {
55
+ "command": "yarn workspace @webex/contact-center fix:lint",
56
+ "source_file": "package.json",
57
+ "role": "other"
58
+ },
59
+ "fix-prettier": {
60
+ "command": "yarn workspace @webex/contact-center fix:prettier",
61
+ "source_file": "package.json",
62
+ "role": "other"
63
+ },
64
+ "docs-build": {
65
+ "command": "yarn workspace @webex/contact-center build:docs",
66
+ "source_file": "package.json",
67
+ "role": "other"
68
+ },
69
+ "deploy": {
70
+ "command": "yarn workspace @webex/contact-center deploy:npm",
71
+ "source_file": "package.json",
72
+ "role": "deploy"
73
+ }
74
+ },
75
+ "tests": {
76
+ "unit": {
77
+ "command_ref": "unit-test",
78
+ "dir": "test/unit/spec",
79
+ "framework": "jest"
80
+ },
81
+ "e2e": {
82
+ "command_ref": "e2e",
83
+ "dir": "../../../cc_playwright",
84
+ "framework": "playwright"
85
+ }
86
+ },
87
+ "toolchain": [
88
+ {
89
+ "name": "node",
90
+ "version": ">=20.x",
91
+ "origin": "repo-config",
30
92
  "source_file": "package.json"
31
93
  },
32
- "lint": {
33
- "command": "yarn workspace @webex/contact-center test:style",
94
+ {
95
+ "name": "node",
96
+ "version": "22.14",
97
+ "origin": "repo-config",
98
+ "source_file": "../../../AGENTS.md"
99
+ },
100
+ {
101
+ "name": "node",
102
+ "version": "lts/jod",
103
+ "origin": "repo-config",
104
+ "source_file": "../../../.nvmrc"
105
+ },
106
+ {
107
+ "name": "yarn",
108
+ "version": "3.4.1",
109
+ "origin": "repo-config",
110
+ "source_file": "../../../package.json"
111
+ },
112
+ {
113
+ "name": "typescript",
114
+ "version": "5.4.5",
115
+ "origin": "repo-config",
34
116
  "source_file": "package.json"
35
117
  },
36
- "docs": {
37
- "command": "yarn workspace @webex/contact-center build:docs",
118
+ {
119
+ "name": "jest",
120
+ "version": "27.5.1",
121
+ "origin": "repo-config",
122
+ "source_file": "package.json"
123
+ },
124
+ {
125
+ "name": "xstate",
126
+ "version": "5.24.0",
127
+ "origin": "repo-config",
128
+ "source_file": "package.json"
129
+ },
130
+ {
131
+ "name": "eslint",
132
+ "version": "^8.24.0",
133
+ "origin": "repo-config",
134
+ "source_file": "package.json"
135
+ },
136
+ {
137
+ "name": "prettier",
138
+ "version": "2.5.1",
139
+ "origin": "repo-config",
140
+ "source_file": "package.json"
141
+ },
142
+ {
143
+ "name": "typedoc",
144
+ "version": "^0.25.0",
145
+ "origin": "repo-config",
38
146
  "source_file": "package.json"
39
147
  }
148
+ ],
149
+ "quality_gates": {
150
+ "code_coverage": {
151
+ "origin": "repo-config",
152
+ "source_file": "jest.config.js",
153
+ "min": 85,
154
+ "kind": "unit-test",
155
+ "applies_to": "total",
156
+ "enforced": true
157
+ }
40
158
  },
41
159
  "coverage_status_definitions": {
42
160
  "specced": ">=80% public surface specced, drift <5% — spec is authoritative",
43
161
  "partial": "40-80% specced — spec is a hint, cross-check code",
44
162
  "untracked": "<40% specced — code is the source of truth"
45
163
  },
164
+ "template_migration": {
165
+ "status": "staged",
166
+ "target_source": "repo-standards",
167
+ "target_source_commit": "d89a7fe59126ae3ad9bac9ca352aa7f12b4c85dc",
168
+ "detected_footprints": [
169
+ "ai-docs",
170
+ "src/metrics/ai-docs",
171
+ "src/services/agent/ai-docs",
172
+ "src/services/ai-docs",
173
+ "src/services/config/ai-docs",
174
+ "src/services/core/ai-docs",
175
+ "src/services/task/ai-docs",
176
+ "src/services/task/state-machine/ai-docs",
177
+ "src/utils/ai-docs"
178
+ ],
179
+ "old_template_disposition": "remove-after-validation",
180
+ "decided_by": "rarajes2@cisco.com (confirmed in chat)",
181
+ "decided_at": "2026-11-16T00:00:00Z"
182
+ },
46
183
  "modules": [
47
184
  {
48
185
  "path": "src",
186
+ "canonical_spec": "src/docs/README.md",
49
187
  "coverage_status": "Partial",
50
- "coverage_evidence": "Canonical spec is structurally complete with 15/15 required documentation fields and source/test evidence mapped by requirement. Independent PR #5088 remediation validation completed on claude-code (2026-07-15); coverage remains Partial until post-baseline promotion criteria are satisfied.",
51
- "canonical_spec": "ai-docs/contact-center-spec.md",
188
+ "coverage_evidence": "Canonical spec is structurally complete with 15/15 required documentation fields and source/test evidence mapped by requirement. Independent PR #5088 remediation validation completed on claude-code (2026-07-15); coverage remains Partial until post-baseline promotion criteria are satisfied. Migrated on 2026-11-16 from the older ai-docs layout to the source-local repo-standards spec; coverage is carried, not reassessed, and coverage review remains pending. Independent validation on 2026-11-17 passed with warnings (0 Blocking, 0 Important, 4 Minor; validator runtime 01a1e76f-2293-79a0-9f8f-f060038448dd); no coverage promotion was performed.",
52
189
  "contracts": {
53
190
  "provides": [
54
- "Published @webex/contact-center package; ContactCenter WebexPlugin; public SDK methods, events, types, Task with ordered action-specific consult/transfer destination controls, AddressBook, ApiAIAssistant, UserPreference, cc.userPreference, existing getQueues/getEntryPoints methods with consult/transfer defaults, full Queue records, mapped EntryPoint records with optional numbers, exported user-preference request/response types, preview-campaign methods acceptPreviewContact/skipPreviewContact/removePreviewContact, Agent Wellness Break APIs, and browser voice getVoiceConnectionState()/voice:connectionStateChange contracts with persistent registration recovery, local line/Mobius status, Available transition guard, multi-login requirement cleanup, and logout reset",
55
- "WXCC-6026 wxApp Better Together: enableWxBetterTogether init config, isWxBetterTogetherEnabled read API, unified task telephony (task.accept/decline/toggleMute/transmitDtmf), TASK_WXAPP_MUTE_STATE_UPDATED event, optional main.keypad uiControl, multi-login supported; runtime toggle deferred to Phase 2 (private)",
56
- "BROWSER stationLogin payload: dialNumber and deviceId are webrtc-{agentId} (contact-center.station-login-browser-dn / AGENT-R-006); public stationLogin({loginOption: 'BROWSER'}) input unchanged"
191
+ "contact-center-sdk"
57
192
  ],
58
193
  "requires": [
59
- "Webex SDK host/plugin runtime; Contact Center REST and WebSocket services; internal Webex calling, metrics, support, authorization, logger, and mercury packages"
194
+ "webex-core-plugin-runtime",
195
+ "webex-calling-sdk",
196
+ "webex-internal-mercury",
197
+ "webex-internal-support",
198
+ "wxcc-api-gateway",
199
+ "wxcc-websocket-notifications"
60
200
  ]
61
201
  },
62
202
  "section_profile": {
@@ -76,31 +216,33 @@
76
216
  "published_package": true,
77
217
  "embedded_in_host": true,
78
218
  "holds_client_state": true,
79
- "resolved_by": "Codex generator with user-confirmed module map",
80
- "resolved_at": "2026-07-07T13:41:40Z"
219
+ "has_submodules": true,
220
+ "has_submodules_computed_by": "scripts/module_tree.py",
221
+ "has_submodules_computed_at": "2026-11-16T13:49:22Z",
222
+ "resolved_by": "claude-code/claude-opus-5-5 (carried from the 2026-07-07 user-confirmed profile; has_submodules from module_tree.py)",
223
+ "resolved_at": "2026-11-16T13:49:22Z"
81
224
  },
82
225
  "source_policy": {
83
226
  "mode": "migrate-existing",
84
227
  "existing_sources": [
85
- "AGENTS.md",
86
- "ai-docs/README.md"
228
+ "ai-docs/contact-center-spec.md"
87
229
  ],
88
230
  "conflict_status": "none",
89
- "decision_record": "ai-docs/adr/0001-spec-source-policy.md"
231
+ "decision_record": "docs/adr/0003-repo-standards-migration.md"
90
232
  }
91
233
  },
92
234
  {
93
235
  "path": "src/metrics",
236
+ "canonical_spec": "src/metrics/docs/README.md",
94
237
  "coverage_status": "Partial",
95
- "coverage_evidence": "Canonical spec is structurally complete with 15/15 required documentation fields and source/test evidence mapped by requirement. Independent PR #5088 remediation validation completed on claude-code (2026-07-15); coverage remains Partial until post-baseline promotion criteria are satisfied.",
96
- "canonical_spec": "src/metrics/ai-docs/metrics-spec.md",
238
+ "coverage_evidence": "Canonical spec is structurally complete with 15/15 required documentation fields and source/test evidence mapped by requirement. Independent PR #5088 remediation validation completed on claude-code (2026-07-15); coverage remains Partial until post-baseline promotion criteria are satisfied. Migrated on 2026-11-16 from the older ai-docs layout to the source-local repo-standards spec; coverage is carried, not reassessed, and coverage review remains pending. Independent validation on 2026-11-17 passed with warnings (0 Blocking, 0 Important, 4 Minor; validator runtime 01a1e76f-2293-79a0-9f8f-f060038448dd); no coverage promotion was performed.",
97
239
  "contracts": {
98
240
  "provides": [
99
- "MetricsManager timing, behavioral/operational/business event submission, taxonomy, queues, tracking-field helpers, and operational Agent Wellness Break action/notification/system-code event names",
100
- "WXAPP_OFFER_PARTICIPANT_FIELDS_MISSING operational/behavioral telemetry event (contract metrics.wxapp-offer-participant-fields-missing; emit site voice/wxAppOfferObservability.ts)"
241
+ "contact-center-metrics"
101
242
  ],
102
243
  "requires": [
103
- "Webex internal metrics service; Webex ready lifecycle; LoggerProxy; browser document visibility"
244
+ "webex-internal-metrics",
245
+ "webex-core-plugin-runtime"
104
246
  ]
105
247
  },
106
248
  "section_profile": {
@@ -120,30 +262,36 @@
120
262
  "published_package": false,
121
263
  "embedded_in_host": false,
122
264
  "holds_client_state": true,
123
- "resolved_by": "Codex generator with user-confirmed module map",
124
- "resolved_at": "2026-07-07T13:41:40Z"
265
+ "has_submodules": false,
266
+ "has_submodules_computed_by": "scripts/module_tree.py",
267
+ "has_submodules_computed_at": "2026-11-16T13:49:22Z",
268
+ "resolved_by": "claude-code/claude-opus-5-5 (carried from the 2026-07-07 user-confirmed profile; has_submodules from module_tree.py)",
269
+ "resolved_at": "2026-11-16T13:49:22Z"
125
270
  },
126
271
  "source_policy": {
127
272
  "mode": "migrate-existing",
128
273
  "existing_sources": [
129
274
  "src/metrics/ai-docs/AGENTS.md",
130
- "src/metrics/ai-docs/ARCHITECTURE.md"
275
+ "src/metrics/ai-docs/ARCHITECTURE.md",
276
+ "src/metrics/ai-docs/metrics-spec.md"
131
277
  ],
132
278
  "conflict_status": "none",
133
- "decision_record": "ai-docs/adr/0001-spec-source-policy.md"
279
+ "decision_record": "docs/adr/0003-repo-standards-migration.md"
134
280
  }
135
281
  },
136
282
  {
137
283
  "path": "src/services",
284
+ "canonical_spec": "src/services/docs/README.md",
138
285
  "coverage_status": "Partial",
139
- "coverage_evidence": "Canonical spec is structurally complete with 15/15 required documentation fields and source/test evidence mapped by requirement. Independent PR #5088 remediation validation completed on claude-code (2026-07-15); coverage remains Partial until post-baseline promotion criteria are satisfied.",
140
- "canonical_spec": "src/services/ai-docs/services-spec.md",
286
+ "coverage_evidence": "Canonical spec is structurally complete with 15/15 required documentation fields and source/test evidence mapped by requirement. Independent PR #5088 remediation validation completed on claude-code (2026-07-15); coverage remains Partial until post-baseline promotion criteria are satisfied. Migrated on 2026-11-16 from the older ai-docs layout to the source-local repo-standards spec; coverage is carried, not reassessed, and coverage review remains pending. Independent validation on 2026-11-17 passed with warnings (0 Blocking, 0 Important, 4 Minor; validator runtime 01a1e76f-2293-79a0-9f8f-f060038448dd); no coverage promotion was performed.",
141
287
  "contracts": {
142
288
  "provides": [
143
- "Services composition root; agent/config/contact/dialer factories; AddressBook, EntryPoint, Queue, UserPreference, ApiAiAssistant, and WebCalling integration; existing Queue/EntryPoint list methods with SDK-owned defaults and compatible existing-parameter overrides; Queue returns full records and EntryPoint maps profile-scoped dial-number rows to typed records with optional numbers; cc.userPreference exposes user-preference CRUD; ApiAiAssistant exposes session-validated direct wellness actions through a read-only context provider supplied at construction"
289
+ "contact-center-services"
144
290
  ],
145
291
  "requires": [
146
- "Core HTTP/WebSocket/AQM infrastructure; WCC APIs; @webex/calling; MetricsManager; PageCache"
292
+ "wxcc-api-gateway",
293
+ "webex-calling-sdk",
294
+ "webex-internal-mercury"
147
295
  ]
148
296
  },
149
297
  "section_profile": {
@@ -163,29 +311,34 @@
163
311
  "published_package": false,
164
312
  "embedded_in_host": false,
165
313
  "holds_client_state": true,
166
- "resolved_by": "Codex generator with user-confirmed module map",
167
- "resolved_at": "2026-07-07T13:41:40Z"
314
+ "has_submodules": true,
315
+ "has_submodules_computed_by": "scripts/module_tree.py",
316
+ "has_submodules_computed_at": "2026-11-16T13:49:22Z",
317
+ "resolved_by": "claude-code/claude-opus-5-5 (carried from the 2026-07-07 user-confirmed profile; has_submodules from module_tree.py)",
318
+ "resolved_at": "2026-11-16T13:49:22Z"
168
319
  },
169
320
  "source_policy": {
170
321
  "mode": "migrate-existing",
171
322
  "existing_sources": [
172
- "src/services/ai-docs/AGENTS.md"
323
+ "src/services/ai-docs/AGENTS.md",
324
+ "src/services/ai-docs/services-spec.md"
173
325
  ],
174
326
  "conflict_status": "none",
175
- "decision_record": "ai-docs/adr/0001-spec-source-policy.md"
327
+ "decision_record": "docs/adr/0003-repo-standards-migration.md"
176
328
  }
177
329
  },
178
330
  {
179
331
  "path": "src/services/agent",
332
+ "canonical_spec": "src/services/agent/docs/README.md",
180
333
  "coverage_status": "Partial",
181
- "coverage_evidence": "Canonical spec is structurally complete with 15/15 required documentation fields and source/test evidence mapped by requirement. Independent PR #5088 remediation validation completed on claude-code (2026-07-15); coverage remains Partial until post-baseline promotion criteria are satisfied.",
182
- "canonical_spec": "src/services/agent/ai-docs/agent-spec.md",
334
+ "coverage_evidence": "Canonical spec is structurally complete with 15/15 required documentation fields and source/test evidence mapped by requirement. Independent PR #5088 remediation validation completed on claude-code (2026-07-15); coverage remains Partial until post-baseline promotion criteria are satisfied. Migrated on 2026-11-16 from the older ai-docs layout to the source-local repo-standards spec; coverage is carried, not reassessed, and coverage review remains pending. Independent validation on 2026-11-17 passed with warnings (0 Blocking, 0 Important, 4 Minor; validator runtime 01a1e76f-2293-79a0-9f8f-f060038448dd); no coverage promotion was performed.",
183
335
  "contracts": {
184
336
  "provides": [
185
- "Agent request factory; station login/logout, state changes, buddy-agent and relogin operations; AGENT_EVENTS and agent types; BROWSER station login sends dialNumber and deviceId as webrtc-{agentId} (contact-center.station-login-browser-dn / AGENT-R-006)"
337
+ "contact-center-agent-events"
186
338
  ],
187
339
  "requires": [
188
- "AqmReqs; WCC API gateway; correlated WebSocket notifications; ContactCenter registration/profile state"
340
+ "wxcc-api-gateway",
341
+ "wxcc-websocket-notifications"
189
342
  ]
190
343
  },
191
344
  "section_profile": {
@@ -205,30 +358,35 @@
205
358
  "published_package": false,
206
359
  "embedded_in_host": false,
207
360
  "holds_client_state": false,
208
- "resolved_by": "Codex generator with user-confirmed module map",
209
- "resolved_at": "2026-07-07T13:41:40Z"
361
+ "has_submodules": false,
362
+ "has_submodules_computed_by": "scripts/module_tree.py",
363
+ "has_submodules_computed_at": "2026-11-16T13:49:22Z",
364
+ "resolved_by": "claude-code/claude-opus-5-5 (carried from the 2026-07-07 user-confirmed profile; has_submodules from module_tree.py)",
365
+ "resolved_at": "2026-11-16T13:49:22Z"
210
366
  },
211
367
  "source_policy": {
212
368
  "mode": "migrate-existing",
213
369
  "existing_sources": [
214
370
  "src/services/agent/ai-docs/AGENTS.md",
215
- "src/services/agent/ai-docs/ARCHITECTURE.md"
371
+ "src/services/agent/ai-docs/ARCHITECTURE.md",
372
+ "src/services/agent/ai-docs/agent-spec.md"
216
373
  ],
217
374
  "conflict_status": "none",
218
- "decision_record": "ai-docs/adr/0001-spec-source-policy.md"
375
+ "decision_record": "docs/adr/0003-repo-standards-migration.md"
219
376
  }
220
377
  },
221
378
  {
222
379
  "path": "src/services/config",
380
+ "canonical_spec": "src/services/config/docs/README.md",
223
381
  "coverage_status": "Partial",
224
- "coverage_evidence": "Canonical spec is structurally complete with 15/15 required documentation fields and source/test evidence mapped by requirement. Independent PR #5088 remediation validation completed on claude-code (2026-07-15); coverage remains Partial until post-baseline promotion criteria are satisfied.",
225
- "canonical_spec": "src/services/config/ai-docs/config-spec.md",
382
+ "coverage_evidence": "Canonical spec is structurally complete with 15/15 required documentation fields and source/test evidence mapped by requirement. Independent PR #5088 remediation validation completed on claude-code (2026-07-15); coverage remains Partial until post-baseline promotion criteria are satisfied. Migrated on 2026-11-16 from the older ai-docs layout to the source-local repo-standards spec; coverage is carried, not reassessed, and coverage review remains pending. Independent validation on 2026-11-17 passed with warnings (0 Blocking, 0 Important, 4 Minor; validator runtime 01a1e76f-2293-79a0-9f8f-f060038448dd); no coverage promotion was performed.",
226
383
  "contracts": {
227
384
  "provides": [
228
- "Agent profile aggregation including fail-closed Agent Wellness Break enablement; config endpoint methods including exact, registration-owned system wellness idle-code lookup; CC event/type contracts; outdial ANI access"
385
+ "contact-center-cc-events"
229
386
  ],
230
387
  "requires": [
231
- "WebexRequest; WCC organization and user desktop-login aggregate APIs; WCC team, aux-code, dial-plan, and site APIs"
388
+ "wxcc-api-gateway",
389
+ "wxcc-websocket-notifications"
232
390
  ]
233
391
  },
234
392
  "section_profile": {
@@ -248,30 +406,37 @@
248
406
  "published_package": false,
249
407
  "embedded_in_host": false,
250
408
  "holds_client_state": false,
251
- "resolved_by": "Codex generator with user-confirmed module map",
252
- "resolved_at": "2026-07-07T13:41:40Z"
409
+ "has_submodules": false,
410
+ "has_submodules_computed_by": "scripts/module_tree.py",
411
+ "has_submodules_computed_at": "2026-11-16T13:49:22Z",
412
+ "resolved_by": "claude-code/claude-opus-5-5 (carried from the 2026-07-07 user-confirmed profile; has_submodules from module_tree.py)",
413
+ "resolved_at": "2026-11-16T13:49:22Z"
253
414
  },
254
415
  "source_policy": {
255
416
  "mode": "migrate-existing",
256
417
  "existing_sources": [
257
418
  "src/services/config/ai-docs/AGENTS.md",
258
- "src/services/config/ai-docs/ARCHITECTURE.md"
419
+ "src/services/config/ai-docs/ARCHITECTURE.md",
420
+ "src/services/config/ai-docs/config-spec.md"
259
421
  ],
260
422
  "conflict_status": "none",
261
- "decision_record": "ai-docs/adr/0001-spec-source-policy.md"
423
+ "decision_record": "docs/adr/0003-repo-standards-migration.md"
262
424
  }
263
425
  },
264
426
  {
265
427
  "path": "src/services/core",
428
+ "canonical_spec": "src/services/core/docs/README.md",
266
429
  "coverage_status": "Partial",
267
- "coverage_evidence": "Canonical spec is structurally complete with 15/15 required documentation fields and source/test evidence mapped by requirement. Independent PR #5088 remediation validation completed on claude-code (2026-07-15); coverage remains Partial until post-baseline promotion criteria are satisfied.",
268
- "canonical_spec": "src/services/core/ai-docs/core-spec.md",
430
+ "coverage_evidence": "Canonical spec is structurally complete with 15/15 required documentation fields and source/test evidence mapped by requirement. Independent PR #5088 remediation validation completed on claude-code (2026-07-15); coverage remains Partial until post-baseline promotion criteria are satisfied. Migrated on 2026-11-16 from the older ai-docs layout to the source-local repo-standards spec; coverage is carried, not reassessed, and coverage review remains pending. Independent validation on 2026-11-17 passed with warnings (0 Blocking, 0 Important, 4 Minor; validator runtime 01a1e76f-2293-79a0-9f8f-f060038448dd); no coverage promotion was performed.",
269
431
  "contracts": {
270
432
  "provides": [
271
- "WebexRequest; WebSocketManager; ConnectionService; AqmReqs; shared error and request types/utilities"
433
+ "contact-center-core-transport"
272
434
  ],
273
435
  "requires": [
274
- "Webex SDK authenticated service routing; browser WebSocket/Worker/network APIs; LoggerProxy; metrics/log-upload infrastructure"
436
+ "webex-core-plugin-runtime",
437
+ "wxcc-api-gateway",
438
+ "wxcc-websocket-notifications",
439
+ "webex-internal-support"
275
440
  ]
276
441
  },
277
442
  "section_profile": {
@@ -291,32 +456,37 @@
291
456
  "published_package": false,
292
457
  "embedded_in_host": false,
293
458
  "holds_client_state": true,
294
- "resolved_by": "Codex generator with user-confirmed module map",
295
- "resolved_at": "2026-07-07T13:41:40Z"
459
+ "has_submodules": false,
460
+ "has_submodules_computed_by": "scripts/module_tree.py",
461
+ "has_submodules_computed_at": "2026-11-16T13:49:22Z",
462
+ "resolved_by": "claude-code/claude-opus-5-5 (carried from the 2026-07-07 user-confirmed profile; has_submodules from module_tree.py)",
463
+ "resolved_at": "2026-11-16T13:49:22Z"
296
464
  },
297
465
  "source_policy": {
298
466
  "mode": "migrate-existing",
299
467
  "existing_sources": [
300
468
  "src/services/core/ai-docs/AGENTS.md",
301
- "src/services/core/ai-docs/ARCHITECTURE.md"
469
+ "src/services/core/ai-docs/ARCHITECTURE.md",
470
+ "src/services/core/ai-docs/core-spec.md"
302
471
  ],
303
472
  "conflict_status": "none",
304
- "decision_record": "ai-docs/adr/0001-spec-source-policy.md"
473
+ "decision_record": "docs/adr/0003-repo-standards-migration.md"
305
474
  }
306
475
  },
307
476
  {
308
477
  "path": "src/services/task",
478
+ "canonical_spec": "src/services/task/docs/README.md",
309
479
  "coverage_status": "Partial",
310
- "coverage_evidence": "Canonical spec is structurally complete with 15/15 required documentation fields and source/test evidence mapped by requirement. Independent PR #5088 remediation validation completed on claude-code (2026-07-15); AI summary method, delivery, enablement, and cleanup updates are pending independent review (2026-10-06); coverage remains Partial until post-baseline promotion criteria are satisfied.",
311
- "canonical_spec": "src/services/task/ai-docs/task-spec.md",
480
+ "coverage_evidence": "Canonical spec is structurally complete with 15/15 required documentation fields and source/test evidence mapped by requirement. Independent PR #5088 remediation validation completed on claude-code (2026-07-15); AI summary method, delivery, enablement, and cleanup updates are pending independent review (2026-10-06); coverage remains Partial until post-baseline promotion criteria are satisfied. Migrated on 2026-11-16 from the older ai-docs layout to the source-local repo-standards spec; coverage is carried, not reassessed, and coverage review remains pending. Independent validation on 2026-11-17 passed with warnings (0 Blocking, 0 Important, 4 Minor; validator runtime 01a1e76f-2293-79a0-9f8f-f060038448dd); no coverage promotion was performed.",
312
481
  "contracts": {
313
482
  "provides": [
314
- "Task/Voice/WebRTC/Digital lifecycle APIs; TaskManager lifecycle correlation, narrowly scoped backend-authoritative ContactOwnerChanged recovery, and task-event publication, including routing owner-changing ContactUpdated through the existing task:hydrate event; TaskManager/Voice stamp wrapUpRequired on wrap-up ingress so task:wrapup and profile-gated auto wrap-up can start; task events/types; ordered action-specific consult/transfer destination controls; call-control and dialer operations including acceptPreviewContact, skipPreviewContact, and removePreviewContact",
315
- "task.ai-summary: receiving-agent summary events delivered directly to taskCollection[conversationId]; latest payload for an unavailable task retained without expiry until its collection key is registered or session cleanup; creation/merge replay follows public task publication; cleanup cancels requests and clears task flags and pending maps; ContactCenter deregistration removes the RTD listener",
316
- "contact-center.task-ai-summary: four dedicated request/response methods; request methods directly check current agent configuration generated-summary flags on the shared ApiAIAssistant.aiFeature field; responses use the current task interaction ID and main interaction ID with an interaction ID fallback for conversation ID; per-task enablement survives data updates, consults, re-keying, and wrapup, then clears on task removal or session cleanup"
483
+ "contact-center-task-events"
317
484
  ],
318
485
  "requires": [
319
- "Contact/dialer AqmReqs; WebSocket managers; @webex/calling; MetricsManager; XState task-state module"
486
+ "wxcc-api-gateway",
487
+ "wxcc-websocket-notifications",
488
+ "webex-calling-sdk",
489
+ "webex-internal-mercury"
320
490
  ]
321
491
  },
322
492
  "section_profile": {
@@ -336,30 +506,35 @@
336
506
  "published_package": false,
337
507
  "embedded_in_host": false,
338
508
  "holds_client_state": true,
339
- "resolved_by": "Codex generator with user-confirmed module map",
340
- "resolved_at": "2026-07-07T13:41:40Z"
509
+ "has_submodules": true,
510
+ "has_submodules_computed_by": "scripts/module_tree.py",
511
+ "has_submodules_computed_at": "2026-11-16T13:49:22Z",
512
+ "resolved_by": "claude-code/claude-opus-5-5 (carried from the 2026-07-07 user-confirmed profile; has_submodules from module_tree.py)",
513
+ "resolved_at": "2026-11-16T13:49:22Z"
341
514
  },
342
515
  "source_policy": {
343
516
  "mode": "migrate-existing",
344
517
  "existing_sources": [
518
+ "ai-docs/features/contact-owner-change-refactor.md",
345
519
  "src/services/task/ai-docs/AGENTS.md",
346
- "src/services/task/ai-docs/ARCHITECTURE.md"
520
+ "src/services/task/ai-docs/ARCHITECTURE.md",
521
+ "src/services/task/ai-docs/task-spec.md"
347
522
  ],
348
523
  "conflict_status": "none",
349
- "decision_record": "ai-docs/adr/0001-spec-source-policy.md"
524
+ "decision_record": "docs/adr/0003-repo-standards-migration.md"
350
525
  }
351
526
  },
352
527
  {
353
528
  "path": "src/services/task/state-machine",
529
+ "canonical_spec": "src/services/task/state-machine/docs/README.md",
354
530
  "coverage_status": "Partial",
355
- "coverage_evidence": "Canonical spec is structurally complete with 15/15 required documentation fields and source/test evidence mapped by requirement. Independent PR #5088 remediation validation completed on claude-code (2026-07-15); coverage remains Partial until post-baseline promotion criteria are satisfied.",
356
- "canonical_spec": "src/services/task/state-machine/ai-docs/task-state-machine-spec.md",
531
+ "coverage_evidence": "Canonical spec is structurally complete with 15/15 required documentation fields and source/test evidence mapped by requirement. Independent PR #5088 remediation validation completed on claude-code (2026-07-15); coverage remains Partial until post-baseline promotion criteria are satisfied. Migrated on 2026-11-16 from the older ai-docs layout to the source-local repo-standards spec; coverage is carried, not reassessed, and coverage review remains pending. Independent validation on 2026-11-17 passed with warnings (0 Blocking, 0 Important, 4 Minor; validator runtime 01a1e76f-2293-79a0-9f8f-f060038448dd); no coverage promotion was performed.",
357
532
  "contracts": {
358
533
  "provides": [
359
- "Task state-machine factory; TaskState/TaskEvent contracts; guards/actions; state/profile/interaction-derived UI-control and ordered consult/transfer destination computation"
534
+ "contact-center-task-state-machine"
360
535
  ],
361
536
  "requires": [
362
- "XState; TaskData/task event contracts; Task and TaskManager integration"
537
+ "xstate-runtime"
363
538
  ]
364
539
  },
365
540
  "section_profile": {
@@ -379,31 +554,33 @@
379
554
  "published_package": false,
380
555
  "embedded_in_host": false,
381
556
  "holds_client_state": true,
382
- "resolved_by": "Codex generator with user-confirmed module map",
383
- "resolved_at": "2026-07-07T13:41:40Z"
557
+ "has_submodules": false,
558
+ "has_submodules_computed_by": "scripts/module_tree.py",
559
+ "has_submodules_computed_at": "2026-11-16T13:49:22Z",
560
+ "resolved_by": "claude-code/claude-opus-5-5 (carried from the 2026-07-07 user-confirmed profile; has_submodules from module_tree.py)",
561
+ "resolved_at": "2026-11-16T13:49:22Z"
384
562
  },
385
563
  "source_policy": {
386
564
  "mode": "migrate-existing",
387
565
  "existing_sources": [
388
566
  "src/services/task/state-machine/ai-docs/AGENTS.md",
389
- "src/services/task/state-machine/ai-docs/ARCHITECTURE.md"
567
+ "src/services/task/state-machine/ai-docs/ARCHITECTURE.md",
568
+ "src/services/task/state-machine/ai-docs/task-state-machine-spec.md"
390
569
  ],
391
570
  "conflict_status": "none",
392
- "decision_record": "ai-docs/adr/0001-spec-source-policy.md"
571
+ "decision_record": "docs/adr/0003-repo-standards-migration.md"
393
572
  }
394
573
  },
395
574
  {
396
575
  "path": "src/utils",
576
+ "canonical_spec": "src/utils/docs/README.md",
397
577
  "coverage_status": "Partial",
398
- "coverage_evidence": "Canonical spec is structurally complete with 15/15 required documentation fields and source/test evidence mapped by requirement. Independent PR #5088 remediation validation completed on claude-code (2026-07-15); coverage remains Partial until post-baseline promotion criteria are satisfied.",
399
- "canonical_spec": "src/utils/ai-docs/utils-spec.md",
578
+ "coverage_evidence": "Canonical spec is structurally complete with 15/15 required documentation fields and source/test evidence mapped by requirement. Independent PR #5088 remediation validation completed on claude-code (2026-07-15); coverage remains Partial until post-baseline promotion criteria are satisfied. Migrated on 2026-11-16 from the older ai-docs layout to the source-local repo-standards spec; coverage is carried, not reassessed, and coverage review remains pending. Independent validation on 2026-11-17 passed with warnings (0 Blocking, 0 Important, 4 Minor; validator runtime 01a1e76f-2293-79a0-9f8f-f060038448dd); no coverage promotion was performed.",
400
579
  "contracts": {
401
580
  "provides": [
402
- "PageCache; pagination/search/cache contracts and defaults"
581
+ "contact-center-page-cache"
403
582
  ],
404
- "requires": [
405
- "LoggerProxy; in-memory Map and clock; AddressBook, EntryPoint, and Queue consumers"
406
- ]
583
+ "requires": []
407
584
  },
408
585
  "section_profile": {
409
586
  "has_ui": false,
@@ -422,24 +599,155 @@
422
599
  "published_package": false,
423
600
  "embedded_in_host": false,
424
601
  "holds_client_state": true,
425
- "resolved_by": "Codex generator with user-confirmed module map",
426
- "resolved_at": "2026-07-07T13:41:40Z"
602
+ "has_submodules": false,
603
+ "has_submodules_computed_by": "scripts/module_tree.py",
604
+ "has_submodules_computed_at": "2026-11-16T13:49:22Z",
605
+ "resolved_by": "claude-code/claude-opus-5-5 (carried from the 2026-07-07 user-confirmed profile; has_submodules from module_tree.py)",
606
+ "resolved_at": "2026-11-16T13:49:22Z"
427
607
  },
428
608
  "source_policy": {
429
609
  "mode": "migrate-existing",
430
610
  "existing_sources": [
611
+ "src/utils/ai-docs/utils-spec.md",
431
612
  "src/utils/AGENTS.md"
432
613
  ],
433
614
  "conflict_status": "none",
434
- "decision_record": "ai-docs/adr/0001-spec-source-policy.md"
615
+ "decision_record": "docs/adr/0003-repo-standards-migration.md"
435
616
  }
436
617
  }
437
618
  ],
619
+ "contract_catalog": {
620
+ "index_path": "docs/architecture.md",
621
+ "definitions": {
622
+ "contact-center-sdk": {
623
+ "kind": "sdk",
624
+ "publication": "published",
625
+ "source_kind": "repository-path",
626
+ "source": "package.json",
627
+ "summary": "Published npm package @webex/contact-center. main and exports[.] are dist/webex.js (src/webex.js); types is dist/types/index.d.ts built from src/index.ts, which exports ContactCenter (src/cc.ts, registered as webex.cc), routingAgent, Task, AddressBook, ApiAIAssistant, UserPreference, getDefaultUIControls, the event enums, and the public types. Specified in src/docs/README.md."
628
+ },
629
+ "contact-center-cc-events": {
630
+ "kind": "event",
631
+ "publication": "published",
632
+ "source_kind": "repository-path",
633
+ "source": "src/services/config/types.ts",
634
+ "summary": "CC_EVENTS, CC_AGENT_EVENTS, CC_TASK_EVENTS and VOICE_CONNECTION_EVENTS: the WebSocket notification types and the SDK events ContactCenter emits for them. Specified in src/services/config/docs/README.md."
635
+ },
636
+ "contact-center-agent-events": {
637
+ "kind": "event",
638
+ "publication": "published",
639
+ "source_kind": "repository-path",
640
+ "source": "src/services/agent/types.ts",
641
+ "summary": "AGENT_EVENTS and the agent request and response types for station login, logout, state change, buddy agents, and relogin. Specified in src/services/agent/docs/README.md."
642
+ },
643
+ "contact-center-task-events": {
644
+ "kind": "event",
645
+ "publication": "published",
646
+ "source_kind": "repository-path",
647
+ "source": "src/services/task/types.ts",
648
+ "summary": "TASK_EVENTS and the TaskData, TaskResponse, and task method payload types emitted and accepted by Task, Voice, WebRTC, and Digital. Specified in src/services/task/docs/README.md."
649
+ },
650
+ "contact-center-task-state-machine": {
651
+ "kind": "sdk",
652
+ "publication": "internal",
653
+ "source_kind": "repository-path",
654
+ "source": "src/services/task/state-machine/index.ts",
655
+ "summary": "XState task state machine factory, TaskState and TaskEvent contracts, guards, actions, and the UI-control computer; getDefaultUIControls is re-exported publicly through src/index.ts. Specified in src/services/task/state-machine/docs/README.md."
656
+ },
657
+ "contact-center-services": {
658
+ "kind": "sdk",
659
+ "publication": "internal",
660
+ "source_kind": "repository-path",
661
+ "source": "src/services/index.ts",
662
+ "summary": "Services composition root that builds the agent, config, contact, and dialer request factories over AqmReqs and WebexRequest. Specified in src/services/docs/README.md."
663
+ },
664
+ "contact-center-core-transport": {
665
+ "kind": "sdk",
666
+ "publication": "internal",
667
+ "source_kind": "repository-path",
668
+ "source": "src/services/core/aqm-reqs.ts",
669
+ "summary": "AqmReqs request/notification correlation, WebexRequest HTTP calls, WebSocketManager and ConnectionService socket lifecycle, and the shared error and utility helpers. Specified in src/services/core/docs/README.md."
670
+ },
671
+ "contact-center-metrics": {
672
+ "kind": "event",
673
+ "publication": "internal",
674
+ "source_kind": "repository-path",
675
+ "source": "src/metrics/constants.ts",
676
+ "summary": "METRIC_EVENT_NAMES and the MetricsManager behavioral, operational, and business event submission API. Specified in src/metrics/docs/README.md."
677
+ },
678
+ "contact-center-page-cache": {
679
+ "kind": "sdk",
680
+ "publication": "internal",
681
+ "source_kind": "repository-path",
682
+ "source": "src/utils/PageCache.ts",
683
+ "summary": "PageCache and the pagination types and defaults shared by AddressBook, EntryPoint, and Queue. Specified in src/utils/docs/README.md."
684
+ },
685
+ "wxcc-api-gateway": {
686
+ "kind": "http",
687
+ "publication": "published",
688
+ "source_kind": "external",
689
+ "source": "Webex Contact Center API gateway (WCC API), reached through webex.request with the wcc-api-gateway service name",
690
+ "summary": "Agent, task, configuration, address book, entry point, queue, user preference, and AI assistant REST endpoints owned by the Contact Center backend. This package consumes them and owns no route."
691
+ },
692
+ "wxcc-websocket-notifications": {
693
+ "kind": "event",
694
+ "publication": "published",
695
+ "source_kind": "external",
696
+ "source": "Webex Contact Center notification WebSocket (subscribe endpoint and socket messages)",
697
+ "summary": "Agent, task, and configuration notifications pushed by the Contact Center backend and correlated by AqmReqs; message type names are mirrored in src/services/config/types.ts."
698
+ },
699
+ "webex-core-plugin-runtime": {
700
+ "kind": "sdk",
701
+ "publication": "published",
702
+ "source_kind": "external",
703
+ "source": "@webex/webex-core (workspace package)",
704
+ "summary": "registerPlugin, WebexPlugin, webex.request service routing, and the ready lifecycle the ContactCenter plugin is built on."
705
+ },
706
+ "webex-calling-sdk": {
707
+ "kind": "sdk",
708
+ "publication": "published",
709
+ "source_kind": "external",
710
+ "source": "@webex/calling (workspace package)",
711
+ "summary": "Calling client, line registration, and call objects used for BROWSER station login and WebRTC voice tasks."
712
+ },
713
+ "webex-internal-mercury": {
714
+ "kind": "sdk",
715
+ "publication": "published",
716
+ "source_kind": "external",
717
+ "source": "@webex/internal-plugin-mercury (workspace package)",
718
+ "summary": "Mercury event stream used for the Webex app (Better Together) telephony synchronisation."
719
+ },
720
+ "webex-internal-metrics": {
721
+ "kind": "sdk",
722
+ "publication": "published",
723
+ "source_kind": "external",
724
+ "source": "@webex/internal-plugin-metrics (workspace package)",
725
+ "summary": "Internal metrics submission used by MetricsManager."
726
+ },
727
+ "webex-internal-support": {
728
+ "kind": "sdk",
729
+ "publication": "published",
730
+ "source_kind": "external",
731
+ "source": "@webex/internal-plugin-support (workspace package)",
732
+ "summary": "Log upload used by the uploadLogs flow."
733
+ },
734
+ "xstate-runtime": {
735
+ "kind": "sdk",
736
+ "publication": "published",
737
+ "source_kind": "external",
738
+ "source": "xstate 5.24.0 (npm dependency)",
739
+ "summary": "Actor and state-machine runtime behind the task state machine."
740
+ }
741
+ }
742
+ },
438
743
  "spec_source_policy": {
439
744
  "mode": "migrate-existing",
440
- "decided_by": "user",
441
- "decided_at": "2026-07-07T13:27:09Z",
442
- "decision_record": "ai-docs/adr/0001-spec-source-policy.md"
745
+ "migrated_source_disposition": "delete-after-validation",
746
+ "disposition_decided_by": "rarajes2@cisco.com (confirmed in chat)",
747
+ "disposition_decided_at": "2026-11-16T00:00:00Z",
748
+ "decided_by": "rarajes2@cisco.com (confirmed in chat)",
749
+ "decided_at": "2026-11-16T00:00:00Z",
750
+ "decision_record": "docs/adr/0003-repo-standards-migration.md"
443
751
  },
444
752
  "spec_sources": [
445
753
  {
@@ -449,406 +757,820 @@
449
757
  "canonical": true,
450
758
  "use_by_agents": "source-for-migration",
451
759
  "canonical_target": "AGENTS.md",
452
- "notes": "Approved in-place canonical target; source units must be inventoried before rewrite."
760
+ "post_migration_action": "retain",
761
+ "deletion_status": "not-applicable",
762
+ "notes": "Existing human-reviewed package agent entry at the canonical path. Its guidance is merged in place into the repo-standards agent-entry shape."
453
763
  },
454
764
  {
455
765
  "path": "ai-docs/README.md",
456
766
  "scope": "repo",
457
- "role": "source-material",
767
+ "role": "superseded",
458
768
  "canonical": false,
459
769
  "use_by_agents": "source-for-migration",
460
- "canonical_target": "ai-docs/GETTING_STARTED.md",
461
- "notes": "Package purpose, technologies, navigation, commands, and architecture overview migrate by meaning."
770
+ "canonical_target": "docs/index.md",
771
+ "post_migration_action": "delete-after-validation",
772
+ "deletion_status": "deleted",
773
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
462
774
  },
463
775
  {
464
- "path": "ai-docs/RULES.md",
776
+ "path": "ai-docs/ARCHITECTURE.md",
465
777
  "scope": "repo",
466
- "role": "source-material",
467
- "canonical": true,
778
+ "role": "superseded",
779
+ "canonical": false,
468
780
  "use_by_agents": "source-for-migration",
469
- "canonical_target": "ai-docs/RULES.md",
470
- "notes": "Approved in-place canonical standing document; source units must be inventoried before rewrite."
781
+ "canonical_target": "docs/architecture.md",
782
+ "post_migration_action": "delete-after-validation",
783
+ "deletion_status": "deleted",
784
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
471
785
  },
472
786
  {
473
- "path": "ai-docs/patterns/event-driven-patterns.md",
474
- "scope": "reference",
475
- "role": "source-material",
787
+ "path": "ai-docs/CONTRACTS.md",
788
+ "scope": "repo",
789
+ "role": "superseded",
476
790
  "canonical": false,
477
791
  "use_by_agents": "source-for-migration",
478
- "canonical_target": "ai-docs/RULES.md",
479
- "notes": "Event and WebSocket rules remain in place and feed canonical rules/module specs."
792
+ "canonical_target": "docs/architecture.md",
793
+ "post_migration_action": "delete-after-validation",
794
+ "deletion_status": "deleted",
795
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
480
796
  },
481
797
  {
482
- "path": "ai-docs/patterns/testing-patterns.md",
483
- "scope": "reference",
484
- "role": "source-material",
798
+ "path": "ai-docs/GETTING_STARTED.md",
799
+ "scope": "repo",
800
+ "role": "superseded",
485
801
  "canonical": false,
486
802
  "use_by_agents": "source-for-migration",
487
- "canonical_target": "ai-docs/RULES.md",
488
- "notes": "Testing conventions remain in place and feed canonical rules/module specs."
803
+ "canonical_target": "docs/getting-started.md",
804
+ "post_migration_action": "delete-after-validation",
805
+ "deletion_status": "deleted",
806
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
489
807
  },
490
808
  {
491
- "path": "ai-docs/patterns/typescript-patterns.md",
492
- "scope": "reference",
493
- "role": "source-material",
809
+ "path": "ai-docs/GLOSSARY.md",
810
+ "scope": "repo",
811
+ "role": "superseded",
494
812
  "canonical": false,
495
813
  "use_by_agents": "source-for-migration",
496
- "canonical_target": "ai-docs/RULES.md",
497
- "notes": "TypeScript/JSDoc conventions remain in place and feed canonical rules/module specs."
814
+ "canonical_target": "docs/architecture.md",
815
+ "post_migration_action": "delete-after-validation",
816
+ "deletion_status": "deleted",
817
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
498
818
  },
499
819
  {
500
- "path": "src/metrics/ai-docs/AGENTS.md",
501
- "scope": "module",
502
- "role": "source-material",
820
+ "path": "ai-docs/REVIEW_CHECKLIST.md",
821
+ "scope": "repo",
822
+ "role": "superseded",
503
823
  "canonical": false,
504
824
  "use_by_agents": "source-for-migration",
505
- "module": "src/metrics",
506
- "canonical_target": "src/metrics/ai-docs/metrics-spec.md",
507
- "notes": "Retained in place; becomes a superseded migration source only after source-fidelity and canonical generation pass."
825
+ "canonical_target": "AGENTS.md",
826
+ "post_migration_action": "delete-after-validation",
827
+ "deletion_status": "deleted",
828
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
508
829
  },
509
830
  {
510
- "path": "src/metrics/ai-docs/ARCHITECTURE.md",
511
- "scope": "module",
512
- "role": "source-material",
831
+ "path": "ai-docs/RULES.md",
832
+ "scope": "repo",
833
+ "role": "superseded",
513
834
  "canonical": false,
514
835
  "use_by_agents": "source-for-migration",
515
- "module": "src/metrics",
516
- "canonical_target": "src/metrics/ai-docs/metrics-spec.md",
517
- "notes": "Retained in place; becomes a superseded migration source only after source-fidelity and canonical generation pass."
836
+ "canonical_target": "AGENTS.md",
837
+ "post_migration_action": "delete-after-validation",
838
+ "deletion_status": "deleted",
839
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
518
840
  },
519
841
  {
520
- "path": "src/services/ai-docs/AGENTS.md",
521
- "scope": "module",
522
- "role": "source-material",
842
+ "path": "ai-docs/SECURITY.md",
843
+ "scope": "repo",
844
+ "role": "superseded",
523
845
  "canonical": false,
524
846
  "use_by_agents": "source-for-migration",
525
- "module": "src/services",
526
- "canonical_target": "src/services/ai-docs/services-spec.md",
527
- "notes": "Retained in place; becomes a superseded migration source only after source-fidelity and canonical generation pass."
847
+ "canonical_target": "docs/architecture.md",
848
+ "post_migration_action": "delete-after-validation",
849
+ "deletion_status": "deleted",
850
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
528
851
  },
529
852
  {
530
- "path": "src/services/agent/ai-docs/AGENTS.md",
531
- "scope": "module",
532
- "role": "source-material",
853
+ "path": "ai-docs/SERVICE_STATE.md",
854
+ "scope": "repo",
855
+ "role": "superseded",
533
856
  "canonical": false,
534
857
  "use_by_agents": "source-for-migration",
535
- "module": "src/services/agent",
536
- "canonical_target": "src/services/agent/ai-docs/agent-spec.md",
537
- "notes": "Retained in place; becomes a superseded migration source only after source-fidelity and canonical generation pass."
858
+ "canonical_target": "docs/architecture.md",
859
+ "post_migration_action": "delete-after-validation",
860
+ "deletion_status": "deleted",
861
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
538
862
  },
539
863
  {
540
- "path": "src/services/agent/ai-docs/ARCHITECTURE.md",
541
- "scope": "module",
542
- "role": "source-material",
864
+ "path": "ai-docs/SPEC_INDEX.md",
865
+ "scope": "repo",
866
+ "role": "superseded",
543
867
  "canonical": false,
544
868
  "use_by_agents": "source-for-migration",
545
- "module": "src/services/agent",
546
- "canonical_target": "src/services/agent/ai-docs/agent-spec.md",
547
- "notes": "Retained in place; becomes a superseded migration source only after source-fidelity and canonical generation pass."
869
+ "canonical_target": "docs/specs/README.md",
870
+ "post_migration_action": "delete-after-validation",
871
+ "deletion_status": "deleted",
872
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
548
873
  },
549
874
  {
550
- "path": "src/services/config/ai-docs/AGENTS.md",
551
- "scope": "module",
552
- "role": "source-material",
875
+ "path": "ai-docs/adr/0001-spec-source-policy.md",
876
+ "scope": "repo",
877
+ "role": "superseded",
553
878
  "canonical": false,
554
879
  "use_by_agents": "source-for-migration",
555
- "module": "src/services/config",
556
- "canonical_target": "src/services/config/ai-docs/config-spec.md",
557
- "notes": "Retained in place; becomes a superseded migration source only after source-fidelity and canonical generation pass."
880
+ "canonical_target": "docs/adr/0001-spec-source-policy.md",
881
+ "post_migration_action": "delete-after-validation",
882
+ "deletion_status": "deleted",
883
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
558
884
  },
559
885
  {
560
- "path": "src/services/config/ai-docs/ARCHITECTURE.md",
561
- "scope": "module",
562
- "role": "source-material",
886
+ "path": "ai-docs/adr/README.md",
887
+ "scope": "repo",
888
+ "role": "superseded",
563
889
  "canonical": false,
564
890
  "use_by_agents": "source-for-migration",
565
- "module": "src/services/config",
566
- "canonical_target": "src/services/config/ai-docs/config-spec.md",
567
- "notes": "Retained in place; becomes a superseded migration source only after source-fidelity and canonical generation pass."
891
+ "canonical_target": "docs/adr/index.md",
892
+ "post_migration_action": "delete-after-validation",
893
+ "deletion_status": "deleted",
894
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
568
895
  },
569
896
  {
570
- "path": "src/services/core/ai-docs/AGENTS.md",
571
- "scope": "module",
572
- "role": "source-material",
897
+ "path": "ai-docs/adr/_adr-template.md",
898
+ "scope": "repo",
899
+ "role": "superseded",
573
900
  "canonical": false,
574
901
  "use_by_agents": "source-for-migration",
575
- "module": "src/services/core",
576
- "canonical_target": "src/services/core/ai-docs/core-spec.md",
577
- "notes": "Retained in place; becomes a superseded migration source only after source-fidelity and canonical generation pass."
902
+ "canonical_target": "docs/adr/index.md",
903
+ "post_migration_action": "delete-after-validation",
904
+ "deletion_status": "deleted",
905
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
578
906
  },
579
907
  {
580
- "path": "src/services/core/ai-docs/ARCHITECTURE.md",
908
+ "path": "ai-docs/contact-center-spec.md",
581
909
  "scope": "module",
582
- "role": "source-material",
910
+ "module": "src",
911
+ "role": "superseded",
583
912
  "canonical": false,
584
913
  "use_by_agents": "source-for-migration",
585
- "module": "src/services/core",
586
- "canonical_target": "src/services/core/ai-docs/core-spec.md",
587
- "notes": "Retained in place; becomes a superseded migration source only after source-fidelity and canonical generation pass."
914
+ "canonical_target": "src/docs/README.md",
915
+ "post_migration_action": "delete-after-validation",
916
+ "deletion_status": "deleted",
917
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
588
918
  },
589
919
  {
590
- "path": "src/services/task/ai-docs/AGENTS.md",
591
- "scope": "module",
592
- "role": "source-material",
920
+ "path": "ai-docs/features/consult-transfer-list-policy/spec/feature-spec.md",
921
+ "scope": "feature",
922
+ "role": "superseded",
593
923
  "canonical": false,
594
924
  "use_by_agents": "source-for-migration",
595
- "module": "src/services/task",
596
- "canonical_target": "src/services/task/ai-docs/task-spec.md",
597
- "notes": "Retained in place; becomes a superseded migration source only after source-fidelity and canonical generation pass."
925
+ "canonical_target": "docs/adr/0002-consult-transfer-list-policy.md",
926
+ "post_migration_action": "delete-after-validation",
927
+ "deletion_status": "deleted",
928
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
598
929
  },
599
930
  {
600
- "path": "src/services/task/ai-docs/ARCHITECTURE.md",
601
- "scope": "module",
602
- "role": "source-material",
931
+ "path": "ai-docs/features/contact-owner-change-refactor.md",
932
+ "scope": "feature",
933
+ "role": "superseded",
603
934
  "canonical": false,
604
935
  "use_by_agents": "source-for-migration",
605
- "module": "src/services/task",
606
- "canonical_target": "src/services/task/ai-docs/task-spec.md",
607
- "notes": "Retained in place; becomes a superseded migration source only after source-fidelity and canonical generation pass."
936
+ "canonical_target": "src/services/task/docs/README.md",
937
+ "post_migration_action": "delete-after-validation",
938
+ "deletion_status": "deleted",
939
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
608
940
  },
609
941
  {
610
- "path": "src/services/task/state-machine/ai-docs/AGENTS.md",
611
- "scope": "module",
612
- "role": "source-material",
942
+ "path": "ai-docs/features/generated-spec-conformance-fidelity-remediation/spec/feature-spec.md",
943
+ "scope": "feature",
944
+ "role": "superseded",
613
945
  "canonical": false,
614
946
  "use_by_agents": "source-for-migration",
615
- "module": "src/services/task/state-machine",
616
- "canonical_target": "src/services/task/state-machine/ai-docs/task-state-machine-spec.md",
617
- "notes": "Retained in place; becomes a superseded migration source only after source-fidelity and canonical generation pass."
947
+ "canonical_target": "docs/specs/README.md",
948
+ "post_migration_action": "delete-after-validation",
949
+ "deletion_status": "deleted",
950
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
618
951
  },
619
952
  {
620
- "path": "src/services/task/state-machine/ai-docs/ARCHITECTURE.md",
621
- "scope": "module",
622
- "role": "source-material",
953
+ "path": "ai-docs/features/residual-warning-coverage-completion/spec/feature-spec.md",
954
+ "scope": "feature",
955
+ "role": "superseded",
623
956
  "canonical": false,
624
957
  "use_by_agents": "source-for-migration",
625
- "module": "src/services/task/state-machine",
626
- "canonical_target": "src/services/task/state-machine/ai-docs/task-state-machine-spec.md",
627
- "notes": "Retained in place; becomes a superseded migration source only after source-fidelity and canonical generation pass."
958
+ "canonical_target": "docs/specs/README.md",
959
+ "post_migration_action": "delete-after-validation",
960
+ "deletion_status": "deleted",
961
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
628
962
  },
629
963
  {
630
- "path": "src/utils/AGENTS.md",
631
- "scope": "module",
632
- "role": "source-material",
964
+ "path": "ai-docs/features/validator-code-fidelity-drift-fix/spec/feature-spec.md",
965
+ "scope": "feature",
966
+ "role": "superseded",
633
967
  "canonical": false,
634
968
  "use_by_agents": "source-for-migration",
635
- "module": "src/utils",
636
- "canonical_target": "src/utils/ai-docs/utils-spec.md",
637
- "notes": "Retained in place; becomes a superseded migration source only after source-fidelity and canonical generation pass."
969
+ "canonical_target": "docs/specs/README.md",
970
+ "post_migration_action": "delete-after-validation",
971
+ "deletion_status": "deleted",
972
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
973
+ },
974
+ {
975
+ "path": "ai-docs/patterns/event-driven-patterns.md",
976
+ "scope": "repo",
977
+ "role": "superseded",
978
+ "canonical": false,
979
+ "use_by_agents": "source-for-migration",
980
+ "canonical_target": "AGENTS.md",
981
+ "post_migration_action": "delete-after-validation",
982
+ "deletion_status": "deleted",
983
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
984
+ },
985
+ {
986
+ "path": "ai-docs/patterns/testing-patterns.md",
987
+ "scope": "repo",
988
+ "role": "superseded",
989
+ "canonical": false,
990
+ "use_by_agents": "source-for-migration",
991
+ "canonical_target": "AGENTS.md",
992
+ "post_migration_action": "delete-after-validation",
993
+ "deletion_status": "deleted",
994
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
995
+ },
996
+ {
997
+ "path": "ai-docs/patterns/typescript-patterns.md",
998
+ "scope": "repo",
999
+ "role": "superseded",
1000
+ "canonical": false,
1001
+ "use_by_agents": "source-for-migration",
1002
+ "canonical_target": "AGENTS.md",
1003
+ "post_migration_action": "delete-after-validation",
1004
+ "deletion_status": "deleted",
1005
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
638
1006
  },
639
1007
  {
640
1008
  "path": "ai-docs/templates/README.md",
641
- "scope": "reference",
642
- "role": "reference-only",
1009
+ "scope": "repo",
1010
+ "role": "superseded",
643
1011
  "canonical": false,
644
- "use_by_agents": "context-only",
645
- "notes": "Legacy package workflow template retained unchanged; not a product intent/design source for canonical SDD specs."
1012
+ "use_by_agents": "source-for-migration",
1013
+ "canonical_target": "AGENTS.md",
1014
+ "post_migration_action": "delete-after-validation",
1015
+ "deletion_status": "deleted",
1016
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
646
1017
  },
647
1018
  {
648
1019
  "path": "ai-docs/templates/documentation/create-agents-md.md",
649
- "scope": "reference",
650
- "role": "reference-only",
1020
+ "scope": "repo",
1021
+ "role": "superseded",
651
1022
  "canonical": false,
652
- "use_by_agents": "context-only",
653
- "notes": "Legacy package workflow template retained unchanged; not a product intent/design source for canonical SDD specs."
1023
+ "use_by_agents": "source-for-migration",
1024
+ "canonical_target": "AGENTS.md",
1025
+ "post_migration_action": "delete-after-validation",
1026
+ "deletion_status": "deleted",
1027
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
654
1028
  },
655
1029
  {
656
1030
  "path": "ai-docs/templates/documentation/create-architecture-md.md",
657
- "scope": "reference",
658
- "role": "reference-only",
1031
+ "scope": "repo",
1032
+ "role": "superseded",
659
1033
  "canonical": false,
660
- "use_by_agents": "context-only",
661
- "notes": "Legacy package workflow template retained unchanged; not a product intent/design source for canonical SDD specs."
1034
+ "use_by_agents": "source-for-migration",
1035
+ "canonical_target": "AGENTS.md",
1036
+ "post_migration_action": "delete-after-validation",
1037
+ "deletion_status": "deleted",
1038
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
662
1039
  },
663
1040
  {
664
1041
  "path": "ai-docs/templates/existing-service/bug-fix.md",
665
- "scope": "reference",
666
- "role": "reference-only",
1042
+ "scope": "repo",
1043
+ "role": "superseded",
667
1044
  "canonical": false,
668
- "use_by_agents": "context-only",
669
- "notes": "Legacy package workflow template retained unchanged; not a product intent/design source for canonical SDD specs."
1045
+ "use_by_agents": "source-for-migration",
1046
+ "canonical_target": "AGENTS.md",
1047
+ "post_migration_action": "delete-after-validation",
1048
+ "deletion_status": "deleted",
1049
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
670
1050
  },
671
1051
  {
672
1052
  "path": "ai-docs/templates/existing-service/feature-enhancement.md",
673
- "scope": "reference",
674
- "role": "reference-only",
1053
+ "scope": "repo",
1054
+ "role": "superseded",
675
1055
  "canonical": false,
676
- "use_by_agents": "context-only",
677
- "notes": "Legacy package workflow template retained unchanged; not a product intent/design source for canonical SDD specs."
1056
+ "use_by_agents": "source-for-migration",
1057
+ "canonical_target": "AGENTS.md",
1058
+ "post_migration_action": "delete-after-validation",
1059
+ "deletion_status": "deleted",
1060
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
678
1061
  },
679
1062
  {
680
1063
  "path": "ai-docs/templates/new-method/00-master.md",
681
- "scope": "reference",
682
- "role": "reference-only",
1064
+ "scope": "repo",
1065
+ "role": "superseded",
683
1066
  "canonical": false,
684
- "use_by_agents": "context-only",
685
- "notes": "Legacy package workflow template retained unchanged; not a product intent/design source for canonical SDD specs."
1067
+ "use_by_agents": "source-for-migration",
1068
+ "canonical_target": "AGENTS.md",
1069
+ "post_migration_action": "delete-after-validation",
1070
+ "deletion_status": "deleted",
1071
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
686
1072
  },
687
1073
  {
688
1074
  "path": "ai-docs/templates/new-method/01-requirements.md",
689
- "scope": "reference",
690
- "role": "reference-only",
1075
+ "scope": "repo",
1076
+ "role": "superseded",
691
1077
  "canonical": false,
692
- "use_by_agents": "context-only",
693
- "notes": "Legacy package workflow template retained unchanged; not a product intent/design source for canonical SDD specs."
1078
+ "use_by_agents": "source-for-migration",
1079
+ "canonical_target": "AGENTS.md",
1080
+ "post_migration_action": "delete-after-validation",
1081
+ "deletion_status": "deleted",
1082
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
694
1083
  },
695
1084
  {
696
1085
  "path": "ai-docs/templates/new-method/02-implementation.md",
697
- "scope": "reference",
698
- "role": "reference-only",
1086
+ "scope": "repo",
1087
+ "role": "superseded",
699
1088
  "canonical": false,
700
- "use_by_agents": "context-only",
701
- "notes": "Legacy package workflow template retained unchanged; not a product intent/design source for canonical SDD specs."
1089
+ "use_by_agents": "source-for-migration",
1090
+ "canonical_target": "AGENTS.md",
1091
+ "post_migration_action": "delete-after-validation",
1092
+ "deletion_status": "deleted",
1093
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
702
1094
  },
703
1095
  {
704
1096
  "path": "ai-docs/templates/new-method/03-tests.md",
705
- "scope": "reference",
706
- "role": "reference-only",
1097
+ "scope": "repo",
1098
+ "role": "superseded",
707
1099
  "canonical": false,
708
- "use_by_agents": "context-only",
709
- "notes": "Legacy package workflow template retained unchanged; not a product intent/design source for canonical SDD specs."
1100
+ "use_by_agents": "source-for-migration",
1101
+ "canonical_target": "AGENTS.md",
1102
+ "post_migration_action": "delete-after-validation",
1103
+ "deletion_status": "deleted",
1104
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
710
1105
  },
711
1106
  {
712
1107
  "path": "ai-docs/templates/new-method/04-validation.md",
713
- "scope": "reference",
714
- "role": "reference-only",
1108
+ "scope": "repo",
1109
+ "role": "superseded",
715
1110
  "canonical": false,
716
- "use_by_agents": "context-only",
717
- "notes": "Legacy package workflow template retained unchanged; not a product intent/design source for canonical SDD specs."
1111
+ "use_by_agents": "source-for-migration",
1112
+ "canonical_target": "AGENTS.md",
1113
+ "post_migration_action": "delete-after-validation",
1114
+ "deletion_status": "deleted",
1115
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
718
1116
  },
719
1117
  {
720
1118
  "path": "ai-docs/templates/new-service/00-master.md",
721
- "scope": "reference",
722
- "role": "reference-only",
1119
+ "scope": "repo",
1120
+ "role": "superseded",
723
1121
  "canonical": false,
724
- "use_by_agents": "context-only",
725
- "notes": "Legacy package workflow template retained unchanged; not a product intent/design source for canonical SDD specs."
1122
+ "use_by_agents": "source-for-migration",
1123
+ "canonical_target": "AGENTS.md",
1124
+ "post_migration_action": "delete-after-validation",
1125
+ "deletion_status": "deleted",
1126
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
726
1127
  },
727
1128
  {
728
1129
  "path": "ai-docs/templates/new-service/01-pre-questions.md",
729
- "scope": "reference",
730
- "role": "reference-only",
1130
+ "scope": "repo",
1131
+ "role": "superseded",
731
1132
  "canonical": false,
732
- "use_by_agents": "context-only",
733
- "notes": "Legacy package workflow template retained unchanged; not a product intent/design source for canonical SDD specs."
1133
+ "use_by_agents": "source-for-migration",
1134
+ "canonical_target": "AGENTS.md",
1135
+ "post_migration_action": "delete-after-validation",
1136
+ "deletion_status": "deleted",
1137
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
734
1138
  },
735
1139
  {
736
1140
  "path": "ai-docs/templates/new-service/02-code-generation.md",
737
- "scope": "reference",
738
- "role": "reference-only",
1141
+ "scope": "repo",
1142
+ "role": "superseded",
739
1143
  "canonical": false,
740
- "use_by_agents": "context-only",
741
- "notes": "Legacy package workflow template retained unchanged; not a product intent/design source for canonical SDD specs."
1144
+ "use_by_agents": "source-for-migration",
1145
+ "canonical_target": "AGENTS.md",
1146
+ "post_migration_action": "delete-after-validation",
1147
+ "deletion_status": "deleted",
1148
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
742
1149
  },
743
1150
  {
744
1151
  "path": "ai-docs/templates/new-service/03-integration.md",
745
- "scope": "reference",
746
- "role": "reference-only",
1152
+ "scope": "repo",
1153
+ "role": "superseded",
747
1154
  "canonical": false,
748
- "use_by_agents": "context-only",
749
- "notes": "Legacy package workflow template retained unchanged; not a product intent/design source for canonical SDD specs."
1155
+ "use_by_agents": "source-for-migration",
1156
+ "canonical_target": "AGENTS.md",
1157
+ "post_migration_action": "delete-after-validation",
1158
+ "deletion_status": "deleted",
1159
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
750
1160
  },
751
1161
  {
752
1162
  "path": "ai-docs/templates/new-service/04-test-generation.md",
753
- "scope": "reference",
754
- "role": "reference-only",
1163
+ "scope": "repo",
1164
+ "role": "superseded",
755
1165
  "canonical": false,
756
- "use_by_agents": "context-only",
757
- "notes": "Legacy package workflow template retained unchanged; not a product intent/design source for canonical SDD specs."
1166
+ "use_by_agents": "source-for-migration",
1167
+ "canonical_target": "AGENTS.md",
1168
+ "post_migration_action": "delete-after-validation",
1169
+ "deletion_status": "deleted",
1170
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
758
1171
  },
759
1172
  {
760
1173
  "path": "ai-docs/templates/new-service/05-validation.md",
761
- "scope": "reference",
762
- "role": "reference-only",
1174
+ "scope": "repo",
1175
+ "role": "superseded",
1176
+ "canonical": false,
1177
+ "use_by_agents": "source-for-migration",
1178
+ "canonical_target": "AGENTS.md",
1179
+ "post_migration_action": "delete-after-validation",
1180
+ "deletion_status": "deleted",
1181
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1182
+ },
1183
+ {
1184
+ "path": "src/metrics/ai-docs/AGENTS.md",
1185
+ "scope": "module",
1186
+ "module": "src/metrics",
1187
+ "role": "superseded",
1188
+ "canonical": false,
1189
+ "use_by_agents": "source-for-migration",
1190
+ "canonical_target": "src/metrics/docs/README.md",
1191
+ "post_migration_action": "delete-after-validation",
1192
+ "deletion_status": "deleted",
1193
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1194
+ },
1195
+ {
1196
+ "path": "src/metrics/ai-docs/ARCHITECTURE.md",
1197
+ "scope": "module",
1198
+ "module": "src/metrics",
1199
+ "role": "superseded",
1200
+ "canonical": false,
1201
+ "use_by_agents": "source-for-migration",
1202
+ "canonical_target": "src/metrics/docs/README.md",
1203
+ "post_migration_action": "delete-after-validation",
1204
+ "deletion_status": "deleted",
1205
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1206
+ },
1207
+ {
1208
+ "path": "src/metrics/ai-docs/metrics-spec.md",
1209
+ "scope": "module",
1210
+ "module": "src/metrics",
1211
+ "role": "superseded",
763
1212
  "canonical": false,
764
- "use_by_agents": "context-only",
765
- "notes": "Legacy package workflow template retained unchanged; not a product intent/design source for canonical SDD specs."
1213
+ "use_by_agents": "source-for-migration",
1214
+ "canonical_target": "src/metrics/docs/README.md",
1215
+ "post_migration_action": "delete-after-validation",
1216
+ "deletion_status": "deleted",
1217
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1218
+ },
1219
+ {
1220
+ "path": "src/services/ai-docs/AGENTS.md",
1221
+ "scope": "module",
1222
+ "module": "src/services",
1223
+ "role": "superseded",
1224
+ "canonical": false,
1225
+ "use_by_agents": "source-for-migration",
1226
+ "canonical_target": "src/services/docs/README.md",
1227
+ "post_migration_action": "delete-after-validation",
1228
+ "deletion_status": "deleted",
1229
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1230
+ },
1231
+ {
1232
+ "path": "src/services/ai-docs/services-spec.md",
1233
+ "scope": "module",
1234
+ "module": "src/services",
1235
+ "role": "superseded",
1236
+ "canonical": false,
1237
+ "use_by_agents": "source-for-migration",
1238
+ "canonical_target": "src/services/docs/README.md",
1239
+ "post_migration_action": "delete-after-validation",
1240
+ "deletion_status": "deleted",
1241
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1242
+ },
1243
+ {
1244
+ "path": "src/services/agent/ai-docs/AGENTS.md",
1245
+ "scope": "module",
1246
+ "module": "src/services/agent",
1247
+ "role": "superseded",
1248
+ "canonical": false,
1249
+ "use_by_agents": "source-for-migration",
1250
+ "canonical_target": "src/services/agent/docs/README.md",
1251
+ "post_migration_action": "delete-after-validation",
1252
+ "deletion_status": "deleted",
1253
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1254
+ },
1255
+ {
1256
+ "path": "src/services/agent/ai-docs/ARCHITECTURE.md",
1257
+ "scope": "module",
1258
+ "module": "src/services/agent",
1259
+ "role": "superseded",
1260
+ "canonical": false,
1261
+ "use_by_agents": "source-for-migration",
1262
+ "canonical_target": "src/services/agent/docs/README.md",
1263
+ "post_migration_action": "delete-after-validation",
1264
+ "deletion_status": "deleted",
1265
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1266
+ },
1267
+ {
1268
+ "path": "src/services/agent/ai-docs/agent-spec.md",
1269
+ "scope": "module",
1270
+ "module": "src/services/agent",
1271
+ "role": "superseded",
1272
+ "canonical": false,
1273
+ "use_by_agents": "source-for-migration",
1274
+ "canonical_target": "src/services/agent/docs/README.md",
1275
+ "post_migration_action": "delete-after-validation",
1276
+ "deletion_status": "deleted",
1277
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1278
+ },
1279
+ {
1280
+ "path": "src/services/config/ai-docs/AGENTS.md",
1281
+ "scope": "module",
1282
+ "module": "src/services/config",
1283
+ "role": "superseded",
1284
+ "canonical": false,
1285
+ "use_by_agents": "source-for-migration",
1286
+ "canonical_target": "src/services/config/docs/README.md",
1287
+ "post_migration_action": "delete-after-validation",
1288
+ "deletion_status": "deleted",
1289
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1290
+ },
1291
+ {
1292
+ "path": "src/services/config/ai-docs/ARCHITECTURE.md",
1293
+ "scope": "module",
1294
+ "module": "src/services/config",
1295
+ "role": "superseded",
1296
+ "canonical": false,
1297
+ "use_by_agents": "source-for-migration",
1298
+ "canonical_target": "src/services/config/docs/README.md",
1299
+ "post_migration_action": "delete-after-validation",
1300
+ "deletion_status": "deleted",
1301
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1302
+ },
1303
+ {
1304
+ "path": "src/services/config/ai-docs/config-spec.md",
1305
+ "scope": "module",
1306
+ "module": "src/services/config",
1307
+ "role": "superseded",
1308
+ "canonical": false,
1309
+ "use_by_agents": "source-for-migration",
1310
+ "canonical_target": "src/services/config/docs/README.md",
1311
+ "post_migration_action": "delete-after-validation",
1312
+ "deletion_status": "deleted",
1313
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1314
+ },
1315
+ {
1316
+ "path": "src/services/core/ai-docs/AGENTS.md",
1317
+ "scope": "module",
1318
+ "module": "src/services/core",
1319
+ "role": "superseded",
1320
+ "canonical": false,
1321
+ "use_by_agents": "source-for-migration",
1322
+ "canonical_target": "src/services/core/docs/README.md",
1323
+ "post_migration_action": "delete-after-validation",
1324
+ "deletion_status": "deleted",
1325
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1326
+ },
1327
+ {
1328
+ "path": "src/services/core/ai-docs/ARCHITECTURE.md",
1329
+ "scope": "module",
1330
+ "module": "src/services/core",
1331
+ "role": "superseded",
1332
+ "canonical": false,
1333
+ "use_by_agents": "source-for-migration",
1334
+ "canonical_target": "src/services/core/docs/README.md",
1335
+ "post_migration_action": "delete-after-validation",
1336
+ "deletion_status": "deleted",
1337
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1338
+ },
1339
+ {
1340
+ "path": "src/services/core/ai-docs/core-spec.md",
1341
+ "scope": "module",
1342
+ "module": "src/services/core",
1343
+ "role": "superseded",
1344
+ "canonical": false,
1345
+ "use_by_agents": "source-for-migration",
1346
+ "canonical_target": "src/services/core/docs/README.md",
1347
+ "post_migration_action": "delete-after-validation",
1348
+ "deletion_status": "deleted",
1349
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1350
+ },
1351
+ {
1352
+ "path": "src/services/task/ai-docs/AGENTS.md",
1353
+ "scope": "module",
1354
+ "module": "src/services/task",
1355
+ "role": "superseded",
1356
+ "canonical": false,
1357
+ "use_by_agents": "source-for-migration",
1358
+ "canonical_target": "src/services/task/docs/README.md",
1359
+ "post_migration_action": "delete-after-validation",
1360
+ "deletion_status": "deleted",
1361
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1362
+ },
1363
+ {
1364
+ "path": "src/services/task/ai-docs/ARCHITECTURE.md",
1365
+ "scope": "module",
1366
+ "module": "src/services/task",
1367
+ "role": "superseded",
1368
+ "canonical": false,
1369
+ "use_by_agents": "source-for-migration",
1370
+ "canonical_target": "src/services/task/docs/README.md",
1371
+ "post_migration_action": "delete-after-validation",
1372
+ "deletion_status": "deleted",
1373
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1374
+ },
1375
+ {
1376
+ "path": "src/services/task/ai-docs/task-spec.md",
1377
+ "scope": "module",
1378
+ "module": "src/services/task",
1379
+ "role": "superseded",
1380
+ "canonical": false,
1381
+ "use_by_agents": "source-for-migration",
1382
+ "canonical_target": "src/services/task/docs/README.md",
1383
+ "post_migration_action": "delete-after-validation",
1384
+ "deletion_status": "deleted",
1385
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1386
+ },
1387
+ {
1388
+ "path": "src/services/task/state-machine/ai-docs/AGENTS.md",
1389
+ "scope": "module",
1390
+ "module": "src/services/task/state-machine",
1391
+ "role": "superseded",
1392
+ "canonical": false,
1393
+ "use_by_agents": "source-for-migration",
1394
+ "canonical_target": "src/services/task/state-machine/docs/README.md",
1395
+ "post_migration_action": "delete-after-validation",
1396
+ "deletion_status": "deleted",
1397
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1398
+ },
1399
+ {
1400
+ "path": "src/services/task/state-machine/ai-docs/ARCHITECTURE.md",
1401
+ "scope": "module",
1402
+ "module": "src/services/task/state-machine",
1403
+ "role": "superseded",
1404
+ "canonical": false,
1405
+ "use_by_agents": "source-for-migration",
1406
+ "canonical_target": "src/services/task/state-machine/docs/README.md",
1407
+ "post_migration_action": "delete-after-validation",
1408
+ "deletion_status": "deleted",
1409
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1410
+ },
1411
+ {
1412
+ "path": "src/services/task/state-machine/ai-docs/task-state-machine-spec.md",
1413
+ "scope": "module",
1414
+ "module": "src/services/task/state-machine",
1415
+ "role": "superseded",
1416
+ "canonical": false,
1417
+ "use_by_agents": "source-for-migration",
1418
+ "canonical_target": "src/services/task/state-machine/docs/README.md",
1419
+ "post_migration_action": "delete-after-validation",
1420
+ "deletion_status": "deleted",
1421
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1422
+ },
1423
+ {
1424
+ "path": "src/utils/ai-docs/utils-spec.md",
1425
+ "scope": "module",
1426
+ "module": "src/utils",
1427
+ "role": "superseded",
1428
+ "canonical": false,
1429
+ "use_by_agents": "source-for-migration",
1430
+ "canonical_target": "src/utils/docs/README.md",
1431
+ "post_migration_action": "delete-after-validation",
1432
+ "deletion_status": "deleted",
1433
+ "notes": "Older Repo Annotation ai-docs output (brownfield-onboarding@0.1.6). Primary route only; per-unit routing, including units placed in other canonical documents, is authoritative in the source-fidelity inventories. Deleted 2026-11-16 in a separate commit after the owner reviewed the migration diff; recoverable from the parent commit."
1434
+ },
1435
+ {
1436
+ "path": "src/utils/AGENTS.md",
1437
+ "scope": "module",
1438
+ "module": "src/utils",
1439
+ "role": "source-material",
1440
+ "canonical": false,
1441
+ "use_by_agents": "source-for-migration",
1442
+ "canonical_target": "src/utils/docs/README.md",
1443
+ "post_migration_action": "retain",
1444
+ "deletion_status": "not-applicable",
1445
+ "notes": "Human-authored utils guide outside ai-docs. Its content is migrated into src/utils/docs/README.md; the file itself is retained because the approved deletion covers only ai-docs folders."
766
1446
  }
767
1447
  ],
768
1448
  "spec_policy": {
769
- "delta_grammar": {
770
- "added": "## ADDED Requirements",
771
- "modified": "## MODIFIED Requirements",
772
- "removed": "## REMOVED Requirements"
773
- },
774
1449
  "require_what_and_why": true,
775
1450
  "require_provenance": true,
776
1451
  "protected_specs": [
777
- "ai-docs/contact-center-spec.md",
778
- "src/metrics/ai-docs/metrics-spec.md",
779
- "src/services/ai-docs/services-spec.md",
780
- "src/services/agent/ai-docs/agent-spec.md",
781
- "src/services/config/ai-docs/config-spec.md",
782
- "src/services/core/ai-docs/core-spec.md",
783
- "src/services/task/ai-docs/task-spec.md",
784
- "src/services/task/state-machine/ai-docs/task-state-machine-spec.md",
785
- "src/utils/ai-docs/utils-spec.md",
786
- "AGENTS.md",
787
- "ai-docs/ARCHITECTURE.md",
788
- "ai-docs/RULES.md",
789
- "ai-docs/CONTRACTS.md",
790
- "ai-docs/SPEC_INDEX.md"
791
- ],
792
- "required_sections_by_change_class": {
793
- "core_always": [
794
- "Intent (WHAT)",
795
- "Rationale (WHY)",
796
- "Scope/Out-of-scope",
797
- "Acceptance criteria",
798
- "Contracts delta"
799
- ],
800
- "security_or_contract_or_perf_critical": [
801
- "Data",
802
- "Error Matrix",
803
- "Resilience",
804
- "Observability",
805
- "Operations"
806
- ]
807
- }
1452
+ "src/docs/README.md",
1453
+ "src/metrics/docs/README.md",
1454
+ "src/services/docs/README.md",
1455
+ "src/services/agent/docs/README.md",
1456
+ "src/services/config/docs/README.md",
1457
+ "src/services/core/docs/README.md",
1458
+ "src/services/task/docs/README.md",
1459
+ "src/services/task/state-machine/docs/README.md",
1460
+ "src/utils/docs/README.md"
1461
+ ]
808
1462
  },
809
1463
  "validation": {
810
- "generator_runtime": "codex",
811
- "validator_runtime": "claude-code",
812
- "must_differ": true,
1464
+ "generator_runtime": "claude-code",
1465
+ "generator_model": "claude-opus-5-5",
1466
+ "generator_runtime_source": "host-metadata",
1467
+ "generator_run_id": "cc-migration-20261116",
1468
+ "source_commit": "0b8c34db7f3768b8f5bfd219c73c205b95f8c551",
1469
+ "base_ref": "next",
1470
+ "minimum_independence": "different-runtime",
813
1471
  "blocking_severities": [
814
1472
  "Blocking"
815
1473
  ],
816
- "generator_run_id": "contact-center-bootstrap-20260707",
817
- "source_commit": "382831a838c34fb1520320654beaf12d4afdfacb",
818
- "runtime_family": "openai-codex"
1474
+ "validator_runtime": "01a1e76f-2293-79a0-9f8f-f060038448dd",
1475
+ "validator_runtime_source": "invocation-input",
1476
+ "runtime_fallback_tier": "different-runtime",
1477
+ "validator_run_id": "01a1e76f-2293-79a0-9f8f-f060038448dd"
819
1478
  },
820
1479
  "layout": {
821
1480
  "sdd_root": ".sdd",
822
- "docs_root": "ai-docs",
1481
+ "docs_root": "docs",
823
1482
  "agent_entry_path": "AGENTS.md",
824
- "standing_docs_root": "ai-docs",
825
- "spec_index_path": "ai-docs/SPEC_INDEX.md",
1483
+ "standing_docs_root": "docs",
1484
+ "spec_index_path": "docs/specs/README.md",
826
1485
  "module_docs_strategy": "source-local",
827
- "module_docs_folder_name": "ai-docs",
1486
+ "module_docs_relative_path": "docs/README.md",
1487
+ "module_docs_decision": {
1488
+ "basis": "repo-standards-default",
1489
+ "reason": "The nine modules confirmed in the 2026-07-07 onboarding keep their paths. Their older source-local ai-docs specs move to the repo-standards default <module>/docs/README.md. test:style lints only src/**/*.ts and build:src compiles only -js -ts, so Markdown under src/ does not reach lint or dist.",
1490
+ "decided_by": "rarajes2@cisco.com (migration plan approval)",
1491
+ "decided_at": "2026-11-16T13:49:22Z"
1492
+ },
1493
+ "repo_context_decision": {
1494
+ "path": ".repo-context.json",
1495
+ "schema_path": "schemas/repo-context.schema.json",
1496
+ "action": "create",
1497
+ "schema_action": "create",
1498
+ "reason": "Neither the operational context nor its schema existed in this package. The context is created from package evidence and the migrated glossary; the schema is copied from the repository-root .sdd/templates/repo-standards/schemas/repo-context.schema.json.",
1499
+ "decided_by": "rarajes2@cisco.com (migration plan approval)",
1500
+ "decided_at": "2026-11-16T13:49:22Z"
1501
+ },
1502
+ "artifact_decisions": [
1503
+ {
1504
+ "path": "docs/service.md",
1505
+ "action": "omit",
1506
+ "reason": "Library package, not a deployable service. package.json has no start script, container, or deployment descriptor.",
1507
+ "decided_by": "claude-code (code evidence)",
1508
+ "decided_at": "2026-11-16T13:49:22Z"
1509
+ },
1510
+ {
1511
+ "path": "mkdocs.yml",
1512
+ "action": "omit",
1513
+ "reason": "No package-level documentation site exists. build:docs writes typedoc output to the workspace docs/wxcc folder.",
1514
+ "decided_by": "claude-code (code evidence)",
1515
+ "decided_at": "2026-11-16T13:49:22Z"
1516
+ },
1517
+ {
1518
+ "path": "api-specs/openapi.yaml",
1519
+ "action": "omit",
1520
+ "reason": "The package serves no HTTP routes. It consumes the Contact Center API gateway (wxcc-api-gateway, external); its published surface is the npm export described by contact-center-sdk.",
1521
+ "decided_by": "claude-code (code evidence)",
1522
+ "decided_at": "2026-11-16T13:49:22Z"
1523
+ },
1524
+ {
1525
+ "path": "SECURITY.md",
1526
+ "action": "omit",
1527
+ "reason": "Security policy is owned at the webex-js-sdk repository root; security architecture is described in docs/architecture.md.",
1528
+ "decided_by": "claude-code (code evidence)",
1529
+ "decided_at": "2026-11-16T13:49:22Z"
1530
+ },
1531
+ {
1532
+ "path": "CONTRIBUTING.md",
1533
+ "action": "omit",
1534
+ "reason": "Contribution guidance is owned at the webex-js-sdk repository root.",
1535
+ "decided_by": "claude-code (code evidence)",
1536
+ "decided_at": "2026-11-16T13:49:22Z"
1537
+ },
1538
+ {
1539
+ "path": "CHANGELOG.md",
1540
+ "action": "omit",
1541
+ "reason": "The monorepo generates changelogs centrally through its release tooling.",
1542
+ "decided_by": "claude-code (code evidence)",
1543
+ "decided_at": "2026-11-16T13:49:22Z"
1544
+ },
1545
+ {
1546
+ "path": "CTO_CHECKLIST.yml",
1547
+ "action": "omit",
1548
+ "reason": "No CTO checklist process applies to this package.",
1549
+ "decided_by": "claude-code (code evidence)",
1550
+ "decided_at": "2026-11-16T13:49:22Z"
1551
+ },
1552
+ {
1553
+ "path": "schemas/cto-checklist.schema.json",
1554
+ "action": "omit",
1555
+ "reason": "Omitted with CTO_CHECKLIST.yml.",
1556
+ "decided_by": "claude-code (code evidence)",
1557
+ "decided_at": "2026-11-16T13:49:22Z"
1558
+ }
1559
+ ],
828
1560
  "template_roots": {
829
- "canonical": "../../../.sdd/templates",
830
- "extensions": [
831
- "../../../.sdd/templates/extensions"
832
- ],
833
- "legacy_compat": "ai-docs/templates"
834
- },
835
- "repo_skills_root": "../../../.agents/skills",
836
- "runtime_skill_entrypoints": {
837
- "codex": "../../../.agents/skills",
838
- "cursor": "../../../.cursor/skills"
839
- },
840
- "contracts_strategy": "root-index-module-detail"
1561
+ "canonical": ".sdd/templates/repo-standards"
1562
+ },
1563
+ "contract_index_path": "docs/architecture.md",
1564
+ "repo_skills_root": ".sdd/skills",
1565
+ "monorepo_package": {
1566
+ "package_path": "packages/@webex/contact-center",
1567
+ "root_manifest_path": "../../../.sdd/manifest.json",
1568
+ "templates_root_path": "../../../.sdd/templates/repo-standards"
1569
+ }
841
1570
  },
842
1571
  "tooling": {
843
1572
  "sdlc_skills": {
844
- "source_repo": "repo-installed SDLC skills",
845
- "source_ref": "brownfield-onboarding@0.1.6+codex.20260706172001",
846
- "install_mode": "copy",
847
- "installed_at": "2026-07-06T17:20:01Z",
848
- "plugins": [
849
- "brownfield-onboarding@0.1.6+codex.20260706172001",
850
- "sdlc-lifecycle@0.1.1+codex.20260630150003"
851
- ]
1573
+ "source_ref": "repo-annotation@2.3.1"
852
1574
  }
853
1575
  },
854
1576
  "coverage_ratchet": {
@@ -856,13 +1578,16 @@
856
1578
  "waivers": []
857
1579
  },
858
1580
  "substrate": {
859
- "source": "webex-js-sdk repository standards",
1581
+ "source": "WebexTools/repo-standards@d89a7fe59126ae3ad9bac9ca352aa7f12b4c85dc",
860
1582
  "consumed": [
861
- "root lint/format configs (.eslintrc.js, .prettierrc, .editorconfig)",
862
- "standard files (README.md, CONTRIBUTING.md, .github/CODEOWNERS)",
863
- "workspace build/test tooling"
1583
+ "the workspace root ../../../.eslintrc.js (airbnb-base plus eslintrules), which test:style resolves; the package has no .eslintrc.js of its own",
1584
+ "@webex/babel-config-legacy via babel.config.js",
1585
+ "@webex/jest-config-legacy via jest.config.js",
1586
+ "@webex/legacy-tools build and test runner via package.json",
1587
+ "workspace tsconfig.json via the package tsconfig.json",
1588
+ "Repo Standards templates at the monorepo root .sdd/templates/repo-standards, referred to through layout.monorepo_package.templates_root_path (this package holds no templates)"
864
1589
  ],
865
- "compliance_tier": "legacy"
1590
+ "compliance_tier": "baseline"
866
1591
  },
867
1592
  "section_profiles": {
868
1593
  "repo": {
@@ -872,16 +1597,17 @@
872
1597
  "domain_data_across_components": true,
873
1598
  "caches_data": true,
874
1599
  "observability_convention": true,
875
- "deploys_to_infra": true,
1600
+ "deploys_to_infra": false,
876
1601
  "shared_base_libs": true,
877
- "is_monorepo": true,
1602
+ "is_monorepo": false,
878
1603
  "multi_platform": false,
879
1604
  "published_package": true,
880
1605
  "embedded_in_host": true,
881
1606
  "cross_repo_deps_material": true,
882
- "security_arch_warranted": true
1607
+ "security_arch_warranted": true,
1608
+ "exposes_commands_or_artifacts": true
883
1609
  },
884
- "resolved_by": "Codex generator with user-confirmed scope/module boundaries",
885
- "resolved_at": "2026-07-07T13:41:40Z"
1610
+ "resolved_by": "claude-code/claude-opus-5-5 (carried from the 2026-07-07 user-confirmed profile; exposes_commands_or_artifacts from package.json scripts; is_monorepo and deploys_to_infra corrected to false: the SDD root is one package, and deploy:npm publishes a library with no infrastructure)",
1611
+ "resolved_at": "2026-11-16T13:49:22Z"
886
1612
  }
887
1613
  }