Team session: PTWeb and PTAgenda

Summit priority (freeze 16:00 UTC): head d310767 is in split/rc 75203d5 (conductor's full run). Done: App Review fixes, NowModel (with NOW-M-1/2), PICK, My program (PROG-1), -PTSeedPicks, AgendaClock, agenda opens on today. Not yet seen compiled: everything after run 364 was cancelled or superseded; rc is the first run to cover it.

Branch: split/team (merged origin/dev b845004, phase 1 + vault) · Updated: 8 Nov, 12:25 UTC

Account B notes (8 Nov, about 01:50 UTC)

• Merged origin/dev (docs only). Run 293 on 6cccf88 stays queued: six runs are ahead of it, and a push now would send it to the back, so I made no Swift change yet.
• Read by eye, no compiler: PTWeb (all of Bridge/, WebPage, BridgeServices, public inits, PTCore symbols it uses) and the PTAgenda seams, ReminderPlan, AgendaBridgeServices, ReaderStore head. All types are public or private as needed; PTCore has every symbol used (Lisbon, HTTPLog, KindBadge, Palette). Nothing to fix before the first compile.
• One behaviour bug to fix with the AppLinks.scheme change: ReminderDelegate (ReminderScheduler.swift) only accepts promptugal links, so a Team (ptteam) reminder tap is dropped. It will check AppLinks.scheme.
• AppLinks is not on dev yet (platform ce3602e, run 292 queued).

• 02:20 UTC: Run 293 failed (cancelled by the conductor after the Debug build, iPhone and iPad tests, PTWeb and PTAsk failed). The log has one real error, twice: BridgeScripts.swift used ScheduleDocument.storageKey and .changeEvent, and PTWeb cannot see PTAgenda. PTWeb now owns both strings (BridgeScripts.scheduleKey, scheduleChangeEvent) and ScheduleDocument reads them. PTAsk failed through PTWeb, so the same fix should clear it. ReminderDelegate now accepts promptugal and ptteam links. Pushed as 115ba30; run 296 (app=all) queued. PTAgenda itself has not compiled yet.

• 03:20 UTC: 17a160c merged to dev as 7863ae2. Follow-up on top of dev eb99508: ReminderPlan, ReminderItem and ReminderScheduler take their scheme from AppLinks.scheme (read when scheduling, so launch order does not matter), ReminderDelegate accepts only the app's own scheme, and TeamFeatures.urlScheme is gone. AppReviewTests: StoreKit product load bounded to 15 s, then the known issue is recorded. Not yet compiled.

• 04:15 UTC: Run 313 (macos-26, app=all) on 3899bb1 green, all 15 jobs. READY sent to the conductor.

• 07:15 UTC, phase 4 review: Read platform's plan against my folders and sent platform and the conductor the findings: module rename breaks 10 @testable import PrompTugal files; InfoPlistTests expects the old BGTask ids; NowNext is not in PTAgenda yet, so the Team project must keep the Shared group and NowNextPublisher (or I delete the publisher calls); design's AppShell.swift:97 must compare with AppLinks.scheme. My own fixes are on split/team (dcca18e, not CI-tested): ReadingCreditView link from AppLinks.open, StoreKit file found in either layout, reminder tests pass their scheme. Waiting for platform's move to review it.

• 07:25 UTC, NowNext moved (conductor ruling): Shared/NowNext.swift is now Packages/PTAgenda/Sources/PTAgenda/NowNext.swift (public NowNextSnapshot, SharedContainer, LisbonClock), App/NowNextPublisher.swift is Packages/PTAgenda/Sources/PTAgenda/NowNextPublisher.swift (public, no team dependency), and NowNextTests.swift is in Packages/PTAgenda/Tests/PTAgendaTests/. SharedContainer.appGroup is now a settable static (default group.news.promptugal.reader; an app with its own group sets it at launch). The widget and intents sources (PrompTugalWidgets/, PrompTugalIntents/) now need import PTAgenda, and their targets must link PTAgenda: platform and apps. Not CI-tested.

• 11:00 UTC, round 2 (contracts §8): native Team screens. All in Apps/Team/Sources/Team/, read through TeamStore from the team site's public data, kept on the device, web page one tap away.
• TeamStandupAgenda.swift (parsers), StandupsView.swift (StandupsView, StandupDetailView, items): list with open counts, agenda by kind, "only items for me", briefings.
• MyCommandCentreView.swift (MyCommandCentreView, CentreIssuesView): decisions, issues with filters, workstreams, agents, activity, messages, sessions.
• TeamPage.swift, TeamPageView.swift: any twin page as native blocks (reports, board health, pulse summary); ReportsView, WakesView, PulseView.
• TeamStore: standupSummaries, agendas, pages, refreshAgenda(slot:), refreshPage(_:), validated paths, offline cache. Tests: Apps/Team/Tests/TeamNativeTests.swift.
• Not registered: design owns Shell/Destinations.swift. Entries to add once green: team.commandcentre → MyCommandCentreView() (kind native), team.standups → StandupsView(), agents.reports → ReportsView(), agents.wakes → WakesView(), briefings.pulse → PulseView(), briefings.board → TeamPageView(path: "board-health", title: "Board health").
• PTNowNext (conductor request): Packages/PTNowNext (no dependencies) holds NowNextSnapshot, SharedContainer, LisbonClock; PTAgenda depends on it and re-exports it; NowNextPublisher stays in PTAgenda. In apps.json and the workspace. Exception to the project-ownership rule, approved by the conductor: I added a reference-only XCLocalSwiftPackageReference for ../../Packages/PTNowNext to Apps/Team/Team.xcodeproj (platform told). PrompTugal.xcodeproj is apps': its reference and the widgets and intents product links come with their merge.

• 11:30 UTC, summit app (summit-app-store brief): conductor paused Team-native; my job is PTAgenda for participants.
• NowBoard (Packages/PTAgenda/Sources/PTAgenda/Schedule/NowBoard.swift): NowBoard.snapshot(agenda:picks:now:) gives venue now/next, my now/next (a day ahead), clashes among my picks (DayPlanner.clashes(in:), extracted from the planner), per-stage now/next, and the summit phase (noAgenda, before, live, between, ended). My program is built from the picks' own event copies, so it shows even before the agenda loads. ReaderStore.nowBoard(at:) feeds it from the screen's one-minute timeline.
• Offline agenda: AgendaHub.seedAgenda (the app sets it from the core pack at launch) is read when nothing is cached; ReaderStore.agendaSource (none, seed, cache, network) and agendaUpdated say where the agenda came from, for "synced 3 min ago".
• Reminders already work for picks with no team (ReminderScheduler(team: nil, identity: nil)); clashes already feed the planner. Tests: NowBoardTests, NowNextSnapshotTests (PTNowNext).
• Waiting for: ux's spec with screen ids. Needs from apps: PrompTugal.xcodeproj reference for PTNowNext and the widgets/intents links; from collab: set AgendaHub.seedAgenda from the core pack.

• 12:25 UTC, summit app (PTAgenda, all on split/team, uncompiled until rc reports):
• NowModel (Schedule/NowModel.swift, pure): phase, For you (with clash flag), On now, Up next, Tomorrow, countdown, first items. NOW-M-1: first items are the first registration and the first summit item (Opening Night); NOW-M-2: registration never takes an On now, Up next or Tomorrow slot. ReaderStore.nowModel(at:) feeds it.
• PICK: PickRules, PickFeedback (toast, clash toast with View), PickStarButton(event:), .pickToasts(), NowNextRepublisher(schedule:). App wiring (design): .pickToasts() at the root, one ScheduleStore per app, PickStarButton on every session row.
• My program (PROG-1): ProgramModel (clash groups, free gaps of 30 min or more, day counts, defaultDay) and MyProgramView(chooseTalks:open:); needs ScheduleStore, ReminderScheduler and an optional PickFeedback in the environment. Route id team.schedule is kept.
• AgendaView(openSession:): the app's native session detail (deck's PTExplore detail, per the conductor). The agenda opens on today (Lisbon) during the summit.
• PickSeed / ScheduleStore.seedPicks(arguments:): DEBUG-only -PTSeedPicks, slugs or full ids. AgendaClock.override (set from -PTNow in DEBUG): the one clock of the agenda screens.
• App Review: PTAgenda text has no Web Summit trademark; WebsiteSources.resource selects WebsitesPublic.json (the public app sets it and removes the old shortcut asset).
• Waiting for: i18n's merge, then I switch my new strings to String(localized:bundle:.module); design's registration of the screens; rc results.

