Skip to content

V2.0.0 Planning#55

Draft
leogdion wants to merge 18 commits intomainfrom
v2.0.0-planning-april-26
Draft

V2.0.0 Planning#55
leogdion wants to merge 18 commits intomainfrom
v2.0.0-planning-april-26

Conversation

@leogdion
Copy link
Copy Markdown
Member

No description provided.

leogdion and others added 5 commits April 9, 2026 10:12
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
A Swift 6+ package can depend on older Swift packages, but not the
reverse — so the main package must be on Swift 6 before adopting
Swift 6.3-only libraries like swift-openapi-generator and
swift-subprocess. Swap Phase 2 and Phase 3 accordingly.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…omponent enforcement

- Create issue #53: Enforce Component-Based Plot API (restrict direct Node
  creation to internal, force Component protocol usage throughout)
- Link #40 (Ink→swift-markdown), #41/#46 (ShellOut→swift-subprocess in
  Tagscriber vs Publish/NPMPublishPlugin), #43 (SyndiKit main branch upgrade),
  #44 (swift-argument-parser→swift-configuration), #45 (Prch removal),
  #47 (MarkdownGenerator→local subrepo) to their Phase 1/3 deliverables
- Add Future Work section for #49 (AT Protocol), #50 (GitHub Pages), #51
  (node-swift research)
