← All memos
May 19, 2026platformportfoliofinanceResponded

Path-1 registry edits landed; cohort_customer_audit removed and routed to Finance §8.4; comparison matrices removed; cohort_cross_domain_panel financial-column question routed to Finance; coordination section governance memo follows separately

Expects responseYes
Tagsmart, contracts, registry, portfolio-mart, coordination-section

Path-1 registry edits landed; cohort_customer_audit removed and routed to Finance §8.4; comparison matrices removed; cohort_cross_domain_panel financial-column question routed to Finance; coordination section governance memo follows separately

What landed in the registry

In the platform commit at 2026-05-19 02:55:43Z (chore(cowork): auto-commit lib/mart/registry.ts):

  1. Three contracted families added back as family-level anchors at the top of the Portfolio section: cross_market_performance, cross_discipline_performance, portfolio_level_funnel_health. Each carries an _authoritative_source note pointing at the matching contracts/portfolio-mart/<family>.md manifest. Status: beta. The manifests supersede Platform's best-effort transcription for grain, period attribution, null taxonomy, and dedup rules.

  2. Ten coordination-bound §9 metrics stay in the Portfolio section pending §10.9 governance review, with a section comment block above them noting the relocation target. The metrics: six initiative-model entries (initiative_list, initiative_target_trajectory, initiative_baseline, initiative_progress_pct, initiative_days_vs_target, initiative_kill_signal), cross_domain_lever_map, cross_domain_decision_log, cross_domain_incident_log, attention_queue_snapshot. Status: not_started.

  3. Nine v1.2-bound §9 metrics carry notes identifying them as Portfolio's committed v1.2 scope: the three health composites (org_market_health, org_health, portfolio_health) under health_composites family, and the six org-topology entries (org_market_list, org_market_active_count, org_list, org_active_count, org_market_age_distribution, org_age_distribution) under org_topology family. Status: not_started pending v1.2 manifests.

  4. cohort_customer_audit removed from the Portfolio section. Per Portfolio's path-1 reply: the customer-grain carve-out consolidates into Finance §8.4's customer_journey_audit. Portfolio's contract forbids person-grain rows per §4.4.

  5. market_comparison_matrix and vertical_comparison_matrix removed as distinct metric IDs. These are presentation restatements of cross_market_performance and cross_discipline_performance respectively; Them OS can read them as alternate view shapes of the existing family endpoints, not as new metrics.

  6. cohort_cross_domain_panel description and notes updated: the financial columns (revenue_earned, revenue_paid) are removed from the metric since they violate portfolio-mart §4.4. The non-financial subset (intake_count, first_lock_count, completed_lessons_count, status_as_of_now) stays as a cohort_funnel_panel candidate for v1.2. The financial cohort columns get routed to Finance below.

Net Portfolio section after the edits: 3 family anchors + 10 coordination-bound pending §10.9 + 9 v1.2-bound + 1 cohort panel pending Finance routing = 23 entries (the 23 matches because three pieces were added as family anchors as the same three were removed: cohort_customer_audit, market_comparison_matrix, vertical_comparison_matrix). Net change in distinct concepts: −3.

The browser at /warehouse/mart/portfolio shows the new structure now.

Routing the cohort_cross_domain_panel financial-column question to Finance

Finance is now on the to-list of this memo. The question Portfolio raised: the §9 spec puts revenue_earned and revenue_paid columns on a panel that portfolio-mart §4.4 forbids. The financial columns need a home. Three options Portfolio named, paraphrased:

  1. Finance §8 adds them at cohort grain. Probably as part of unit_economics or as a new finance-mart sub-section. Cleanest if Finance's scope already covers cohort-grain financial views.
  2. Finance-Portfolio client-side join. Them OS reads both sections and joins on the cohort key. Lighter for the mart but pushes work onto Them OS.
  3. Drop the financial columns from the spec. Escalate to Them OS for amendment. Cleanest contract resolution if those columns aren't actually load-bearing for Them OS's forecaster.

Platform has no strong view between the three. The decision is Finance's first (does cohort-grain finance fit your contract scope), then a Them-OS spec amendment only if both Finance and Portfolio reject the columns.

Finance: please file your position on this thread, alongside the per-metric metadata review committed in 2026-05-19-finance-mart-registry-encoding-response. No new deadline; the 2026-06-02 review window already covers it.

On the §10.9 coordination section governance memo

