Roadmap

Project Roadmap

Our roadmap tracks the features and tools designed to help you work faster, collaborate seamlessly, and design without software bloat. We prioritize core system speed and asset accuracy first, ensuring your kitchen models load instantly and run perfectly.

In Progress

2 In Progress β–Ό
[CORE]
Sprint 5.05

Refactor Marketing Site IA for Command-First Identity (ADR-0033 Umbrella)

High-fidelity Terminal Hero and capability-based documentation flow per ADR-0006/ADR-0012.

SPEC_ID: #239
[TOOLING]
Sprint 5.05

Initialize Official Homebrew Tap (CLI tooling track, step 3 of 3; unblocked now that Issue #84 is complete)

Move distribution off the personal iamrichardd/homebrew-pkd tap to pharos-systems-llc/homebrew-pkd (org migration, Issue #325); automate Formula generation and release; update docs.

SPEC_ID: #85

To Do

16 Approved β–Ό
[IDENTITY]
Sprint 6.01

Domain-to-Org Mapping

Implementing secure domain validation for organizational onboarding.

SPEC_ID: #87
[CORE]
Sprint 6.01

Design Production Split boundaries

Decouple production infrastructure stages to isolate networking blocks.

SPEC_ID: #268
[UX]
Sprint 6.01

Enforce Reference Validation

Add runtime validators for Three.js layout elements.

SPEC_ID: #257
[UX]
Sprint 6.01

Standardize Web Components

Refactor custom layout components to strictly inherit standard bindings.

SPEC_ID: #256
[IDENTITY]
Sprint 6.01

Cryptographic signature validation

Implement runtime checks for search index binary signatures.

SPEC_ID: #253
[UX]
Sprint 6.01

Implement Info Cards

Build interactive hover metadata panels for Three.js canvas items.

SPEC_ID: #227
[IDENTITY]
Sprint 6.01

Purge Legacy SQLite modules

Remove dead sqlite libraries to decrease Tauri compile overhead.

SPEC_ID: #226
[CORE]
Sprint 6.01

Implement Vfs Trait & Storage Abstraction

Cross-platform Vfs trait in pkd-core supporting local disk (CLI) and OPFS/Cache API (Browser) for search index and dialect storage, per ADR-0057.

SPEC_ID: #225
[CORE]
Sprint 6.01

Decommission old AWS credentials

Purge vestigial IAM secrets from GitHub variables.

SPEC_ID: #212
[CORE]
Sprint 6.01

Purge vestigial auth routes

Deprecate endpoint routes bypassed by passkey auth.

SPEC_ID: #211
[PROTOCOL]
Sprint 6.01

Document BIM Standard

Publish comprehensive guide for manufacturer schema adherence.

SPEC_ID: #209
[IDENTITY]
Sprint 6.01

Remediate high vulnerability NPM packages

Patch devalue, fast-uri, and js-cookie vulnerabilities. Note: Astro >= 5.0.0 and happy-dom fixes are already completed.

SPEC_ID: #192
[CORE]
Sprint 6.01

Implement Rust unit tests for Dialects

Ensure True and Frymaster dialers have 100% logic test coverage.

SPEC_ID: #184
[UX]
Sprint 6.01

IKD Empowerment Hub UI

Build workspace interface for solo designers.

SPEC_ID: #144
[CORE]
Sprint 6.01

Shared Design Schema standardization

Re-align JSON dialect structures across Revit and Three.js.

SPEC_ID: #28
[PROTOCOL]
Sprint 6.01

Implement webMCP metrics endpoint to expose DORA and sprint telemetry

Implement /mcp/metrics route in apps/marketing using Astro endpoint handlers to serve JSON telemetry.

SPEC_ID: #278

Completed

61 Verified β–Ό
[CORE]
Sprint 5.05

Implement Stone 458.9 CLI Live Catalog Search and Remote Registry Client

Implemented pkd search --remote querying Cloudflare D1/Hyperdrive REST search endpoint with environment targeting (--env stage/prod), projection support, canonical RFC 2378 key-value output formatting, and comprehensive zero-host unit and live integration testing (PR #475). Verified 🟒 PHAROS GREEN.

SPEC_ID: #474
[CORE]
Sprint 5.05

Correct CLI Search Cache Guidance and Remove Non-Existent Sync Subcommand Hint

Replaced ghost pkd registry sync and unflagged bake hints with dedicated format_missing_index_guidance() providing working two-step recovery commands, and added atomic test guarding against regression (PR #455). Verified 🟒 PHAROS GREEN.

SPEC_ID: #454
[CORE]
Sprint 5.05

Refactor Schema Parameter Names to Remove Legacy PKD Prefix

Executed multi-stone refactor across schema, rust core, dialects, and truth engine. Stone 251.1 purged legacy PKD_ prefix from JSON schema definitions and rust core models (PR #452); Stone 251.3 aligned Hobart and True dialects, updated SQLite ingestion pipeline, and wired live search integration across CLI and web demo (PR #453). Verified 🟒 PHAROS GREEN.

SPEC_ID: #251
[IDENTITY]
Sprint 5.05

Audit Remediation: SRI Test Integration, SEO Metadata, and WASM JS-Bridge Verification

Chained verify-sri.sh into marketing test loop, implemented OpenGraph/Twitter Card metadata in BaseLayout.astro with fallback resolution, elevated WASM smoke test to active runtime execution via validate_metadata_wasm, hardened login.astro WebAuthn handlers with null guards and typed interfaces, decoupled localized date formatting in date.ts, and removed orphaned Containerfile.test (PR #446). Verified 🟒 PHAROS GREEN.

SPEC_ID: #42
[CORE]
Sprint 5.05

Configure Dual-Stream Release Pipeline

Implemented Admin Sharding release automation. Stone 84.1 added pkd-admin as a standalone Pulse slice (PR #444); Stone 84.2 added release.yml, Containerfile.release, and scripts/release.sh cross-compiling Windows pkd.exe via MinGW in Bookworm Podman with SHA-256 checksums (PR #445). Verified 🟒 PHAROS GREEN.

SPEC_ID: #84
[CORE]
Sprint 5.05

Develop Manufacturer Maintenance Sidecar (ADR-0033 Umbrella)

Extracted pkd admin functions into standalone pkd-admin crate and binary, migrating shared models to pharos-protocol and native auth/config to pkd-common across Stones 89.1-89.3 (PR #421). Verified 🟒 PHAROS GREEN.

SPEC_ID: #89
[CORE]
Sprint 5.05

Implement True Zero-Allocation JSON Parsing (WASM)

Implemented source-generated JSON parsers and ReadOnlySpan<byte> buffer processor to eliminate heap allocation overhead in Revit bridge (PR #440). Verified 🟒 PHAROS GREEN.

SPEC_ID: #185
[IDENTITY]
Sprint 5.05

Remediate Critical Security Vulnerabilities (Rust Core / Cargo)

Upgraded wasmtime to 49.0.4 neutralizing memory safety escape vectors, updated rustls-webpki to 0.103.16 hardening certificate validation, pruned unmaintained bincode and fxhash dependencies, and confirmed 0 active cargo audit vulnerabilities across 567 crates. Verified 🟒 PHAROS GREEN.

SPEC_ID: #193
[CORE]
Sprint 5.05

Sync ADR-0034 ECT Label into SESSION_CONTEXT.md During Worktree Provisioning

Implemented scripts/new-sibling.sh to query and stamp canonical ADR-0034 ECT labels during worktree creation, updated GEMINI.md paved road instructions, and verified rigor-verify.sh offline execution. Verified 🟒 PHAROS GREEN.

SPEC_ID: #414
[CORE]
Sprint 5.05

Filter Pulse Matrix Execution on Main for Documentation Updates and Audit Supply Chain Remediation

Mirrored paths allowlist under push trigger in pulse.yml to prevent doc-only commits from running the 3-shard release matrix on main. Bumped zstd-sys to 2.1.2 and configured .cargo/audit.toml with .dockerignore allowance to resolve upstream advisories. Verified 🟒 PHAROS GREEN.

SPEC_ID: #409
[PROTOCOL]
Sprint 5.05

Codify Edge-Routed Catalog Architecture and Reconcile ADRs

Formally drafted ADR-0074 for edge-routed multi-realm registry, amended ADR-0070 and ADR-0026 for Cloudflare LLC consolidation, ratified ADR-0073 peer messaging, and updated uat.yml path filters. Verified 🟒 PHAROS GREEN.

SPEC_ID: #407
[CORE]
Sprint 5.05

Resolve Production Auth Endpoint Resolution and Error Masking

Implemented environment-aware auth URL resolver config helper in protocol package, URL path prefix rewrite middleware, and secure database error masking in router fetch handlers. Verified 🟒 PHAROS GREEN.

SPEC_ID: #317
[CORE]
Sprint 5.05

Resolve Mobile Navigation Horizontal Overflow

Implemented responsive header navigation and mobile toggle drawer matching the voidzero.dev pattern, and enabled hybrid touch/hover prefetching. Verified 🟒 PHAROS GREEN.

SPEC_ID: #312
[CORE]
Sprint 5.05

Refactor Navigation Layout and Naming Taxonomy

Reorganized header page links to standard terminology (Guide, Reference, Blog, About) using a config-driven array layout. Verified 🟒 PHAROS GREEN.

SPEC_ID: #313
[CORE]
Sprint 5.05

Implement Dynamic Login and Settings Navigation Link

Developed client-side <pharos-nav-auth> Custom Element, SessionManager in shared @pkd/protocol, settings profile maturation form with non-prefixed localStorage key persistence, and a localized 30-day trial countdown. Unified layout titles with compact <PageHeader> component and reordered roadmap with collapse toggles. Verified 🟒 PHAROS GREEN.

SPEC_ID: #311
[CORE]
Sprint 5.05

Implement Progressive Dynamic Imports for ThreeJS Component in Marketing & Demo Slices

Resolved esbuild deprecation warnings by pinning @astrojs/react to v6.0.1 (upgrading Vite compile target) and implementing esbuild cleanup pre-plugins, decoupled WebGL dependencies into lazy-loaded ThreeCanvas chunks, and refactored dynamic loading spinners to utility css rules. Verified 🟒 PHAROS GREEN.

SPEC_ID: #322
[CORE]
Sprint 5.04

Configure Production-Only CORS Rules for Cloudflare R2 Registry Storage

Enforced production-only origins and restricted allowed headers to Content-Type and Range to minimize attack surface. Verified 🟒 PHAROS GREEN.

SPEC_ID: #275
[CORE]
Sprint 5.04

Integrate cargo-machete into pulse.sh

Pinned and installed cargo-machete v0.7.0 binary inside Podman build, automated unused dependency checks in pulse, and pruned 8 unused dependencies from workspace. Verified 🟒 PHAROS GREEN.

SPEC_ID: #274
[CORE]
Sprint 5.04

Add --registry-target Flags and Update Registry CLI Documentation

Added global --registry-target flag and environment variable to registry commands, relaxed output directory parameter to optional with fallback resolution, and added unit/integration tests. Verified 🟒 PHAROS GREEN.

SPEC_ID: #276
[CORE]
Sprint 5.04

Implement Local Disk Registry Serving with Path Guards in Vite Dev Server

Registered custom middleware in Astro/Vite configs to serve local indices with directory traversal and symlink checks. Verified 🟒 PHAROS GREEN.

SPEC_ID: #277
[CORE]
Sprint 5.04

Decouple Marketing and Demo Build Stages in Containerfile.ts

Decoupled the React demo compilation stage from the marketing build in Containerfile.ts to prevent demo compilation errors from blocking marketing site assembly. Verified 🟒 PHAROS GREEN.

SPEC_ID: #273
[CORE]
Sprint 5.04

Promote Search Index to Cloudflare R2 on Merge and Update CLI Push Guidance

Configured automated index baking in the core builder container and enabled Wrangler auto-promotion to the Cloudflare R2 registry bucket on merge. Refactored local CLI push stub to print professional guidance. Verified 🟒 PHAROS GREEN.

SPEC_ID: #271
[CORE]
Sprint 5.04

Deploy Search Index Binary to Correct CDN Key Prefix

Compiled search-index.bin JSON database in pkd registry bake and configured the pulse workflow to upload both files under the pharos-kitchen-design prefix to Cloudflare R2 CDN. Verified 🟒 PHAROS GREEN.

SPEC_ID: #300
[CORE]
Sprint 5.04

Expose Cloudflare Environment Secrets Dynamically in Pulse Workflow

Configured dynamic environment targeting for the sharded pulse job, exposing Cloudflare credentials on release builds to the main branch while shielding them on feature branch PRs. Added local verification test to capture workflow environment errors. Verified 🟒 PHAROS GREEN.

SPEC_ID: #306
[CORE]
Sprint 5.03

Provision Cloudflare R2 Registry Storage

Provisioned the R2 bucket for BIM Registry assets, bound `registry.iamrichardd.com` via `cloudflare_r2_custom_domain`, and upgraded the infrastructure slice to Cloudflare Provider v5.20.0 for compatibility. Verified 🟒 PHAROS GREEN.

SPEC_ID: #254
[CORE]
Sprint 5.03

Implement RFC-2378 OmniBar & Procedural Hover-Bake

Implemented Web Component command bar, unified wildcard search across workspaces, integrated real-time WebGL canvas, and verified input validation / ReDoS protections. Verified 🟒 PHAROS GREEN.

SPEC_ID: #242
[CORE]
Sprint 5.03

Connect Demo OmniBar to Production Search Index and Category Shards

Implemented R2 bucket fetch client in demo, integrated production index with WASM query engine, added lazy-loaded category shards, and added micro-animations with status panel. Verified 🟒 PHAROS GREEN.

SPEC_ID: #252
[CORE]
Sprint 5.03

Remediate CI Disk Exhaustion in Containerfile.bridge by Standardizing on Debian Base

Replaced the bloated sam build-dotnet8 base image in Containerfile.bridge with standard Debian Bookworm and installed dotnet-sdk-8.0 directly, resolving CI disk exhaustion. Verified 🟒 PHAROS GREEN.

SPEC_ID: #258
[CORE]
Sprint 5.03

Dependency Pruning

Audited and pruned pkd-core dependencies. Isolated native-only crates (dashmap, rayon) to native targets, significantly reducing WASM artifact size. Verified 🟒 PHAROS GREEN.

SPEC_ID: #107
[CORE]
Sprint 5.03

Resolve Demo Site Search Index Asset Pathing Mismatch

Decoupled registry base URLs, implemented custom RegistryLoadError, polished UI diagnostic copy, and added 404/403 failure test cases. Verified 🟒 PHAROS GREEN.

SPEC_ID: #267
[CORE]
Sprint 5.03

Refactor Deploy Site Workflow Trigger Paths

Added apps/demo/** to the on: push: paths: filter in deploy-site.yml to ensure demo site changes trigger redeployments. Verified 🟒 PHAROS GREEN.

SPEC_ID: #270
[PROTOCOL]
Sprint 5.02

Conclude Sprint 5.02 and Draft Friday Handoff

Reconciled Sprint 5.02 backlog, updated DORA metrics, drafted Friday handoff report, and prepared weekly update blog post. Verified 🟒 PHAROS GREEN.

SPEC_ID: #248
[TOOLING]
Sprint 5.02

Resolve Demo URL 404 Build Omission

Refactored Containerfile.ts to build and nest the Demo app, enforced React 19.0.0, and unified the React island for context sharing. Verified 🟒 PHAROS GREEN.

SPEC_ID: #235
[CORE]
Sprint 5.02

Remediate Rust Toolchain and Metadata Warnings

Centralized package metadata via workspace inheritance, resolved stylistic drifts, and removed dead code in `pkd-cli`. Verified 🟒 PHAROS GREEN.

SPEC_ID: #237
[IDENTITY]
Sprint 5.02

Remediate NPM Dependency Vulnerabilities

Updated Happy DOM and implemented dependency overrides to resolve critical RCE vulnerabilities. Verified workspace build integrity in Podman. Verified 🟒 PHAROS GREEN.

SPEC_ID: #238
[PROTOCOL]
Sprint 5.02

Remediate Roadmap Status Mapping Mismatch

Implemented section-aware 'Sentinel State Machine' in sync-roadmap.ts per ADR-0051. Verified 🟒 PHAROS GREEN.

SPEC_ID: #234
[PROTOCOL]
Sprint 5.02

Document GitHub Issue and Label Governance Standard

Codified ADR-0065 in GEMINI.md, establishing the Label Verification Gate and standardized Title/Body schema. Re-standardized the active backlog. Verified 🟒 PHAROS GREEN.

SPEC_ID: #236
[IDENTITY]
Sprint 5.02

Edge-Sovereign Onboarding & Recovery

Implemented the 'Zero-to-Hero' path for solo IKDs, including seamless registration pivots, cross-device hardware hooks, and a resilient Magic Link fallback with SPF/DKIM infrastructure. Verified 🟒 PHAROS GREEN.

SPEC_ID: #205
[IDENTITY]
Sprint 5.02

Implement Domain Allowlist in bless-sri.sh

Added origin verification to the blessing script to prevent accidental malicious blessing and hardened the Node.js bridge against shell injection.

SPEC_ID: #223
[CORE]
Sprint 5.02

Refine 'sed' targeting in bless-sri.sh

Tightened regex targeting to prevent cross-talk during SRI updates.

SPEC_ID: #222
[CORE]
Sprint 5.02

Standardize Pinned Toolchain Binaries and Optimize CI Space

Standardized wasm-pack and cargo-audit on pinned pre-compiled binaries with SHA-256 integrity checks. Optimized Cargo profiles and merged build stages to remediate CI disk exhaustion. Verified 🟒 PHAROS GREEN.

SPEC_ID: #246
[PROTOCOL]
Sprint 5.01

Authoritative Consent Gate for Upstream Scripts

Implemented the `bless-sri.sh` workflow and ADR-0053 to prevent build-killing SRI failures.

SPEC_ID: #220
[PROTOCOL]
Sprint 5.01

Backlog Restructure for Multi-Sprint Roadmap Synchronization

Reorganized @TODO and @PROGRESS into explicit 'Active' and 'Future' pools, enabling machine-readable roadmap swimlanes.

SPEC_ID: #218
[UX]
Sprint 5.01

Professional Grade Roadmap UI Refactor

Transformed the public roadmap into a segregated, searchable, and traceable tool.

SPEC_ID: #215
[PROTOCOL]
Sprint 5.01

Automated Roadmap Synchronization

Implemented the Sync Engine to automate roadmap updates from sharded logs.

SPEC_ID: #208
[PROTOCOL]
Sprint 5.01

Lossless Authoritative Log Restructure

Hardened @PROGRESS and @TODO into machine-readable DTOs for the Sync Engine.

SPEC_ID: #207
[IDENTITY]
Sprint 5.01

Identity Re-platforming

Migrated to sovereign Cloudflare D1-backed identity model with Passkey-First authentication.

SPEC_ID: #206
[CORE]
Sprint 5.01

TOON Diagnostics

Implemented line/column character tracking and snippet extraction for lexer errors.

SPEC_ID: #139
[PROTOCOL]
Sprint 5.01

Human-Centric Communication

Codified ADR-0048 for natural, first-person voice.

SPEC_ID: #199
[UX]
Sprint 5.01

Astro 6.4 Upgrade

Integrated SΓ€tteri Rust-based processor, achieving ~70.5% reduction in site build times.

SPEC_ID: #196
[CORE]
Sprint 5.01

Rust 1.96.0 Upgrade

Hardened toolchain with security betterments.

SPEC_ID: #195
[PROTOCOL]
Sprint 5.01

Monorepo Remediation

Restored compliance with ADR-0043/44/46 and implemented WASM panic isolation.

SPEC_ID: #194
[TOOLING]
Sprint 5.01

Build Warning Remediation

Resolved CI build warnings and hardened zero-warning sentinels.

SPEC_ID: #187
[CORE]
Sprint 5.01

Metadata Builder Pattern

Implemented `PharosMetadata::builder()` for safe object construction.

SPEC_ID: #148
[CORE]
Sprint 5.01

RFC-2378 Query Logic

Delivered full query logic and wildcard engine with 33 integration tests in Podman.

SPEC_ID: #138
[CORE]
Sprint 5.01

Relational Handle Mapping

Implemented O(n) linear parsing velocity for TOON handles.

SPEC_ID: #141
[TOOLING]
Sprint 5.01

PowerShell Remediation

Refactored install.ps1 to use native Invoke-WebRequest.

SPEC_ID: #162
[IDENTITY]
Sprint 4.11

Supply Chain Watchdog

Implemented immutable SHA-256 image pinning and automated dependency auditing.

SPEC_ID: #169
[BRIDGE]
Sprint 4.11

Zero-Allocation Marshalling

Delivered high-performance memory-safe marshalling for the Revit Bridge (ECT 4).

SPEC_ID: #123
[UX]
Sprint 4.11

Design System Alignment

Aligned the Marketing TOON loader with the Pharos Design System typography.

SPEC_ID: #175
[PROTOCOL]
Sprint 4.11

Automated Boundary Enforcement

Implemented ADR-0044 drift detection to ensure Rust/C# parity.

SPEC_ID: #168

Contribute to the Blueprint

PKD is built for the IKD community. Our roadmap is an open specification for the future of AEC data sovereignty.

Join the Development