@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.
- package/.repo-context.json +704 -0
- package/.sdd/manifest.json +1065 -339
- package/AGENTS.md +935 -60
- package/dist/webex.js +1 -1
- package/docs/adr/0001-spec-source-policy.md +97 -0
- package/{ai-docs/features/consult-transfer-list-policy/spec/feature-spec.md → docs/adr/0002-consult-transfer-list-policy.md} +227 -244
- 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 +10 -9
- package/schemas/repo-context.schema.json +796 -0
- package/src/docs/README.md +727 -0
- package/src/metrics/docs/README.md +710 -0
- package/src/services/agent/docs/README.md +673 -0
- package/src/services/config/docs/README.md +530 -0
- package/src/services/core/docs/README.md +993 -0
- package/src/services/docs/README.md +765 -0
- package/src/services/task/docs/README.md +1569 -0
- package/src/services/task/state-machine/docs/README.md +1388 -0
- package/src/utils/AGENTS.md +6 -4
- package/src/utils/docs/README.md +413 -0
- package/umd/contact-center.min.js +2 -2
- package/umd/contact-center.min.js.map +1 -1
- package/ai-docs/ARCHITECTURE.md +0 -168
- package/ai-docs/CONTRACTS.md +0 -64
- package/ai-docs/GETTING_STARTED.md +0 -168
- package/ai-docs/GLOSSARY.md +0 -43
- package/ai-docs/README.md +0 -138
- package/ai-docs/REVIEW_CHECKLIST.md +0 -41
- package/ai-docs/RULES.md +0 -444
- package/ai-docs/SECURITY.md +0 -52
- package/ai-docs/SERVICE_STATE.md +0 -52
- package/ai-docs/SPEC_INDEX.md +0 -65
- package/ai-docs/adr/0001-spec-source-policy.md +0 -55
- package/ai-docs/adr/README.md +0 -8
- package/ai-docs/adr/_adr-template.md +0 -31
- package/ai-docs/contact-center-spec.md +0 -388
- package/ai-docs/features/contact-owner-change-refactor.md +0 -78
- package/ai-docs/features/generated-spec-conformance-fidelity-remediation/spec/feature-spec.md +0 -117
- package/ai-docs/features/residual-warning-coverage-completion/spec/feature-spec.md +0 -203
- package/ai-docs/features/validator-code-fidelity-drift-fix/spec/feature-spec.md +0 -315
- package/ai-docs/patterns/event-driven-patterns.md +0 -485
- package/ai-docs/patterns/testing-patterns.md +0 -480
- package/ai-docs/patterns/typescript-patterns.md +0 -365
- package/ai-docs/templates/README.md +0 -102
- package/ai-docs/templates/documentation/create-agents-md.md +0 -240
- package/ai-docs/templates/documentation/create-architecture-md.md +0 -295
- package/ai-docs/templates/existing-service/bug-fix.md +0 -254
- package/ai-docs/templates/existing-service/feature-enhancement.md +0 -450
- package/ai-docs/templates/new-method/00-master.md +0 -80
- package/ai-docs/templates/new-method/01-requirements.md +0 -232
- package/ai-docs/templates/new-method/02-implementation.md +0 -295
- package/ai-docs/templates/new-method/03-tests.md +0 -201
- package/ai-docs/templates/new-method/04-validation.md +0 -141
- package/ai-docs/templates/new-service/00-master.md +0 -109
- package/ai-docs/templates/new-service/01-pre-questions.md +0 -159
- package/ai-docs/templates/new-service/02-code-generation.md +0 -346
- package/ai-docs/templates/new-service/03-integration.md +0 -178
- package/ai-docs/templates/new-service/04-test-generation.md +0 -205
- package/ai-docs/templates/new-service/05-validation.md +0 -145
- package/src/metrics/ai-docs/AGENTS.md +0 -350
- package/src/metrics/ai-docs/ARCHITECTURE.md +0 -338
- package/src/metrics/ai-docs/metrics-spec.md +0 -971
- package/src/services/agent/ai-docs/AGENTS.md +0 -240
- package/src/services/agent/ai-docs/ARCHITECTURE.md +0 -304
- package/src/services/agent/ai-docs/agent-spec.md +0 -505
- package/src/services/ai-docs/AGENTS.md +0 -386
- package/src/services/ai-docs/services-spec.md +0 -512
- package/src/services/config/ai-docs/AGENTS.md +0 -250
- package/src/services/config/ai-docs/ARCHITECTURE.md +0 -413
- package/src/services/config/ai-docs/config-spec.md +0 -669
- package/src/services/core/ai-docs/AGENTS.md +0 -381
- package/src/services/core/ai-docs/ARCHITECTURE.md +0 -698
- package/src/services/core/ai-docs/core-spec.md +0 -797
- package/src/services/task/ai-docs/AGENTS.md +0 -457
- package/src/services/task/ai-docs/ARCHITECTURE.md +0 -595
- package/src/services/task/ai-docs/task-spec.md +0 -1501
- package/src/services/task/state-machine/ai-docs/AGENTS.md +0 -460
- package/src/services/task/state-machine/ai-docs/ARCHITECTURE.md +0 -1156
- package/src/services/task/state-machine/ai-docs/task-state-machine-spec.md +0 -2247
- package/src/utils/ai-docs/utils-spec.md +0 -391
package/dist/webex.js
CHANGED
|
@@ -0,0 +1,97 @@
|
|
|
1
|
+
---
|
|
2
|
+
type: ADR
|
|
3
|
+
title: ADR-0001 - Spec source policy
|
|
4
|
+
description: July 2026 decision to migrate the legacy Contact Center AI docs into canonical SDD specs and keep the legacy files as reference-only sources; superseded by ADR-0003.
|
|
5
|
+
tags: [adr]
|
|
6
|
+
timestamp: 2026-07-07T00:00:00Z
|
|
7
|
+
status: superseded
|
|
8
|
+
---
|
|
9
|
+
<!-- sdd-generated-metadata
|
|
10
|
+
doc_kind: standing-doc
|
|
11
|
+
generated_from: adr@0.3.0
|
|
12
|
+
generated_by: claude-code
|
|
13
|
+
approved_by: rarajes2@cisco.com
|
|
14
|
+
updated_at: 2026-11-17T03:03:58Z
|
|
15
|
+
validation_status: pass-with-warnings
|
|
16
|
+
-->
|
|
17
|
+
|
|
18
|
+
# ADR-0001 - Migrate legacy Contact Center AI docs into canonical SDD specs
|
|
19
|
+
|
|
20
|
+
| Field | Value |
|
|
21
|
+
|---|---|
|
|
22
|
+
| Status | Superseded by [ADR-0003](0003-repo-standards-migration.md); Accepted 2026-07-07 |
|
|
23
|
+
| Decision date | 2026-07-07 |
|
|
24
|
+
| Deciders | Package maintainer / user |
|
|
25
|
+
| Supersedes | none |
|
|
26
|
+
| Superseded by | [ADR-0003 - Repo-standards migration](0003-repo-standards-migration.md) |
|
|
27
|
+
|
|
28
|
+
This record keeps the decision as it was accepted in July 2026. Its file paths name the layout of that
|
|
29
|
+
time, which ADR-0003 replaced.
|
|
30
|
+
|
|
31
|
+
## Context
|
|
32
|
+
|
|
33
|
+
The Contact Center package already contained module-local AGENTS.md, ARCHITECTURE.md, pattern, and workflow documents before canonical SDD specifications were introduced. Those files contain useful intent and examples, but allowing them to remain co-equal with the generated \*-spec.md files would make documentation routing ambiguous and could preserve statements that have drifted from src/\*\* and test/\*\*.
|
|
34
|
+
|
|
35
|
+
The source inventory and canonical targets are recorded in `packages/@webex/contact-center/.sdd/manifest.json`. Code and tests remain the behavioral referee for every migrated statement.
|
|
36
|
+
|
|
37
|
+
## Decision
|
|
38
|
+
|
|
39
|
+
Use the `migrate-existing` source policy.
|
|
40
|
+
|
|
41
|
+
- Preserve relevant legacy content by meaning in the canonical SDD specification for each module.
|
|
42
|
+
- Treat manifest-routed legacy documents as reference-only migration sources, not canonical specifications.
|
|
43
|
+
- Route agents through `.sdd/manifest.json` and ai-docs/SPEC_INDEX.md to the canonical target.
|
|
44
|
+
- Retain legacy files with a banner pointing to their canonical target; if documentation conflicts with code or tests, code and tests win.
|
|
45
|
+
|
|
46
|
+
The SDD route replaces the former package-local workflow, classification summary, specification-summary gate, and service-routing tables with one sequence: read package AGENTS.md, select the owning spec through SPEC_INDEX.md, verify requirements against source/tests, obtain approval for the affected files/contracts, update code and its owning spec together, and run generator-side conformance plus independent semantic validation before staging.
|
|
47
|
+
|
|
48
|
+
| Module | Canonical target |
|
|
49
|
+
|---|---|
|
|
50
|
+
| `src` | ai-docs/contact-center-spec.md |
|
|
51
|
+
| `src/metrics` | src/metrics/ai-docs/metrics-spec.md |
|
|
52
|
+
| `src/services` | src/services/ai-docs/services-spec.md |
|
|
53
|
+
| `src/services/agent` | src/services/agent/ai-docs/agent-spec.md |
|
|
54
|
+
| `src/services/config` | src/services/config/ai-docs/config-spec.md |
|
|
55
|
+
| `src/services/core` | src/services/core/ai-docs/core-spec.md |
|
|
56
|
+
| `src/services/task` | src/services/task/ai-docs/task-spec.md |
|
|
57
|
+
| `src/services/task/state-machine` | src/services/task/state-machine/ai-docs/task-state-machine-spec.md |
|
|
58
|
+
| `src/utils` | src/utils/ai-docs/utils-spec.md |
|
|
59
|
+
|
|
60
|
+
## Why
|
|
61
|
+
|
|
62
|
+
One machine-routed canonical specification per module gives agents a deterministic route, while the
|
|
63
|
+
legacy documents stay available as context without competing for authority.
|
|
64
|
+
|
|
65
|
+
## Alternatives considered
|
|
66
|
+
|
|
67
|
+
| Alternative | Pros | Cons | Why rejected |
|
|
68
|
+
|---|---|---|---|
|
|
69
|
+
| Keep legacy and SDD docs separate and co-equal | No migration work | Agents must choose between competing authorities; drift remains likely | Does not establish deterministic routing |
|
|
70
|
+
| Reconcile every legacy document in place | Preserves familiar paths | Keeps multiple canonical shapes and complicates validation | The package needs one template-compatible SDD surface |
|
|
71
|
+
| Delete legacy documents after migration | Removes ambiguity | Loses useful historical examples and context | Reference material remains valuable when clearly marked noncanonical |
|
|
72
|
+
|
|
73
|
+
## Consequences
|
|
74
|
+
|
|
75
|
+
- **Positive:** Each module has one machine-routed canonical specification and a durable, reviewable policy record.
|
|
76
|
+
- **Negative / cost:** Retained legacy documents require reference-only banners and must not be updated as independent authorities.
|
|
77
|
+
- **Agents must:** Read the manifest and SPEC_INDEX.md, open the canonical \*-spec.md, and cross-check behavior against source and tests.
|
|
78
|
+
|
|
79
|
+
## Constraint on future changes
|
|
80
|
+
|
|
81
|
+
Code and the owning specification change together; when documentation and code or tests disagree,
|
|
82
|
+
code and tests win; no second documentation family becomes canonical beside the module
|
|
83
|
+
specifications.
|
|
84
|
+
|
|
85
|
+
## Follow-up
|
|
86
|
+
|
|
87
|
+
- Superseded on 2026-11-16 by [ADR-0003](0003-repo-standards-migration.md), which moved the
|
|
88
|
+
specifications into the repo-standards layout and removes the legacy documents after review.
|
|
89
|
+
|
|
90
|
+
## Revisit when
|
|
91
|
+
|
|
92
|
+
- A module is promoted from `Partial` to `Specced`, a canonical target is relocated, or a legacy file is proposed for removal.
|
|
93
|
+
|
|
94
|
+
## References
|
|
95
|
+
|
|
96
|
+
- `.sdd/manifest.json` `spec_source_policy` and `spec_sources`
|
|
97
|
+
- [ADR-0003 - Repo-standards migration](0003-repo-standards-migration.md)
|