GFS Platform · Round 583 · Live

GFS Operating Flow Diagrams

The flow charts plus wiki for how every part of the platform works. 91 diagrams spanning workflows, runtime substrate, system contracts, job-pillar admin, data pipelines, and wall-poster canvases.

91
Diagrams
22
Workflow contracts v2
162
D1 tables mirrored
31
Cron triggers · 11 bands
3,360
Knowledge chunks indexed
50
Chat tools registered

Workflows

22 contracts · AI-proposes, admin-approves

Substrate-detected anomaly (margin, AR, ops) → triage → propose action → HITL queue.

contractrisk 2+ graph

Inbound new account → credit check → NS customer record → tier assignment → kickoff comms.

contractrisk 3+ graph

Workflow Graphs

27 standalone archify renders · open inline

Substrate

4 diagrams · the runtime under every workflow

executeWorkflowContract — the one entrypoint that runs every v2 contract end-to-end.

REALruntime

events + drainEvents — append-only CDC + subscriber drain across the platform.

REALledger

proposed_actions state machine — every AI write parks here before NS push.

REALstate machine

Leading-indicator scoring — AR, order cadence, sentiment, margin → risk score.

REALscoring

System

14 diagrams · intake / memory / chat / lifecycle / security / cost / lineage / NS

Every entry point — email, chat, upload, webhook — routes through one workflow runner.

REALintake

3,360 knowledge chunks + decision corpus — what AI remembers and how curation works.

REAL3,360 chunks

Driscoll's journey end-to-end — discovery → first PO → health scoring → growth.

REALcase study

Where the money actually goes — every CF, AI, and NS dollar attributed.

REAL$

From NetSuite to a chat answer — every hop, transform, and cache traced.

REALlineage

124+ products → template → PDF · 8 brand themes · D1 spec_items mirror.

REALpipeline

Canonical bid example — NYC DOE B5875, intake → submission → award.

REALcase study

Every HITL-approved write lands in NS_PUSH_QUEUE → drainer reconciles to NetSuite.

REALqueue

Work-order create → release → build → assemble → close · the NS shopfloor state path.

REALNS WO

Assembly build mechanics inside NetSuite — BOM consume, finished-goods receipt, costing.

REALNS build

Pillars

7 job pillars + 4 legacy admin flows

AR, AP, GL, margin reporting, dunning, statements — finance pillar daily flow.

pillarjob 1/7

Spec sheets, allergens, USDA child-nutrition labels, K-12 menu validation.

pillarjob 2/7

Pricing cascade — vendor cost in, customer prices out · all 6 tiers traced.

pillarjob 3/7

B5875 + every K-12 + USDA bid · intake, eligibility, submission, award.

pillarjob 4/7

SO intake → pick/pack → ship → invoice · the order-to-cash backbone.

pillarjob 5/7

Customer + vendor contacts, segmentation, touchpoint cadence, sentiment.

pillarjob 6/7

281 NS reports · the analytical surface every other pillar leans on.

pillarjob 7/7

Pipelines

10 diagrams · long-running plumbing

Email + upload + form → parse → enqueue → route. The front door for inbound work.

REALintake

Frontend → council → tool calls → auto-context → answer. The full chat stack.

REALchat

NS → D1 tiered sync · 2/5/60-min bands · 14+ tables live · 311K+ rows mirrored.

REAL14 tables

proposed_actions → admin review → ns_push_queue → drainer → NS. The write path.

REALwriteback

SO → fulfillment → invoice → payment. The full order revenue cycle.

mixedO2C

31 cron triggers in 11 bands — sync, drainers, audits, decay, rollups.

REAL31 triggers

Canvases

4 wall-poster overviews · everything at once

Workers · D1 · R2 · KV · Queues · Workflows · DOs · Email · Browser · Pages · all in one frame.

canvasCF

Wiki

How to read these diagrams · operating conventions

Wiki · AR aging action plan

Plain-English walkthrough of the AR collections workflow. Bucket thresholds, escalation ladder, dunning copy, hold criteria, and the comms record trail.

guide · risk 3

Wiki · Bid price update

Plain-English deep-dive on the canonical bid-price recompute workflow. Triggers, lanes, side effects, HITL gates, and edge cases all walked through.

guide · risk 3 · 2 parts

Wiki · Customer quote

How an inbound quote request becomes an HTML quote. Pricing cascade hops, tier mapping, terms boilerplate, and approve-before-send invariants explained.

guide · risk 3

Wiki · Vendor cost update

Vendor sends a cost change · what changes downstream. Item map, blast radius, recompute order, and which prices auto-propose vs require fresh approval.

guide · risk 3

What is a workflow contract?

A v2 workflow is a typed JSON contract executed by the substrate runner. Inputs, lanes, tools, side effects, and HITL gates are all declared up front — no free-form prose, no surprises.

22 contracts · src/index.ts · v2 schema

What's a lane?

Lanes are vertical swimlanes in each diagram. They map to the actor (Customer · AI · Admin · NS · Folder · D1) so you can see at a glance who does what at each step.

2-6 lanes per workflow

Risk score (0-5)

Workflow risk reflects blast radius if it fires unattended. 5 = touches school-year revenue. 2 = read-only triage. Every step routed to HITL queue if risk ≥ 3.

ADR-031 · HITL invariant

REAL vs STUB

REAL = wired end-to-end in src/index.ts with green tool calls. STUB = diagram first, code TBD. Mixed = some lanes live, some scaffolded.

badges in every card

What's a graph file?

Each workflow has a paired -graph.html — an archify node-edge render of the same contract for visual scanning. Big workflows split into part-1 / part-2.

27 graph renders · archify

HITL invariant

Every write to NetSuite passes 4 gates: preview, edit-token header, proposed_actions queue, ns_push_queue drainer. Zero AI writes bypass.

hitl-security-invariant.html
F Ask Frosty 8 specialist pillars