Files

T

rzen 0bec9a6be5 Collapse the edition split — one app, Pro as a subscription

2026-07-30 design pass (with the user), superseding the 2026-07-27
two-app split and the 2026-07-29 App Group ruling. Rulings:

- One Mac App Store app (dev.rzen.indie.Kanban, free, 2.0 updates the
  existing record); Lanework Pro = auto-renewable subscription (StoreKit
  2) unlocking the git tier; libgit2 compiles in dormant. The KanbanPro
  target, module-alias tests, verify-editions, UTI/About/Types twins all
  retire. Teams stays deferred — probably a separate app, and never on a
  shared app group.
- No grandfathering: 1.x's free git users get the inert-.git posture;
  unsubscribed and lapsed are one state — histories freeze, resume on
  subscribe via the committer's catch-up commit.
- Entitlement = local read of StoreKit's signed transaction store at
  board-session composition; never a network call on the open path;
  subscribe effective at next open (purchase flow offers reopen); lapse
  never interrupts an open session; expiry-while-offline with auto-renew
  on holds in grace until a real refresh.
- App Group removed wholesale: registry, clipboard staging, template
  store, defaults return to ordinary Application Support; grant slots
  collapse to one bookmark, open-now to one flag; freshness stamp,
  pid-liveness line, group-id provisioning risk all dissolve.
- Quiet signposts carry over; Settings gains the Pro section (subscribe/
  manage/restore) as the third named Pro surface.

12-editions.md rewritten as the tiers doc; edition vocabulary swept to
tiers across 00-13, README, WISHLIST.

Claude-Session: https://claude.ai/code/session_01CqjXB7ASoWtbyoGod68k97

2026-07-30 15:04:09 -04:00

3.5 KiB

Raw Blame History

Lanework — Design Documents

A ground-up rewrite of the Kanban app, to ship as Lanework on the Mac App Store. The old repo (../../Kanban, one level above this repository — not the rewrite's own Kanban/ source folder, which shares the codename) was a pathfinder — it never shipped, but it is the reference implementation and the source of hard-won decisions. This design starts from a clean slate and keeps only what earned its place. The rewrite keeps the internal codename Kanban (bundle id dev.rzen.indie.Kanban).

Each document covers one aspect of the design. Within each:

Decisions — settled, either carried over from the old app or newly made.
Changes from Kanban — where this rewrite deliberately diverges.
Open questions — flagged for iteration; nothing here is implicitly settled.

Index

Doc	Aspect
00-vision.md	What Lanework is, who it's for, goals and non-goals
01-storage-format.md	On-disk contract: folders, frontmatter, ordering, the materialized trash
02-architecture.md	App structure: source of truth, stores, watchers, concurrency
03-board-ui.md	Board window: layout, lanes, cards, styling, templates
04-interactions.md	Selection, drag & drop, keyboard, clipboard, search
05-card-window.md	The card window: Markdown preview/edit, attachments
06-history-undo.md	Git-backed undo/redo and history — Pro tier
07-sync-collab.md	Board modes: local-only, git; iCloud Drive warned against — Pro tier
08-agent-integration.md	AI agents as first-class users of the board
09-templates.md	Board templates: inventory and definition format
10-accessibility.md	VoiceOver, text scaling, visual accommodations
11-command-nexus.md	The command Nexus — every command and action: bindings, contexts, customizability
12-editions.md	The tiers (free / Pro subscription / Teams deferred): one-app distribution, entitlement, provider seam, feature matrix
13-native-undo.md	macOS-native undo/redo — the free tier's history substrate

Deferred design iterations

The card window (05-card-window.md), toolbar (03-board-ui.md ▸ Toolbar), styling controls (03-board-ui.md ▸ Styling ▸ Controls), and comments (01 ▸ Enhanced schema + 05 ▸ The comments column — designed 2026-07-29, shipping post-2.0) each had their focused pass and are settled.

The authoritative list of open design passes is the findings board (Lanework Redesign.kanban ▸ Issues to Resolve) — this section stopped enumerating by hand after drifting twice. Standing examples as of 2026-07-29: the attachment-undo staging design and the EchoLedger foreign-undo bridge (both flagged in 13-native-undo.md), Teams' tracker integration (no design yet), the fail-fast decision surface (01 ▸ Refuse), and the drop-release settle presentation (03 ▸ Motion — deliberately last in line).

Wishlist

Ideas worth keeping but outside the committed design live in ../WISHLIST.md.

Terminology

The rewrite adopts lane as the canonical term for what the old app called a column (it's in the name: Lane-work). "Column" survives only when referring to the old app or to interior card-grid columns inside a wide lane.

3.5 KiB Raw Blame History