[{"data":1,"prerenderedAt":4863},["ShallowReactive",2],{"app-navigation_en":3,"blog-post:posts_en:/en/blog/mutuellefit-ddd-agentic":99,"blog-available-locales:mutuellefit-ddd-agentic":2602,"blog-navigation_en":2603,"blog-surround:posts_en:/en/blog/mutuellefit-ddd-agentic":2629},[4],{"title":5,"path":6,"stem":7,"children":8,"page":98},"En","/en","en",[9],{"title":10,"path":11,"stem":12,"children":13,"page":98},"Blog","/en/blog","en/blog",[14,18,22,26,30,34,38,42,46,50,54,58,62,66,70,74,78,82,86,90,94],{"title":15,"path":16,"stem":17},"Security Practices for MCP Using JSON-RPC","/en/blog/mcp-security","en/blog/1. mcp-security",{"title":19,"path":20,"stem":21},"MikesHub internals: port ownership, reclaim, and AWP-paced Tauri","/en/blog/mikeshub","en/blog/10. mikeshub",{"title":23,"path":24,"stem":25},"Anatomy of a Mission-Critical AI System","/en/blog/anatomy-mission-critical-ai","en/blog/11. anatomy-mission-critical-ai",{"title":27,"path":28,"stem":29},"rag-factory: a Rust engine for recipe-driven RAG — cite, refuse, eval before ship","/en/blog/rag-factory","en/blog/12. rag-factory",{"title":31,"path":32,"stem":33},"Offline-verifiable attestation for consequential AI runs","/en/blog/agent-receipts-packing-slip","en/blog/13. agent-receipts-packing-slip",{"title":35,"path":36,"stem":37},"MCP Servers: Connecting AI to Real-Time Data","/en/blog/mcp-create","en/blog/2. mcp-create",{"title":39,"path":40,"stem":41},"MCP Servers: Risks of Using in Claude Desktop","/en/blog/mcp-risks","en/blog/3. mcp-risks",{"title":43,"path":44,"stem":45},"MCP Servers: Integrating LLM in E-Commerce Systems","/en/blog/mcp","en/blog/4. mcp",{"title":47,"path":48,"stem":49},"MCP Tiny Agents On-Premises: Breaking Free from Cloud Dependencies","/en/blog/mcp-tiny-agents-on-premises","en/blog/5. mcp-tiny-agents-on-premises",{"title":51,"path":52,"stem":53},"From Idea to API in 2 Days: Building Bankly with Agentic Workflows","/en/blog/overvibing","en/blog/6. overvibing",{"title":55,"path":56,"stem":57},"AI Chat, MCP Server build with Agentic Workflow Protocol for demo at Checkatrade .com","/en/blog/mcp-in-chat-demo","en/blog/8. mcp-in-chat-demo",{"title":59,"path":60,"stem":61},"MutuelleFit: contracts from a payroll-native insurance vertical","/en/blog/mutuellefit-ddd-agentic","en/blog/9. mutuellefit-ddd-agentic",{"title":63,"path":64,"stem":65},"AI Opportunities for Checkatrade considering PERN Stack","/en/blog/ai-opportunities-pern-stack","en/blog/ai-opportunities-pern-stack",{"title":67,"path":68,"stem":69},"Domain-Driven Design in Full-Stack Frameworks","/en/blog/architecture","en/blog/architecture",{"title":71,"path":72,"stem":73},"one-front, as told by git","/en/blog/building-one-front","en/blog/building-one-front",{"title":75,"path":76,"stem":77},"Commercial architecture is a chain, not a pricing page","/en/blog/commercial-architecture-chain","en/blog/commercial-architecture-chain",{"title":79,"path":80,"stem":81},"Quality: How to protect AI-powered Frontends?","/en/blog/qa-front","en/blog/qa-front",{"title":83,"path":84,"stem":85},"The Hidden Dangers of GraphQL: Security, Performance, and Complexity Risks","/en/blog/risking-with-graphql","en/blog/risking-with-graphql",{"title":87,"path":88,"stem":89},"From Zero to Hero: Scaling up to million users","/en/blog/scalability","en/blog/scalability",{"title":91,"path":92,"stem":93},"IT Consulting and Strategy","/en/blog/strategy","en/blog/strategy",{"title":95,"path":96,"stem":97},"Distributed Systems","/en/blog/systems","en/blog/systems",false,{"id":100,"title":59,"authors":101,"badge":108,"body":112,"date":2594,"description":2595,"extension":2596,"image":2597,"meta":2598,"navigation":2599,"path":60,"seo":2600,"stem":61,"__hash__":2601},"posts_en/en/blog/9. mutuellefit-ddd-agentic.md",[102],{"name":103,"description":104,"to":105,"avatar":106},"Michael Wybraniec","System Design, GenAI Automation & Architecture","https://www.linkedin.com/in/one-front/",{"src":107},"https://media.licdn.com/dms/image/v2/D4D03AQEGvIVcrTTS2g/profile-displayphoto-shrink_800_800/B4DZbtSf7LIEAc-/0/1747737772225?e=1753315200&v=beta&t=EOviZQkM396PoGctVjDCdlG8U3vN5UKWiIeNQ8IFUgQ",{"label":109,"color":110,"variant":111},"System Design, DDD, Agentic","primary","soft",{"type":113,"value":114,"toc":2571},"minimark",[115,149,166,184,206,218,225,242,257,263,403,418,424,433,442,457,463,471,496,516,693,701,716,722,730,738,779,810,815,955,959,1074,1078,1178,1208,1224,1245,1260,1266,1274,1296,1309,1324,1330,1338,1465,1480,1486,1696,1728,1743,1749,1832,1836,1945,1949,2015,2030,2036,2044,2052,2067,2073,2161,2170,2185,2206,2286,2325,2331,2346,2352,2388,2397,2485,2500,2567],[116,117,120],"div",{"className":118},[119],"text-justify",[121,122,123,127,128,131,132,135,136,139,140,144,145,148],"p",{},[124,125,126],"strong",{},"MutuelleFit"," is a thin ",[124,129,130],{},"Insurance bounded context"," POC: multi-tenant enrol / dispense → carrier affiliation behind an ",[124,133,134],{},"anti-corruption layer"," → Santé ",[124,137,138],{},"premium instructions"," for a payroll stub. Design sources: constitution, ",[141,142,143],"code",{},"docs/base.md",", Spec Kit feature ",[141,146,147],{},"001-mutuelle-enrolment-cotisations",".",[116,150,152],{"className":151},[119],[121,153,154,157,158,161,162,165],{},[124,155,156],{},"One breath:"," DDD decides the ",[124,159,160],{},"walls"," (who owns enrolment vs payroll vs employee). System design decides the ",[124,163,164],{},"pipes and failure modes"," (api / worker / outbox / queue / retries). They nest — they are not competitors.",[116,167,169],{"className":168},[119],[121,170,171,172,175,176,179,180,183],{},"Figures use seed data only (",[141,173,174],{},"Company 1"," / ",[141,177,178],{},"Employee 1","). No live credentials. Carrier names are ",[124,181,182],{},"ACL stubs",". Hover or focus a figure to blur it and read the contract.",[116,185,190,197],{"className":186},[187,188,189],"flex","justify-between","items-center",[191,192,194],"h2",{"id":193},"_1-walkthrough",[124,195,196],{},"1. Walkthrough",[121,198,199],{},[200,201,203],"a",{"href":202},"#top",[124,204,205],{},"⤴",[116,207,209],{"className":208},[119],[121,210,211,212,148],{},"Live guided demo on GitHub Pages — a cursor walks Docs → enrol until Covered → Architecture play → Cards. It loads only when you click below (so the auto-tour cannot yank page scroll). Full screen: ",[200,213,217],{"href":214,"rel":215},"https://michaelwybraniec.github.io/insurance-vertical/",[216],"nofollow","MutuelleFit demo",[219,220],"demo-iframe",{"height":221,"music":222,"poster":223,"src":214,"title":224},"760px","/audio/funkyelement.mp3","/blog/mutuellefit/demo-poster.jpg","MutuelleFit — insurance vertical guided demo",[116,226,228],{"className":227},[119],[121,229,230],{},[231,232,233,234,237,238,241],"em",{},"Guided demo — ",[124,235,236],{},"Play demo"," or ",[124,239,240],{},"Play demo with music"," (Bensound).",[116,243,245,251],{"className":244},[187,188,189],[191,246,248],{"id":247},"_2-contracts",[124,249,250],{},"2. Contracts",[121,252,253],{},[200,254,255],{"href":202},[124,256,205],{},[116,258,260],{"className":259},[119],[121,261,262],{},"What the vertical proves — constitution principles I–VII plus Spec Kit clarifications:",[264,265,266,282],"table",{},[267,268,269],"thead",{},[270,271,272,276,279],"tr",{},[273,274,275],"th",{},"#",[273,277,278],{},"Contract",[273,280,281],{},"Evidence",[283,284,285,304,315,334,349,360,377,392],"tbody",{},[270,286,287,291,294],{},[288,289,290],"td",{},"1",[288,292,293],{},"Enrol is async",[288,295,296,299,300,303],{},[141,297,298],{},"202"," + ",[141,301,302],{},"PendingExternal","; Active only after ACL confirm",[270,305,306,309,312],{},[288,307,308],{},"2",[288,310,311],{},"Bounded writes",[288,313,314],{},"Insurance never writes Payroll tables; ids + cents on the bus",[270,316,317,320,323],{},[288,318,319],{},"3",[288,321,322],{},"ACL, not products",[288,324,325,326,329,330,333],{},"Same ",[141,327,328],{},"EnrolEmployee","; ",[141,331,332],{},"InsurerGateway"," → AlanStub | AxaStub",[270,335,336,339,342],{},[288,337,338],{},"4",[288,340,341],{},"Outbox + idempotency in Postgres",[288,343,344,345,348],{},"Same TX as aggregate; ",[141,346,347],{},"(companyId, route, key)"," store",[270,350,351,354,357],{},[288,352,353],{},"5",[288,355,356],{},"ANI money",[288,358,359],{},"Integer EUR cents; employer ≥ 50%; half-up + remainder",[270,361,362,365,368],{},[288,363,364],{},"6",[288,366,367],{},"Tenant isolation",[288,369,370,373,374],{},[141,371,372],{},"X-Company-Id"," mismatch → ",[124,375,376],{},"403",[270,378,379,382,385],{},[288,380,381],{},"7",[288,383,384],{},"Honest failure",[288,386,387,388,391],{},"Retry ×3 → ",[141,389,390],{},"Failed"," + DLQ counter — never silent Active",[270,393,394,397,400],{},[288,395,396],{},"8",[288,398,399],{},"Agentic rails",[288,401,402],{},"Spec Kit + domain skills block illegal transitions",[116,404,406,412],{"className":405},[187,188,189],[191,407,409],{"id":408},"_3-problem-and-slice",[124,410,411],{},"3. Problem and slice",[121,413,414],{},[200,415,416],{"href":202},[124,417,205],{},[116,419,421],{"className":420},[119],[121,422,423],{},"Target pain: double entry between HRIS and insurer, wrong cotisations on the bulletin, leavers still “covered.” The POC is the smallest vertical that still has real architecture — not claims, marketplace, or DSN/URSSAF.",[116,425,427],{"className":426},[119],[121,428,429,432],{},[124,430,431],{},"Pitch:"," for many client companies, turn employee lifecycle into mutuelle affiliation and payroll-ready cotisations — DDD vertical + events + outbox + swappable carrier ACLs.",[434,435],"hover-figure",{"alt":436,"caption":437,"detail":438,"src":439,"tags":440,"title":441},"Docs overview — Insurance as bounded context","Docs · Start","Insurance sits next to company, employee, and payroll. HR talks to /v1; cover lives in an Enrolment FSM; carriers sit behind InsurerGateway; Payroll only receives EUR cents instructions. Critical path is labelled ENROL IS ASYNC.","/blog/mutuellefit/docs-overview.png","bounded-context, fsm, acl, domain-api","Docs · bounded context in one minute",[116,443,445,451],{"className":444},[187,188,189],[191,446,448],{"id":447},"_4-architecture",[124,449,450],{},"4. Architecture",[121,452,453],{},[200,454,455],{"href":202},[124,456,205],{},[116,458,460],{"className":459},[119],[121,461,462],{},"Five ownership zones. Write authority is the cut that matters — not how many containers you deploy. Walls first (Insurance vs Employee vs Payroll); then pipes (HTTPS commands, outbox → bus, ACL HTTPS, webhooks).",[434,464],{"alt":465,"caption":466,"detail":467,"src":468,"tags":469,"title":470},"Five ownership zones diagram","Ownership zones","Zone 1 Cover — thin client, never SoT. Zone 2 Insurance API — role + companyId. Zone 3 Records — FSM + outbox handoff. Zone 4 Background jobs — async boundary. Zone 5 Outside — carriers, payroll, EmployeeTerminated.","/blog/mutuellefit/ownership-zones.png","hexagonal, ports-adapters, authz, async-boundary","Five zones · write authority",[116,472,474],{"className":473},[119],[121,475,476,479,480,175,483,486,487,490,491,493,494,148],{},[124,477,478],{},"Hexagonal / ports-and-adapters."," Driving adapters: HTTP domain API + worker. Driven adapters: Postgres, in-process bus (prod-shaped → SQS / SNS / EventBridge), ",[141,481,482],{},"AlanStub",[141,484,485],{},"AxaStub",". Domain aggregates contain ",[124,488,489],{},"zero"," carrier DTOs — only ",[141,492,332],{},". That is the ",[124,495,134],{},[116,497,499],{"className":498},[119],[121,500,501,504,505,508,509,512,513,515],{},[124,502,503],{},"Context map."," Employee / Company are upstream. Payroll is downstream customer/supplier via ",[141,506,507],{},"PremiumInstructionIssued",". Carriers are conformist at the ACL, not in the core model. Identity is stub headers (",[141,510,511],{},"X-Role",", ",[141,514,372],{},") in the POC.",[517,518,523],"pre",{"className":519,"code":520,"language":521,"meta":522,"style":522},"language-mermaid shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","flowchart TB\n  subgraph Upstream[\"Upstream\"]\n    EMP[Employee]\n    CO[Company]\n    ID[Identity stub]\n  end\n  subgraph InsuranceBC[\"Insurance BC\"]\n    API[\"Domain API /v1\"]\n    AGG[\"Enrolment aggregate + FSM\"]\n    OB[(outbox · idempotency · audit)]\n    W[Activation worker]\n    GW[\"InsurerGateway\"]\n  end\n  subgraph Downstream[\"Downstream / edge\"]\n    PAY[Payroll stub]\n    ALAN[AlanStub]\n    AXA[AxaStub]\n  end\n  EMP -->|Terminated| W\n  CO -->|carrier config| AGG\n  ID -->|authZ| API\n  API --> AGG\n  AGG --> OB\n  W --> OB\n  W --> GW\n  GW --> ALAN\n  GW --> AXA\n  W -->|PremiumInstructionIssued| PAY\n","mermaid","",[141,524,525,533,539,545,551,557,563,569,575,581,587,593,599,604,610,616,622,628,633,639,645,651,657,663,669,675,681,687],{"__ignoreMap":522},[526,527,530],"span",{"class":528,"line":529},"line",1,[526,531,532],{},"flowchart TB\n",[526,534,536],{"class":528,"line":535},2,[526,537,538],{},"  subgraph Upstream[\"Upstream\"]\n",[526,540,542],{"class":528,"line":541},3,[526,543,544],{},"    EMP[Employee]\n",[526,546,548],{"class":528,"line":547},4,[526,549,550],{},"    CO[Company]\n",[526,552,554],{"class":528,"line":553},5,[526,555,556],{},"    ID[Identity stub]\n",[526,558,560],{"class":528,"line":559},6,[526,561,562],{},"  end\n",[526,564,566],{"class":528,"line":565},7,[526,567,568],{},"  subgraph InsuranceBC[\"Insurance BC\"]\n",[526,570,572],{"class":528,"line":571},8,[526,573,574],{},"    API[\"Domain API /v1\"]\n",[526,576,578],{"class":528,"line":577},9,[526,579,580],{},"    AGG[\"Enrolment aggregate + FSM\"]\n",[526,582,584],{"class":528,"line":583},10,[526,585,586],{},"    OB[(outbox · idempotency · audit)]\n",[526,588,590],{"class":528,"line":589},11,[526,591,592],{},"    W[Activation worker]\n",[526,594,596],{"class":528,"line":595},12,[526,597,598],{},"    GW[\"InsurerGateway\"]\n",[526,600,602],{"class":528,"line":601},13,[526,603,562],{},[526,605,607],{"class":528,"line":606},14,[526,608,609],{},"  subgraph Downstream[\"Downstream / edge\"]\n",[526,611,613],{"class":528,"line":612},15,[526,614,615],{},"    PAY[Payroll stub]\n",[526,617,619],{"class":528,"line":618},16,[526,620,621],{},"    ALAN[AlanStub]\n",[526,623,625],{"class":528,"line":624},17,[526,626,627],{},"    AXA[AxaStub]\n",[526,629,631],{"class":528,"line":630},18,[526,632,562],{},[526,634,636],{"class":528,"line":635},19,[526,637,638],{},"  EMP -->|Terminated| W\n",[526,640,642],{"class":528,"line":641},20,[526,643,644],{},"  CO -->|carrier config| AGG\n",[526,646,648],{"class":528,"line":647},21,[526,649,650],{},"  ID -->|authZ| API\n",[526,652,654],{"class":528,"line":653},22,[526,655,656],{},"  API --> AGG\n",[526,658,660],{"class":528,"line":659},23,[526,661,662],{},"  AGG --> OB\n",[526,664,666],{"class":528,"line":665},24,[526,667,668],{},"  W --> OB\n",[526,670,672],{"class":528,"line":671},25,[526,673,674],{},"  W --> GW\n",[526,676,678],{"class":528,"line":677},26,[526,679,680],{},"  GW --> ALAN\n",[526,682,684],{"class":528,"line":683},27,[526,685,686],{},"  GW --> AXA\n",[526,688,690],{"class":528,"line":689},28,[526,691,692],{},"  W -->|PremiumInstructionIssued| PAY\n",[434,694],{"alt":695,"caption":696,"detail":697,"src":698,"tags":699,"title":700},"Cover UI beside live architecture graph","Cover · Architecture tab","Left — person journey (enrolled → waiting → covered → payslip). Right — Insurance API, Enrolment FSM, event bus, activation worker, payroll observer. Illegal edges (Cover → carrier HTTP) are architecture violations.","/blog/mutuellefit/cover-architecture-split.png","observability, eda, fsm, demo","Stepper + runtime graph",[116,702,704,710],{"className":703},[187,188,189],[191,705,707],{"id":706},"_5-critical-path",[124,708,709],{},"5. Critical path",[121,711,712],{},[200,713,714],{"href":202},[124,715,205],{},[116,717,719],{"className":718},[119],[121,720,721],{},"Command → same-TX outbox → worker → ACL → Active → premium instruction → payroll stub.",[434,723],{"alt":724,"caption":725,"detail":726,"src":727,"tags":728,"title":729},"Sequence diagram enrol async path","Sequence · enrol","POST enrol + Idempotency-Key → 202 PendingExternal. Enrolment + outbox commit together. Worker → createMember → Active → PremiumInstructionIssued (cents) → Payroll. No optimistic Covered.","/blog/mutuellefit/sequence-enrol.png","http-202, transactional-outbox, idempotency-key, eventual-consistency","Enrol is async · outbox in one TX",[116,731,733],{"className":732},[119],[121,734,735],{},[124,736,737],{},"Same ACID transaction:",[739,740,741,756,761,768],"ol",{},[742,743,744,745,748,749,752,753,148],"li",{},"Enforce invariants — ≤1 open ",[141,746,747],{},"PendingExternal|Active"," per ",[141,750,751],{},"(companyId, employeeId)","; plan exists; insurance enabled; ",[141,754,755],{},"coverage = collective",[742,757,758,759,148],{},"Persist Enrolment as ",[141,760,302],{},[742,762,763,764,767],{},"Insert outbox row (",[141,765,766],{},"event_type"," + jsonb payload).",[742,769,770,771,774,775,778],{},"Upsert ",[141,772,773],{},"idempotency_keys"," ",[141,776,777],{},"(company_id, route, key)"," → cached 202 body.",[116,780,782],{"className":781},[119],[121,783,784,785,788,789,299,792,299,795,797,798,801,802,804,805,299,807,148],{},"Worker drains Pending / outbox → ",[141,786,787],{},"createMember"," → on success FSM → ",[141,790,791],{},"Active",[141,793,794],{},"EmployeeEnrolledInInsurance",[141,796,507],{},". Timeout increments ",[141,799,800],{},"attempt_count","; after ",[124,803,319],{}," → ",[141,806,390],{},[141,808,809],{},"dead_letter_counters",[811,812,814],"h3",{"id":813},"example-enrol-company-a-alan","Example · enrol (Company A / Alan)",[517,816,821],{"className":817,"code":818,"filename":819,"language":820,"meta":522,"style":522},"language-bash shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","curl -sS \\\n  -H \"X-Role: company.admin\" \\\n  -H \"X-Company-Id: company-a\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: demo-enrol-a-1\" \\\n  -X POST \"http://localhost:3810/v1/companies/company-a/enrolments\" \\\n  -d '{\n    \"employeeId\": \"emp-a1\",\n    \"planId\": \"sante-base\",\n    \"coverage\": \"collective\",\n    \"effectiveFrom\": \"2026-04-01\"\n  }'\n# → 202 { enrolmentId, status: \"PendingExternal\" }\n","enrol-company-a.sh","bash",[141,822,823,837,854,867,880,893,910,921,926,931,936,941,949],{"__ignoreMap":522},[526,824,825,829,833],{"class":528,"line":529},[526,826,828],{"class":827},"sBMFI","curl",[526,830,832],{"class":831},"sfazB"," -sS",[526,834,836],{"class":835},"sTEyZ"," \\\n",[526,838,839,842,846,849,852],{"class":528,"line":535},[526,840,841],{"class":831},"  -H",[526,843,845],{"class":844},"sMK4o"," \"",[526,847,848],{"class":831},"X-Role: company.admin",[526,850,851],{"class":844},"\"",[526,853,836],{"class":835},[526,855,856,858,860,863,865],{"class":528,"line":541},[526,857,841],{"class":831},[526,859,845],{"class":844},[526,861,862],{"class":831},"X-Company-Id: company-a",[526,864,851],{"class":844},[526,866,836],{"class":835},[526,868,869,871,873,876,878],{"class":528,"line":547},[526,870,841],{"class":831},[526,872,845],{"class":844},[526,874,875],{"class":831},"Content-Type: application/json",[526,877,851],{"class":844},[526,879,836],{"class":835},[526,881,882,884,886,889,891],{"class":528,"line":553},[526,883,841],{"class":831},[526,885,845],{"class":844},[526,887,888],{"class":831},"Idempotency-Key: demo-enrol-a-1",[526,890,851],{"class":844},[526,892,836],{"class":835},[526,894,895,898,901,903,906,908],{"class":528,"line":559},[526,896,897],{"class":831},"  -X",[526,899,900],{"class":831}," POST",[526,902,845],{"class":844},[526,904,905],{"class":831},"http://localhost:3810/v1/companies/company-a/enrolments",[526,907,851],{"class":844},[526,909,836],{"class":835},[526,911,912,915,918],{"class":528,"line":565},[526,913,914],{"class":831},"  -d",[526,916,917],{"class":844}," '",[526,919,920],{"class":831},"{\n",[526,922,923],{"class":528,"line":571},[526,924,925],{"class":831},"    \"employeeId\": \"emp-a1\",\n",[526,927,928],{"class":528,"line":577},[526,929,930],{"class":831},"    \"planId\": \"sante-base\",\n",[526,932,933],{"class":528,"line":583},[526,934,935],{"class":831},"    \"coverage\": \"collective\",\n",[526,937,938],{"class":528,"line":589},[526,939,940],{"class":831},"    \"effectiveFrom\": \"2026-04-01\"\n",[526,942,943,946],{"class":528,"line":595},[526,944,945],{"class":831},"  }",[526,947,948],{"class":844},"'\n",[526,950,951],{"class":528,"line":601},[526,952,954],{"class":953},"sHwdD","# → 202 { enrolmentId, status: \"PendingExternal\" }\n",[811,956,958],{"id":957},"example-dual-carrier-company-b-axa","Example · dual carrier (Company B / AXA)",[517,960,963],{"className":817,"code":961,"filename":962,"language":820,"meta":522,"style":522},"curl -sS \\\n  -H \"X-Role: company.admin\" \\\n  -H \"X-Company-Id: company-b\" \\\n  -H \"Content-Type: application/json\" \\\n  -H \"Idempotency-Key: demo-enrol-b-1\" \\\n  -X POST \"http://localhost:3810/v1/companies/company-b/enrolments\" \\\n  -d '{\n    \"employeeId\": \"emp-b1\",\n    \"planId\": \"sante-base\",\n    \"coverage\": \"collective\",\n    \"effectiveFrom\": \"2026-04-01\"\n  }'\n# ACL log differs; PremiumInstruction shape identical\n","enrol-company-b.sh",[141,964,965,973,985,998,1010,1023,1038,1046,1051,1055,1059,1063,1069],{"__ignoreMap":522},[526,966,967,969,971],{"class":528,"line":529},[526,968,828],{"class":827},[526,970,832],{"class":831},[526,972,836],{"class":835},[526,974,975,977,979,981,983],{"class":528,"line":535},[526,976,841],{"class":831},[526,978,845],{"class":844},[526,980,848],{"class":831},[526,982,851],{"class":844},[526,984,836],{"class":835},[526,986,987,989,991,994,996],{"class":528,"line":541},[526,988,841],{"class":831},[526,990,845],{"class":844},[526,992,993],{"class":831},"X-Company-Id: company-b",[526,995,851],{"class":844},[526,997,836],{"class":835},[526,999,1000,1002,1004,1006,1008],{"class":528,"line":547},[526,1001,841],{"class":831},[526,1003,845],{"class":844},[526,1005,875],{"class":831},[526,1007,851],{"class":844},[526,1009,836],{"class":835},[526,1011,1012,1014,1016,1019,1021],{"class":528,"line":553},[526,1013,841],{"class":831},[526,1015,845],{"class":844},[526,1017,1018],{"class":831},"Idempotency-Key: demo-enrol-b-1",[526,1020,851],{"class":844},[526,1022,836],{"class":835},[526,1024,1025,1027,1029,1031,1034,1036],{"class":528,"line":559},[526,1026,897],{"class":831},[526,1028,900],{"class":831},[526,1030,845],{"class":844},[526,1032,1033],{"class":831},"http://localhost:3810/v1/companies/company-b/enrolments",[526,1035,851],{"class":844},[526,1037,836],{"class":835},[526,1039,1040,1042,1044],{"class":528,"line":565},[526,1041,914],{"class":831},[526,1043,917],{"class":844},[526,1045,920],{"class":831},[526,1047,1048],{"class":528,"line":571},[526,1049,1050],{"class":831},"    \"employeeId\": \"emp-b1\",\n",[526,1052,1053],{"class":528,"line":577},[526,1054,930],{"class":831},[526,1056,1057],{"class":528,"line":583},[526,1058,935],{"class":831},[526,1060,1061],{"class":528,"line":589},[526,1062,940],{"class":831},[526,1064,1065,1067],{"class":528,"line":595},[526,1066,945],{"class":831},[526,1068,948],{"class":844},[526,1070,1071],{"class":528,"line":601},[526,1072,1073],{"class":953},"# ACL log differs; PremiumInstruction shape identical\n",[811,1075,1077],{"id":1076},"example-published-language","Example · published language",[517,1079,1084],{"className":1080,"code":1081,"filename":1082,"language":1083,"meta":522,"style":522},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","PremiumInstructionIssued {\n  eventId, occurredAt, companyId, employeeId, enrolmentId,\n  periodFrom, periodTo,   // Europe/Paris month of effectiveFrom\n  employerShareCents,     // half-up from plan.employerSharePct\n  employeeShareCents,     // remainder so sum === premium\n  currency: \"EUR\"\n}\n","premium-instruction.ts","ts",[141,1085,1086,1093,1122,1137,1147,1157,1173],{"__ignoreMap":522},[526,1087,1088,1091],{"class":528,"line":529},[526,1089,1090],{"class":835},"PremiumInstructionIssued ",[526,1092,920],{"class":844},[526,1094,1095,1098,1101,1104,1106,1109,1111,1114,1116,1119],{"class":528,"line":535},[526,1096,1097],{"class":835},"  eventId",[526,1099,1100],{"class":844},",",[526,1102,1103],{"class":835}," occurredAt",[526,1105,1100],{"class":844},[526,1107,1108],{"class":835}," companyId",[526,1110,1100],{"class":844},[526,1112,1113],{"class":835}," employeeId",[526,1115,1100],{"class":844},[526,1117,1118],{"class":835}," enrolmentId",[526,1120,1121],{"class":844},",\n",[526,1123,1124,1127,1129,1132,1134],{"class":528,"line":541},[526,1125,1126],{"class":835},"  periodFrom",[526,1128,1100],{"class":844},[526,1130,1131],{"class":835}," periodTo",[526,1133,1100],{"class":844},[526,1135,1136],{"class":953},"   // Europe/Paris month of effectiveFrom\n",[526,1138,1139,1142,1144],{"class":528,"line":547},[526,1140,1141],{"class":835},"  employerShareCents",[526,1143,1100],{"class":844},[526,1145,1146],{"class":953},"     // half-up from plan.employerSharePct\n",[526,1148,1149,1152,1154],{"class":528,"line":553},[526,1150,1151],{"class":835},"  employeeShareCents",[526,1153,1100],{"class":844},[526,1155,1156],{"class":953},"     // remainder so sum === premium\n",[526,1158,1159,1162,1165,1167,1170],{"class":528,"line":559},[526,1160,1161],{"class":827},"  currency",[526,1163,1164],{"class":844},":",[526,1166,845],{"class":844},[526,1168,1169],{"class":831},"EUR",[526,1171,1172],{"class":844},"\"\n",[526,1174,1175],{"class":528,"line":565},[526,1176,1177],{"class":844},"}\n",[116,1179,1181],{"className":1180},[119],[121,1182,1183,774,1186,1188,1189,175,1192,175,1194,1197,1198,1200,1201,1203,1204,1207],{},[124,1184,1185],{},"Command vs event.",[141,1187,328],{}," is a command — please do X; it can be refused (",[141,1190,1191],{},"400",[141,1193,376],{},[141,1195,1196],{},"409","). ",[141,1199,794],{}," and ",[141,1202,507],{}," are domain events — past-tense facts others react to. Never name an event ",[141,1205,1206],{},"UpdateEnrolment"," (a DB verb); consumers need a business fact. One aggregate TX in Insurance; Payroll must not join that TX.",[116,1209,1211],{"className":1210},[119],[121,1212,1213,774,1216,1219,1220,1223],{},[124,1214,1215],{},"Money:",[141,1217,1218],{},"splitShares(monthlyPremiumCents, employerSharePct)"," rejects ",[141,1221,1222],{},"employerSharePct \u003C 50",", half-up on employer cents, employee gets remainder. Seed plan → 60 / 40 EUR on the bulletin preview.",[116,1225,1227],{"className":1226},[119],[121,1228,1229,1232,1233,1236,1237,1240,1241,1244],{},[124,1230,1231],{},"Effective dating & proration."," Cover and premium instructions carry a validity interval, not only a “current” flag. Spec Kit locked period = whole calendar month of ",[141,1234,1235],{},"effectiveFrom"," in ",[141,1238,1239],{},"Europe/Paris"," (",[141,1242,1243],{},"full_month"," — no mid-month pro-rata engine in v1). Say the rule aloud, then stick to it; fixing a wrong premium means a new/changed instruction + audit, not a silent rewrite of history.",[116,1246,1248,1254],{"className":1247},[187,188,189],[191,1249,1251],{"id":1250},"_6-enrolment-fsm",[124,1252,1253],{},"6. Enrolment FSM",[121,1255,1256],{},[200,1257,1258],{"href":202},[124,1259,205],{},[116,1261,1263],{"className":1262},[119],[121,1264,1265],{},"Illegal transitions are rejected in the aggregate. UI labels map 1:1 to engine names.",[434,1267],{"alt":1268,"caption":1269,"detail":1270,"src":1271,"tags":1272,"title":1273},"Enrolment finite state machine","Docs · Statuses","enrol → PendingExternal → Active | Failed. Dispense → Dispensed (no premium). cancel / terminate → Ended. Failed allows re-enrol (new id). Dispense while Pending / Active → 409.","/blog/mutuellefit/docs-fsm.png","aggregate-root, fsm, invariants, http-409","FSM · the diagram is the contract",[116,1275,1277],{"className":1276},[119],[121,1278,1279,1280,1282,1283,1285,1286,1289,1290,1293,1294,148],{},"Spec Kit defaults that stop invention: missing Idempotency-Key → ",[124,1281,1191],{},"; replay → ",[124,1284,298],{}," same body; terminate vs activate → ",[124,1287,1288],{},"terminate wins","; webhook already Active → ",[124,1291,1292],{},"200"," no-op; Cancel on Dispensed / Failed → ",[124,1295,1196],{},[116,1297,1299],{"className":1298},[119],[121,1300,1301,1304,1305,1308],{},[124,1302,1303],{},"Saga vs FSM."," Enrolment is multi-step in life (accept → insurer → Active → Payroll), but the MVP keeps an ",[124,1306,1307],{},"Enrolment FSM + worker retries"," — not a saga framework. Introduce an explicit saga (with compensations as first-class steps) only when branching gets heavy. Pending + leave already compensates locally and at the ACL without a workflow engine.",[116,1310,1312,1318],{"className":1311},[187,188,189],[191,1313,1315],{"id":1314},"_7-persistence",[124,1316,1317],{},"7. Persistence",[121,1319,1320],{},[200,1321,1322],{"href":202},[124,1323,205],{},[116,1325,1327],{"className":1326},[119],[121,1328,1329],{},"Reliability tables are the design. Domain refs stay boring on purpose.",[434,1331],{"alt":1332,"caption":1333,"detail":1334,"src":1335,"tags":1336,"title":1337},"Postgres ER diagram","ER · insurance_poc","enrollments = write model + FSM. outbox = durable publish. idempotency_keys = at-most-once effect. audit_log = correlation trail. dead_letter_counters = Failed@N. Connection string redacted.","/blog/mutuellefit/db-schema.png","transactional-outbox, idempotency, multi-tenant, postgres","Schema · outbox, idempotency, audit, DLQ",[264,1339,1340,1353],{},[267,1341,1342],{},[270,1343,1344,1347,1350],{},[273,1345,1346],{},"Table",[273,1348,1349],{},"Pattern",[273,1351,1352],{},"Key columns",[283,1354,1355,1378,1398,1414,1435,1452],{},[270,1356,1357,1362,1365],{},[288,1358,1359],{},[141,1360,1361],{},"enrollments",[288,1363,1364],{},"Aggregate write model",[288,1366,1367,512,1370,512,1372,512,1375],{},[141,1368,1369],{},"status",[141,1371,800],{},[141,1373,1374],{},"insurer_member_id",[141,1376,1377],{},"carrier",[270,1379,1380,1385,1388],{},[288,1381,1382],{},[141,1383,1384],{},"outbox",[288,1386,1387],{},"Transactional outbox",[288,1389,1390,512,1392,512,1395],{},[141,1391,766],{},[141,1393,1394],{},"payload",[141,1396,1397],{},"published_at",[270,1399,1400,1404,1407],{},[288,1401,1402],{},[141,1403,773],{},[288,1405,1406],{},"Command dedupe",[288,1408,1409,804,1411],{},[141,1410,777],{},[141,1412,1413],{},"response_body",[270,1415,1416,1421,1424],{},[288,1417,1418],{},[141,1419,1420],{},"audit_log",[288,1422,1423],{},"Append-only trail",[288,1425,1426,512,1429,512,1432],{},[141,1427,1428],{},"correlation_id",[141,1430,1431],{},"action",[141,1433,1434],{},"detail",[270,1436,1437,1441,1444],{},[288,1438,1439],{},[141,1440,809],{},[288,1442,1443],{},"Ops signal",[288,1445,1446,512,1449],{},[141,1447,1448],{},"count",[141,1450,1451],{},"last_enrollment_id",[270,1453,1454,1459,1462],{},[288,1455,1456],{},[141,1457,1458],{},"payroll_lines",[288,1460,1461],{},"Downstream stub",[288,1463,1464],{},"Written from events — not from enrol commands",[116,1466,1468,1474],{"className":1467},[187,188,189],[191,1469,1471],{"id":1470},"_8-domain-api",[124,1472,1473],{},"8. Domain API",[121,1475,1476],{},[200,1477,1478],{"href":202},[124,1479,205],{},[116,1481,1483],{"className":1482},[119],[121,1484,1485],{},"Insurance’s own HTTP API — not the insurer’s, not Payroll’s. Command / query style; server enforces invariants + authZ.",[264,1487,1488,1504],{},[267,1489,1490],{},[270,1491,1492,1495,1498,1501],{},[273,1493,1494],{},"Method",[273,1496,1497],{},"Path",[273,1499,1500],{},"Role",[273,1502,1503],{},"Intent",[283,1505,1506,1528,1548,1569,1587,1605,1624,1641,1660,1678],{},[270,1507,1508,1513,1518,1523],{},[288,1509,1510],{},[141,1511,1512],{},"POST",[288,1514,1515],{},[141,1516,1517],{},"/v1/companies/:id/enrolments",[288,1519,1520],{},[141,1521,1522],{},"company.admin",[288,1524,1525,1527],{},[141,1526,328],{}," + Idempotency-Key",[270,1529,1530,1534,1539,1543],{},[288,1531,1532],{},[141,1533,1512],{},[288,1535,1536],{},[141,1537,1538],{},"/v1/companies/:id/dispenses",[288,1540,1541],{},[141,1542,1522],{},[288,1544,1545],{},[141,1546,1547],{},"DispenseEmployee",[270,1549,1550,1554,1559,1563],{},[288,1551,1552],{},[141,1553,1512],{},[288,1555,1556],{},[141,1557,1558],{},"/v1/enrolments/:id/cancellations",[288,1560,1561],{},[141,1562,1522],{},[288,1564,1565,1568],{},[141,1566,1567],{},"CancelEnrolment"," → Ended",[270,1570,1571,1576,1580,1584],{},[288,1572,1573],{},[141,1574,1575],{},"GET",[288,1577,1578],{},[141,1579,1517],{},[288,1581,1582],{},[141,1583,1522],{},[288,1585,1586],{},"List cover",[270,1588,1589,1593,1598,1602],{},[288,1590,1591],{},[141,1592,1575],{},[288,1594,1595],{},[141,1596,1597],{},"/v1/enrolments/:id",[288,1599,1600],{},[141,1601,1522],{},[288,1603,1604],{},"Detail",[270,1606,1607,1611,1616,1621],{},[288,1608,1609],{},[141,1610,1575],{},[288,1612,1613],{},[141,1614,1615],{},"/v1/me/cover",[288,1617,1618],{},[141,1619,1620],{},"employee.self",[288,1622,1623],{},"My cover",[270,1625,1626,1630,1635,1638],{},[288,1627,1628],{},[141,1629,1512],{},[288,1631,1632],{},[141,1633,1634],{},"/v1/webhooks/carriers/:carrier",[288,1636,1637],{},"carrier sig",[288,1639,1640],{},"Confirm / reject",[270,1642,1643,1647,1652,1657],{},[288,1644,1645],{},[141,1646,1512],{},[288,1648,1649],{},[141,1650,1651],{},"/v1/dev/platform-events",[288,1653,1654],{},[141,1655,1656],{},"system.worker",[288,1658,1659],{},"Terminate ingress",[270,1661,1662,1666,1671,1675],{},[288,1663,1664],{},[141,1665,1575],{},[288,1667,1668],{},[141,1669,1670],{},"/v1/companies/:id/payroll-lines",[288,1672,1673],{},[141,1674,1522],{},[288,1676,1677],{},"Bulletin preview",[270,1679,1680,1684,1689,1693],{},[288,1681,1682],{},[141,1683,1575],{},[288,1685,1686],{},[141,1687,1688],{},"/v1/companies/:id/audit",[288,1690,1691],{},[141,1692,1522],{},[288,1694,1695],{},"Audit tail",[116,1697,1699],{"className":1698},[119],[121,1700,1701,1704,1705,1708,1709,1712,1713,1716,1717,175,1720,1723,1724,1727],{},[124,1702,1703],{},"Webhook path (carrier → us)."," Never trust the body blindly: verify signature (",[141,1706,1707],{},"X-Carrier-Signature"," stub secret in POC → ",[124,1710,1711],{},"401"," if wrong) → dedupe ",[141,1714,1715],{},"insurerEventId"," (inbox) → match/upsert on ",[141,1718,1719],{},"insurerMemberId",[141,1721,1722],{},"enrolmentId"," → drive the FSM via a domain command → emit ",[124,1725,1726],{},"our"," events on the outbox (not raw insurer JSON). Out-of-order is OK if upsert is idempotent. Demo gate may activate sync via stubs; the webhook contract still exists so duplicate notify is a no-op, not a second Active.",[116,1729,1731,1737],{"className":1730},[187,188,189],[191,1732,1734],{"id":1733},"_9-edge-matrix",[124,1735,1736],{},"9. Edge matrix",[121,1738,1739],{},[200,1740,1741],{"href":202},[124,1742,205],{},[116,1744,1746],{"className":1745},[119],[121,1747,1748],{},"Happy path is cheap. This table is the review gate:",[264,1750,1751,1761],{},[267,1752,1753],{},[270,1754,1755,1758],{},[273,1756,1757],{},"Case",[273,1759,1760],{},"Expected",[283,1762,1763,1771,1779,1789,1797,1805,1814,1823],{},[270,1764,1765,1768],{},[288,1766,1767],{},"Double-click enrol",[288,1769,1770],{},"Same Idempotency-Key → same enrolment",[270,1772,1773,1776],{},[288,1774,1775],{},"Insurer timeout",[288,1777,1778],{},"Pending → retry → Failed@3 + DLQ counter",[270,1780,1781,1784],{},[288,1782,1783],{},"Duplicate webhook",[288,1785,1786,1788],{},[141,1787,1715],{}," inbox → no-op",[270,1790,1791,1794],{},[288,1792,1793],{},"Terminate while Pending",[288,1795,1796],{},"Cancel local + compensate stub",[270,1798,1799,1802],{},[288,1800,1801],{},"Dispense instead of enrol",[288,1803,1804],{},"Dispensed; no PremiumInstruction",[270,1806,1807,1810],{},[288,1808,1809],{},"Wrong company",[288,1811,1812],{},[124,1813,376],{},[270,1815,1816,1819],{},[288,1817,1818],{},"Dispense while Active / Pending",[288,1820,1821],{},[124,1822,1196],{},[270,1824,1825,1828],{},[288,1826,1827],{},"Missing Idempotency-Key",[288,1829,1830],{},[124,1831,1191],{},[811,1833,1835],{"id":1834},"example-tenancy-403","Example · tenancy 403",[517,1837,1840],{"className":817,"code":1838,"filename":1839,"language":820,"meta":522,"style":522},"curl -sS -o /dev/null -w \"%{http_code}\\n\" \\\n  -H \"X-Role: company.admin\" \\\n  -H \"X-Company-Id: company-a\" \\\n  -H \"Idempotency-Key: x\" \\\n  -H \"Content-Type: application/json\" \\\n  -X POST \"http://localhost:3810/v1/companies/company-b/enrolments\" \\\n  -d '{\"employeeId\":\"emp-b1\",\"planId\":\"sante-base\",\"coverage\":\"collective\",\"effectiveFrom\":\"2026-04-01\"}'\n# → 403\n","tenancy-403.sh",[141,1841,1842,1866,1878,1890,1903,1915,1929,1940],{"__ignoreMap":522},[526,1843,1844,1846,1848,1851,1854,1857,1859,1862,1864],{"class":528,"line":529},[526,1845,828],{"class":827},[526,1847,832],{"class":831},[526,1849,1850],{"class":831}," -o",[526,1852,1853],{"class":831}," /dev/null",[526,1855,1856],{"class":831}," -w",[526,1858,845],{"class":844},[526,1860,1861],{"class":831},"%{http_code}\\n",[526,1863,851],{"class":844},[526,1865,836],{"class":835},[526,1867,1868,1870,1872,1874,1876],{"class":528,"line":535},[526,1869,841],{"class":831},[526,1871,845],{"class":844},[526,1873,848],{"class":831},[526,1875,851],{"class":844},[526,1877,836],{"class":835},[526,1879,1880,1882,1884,1886,1888],{"class":528,"line":541},[526,1881,841],{"class":831},[526,1883,845],{"class":844},[526,1885,862],{"class":831},[526,1887,851],{"class":844},[526,1889,836],{"class":835},[526,1891,1892,1894,1896,1899,1901],{"class":528,"line":547},[526,1893,841],{"class":831},[526,1895,845],{"class":844},[526,1897,1898],{"class":831},"Idempotency-Key: x",[526,1900,851],{"class":844},[526,1902,836],{"class":835},[526,1904,1905,1907,1909,1911,1913],{"class":528,"line":553},[526,1906,841],{"class":831},[526,1908,845],{"class":844},[526,1910,875],{"class":831},[526,1912,851],{"class":844},[526,1914,836],{"class":835},[526,1916,1917,1919,1921,1923,1925,1927],{"class":528,"line":559},[526,1918,897],{"class":831},[526,1920,900],{"class":831},[526,1922,845],{"class":844},[526,1924,1033],{"class":831},[526,1926,851],{"class":844},[526,1928,836],{"class":835},[526,1930,1931,1933,1935,1938],{"class":528,"line":565},[526,1932,914],{"class":831},[526,1934,917],{"class":844},[526,1936,1937],{"class":831},"{\"employeeId\":\"emp-b1\",\"planId\":\"sante-base\",\"coverage\":\"collective\",\"effectiveFrom\":\"2026-04-01\"}",[526,1939,948],{"class":844},[526,1941,1942],{"class":528,"line":571},[526,1943,1944],{"class":953},"# → 403\n",[811,1946,1948],{"id":1947},"example-terminate","Example · terminate",[517,1950,1953],{"className":817,"code":1951,"filename":1952,"language":820,"meta":522,"style":522},"curl -sS \\\n  -H \"X-Role: system.worker\" \\\n  -H \"Content-Type: application/json\" \\\n  -X POST \"http://localhost:3810/v1/dev/platform-events\" \\\n  -d @fixtures/employee-terminated.json\n# → Ended + compensate + PremiumInstruction Stop\n","terminate.sh",[141,1954,1955,1963,1976,1988,2003,2010],{"__ignoreMap":522},[526,1956,1957,1959,1961],{"class":528,"line":529},[526,1958,828],{"class":827},[526,1960,832],{"class":831},[526,1962,836],{"class":835},[526,1964,1965,1967,1969,1972,1974],{"class":528,"line":535},[526,1966,841],{"class":831},[526,1968,845],{"class":844},[526,1970,1971],{"class":831},"X-Role: system.worker",[526,1973,851],{"class":844},[526,1975,836],{"class":835},[526,1977,1978,1980,1982,1984,1986],{"class":528,"line":541},[526,1979,841],{"class":831},[526,1981,845],{"class":844},[526,1983,875],{"class":831},[526,1985,851],{"class":844},[526,1987,836],{"class":835},[526,1989,1990,1992,1994,1996,1999,2001],{"class":528,"line":547},[526,1991,897],{"class":831},[526,1993,900],{"class":831},[526,1995,845],{"class":844},[526,1997,1998],{"class":831},"http://localhost:3810/v1/dev/platform-events",[526,2000,851],{"class":844},[526,2002,836],{"class":835},[526,2004,2005,2007],{"class":528,"line":553},[526,2006,914],{"class":831},[526,2008,2009],{"class":831}," @fixtures/employee-terminated.json\n",[526,2011,2012],{"class":528,"line":559},[526,2013,2014],{"class":953},"# → Ended + compensate + PremiumInstruction Stop\n",[116,2016,2018,2024],{"className":2017},[187,188,189],[191,2019,2021],{"id":2020},"_10-cover-ui",[124,2022,2023],{},"10. Cover UI",[121,2025,2026],{},[200,2027,2028],{"href":202},[124,2029,205],{},[116,2031,2033],{"className":2032},[119],[121,2034,2035],{},"Thin client: commands + projections. Never calls the carrier. Never writes payslip lines.",[434,2037],{"alt":2038,"caption":2039,"detail":2040,"src":2041,"tags":2042,"title":2043},"MutuelleFit Cover admin UI","Cover","Company switcher (Company 1 · Alan vs Company 2 · AXA). Enrol / dispense / employee view. Cards · Logs · Architecture expose write model vs mock vs seed.","/blog/mutuellefit/cover-hero.png","thin-client, cqrs-lite, multi-tenant","Cover · command pad + projections",[434,2045],{"alt":2046,"caption":2047,"detail":2048,"src":2049,"tags":2050,"title":2051},"Payslip preview patronale and salariale","Cover · payslip","Lines only after Covered. Seed Santé Base → employer 60.00 / employee 40.00 EUR. Simulate leaving → Ended + stop lines — leave-drift is the failure mode this vertical kills.","/blog/mutuellefit/cover-payslip.png","ani, patronale, salariale, terminate","Payslip preview · event projection",[116,2053,2055,2061],{"className":2054},[187,188,189],[191,2056,2058],{"id":2057},"_11-scope-discipline",[124,2059,2060],{},"11. Scope discipline",[121,2062,2063],{},[200,2064,2065],{"href":202},[124,2066,205],{},[116,2068,2070],{"className":2069},[119],[121,2071,2072],{},"Prove domain + events + multi-company + two carriers. Everything else is seed, fixture, or stub.",[264,2074,2075,2088],{},[267,2076,2077],{},[270,2078,2079,2082,2085],{},[273,2080,2081],{},"Must code",[273,2083,2084],{},"Seed",[273,2086,2087],{},"Mock / defer",[283,2089,2090,2101,2114,2125,2136,2147],{},[270,2091,2092,2095,2098],{},[288,2093,2094],{},"Enrolment aggregate + FSM tests",[288,2096,2097],{},"companies A/B, employees, plan, reasons, admins",[288,2099,2100],{},"Real Alan / AXA HTTP",[270,2102,2103,2106,2111],{},[288,2104,2105],{},"Domain API enrol / list / get",[288,2107,2108],{},[141,2109,2110],{},"employerSharePct ≥ 50",[288,2112,2113],{},"SSO",[270,2115,2116,2119,2122],{},[288,2117,2118],{},"Outbox same TX + publisher",[288,2120,2121],{},"dispense reason codes",[288,2123,2124],{},"SQS / K8s / Terraform",[270,2126,2127,2130,2133],{},[288,2128,2129],{},"Worker + AlanStub + AxaStub",[288,2131,2132],{},"AXA setup-sheet fixture",[288,2134,2135],{},"DSN / URSSAF",[270,2137,2138,2141,2144],{},[288,2139,2140],{},"Idempotency + 403 tests",[288,2142,2143],{},"—",[288,2145,2146],{},"Marketplace, claims",[270,2148,2149,2152,2158],{},[288,2150,2151],{},"Terminate handler",[288,2153,2154,2157],{},[141,2155,2156],{},"employee-terminated"," fixture",[288,2159,2160],{},"ChangeCoverage",[116,2162,2164],{"className":2163},[119],[121,2165,2166,2169],{},[124,2167,2168],{},"Ship order:"," seed → aggregate + tests → API → outbox → worker + stubs → idempotency → tenancy → terminate → demo curls / thin React.",[116,2171,2173,2179],{"className":2172},[187,188,189],[191,2174,2176],{"id":2175},"_12-cloud-mapping",[124,2177,2178],{},"12. Cloud mapping",[121,2180,2181],{},[200,2182,2183],{"href":202},[124,2184,205],{},[116,2186,2188],{"className":2187},[119],[121,2189,2190,2191,2194,2195,2198,2199,1240,2202,2205],{},"Local: API ",[141,2192,2193],{},":3810",", worker, Postgres ",[141,2196,2197],{},":5433",", UI ",[141,2200,2201],{},":5810",[141,2203,2204],{},"hub.yaml","). Cloud is transport — not a redesign:",[264,2207,2208,2221],{},[267,2209,2210],{},[270,2211,2212,2215,2218],{},[273,2213,2214],{},"POC",[273,2216,2217],{},"Production-shaped",[273,2219,2220],{},"Concern",[283,2222,2223,2234,2245,2259,2272],{},[270,2224,2225,2228,2231],{},[288,2226,2227],{},"SQL outbox + publisher",[288,2229,2230],{},"Outbox → SQS / SNS / EventBridge",[288,2232,2233],{},"Fan-out, retry, DLQ",[270,2235,2236,2239,2242],{},[288,2237,2238],{},"Activation worker",[288,2240,2241],{},"EKS / ECS / Lambda consumer",[288,2243,2244],{},"Scale consumers ≠ API",[270,2246,2247,2250,2256],{},[288,2248,2249],{},"Idempotency + inbox",[288,2251,2252,2253],{},"Exactly-once ",[231,2254,2255],{},"effect",[288,2257,2258],{},"Blips, webhook dupes",[270,2260,2261,2266,2269],{},[288,2262,2263,2265],{},[141,2264,332],{}," stubs",[288,2267,2268],{},"Real partner HTTP, same port",[288,2270,2271],{},"Adapter swap",[270,2273,2274,2280,2283],{},[288,2275,2276,2279],{},[141,2277,2278],{},"X-Correlation-Id"," + DLQ counters",[288,2281,2282],{},"Traces, metrics, alarms",[288,2284,2285],{},"Operability",[116,2287,2289],{"className":2288},[119],[121,2290,2291,2294,2295,2298,2299,2302,2303,2306,2307,2310,2311,2314,2315,2318,2319,2322,2323,148],{},[124,2292,2293],{},"At-least-once is the default."," SQS (and webhooks) can deliver more than once. ",[124,2296,2297],{},"Visibility timeout:"," while a worker processes a message, others don’t see it; if the process dies before delete/ack, the message reappears — that ",[231,2300,2301],{},"is"," the duplicate. Design for at-least-once delivery + idempotent handlers (outbox publish once logically; inbox / ",[141,2304,2305],{},"eventId"," / Idempotency-Key for effects). ",[124,2308,2309],{},"SNS"," = publish once, fan-out to many queues; ",[124,2312,2313],{},"SQS"," = competing consumers on one queue. ",[124,2316,2317],{},"DLQ"," = park poison after N fails and alert — don’t retry forever. Don’t bet on exactly-once ",[231,2320,2321],{},"delivery","; aim for exactly-once ",[231,2324,2255],{},[116,2326,2328],{"className":2327},[119],[121,2329,2330],{},"Scale target: thousands of companies × employees × monthly payroll runs without leave-drift — not enrol QPS theatre.",[116,2332,2334,2340],{"className":2333},[187,188,189],[191,2335,2337],{"id":2336},"_13-agentic-delivery",[124,2338,2339],{},"13. Agentic delivery",[121,2341,2342],{},[200,2343,2344],{"href":202},[124,2345,205],{},[116,2347,2349],{"className":2348},[119],[121,2350,2351],{},"What kept velocity from deleting the design:",[739,2353,2354,2360,2375,2382],{},[742,2355,2356,2359],{},[124,2357,2358],{},"Spec Kit"," — constitution → specify → plan → tasks → implement.",[742,2361,2362,2365,2366,512,2369,512,2372,148],{},[124,2363,2364],{},"Domain skills"," — ",[141,2367,2368],{},"insurance-domain",[141,2370,2371],{},"insurer-acl",[141,2373,2374],{},"insurance-demo",[742,2376,2377,2381],{},[124,2378,2379],{},[141,2380,2204],{}," — shared ports for humans and agents.",[742,2383,2384,2387],{},[124,2385,2386],{},"Subagents + browser"," — explore in parallel, verify Cover / Docs on localhost.",[116,2389,2391],{"className":2390},[119],[121,2392,2393,2394,2396],{},"Clarifications locked ~30 POC defaults (",[141,2395,1239],{}," month, cents canonical, Failed re-enrolable, terminate wins races, …). That is why agents did not invent a synchronous Active shortcut.",[517,2398,2400],{"className":519,"code":2399,"language":521,"meta":522,"style":522},"flowchart LR\n  subgraph Spec[\"Spec Kit\"]\n    C[Constitution]\n    S[Spec + clarifications]\n    P[Plan / tasks]\n    I[Implement]\n  end\n  subgraph Skills[\"Skills\"]\n    D[insurance-domain]\n    A[insurer-acl]\n    M[insurance-demo]\n  end\n  C --> S --> P --> I\n  D --> I\n  A --> I\n  M --> I\n  I --> Demo[Cover + curls + tests]\n",[141,2401,2402,2407,2412,2417,2422,2427,2432,2436,2441,2446,2451,2456,2460,2465,2470,2475,2480],{"__ignoreMap":522},[526,2403,2404],{"class":528,"line":529},[526,2405,2406],{},"flowchart LR\n",[526,2408,2409],{"class":528,"line":535},[526,2410,2411],{},"  subgraph Spec[\"Spec Kit\"]\n",[526,2413,2414],{"class":528,"line":541},[526,2415,2416],{},"    C[Constitution]\n",[526,2418,2419],{"class":528,"line":547},[526,2420,2421],{},"    S[Spec + clarifications]\n",[526,2423,2424],{"class":528,"line":553},[526,2425,2426],{},"    P[Plan / tasks]\n",[526,2428,2429],{"class":528,"line":559},[526,2430,2431],{},"    I[Implement]\n",[526,2433,2434],{"class":528,"line":565},[526,2435,562],{},[526,2437,2438],{"class":528,"line":571},[526,2439,2440],{},"  subgraph Skills[\"Skills\"]\n",[526,2442,2443],{"class":528,"line":577},[526,2444,2445],{},"    D[insurance-domain]\n",[526,2447,2448],{"class":528,"line":583},[526,2449,2450],{},"    A[insurer-acl]\n",[526,2452,2453],{"class":528,"line":589},[526,2454,2455],{},"    M[insurance-demo]\n",[526,2457,2458],{"class":528,"line":595},[526,2459,562],{},[526,2461,2462],{"class":528,"line":601},[526,2463,2464],{},"  C --> S --> P --> I\n",[526,2466,2467],{"class":528,"line":606},[526,2468,2469],{},"  D --> I\n",[526,2471,2472],{"class":528,"line":612},[526,2473,2474],{},"  A --> I\n",[526,2476,2477],{"class":528,"line":618},[526,2478,2479],{},"  M --> I\n",[526,2481,2482],{"class":528,"line":624},[526,2483,2484],{},"  I --> Demo[Cover + curls + tests]\n",[116,2486,2488,2494],{"className":2487},[187,188,189],[191,2489,2491],{"id":2490},"_14-what-transfers",[124,2492,2493],{},"14. What transfers",[121,2495,2496],{},[200,2497,2498],{"href":202},[124,2499,205],{},[116,2501,2503,2564],{"className":2502},[119],[2504,2505,2506,2512,2518,2524,2530,2536,2542,2552,2558],"ul",{},[742,2507,2508,2511],{},[124,2509,2510],{},"Walls then pipes"," — DDD ownership first; api/worker/queue second.",[742,2513,2514,2517],{},[124,2515,2516],{},"Aggregate + FSM honesty"," — Waiting is a product feature; saga only if branching demands it.",[742,2519,2520,2523],{},[124,2521,2522],{},"Command ≠ event"," — refuseable intent vs past-tense facts.",[742,2525,2526,2529],{},[124,2527,2528],{},"Transactional outbox + idempotency"," — in the schema; at-least-once on the bus.",[742,2531,2532,2535],{},[124,2533,2534],{},"ACL + signed webhooks"," — partner JSON stays at the edge.",[742,2537,2538,2541],{},[124,2539,2540],{},"Tenant authZ"," — 403 is a demo step.",[742,2543,2544,2547,2548,175,2550,148],{},[124,2545,2546],{},"Integer money + explicit period rule"," — ANI cents; ",[141,2549,1243],{},[141,2551,1239],{},[742,2553,2554,2557],{},[124,2555,2556],{},"Edge matrix"," — Spec Kit clarifications beat vibes.",[742,2559,2560,2563],{},[124,2561,2562],{},"Agentic speed with a constitution"," — otherwise the UI lies.",[121,2565,2566],{},"MutuelleFit stays a POC: stubs, seed companies, thin admin. The contracts above are what transfer — whether the bus is in-process or EventBridge.",[2568,2569,2570],"style",{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}",{"title":522,"searchDepth":535,"depth":535,"links":2572},[2573,2574,2575,2576,2577,2582,2583,2584,2585,2589,2590,2591,2592,2593],{"id":193,"depth":535,"text":196},{"id":247,"depth":535,"text":250},{"id":408,"depth":535,"text":411},{"id":447,"depth":535,"text":450},{"id":706,"depth":535,"text":709,"children":2578},[2579,2580,2581],{"id":813,"depth":541,"text":814},{"id":957,"depth":541,"text":958},{"id":1076,"depth":541,"text":1077},{"id":1250,"depth":535,"text":1253},{"id":1314,"depth":535,"text":1317},{"id":1470,"depth":535,"text":1473},{"id":1733,"depth":535,"text":1736,"children":2586},[2587,2588],{"id":1834,"depth":541,"text":1835},{"id":1947,"depth":541,"text":1948},{"id":2020,"depth":535,"text":2023},{"id":2057,"depth":535,"text":2060},{"id":2175,"depth":535,"text":2178},{"id":2336,"depth":535,"text":2339},{"id":2490,"depth":535,"text":2493},"2026-10-14","Enrolment aggregate, transactional outbox, InsurerGateway ACL, ANI cents, command vs event, at-least-once buses, webhook edge, Spec Kit agentic delivery — a DDD vertical you can demo.","md",{"src":223},{},true,{"title":59,"description":2595},"Rfh66lURMwvqA6AIBs3pAoetPdJSW-5UfxcfaFBMldY",[7],[2604],{"title":5,"path":6,"stem":7,"children":2605,"page":98},[2606],{"title":10,"path":11,"stem":12,"children":2607,"page":98},[2608,2609,2610,2611,2612,2613,2614,2615,2616,2617,2618,2619,2620,2621,2622,2623,2624,2625,2626,2627,2628],{"title":15,"path":16,"stem":17},{"title":19,"path":20,"stem":21},{"title":23,"path":24,"stem":25},{"title":27,"path":28,"stem":29},{"title":31,"path":32,"stem":33},{"title":35,"path":36,"stem":37},{"title":39,"path":40,"stem":41},{"title":43,"path":44,"stem":45},{"title":47,"path":48,"stem":49},{"title":51,"path":52,"stem":53},{"title":55,"path":56,"stem":57},{"title":59,"path":60,"stem":61},{"title":63,"path":64,"stem":65},{"title":67,"path":68,"stem":69},{"title":71,"path":72,"stem":73},{"title":75,"path":76,"stem":77},{"title":79,"path":80,"stem":81},{"title":83,"path":84,"stem":85},{"title":87,"path":88,"stem":89},{"title":91,"path":92,"stem":93},{"title":95,"path":96,"stem":97},[2630,4008],{"id":2631,"title":19,"authors":2632,"badge":2635,"body":2637,"date":4002,"description":4003,"extension":2596,"image":4004,"meta":4005,"navigation":2599,"path":20,"seo":4006,"stem":21,"__hash__":4007},"posts_en/en/blog/10. mikeshub.md",[2633],{"name":103,"description":104,"to":105,"avatar":2634},{"src":107},{"label":2636,"color":110,"variant":111},"Systems, AWP, Spec Kit",{"type":113,"value":2638,"toc":3993},[2639,2642,2674,2705,2716,2735,2750,2771,2780,2887,2931,2937,3018,3033,3042,3069,3086,3231,3246,3261,3291,3368,3384,3475,3490,3499,3515,3521,3560,3577,3662,3677,3710,3796,3813,3828,3919,3949,3958,3973,3990],[2640,2641],"br",{},[116,2643,2645],{"className":2644},[119],[121,2646,2647,2650,2651,2653,2654,2661,2662,2665,2666,2673],{},[124,2648,2649],{},"MikesHub"," is a Tauri 2 + React desk for waking local demos from ",[141,2652,2204],{},": Start/Stop, Preview, links, Ports & Apps, schema, DBeaver. The interesting part is not the chrome — it is ",[124,2655,2656,2657,2660],{},"how the hub decides that ",[141,2658,2659],{},":5173"," belongs to you",", how it ",[124,2663,2664],{},"stops the wrong holder"," before Start, and how ",[124,2667,2668,2669,2672],{},"one ",[141,2670,2671],{},"lsof"," pass"," feeds both UI tables without melting the machine.",[116,2675,2677],{"className":2676},[119],[121,2678,2679,2680,2683,2684,1240,2686,2689,2690,2693,2694,2697,2698,512,2701,2704],{},"I built it with ",[124,2681,2682],{},"Cursor agents",", but the pacing was not chat roulette. Feature work sat under ",[124,2685,2358],{},[141,2687,2688],{},"001-local-project-hub","). Day-to-day agent behaviour followed ",[124,2691,2692],{},"AWP"," (Agentic Workflow Protocol — ",[141,2695,2696],{},"agentic-sdlc/AWP.md"," on this site’s repo and sibling projects): human leads, ",[141,2699,2700],{},"awp update → awp commit → awp next",[141,2702,2703],{},"commitStandard",", no invented scope. Spec Kit owns the feature contract; AWP owns how the agent is allowed to move.",[116,2706,2709],{"className":2707},[2708],"my-8",[121,2710,2711],{},[2712,2713],"img",{"alt":2714,"src":2715},"Ports & Apps — declared conflicts, cwd ownership, RSS","/blog/mikeshub/02-ports-ownership.png",[116,2717,2719],{"className":2718},[119],[121,2720,2721],{},[231,2722,2723,2724,2727,2728,512,2731,2734],{},"Ports & Apps: enrolled ports are reserved; ownership is process ",[124,2725,2726],{},"cwd"," (and args). Banner shows declared conflicts (",[141,2729,2730],{},":3000",[141,2732,2733],{},":8088","). Green chips are hub-known listeners; red are conflicted or contested.",[116,2736,2738,2744],{"className":2737},[187,188,189],[191,2739,2741],{"id":2740},"_1-the-hard-problem-listening-mine",[124,2742,2743],{},"1. The hard problem: “listening” ≠ “mine”",[121,2745,2746],{},[200,2747,2748],{"href":202},[124,2749,205],{},[116,2751,2753],{"className":2752},[119],[121,2754,2755,2756,2759,2760,2762,2763,2766,2767,2770],{},"A TCP ",[141,2757,2758],{},"LISTEN"," on a declared port is necessary but not sufficient. Vite loves ",[141,2761,2659],{},". If another repo already holds it, marking ",[231,2764,2765],{},"this"," project ",[141,2768,2769],{},"running"," is a lie — and Preview opens the wrong app.",[116,2772,2774],{"className":2773},[119],[121,2775,2776,2777,1164],{},"Classification is a three-state hold on each ",[141,2778,2779],{},"(declared_port, project_path)",[517,2781,2785],{"className":2782,"code":2783,"language":2784,"meta":522,"style":522},"language-rust shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","// apps/hub/src-tauri/src/ports/ownership.rs\n\npub enum PortHold {\n    Free,\n    HeldByOwner,\n    Hijacked,\n}\n\npub fn processes_belong_to_project(port: &ListeningPort, project_path: &str) -> bool {\n    port.processes.iter().any(|proc| {\n        path_belongs(&proc.cwd, project_path) || path_belongs(&proc.args, project_path)\n    })\n}\n\npub fn classify_hold(live: Option\u003C&ListeningPort>, project_path: &str) -> PortHold {\n    match live {\n        None => PortHold::Free,\n        Some(row) if processes_belong_to_project(row, project_path) => PortHold::HeldByOwner,\n        Some(_) => PortHold::Hijacked,\n    }\n}\n","rust",[141,2786,2787,2792,2797,2802,2807,2812,2817,2821,2825,2830,2835,2840,2845,2849,2853,2858,2863,2868,2873,2878,2883],{"__ignoreMap":522},[526,2788,2789],{"class":528,"line":529},[526,2790,2791],{},"// apps/hub/src-tauri/src/ports/ownership.rs\n",[526,2793,2794],{"class":528,"line":535},[526,2795,2796],{"emptyLinePlaceholder":2599},"\n",[526,2798,2799],{"class":528,"line":541},[526,2800,2801],{},"pub enum PortHold {\n",[526,2803,2804],{"class":528,"line":547},[526,2805,2806],{},"    Free,\n",[526,2808,2809],{"class":528,"line":553},[526,2810,2811],{},"    HeldByOwner,\n",[526,2813,2814],{"class":528,"line":559},[526,2815,2816],{},"    Hijacked,\n",[526,2818,2819],{"class":528,"line":565},[526,2820,1177],{},[526,2822,2823],{"class":528,"line":571},[526,2824,2796],{"emptyLinePlaceholder":2599},[526,2826,2827],{"class":528,"line":577},[526,2828,2829],{},"pub fn processes_belong_to_project(port: &ListeningPort, project_path: &str) -> bool {\n",[526,2831,2832],{"class":528,"line":583},[526,2833,2834],{},"    port.processes.iter().any(|proc| {\n",[526,2836,2837],{"class":528,"line":589},[526,2838,2839],{},"        path_belongs(&proc.cwd, project_path) || path_belongs(&proc.args, project_path)\n",[526,2841,2842],{"class":528,"line":595},[526,2843,2844],{},"    })\n",[526,2846,2847],{"class":528,"line":601},[526,2848,1177],{},[526,2850,2851],{"class":528,"line":606},[526,2852,2796],{"emptyLinePlaceholder":2599},[526,2854,2855],{"class":528,"line":612},[526,2856,2857],{},"pub fn classify_hold(live: Option\u003C&ListeningPort>, project_path: &str) -> PortHold {\n",[526,2859,2860],{"class":528,"line":618},[526,2861,2862],{},"    match live {\n",[526,2864,2865],{"class":528,"line":624},[526,2866,2867],{},"        None => PortHold::Free,\n",[526,2869,2870],{"class":528,"line":630},[526,2871,2872],{},"        Some(row) if processes_belong_to_project(row, project_path) => PortHold::HeldByOwner,\n",[526,2874,2875],{"class":528,"line":635},[526,2876,2877],{},"        Some(_) => PortHold::Hijacked,\n",[526,2879,2880],{"class":528,"line":641},[526,2881,2882],{},"    }\n",[526,2884,2885],{"class":528,"line":647},[526,2886,1177],{},[116,2888,2890],{"className":2889},[119],[121,2891,2892,2895,2896,2899,2900,2903,2904,512,2907,2910,2911,2914,2915,2918,2919,2922,2923,2930],{},[141,2893,2894],{},"path_belongs"," normalises separators and accepts exact path, prefix (",[141,2897,2898],{},"project/…","), or args that embed the project root (common for ",[141,2901,2902],{},"node …/project/node_modules/…","). Infra services (",[141,2905,2906],{},"postgres",[141,2908,2909],{},"redis",", classic ",[141,2912,2913],{},"5432","/",[141,2916,2917],{},"6379",") are ",[124,2920,2921],{},"claimed in the UI"," but ",[124,2924,2925,2926,2929],{},"ignored for ",[141,2927,2928],{},"ports_live"," / Running"," — a shared DB must not make every enrolled app look up.",[116,2932,2934],{"className":2933},[119],[121,2935,2936],{},"Reconcile folds that into project status:",[517,2938,2940],{"className":2782,"code":2939,"language":2784,"meta":522,"style":522},"// apps/hub/src-tauri/src/ports/mod.rs — reconcile_live_status (excerpt)\n\nlet live_rows = list_system_listening(std::slice::from_ref(project)).unwrap_or_default();\nlet mut owned_live = false;\nfor service in &project.manifest.services {\n    let Some(port) = service.port else { continue };\n    if is_infra_service(service) {\n        continue;\n    }\n    let row = live_rows.iter().find(|p| p.port == port);\n    if classify_hold(row, &project.path) == PortHold::HeldByOwner {\n        owned_live = true;\n        break;\n    }\n}\nproject.ports_live = owned_live;\n",[141,2941,2942,2947,2951,2956,2961,2966,2971,2976,2981,2985,2990,2995,3000,3005,3009,3013],{"__ignoreMap":522},[526,2943,2944],{"class":528,"line":529},[526,2945,2946],{},"// apps/hub/src-tauri/src/ports/mod.rs — reconcile_live_status (excerpt)\n",[526,2948,2949],{"class":528,"line":535},[526,2950,2796],{"emptyLinePlaceholder":2599},[526,2952,2953],{"class":528,"line":541},[526,2954,2955],{},"let live_rows = list_system_listening(std::slice::from_ref(project)).unwrap_or_default();\n",[526,2957,2958],{"class":528,"line":547},[526,2959,2960],{},"let mut owned_live = false;\n",[526,2962,2963],{"class":528,"line":553},[526,2964,2965],{},"for service in &project.manifest.services {\n",[526,2967,2968],{"class":528,"line":559},[526,2969,2970],{},"    let Some(port) = service.port else { continue };\n",[526,2972,2973],{"class":528,"line":565},[526,2974,2975],{},"    if is_infra_service(service) {\n",[526,2977,2978],{"class":528,"line":571},[526,2979,2980],{},"        continue;\n",[526,2982,2983],{"class":528,"line":577},[526,2984,2882],{},[526,2986,2987],{"class":528,"line":583},[526,2988,2989],{},"    let row = live_rows.iter().find(|p| p.port == port);\n",[526,2991,2992],{"class":528,"line":589},[526,2993,2994],{},"    if classify_hold(row, &project.path) == PortHold::HeldByOwner {\n",[526,2996,2997],{"class":528,"line":595},[526,2998,2999],{},"        owned_live = true;\n",[526,3001,3002],{"class":528,"line":601},[526,3003,3004],{},"        break;\n",[526,3006,3007],{"class":528,"line":606},[526,3008,2882],{},[526,3010,3011],{"class":528,"line":612},[526,3012,1177],{},[526,3014,3015],{"class":528,"line":618},[526,3016,3017],{},"project.ports_live = owned_live;\n",[116,3019,3021,3027],{"className":3020},[187,188,189],[191,3022,3024],{"id":3023},"_2-start-must-reclaim-not-politely-fail",[124,3025,3026],{},"2. Start must reclaim, not politely fail",[121,3028,3029],{},[200,3030,3031],{"href":202},[124,3032,205],{},[116,3034,3036],{"className":3035},[2708],[121,3037,3038],{},[2712,3039],{"alt":3040,"src":3041},"Project workspace — Start follows hub.yaml, then reclaim","/blog/mikeshub/03-project-detail.png",[116,3043,3045],{"className":3044},[119],[121,3046,3047],{},[231,3048,3049,3050,3053,3054,3056,3057,3059,3060,3062,3063,3065,3066,148],{},"Multi-service vertical (",[141,3051,3052],{},"insurance-vertical","): UI ",[141,3055,2201],{},", API ",[141,3058,2193],{},", Postgres ",[141,3061,2197],{},", worker without a listen port. The sticky note is the contract: reload ",[141,3064,2204],{}," → stop wrong holders → ",[141,3067,3068],{},"scripts.start",[116,3070,3072],{"className":3071},[119],[121,3073,3074,3075,3078,3079,3082,3083,3085],{},"On Start, if a reserved ",[124,3076,3077],{},"app"," port is ",[141,3080,3081],{},"Hijacked",", the hub TERMs those PIDs, invalidates the listen cache, waits briefly for the OS to release sockets, then runs ",[141,3084,3068],{},". Skipping infra avoids murdering a shared Postgres because your UI port was free.",[517,3087,3089],{"className":2782,"code":3088,"language":2784,"meta":522,"style":522},"// apps/hub/src-tauri/src/ports/mod.rs — reclaim_mismatched_ports (core loop)\n\nfor service in &project.manifest.services {\n    let Some(port) = service.port else { continue };\n    if is_infra_service(service) {\n        continue;\n    }\n    let Some(row) = all.iter().find(|p| p.port == port) else {\n        continue;\n    };\n    if classify_hold(Some(row), &project.path) != PortHold::Hijacked {\n        continue;\n    }\n    for proc in &row.processes {\n        if !pids.contains(&proc.pid) {\n            pids.push(proc.pid);\n        }\n    }\n    notes.push(format!(\n        \"Stopped wrong holder on :{} ({}) — reserved for {} / {}\",\n        port,\n        holder_summary(row),\n        project.manifest.name,\n        service.name\n    ));\n}\n\nlistening::invalidate_listen_cache();\nlet killed = listening::kill_pids(&pids, false)?;\nstd::thread::sleep(Duration::from_millis(500));\n",[141,3090,3091,3096,3100,3104,3108,3112,3116,3120,3125,3129,3134,3139,3143,3147,3152,3157,3162,3167,3171,3176,3181,3186,3191,3196,3201,3206,3210,3214,3219,3225],{"__ignoreMap":522},[526,3092,3093],{"class":528,"line":529},[526,3094,3095],{},"// apps/hub/src-tauri/src/ports/mod.rs — reclaim_mismatched_ports (core loop)\n",[526,3097,3098],{"class":528,"line":535},[526,3099,2796],{"emptyLinePlaceholder":2599},[526,3101,3102],{"class":528,"line":541},[526,3103,2965],{},[526,3105,3106],{"class":528,"line":547},[526,3107,2970],{},[526,3109,3110],{"class":528,"line":553},[526,3111,2975],{},[526,3113,3114],{"class":528,"line":559},[526,3115,2980],{},[526,3117,3118],{"class":528,"line":565},[526,3119,2882],{},[526,3121,3122],{"class":528,"line":571},[526,3123,3124],{},"    let Some(row) = all.iter().find(|p| p.port == port) else {\n",[526,3126,3127],{"class":528,"line":577},[526,3128,2980],{},[526,3130,3131],{"class":528,"line":583},[526,3132,3133],{},"    };\n",[526,3135,3136],{"class":528,"line":589},[526,3137,3138],{},"    if classify_hold(Some(row), &project.path) != PortHold::Hijacked {\n",[526,3140,3141],{"class":528,"line":595},[526,3142,2980],{},[526,3144,3145],{"class":528,"line":601},[526,3146,2882],{},[526,3148,3149],{"class":528,"line":606},[526,3150,3151],{},"    for proc in &row.processes {\n",[526,3153,3154],{"class":528,"line":612},[526,3155,3156],{},"        if !pids.contains(&proc.pid) {\n",[526,3158,3159],{"class":528,"line":618},[526,3160,3161],{},"            pids.push(proc.pid);\n",[526,3163,3164],{"class":528,"line":624},[526,3165,3166],{},"        }\n",[526,3168,3169],{"class":528,"line":630},[526,3170,2882],{},[526,3172,3173],{"class":528,"line":635},[526,3174,3175],{},"    notes.push(format!(\n",[526,3177,3178],{"class":528,"line":641},[526,3179,3180],{},"        \"Stopped wrong holder on :{} ({}) — reserved for {} / {}\",\n",[526,3182,3183],{"class":528,"line":647},[526,3184,3185],{},"        port,\n",[526,3187,3188],{"class":528,"line":653},[526,3189,3190],{},"        holder_summary(row),\n",[526,3192,3193],{"class":528,"line":659},[526,3194,3195],{},"        project.manifest.name,\n",[526,3197,3198],{"class":528,"line":665},[526,3199,3200],{},"        service.name\n",[526,3202,3203],{"class":528,"line":671},[526,3204,3205],{},"    ));\n",[526,3207,3208],{"class":528,"line":677},[526,3209,1177],{},[526,3211,3212],{"class":528,"line":683},[526,3213,2796],{"emptyLinePlaceholder":2599},[526,3215,3216],{"class":528,"line":689},[526,3217,3218],{},"listening::invalidate_listen_cache();\n",[526,3220,3222],{"class":528,"line":3221},29,[526,3223,3224],{},"let killed = listening::kill_pids(&pids, false)?;\n",[526,3226,3228],{"class":528,"line":3227},30,[526,3229,3230],{},"std::thread::sleep(Duration::from_millis(500));\n",[116,3232,3234,3240],{"className":3233},[187,188,189],[191,3235,3237],{"id":3236},"_3-performance-one-listen-scan-many-consumers",[124,3238,3239],{},"3. Performance: one listen scan, many consumers",[121,3241,3242],{},[200,3243,3244],{"href":202},[124,3245,205],{},[116,3247,3249],{"className":3248},[119],[121,3250,3251,3252,774,3255,2914,3257,3260],{},"Early Ports UI felt sticky because every tick did ",[124,3253,3254],{},"multiple",[141,3256,2671],{},[141,3258,3259],{},"ps"," walks (per-project reconcile + dual tables + aggressive React loading thrash). The fix is boring systems work:",[2504,3262,3263,3269,3277,3285],{},[742,3264,3265,3268],{},[124,3266,3267],{},"Global listen cache"," (TTL ~4s), invalidated on kill / refresh",[742,3270,3271,3276],{},[124,3272,3273],{},[141,3274,3275],{},"ports_snapshot",": one scan → decorate declared matches → derive service runtimes",[742,3278,3279,3284],{},[124,3280,3281],{},[141,3282,3283],{},"projects_snapshot",": clone without re-reconciling every project",[742,3286,3287,3288],{},"UI: soft poll (no full-panel spinner), floor ≥5s, mount ",[124,3289,3290],{},"cards XOR table",[517,3292,3294],{"className":2782,"code":3293,"language":2784,"meta":522,"style":522},"// apps/hub/src-tauri/src/commands/ports.rs\n\npub fn ports_snapshot(state: State\u003C'_, AppState>) -> HubResult\u003CPortsSnapshot> {\n    // One listen scan (cached briefly) drives both tables — avoid double lsof/ps.\n    let projects = state.projects_snapshot();\n    let listening = ports::list_system_listening(&projects)?;\n    let services = ports::list_service_runtimes_from(&projects, &listening);\n    let total_rss_bytes = listening.iter().map(|p| p.rss_bytes).sum();\n    Ok(PortsSnapshot {\n        services,\n        listening,\n        total_rss_bytes,\n        total_rss_human: listening::format_bytes(total_rss_bytes),\n    })\n}\n",[141,3295,3296,3301,3305,3310,3315,3320,3325,3330,3335,3340,3345,3350,3355,3360,3364],{"__ignoreMap":522},[526,3297,3298],{"class":528,"line":529},[526,3299,3300],{},"// apps/hub/src-tauri/src/commands/ports.rs\n",[526,3302,3303],{"class":528,"line":535},[526,3304,2796],{"emptyLinePlaceholder":2599},[526,3306,3307],{"class":528,"line":541},[526,3308,3309],{},"pub fn ports_snapshot(state: State\u003C'_, AppState>) -> HubResult\u003CPortsSnapshot> {\n",[526,3311,3312],{"class":528,"line":547},[526,3313,3314],{},"    // One listen scan (cached briefly) drives both tables — avoid double lsof/ps.\n",[526,3316,3317],{"class":528,"line":553},[526,3318,3319],{},"    let projects = state.projects_snapshot();\n",[526,3321,3322],{"class":528,"line":559},[526,3323,3324],{},"    let listening = ports::list_system_listening(&projects)?;\n",[526,3326,3327],{"class":528,"line":565},[526,3328,3329],{},"    let services = ports::list_service_runtimes_from(&projects, &listening);\n",[526,3331,3332],{"class":528,"line":571},[526,3333,3334],{},"    let total_rss_bytes = listening.iter().map(|p| p.rss_bytes).sum();\n",[526,3336,3337],{"class":528,"line":577},[526,3338,3339],{},"    Ok(PortsSnapshot {\n",[526,3341,3342],{"class":528,"line":583},[526,3343,3344],{},"        services,\n",[526,3346,3347],{"class":528,"line":589},[526,3348,3349],{},"        listening,\n",[526,3351,3352],{"class":528,"line":595},[526,3353,3354],{},"        total_rss_bytes,\n",[526,3356,3357],{"class":528,"line":601},[526,3358,3359],{},"        total_rss_human: listening::format_bytes(total_rss_bytes),\n",[526,3361,3362],{"class":528,"line":606},[526,3363,2844],{},[526,3365,3366],{"class":528,"line":612},[526,3367,1177],{},[116,3369,3371],{"className":3370},[119],[121,3372,3373,3374,3377,3378,299,3380,3383],{},"The scan path itself is still expensive by nature: ",[141,3375,3376],{},"lsof -nP -iTCP -sTCP:LISTEN",", then batch ",[141,3379,3259],{},[141,3381,3382],{},"lsof -a -d cwd -p …"," for RSS/cwd/parent. Caching is what makes polling acceptable.",[517,3385,3387],{"className":2782,"code":3386,"language":2784,"meta":522,"style":522},"// apps/hub/src-tauri/src/ports/listening.rs — cache gate\n\nfn cached_or_scan() -> HubResult\u003CVec\u003CListeningPort>> {\n    {\n        let guard = LISTEN_CACHE.lock();\n        if let Some(cache) = guard.as_ref() {\n            if cache.at.elapsed() \u003C LISTEN_CACHE_TTL {\n                return Ok(cache.ports.clone());\n            }\n        }\n    }\n    let ports = scan_listening_ports()?;\n    *LISTEN_CACHE.lock() = Some(ListenCache {\n        at: Instant::now(),\n        ports: ports.clone(),\n    });\n    Ok(ports)\n}\n",[141,3388,3389,3394,3398,3403,3408,3413,3418,3423,3428,3433,3437,3441,3446,3451,3456,3461,3466,3471],{"__ignoreMap":522},[526,3390,3391],{"class":528,"line":529},[526,3392,3393],{},"// apps/hub/src-tauri/src/ports/listening.rs — cache gate\n",[526,3395,3396],{"class":528,"line":535},[526,3397,2796],{"emptyLinePlaceholder":2599},[526,3399,3400],{"class":528,"line":541},[526,3401,3402],{},"fn cached_or_scan() -> HubResult\u003CVec\u003CListeningPort>> {\n",[526,3404,3405],{"class":528,"line":547},[526,3406,3407],{},"    {\n",[526,3409,3410],{"class":528,"line":553},[526,3411,3412],{},"        let guard = LISTEN_CACHE.lock();\n",[526,3414,3415],{"class":528,"line":559},[526,3416,3417],{},"        if let Some(cache) = guard.as_ref() {\n",[526,3419,3420],{"class":528,"line":565},[526,3421,3422],{},"            if cache.at.elapsed() \u003C LISTEN_CACHE_TTL {\n",[526,3424,3425],{"class":528,"line":571},[526,3426,3427],{},"                return Ok(cache.ports.clone());\n",[526,3429,3430],{"class":528,"line":577},[526,3431,3432],{},"            }\n",[526,3434,3435],{"class":528,"line":583},[526,3436,3166],{},[526,3438,3439],{"class":528,"line":589},[526,3440,2882],{},[526,3442,3443],{"class":528,"line":595},[526,3444,3445],{},"    let ports = scan_listening_ports()?;\n",[526,3447,3448],{"class":528,"line":601},[526,3449,3450],{},"    *LISTEN_CACHE.lock() = Some(ListenCache {\n",[526,3452,3453],{"class":528,"line":606},[526,3454,3455],{},"        at: Instant::now(),\n",[526,3457,3458],{"class":528,"line":612},[526,3459,3460],{},"        ports: ports.clone(),\n",[526,3462,3463],{"class":528,"line":618},[526,3464,3465],{},"    });\n",[526,3467,3468],{"class":528,"line":624},[526,3469,3470],{},"    Ok(ports)\n",[526,3472,3473],{"class":528,"line":630},[526,3474,1177],{},[116,3476,3478,3484],{"className":3477},[187,188,189],[191,3479,3481],{"id":3480},"_4-dbeaver-process-lifecycle-vs-connection-semantics",[124,3482,3483],{},"4. DBeaver: process lifecycle vs connection semantics",[121,3485,3486],{},[200,3487,3488],{"href":202},[124,3489,205],{},[116,3491,3493],{"className":3492},[2708],[121,3494,3495],{},[2712,3496],{"alt":3497,"src":3498},"Workspace with Database schema → DBeaver","/blog/mikeshub/01-project-workspace.png",[116,3500,3502],{"className":3501},[119],[121,3503,3504],{},[231,3505,3506,3507,3510,3511,3514],{},"Project desk for ",[141,3508,3509],{},"krishna360",": links include ",[124,3512,3513],{},"Database schema"," (ER + open DBeaver). Connection details resolve from the project’s local env files (never committed); cloud dashboard URLs stay out of screenshots.",[116,3516,3518],{"className":3517},[119],[121,3519,3520],{},"Three failure modes taught the API:",[739,3522,3523,3532,3550],{},[742,3524,3525,3531],{},[124,3526,3527,3530],{},[141,3528,3529],{},".status()"," on the DBeaver binary"," — GUI never exits → Tauri invoke hangs forever.",[742,3533,3534,3539,3540,1200,3543,774,3546,3549],{},[124,3535,3536],{},[141,3537,3538],{},"openConsole=true"," — DBeaver’s instance server opens an SQL ",[231,3541,3542],{},"editor tab",[124,3544,3545],{},"skips",[141,3547,3548],{},"connectToDataSource"," (navigator connect).",[742,3551,3552,3555,3556,3559],{},[124,3553,3554],{},"Shared personal workspace"," — demos polluted with every other connection; the hub writes a ",[124,3557,3558],{},"project-only"," datasource file instead of reusing your personal graph.",[116,3561,3563],{"className":3562},[119],[121,3564,3565,3566,3569,3570,3573,3574,3576],{},"The path that works: write an isolated Eclipse workspace under Application Support, quit only prior MikesHub-workspace PIDs, spawn with ",[141,3567,3568],{},"-newInstance -data \u003Cws> -closeTabs -con '…|openConsole=false|connect=true|…'"," — credentials come from the project’s local env at runtime and are ",[124,3571,3572],{},"not"," embedded in ",[141,3575,2204],{}," or blog assets.",[517,3578,3580],{"className":2782,"code":3579,"language":2784,"meta":522,"style":522},"// apps/hub/src-tauri/src/db/mod.rs — open_dbeaver (shape)\n\nlet workspace = mikeshub_dbeaver_workspace()?;\nwrite_project_only_datasource(/* id, host, user, jdbc — sole connection */)?;\n\nquit_mikeshub_dbeaver(&ws); // do not quit the user’s main DBeaver\n\nCommand::new(&bin)\n    .args([\n        \"-newInstance\",\n        \"-data\", &ws,\n        \"-closeTabs\",\n        \"-con\", &con, // openConsole=false · connect=true — no secrets in this snippet\n        \"-bringToFront\",\n    ])\n    .spawn()?; // never .status() on the GUI process\n",[141,3581,3582,3587,3591,3596,3601,3605,3610,3614,3619,3624,3629,3634,3639,3647,3652,3657],{"__ignoreMap":522},[526,3583,3584],{"class":528,"line":529},[526,3585,3586],{},"// apps/hub/src-tauri/src/db/mod.rs — open_dbeaver (shape)\n",[526,3588,3589],{"class":528,"line":535},[526,3590,2796],{"emptyLinePlaceholder":2599},[526,3592,3593],{"class":528,"line":541},[526,3594,3595],{},"let workspace = mikeshub_dbeaver_workspace()?;\n",[526,3597,3598],{"class":528,"line":547},[526,3599,3600],{},"write_project_only_datasource(/* id, host, user, jdbc — sole connection */)?;\n",[526,3602,3603],{"class":528,"line":553},[526,3604,2796],{"emptyLinePlaceholder":2599},[526,3606,3607],{"class":528,"line":559},[526,3608,3609],{},"quit_mikeshub_dbeaver(&ws); // do not quit the user’s main DBeaver\n",[526,3611,3612],{"class":528,"line":565},[526,3613,2796],{"emptyLinePlaceholder":2599},[526,3615,3616],{"class":528,"line":571},[526,3617,3618],{},"Command::new(&bin)\n",[526,3620,3621],{"class":528,"line":577},[526,3622,3623],{},"    .args([\n",[526,3625,3626],{"class":528,"line":583},[526,3627,3628],{},"        \"-newInstance\",\n",[526,3630,3631],{"class":528,"line":589},[526,3632,3633],{},"        \"-data\", &ws,\n",[526,3635,3636],{"class":528,"line":595},[526,3637,3638],{},"        \"-closeTabs\",\n",[526,3640,3641,3644],{"class":528,"line":601},[526,3642,3643],{},"        \"-con\", &con,",[526,3645,3646],{}," // openConsole=false · connect=true — no secrets in this snippet\n",[526,3648,3649],{"class":528,"line":606},[526,3650,3651],{},"        \"-bringToFront\",\n",[526,3653,3654],{"class":528,"line":612},[526,3655,3656],{},"    ])\n",[526,3658,3659],{"class":528,"line":618},[526,3660,3661],{},"    .spawn()?; // never .status() on the GUI process\n",[116,3663,3665,3671],{"className":3664},[187,188,189],[191,3666,3668],{"id":3667},"_5-enroll-update-without-clobbering-hand-tuned-yaml",[124,3669,3670],{},"5. Enroll update without clobbering hand-tuned YAML",[121,3672,3673],{},[200,3674,3675],{"href":202},[124,3676,205],{},[116,3678,3680],{"className":3679},[119],[121,3681,3682,3684,3685,3688,3689,3692,3693,3696,3697,2914,3700,2914,3703,3706,3707,3709],{},[141,3683,2204],{}," is the contract you commit. Auto-detect is useful once; afterwards ",[124,3686,3687],{},"Update"," must merge: keep custom ports/scripts/links, append only ",[231,3690,3691],{},"new"," services — matched by name ",[124,3694,3695],{},"or"," role heuristics (",[141,3698,3699],{},"api",[141,3701,3702],{},"web",[141,3704,3705],{},"db",") ",[124,3708,3695],{}," same port.",[517,3711,3713],{"className":2782,"code":3712,"language":2784,"meta":522,"style":522},"// apps/hub/src-tauri/src/enroll.rs — merge_with_existing (service merge)\n\nfor svc in detected.services {\n    let exists = merged.iter().any(|m| {\n        let a = m.name.to_lowercase();\n        let b = svc.name.to_lowercase();\n        a == b\n            || (is_api_role(&a) && is_api_role(&b))\n            || (is_web_role(&a) && is_web_role(&b))\n            || (is_db_role(&a) && is_db_role(&b))\n            || m.port == svc.port\n    });\n    if !exists {\n        merged.push(svc);\n    }\n}\ndetected.services = dedupe_services(merged);\n",[141,3714,3715,3720,3724,3729,3734,3739,3744,3749,3754,3759,3764,3769,3773,3778,3783,3787,3791],{"__ignoreMap":522},[526,3716,3717],{"class":528,"line":529},[526,3718,3719],{},"// apps/hub/src-tauri/src/enroll.rs — merge_with_existing (service merge)\n",[526,3721,3722],{"class":528,"line":535},[526,3723,2796],{"emptyLinePlaceholder":2599},[526,3725,3726],{"class":528,"line":541},[526,3727,3728],{},"for svc in detected.services {\n",[526,3730,3731],{"class":528,"line":547},[526,3732,3733],{},"    let exists = merged.iter().any(|m| {\n",[526,3735,3736],{"class":528,"line":553},[526,3737,3738],{},"        let a = m.name.to_lowercase();\n",[526,3740,3741],{"class":528,"line":559},[526,3742,3743],{},"        let b = svc.name.to_lowercase();\n",[526,3745,3746],{"class":528,"line":565},[526,3747,3748],{},"        a == b\n",[526,3750,3751],{"class":528,"line":571},[526,3752,3753],{},"            || (is_api_role(&a) && is_api_role(&b))\n",[526,3755,3756],{"class":528,"line":577},[526,3757,3758],{},"            || (is_web_role(&a) && is_web_role(&b))\n",[526,3760,3761],{"class":528,"line":583},[526,3762,3763],{},"            || (is_db_role(&a) && is_db_role(&b))\n",[526,3765,3766],{"class":528,"line":589},[526,3767,3768],{},"            || m.port == svc.port\n",[526,3770,3771],{"class":528,"line":595},[526,3772,3465],{},[526,3774,3775],{"class":528,"line":601},[526,3776,3777],{},"    if !exists {\n",[526,3779,3780],{"class":528,"line":606},[526,3781,3782],{},"        merged.push(svc);\n",[526,3784,3785],{"class":528,"line":612},[526,3786,2882],{},[526,3788,3789],{"class":528,"line":618},[526,3790,1177],{},[526,3792,3793],{"class":528,"line":624},[526,3794,3795],{},"detected.services = dedupe_services(merged);\n",[116,3797,3799],{"className":3798},[119],[121,3800,3801,3802,3805,3806,3808,3809,3812],{},"That is why AUDIT4 can declare Nuxt ",[141,3803,3804],{},":4444"," plus mcp-ai-act ",[141,3807,2733],{}," (API ",[124,3810,3811],{},"and"," static UI on the same port) without Enroll “refresh” wiping the hand-written Start that runs both trees.",[116,3814,3816,3822],{"className":3815},[187,188,189],[191,3817,3819],{"id":3818},"_6-awp-spec-kit-who-owns-what",[124,3820,3821],{},"6. AWP + Spec Kit: who owns what",[121,3823,3824],{},[200,3825,3826],{"href":202},[124,3827,205],{},[517,3829,3831],{"className":519,"code":3830,"language":521,"meta":522,"style":522},"flowchart TB\n  subgraph Contract[\"Spec Kit — feature authority\"]\n    S[spec.md]\n    P[plan.md]\n    T[tasks.md]\n  end\n  subgraph Pace[\"AWP — agent pacing\"]\n    U[awp update]\n    C[awp commit]\n    N[awp next]\n    U --> C --> N\n  end\n  subgraph Human[\"Human gates\"]\n    H[clarify scope · accept diffs · no silent initiative]\n  end\n  Contract --> Pace\n  Pace --> Human\n  Human -->|merge| Git[(hub.yaml + Rust/TS)]\n",[141,3832,3833,3837,3842,3847,3852,3857,3861,3866,3871,3876,3881,3886,3890,3895,3900,3904,3909,3914],{"__ignoreMap":522},[526,3834,3835],{"class":528,"line":529},[526,3836,532],{},[526,3838,3839],{"class":528,"line":535},[526,3840,3841],{},"  subgraph Contract[\"Spec Kit — feature authority\"]\n",[526,3843,3844],{"class":528,"line":541},[526,3845,3846],{},"    S[spec.md]\n",[526,3848,3849],{"class":528,"line":547},[526,3850,3851],{},"    P[plan.md]\n",[526,3853,3854],{"class":528,"line":553},[526,3855,3856],{},"    T[tasks.md]\n",[526,3858,3859],{"class":528,"line":559},[526,3860,562],{},[526,3862,3863],{"class":528,"line":565},[526,3864,3865],{},"  subgraph Pace[\"AWP — agent pacing\"]\n",[526,3867,3868],{"class":528,"line":571},[526,3869,3870],{},"    U[awp update]\n",[526,3872,3873],{"class":528,"line":577},[526,3874,3875],{},"    C[awp commit]\n",[526,3877,3878],{"class":528,"line":583},[526,3879,3880],{},"    N[awp next]\n",[526,3882,3883],{"class":528,"line":589},[526,3884,3885],{},"    U --> C --> N\n",[526,3887,3888],{"class":528,"line":595},[526,3889,562],{},[526,3891,3892],{"class":528,"line":601},[526,3893,3894],{},"  subgraph Human[\"Human gates\"]\n",[526,3896,3897],{"class":528,"line":606},[526,3898,3899],{},"    H[clarify scope · accept diffs · no silent initiative]\n",[526,3901,3902],{"class":528,"line":612},[526,3903,562],{},[526,3905,3906],{"class":528,"line":618},[526,3907,3908],{},"  Contract --> Pace\n",[526,3910,3911],{"class":528,"line":624},[526,3912,3913],{},"  Pace --> Human\n",[526,3915,3916],{"class":528,"line":630},[526,3917,3918],{},"  Human -->|merge| Git[(hub.yaml + Rust/TS)]\n",[116,3920,3922],{"className":3921},[119],[121,3923,3924,3926,3927,3930,3931,3926,3933,3936,3937,3940,3941,3944,3945,3948],{},[124,3925,2358],{}," answered ",[231,3928,3929],{},"what"," MikesHub is (wake demos, ports view, links, Start Spec). ",[124,3932,2692],{},[231,3934,3935],{},"how"," the agent may proceed: read ",[141,3938,3939],{},"AWP.md"," on any ",[141,3942,3943],{},"awp*"," command; never skip ",[141,3946,3947],{},"update → commit → next"," without permission; ask when “next to the end” is ambiguous; never put “AI” in commit messages; park surprises in Unplanned Tasks.",[116,3950,3952],{"className":3951},[119],[121,3953,3954,3955,3957],{},"Useful agent wins under that envelope: ownership/reclaim design, listen-cache + snapshot, DBeaver CLI archaeology, monorepo local-env resolution (nested app folders). Useful human vetoes: no live Vite iframe inside the hub; never wait on DBeaver’s process; never dump the personal DBeaver graph into a demo; never commit credentials into ",[141,3956,2204],{}," or screenshots.",[116,3959,3961,3967],{"className":3960},[187,188,189],[191,3962,3964],{"id":3963},"closing",[124,3965,3966],{},"Closing",[121,3968,3969],{},[200,3970,3971],{"href":202},[124,3972,205],{},[116,3974,3976],{"className":3975},[119],[121,3977,3978,3979,3982,3983,1200,3986,3989],{},"If you only need a prettier ",[141,3980,3981],{},"npm run dev",", skip MikesHub. If you run many stacks and have been bitten by ",[124,3984,3985],{},"shared ports",[124,3987,3988],{},"half-started"," multi-repo demos, the leverage is the ownership model + reclaim + a single listen snapshot — with Spec Kit for the product spine and AWP so the agent does not outrun the contract.",[2568,3991,3992],{},"html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":522,"searchDepth":535,"depth":535,"links":3994},[3995,3996,3997,3998,3999,4000,4001],{"id":2740,"depth":535,"text":2743},{"id":3023,"depth":535,"text":3026},{"id":3236,"depth":535,"text":3239},{"id":3480,"depth":535,"text":3483},{"id":3667,"depth":535,"text":3670},{"id":3818,"depth":535,"text":3821},{"id":3963,"depth":535,"text":3966},"2026-10-16","How a local demo desk classifies hijacked ports via cwd, snapshots lsof once, opens DBeaver in an isolated workspace — built under Spec Kit + AWP, not vibes.",{"src":2715},{},{"title":19,"description":4003},"F_b9RUINYGAaW3xCXeUYBie62IjP55LvVFAO0of_Ia4",{"id":4009,"title":71,"authors":4010,"badge":4013,"body":4015,"date":4856,"description":4857,"extension":2596,"image":4858,"meta":4860,"navigation":2599,"path":72,"seo":4861,"stem":73,"__hash__":4862},"posts_en/en/blog/building-one-front.md",[4011],{"name":103,"description":104,"to":105,"avatar":4012},{"src":107},{"label":4014,"color":110,"variant":111},"Case study",{"type":113,"value":4016,"toc":4848},[4017,4019,4040,4055,4064,4138,4151,4218,4224,4239,4248,4359,4374,4414,4429,4457,4524,4537,4552,4580,4583,4648,4657,4723,4729,4795,4808,4823,4846],[2640,4018],{},[116,4020,4022,4029],{"className":4021},[119],[121,4023,4024,4025,4028],{},"I do not remember one-front as a roadmap. I remember it as ",[124,4026,4027],{},"time"," — loud weeks, long quiet stretches, then another spike when something needed a place on the internet.",[121,4030,4031,4032,4035,4036,4039],{},"This post is that trail made readable: ",[124,4033,4034],{},"~227 commits"," on one domain, then what ",[124,4037,4038],{},"~2.8K"," visitors actually did. Not a feature tour — a record of when the site was alive, and when it was not.",[116,4041,4043,4049],{"className":4042},[187,188,189],[191,4044,4046],{"id":4045},"when-the-work-happened",[124,4047,4048],{},"When the work happened",[121,4050,4051],{},[200,4052,4053],{"href":202},[124,4054,205],{},[116,4056,4058],{"className":4057},[119],[121,4059,4060,4061,4063],{},"By quarter, the pattern is obvious. Two quiet seasons, then a rebuild, a writing stretch, a CV sprint, and quieter shipping again. Empty quarters are not missing data — they are months with ",[124,4062,489],{}," commits.",[517,4065,4067],{"className":519,"code":4066,"language":521,"meta":522,"style":522},"---\nconfig:\n  xyChart:\n    width: 900\n    height: 300\n  themeVariables:\n    xyChart:\n      plotColorPalette: \"#4A7CD8\"\n---\nxychart-beta\n  title \"Commits by quarter — silence is a real bar (height 0)\"\n  x-axis [\"Q3'24\", \"Q4'24\", \"Q1'25\", \"Q2'25\", \"Q3'25\", \"Q4'25\", \"Q1'26\", \"Q2'26\", \"Q3'26\"]\n  y-axis \"Commits\" 0 --> 130\n  bar [8, 0, 0, 123, 9, 7, 72, 3, 5]\n",[141,4068,4069,4074,4079,4084,4089,4094,4099,4104,4109,4113,4118,4123,4128,4133],{"__ignoreMap":522},[526,4070,4071],{"class":528,"line":529},[526,4072,4073],{},"---\n",[526,4075,4076],{"class":528,"line":535},[526,4077,4078],{},"config:\n",[526,4080,4081],{"class":528,"line":541},[526,4082,4083],{},"  xyChart:\n",[526,4085,4086],{"class":528,"line":547},[526,4087,4088],{},"    width: 900\n",[526,4090,4091],{"class":528,"line":553},[526,4092,4093],{},"    height: 300\n",[526,4095,4096],{"class":528,"line":559},[526,4097,4098],{},"  themeVariables:\n",[526,4100,4101],{"class":528,"line":565},[526,4102,4103],{},"    xyChart:\n",[526,4105,4106],{"class":528,"line":571},[526,4107,4108],{},"      plotColorPalette: \"#4A7CD8\"\n",[526,4110,4111],{"class":528,"line":577},[526,4112,4073],{},[526,4114,4115],{"class":528,"line":583},[526,4116,4117],{},"xychart-beta\n",[526,4119,4120],{"class":528,"line":589},[526,4121,4122],{},"  title \"Commits by quarter — silence is a real bar (height 0)\"\n",[526,4124,4125],{"class":528,"line":595},[526,4126,4127],{},"  x-axis [\"Q3'24\", \"Q4'24\", \"Q1'25\", \"Q2'25\", \"Q3'25\", \"Q4'25\", \"Q1'26\", \"Q2'26\", \"Q3'26\"]\n",[526,4129,4130],{"class":528,"line":601},[526,4131,4132],{},"  y-axis \"Commits\" 0 --> 130\n",[526,4134,4135],{"class":528,"line":606},[526,4136,4137],{},"  bar [8, 0, 0, 123, 9, 7, 72, 3, 5]\n",[116,4139,4141],{"className":4140},[119],[121,4142,4143,4146,4147,4150],{},[124,4144,4145],{},"Q2 2025"," (rebuild + content) and ",[124,4148,4149],{},"Q1 2026"," (CV as product) dominate. Everything else is maintenance or pause. Concentration makes that sharper:",[517,4152,4154],{"className":519,"code":4153,"language":521,"meta":522,"style":522},"---\nconfig:\n  xyChart:\n    width: 900\n    height: 260\n  themeVariables:\n    xyChart:\n      plotColorPalette: \"#1D4ED8\"\n---\nxychart-beta\n  title \"Commit concentration — 3 peak months = 70% of all commits\"\n  x-axis [\"Apr'25 + Jun'25 + Jan'26\", \"Other 11 active months\"]\n  y-axis \"Commits\" 0 --> 180\n  bar [160, 67]\n",[141,4155,4156,4160,4164,4168,4172,4177,4181,4185,4190,4194,4198,4203,4208,4213],{"__ignoreMap":522},[526,4157,4158],{"class":528,"line":529},[526,4159,4073],{},[526,4161,4162],{"class":528,"line":535},[526,4163,4078],{},[526,4165,4166],{"class":528,"line":541},[526,4167,4083],{},[526,4169,4170],{"class":528,"line":547},[526,4171,4088],{},[526,4173,4174],{"class":528,"line":553},[526,4175,4176],{},"    height: 260\n",[526,4178,4179],{"class":528,"line":559},[526,4180,4098],{},[526,4182,4183],{"class":528,"line":565},[526,4184,4103],{},[526,4186,4187],{"class":528,"line":571},[526,4188,4189],{},"      plotColorPalette: \"#1D4ED8\"\n",[526,4191,4192],{"class":528,"line":577},[526,4193,4073],{},[526,4195,4196],{"class":528,"line":583},[526,4197,4117],{},[526,4199,4200],{"class":528,"line":589},[526,4201,4202],{},"  title \"Commit concentration — 3 peak months = 70% of all commits\"\n",[526,4204,4205],{"class":528,"line":595},[526,4206,4207],{},"  x-axis [\"Apr'25 + Jun'25 + Jan'26\", \"Other 11 active months\"]\n",[526,4209,4210],{"class":528,"line":601},[526,4211,4212],{},"  y-axis \"Commits\" 0 --> 180\n",[526,4214,4215],{"class":528,"line":606},[526,4216,4217],{},"  bar [160, 67]\n",[116,4219,4221],{"className":4220},[119],[121,4222,4223],{},"April 2025 (58), June 2025 (42), and January 2026 (60) are most of the repo. A personal site without a habit surface goes dark; the chart is just the receipt.",[116,4225,4227,4233],{"className":4226},[187,188,189],[191,4228,4230],{"id":4229},"what-changed-the-product",[124,4231,4232],{},"What changed the product",[121,4234,4235],{},[200,4236,4237],{"href":202},[124,4238,205],{},[116,4240,4242],{"className":4241},[119],[121,4243,4244,4245,4247],{},"If you keep only the commits that changed what the site ",[231,4246,2301],{},", the path is short:",[517,4249,4251],{"className":519,"code":4250,"language":521,"meta":522,"style":522},"---\nheader: Product milestones — Aug 2024 → Sep 2026\nconfig:\n  theme: 'default'\n  themeVariables:\n    'git0': '#4A7CD8'\n    'git1': '#633486'\n    'git2': '#566F97'\n---\ngitGraph LR:\n    commit id: \"init site\" tag: \"2024-08\" type: HIGHLIGHT\n    commit id: \"contact + light mode\" tag: \"2024-09\"\n    commit id: \"pause\" tag: \"quiet\"\n    commit id: \"Nuxt rebuild\" tag: \"2025-04\" type: HIGHLIGHT\n    commit id: \"deploy pipeline\" type: REVERSE\n    commit id: \"blog + i18n\"\n    commit id: \"RnD index\" tag: \"2025-05\"\n    commit id: \"MCP writing\" tag: \"2025-06\" type: HIGHLIGHT\n    commit id: \"CV product\" tag: \"2026-01\" type: HIGHLIGHT\n    commit id: \"CI + Sentry\" tag: \"2026-02\"\n    commit id: \"Audit4 / Vibe / Overvibing\" tag: \"2026-04\" type: HIGHLIGHT\n    commit id: \"positioning refresh\" tag: \"2026-09\" type: HIGHLIGHT\n",[141,4252,4253,4257,4262,4266,4271,4275,4280,4285,4290,4294,4299,4304,4309,4314,4319,4324,4329,4334,4339,4344,4349,4354],{"__ignoreMap":522},[526,4254,4255],{"class":528,"line":529},[526,4256,4073],{},[526,4258,4259],{"class":528,"line":535},[526,4260,4261],{},"header: Product milestones — Aug 2024 → Sep 2026\n",[526,4263,4264],{"class":528,"line":541},[526,4265,4078],{},[526,4267,4268],{"class":528,"line":547},[526,4269,4270],{},"  theme: 'default'\n",[526,4272,4273],{"class":528,"line":553},[526,4274,4098],{},[526,4276,4277],{"class":528,"line":559},[526,4278,4279],{},"    'git0': '#4A7CD8'\n",[526,4281,4282],{"class":528,"line":565},[526,4283,4284],{},"    'git1': '#633486'\n",[526,4286,4287],{"class":528,"line":571},[526,4288,4289],{},"    'git2': '#566F97'\n",[526,4291,4292],{"class":528,"line":577},[526,4293,4073],{},[526,4295,4296],{"class":528,"line":583},[526,4297,4298],{},"gitGraph LR:\n",[526,4300,4301],{"class":528,"line":589},[526,4302,4303],{},"    commit id: \"init site\" tag: \"2024-08\" type: HIGHLIGHT\n",[526,4305,4306],{"class":528,"line":595},[526,4307,4308],{},"    commit id: \"contact + light mode\" tag: \"2024-09\"\n",[526,4310,4311],{"class":528,"line":601},[526,4312,4313],{},"    commit id: \"pause\" tag: \"quiet\"\n",[526,4315,4316],{"class":528,"line":606},[526,4317,4318],{},"    commit id: \"Nuxt rebuild\" tag: \"2025-04\" type: HIGHLIGHT\n",[526,4320,4321],{"class":528,"line":612},[526,4322,4323],{},"    commit id: \"deploy pipeline\" type: REVERSE\n",[526,4325,4326],{"class":528,"line":618},[526,4327,4328],{},"    commit id: \"blog + i18n\"\n",[526,4330,4331],{"class":528,"line":624},[526,4332,4333],{},"    commit id: \"RnD index\" tag: \"2025-05\"\n",[526,4335,4336],{"class":528,"line":630},[526,4337,4338],{},"    commit id: \"MCP writing\" tag: \"2025-06\" type: HIGHLIGHT\n",[526,4340,4341],{"class":528,"line":635},[526,4342,4343],{},"    commit id: \"CV product\" tag: \"2026-01\" type: HIGHLIGHT\n",[526,4345,4346],{"class":528,"line":641},[526,4347,4348],{},"    commit id: \"CI + Sentry\" tag: \"2026-02\"\n",[526,4350,4351],{"class":528,"line":647},[526,4352,4353],{},"    commit id: \"Audit4 / Vibe / Overvibing\" tag: \"2026-04\" type: HIGHLIGHT\n",[526,4355,4356],{"class":528,"line":653},[526,4357,4358],{},"    commit id: \"positioning refresh\" tag: \"2026-09\" type: HIGHLIGHT\n",[116,4360,4362,4368],{"className":4361},[187,188,189],[191,4363,4365],{"id":4364},"timeline-in-plain-language",[124,4366,4367],{},"Timeline in plain language",[121,4369,4370],{},[200,4371,4372],{"href":202},[124,4373,205],{},[116,4375,4377,4383,4389,4395,4401,4407],{"className":4376},[119],[121,4378,4379,4382],{},[124,4380,4381],{},"2024"," — Domain, contact, light mode. Then silence. LinkedIn still carried more attention than the site.",[121,4384,4385,4388],{},[124,4386,4387],{},"Spring 2025"," — Rebuild on Nuxt. Deploy and config work that looks noisy in git and was necessary in production. Blog in Markdown, translations when a post earned them, RnD when polished “Projects” felt dishonest.",[121,4390,4391,4394],{},[124,4392,4393],{},"Summer 2025"," — Writing season: MCP, testing, architecture. Some posts also ship as audio: blog → ElevenLabs → Spotify → embed.",[121,4396,4397,4400],{},[124,4398,4399],{},"January 2026"," — CV treated as a product: hydration, print, locales, process discipline so the week stayed shippable.",[121,4402,4403,4406],{},[124,4404,4405],{},"Later"," — Experiments live under RnD (Audit4, Vibe Drawing, Overvibing). Positioning catches up: system design and GenAI, not a freelance brochure.",[121,4408,4409,4410,4413],{},"Time moved in ",[124,4411,4412],{},"spikes and silence",", not in a smooth feature roadmap.",[116,4415,4417,4423],{"className":4416},[187,188,189],[191,4418,4420],{"id":4419},"what-git-can-and-cannot-say-about-ai",[124,4421,4422],{},"What git can (and cannot) say about AI",[121,4424,4425],{},[200,4426,4427],{"href":202},[124,4428,205],{},[116,4430,4432,4435],{"className":4431},[119],[121,4433,4434],{},"A “% built with AI” chart would be fiction. Git does not know that.",[121,4436,4437,4438,4441,4442,4445,4446,4449,4450,4453,4454,148],{},"What it ",[231,4439,4440],{},"can"," show: commits that carry a Cursor trailer (",[141,4443,4444],{},"Co-authored-by: Cursor","). On this repo that is ",[124,4447,4448],{},"19 / 227"," (~",[124,4451,4452],{},"8%","), starting only in ",[124,4455,4456],{},"February 2026",[517,4458,4460],{"className":519,"code":4459,"language":521,"meta":522,"style":522},"---\nconfig:\n  xyChart:\n    width: 900\n    height: 280\n  themeVariables:\n    xyChart:\n      plotColorPalette: \"#633486\"\n---\nxychart-beta\n  title \"Cursor-tagged commits only — 19 of 227 total (~8%)\"\n  x-axis [\"Feb'26 (12)\", \"Apr'26 (1)\", \"May'26 (2)\", \"Sep'26 (5)\"]\n  y-axis \"Tagged commits\" 0 --> 14\n  bar [12, 1, 2, 5]\n",[141,4461,4462,4466,4470,4474,4478,4483,4487,4491,4496,4500,4504,4509,4514,4519],{"__ignoreMap":522},[526,4463,4464],{"class":528,"line":529},[526,4465,4073],{},[526,4467,4468],{"class":528,"line":535},[526,4469,4078],{},[526,4471,4472],{"class":528,"line":541},[526,4473,4083],{},[526,4475,4476],{"class":528,"line":547},[526,4477,4088],{},[526,4479,4480],{"class":528,"line":553},[526,4481,4482],{},"    height: 280\n",[526,4484,4485],{"class":528,"line":559},[526,4486,4098],{},[526,4488,4489],{"class":528,"line":565},[526,4490,4103],{},[526,4492,4493],{"class":528,"line":571},[526,4494,4495],{},"      plotColorPalette: \"#633486\"\n",[526,4497,4498],{"class":528,"line":577},[526,4499,4073],{},[526,4501,4502],{"class":528,"line":583},[526,4503,4117],{},[526,4505,4506],{"class":528,"line":589},[526,4507,4508],{},"  title \"Cursor-tagged commits only — 19 of 227 total (~8%)\"\n",[526,4510,4511],{"class":528,"line":595},[526,4512,4513],{},"  x-axis [\"Feb'26 (12)\", \"Apr'26 (1)\", \"May'26 (2)\", \"Sep'26 (5)\"]\n",[526,4515,4516],{"class":528,"line":601},[526,4517,4518],{},"  y-axis \"Tagged commits\" 0 --> 14\n",[526,4520,4521],{"class":528,"line":606},[526,4522,4523],{},"  bar [12, 1, 2, 5]\n",[116,4525,4527],{"className":4526},[119],[121,4528,4529,4530,4533,4534,4536],{},"This proves when Cursor ",[231,4531,4532],{},"signed"," a commit. It does ",[124,4535,3572],{}," prove AI help without a trailer, how much of a commit was generated, or work outside git (including the voice pipeline). Treat it as a limited, honest signal — not a productivity score.",[116,4538,4540,4546],{"className":4539},[187,188,189],[191,4541,4543],{"id":4542},"what-visitors-did",[124,4544,4545],{},"What visitors did",[121,4547,4548],{},[200,4549,4550],{"href":202},[124,4551,205],{},[116,4553,4555],{"className":4554},[119],[121,4556,4557,4560,4561,4564,4565,4567,4568,4571,4572,4575,4576,4579],{},[124,4558,4559],{},"Method (GA4 snapshot):"," property-wide active users ≈ ",[124,4562,4563],{},"2.8K",", new users ≈ ",[124,4566,4563],{},", events ≈ ",[124,4569,4570],{},"40K",", average engagement ≈ ",[124,4573,4574],{},"1m 29s",". Almost no returning users. Geography below uses named city rows from the export, rolled to country/region; everyone else is ",[124,4577,4578],{},"Other"," — not invented city-level detail.",[4581,4582],"ga-visitors-map",{},[517,4584,4586],{"className":519,"code":4585,"language":521,"meta":522,"style":522},"---\nconfig:\n  xyChart:\n    width: 900\n    height: 280\n  themeVariables:\n    xyChart:\n      plotColorPalette: \"#1D4ED8\"\n---\nxychart-beta\n  title \"Users by country — named GA rows + Other (sums to ~2.8K)\"\n  x-axis [\"Poland 20%\", \"US 17%\", \"Singapore 5%\", \"France 3%\", \"China 3%\", \"Other 52%\"]\n  y-axis \"Users\" 0 --> 1600\n  bar [554, 484, 143, 82, 76, 1461]\n",[141,4587,4588,4592,4596,4600,4604,4608,4612,4616,4620,4624,4628,4633,4638,4643],{"__ignoreMap":522},[526,4589,4590],{"class":528,"line":529},[526,4591,4073],{},[526,4593,4594],{"class":528,"line":535},[526,4595,4078],{},[526,4597,4598],{"class":528,"line":541},[526,4599,4083],{},[526,4601,4602],{"class":528,"line":547},[526,4603,4088],{},[526,4605,4606],{"class":528,"line":553},[526,4607,4482],{},[526,4609,4610],{"class":528,"line":559},[526,4611,4098],{},[526,4613,4614],{"class":528,"line":565},[526,4615,4103],{},[526,4617,4618],{"class":528,"line":571},[526,4619,4189],{},[526,4621,4622],{"class":528,"line":577},[526,4623,4073],{},[526,4625,4626],{"class":528,"line":583},[526,4627,4117],{},[526,4629,4630],{"class":528,"line":589},[526,4631,4632],{},"  title \"Users by country — named GA rows + Other (sums to ~2.8K)\"\n",[526,4634,4635],{"class":528,"line":595},[526,4636,4637],{},"  x-axis [\"Poland 20%\", \"US 17%\", \"Singapore 5%\", \"France 3%\", \"China 3%\", \"Other 52%\"]\n",[526,4639,4640],{"class":528,"line":601},[526,4641,4642],{},"  y-axis \"Users\" 0 --> 1600\n",[526,4644,4645],{"class":528,"line":606},[526,4646,4647],{},"  bar [554, 484, 143, 82, 76, 1461]\n",[116,4649,4651],{"className":4650},[119],[121,4652,4653,4654,4656],{},"Poland (Warsaw) is the largest named city. The US city rows include names that often correlate with hosting or bot noise — counted in the total, interpreted cautiously. ",[124,4655,4578],{}," is still real traffic; the export simply did not list those cities.",[517,4658,4660],{"className":519,"code":4659,"language":521,"meta":522,"style":522},"---\nconfig:\n  xyChart:\n    width: 900\n    height: 300\n  themeVariables:\n    xyChart:\n      plotColorPalette: \"#0F766E\"\n---\nxychart-beta\n  title \"Top pages — homepage ≈ 58% of views in this set\"\n  x-axis [\"Home 58%\", \"Blog 15%\", \"ONE-FRONT 15%\", \"Product CV 6%\", \"Resume 5%\", \"Bankly 2%\"]\n  y-axis \"Views\" 0 --> 11000\n  bar [9900, 2500, 2500, 950, 780, 423]\n",[141,4661,4662,4666,4670,4674,4678,4682,4686,4690,4695,4699,4703,4708,4713,4718],{"__ignoreMap":522},[526,4663,4664],{"class":528,"line":529},[526,4665,4073],{},[526,4667,4668],{"class":528,"line":535},[526,4669,4078],{},[526,4671,4672],{"class":528,"line":541},[526,4673,4083],{},[526,4675,4676],{"class":528,"line":547},[526,4677,4088],{},[526,4679,4680],{"class":528,"line":553},[526,4681,4093],{},[526,4683,4684],{"class":528,"line":559},[526,4685,4098],{},[526,4687,4688],{"class":528,"line":565},[526,4689,4103],{},[526,4691,4692],{"class":528,"line":571},[526,4693,4694],{},"      plotColorPalette: \"#0F766E\"\n",[526,4696,4697],{"class":528,"line":577},[526,4698,4073],{},[526,4700,4701],{"class":528,"line":583},[526,4702,4117],{},[526,4704,4705],{"class":528,"line":589},[526,4706,4707],{},"  title \"Top pages — homepage ≈ 58% of views in this set\"\n",[526,4709,4710],{"class":528,"line":595},[526,4711,4712],{},"  x-axis [\"Home 58%\", \"Blog 15%\", \"ONE-FRONT 15%\", \"Product CV 6%\", \"Resume 5%\", \"Bankly 2%\"]\n",[526,4714,4715],{"class":528,"line":601},[526,4716,4717],{},"  y-axis \"Views\" 0 --> 11000\n",[526,4719,4720],{"class":528,"line":606},[526,4721,4722],{},"  bar [9900, 2500, 2500, 950, 780, 423]\n",[116,4724,4726],{"className":4725},[119],[121,4727,4728],{},"Among measured top pages, the homepage is still the front door. Blog and CV matter; they are not where most sessions start.",[517,4730,4732],{"className":519,"code":4731,"language":521,"meta":522,"style":522},"---\nconfig:\n  xyChart:\n    width: 900\n    height: 280\n  themeVariables:\n    xyChart:\n      plotColorPalette: \"#B45309\"\n---\nxychart-beta\n  title \"First-user source — Direct ≈ 64% of ~2.8K users\"\n  x-axis [\"Direct 64%\", \"Google 9%\", \"LinkedIn 3%\", \"Other 24%\"]\n  y-axis \"Users\" 0 --> 2000\n  bar [1800, 249, 74, 677]\n",[141,4733,4734,4738,4742,4746,4750,4754,4758,4762,4767,4771,4775,4780,4785,4790],{"__ignoreMap":522},[526,4735,4736],{"class":528,"line":529},[526,4737,4073],{},[526,4739,4740],{"class":528,"line":535},[526,4741,4078],{},[526,4743,4744],{"class":528,"line":541},[526,4745,4083],{},[526,4747,4748],{"class":528,"line":547},[526,4749,4088],{},[526,4751,4752],{"class":528,"line":553},[526,4753,4482],{},[526,4755,4756],{"class":528,"line":559},[526,4757,4098],{},[526,4759,4760],{"class":528,"line":565},[526,4761,4103],{},[526,4763,4764],{"class":528,"line":571},[526,4765,4766],{},"      plotColorPalette: \"#B45309\"\n",[526,4768,4769],{"class":528,"line":577},[526,4770,4073],{},[526,4772,4773],{"class":528,"line":583},[526,4774,4117],{},[526,4776,4777],{"class":528,"line":589},[526,4778,4779],{},"  title \"First-user source — Direct ≈ 64% of ~2.8K users\"\n",[526,4781,4782],{"class":528,"line":595},[526,4783,4784],{},"  x-axis [\"Direct 64%\", \"Google 9%\", \"LinkedIn 3%\", \"Other 24%\"]\n",[526,4786,4787],{"class":528,"line":601},[526,4788,4789],{},"  y-axis \"Users\" 0 --> 2000\n",[526,4791,4792],{"class":528,"line":606},[526,4793,4794],{},"  bar [1800, 249, 74, 677]\n",[116,4796,4798],{"className":4797},[119],[121,4799,4800,4801,4804,4805,4807],{},"Most people arrive ",[124,4802,4803],{},"direct"," (bookmark, pasted link, typed domain). Organic search and LinkedIn are smaller. ",[124,4806,4578],{}," includes a long tail of referrals — some legitimate, some junk. Same shape as the commit chart: spikes and paths, not a smooth growth curve.",[116,4809,4811,4817],{"className":4810},[187,188,189],[191,4812,4814],{"id":4813},"work-with-me",[124,4815,4816],{},"Work with me",[121,4818,4819],{},[200,4820,4821],{"href":202},[124,4822,205],{},[116,4824,4826,4829],{"className":4825},[119],[121,4827,4828],{},"The public trail is the point: I ship in focused bursts, leave a measurable record, and keep front-end systems maintainable after the spike — architecture, product UI, GenAI/automation glue, and the ops that keep a site alive.",[121,4830,4831,774,4834,4838,4839,4838,4843],{},[124,4832,4833],{},"Next step:",[200,4835,4837],{"href":4836},"/cv/product","Product CV"," · ",[200,4840,4842],{"href":105,"rel":4841},[216],"LinkedIn",[200,4844,4845],{"href":2914},"one-front.com",[2568,4847,3992],{},{"title":522,"searchDepth":535,"depth":535,"links":4849},[4850,4851,4852,4853,4854,4855],{"id":4045,"depth":535,"text":4048},{"id":4229,"depth":535,"text":4232},{"id":4364,"depth":535,"text":4367},{"id":4419,"depth":535,"text":4422},{"id":4542,"depth":535,"text":4545},{"id":4813,"depth":535,"text":4816},"2026-09-27","Two years of commits, silence, and traffic — what the public repo and analytics actually show about building a personal site.",{"src":4859},"/blog/mcp/mcp-cover.png",{},{"title":71,"description":4857},"Az6ASQuxzTLgVOePm47cj3aE1gEHBofiKlOPRBFgxi0",1794268626732]