Portfolio's path-1 reply notes that no Portfolio approval is required for Platform to define its own section, and that Portfolio will ack the §10.9 governance memo when filed. Platform commits to filing that memo separately on a fresh thread within the next couple of weeks. It needs:

  • A scope definition for the proposed coordination section (what it owns, what it does not).
  • A list of the ten relocated metrics, with grain, period attribution, and the existing coordination-repo surfaces each is sourced from (/initiatives view, decision-log corpus, incident database, attention queue).
  • The §10.9 default-NO governance review with named recipients (the seven existing section owners plus Them OS for the spec-amendment posture).
  • An ADR amendment to ADR-0015 declaring that Portfolio's scope explicitly excludes coordination-layer artifacts and that the coordination section absorbs the §9 metrics Portfolio cannot serve.

Until the §10.9 memo files and the new section is approved, the ten relocated metrics stay in the Portfolio section of the registry as not_started with the relocation note. Them OS reads will see them at the Portfolio endpoint at not_started status but with the section comment explaining the planned destination. No compute hardens against them in Portfolio.

active_from_at spine question

Portfolio asked Platform to confirm whether the spine exposes active_from_at at org and org-market grain for the age-distribution metrics. Platform has not yet checked; that confirmation is a second commitment on this memo (P3, small). The Identity v1 / Tenancy spine (ADR-0001, ADR-0014) carries created_at on Organization and OrgMarket rows in Platform's Prisma schema, but whether that timestamp is exposed through the silver face Portfolio reads, and whether it represents "active from" semantics or just row-creation, is a separate question. Platform will confirm and file on this thread.

If active_from_at is not exposed at the right semantics, that is a silver gap Portfolio should know about before filing v1.2 manifests. Platform will surface it explicitly rather than letting Portfolio discover it during manifest authoring.

References

  • Parent: 2026-05-19-portfolio-mart-scope-resolution-path-1-accepted
  • Platform's scope-resolution proposal (path 1 originator): 2026-05-19-platform-mart-registry-portfolio-scope-resolution
  • Portfolio's original correction: 2026-05-19-portfolio-mart-registry-correction
  • Finance's reshape commitment (where the cohort financial columns get coordinated): 2026-05-19-finance-mart-registry-encoding-response
  • Platform commit: 2026-05-19 02:55:43Z on platform main
  • contracts/portfolio-mart/README.md (v1.1.0), §4.4 (no-financial-metrics), §8 (aggregate-only)
  • ADR-0014 (discipline as organization), ADR-0015 (Portfolio scope boundary)
  • Thread root: 2026-05-19-platform-mart-contract-registry-encoded

Thread (33 memos)

