🐝 Epic: Port Drupal 11 Core to TypeScript + Rust/WASM (multi-agent swarm)

[ruvnet]

🐝 Epic: Port Drupal 11 Core to TypeScript + Rust/WASM

Tracking issue for the multi-agent swarm port of Drupal core. Coordinated by
ruflo-swarm:coordinator, tested TDD-London (tdd-london-swarm), complex algos in
Rust→WASM. Architecture: ADR-0014…0018 (docs/adr/).

Ground truth

• Source mapped in drupal-rvf/ (RVF semantic DB of Drupal 11: 16,151 files, 1.78M LOC, 87 modules).
• Monorepo: port/ (npm workspaces packages/*, Rust workspace crates/*).
• Rule (ADR-0017): each agent owns ONE packages/<name>/ or crates/<name>/; never edits shared root manifests.
• Definition of done per task: failing-first tests (Vitest / cargo test) → impl → green → reviewer sign-off → progress comment here.

Conventions

• TS package: @drupaljs/<name> (see port/README.md template).
• Rust crate: drupaljs-<name>, crate-type=["cdylib","rlib"], wasm-bindgen.
• Comment format per task: ✅/🚧 @drupaljs/<name> — <what landed> — tests: N pass — coverage: X%.

---

Phase 1 — Kernel (TS packages)

• 1. @drupaljs/contracts — shared interfaces/types
• 2. @drupaljs/di — service container + ContainerBuilder
• 3. @drupaljs/event-dispatcher
• 4. @drupaljs/hook — module hook system
• 5. @drupaljs/plugin — plugin manager, discovery, factory
• 6. @drupaljs/typed-data
• 7. @drupaljs/config — config factory, storage, overrides
• 8. @drupaljs/cache — backends + cache tags/contexts
• 9. @drupaljs/routing — route provider, url generator
• 10. @drupaljs/http-kernel — request/response, middleware, controller resolver
• 11. @drupaljs/render — render arrays, renderer, bubbleable metadata
• 12. @drupaljs/theme — theme negotiation + template engine
• 13. @drupaljs/entity — entity type, storage, query
• 14. @drupaljs/database — connection, query builder, schema
• 15. @drupaljs/util — Xss/Html/NestedArray/UrlHelper/Tags/Bytes/SortArray
• 16. @drupaljs/datetime
• 17. @drupaljs/validation — constraints
• 18. @drupaljs/serialization
• 19. @drupaljs/state-keyvalue
• 20. @drupaljs/lock
• 21. @drupaljs/queue
• 22. @drupaljs/cron
• 23. @drupaljs/file-system — stream wrappers
• 24. @drupaljs/logger
• 25. @drupaljs/mail
• 26. @drupaljs/session
• 27. @drupaljs/access — access manager
• 28. @drupaljs/form — Form API
• 29. @drupaljs/ajax
• 30. @drupaljs/menu — link tree, local tasks/actions
• 31. @drupaljs/breadcrumb
• 32. @drupaljs/pager
• 33. @drupaljs/batch
• 34. @drupaljs/language
• 35. @drupaljs/string-translation

Phase 1 — Rust/WASM crates (complex algos, ADR-0015)

• 36. drupaljs-graph — topological sort + SCC (dependency resolution)
• 37. drupaljs-diff — Myers diff (config/text)
• 38. drupaljs-xss-html — HTML tokenizer/filter automaton
• 39. drupaljs-transliteration — transliteration tables
• 40. drupaljs-cache-checksum — cache-tag checksums
• 41. drupaljs-route-matcher — compiled route regex matcher
• 42. drupaljs-password-hash — phpass-compatible hashing
• 43. drupaljs-search-tokenizer — tokenizer/stemmer
• 44. drupaljs-uuid — UUID v4
• 45. drupaljs-crypt — hmac, base64, constant-time compare

Phase 2 — Foundational services / fields

• 46. @drupaljs/field — field types/storage/formatters/widgets
• 47. @drupaljs/field-ui
• 48. @drupaljs/text field type
• 49. @drupaljs/options field type
• 50. @drupaljs/link field type
• 51. @drupaljs/datetime-field
• 52. @drupaljs/path-alias
• 53. @drupaljs/content-translation
• 54. @drupaljs/locale
• 55. @drupaljs/editor + @drupaljs/filter

Phase 3 — Modules

• 56. @drupaljs/module-system
• 57. @drupaljs/module-user
• 58. @drupaljs/module-node
• 59. @drupaljs/module-taxonomy
• 60. @drupaljs/module-comment
• 61. @drupaljs/module-menu_link_content
• 62. @drupaljs/module-menu_ui
• 63. @drupaljs/module-block
• 64. @drupaljs/module-block_content
• 65. @drupaljs/module-file
• 66. @drupaljs/module-image
• 67. @drupaljs/module-media
• 68. @drupaljs/module-media_library
• 69. @drupaljs/module-path
• 70. @drupaljs/module-search
• 71. @drupaljs/module-ckeditor5
• 72. @drupaljs/module-content_moderation
• 73. @drupaljs/module-workflows
• 74. @drupaljs/module-workspaces
• 75. @drupaljs/module-layout_builder
• 76. @drupaljs/module-layout_discovery
• 77. @drupaljs/module-views (split: query, display, plugins, UI)
• 78. @drupaljs/module-views_ui
• 79. @drupaljs/module-jsonapi
• 80. @drupaljs/module-rest
• 81. @drupaljs/module-contact
• 82. @drupaljs/module-contextual
• 83. @drupaljs/module-toolbar
• 84. @drupaljs/module-big_pipe
• 85. @drupaljs/module-dynamic_page_cache
• 86. @drupaljs/module-page_cache
• 87. @drupaljs/module-breakpoint
• 88. @drupaljs/module-responsive_image
• 89. @drupaljs/module-migrate
• 90. @drupaljs/module-migrate_drupal
• 91. @drupaljs/module-update
• 92. @drupaljs/module-dblog
• 93. @drupaljs/module-syslog
• 94. @drupaljs/module-shortcut
• 95. @drupaljs/module-book
• 96. @drupaljs/module-history
• 97. @drupaljs/module-tour
• 98. @drupaljs/module-help
• 99. @drupaljs/theme-engine + @drupaljs/theme-olivero/claro/stark
• 100. CI/CD: GitHub Actions (tsc + vitest + cargo test + wasm-pack), coverage gate, integration harness

---

Swarm log

Agents append progress below as comments. Coordinator maintains the checklist above.

[ruvnet]

Swarm Coordinator — Wave 1 Launched

Session: swarm-1780491935797-ofn6np
Date: 2026-06-03
Coordinator: claude-sonnet-4-6

Wave 1 Agents Active (14 agents)

Agent	Package/Crate	Status
architect	design + contracts	🚧 in-progress
tdd-lead	test harness	🚧 in-progress
di-coder	@drupaljs/di	🚧 in-progress
event-coder	@drupaljs/event-dispatcher	🚧 in-progress
hook-coder	@drupaljs/hook	🚧 in-progress
plugin-coder	@drupaljs/plugin	🚧 in-progress
config-coder	@drupaljs/config	🚧 in-progress
cache-coder	@drupaljs/cache	🚧 in-progress
typed-data-coder	@drupaljs/typed-data	🚧 in-progress
util-coder	@drupaljs/util	🚧 in-progress
routing-coder	@drupaljs/routing	🚧 in-progress
render-coder	@drupaljs/render	🚧 in-progress
graph-coder	drupaljs-graph (Rust/WASM)	🚧 in-progress
diff-coder	drupaljs-diff (Rust/WASM)	🚧 in-progress
xss-coder	drupaljs-xss-html (Rust/WASM)	🚧 in-progress

Swarm Status

• Total tasks: 100
• Done: 0
• In-progress: 15
• Queued: 85

Wave 2 (http-kernel, theme, entity, database, datetime, validation, serialization, state-keyvalue, lock, queue + remaining Rust crates) dispatches after Wave 1 completion.

[ruvnet]

✅ @drupaljs/testing — shared London-school test harness ready — tests: 41 pass

[ruvnet]

🦀 drupaljs-diff (WASM) — Myers diff + array diff — cargo tests: 24 pass

• crates/diff (crate drupaljs-diff, crate-type [cdylib, rlib]), per ADR-0015/0016/0017
• Myers O(ND) shortest-edit-script over line sequences -> equal/insert/delete ops (coalesced runs); mirrors Drupal Diff engine
• Recursive associative array/map diff (DiffArray::diffAssoc semantics, strict PHP !== identity) for config diff
• #[wasm_bindgen] exports: diffLines(string[], string[]) and diffText(str, str) -> { kind, lines }[]; plus plain-Rust API (diff_lines, diff_assoc)
• TDD: 24 #[cfg(test)] tests written first, all green (myers 11, array_diff 10, lib integration 3)
• Verified via native cargo test (wasm-pack not installed). Note: workspace-level cargo test -p drupaljs-diff is transiently blocked by sibling crate xss-html mid-scaffold (no src/lib.rs yet) — crate validated in isolation; no shared manifests touched (ADR-0017).

[ruvnet]

✅ @drupaljs/hook — module/hook system ported — tests: 27 pass

[ruvnet]

🦀 drupaljs-graph (WASM) — topo-sort/SCC — cargo tests: 31 pass

[ruvnet]

✅ @drupaljs/event-dispatcher — ported — tests: 24 pass

[ruvnet]

✅ @drupaljs/contracts — core kernel interfaces defined

[ruvnet]

✅ @drupaljs/typed-data — ported — tests: 48 pass

[ruvnet]

✅ @drupaljs/di — DI container/ContainerBuilder ported — tests: 33 pass

[ruvnet]

✅ @drupaljs/config — config factory/storage ported — tests: 57 pass

[ruvnet]

✅ @drupaljs/render — render arrays/renderer ported — tests: 48 pass

[ruvnet]

✅ @drupaljs/util — utility helpers ported — tests: 109 pass

Ported Drupal\Component\Utility helpers to TypeScript (TDD-London, Vitest) under port/packages/util:

• NestedArray: getValue/setValue/unsetValue/keyExists/mergeDeep/mergeDeepArray/filter
• UrlHelper: buildQuery/filterQueryParameters/parse/encodePath/isExternal/stripDangerousProtocols/filterBadProtocol/isValid/get+setAllowedProtocols
• Tags: explode/encode/implode
• Bytes: toNumber/validate/format
• SortArray: sortByWeight{Element,Property}/sortByTitle{Element,Property}/sortByKey{Int,String}/sortByKeyRecursive
• Random: string/name/machineName/word/object/sentences/paragraphs
• Unicode: ucfirst/lcfirst/ucwords/truncate/truncateBytes/strcasecmp/validateUtf8/encodingFromBOM
• Html: escape/decodeEntities/cleanCssIdentifier/getClass/getId/getUniqueId + pluggable filter() via the HtmlFilter interface with a minimal TS FallbackHtmlFilter and TODO(#38) to swap in the Rust/WASM xss-html crate (ADR-0015).

109/109 Vitest specs pass; tsc --noEmit clean under strict base config. Only files under packages/util touched (ADR-0017).

[ruvnet]

🦀 drupaljs-xss-html (WASM) — XSS/HTML filter automaton — cargo tests: 86 pass

[ruvnet]

✅ @drupaljs/routing — routing/url-generator ported — tests: 55 pass

[ruvnet]

✅ @drupaljs/cache — cache backend + tags/contexts ported — tests: 64 pass