KofTwentyTwo/Jarvis
2
0 Fork 0
Code Issues 111 Pull Requests 16 Actions Packages Projects Releases 4 Wiki Activity

M-0: scaffold packages/JarvisAPI/ package skeleton (types only, no conformers) #90

New Issue
Open
opened 2026-05-12 19:36:35 +00:00 by KofTwentyTwo · 0 comments
KofTwentyTwo commented 2026-05-12 19:36:35 +00:00 (Migrated from github.com)
Copy link
Copy source

Goal

Scaffold packages/JarvisAPI/ as a types-only package (protocols, structs, enums) with no conformers and no call sites in App/.

Scope

  • New SPM package packages/JarvisAPI/
  • Source layout: Sources/JarvisAPI/{Surfaces,Commands,Events,Queries,Errors}.swift, JarvisHost.swift
  • Typed JarvisHost.boot() async -> Result<JarvisHost, BootError> per OQ-T6
  • NO conformers; NO imports from App/

Files

  • packages/JarvisAPI/Package.swift (new)
  • packages/JarvisAPI/Sources/JarvisAPI/Surfaces.swift (new)
  • packages/JarvisAPI/Sources/JarvisAPI/Commands.swift (new)
  • packages/JarvisAPI/Sources/JarvisAPI/Events.swift (new)
  • packages/JarvisAPI/Sources/JarvisAPI/Queries.swift (new)
  • packages/JarvisAPI/Sources/JarvisAPI/Errors.swift (new)
  • packages/JarvisAPI/Sources/JarvisAPI/JarvisHost.swift (new)

Acceptance

  • swift test --package-path packages/JarvisAPI green (types compile)
  • No import JarvisAPI in App/ yet
  • All Surface protocols defined with empty method bodies (fatalError) or default implementations

Test

swift build --package-path packages/JarvisAPI succeeds; swift test --package-path packages/JarvisAPI runs (empty suite ok).

Parent epic

#4

Source

.planning/architecture/JARVIS-API-MIGRATION-PLAN.md §2.1 (M-0.1)
.planning/architecture/JARVIS-API-DESIGN-v0.1.md (all surface defs)

## Goal Scaffold packages/JarvisAPI/ as a types-only package (protocols, structs, enums) with no conformers and no call sites in App/. ## Scope - New SPM package `packages/JarvisAPI/` - Source layout: `Sources/JarvisAPI/{Surfaces,Commands,Events,Queries,Errors}.swift`, `JarvisHost.swift` - Typed `JarvisHost.boot() async -> Result<JarvisHost, BootError>` per OQ-T6 - NO conformers; NO imports from App/ ## Files - `packages/JarvisAPI/Package.swift` (new) - `packages/JarvisAPI/Sources/JarvisAPI/Surfaces.swift` (new) - `packages/JarvisAPI/Sources/JarvisAPI/Commands.swift` (new) - `packages/JarvisAPI/Sources/JarvisAPI/Events.swift` (new) - `packages/JarvisAPI/Sources/JarvisAPI/Queries.swift` (new) - `packages/JarvisAPI/Sources/JarvisAPI/Errors.swift` (new) - `packages/JarvisAPI/Sources/JarvisAPI/JarvisHost.swift` (new) ## Acceptance - [ ] `swift test --package-path packages/JarvisAPI` green (types compile) - [ ] No `import JarvisAPI` in `App/` yet - [ ] All Surface protocols defined with empty method bodies (`fatalError`) or default implementations ## Test `swift build --package-path packages/JarvisAPI` succeeds; `swift test --package-path packages/JarvisAPI` runs (empty suite ok). ## Parent epic #4 ## Source `.planning/architecture/JARVIS-API-MIGRATION-PLAN.md` §2.1 (M-0.1) `.planning/architecture/JARVIS-API-DESIGN-v0.1.md` (all surface defs)
Sign in to join this conversation.
No Branch/Tag Specified
Labels
Clear labels
area:agent
area:build
area:bus
area:devtool
area:hud
area:logging
area:mcp
area:memory
area:vision
area:voice
audit-finding
bug
Something isn't working
 carry-forward
comment-cleanup
Comment / docstring cleanup per .planning/code-commenting-guide.md
 dependencies
Dependency updates
 documentation
Improvements or additions to documentation
 duplicate
This issue or pull request already exists
 enhancement
New feature or request
 epic
good first issue
Good for newcomers
 help wanted
Extra attention is needed
 invalid
This doesn't seem right
 javascript
Pull requests that update javascript code
 migration
question
Further information is requested
 severity:critical
severity:high
severity:low
severity:medium
wontfix
This will not be worked on
No labels area:build enhancement migration
Milestone
No items
No Milestone v0.5 — API M-0..M-3 (Self / Settings / Diagnostics surfaces)
Projects
Clear projects
No projects
Assignees
Clear assignees
forge-recovery (Forge Recovery) james.maes (James Maes)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: KofTwentyTwo/Jarvis#90