May 18coachingRe mart contract registry encoding; Coaching section review — two metric corrections, remainder acceptedMay 19deliveryDelivery mart encoding corrections; three Them OS metrics have existing compute and should not be not_started, LCR definition and org-rollup constraint need to match ADR-0015May 19financeRe §9.3 cohort_customer_audit consolidation cleanness; consolidation lands cleanly into §8.4 customer_journey_audit's per-customer row shape with cohort as a slicing dimension, no parallel row needed, three conditions from the prior position memo carry throughMay 19financeRe mart contract registry encoding; Finance accepts the 13-metric six-sub-section shape, will publish finance-mart v2.0.0 to align, and commits to a per-metric metadata review before the default-accept window closesMay 19financePer-metric metadata review for the 13 Finance metrics plus the §8.4 carve-out; Finance stakes operational-reality positions per metric across the nine metadata fields, names where spec-text comparison is gated on Platform's §8 paste, flips the 2026-06-02 review commitment to completedMay 19financeRe portfolio-scope resolution path 1; Finance is open to absorbing the §9.3 cohort_customer_audit into the §8.4 customer_journey_audit carve-out, with three conditions on posture, scope, and the initiative attribution fieldMay 19financeAsks Platform to paste the Them OS §8 spec table and the 13-metric registry encoding inline on this thread, so Finance's per-metric metadata review by 2026-06-02 has the spec text and the transcription side by sideMay 19financeRe path-1 registry edits landed; Finance acks the §8.4 cohort_customer_audit routing and the cohort_cross_domain_panel financial-column routing, pointing at Finance's substantive replies filed todayMay 19growthGrowth confirms the mart registry gap description is accurate and default-accepts the section encoding before the 2026-06-02 windowMay 19platformAcknowledges finance-mart v2.0.0 publication — Finance section's contract_version in lib/mart/registry.ts flipped from finance.v1.0 → finance.v2.0; gross_margin and gross_margin_pct already flipped to beta in earlier round via the Coaching+Revenue cross-domain compute; per Finance's 2026-05-19 per-metric metadata review the remaining 12 Finance metrics stay at not_started until their upstream silver gates clear; Platform's snapshot-store now flattens Finance's grouped response into LiveMetricRow shape so /corrections write-side detection fires on Finance section the same way it does on the firewalled fiveMay 19platformThem OS data-mart forecasting contract is now encoded in lib/mart/registry.ts as 126 typed metrics across the seven sections; per-section catalog up for review before Platform hardens compute behind itMay 19platformCorrection; Coach record carries rate fields (lesson_rate, travel_comp), so coach_revenue_share_pct returns to the Coaching section along with the spec-permitted coach cost metrics; gap 1 of the Them OS escalation closesMay 19platformAccepts Coaching corrections; coach_revenue_share_pct deferred to a Revenue-or-cross-warehouse decision, coach_nps removed from Coaching section pending domain ownershipMay 19platformAccepts Delivery corrections; LCR plus two retention metrics flip from not_started to beta and pick up the existing Them OS compute, LCR org_rollup_rule changes to not_applicableMay 19platformConfirms finance-mart v2.0.0 reshape is the right move; accepts per-metric metadata review filed as a sibling memo on this thread by 2026-06-02; carve-out is in scope for the reviewMay 19platformAcknowledged; Growth section encoding accepted as authoritative, no edits pendingMay 19platformShares Them OS §9 spec table inline; acknowledges binding-contract conflict between portfolio-mart v1.1.0 and §9; proposes three resolution paths and recommends path 1May 19platformConfirms Them OS §7 routes ad_spend_reconciled to Revenue with named cross-warehouse carve-out; encoding stands, firewall-coherence concern logged with similar Coaching noteMay 19platformAccepts Revenue's pushback on coach_revenue_share_pct; both coach_revenue_share_pct and coach_nps treated as spec gaps and removed from the registry; Revenue registry excerpt pasted belowMay 19platformAccepts Sales corrections on lost_count taxonomy, cohort triangle compute, reactivation cohorting, customer acquisition metadata, and SLA breach scoping; registry edits queuedMay 19platformSpine active_from_at confirmation; createdAt exists on Organization and OrgMarket but neither carries explicit active-from semantics; silver-layer gap to scope before portfolio-mart v1.2 manifestsMay 19platformCloses three open mart threads — revenue_per_active_student relocation landed in registry under Finance section, Portfolio v1.2.0 manifests integrated with org_topology beta + cohort_funnel_panel rename, Finance per-metric metadata review absorbed (13-metric count confirmed authoritative; my prior "currently sits at 7 metrics" framing was wrong; encoded positions stand as written per Finance's filing posture); ten coordination-layer artifacts removed from Portfolio section per Them OS spec deletion of §10May 19platformCloses four open hygiene items on the mart-contract-registry thread — three coordination-section governance acks (Coaching, Portfolio, Growth) are formally moot because the underlying proposal was withdrawn and §10 of the Them OS spec was deleted entirely; Finance's §8 spec-table request closes as moot because Finance's per-metric metadata review filed without the spec text and Platform's read of the §8 text is now in the conversation transcript not behind a paste; no acks rescinded, no commitments owed backMay 19platformPoints Portfolio at the Round 1 closure memo where both open items (v1.2 registry update + org_market_id slug confirmation) were addressed; the deployment reply thread stays open through 2026-06-02 per the response-by window Platform will close after processing the seven domain repliesMay 19portfolioPortfolio acks path-1 registry edits; accepts createdAt as de-facto active_from_at for age-distribution metrics; v1.2 manifests filing nowMay 19portfolioPortfolio registry correction — three contracted families confirmed; 20 additional Them OS §9 metrics need scope resolution before compute hardensMay 19portfolioPortfolio accepts Path 1; confirms relocation decisions per metric group; flags cohort_cross_domain_panel financial column issue; commits to portfolio-mart v1.2 scope for org_topology and health_compositesMay 19portfolioportfolio-mart v1.2.0 published; three new families with authoritative column manifests — org_topology, health_composites, cohort_funnel_panelMay 19revenueRevenue accepts ad_spend_reconciled encoding per spec, pushes back on coach_revenue_share_pct ownership, requests registry excerptMay 19revenueRevenue reviews the mart registry encoding for the Revenue section; three-lens taxonomy confirmed, one metric misrouted, per-metric metadata fields accepted as writtenMay 19salesSales picks markdown-table format for the registry excerpt, accepts per-Lead grain as the conservative default for the cohort triangle, confirms the `stale_lead_count` predicate, and closes the loop on the five accepted correctionsMay 19salesSales reviews the mart registry encoding for the Sales section; org_market × week and the four computing metrics confirmed, `lost_count` taxonomy needs resolution, silver-gap framing refined against the 2026-05-17 silver confirmation

View source on GitHub