- Update MarkdownGenerator in compatibility matrix: KEEP→BRING LOCAL (#47)
- Note #43 SyndiKit upgrade as prerequisite for Phase 2 macOS 13 minimum

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…program path

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Merges the detailed technical content from .claude/PRD-V2-MIGRATION.md
into PRD.md — correct phase ordering (Swift 6 before OpenAPI), dependency
research table, publishing infra architecture, and new issue #51. Deletes
PRD-V2-MIGRATION.md.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 13, 2026

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: a1b8eb2f-068d-4517-9649-dfbdb535fcaf

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch v2.0.0-planning-april-26

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

Comment thread PRD.md Outdated
Comment thread PRD.md
Comment thread PRD.md Outdated
Comment on lines +67 to +69
| #3 | Add Additional Local Storage Options | Open |
| #4 | Add Main Actor to Swift 6 Article Solution | Open |
| #13 | Clarify String vs Reference design choice in MistKit article | Open |
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

these issues are not part of the migration but just content edits. mark so in this document and apply a label.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

move these to the bottom

Comment thread PRD.md
Comment thread PRD.md Outdated
Comment on lines +90 to +95
| #19 | Implement FAQ Schema Markup in `PiHTMLFactory` | P0-critical | In Progress |
| #20 | Implement HowTo Schema Markup in `PiHTMLFactory` | P1-high | Open |

**Implementation files:**
- `Sources/BrightDigitSite/Nodes/PiHTMLFactory.HTML.swift` — head generation
- `Sources/BrightDigitSite/PiHTMLFactory.swift` — main factory
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Is PiHTMLFactory the protocol? Verify FAQ and HowTo are appropriate for a company site. If not find appropriate counter parts.

Comment thread PRD.md Outdated

| # | Title | Status |
|---|-------|--------|
| #38 | Swift 6 Language Mode + Component Migration + Mermaid Support | Open |
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add an issue to upgrade Tailwind and create a library for easy tailwind access

Comment thread PRD.md
Comment thread PRD.md Outdated
| # | Title | Notes |
|---|-------|-------|
| #50 | Migrate to GitHub Pages | Currently deployed via Netlify |
| #49 | Support AT Protocol | Reference: [A Social Filesystem](https://overreacted.io/a-social-filesystem/) |
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This should be a prerequisite for PublishKit?

Comment thread PRD.md Outdated
|---|-------|-------|
| #34 | Remove or repurpose Import/Wordpress XML files | Clean up leftover import artifacts |
| #1 | Skip Campaign Download For Existing Newsletters | May be superseded by Phase 6 Buttondown migration; keep for now |
| #51 | Research node-swift | Evaluate [kabiroberai/node-swift](https://github.com/kabiroberai/node-swift); may affect NPMPublishPlugin long-term |
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this should be prerequisite for nom plugin

Comment thread PRD.md Outdated
| # | Title | Notes |
|---|-------|-------|
| #34 | Remove or repurpose Import/Wordpress XML files | Clean up leftover import artifacts |
| #1 | Skip Campaign Download For Existing Newsletters | May be superseded by Phase 6 Buttondown migration; keep for now |
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this should be part of buttondownkit integration

- Move #18 (seomachine) from Phase 0 to Phase 1A (AI integration)
- Mark Phase 0B explicitly as non-migration content edits; call out article-edit label
- Frame AI-CITE as Swift site-building integration (BrightDigitSite/Publish)
- Add schema type verification note for FAQ/HowTo in Phase 1A
- Add re-evaluation note to Phase 1B (post-migration)
- Mark Phase 1D as post-migration tasks
- Update all Swift 6 references to Swift 6.3; remove StrictConcurrency task (not needed in 6.3)
- Expand Kanna/MarkdownGenerator rows with usage context and research notes
- Note #46 (NPMPublishPlugin) should leverage #51 (node-swift) before implementing
- Add optional #1 to Phase 4 success criteria
- Add TBD Tailwind upgrade issue to Phase 5
- Add TBD form integration issue to Phase 7
- Note #49 as potential PublishKit prerequisite
- Move #1 to ButtondownKit integration (Phase 6) context
- Mark #51 as prerequisite for Phase 4 #46
- Update issue count table (Phase 0→2, Phase 1→11, Total→38)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Comment thread PRD.md Outdated
Comment thread PRD.md
Comment thread PRD.md Outdated
Comment on lines +101 to +105
| #21 | Optimize Mise Setup Guide for AI-CITE | P1-high | Open |
| #22 | Optimize Best Backend Article for AI-CITE | P1-high | Open |
| #26 | Optimize iOS CI/CD Article for AI-CITE | P1-high | Open |
| #27 | Optimize iOS Architecture Article for AI-CITE | P1-high | Open |
| #28 | Optimize Remaining Priority Articles (Batch) | P1-high | Open |
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

move these to the bottom

Comment thread PRD.md Outdated
Comment on lines +67 to +69
| #3 | Add Additional Local Storage Options | Open |
| #4 | Add Main Actor to Swift 6 Article Solution | Open |
| #13 | Clarify String vs Reference design choice in MistKit article | Open |
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

move these to the bottom

Comment thread PRD.md Outdated
Comment on lines +119 to +120
| #24 | YouTube Video Content Strategy | P2-medium | Open |
| #25 | Create Unique BrightDigit Frameworks/Methodologies | P2-medium | Open |
Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

move them to the correct phase

Comment thread PRD.md
leogdion and others added 12 commits April 13, 2026 17:22
- Update dependency chain: Phase 1A requires Phase 3; Phase 1C independent
- Add schema integration research note to Phase 1A
- Move Phase 0B (article edits) to new Post-Migration Content Tasks section
- Move Phase 1B (article optimization) to Post-Migration Content Tasks section
- Move Phase 1D (#24, #25) to Phase 5 (post-migration AI-CITE content strategy)
- Add TBD issue to Phase 3: investigate decoupling content updates from Swift build
- Update issue count table to reflect restructuring

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…nts, NPM, and content/code separation

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Use SchemaProvider protocol in BrightDigitSite for Phase 1; promote to
PageContent in Phase 5 during component migration.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…a work

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…itSite implements

schemaMarkup: String? belongs on PageContent in PublishType (the protocol layer),
not as a workaround protocol in BrightDigitSite.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Phase 1A schema work is additive to PublishType and needs no Swift 6.3 upgrade.
Phase 1C validation cannot run before Phase 1A schema is shipped.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Avoids doing AI-CITE code changes across a Swift 6.3 boundary.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Monorepo cleanup → Swift 6.3 → AI-CITE → OpenAPI → Subrepos/Components
→ Publishing → Platform → Cleanup

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…m conflict

Package@swift-6.0.swift on main handles Swift 6.3 compatibility automatically.
#43 is recommended before Phase 2 for clean concurrency, not a hard blocker.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
SwiftSoup is pure Swift, Linux-compatible, covers all Kanna usage in
Tagscriber/KannaMarkdownGenerator.swift (tag names, text, attributes,
child selection via CSS selectors instead of XPath).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
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.

1 participant