zapstore/spec/work/_TEMPLATE.md

WORK-XXX — Short Name

Feature: FEAT-XXX-short-name.md Status: In Progress | Complete

Tasks

• 1. Task description
  • Files: lib/path/to/file.dart
  • Notes: any relevant context
• 2. Task description
• 3. Handle edge cases per spec
• 4. Self-review against INVARIANTS.md

Test Coverage

Scenario	Expected	Status
Happy path	Describe expected behavior	[ ]
Edge case: network failure	Graceful degradation	[ ]
Edge case: cancellation	Clean cleanup	[ ]

Decisions

YYYY-MM-DD — Decision title

Context: Why this decision came up. Options: A, B, C considered. Decision: Chosen option. Rationale: Why.

Spec Issues

Report blockers here instead of guessing. Format:

• Issue: Description of unclear/incorrect spec
• Question: What clarification is needed

Progress Notes

Brief updates as work proceeds.

On Merge

Delete this work packet. If any decision here is non-obvious and worth remembering, promote it to spec/knowledge/DEC-XXX-short-title.md first.

---

Example: WORK-002 — NWC Zaps

Feature: FEAT-002-nwc-zaps.md Status: In Progress

Tasks

• 1. Add nwc_wallet package dependency
• 2. Create NwcService in lib/services/
  • Files: lib/services/nwc_service.dart
  • Stores connection string in SecureStorageService
• 3. Add NWC settings UI in profile screen
  • Files: lib/screens/profile_screen.dart, lib/widgets/nwc_widgets.dart
• 4. Create ZapButton widget
  • Files: lib/widgets/zap_button.dart
• 5. Create ZapDialog for amount selection
• 6. Integrate into AppDetailScreen
• 7. Implement zap request flow (kind 9734)
• 8. Self-review against INVARIANTS.md

Test Coverage

Scenario	Expected	Status
Connect valid NWC	Connection saved, status updated	[x]
Connect invalid NWC	Error shown, nothing saved	[x]
Zap with sufficient balance	Success toast	[ ]
Zap with insufficient balance	Wallet error shown	[ ]
Developer has no LN address	Button disabled with tooltip	[ ]

Decisions

2026-01-15 — NWC string storage

Context: Need to persist NWC connection string securely. Options: New encrypted file, SecureStorageService, Nostr event. Decision: SecureStorageService. Rationale: Already used for nsec, platform-native secure storage.

Spec Issues

None

Progress Notes

2026-01-15: Completed NWC connection flow. Reused SecureStorageService. 2026-01-17: ZapButton done. Added edge case for missing LN address to test matrix.