docs: add SDK dependency map generator and sync tooling by ciscoRankush · Pull Request #662

docs: add SDK dependency map generator and sync tooling by ciscoRankush · Pull Request #662 · webex/widgets

and others added 3 commits

March 11, 2026 14:12

Add automated SDD documentation drift detection tooling:
- /spec-drift: full scan command for validating all ai-docs against source code
- /spec-drift-changed: incremental scan for changed files only
- Pre-commit hook to block commits when ai-docs drift is unverified

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

- Register hook in settings.json (was dead code without it)
- Fail-closed when python3 unavailable or JSON parse fails
- Use content-based hash (git diff --cached) instead of path-only hash
- Don't consume marker in PreToolUse — invalidated naturally by content changes
- Precise case pattern to avoid matching git commit-tree
- Add shasum/sha256sum portability fallback
- Fix "Task tool" → "Agent tool" references in command files
- Add agent timeout handling rule
- Add staged-only content note for verification marker
- Make widget path mappings dynamic instead of hardcoded
- Label inventory as example
- Document advisory-only nature of verification

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Add cross-repo SDK synchronization tooling for detecting and tracking
SDK API changes across the consumer codebase.

- scripts/generate-sdk-deps.ts: scans all SDK imports, traces to file+line
- sdk-dependencies.yaml: generated dependency map for @webex/contact-center
- .claude/commands/sync-sdk.md: /sync-sdk skill for impact reports
- .claude/hooks/check-sdk-version-change.sh: notifies on SDK version change
- .sdk-cache/: cached manifest for version-to-version diffing

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

ciscoRankush changed the title ~~feat: add SDK dependency map generator and sync tooling~~ chore: add SDK dependency map generator and sync tooling

Mar 24, 2026

ciscoRankush changed the title ~~chore: add SDK dependency map generator and sync tooling~~ docs: add SDK dependency map generator and sync tooling

Mar 24, 2026

Add usage instructions for SDK dependency tracking and /sync-sdk
skill, including mandatory API verification steps for AI agents.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

The .sdk-cache/ directory is a local dev cache for SDK manifest
diffing. Each developer's cache reflects when they last ran /sync-sdk.
It should not be committed.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Replace separate TRACKED_SDKS and SCAN_DIRS arrays with a single
SDK_CONFIG array where each entry has package, scanDirs, and
localManifestPath. Adding a new SDK dependency now requires one
config entry instead of changes in multiple places.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>