Skip to content

docs: add 11 missing breaking changes to MIGRATION.md - #2668

Merged
cs-raj merged 1 commit into
v2-devfrom
docs/v2-migration-guide-additions
Jul 29, 2026
Merged

docs: add 11 missing breaking changes to MIGRATION.md#2668
cs-raj merged 1 commit into
v2-devfrom
docs/v2-migration-guide-additions

Conversation

@cs-raj

@cs-raj cs-raj commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Adds 11 new sections (8–18) to MIGRATION.md covering all breaking changes identified through a complete file-by-file code verification pass across every package in the cli and cli-plugins repos
  • No existing content was modified — additions only
  • Also adds MIGRATION.md to .talismanrc to suppress false-positive secret scan alerts on documentation text

What's Added

# Section Impact
8 Flag renames on export/import/export-to-csv --data--data-dir, -s, -B, --skip-app-recreation removed — scripts error immediately
9 Export directory structure changed globalfields.json gone, schema.json gone, branches.json gone
10 V2 export + V1 import = silent data loss Import completes "successfully" with 0 content types / 0 global fields — no warning
11 Command aliases removed cm:export, cm:import, audit, audit:fix, tokens, cm:seed all fail
12 content-type:* deprecated flags removed --stack, --token-alias, and 10+ short chars across 6 commands
13 --api-version removed from bulk ops Passing it now fails; 3.2 is hardcoded
14 Short char removals across other commands -A/-n/-B on migration, -n on app:create, etc.
15 Console log config key renamed V1 log setting not carried over; must re-run config:set:log after upgrade
16 13 bootstrap app configs removed 8 deprecated starters + 4 sample apps gone; 8 kickstart apps remain
17 Seed stack list now curated GitHub dynamic search gone; only 4 repos; use --repo for anything else
18 Ctrl+C exits 130 instead of exception CI pipelines checking exit codes need updating

Test plan

  • Verify all added sections render correctly in GitHub markdown
  • Confirm no existing sections were modified
  • Confirm .talismanrc checksum matches the current MIGRATION.md content

🤖 Generated with Claude Code

Extends the V1→V2 migration guide with all breaking changes identified
through a complete file-by-file code verification pass across every
package in the cli and cli-plugins repos.

Sections added (8–18):
- Flag renames on export/import/export-to-csv (--data→--data-dir, -s, -B, --skip-app-recreation)
- Export directory structure changes (per-UID global fields/CTs, schema.json removed, branches.json removed)
- V2 export + V1 import silent data loss (content types and global fields silently skipped)
- Command aliases removed (cm:export, cm:import, audit, audit:fix, tokens, cm:seed)
- content-type:* deprecated flags removed (--stack, --token-alias, 10+ short chars)
- --api-version removed from bulk-entries and bulk-taxonomies (hardcoded 3.2)
- Short char removals across migration, migrate:convert, migrate:export, app:create
- Console log config key renamed (show-console-logs → showConsoleLogs)
- 13 bootstrap app configs removed (8 deprecated starters + 4 sample apps)
- Seed stack list now curated (4 stacks; GitHub dynamic search removed)
- Ctrl+C exits with code 130 instead of throwing ExitPromptError

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@cs-raj
cs-raj requested a review from a team as a code owner July 29, 2026 10:28
@github-actions

Copy link
Copy Markdown

🔒 Security Scan Results

ℹ️ Note: Only vulnerabilities with available fixes (upgrades or patches) are counted toward thresholds.

Check Type Count (with fixes) Without fixes Threshold Result
🔴 Critical Severity 0 0 10 ✅ Passed
🟠 High Severity 1 36 25 ✅ Passed
🟡 Medium Severity 0 2 500 ✅ Passed
🔵 Low Severity 0 0 1000 ✅ Passed

⏱️ SLA Breach Summary

✅ No SLA breaches detected. All vulnerabilities are within acceptable time thresholds.

Severity Breaches (with fixes) Breaches (no fixes) SLA Threshold (with/no fixes) Status
🔴 Critical 0 0 15 / 30 days ✅ Passed
🟠 High 0 0 30 / 120 days ✅ Passed
🟡 Medium 0 0 90 / 365 days ✅ Passed
🔵 Low 0 0 180 / 365 days ✅ Passed

ℹ️ Vulnerabilities Without Available Fixes (Informational Only)

The following vulnerabilities were detected but do not have fixes available (no upgrade or patch). These are excluded from failure thresholds:

  • Critical without fixes: 0
  • High without fixes: 36
  • Medium without fixes: 2
  • Low without fixes: 0

✅ BUILD PASSED - All security checks passed

@cs-raj
cs-raj merged commit efeb2ef into v2-dev Jul 29, 2026
10 checks passed
@cs-raj
cs-raj deleted the docs/v2-migration-guide-additions branch July 29, 2026 10:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants