@webex/contact-center 3.12.0 → 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.
- package/.repo-context.json +704 -0
- package/.sdd/manifest.json +1613 -0
- package/AGENTS.md +969 -0
- package/dist/cc.js +1102 -47
- package/dist/cc.js.map +1 -1
- package/dist/config.js +13 -0
- package/dist/config.js.map +1 -1
- package/dist/constants.js +46 -3
- package/dist/constants.js.map +1 -1
- package/dist/index.js +86 -17
- package/dist/index.js.map +1 -1
- package/dist/metrics/MetricsManager.js +16 -0
- package/dist/metrics/MetricsManager.js.map +1 -1
- package/dist/metrics/behavioral-events.js +211 -0
- package/dist/metrics/behavioral-events.js.map +1 -1
- package/dist/metrics/constants.js +58 -4
- package/dist/metrics/constants.js.map +1 -1
- package/dist/services/AddressBook.js +18 -15
- package/dist/services/AddressBook.js.map +1 -1
- package/dist/services/AnswerCallOnWebexService.js +202 -0
- package/dist/services/AnswerCallOnWebexService.js.map +1 -0
- package/dist/services/ApiAiAssistant.js +369 -14
- package/dist/services/ApiAiAssistant.js.map +1 -1
- package/dist/services/EntryPoint.js +46 -68
- package/dist/services/EntryPoint.js.map +1 -1
- package/dist/services/Queue.js +27 -22
- package/dist/services/Queue.js.map +1 -1
- package/dist/services/UserPreference.js +427 -0
- package/dist/services/UserPreference.js.map +1 -0
- package/dist/services/WebCallingService.js +287 -37
- package/dist/services/WebCallingService.js.map +1 -1
- package/dist/services/WebexCrossClientService.js +225 -0
- package/dist/services/WebexCrossClientService.js.map +1 -0
- package/dist/services/WxAppTelephonyMercurySync.js +111 -0
- package/dist/services/WxAppTelephonyMercurySync.js.map +1 -0
- package/dist/services/config/Util.js +48 -48
- package/dist/services/config/Util.js.map +1 -1
- package/dist/services/config/constants.js +57 -79
- package/dist/services/config/constants.js.map +1 -1
- package/dist/services/config/index.js +100 -226
- package/dist/services/config/index.js.map +1 -1
- package/dist/services/config/types.js +100 -40
- package/dist/services/config/types.js.map +1 -1
- package/dist/services/constants.js +19 -1
- package/dist/services/constants.js.map +1 -1
- package/dist/services/core/Err.js.map +1 -1
- package/dist/services/core/Utils.js +131 -32
- package/dist/services/core/Utils.js.map +1 -1
- package/dist/services/core/WebexRequest.js +6 -2
- package/dist/services/core/WebexRequest.js.map +1 -1
- package/dist/services/core/aqm-reqs.js +17 -11
- package/dist/services/core/aqm-reqs.js.map +1 -1
- package/dist/services/core/constants.js +9 -1
- package/dist/services/core/constants.js.map +1 -1
- package/dist/services/core/types.js.map +1 -1
- package/dist/services/core/websocket/WebSocketManager.js +26 -6
- package/dist/services/core/websocket/WebSocketManager.js.map +1 -1
- package/dist/services/core/websocket/connection-service.js +3 -1
- package/dist/services/core/websocket/connection-service.js.map +1 -1
- package/dist/services/core/websocket/types.js.map +1 -1
- package/dist/services/index.js +6 -0
- package/dist/services/index.js.map +1 -1
- package/dist/services/task/Task.js +955 -0
- package/dist/services/task/Task.js.map +1 -0
- package/dist/services/task/TaskFactory.js +50 -0
- package/dist/services/task/TaskFactory.js.map +1 -0
- package/dist/services/task/TaskManager.js +1275 -504
- package/dist/services/task/TaskManager.js.map +1 -1
- package/dist/services/task/TaskUtils.js +221 -27
- package/dist/services/task/TaskUtils.js.map +1 -1
- package/dist/services/task/WebexCallingUtils.js +70 -0
- package/dist/services/task/WebexCallingUtils.js.map +1 -0
- package/dist/services/task/constants.js +22 -2
- package/dist/services/task/constants.js.map +1 -1
- package/dist/services/task/contact.js +29 -0
- package/dist/services/task/contact.js.map +1 -1
- package/dist/services/task/dialer.js +78 -0
- package/dist/services/task/dialer.js.map +1 -1
- package/dist/services/task/digital/Digital.js +78 -0
- package/dist/services/task/digital/Digital.js.map +1 -0
- package/dist/services/task/state-machine/TaskStateMachine.js +982 -0
- package/dist/services/task/state-machine/TaskStateMachine.js.map +1 -0
- package/dist/services/task/state-machine/actions.js +572 -0
- package/dist/services/task/state-machine/actions.js.map +1 -0
- package/dist/services/task/state-machine/constants.js +161 -0
- package/dist/services/task/state-machine/constants.js.map +1 -0
- package/dist/services/task/state-machine/guards.js +379 -0
- package/dist/services/task/state-machine/guards.js.map +1 -0
- package/dist/services/task/state-machine/index.js +53 -0
- package/dist/services/task/state-machine/index.js.map +1 -0
- package/dist/services/task/state-machine/types.js +54 -0
- package/dist/services/task/state-machine/types.js.map +1 -0
- package/dist/services/task/state-machine/uiControlsComputer.js +703 -0
- package/dist/services/task/state-machine/uiControlsComputer.js.map +1 -0
- package/dist/services/task/taskDataNormalizer.js +99 -0
- package/dist/services/task/taskDataNormalizer.js.map +1 -0
- package/dist/services/task/types.js +259 -5
- package/dist/services/task/types.js.map +1 -1
- package/dist/services/task/voice/Voice.js +1504 -0
- package/dist/services/task/voice/Voice.js.map +1 -0
- package/dist/services/task/voice/WebRTC.js +152 -0
- package/dist/services/task/voice/WebRTC.js.map +1 -0
- package/dist/services/task/voice/wxAppOfferObservability.js +145 -0
- package/dist/services/task/voice/wxAppOfferObservability.js.map +1 -0
- package/dist/services/task/voice/wxAppVoiceMethods.js +395 -0
- package/dist/services/task/voice/wxAppVoiceMethods.js.map +1 -0
- package/dist/services/wxAppDiagnosticLogging.js +159 -0
- package/dist/services/wxAppDiagnosticLogging.js.map +1 -0
- package/dist/services/wxAppTelephonyUtils.js +19 -0
- package/dist/services/wxAppTelephonyUtils.js.map +1 -0
- package/dist/types/cc.d.ts +222 -10
- package/dist/types/config.d.ts +13 -0
- package/dist/types/constants.d.ts +40 -1
- package/dist/types/index.d.ts +58 -22
- package/dist/types/metrics/MetricsManager.d.ts +6 -0
- package/dist/types/metrics/constants.d.ts +52 -1
- package/dist/types/services/AddressBook.d.ts +2 -1
- package/dist/types/services/AnswerCallOnWebexService.d.ts +38 -0
- package/dist/types/services/ApiAiAssistant.d.ts +67 -5
- package/dist/types/services/EntryPoint.d.ts +7 -5
- package/dist/types/services/Queue.d.ts +5 -3
- package/dist/types/services/UserPreference.d.ts +118 -0
- package/dist/types/services/WebexCrossClientService.d.ts +32 -0
- package/dist/types/services/WxAppTelephonyMercurySync.d.ts +28 -0
- package/dist/types/services/config/Util.d.ts +4 -8
- package/dist/types/services/config/constants.d.ts +49 -76
- package/dist/types/services/config/index.d.ts +16 -64
- package/dist/types/services/config/types.d.ts +252 -114
- package/dist/types/services/constants.d.ts +16 -0
- package/dist/types/services/core/Err.d.ts +6 -0
- package/dist/types/services/core/Utils.d.ts +43 -13
- package/dist/types/services/core/WebexRequest.d.ts +1 -0
- package/dist/types/services/core/constants.d.ts +7 -0
- package/dist/types/services/core/types.d.ts +2 -0
- package/dist/types/services/core/websocket/WebSocketManager.d.ts +2 -0
- package/dist/types/services/core/websocket/types.d.ts +1 -1
- package/dist/types/services/index.d.ts +2 -0
- package/dist/types/services/task/Task.d.ts +186 -0
- package/dist/types/services/task/TaskFactory.d.ts +14 -0
- package/dist/types/services/task/TaskUtils.d.ts +54 -2
- package/dist/types/services/task/WebexCallingUtils.d.ts +11 -0
- package/dist/types/services/task/constants.d.ts +20 -0
- package/dist/types/services/task/contact.d.ts +4 -0
- package/dist/types/services/task/dialer.d.ts +30 -0
- package/dist/types/services/task/digital/Digital.d.ts +23 -0
- package/dist/types/services/task/state-machine/TaskStateMachine.d.ts +1442 -0
- package/dist/types/services/task/state-machine/actions.d.ts +10 -0
- package/dist/types/services/task/state-machine/constants.d.ts +107 -0
- package/dist/types/services/task/state-machine/guards.d.ts +103 -0
- package/dist/types/services/task/state-machine/index.d.ts +13 -0
- package/dist/types/services/task/state-machine/types.d.ts +277 -0
- package/dist/types/services/task/state-machine/uiControlsComputer.d.ts +9 -0
- package/dist/types/services/task/taskDataNormalizer.d.ts +10 -0
- package/dist/types/services/task/types.d.ts +790 -66
- package/dist/types/services/task/voice/Voice.d.ts +241 -0
- package/dist/types/services/task/voice/WebRTC.d.ts +54 -0
- package/dist/types/services/task/voice/wxAppOfferObservability.d.ts +39 -0
- package/dist/types/services/task/voice/wxAppVoiceMethods.d.ts +68 -0
- package/dist/types/services/wxAppDiagnosticLogging.d.ts +63 -0
- package/dist/types/services/wxAppTelephonyUtils.d.ts +5 -0
- package/dist/types/types.d.ts +258 -11
- package/dist/types/utils/PageCache.d.ts +20 -3
- package/dist/types/webex.d.ts +1 -0
- package/dist/types.js +204 -6
- package/dist/types.js.map +1 -1
- package/dist/utils/PageCache.js +19 -5
- package/dist/utils/PageCache.js.map +1 -1
- package/dist/webex.js +22 -2
- package/dist/webex.js.map +1 -1
- package/docs/adr/0001-spec-source-policy.md +97 -0
- package/docs/adr/0002-consult-transfer-list-policy.md +345 -0
- package/docs/adr/0003-repo-standards-migration.md +104 -0
- package/docs/adr/index.md +35 -0
- package/docs/architecture.md +460 -0
- package/docs/getting-started.md +142 -0
- package/docs/index.md +53 -0
- package/docs/specs/README.md +98 -0
- package/package.json +17 -12
- package/schemas/repo-context.schema.json +796 -0
- package/src/cc.ts +1439 -105
- package/src/config.ts +13 -0
- package/src/constants.ts +53 -1
- package/src/docs/README.md +727 -0
- package/src/index.ts +72 -16
- package/src/metrics/MetricsManager.ts +16 -0
- package/src/metrics/behavioral-events.ts +218 -0
- package/src/metrics/constants.ts +63 -4
- package/src/metrics/docs/README.md +710 -0
- package/src/services/AddressBook.ts +17 -6
- package/src/services/AnswerCallOnWebexService.ts +239 -0
- package/src/services/ApiAiAssistant.ts +494 -15
- package/src/services/EntryPoint.ts +59 -60
- package/src/services/Queue.ts +29 -12
- package/src/services/UserPreference.ts +509 -0
- package/src/services/WebCallingService.ts +362 -40
- package/src/services/WebexCrossClientService.ts +298 -0
- package/src/services/WxAppTelephonyMercurySync.ts +142 -0
- package/src/services/agent/docs/README.md +673 -0
- package/src/services/config/Util.ts +54 -84
- package/src/services/config/constants.ts +64 -86
- package/src/services/config/docs/README.md +530 -0
- package/src/services/config/index.ts +116 -277
- package/src/services/config/types.ts +238 -125
- package/src/services/constants.ts +18 -0
- package/src/services/core/Err.ts +3 -0
- package/src/services/core/Utils.ts +151 -37
- package/src/services/core/WebexRequest.ts +3 -1
- package/src/services/core/aqm-reqs.ts +18 -12
- package/src/services/core/constants.ts +8 -0
- package/src/services/core/docs/README.md +993 -0
- package/src/services/core/types.ts +33 -1
- package/src/services/core/websocket/WebSocketManager.ts +37 -8
- package/src/services/core/websocket/connection-service.ts +5 -1
- package/src/services/core/websocket/types.ts +1 -1
- package/src/services/docs/README.md +765 -0
- package/src/services/index.ts +4 -0
- package/src/services/task/Task.ts +1211 -0
- package/src/services/task/TaskFactory.ts +82 -0
- package/src/services/task/TaskManager.ts +1551 -584
- package/src/services/task/TaskUtils.ts +316 -25
- package/src/services/task/WebexCallingUtils.ts +136 -0
- package/src/services/task/constants.ts +21 -0
- package/src/services/task/contact.ts +30 -0
- package/src/services/task/dialer.ts +80 -0
- package/src/services/task/digital/Digital.ts +102 -0
- package/src/services/task/docs/README.md +1569 -0
- package/src/services/task/state-machine/TaskStateMachine.ts +1320 -0
- package/src/services/task/state-machine/actions.ts +741 -0
- package/src/services/task/state-machine/constants.ts +172 -0
- package/src/services/task/state-machine/docs/README.md +1388 -0
- package/src/services/task/state-machine/guards.ts +442 -0
- package/src/services/task/state-machine/index.ts +28 -0
- package/src/services/task/state-machine/types.ts +258 -0
- package/src/services/task/state-machine/uiControlsComputer.ts +1135 -0
- package/src/services/task/taskDataNormalizer.ts +137 -0
- package/src/services/task/types.ts +974 -70
- package/src/services/task/voice/Voice.ts +1878 -0
- package/src/services/task/voice/WebRTC.ts +194 -0
- package/src/services/task/voice/wxAppOfferObservability.ts +204 -0
- package/src/services/task/voice/wxAppVoiceMethods.ts +575 -0
- package/src/services/wxAppDiagnosticLogging.ts +286 -0
- package/src/services/wxAppTelephonyUtils.ts +14 -0
- package/src/types.ts +323 -13
- package/src/utils/AGENTS.md +291 -0
- package/src/utils/PageCache.ts +38 -5
- package/src/utils/docs/README.md +413 -0
- package/src/webex.js +10 -0
- package/test/unit/fixtures/aiSummaryTestUtils.ts +40 -0
- package/test/unit/spec/cc.ts +4046 -181
- package/test/unit/spec/index.ts +891 -0
- package/test/unit/spec/logger-proxy.ts +70 -0
- package/test/unit/spec/metrics/MetricsManager.ts +25 -0
- package/test/unit/spec/metrics/behavioral-events.ts +60 -0
- package/test/unit/spec/services/AddressBook.ts +37 -6
- package/test/unit/spec/services/AnswerCallOnWebexService.ts +264 -0
- package/test/unit/spec/services/ApiAiAssistant.ts +442 -23
- package/test/unit/spec/services/EntryPoint.ts +87 -40
- package/test/unit/spec/services/Queue.ts +123 -12
- package/test/unit/spec/services/UserPreference.ts +401 -0
- package/test/unit/spec/services/WebCallingService.ts +484 -49
- package/test/unit/spec/services/WebexCrossClientService.ts +509 -0
- package/test/unit/spec/services/WxAppTelephonyMercurySync.ts +136 -0
- package/test/unit/spec/services/config/Util.ts +501 -0
- package/test/unit/spec/services/config/index.ts +318 -548
- package/test/unit/spec/services/core/Utils.ts +447 -8
- package/test/unit/spec/services/core/WebexRequest.ts +8 -7
- package/test/unit/spec/services/core/aqm-reqs.ts +142 -1
- package/test/unit/spec/services/core/websocket/WebSocketManager.ts +132 -56
- package/test/unit/spec/services/core/websocket/connection-service.ts +3 -1
- package/test/unit/spec/services/task/AutoWrapup.ts +63 -0
- package/test/unit/spec/services/task/Task.ts +2723 -0
- package/test/unit/spec/services/task/TaskFactory.ts +116 -0
- package/test/unit/spec/services/task/TaskManager.ts +4800 -1586
- package/test/unit/spec/services/task/TaskUtils.ts +307 -0
- package/test/unit/spec/services/task/WebexCallingUtils.ts +153 -0
- package/test/unit/spec/services/task/contact.ts +33 -0
- package/test/unit/spec/services/task/dialer.ts +190 -0
- package/test/unit/spec/services/task/digital/Digital.ts +105 -0
- package/test/unit/spec/services/task/state-machine/TaskStateMachine.ts +4060 -0
- package/test/unit/spec/services/task/state-machine/guards.ts +839 -0
- package/test/unit/spec/services/task/state-machine/types.ts +18 -0
- package/test/unit/spec/services/task/state-machine/uiControlsComputer.ts +3101 -0
- package/test/unit/spec/services/task/taskTestUtils.ts +87 -0
- package/test/unit/spec/services/task/voice/Voice.ts +2355 -0
- package/test/unit/spec/services/task/voice/WebRTC.ts +235 -0
- package/test/unit/spec/services/task/voice/wxAppOfferObservability.ts +361 -0
- package/test/unit/spec/services/task/voice/wxAppVoiceMethods.ts +719 -0
- package/test/unit/spec/services/wxAppDiagnosticLogging.ts +179 -0
- package/test/unit/spec/wellnessSampleUtils.ts +288 -0
- package/typedoc.md +1 -1
- package/umd/contact-center.min.js +2 -2
- package/umd/contact-center.min.js.map +1 -1
- package/dist/services/task/index.js +0 -1525
- package/dist/services/task/index.js.map +0 -1
- package/dist/types/services/task/index.d.ts +0 -650
- package/src/services/task/index.ts +0 -1801
- package/test/unit/spec/services/task/index.ts +0 -2184
|
@@ -0,0 +1,704 @@
|
|
|
1
|
+
{
|
|
2
|
+
"$schema": "./schemas/repo-context.schema.json",
|
|
3
|
+
"version": 1,
|
|
4
|
+
"repository": {
|
|
5
|
+
"name": "@webex/contact-center",
|
|
6
|
+
"purpose": "A Webex SDK plugin package that exposes Contact Center agent, task, calling, configuration, realtime event, and telemetry APIs."
|
|
7
|
+
},
|
|
8
|
+
"commands": {
|
|
9
|
+
"install": "yarn",
|
|
10
|
+
"compile": "yarn workspace @webex/contact-center compile",
|
|
11
|
+
"build": "yarn workspace @webex/contact-center build:src",
|
|
12
|
+
"types": "yarn workspace @webex/contact-center build",
|
|
13
|
+
"unit-test": "yarn workspace @webex/contact-center test:unit",
|
|
14
|
+
"lint": "yarn workspace @webex/contact-center test:style",
|
|
15
|
+
"test-all": "yarn workspace @webex/contact-center test",
|
|
16
|
+
"e2e": "yarn workspace @webex/contact-center test:e2e",
|
|
17
|
+
"fix-lint": "yarn workspace @webex/contact-center fix:lint",
|
|
18
|
+
"fix-prettier": "yarn workspace @webex/contact-center fix:prettier",
|
|
19
|
+
"docs-build": "yarn workspace @webex/contact-center build:docs",
|
|
20
|
+
"deploy": "yarn workspace @webex/contact-center deploy:npm"
|
|
21
|
+
},
|
|
22
|
+
"task_playbooks": [
|
|
23
|
+
{
|
|
24
|
+
"task": "change-public-api-or-event",
|
|
25
|
+
"reference": "docs/architecture.md",
|
|
26
|
+
"when_to_use": "Adding, renaming, or changing an export of src/index.ts, a public ContactCenter or Task method, or an event enum value.",
|
|
27
|
+
"start_with": [
|
|
28
|
+
"docs/architecture.md",
|
|
29
|
+
"src/docs/README.md"
|
|
30
|
+
],
|
|
31
|
+
"evidence_required": [
|
|
32
|
+
"src/index.ts",
|
|
33
|
+
"the owning source file and its test under test/unit/spec"
|
|
34
|
+
],
|
|
35
|
+
"allowed_edits": [
|
|
36
|
+
"src",
|
|
37
|
+
"test/unit/spec",
|
|
38
|
+
"the owning module docs/README.md",
|
|
39
|
+
"docs/architecture.md",
|
|
40
|
+
".sdd/manifest.json contract_catalog"
|
|
41
|
+
],
|
|
42
|
+
"refresh_with": [
|
|
43
|
+
"yarn workspace @webex/contact-center build"
|
|
44
|
+
],
|
|
45
|
+
"validate_with": [
|
|
46
|
+
"yarn workspace @webex/contact-center test:unit",
|
|
47
|
+
"yarn workspace @webex/contact-center test:style"
|
|
48
|
+
],
|
|
49
|
+
"fallback": "If the change removes, renames, or reinterprets a published symbol, stop: it is a breaking change that needs a major version and consumer notes."
|
|
50
|
+
},
|
|
51
|
+
{
|
|
52
|
+
"task": "change-task-lifecycle",
|
|
53
|
+
"reference": "src/services/task/state-machine/docs/README.md",
|
|
54
|
+
"when_to_use": "Changing task states, transitions, guards, actions, or UI controls.",
|
|
55
|
+
"start_with": [
|
|
56
|
+
"src/services/task/docs/README.md",
|
|
57
|
+
"src/services/task/state-machine/docs/README.md"
|
|
58
|
+
],
|
|
59
|
+
"evidence_required": [
|
|
60
|
+
"src/services/task/state-machine/TaskStateMachine.ts",
|
|
61
|
+
"test/unit/spec/services/task/state-machine/TaskStateMachine.ts"
|
|
62
|
+
],
|
|
63
|
+
"allowed_edits": [
|
|
64
|
+
"src/services/task",
|
|
65
|
+
"test/unit/spec/services/task"
|
|
66
|
+
],
|
|
67
|
+
"refresh_with": [
|
|
68
|
+
"yarn workspace @webex/contact-center build:src"
|
|
69
|
+
],
|
|
70
|
+
"validate_with": [
|
|
71
|
+
"yarn workspace @webex/contact-center test:unit",
|
|
72
|
+
"yarn workspace @webex/contact-center test:style"
|
|
73
|
+
],
|
|
74
|
+
"fallback": "If the backend event that drives the transition cannot be confirmed in src/services/config/types.ts, do not add the transition; report the gap."
|
|
75
|
+
},
|
|
76
|
+
{
|
|
77
|
+
"task": "change-transport-or-recovery",
|
|
78
|
+
"reference": "src/services/core/docs/README.md",
|
|
79
|
+
"when_to_use": "Changing AqmReqs correlation, WebSocket connection, keepalive, reconnect, or silent relogin.",
|
|
80
|
+
"start_with": [
|
|
81
|
+
"src/services/core/docs/README.md",
|
|
82
|
+
"docs/architecture.md"
|
|
83
|
+
],
|
|
84
|
+
"evidence_required": [
|
|
85
|
+
"src/services/core/aqm-reqs.ts",
|
|
86
|
+
"src/services/core/websocket/connection-service.ts",
|
|
87
|
+
"src/cc.ts"
|
|
88
|
+
],
|
|
89
|
+
"allowed_edits": [
|
|
90
|
+
"src/services/core",
|
|
91
|
+
"src/cc.ts",
|
|
92
|
+
"test/unit/spec/services/core",
|
|
93
|
+
"test/unit/spec/cc.ts"
|
|
94
|
+
],
|
|
95
|
+
"refresh_with": [
|
|
96
|
+
"yarn workspace @webex/contact-center build:src"
|
|
97
|
+
],
|
|
98
|
+
"validate_with": [
|
|
99
|
+
"yarn workspace @webex/contact-center test:unit",
|
|
100
|
+
"yarn workspace @webex/contact-center test:style"
|
|
101
|
+
],
|
|
102
|
+
"fallback": "Keep the timeout constants in src/services/core/constants.ts unless the backend contract change is confirmed."
|
|
103
|
+
}
|
|
104
|
+
],
|
|
105
|
+
"public_interfaces": [
|
|
106
|
+
{
|
|
107
|
+
"name": "@webex/contact-center package main",
|
|
108
|
+
"kind": "package_export",
|
|
109
|
+
"source": "package.json",
|
|
110
|
+
"entrypoints": [
|
|
111
|
+
"import Webex from '@webex/contact-center'",
|
|
112
|
+
"Webex.init(attrs)"
|
|
113
|
+
],
|
|
114
|
+
"audience": "applications that use only the Contact Center plugin",
|
|
115
|
+
"notes": "main and exports['.'] load dist/webex.js, built from src/webex.js: a WebexCore constructor with authorization, mercury, logger, support, and the cc plugin; Webex.init merges src/webex-config.ts with attrs.config. types is dist/types/index.d.ts built from src/index.ts."
|
|
116
|
+
},
|
|
117
|
+
{
|
|
118
|
+
"name": "cc plugin registration and typed exports",
|
|
119
|
+
"kind": "package_export",
|
|
120
|
+
"source": "src/index.ts",
|
|
121
|
+
"entrypoints": [
|
|
122
|
+
"webex.cc",
|
|
123
|
+
"import {ContactCenter, routingAgent, Task, AddressBook, ApiAIAssistant, UserPreference, getDefaultUIControls, TASK_EVENTS, AGENT_EVENTS, CC_EVENTS} from '@webex/contact-center'"
|
|
124
|
+
],
|
|
125
|
+
"audience": "applications and SDK bundles",
|
|
126
|
+
"notes": "registerPlugin('cc', ContactCenter, {config}); defaults in src/config.ts. Contract index: docs/architecture.md Public and consumer surfaces."
|
|
127
|
+
},
|
|
128
|
+
{
|
|
129
|
+
"name": "package scripts",
|
|
130
|
+
"kind": "npm_scripts",
|
|
131
|
+
"source": "package.json",
|
|
132
|
+
"entrypoints": [
|
|
133
|
+
"build:src",
|
|
134
|
+
"build",
|
|
135
|
+
"compile",
|
|
136
|
+
"test",
|
|
137
|
+
"test:unit",
|
|
138
|
+
"test:style",
|
|
139
|
+
"test:e2e",
|
|
140
|
+
"fix:lint",
|
|
141
|
+
"fix:prettier",
|
|
142
|
+
"build:docs",
|
|
143
|
+
"deploy:npm"
|
|
144
|
+
],
|
|
145
|
+
"audience": "contributors and CI",
|
|
146
|
+
"notes": "test:unit runs jest through webex-legacy-tools with an 85% global coverage threshold (jest.config.js). test:style lints src/**/*.ts with the workspace root ESLint config. test:e2e runs the workspace Playwright config against the sample app. build:docs writes typedoc output outside the package."
|
|
147
|
+
}
|
|
148
|
+
],
|
|
149
|
+
"source_of_truth": [
|
|
150
|
+
{
|
|
151
|
+
"surface": "Contact Center plugin implementation",
|
|
152
|
+
"paths": [
|
|
153
|
+
"src"
|
|
154
|
+
],
|
|
155
|
+
"generated_artifacts": [
|
|
156
|
+
"dist"
|
|
157
|
+
],
|
|
158
|
+
"refresh_with": [
|
|
159
|
+
"yarn workspace @webex/contact-center build:src"
|
|
160
|
+
],
|
|
161
|
+
"validate_with": [
|
|
162
|
+
"yarn workspace @webex/contact-center test:unit",
|
|
163
|
+
"yarn workspace @webex/contact-center test:style"
|
|
164
|
+
]
|
|
165
|
+
},
|
|
166
|
+
{
|
|
167
|
+
"surface": "unit tests",
|
|
168
|
+
"paths": [
|
|
169
|
+
"test/unit/spec"
|
|
170
|
+
],
|
|
171
|
+
"generated_artifacts": [
|
|
172
|
+
"coverage",
|
|
173
|
+
"junit.xml"
|
|
174
|
+
],
|
|
175
|
+
"refresh_with": [
|
|
176
|
+
"yarn workspace @webex/contact-center test:unit"
|
|
177
|
+
],
|
|
178
|
+
"validate_with": [
|
|
179
|
+
"yarn workspace @webex/contact-center test:unit"
|
|
180
|
+
]
|
|
181
|
+
},
|
|
182
|
+
{
|
|
183
|
+
"surface": "module specifications",
|
|
184
|
+
"paths": [
|
|
185
|
+
"src/docs/README.md",
|
|
186
|
+
"src/metrics/docs/README.md",
|
|
187
|
+
"src/services/docs/README.md",
|
|
188
|
+
"src/services/agent/docs/README.md",
|
|
189
|
+
"src/services/config/docs/README.md",
|
|
190
|
+
"src/services/core/docs/README.md",
|
|
191
|
+
"src/services/task/docs/README.md",
|
|
192
|
+
"src/services/task/state-machine/docs/README.md",
|
|
193
|
+
"src/utils/docs/README.md"
|
|
194
|
+
],
|
|
195
|
+
"generated_artifacts": [],
|
|
196
|
+
"refresh_with": [
|
|
197
|
+
"update alongside the behavior change in the same commit"
|
|
198
|
+
],
|
|
199
|
+
"validate_with": [
|
|
200
|
+
"spec-validator on an independent runtime"
|
|
201
|
+
]
|
|
202
|
+
},
|
|
203
|
+
{
|
|
204
|
+
"surface": "package standing documentation",
|
|
205
|
+
"paths": [
|
|
206
|
+
"AGENTS.md",
|
|
207
|
+
"docs"
|
|
208
|
+
],
|
|
209
|
+
"generated_artifacts": [],
|
|
210
|
+
"refresh_with": [
|
|
211
|
+
"update in the same change that alters package boundaries, contracts, commands, or decisions"
|
|
212
|
+
],
|
|
213
|
+
"validate_with": [
|
|
214
|
+
"check_spec_index.py and check_repo_context.py from the repo-annotation plugin"
|
|
215
|
+
]
|
|
216
|
+
}
|
|
217
|
+
],
|
|
218
|
+
"generated_artifacts": [
|
|
219
|
+
{
|
|
220
|
+
"path": "dist",
|
|
221
|
+
"generated_from": "src",
|
|
222
|
+
"refresh_with": "yarn workspace @webex/contact-center build:src"
|
|
223
|
+
},
|
|
224
|
+
{
|
|
225
|
+
"path": "umd/contact-center.min.js",
|
|
226
|
+
"generated_from": "src/webex.js",
|
|
227
|
+
"refresh_with": "The workspace webpack UMD build (webpack.config.js contact-center entry at the workspace root); not a package script."
|
|
228
|
+
},
|
|
229
|
+
{
|
|
230
|
+
"path": "../../../.sdd/templates/repo-standards/template-map.json",
|
|
231
|
+
"generated_from": "WebexTools/repo-standards@d89a7fe59126ae3ad9bac9ca352aa7f12b4c85dc",
|
|
232
|
+
"refresh_with": "The package holds no templates. It refers to the monorepo root snapshot at ../../../.sdd/templates/repo-standards through layout.monorepo_package.templates_root_path in .sdd/manifest.json. Refresh the root snapshot, not this package."
|
|
233
|
+
}
|
|
234
|
+
],
|
|
235
|
+
"validation_matrix": [
|
|
236
|
+
{
|
|
237
|
+
"paths": [
|
|
238
|
+
"src/**"
|
|
239
|
+
],
|
|
240
|
+
"minimum": [
|
|
241
|
+
"yarn workspace @webex/contact-center build:src",
|
|
242
|
+
"yarn workspace @webex/contact-center test:unit",
|
|
243
|
+
"yarn workspace @webex/contact-center test:style"
|
|
244
|
+
],
|
|
245
|
+
"recommended": [
|
|
246
|
+
"add or update the matching test/unit/spec case; keep the 85% coverage threshold met"
|
|
247
|
+
]
|
|
248
|
+
},
|
|
249
|
+
{
|
|
250
|
+
"paths": [
|
|
251
|
+
"src/index.ts",
|
|
252
|
+
"src/types.ts",
|
|
253
|
+
"src/services/*/types.ts",
|
|
254
|
+
"package.json"
|
|
255
|
+
],
|
|
256
|
+
"minimum": [
|
|
257
|
+
"yarn workspace @webex/contact-center build",
|
|
258
|
+
"yarn workspace @webex/contact-center test:unit"
|
|
259
|
+
],
|
|
260
|
+
"recommended": [
|
|
261
|
+
"test/unit/spec/index.ts checks the root exports; update docs/architecture.md and .sdd/manifest.json contract_catalog"
|
|
262
|
+
]
|
|
263
|
+
},
|
|
264
|
+
{
|
|
265
|
+
"paths": [
|
|
266
|
+
"src/webex.js",
|
|
267
|
+
"src/webex-config.ts"
|
|
268
|
+
],
|
|
269
|
+
"minimum": [
|
|
270
|
+
"yarn workspace @webex/contact-center build:src",
|
|
271
|
+
"yarn workspace @webex/contact-center test:style"
|
|
272
|
+
],
|
|
273
|
+
"recommended": [
|
|
274
|
+
"rebuild the UMD bundle and load the Contact Center sample; yarn workspace @webex/contact-center test:e2e when credentials are available"
|
|
275
|
+
]
|
|
276
|
+
}
|
|
277
|
+
],
|
|
278
|
+
"change_impact": [
|
|
279
|
+
{
|
|
280
|
+
"paths": [
|
|
281
|
+
"src/cc.ts"
|
|
282
|
+
],
|
|
283
|
+
"affects": [
|
|
284
|
+
"every public webex.cc method and plugin event",
|
|
285
|
+
"register, deregister, and silent relogin ordering"
|
|
286
|
+
],
|
|
287
|
+
"refresh_with": [
|
|
288
|
+
"yarn workspace @webex/contact-center build:src"
|
|
289
|
+
],
|
|
290
|
+
"validate_with": [
|
|
291
|
+
"yarn workspace @webex/contact-center test:unit",
|
|
292
|
+
"yarn workspace @webex/contact-center test:style"
|
|
293
|
+
],
|
|
294
|
+
"avoid_direct_edits": [
|
|
295
|
+
"dist",
|
|
296
|
+
"umd/contact-center.min.js"
|
|
297
|
+
],
|
|
298
|
+
"notes": "Collaborators are constructed on the Webex READY event; register() only subscribes and connects (src/docs/README.md)."
|
|
299
|
+
},
|
|
300
|
+
{
|
|
301
|
+
"paths": [
|
|
302
|
+
"src/services/core/**"
|
|
303
|
+
],
|
|
304
|
+
"affects": [
|
|
305
|
+
"AQM request settlement and timeouts",
|
|
306
|
+
"WebSocket connection and recovery for every agent and task operation"
|
|
307
|
+
],
|
|
308
|
+
"refresh_with": [
|
|
309
|
+
"yarn workspace @webex/contact-center build:src"
|
|
310
|
+
],
|
|
311
|
+
"validate_with": [
|
|
312
|
+
"yarn workspace @webex/contact-center test:unit"
|
|
313
|
+
],
|
|
314
|
+
"avoid_direct_edits": [
|
|
315
|
+
"dist"
|
|
316
|
+
],
|
|
317
|
+
"notes": "An HTTP acknowledgement never settles an AQM request; the matched WebSocket notification or TIMEOUT_REQ does."
|
|
318
|
+
},
|
|
319
|
+
{
|
|
320
|
+
"paths": [
|
|
321
|
+
"src/services/task/**"
|
|
322
|
+
],
|
|
323
|
+
"affects": [
|
|
324
|
+
"Task, Voice, WebRTC, and Digital behavior",
|
|
325
|
+
"TASK_EVENTS and TaskUIControls seen by applications"
|
|
326
|
+
],
|
|
327
|
+
"refresh_with": [
|
|
328
|
+
"yarn workspace @webex/contact-center build:src"
|
|
329
|
+
],
|
|
330
|
+
"validate_with": [
|
|
331
|
+
"yarn workspace @webex/contact-center test:unit"
|
|
332
|
+
],
|
|
333
|
+
"avoid_direct_edits": [
|
|
334
|
+
"dist"
|
|
335
|
+
],
|
|
336
|
+
"notes": "State transitions belong to the state machine; TaskManager maps backend events to TaskEvent."
|
|
337
|
+
},
|
|
338
|
+
{
|
|
339
|
+
"paths": [
|
|
340
|
+
"src/services/Queue.ts",
|
|
341
|
+
"src/services/EntryPoint.ts",
|
|
342
|
+
"src/services/AddressBook.ts",
|
|
343
|
+
"src/utils/PageCache.ts"
|
|
344
|
+
],
|
|
345
|
+
"affects": [
|
|
346
|
+
"consult and transfer destination lists",
|
|
347
|
+
"page cache eligibility"
|
|
348
|
+
],
|
|
349
|
+
"refresh_with": [
|
|
350
|
+
"yarn workspace @webex/contact-center build:src"
|
|
351
|
+
],
|
|
352
|
+
"validate_with": [
|
|
353
|
+
"yarn workspace @webex/contact-center test:unit"
|
|
354
|
+
],
|
|
355
|
+
"avoid_direct_edits": [
|
|
356
|
+
"dist"
|
|
357
|
+
],
|
|
358
|
+
"notes": "Defaults and backend ordering are fixed by docs/adr/0002-consult-transfer-list-policy.md."
|
|
359
|
+
}
|
|
360
|
+
],
|
|
361
|
+
"glossary": [
|
|
362
|
+
{
|
|
363
|
+
"term": "ContactCenter",
|
|
364
|
+
"definition": "Host-embedded Webex plugin exposing the package API, registered as cc (src/cc.ts).",
|
|
365
|
+
"notes": "Reached as webex.cc."
|
|
366
|
+
},
|
|
367
|
+
{
|
|
368
|
+
"term": "Agent Profile",
|
|
369
|
+
"definition": "Aggregated remote configuration used during an agent session (Profile in src/services/config/types.ts).",
|
|
370
|
+
"notes": "Do not call it durable local state."
|
|
371
|
+
},
|
|
372
|
+
{
|
|
373
|
+
"term": "Task",
|
|
374
|
+
"definition": "Client representation of a contact-center interaction and its operations (src/services/task/Task.ts).",
|
|
375
|
+
"notes": "Backed by remote interaction data."
|
|
376
|
+
},
|
|
377
|
+
{
|
|
378
|
+
"term": "AQM request",
|
|
379
|
+
"definition": "HTTP initiation whose success or failure is delivered by a correlated WebSocket notification (src/services/core/aqm-reqs.ts).",
|
|
380
|
+
"notes": "Not request-over-WebSocket."
|
|
381
|
+
},
|
|
382
|
+
{
|
|
383
|
+
"term": "TaskEvent",
|
|
384
|
+
"definition": "Typed internal state-machine event mapped from API calls or backend events (src/services/task/state-machine/constants.ts).",
|
|
385
|
+
"notes": "Distinct from raw CC_EVENTS."
|
|
386
|
+
},
|
|
387
|
+
{
|
|
388
|
+
"term": "PageCache",
|
|
389
|
+
"definition": "Five-minute in-memory cache for simple paginated data-service requests (src/utils/PageCache.ts).",
|
|
390
|
+
"notes": "Parameterized searches bypass it."
|
|
391
|
+
},
|
|
392
|
+
{
|
|
393
|
+
"term": "WCC",
|
|
394
|
+
"definition": "Webex Contact Center, the remote Contact Center service family."
|
|
395
|
+
},
|
|
396
|
+
{
|
|
397
|
+
"term": "RTD",
|
|
398
|
+
"definition": "Realtime data/transcription: the secondary realtime WebSocket stream."
|
|
399
|
+
},
|
|
400
|
+
{
|
|
401
|
+
"term": "RONA",
|
|
402
|
+
"definition": "Ring On No Answer: the offered-task failure state and event.",
|
|
403
|
+
"notes": "Task types also expand it as Redirection on No Answer."
|
|
404
|
+
},
|
|
405
|
+
{
|
|
406
|
+
"term": "ANI",
|
|
407
|
+
"definition": "Automatic Number Identification: outbound caller-id selection data."
|
|
408
|
+
},
|
|
409
|
+
{
|
|
410
|
+
"term": "Event",
|
|
411
|
+
"definition": "In Config and Core, a raw backend WebSocket event; in the task state machine, a typed TaskEvent after mapping."
|
|
412
|
+
},
|
|
413
|
+
{
|
|
414
|
+
"term": "State",
|
|
415
|
+
"definition": "For an agent, the backend availability or substatus; for a task, the XState lifecycle state."
|
|
416
|
+
},
|
|
417
|
+
{
|
|
418
|
+
"term": "Station login",
|
|
419
|
+
"definition": "Agent sign-in with a LoginOption of BROWSER, EXTENSION, or AGENT_DN (src/types.ts)."
|
|
420
|
+
},
|
|
421
|
+
{
|
|
422
|
+
"term": "Silent relogin",
|
|
423
|
+
"definition": "ContactCenter's private recovery that calls the agent reload request after the WebSocket reconnects, when allowAutomatedRelogin is true (src/cc.ts)."
|
|
424
|
+
}
|
|
425
|
+
],
|
|
426
|
+
"evidence_rules": [
|
|
427
|
+
{
|
|
428
|
+
"claim_category": "command_name",
|
|
429
|
+
"sources": [
|
|
430
|
+
"package.json",
|
|
431
|
+
".sdd/manifest.json"
|
|
432
|
+
],
|
|
433
|
+
"requirement": "The script must exist in package.json scripts and the command must equal a manifest commands entry.",
|
|
434
|
+
"notes": "Use the workspace form from the workspace root: yarn workspace @webex/contact-center plus the script name."
|
|
435
|
+
},
|
|
436
|
+
{
|
|
437
|
+
"claim_category": "import_path",
|
|
438
|
+
"sources": [
|
|
439
|
+
"src/index.ts",
|
|
440
|
+
"src/webex.js",
|
|
441
|
+
"package.json"
|
|
442
|
+
],
|
|
443
|
+
"requirement": "Typed exports are those of src/index.ts; the runtime default export is the Webex constructor from src/webex.js."
|
|
444
|
+
},
|
|
445
|
+
{
|
|
446
|
+
"claim_category": "behavior_claim",
|
|
447
|
+
"sources": [
|
|
448
|
+
"src",
|
|
449
|
+
"test/unit/spec"
|
|
450
|
+
],
|
|
451
|
+
"requirement": "Ground every behavioral claim in source or test evidence.",
|
|
452
|
+
"notes": "Commit history is not an evidence source; the old documentation set is migrated and is not evidence."
|
|
453
|
+
}
|
|
454
|
+
],
|
|
455
|
+
"negative_guidance": [
|
|
456
|
+
{
|
|
457
|
+
"rule": "Do not treat an AQM HTTP response as completion.",
|
|
458
|
+
"why": "AqmReqs settles on the correlated WebSocket notification or timeout (src/services/core/aqm-reqs.ts)."
|
|
459
|
+
},
|
|
460
|
+
{
|
|
461
|
+
"rule": "Do not construct collaborators in register().",
|
|
462
|
+
"why": "They are built once on the Webex READY event; register() only subscribes and connects (src/cc.ts)."
|
|
463
|
+
},
|
|
464
|
+
{
|
|
465
|
+
"rule": "Do not log tokens, dial numbers, or raw routing payloads.",
|
|
466
|
+
"why": "Sensitive AQM operations set redactSensitiveLogs; credentials are host-owned (docs/architecture.md Security architecture)."
|
|
467
|
+
},
|
|
468
|
+
{
|
|
469
|
+
"rule": "Do not sort or filter consult and transfer lists in the SDK after the response.",
|
|
470
|
+
"why": "Backend order is authoritative (docs/adr/0002-consult-transfer-list-policy.md)."
|
|
471
|
+
},
|
|
472
|
+
{
|
|
473
|
+
"rule": "Do not remove or rename a published export or event value without a major version.",
|
|
474
|
+
"why": "The package is published and semver-sensitive (docs/architecture.md Release and versioning)."
|
|
475
|
+
}
|
|
476
|
+
],
|
|
477
|
+
"confidence_policy": {
|
|
478
|
+
"high": {
|
|
479
|
+
"action": "update",
|
|
480
|
+
"expectation": "Source and a unit case in test/unit/spec agree on the behavior."
|
|
481
|
+
},
|
|
482
|
+
"medium": {
|
|
483
|
+
"action": "narrow-scope",
|
|
484
|
+
"expectation": "Only source exists, or the behavior depends on a backend message shape mirrored in src/services/config/types.ts; pin it with a unit case before modifying."
|
|
485
|
+
},
|
|
486
|
+
"low": {
|
|
487
|
+
"action": "noop",
|
|
488
|
+
"expectation": "Neither source nor tests settle the question, such as backend ordering or eligibility rules; stop and report the gap."
|
|
489
|
+
}
|
|
490
|
+
},
|
|
491
|
+
"repository_topology": {
|
|
492
|
+
"main_entrypoints": [
|
|
493
|
+
{
|
|
494
|
+
"name": "package main",
|
|
495
|
+
"path": "src/webex.js",
|
|
496
|
+
"purpose": "Standalone Webex constructor; also the workspace UMD entry for umd/contact-center.min.js",
|
|
497
|
+
"notes": "package.json main and exports['.'] are dist/webex.js."
|
|
498
|
+
},
|
|
499
|
+
{
|
|
500
|
+
"name": "typed entry",
|
|
501
|
+
"path": "src/index.ts",
|
|
502
|
+
"purpose": "Registers the cc plugin and exports the public classes, enums, and types",
|
|
503
|
+
"notes": "package.json devMain; types is dist/types/index.d.ts."
|
|
504
|
+
},
|
|
505
|
+
{
|
|
506
|
+
"name": "plugin facade",
|
|
507
|
+
"path": "src/cc.ts",
|
|
508
|
+
"purpose": "ContactCenter: READY-time composition, register, deregister, and the public methods"
|
|
509
|
+
}
|
|
510
|
+
],
|
|
511
|
+
"workspace_packages": [
|
|
512
|
+
{
|
|
513
|
+
"name": "@webex/contact-center",
|
|
514
|
+
"paths": [
|
|
515
|
+
"src",
|
|
516
|
+
"test"
|
|
517
|
+
],
|
|
518
|
+
"notes": "Nine manifest modules; this SDD root is the package directory inside the webex-js-sdk monorepo."
|
|
519
|
+
}
|
|
520
|
+
],
|
|
521
|
+
"source_surfaces": [
|
|
522
|
+
{
|
|
523
|
+
"name": "Contact Center plugin",
|
|
524
|
+
"paths": [
|
|
525
|
+
"src"
|
|
526
|
+
],
|
|
527
|
+
"notes": "Specified by the nine module docs/README.md files listed in docs/specs/README.md."
|
|
528
|
+
},
|
|
529
|
+
{
|
|
530
|
+
"name": "tests",
|
|
531
|
+
"paths": [
|
|
532
|
+
"test/unit/spec"
|
|
533
|
+
],
|
|
534
|
+
"notes": "Jest unit specs mirroring src; fixtures under test/unit/fixtures."
|
|
535
|
+
}
|
|
536
|
+
],
|
|
537
|
+
"generated_surfaces": [
|
|
538
|
+
{
|
|
539
|
+
"name": "build output",
|
|
540
|
+
"paths": [
|
|
541
|
+
"dist"
|
|
542
|
+
],
|
|
543
|
+
"generated_from": "src",
|
|
544
|
+
"refresh_with": "yarn workspace @webex/contact-center build:src",
|
|
545
|
+
"notes": "JavaScript, source maps, and dist/types declarations. Do not edit by hand."
|
|
546
|
+
},
|
|
547
|
+
{
|
|
548
|
+
"name": "UMD bundle",
|
|
549
|
+
"paths": [
|
|
550
|
+
"umd/contact-center.min.js"
|
|
551
|
+
],
|
|
552
|
+
"generated_from": "src/webex.js",
|
|
553
|
+
"refresh_with": "The workspace webpack UMD build",
|
|
554
|
+
"notes": "Committed bundle loaded by the Contact Center sample."
|
|
555
|
+
},
|
|
556
|
+
{
|
|
557
|
+
"name": "repo-standards template map",
|
|
558
|
+
"paths": [
|
|
559
|
+
"../../../.sdd/templates/repo-standards"
|
|
560
|
+
],
|
|
561
|
+
"generated_from": "WebexTools/repo-standards@d89a7fe59126ae3ad9bac9ca352aa7f12b4c85dc",
|
|
562
|
+
"refresh_with": "The package holds no templates. It refers to the monorepo root snapshot at ../../../.sdd/templates/repo-standards through layout.monorepo_package.templates_root_path in .sdd/manifest.json. Refresh the root snapshot, not this package.",
|
|
563
|
+
"notes": "The package holds no templates. It refers to the monorepo root snapshot at ../../../.sdd/templates/repo-standards through layout.monorepo_package.templates_root_path in .sdd/manifest.json. Refresh the root snapshot, not this package."
|
|
564
|
+
}
|
|
565
|
+
],
|
|
566
|
+
"sync_paths": [
|
|
567
|
+
{
|
|
568
|
+
"source": "src",
|
|
569
|
+
"targets": [
|
|
570
|
+
"src/docs/README.md",
|
|
571
|
+
"src/metrics/docs/README.md",
|
|
572
|
+
"src/services/docs/README.md",
|
|
573
|
+
"src/services/agent/docs/README.md",
|
|
574
|
+
"src/services/config/docs/README.md",
|
|
575
|
+
"src/services/core/docs/README.md",
|
|
576
|
+
"src/services/task/docs/README.md",
|
|
577
|
+
"src/services/task/state-machine/docs/README.md",
|
|
578
|
+
"src/utils/docs/README.md",
|
|
579
|
+
"docs/architecture.md"
|
|
580
|
+
],
|
|
581
|
+
"mechanism": "Manual; update the owning module specification and the contract index in the same change that alters observable behavior or a contract.",
|
|
582
|
+
"notes": "Code is the referee."
|
|
583
|
+
},
|
|
584
|
+
{
|
|
585
|
+
"source": "WebexTools/repo-standards@d89a7fe59126ae3ad9bac9ca352aa7f12b4c85dc",
|
|
586
|
+
"targets": [
|
|
587
|
+
"../../../.sdd/templates/repo-standards"
|
|
588
|
+
],
|
|
589
|
+
"mechanism": "The package holds no templates. It refers to the monorepo root snapshot at ../../../.sdd/templates/repo-standards through layout.monorepo_package.templates_root_path in .sdd/manifest.json. Refresh the root snapshot, not this package.",
|
|
590
|
+
"notes": "The package holds no templates. It refers to the monorepo root snapshot at ../../../.sdd/templates/repo-standards through layout.monorepo_package.templates_root_path in .sdd/manifest.json. Refresh the root snapshot, not this package."
|
|
591
|
+
}
|
|
592
|
+
],
|
|
593
|
+
"validation_entrypoints": [
|
|
594
|
+
{
|
|
595
|
+
"name": "build",
|
|
596
|
+
"command": "yarn workspace @webex/contact-center build:src",
|
|
597
|
+
"scope": "src",
|
|
598
|
+
"notes": "webex-legacy-tools build, then declarations."
|
|
599
|
+
},
|
|
600
|
+
{
|
|
601
|
+
"name": "unit-test",
|
|
602
|
+
"command": "yarn workspace @webex/contact-center test:unit",
|
|
603
|
+
"scope": "test/unit/spec",
|
|
604
|
+
"notes": "Jest with the 85% global coverage threshold."
|
|
605
|
+
},
|
|
606
|
+
{
|
|
607
|
+
"name": "lint",
|
|
608
|
+
"command": "yarn workspace @webex/contact-center test:style",
|
|
609
|
+
"scope": "src",
|
|
610
|
+
"notes": "ESLint over src/**/*.ts with the workspace root config; Markdown is not linted."
|
|
611
|
+
}
|
|
612
|
+
]
|
|
613
|
+
},
|
|
614
|
+
"folder_readme_contract": {
|
|
615
|
+
"required_sections": [
|
|
616
|
+
"purpose",
|
|
617
|
+
"boundaries",
|
|
618
|
+
"key-files",
|
|
619
|
+
"common-tasks"
|
|
620
|
+
],
|
|
621
|
+
"rules": [
|
|
622
|
+
"Orient the reader before describing detail.",
|
|
623
|
+
"Link to the module specification rather than duplicating it."
|
|
624
|
+
],
|
|
625
|
+
"example_policy": "Examples are allowed only when verified against src/ or test/.",
|
|
626
|
+
"fallback": "Omit a section rather than inventing content; report unresolved facts as gaps."
|
|
627
|
+
},
|
|
628
|
+
"regression_feedback_rules": [
|
|
629
|
+
{
|
|
630
|
+
"trigger": "A change to src/cc.ts registration, deregistration, or relogin ordering.",
|
|
631
|
+
"required_followups": [
|
|
632
|
+
"Add or update the case in test/unit/spec/cc.ts",
|
|
633
|
+
"Update the lifecycle flows in src/docs/README.md"
|
|
634
|
+
],
|
|
635
|
+
"notes": "Current risk: deregister() does not remove the connectionLost listener registered with handleConnectionLost.bind(this), nor the TASK_MERGED listener (src/cc.ts)."
|
|
636
|
+
},
|
|
637
|
+
{
|
|
638
|
+
"trigger": "A new or renamed export, event, or metric name.",
|
|
639
|
+
"required_followups": [
|
|
640
|
+
"Update docs/architecture.md Public and consumer surfaces",
|
|
641
|
+
"Update .sdd/manifest.json contract_catalog",
|
|
642
|
+
"Update the owning module specification"
|
|
643
|
+
]
|
|
644
|
+
}
|
|
645
|
+
],
|
|
646
|
+
"surface_owners": [
|
|
647
|
+
{
|
|
648
|
+
"surface": "module implementation and specifications",
|
|
649
|
+
"owner": "@webex/web-sdk",
|
|
650
|
+
"edit_boundary": "The monorepo .github/CODEOWNERS default rule assigns @webex/web-sdk; no line names this package."
|
|
651
|
+
}
|
|
652
|
+
],
|
|
653
|
+
"do_not_edit": [
|
|
654
|
+
"dist",
|
|
655
|
+
"umd/contact-center.min.js",
|
|
656
|
+
"../../../.sdd/templates/repo-standards"
|
|
657
|
+
],
|
|
658
|
+
"marker_scopes": {
|
|
659
|
+
"sdd": [
|
|
660
|
+
".sdd/manifest.json",
|
|
661
|
+
"AGENTS.md",
|
|
662
|
+
"docs",
|
|
663
|
+
"src/docs/README.md",
|
|
664
|
+
"src/metrics/docs/README.md",
|
|
665
|
+
"src/services/docs/README.md",
|
|
666
|
+
"src/services/agent/docs/README.md",
|
|
667
|
+
"src/services/config/docs/README.md",
|
|
668
|
+
"src/services/core/docs/README.md",
|
|
669
|
+
"src/services/task/docs/README.md",
|
|
670
|
+
"src/services/task/state-machine/docs/README.md",
|
|
671
|
+
"src/utils/docs/README.md"
|
|
672
|
+
]
|
|
673
|
+
},
|
|
674
|
+
"fallback_rules": [
|
|
675
|
+
"When source and tests disagree, code is the referee and the disagreement is recorded rather than silently resolved.",
|
|
676
|
+
"When neither source nor tests settle a question, report it as a gap instead of inferring.",
|
|
677
|
+
"Commit history is not a valid rationale source for this package."
|
|
678
|
+
],
|
|
679
|
+
"downstream_context_pack": {
|
|
680
|
+
"required_human_surfaces": [
|
|
681
|
+
"README.md",
|
|
682
|
+
"docs/index.md",
|
|
683
|
+
"docs/architecture.md",
|
|
684
|
+
"docs/getting-started.md"
|
|
685
|
+
],
|
|
686
|
+
"required_agent_operational_surfaces": [
|
|
687
|
+
"AGENTS.md",
|
|
688
|
+
"docs/specs/README.md"
|
|
689
|
+
],
|
|
690
|
+
"required_machine_readable_surface": ".sdd/manifest.json",
|
|
691
|
+
"recommended_machine_readable_sections": [
|
|
692
|
+
"task_playbooks",
|
|
693
|
+
"public_interfaces",
|
|
694
|
+
"change_impact",
|
|
695
|
+
"glossary",
|
|
696
|
+
"evidence_rules",
|
|
697
|
+
"negative_guidance",
|
|
698
|
+
"confidence_policy",
|
|
699
|
+
"repository_topology",
|
|
700
|
+
"folder_readme_contract",
|
|
701
|
+
"regression_feedback_rules"
|
|
702
|
+
]
|
|
703
|
+
}
|
|
704
|
+
}
|