Handoff

Handed off at 01:35 UTC, 8 Nov, to the session on account B.

• Head: 6cccf88 on split/team (phase 3 moves for PTWeb and PTAgenda, on top of origin/dev 94b63c7).
• Last CI run: ios.yml run 293 (workflow_dispatch, app=all) on 6cccf88. It was still queued when I stopped. Result not seen. Read it first: actions_list for ios.yml, branch split/team.
• Done:
• PTWeb: Bridge/, WebPage, WebsiteView, WebsiteShortcuts, Websites.json (package resource, Bundle.module). Seams: WebBridgeHub (bridge, offlineReader, noteCurrentPage) and BridgeServices, BridgeMeterSource in Bridge/BridgeServices.swift.
• PTAgenda: Schedule/ (not ScheduleIntents.swift), Notifications/, AgendaView, ReaderStore (in News/). Seams in AgendaSources.swift: AgendaTeamSource, AgendaIdentitySource, VaultPicksAccess, AgendaHub, TeamStandup. AgendaBridgeServices is the adapter for the bridge.
• Team app glue: Team/TeamAgendaConformances.swift (conformances and VaultSessionPicks), Team/TeamFeatures.swift (registerHubs()).
• Tests moved: ScheduleTests and ReaderStoreTests to PTAgenda; WebsitesJSONTests and the bridge-gate / checkout tests (new BridgeGateTests.swift) to PTWeb.
• Both Package.swift files use swiftLanguageModes: [.v5], matching the app (SWIFT_VERSION 5.0). PTWeb has resources: [.process("Resources")].
• Half-done / unknown:
• Nothing has been compiled. Expect errors: I added public with a script (publicize.py, not in the repo) and generated public inits for structs without one. Likely misses: a missing public init, an @escaping, a private type in a public signature, an unimported symbol, a package test target that does not compile.
• Check also that the Xcode project still builds: the app target uses synchronized folders, so moved files drop out by themselves, but Websites.json and Shared/ are worth a look.
• Exact next steps: 1. Read run 293 (get_job_logs with failed_only). Fix, push, dispatch ios.yml again (app=all; pushes to split/** do not trigger it). 2. Switch the reminder URL scheme to AppLinks.scheme once PTCore has it on dev (platform, commit ce3602e on split/platform): merge origin/dev, then in Packages/PTAgenda/Sources/PTAgenda/Notifications/ReminderPlan.swift replace the default "promptugal" (ReminderItem.scheme, ReminderPlan.items(scheme:)) and in ReminderScheduler.init(urlScheme:) use AppLinks.scheme. Then TeamFeatures.urlScheme can go. 3. When green, run one full run (quick=false), then send_message "@parent" with branch, commit and run number: READY. 4. Shared/NowNext.swift stays until the widget target links PTAgenda (phase 4, platform). ScheduleIntents.swift stays in PrompTugal/Schedule/ until phase 4 (goes to the PrompTugal app).
• Open questions:
• Is swiftLanguageModes: [.v5] right for all packages? The other packages on dev do not set it.
• WebBridgeHub.noteCurrentPage is wired to CollabHooks.noteCurrentPage in TeamFeatures.registerHubs(). The public app needs its own wiring for Ask's "current page".
• The conductor asked for PTWeb alone first, so design's PTNews could merge it. It is in the same commit as PTAgenda. If PTAgenda keeps failing, split PTWeb out by reverting PTAgenda files in a separate branch.

State

• Done: read both briefs, mapped every type in the moving folders.
• In progress: this plan.
• Next: wait for "PTCore is on dev", then merge origin/dev and move.
• Blocked: nothing yet. Three questions below.
• Last CI run: none (no code changed).

What moves

NowNextPublisher.swift stays in App/ (platform). PrompTugalWidgets/NowNextWidget.swift also uses NowNext.swift, so the widget target must link PTAgenda (platform, phase 4).

Edges that point up or sideways, and how each is broken

PTWeb (may use only PTCore)

These sources can be one protocol (BridgeServices) if you prefer. I will use one protocol with five groups, so AppBridge.init takes one services: argument instead of five.

PTAgenda (may use PTCore and PTWeb)

Stays in the Team app (team owns)

TeamFeatures stays in Team/. It builds the stores, sets WebBridgeHub.bridge and AgendaHub, and conforms the stores to the new protocols. Today it also creates ScheduleStore, PlannerStore, ReminderScheduler, AppBridge: those become public with public inits.

Resources

• Websites.json moves to Packages/PTWeb/Sources/PTWeb/Resources/Websites.json, declared in Package.swift with resources: [.process("Resources")]. WebsiteShortcuts changes Bundle.main to Bundle.module.
• The injected JS is inline Swift strings in BridgeScripts.swift (no .js files). Nothing to bundle.
• WebsitesJSONTests reads Bundle.main. It moves to Packages/PTWeb/Tests and uses Bundle.module through @testable import PTWeb.
• Platform: remove Websites.json from the app's Resources build phase when its folder moves (phase 4, or when PTWeb lands).

Tests

Conductor's answers (8 Nov, 00:48 Lisbon)

1. JSON-level bridge. ScheduleDocument, ScheduleMerge, ScheduleID stay in PTAgenda.
2. Platform moves Event and FeedClient.site into PTCore in phase 2.
3. ScheduleIntents stays in the app target; in phase 4 it goes to the PrompTugal app. The Team app gets no intents tonight.
4. The public app gets a no-team AgendaTeamSource that returns nothing.

1. News/AgendaView.swift (204 lines) moves into PTAgenda. It reads ScheduleStore from the environment and uses .webTwin and FeedClient (PTCore / PTWeb). Design reviews it.
2. App/ReaderStore.swift (168 lines) moves into PTAgenda. Its TeamFeatures.shared.schedule and TeamFeatures.shared.agendaDidLoad become an injected schedule and an onAgendaLoaded closure. PTAgenda must not import PTNews; each app adds extension ReaderStore: NewsSource {}.
3. Reminder links take their URL scheme from the app (ptteam:// for Team, promptugal:// for the public app). ReminderPlan gets a scheme parameter instead of the hard-coded promptugal:// (line 28).

Waiting for phase 2 (PTCore on dev).

Questions for the conductor (answered above)

1. Schedule types across PTWeb and PTAgenda. The bridge reads and merges ScheduleDocument. I plan a JSON-level protocol so PTWeb does not know the type. The cheaper alternative is to put ScheduleDocument, ScheduleMerge and ScheduleID (pure Foundation value types) in PTCore. Which do you want? Default: JSON-level protocol, no PTCore change.
2. Event and FeedClient.site are in App/Content.swift. PTNews, PTAgenda and PTAsk all need Event. Is platform moving the Event struct (and FeedClient.site) to PTCore in phase 2? If not, I need it there.
3. App Intents in a package. ScheduleIntents.swift (SessionEntity, SessionQuery, intents) is an App Intents type. Intents in a Swift package need an AppIntentsPackage conformance and the app target to include it. Safer: keep ScheduleIntents.swift in the app target and move only the stores. I propose it goes to Apps/PrompTugal and Apps/Team (shared source, or platform decides). OK?

Also: Store/ and Team/ stay as they are, but Team/ must not be moved by anyone until TeamFeatures is updated by me in the same phase. I will edit Team/TeamFeatures.swift, Team/TeamStore.swift conformances and Store/ only for public/conformance lines.

Needs from others

• design or platform: Shell/AppShell.swift:97 accepts only url.scheme == "promptugal". When the Team app switches to ptteam (phase 4) it must compare with AppLinks.scheme, or reminder taps and deep links stop opening.

• platform: Event, FeedClient.site, Lisbon, HTTPClient public in PTCore (question 2). PTWeb and PTAgenda Package.swift with resources: for PTWeb.
• design: review WebPage.swift and WebsiteView.swift after the move (only public, import, and WebBridgeHub changes).