update spec lists (#1800)

This commit is contained in:
Justin Hernandez
2026-03-02 06:41:34 -08:00
committed by GitHub
parent 9406bacda8
commit a18a5ab097
6 changed files with 35 additions and 27 deletions

View File

@@ -54,6 +54,7 @@ function findFiles(
'Pods',
'.gradle',
'vendor',
'assets',
].includes(item)
) {
traverse(fullPath);

13
specs/KMP-STATUS.md Normal file
View File

@@ -0,0 +1,13 @@
# KMP Status (At a Glance)
> Last updated: 2026-03-02
| Area | Spec | % Done |
| --- | --- | ---: |
| KMP Native Shells | `person2-native-shells` | 82% |
| MiniPay Integration Sample | `person3-integrations` | 70% |
| SDK Core (non-web follow-ups) | `person4-sdk-core` | 100% |
| RN Native Shell | `person5-rn-sdk` | 100% |
| Physical Device Validation | cross-spec | 25% |
| Packaging + Publishing | cross-spec | 35% |
| **Overall KMP Program** | `SDK-OVERVIEW` + `WAVE-PLAN` | **72%** |

View File

@@ -26,6 +26,7 @@ Specs double as AI agent prompts. Written in second person, sized for single con
| ------------------------------------ | ---------------------------------------------------------------------- | ------------------------------------------ |
| [SDK-OVERVIEW.md](./SDK-OVERVIEW.md) | Architecture, bridge protocol, module table, decision matrix, glossary | First. Always. |
| [WAVE-PLAN.md](./WAVE-PLAN.md) | Dependency-ordered execution plan for parallel agent work | When planning which chunks to execute next |
| [KMP-STATUS.md](./KMP-STATUS.md) | At-a-glance KMP completion percentages | When you need quick status only |
## Workstream Specs

View File

@@ -1,10 +1,10 @@
# Person 3: MiniPay Integration Sample — Implementation Spec
> Last updated: 2026-02-17
> Last updated: 2026-03-02
> Owner: Person 3 (Integrations)
> Parent: [OVERVIEW.md](./OVERVIEW.md)
> Project: [SDK-OVERVIEW.md](../SDK-OVERVIEW.md)
> Status: Draft
> Status: Active
## North Star
@@ -715,11 +715,11 @@ All three chunks are sequential — each builds on the previous.
| Chunk | Description | Size | Status |
| ----- | ------------------------------------------- | ----- | ----------- |
| 3A | Project Setup + Home Screen + Launch Button | M ~6k | **Pending** |
| 3B | Wire SelfSdk.launch() + Handle Callback | M ~5k | **Pending** |
| 3C | Polish Result Display + Error Handling | S ~4k | **Pending** |
| 3A | Project Setup + Home Screen + Launch Button | M ~6k | **Done** |
| 3B | Wire SelfSdk.launch() + Handle Callback | M ~5k | **Done** |
| 3C | Polish Result Display + Error Handling | S ~4k | **Partial** |
**Overall: 0% implemented.**
**Overall: Partial (implementation complete; physical-device NFC E2E remains).**
## Validation Plan

View File

@@ -1,6 +1,6 @@
# Person 4: SDK Core Adaptation — Implementation Spec
> Last updated: 2026-02-17
> Last updated: 2026-03-02
> Owner: Person 4 (SDK Core)
> Parent: [OVERVIEW.md](./OVERVIEW.md)
> Status: Active
@@ -667,7 +667,7 @@ Person 2 (KMP) ←── contract via ──→ Person 4 (lifecycle types)
## Completion Status
_Audit date: 2026-02-17_
_Audit date: 2026-03-02_
| Chunk | Description | Size | Status |
| ----- | ------------------------------------- | ----- | ------------------------------------------------------- |
@@ -676,21 +676,14 @@ _Audit date: 2026-02-17_
| 4C | WebView Lifecycle Events | S ~2k | **Done** |
| 4D | WsAdapter Integration | M ~5k | **Skipped** (optional — raw WebSocket works in browser) |
| 4E | Conditional SelfApp Store | S ~2k | **Done** |
| 4F | Web Fallback Adapter Implementations | M ~6k | **Pending** |
| 4F | Web Fallback Adapter Implementations | M ~6k | **Done** |
4 of 6 chunks complete. Chunk 4D explicitly optional. **Chunk 4F is the remaining work.**
5 of 6 chunks complete. Chunk 4D remains optional and skipped by design.
### What's Left
### Remaining Follow-Ups
**Chunk 4F — Web Fallback Adapters (blocking for WebView integration)**
| Adapter | File to Create | Implementation |
| ----------------------------------- | ----------------------------------- | ----------------------------------- |
| `createIndexedDBDocumentsAdapter()` | `src/adapters/browser/documents.ts` | IndexedDB with two object stores |
| `createWebCryptoAdapter()` | `src/adapters/browser/crypto.ts` | `crypto.subtle.digest` for `hash()` |
| `createWebAnalyticsAdapter()` | `src/adapters/browser/analytics.ts` | console + fetch fire-and-forget |
| `createNoOpHapticAdapter()` | `src/adapters/browser/haptic.ts` | Silent no-op |
| Barrel export | `src/adapters/browser/index.ts` | Re-exports all factories |
- Consolidate bridge-layer fallback duplicates with engine-owned adapters.
- Expose `generateKey()` / `getPublicKey()` in bridge crypto adapter surface.
**Implementation notes from PR review:**

View File

@@ -1,6 +1,6 @@
# RN Native Shell — Implementation Spec
> Last updated: 2026-02-17
> Last updated: 2026-03-02
> Owner: Person 5 (RN SDK)
> Parent: [OVERVIEW.md](./OVERVIEW.md)
> Status: Active
@@ -1026,16 +1026,16 @@ Chunk 5A (package + component + router + lifecycle) — no deps, start here
## Completion Status
_Audit date: 2026-02-17_
_Audit date: 2026-03-02_
| Chunk | Description | Size | Status |
| ----- | ------------------------------------------------------------------------------------- | ------ | ----------- |
| 5A | Package setup + `SelfVerification` shell + `MessageRouter` + `LifecycleHandler` | M ~8k | **Pending** |
| 5B | `BiometricHandler` + `KeychainHandler` | S ~4k | **Pending** |
| 5C | `NfcHandler` + `CameraHandler` (hardware-dependent, requires physical device testing) | L ~10k | **Pending** |
| 5D | Asset bundling (copy Vite output into `assets/`) + npm publishing config | M ~6k | **Pending** |
| 5A | Package setup + `SelfVerification` shell + `MessageRouter` + `LifecycleHandler` | M ~8k | **Done** |
| 5B | `BiometricHandler` + `KeychainHandler` | S ~4k | **Done** |
| 5C | `NfcHandler` + `CameraHandler` (hardware-dependent, requires physical device testing) | L ~10k | **Done** |
| 5D | Asset bundling (copy Vite output into `assets/`) + npm publishing config | M ~6k | **Done** |
**0% implemented. Spec ready for implementation.**
**Implementation chunks complete. Remaining work is integration validation + npm publish.**
## Validation Plan