[{"_1":2,"_12701":-5,"_12702":-5},"loaderData",{"_3":4,"_18":19},"root",{"_5":6,"_7":6,"_8":9,"_10":11,"_12":13,"_14":15,"_16":17},"isProd",true,"enableStats","domain","hyper.media","siteHost","seed.hyper.media","sentryTrace","a08e327ce43b464daeddd659b0fa174a--0","sentryBaggage","sentry-environment=production,sentry-trace_id=a08e327ce43b464daeddd659b0fa174a,sentry-sampled=false","remixVersion",2,"routes/$",{"_20":21,"_12320":12321},"json",{"_22":23,"_24":25,"_26":-5,"_27":-5,"_28":29,"_6417":-5,"_6418":6,"_39":6419,"_6432":6433,"_6434":6435,"_12306":6425,"_10":12307,"_12308":12307,"_12309":12310,"_12315":12316},"prefersLanguages",[],"viewTerm","collaborators","panelParam","openComment","document",{"_30":31,"_6395":42,"_6396":6397,"_6398":6399,"_6401":6402,"_6403":6404,"_6405":6404,"_6406":6407,"_6412":6413,"_6414":42,"_6415":6416},"content",[32,50,58,104,195,392,565,690,884,933,1050,1099,1134,1140,1147,1169,1176,1183,1190,1197,1204,1269,1276,1300,1311,1335,1352,1369,1380,1387,1413,1431,1447,1458,1470,1477,1499,1571,1578,1585,1601,1615,1640,1647,1663,1674,1686,1698,1704,1711,1718,1725,1732,1739,1750,1762,1787,1804,1821,1832,1839,1850,1861,1872,1883,1899,1910,1917,1933,1944,1960,1981,1992,2003,2010,2021,2032,2054,2065,2076,2087,2094,2105,2116,2133,2144,2160,2171,2178,2189,2200,2216,2232,2243,2260,2267,2274,2283,2295,2302,2314,2321,2332,2339,2350,2357,2368,2375,2382,2389,2405,2426,2442,2457,2468,2475,2521,2574,2606,2613,2620,2627,2638,2649,2660,2671,2682,2689,2696,2708,2719,2730,2737,2743,2750,2757,2764,2771,2792,2799,2806,2813,2820,2827,2834,2841,2849,2859,2866,2873,2880,2887,2905,2924,2970,2977,2988,2995,3008,3019,3026,3033,3040,3047,3054,3061,3068,3075,3086,3101,3112,3119,3126,3133,3140,3147,3154,3161,3172,3179,3190,3197,3204,3211,3226,3233,3240,3247,3260,3267,3274,3281,3338,3384,3396,3403,3414,3425,3432,3486,3497,3505,3512,3565,3577,3585,3592,3599,3606,3613,3659,3673,3680,3687,3694,3700,3711,3718,3725,3733,3740,3747,3754,3761,3768,3775,3786,3793,3804,3819,3826,3833,3852,3859,3875,3882,3889,3896,3904,3911,3918,3932,3939,3946,3990,3997,4004,4011,4018,4025,4032,4043,4050,4090,4097,4104,4111,4118,4125,4132,4139,4147,4154,4161,4168,4175,4182,4189,4196,4203,4210,4217,4224,4230,4237,4244,4260,4267,4282,4293,4304,4311,4318,4325,4332,4339,4346,4353,4360,4367,4374,4381,4388,4395,4406,4424,4435,4442,4449,4456,4463,4517,4524,4531,4538,4545,4552,4559,4566,4573,4580,4587,4593,4600,4607,4713,4720,4727,4734,4748,4755,4774,4781,4802,4813,4819,4831,4838,4845,4857,4864,4871,4878,4913,4920,4927,4940,4947,4954,4965,4972,4984,4991,5002,5009,5016,5023,5035,5042,5049,5056,5063,5070,5077,5084,5095,5147,5154,5161,5168,5175,5182,5189,5195,5202,5209,5216,5223,5230,5237,5247,5254,5261,5273,5280,5287,5294,5305,5311,5318,5325,5332,5343,5350,5361,5368,5383,5394,5401,5412,5423,5430,5441,5448,5459,5466,5477,5484,5499,5506,5513,5520,5531,5538,5549,5556,5567,5574,5581,5588,5595,5602,5609,5616,5622,5629,5636,5643,5650,5656,5668,5675,5682,5689,5700,5721,5728,5742,5749,5756,5763,5770,5777,5783,5790,5797,5804,5811,5818,5825,5832,5839,5846,5852,5858,5865,5877,5884,5896,5907,5914,5921,5928,5934,5941,5948,5955,5962,5973,5984,5991,5998,6005,6018,6025,6032,6052,6065,6072,6083,6094,6105,6116,6127,6138,6149,6160,6171,6182,6193,6204,6215,6226],{"_33":34,"_35":36},"children",[],"block",{"_37":38,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":48},"type","Paragraph","id","tJhgDqmN","revision","bafy2bzacecrdfptvkhfia32hngvirdiyhdnjpxinmo7rox2inmrag22avsmqy","attributes",{},"annotations",[],"text","","link",{"_33":51,"_35":52},[],{"_37":53,"_39":54,"_41":42,"_43":55,"_45":56,"_47":57,"_49":48},"Heading","9uOYDT4Q",{},[],"## Table of Contents",{"_33":59,"_35":97},[60,76,83,90],{"_33":61,"_35":62},[],{"_37":38,"_39":63,"_41":42,"_43":64,"_45":65,"_47":75,"_49":48},"LD_Ksz6w",{},[66],{"_37":67,"_68":69,"_71":72,"_43":74,"_49":48},"Italic","starts",[70],30,"ends",[73],179,{},"0.1 Single guiding principle: \"Does this make it easier for a third-party developer, or non-tech product builder, to ship an application on Seed Hypermedia than it was yesterday?\"",{"_33":77,"_35":78},[],{"_37":38,"_39":79,"_41":42,"_43":80,"_45":81,"_47":82,"_49":48},"UyzVxv-v",{},[],"0.2 Rich Hickey's philosophy applied: what we take, what we leave behind",{"_33":84,"_35":85},[],{"_37":38,"_39":86,"_41":42,"_43":87,"_45":88,"_47":89,"_49":48},"SlJVNBhj",{},[],"0.3 Frugality constraints: zero new runtime dependencies, zero triple stores, zero rewrites",{"_33":91,"_35":92},[],{"_37":38,"_39":93,"_41":42,"_43":94,"_45":95,"_47":96,"_49":48},"sPIqYXnb",{},[],"0.4 What the semantic layer is not",{"_37":53,"_39":98,"_41":42,"_43":99,"_45":102,"_47":103,"_49":48},"tnbe65dq",{"_100":101},"childrenType","Unordered",[],"0. Preamble",{"_33":105,"_35":190},[106,155,162,169,176,183],{"_33":107,"_35":150},[108,115,122,129,136,143],{"_33":109,"_35":110},[],{"_37":38,"_39":111,"_41":42,"_43":112,"_45":113,"_47":114,"_49":48},"oC3Xt-Xc",{},[],"H1 — Describability without breakage",{"_33":116,"_35":117},[],{"_37":38,"_39":118,"_41":42,"_43":119,"_45":120,"_47":121,"_49":48},"no29kFIK",{},[],"H2 — Discoverability without source code",{"_33":123,"_35":124},[],{"_37":38,"_39":125,"_41":42,"_43":126,"_45":127,"_47":128,"_49":48},"SFG32ECS",{},[],"H3 — Community extension without coordination",{"_33":130,"_35":131},[],{"_37":38,"_39":132,"_41":42,"_43":133,"_45":134,"_47":135,"_49":48},"y2WC9ZsD",{},[],"H4 — Build-time generation is complete",{"_33":137,"_35":138},[],{"_37":38,"_39":139,"_41":42,"_43":140,"_45":141,"_47":142,"_49":48},"cgy-Z4Lo",{},[],"H5 — Zero runtime overhead is achievable",{"_33":144,"_35":145},[],{"_37":38,"_39":146,"_41":42,"_43":147,"_45":148,"_47":149,"_49":48},"J4dK6LU8",{},[],"H6 — The vocabulary is useful, not just correct",{"_37":38,"_39":151,"_41":42,"_43":152,"_45":153,"_47":154,"_49":48},"pSDunx8f",{"_100":101},[],"1.1 The hypotheses ",{"_33":156,"_35":157},[],{"_37":38,"_39":158,"_41":42,"_43":159,"_45":160,"_47":161,"_49":48},"DiepoBnt",{},[],"1.2 Experiment ordering and dependencies",{"_33":163,"_35":164},[],{"_37":38,"_39":165,"_41":42,"_43":166,"_45":167,"_47":168,"_49":48},"E4WIbbaR",{},[],"1.3 The Hello World artifact",{"_33":170,"_35":171},[],{"_37":38,"_39":172,"_41":42,"_43":173,"_45":174,"_47":175,"_49":48},"bLxagdDf",{},[],"1.4 Success and failure criteria for the POC",{"_33":177,"_35":178},[],{"_37":38,"_39":179,"_41":42,"_43":180,"_45":181,"_47":182,"_49":48},"41LaE7wK",{},[],"1.5 What we are not testing in the POC",{"_33":184,"_35":185},[],{"_37":38,"_39":186,"_41":42,"_43":187,"_45":188,"_47":189,"_49":48},"ElNMdsQa",{},[],"1.6 Decision gate",{"_37":53,"_39":191,"_41":42,"_43":192,"_45":193,"_47":194,"_49":48},"lLO2xqOp",{"_100":101},[],"1. Stepping Back Before a Hello World — Hypothesis Verification Protocol",{"_33":196,"_35":387},[197,232,288,324,380],{"_33":198,"_35":227},[199,206,213,220],{"_33":200,"_35":201},[],{"_37":38,"_39":202,"_41":42,"_43":203,"_45":204,"_47":205,"_49":48},"So1VUJ45",{},[],"2.1.1 Inventory of block types in Go code (structs) and TypeScript (interfaces)",{"_33":207,"_35":208},[],{"_37":38,"_39":209,"_41":42,"_43":210,"_45":211,"_47":212,"_49":48},"iqAfig9t",{},[],"2.1.2 Extraction of implicit relationships between types",{"_33":214,"_35":215},[],{"_37":38,"_39":216,"_41":42,"_43":217,"_45":218,"_47":219,"_49":48},"ReJtB4hx",{},[],"2.1.3 Identification of the 5–7 priority block types for the initial vocabulary",{"_33":221,"_35":222},[],{"_37":38,"_39":223,"_41":42,"_43":224,"_45":225,"_47":226,"_49":48},"uBq5T6nM",{},[],"2.1.4 Survey of current naming conventions (CBOR fields, JSON keys, gRPC names)",{"_37":38,"_39":228,"_41":42,"_43":229,"_45":230,"_47":231,"_49":48},"pHGL3i6f",{"_100":101},[],"2.1 Mapping the existing landscape ",{"_33":233,"_35":283},[234,241,255,262,269,276],{"_33":235,"_35":236},[],{"_37":38,"_39":237,"_41":42,"_43":238,"_45":239,"_47":240,"_49":48},"_ocNt0wV",{},[],"2.2.1 YAML source file as canonical reference (human-readable, version-controllable)",{"_33":242,"_35":243},[],{"_37":38,"_39":244,"_41":42,"_43":245,"_45":246,"_47":254,"_49":48},"v7g5QIfA",{},[247],{"_37":248,"_68":249,"_71":251,"_43":253,"_49":48},"Code",[250],20,[252],33,{},"2.2.2 Generation of core-skos.ttl from YAML",{"_33":256,"_35":257},[],{"_37":38,"_39":258,"_41":42,"_43":259,"_45":260,"_47":261,"_49":48},"LEZJ2bGP",{},[],"2.2.3 Why SKOS — the 80/20 solution for RDF",{"_33":263,"_35":264},[],{"_37":38,"_39":265,"_41":42,"_43":266,"_45":267,"_47":268,"_49":48},"Zm6KU82S",{},[],"2.2.4 SKOS-XL for rich label management",{"_33":270,"_35":271},[],{"_37":38,"_39":272,"_41":42,"_43":273,"_45":274,"_47":275,"_49":48},"x23lvhwm",{},[],"2.2.5 Future-proof evolution path",{"_33":277,"_35":278},[],{"_37":38,"_39":279,"_41":42,"_43":280,"_45":281,"_47":282,"_49":48},"9llIokWC",{},[],"2.2.6 Publication of the vocabulary as a standalone open artifact (dedicated IPFS CID)",{"_37":38,"_39":284,"_41":42,"_43":285,"_45":286,"_47":287,"_49":48},"esZrRrQs",{"_100":101},[],"2.2 Canonical SKOS vocabulary ",{"_33":289,"_35":319},[290,297,312],{"_33":291,"_35":292},[],{"_37":38,"_39":293,"_41":42,"_43":294,"_45":295,"_47":296,"_49":48},"eVV_3gop",{},[],"2.3.1 Dual context: JSON-LD version for web consumers, CBOR version for the backend",{"_33":298,"_35":299},[],{"_37":38,"_39":300,"_41":42,"_43":301,"_45":302,"_47":311,"_49":48},"86Q2QRR1",{},[303],{"_37":248,"_68":304,"_71":307,"_43":310,"_49":48},[305,306],56,65,[308,309],62,77,{},"2.3.2 Mapping of existing short keys to qualified URIs (\"type\" → hm:blockType)",{"_33":313,"_35":314},[],{"_37":38,"_39":315,"_41":42,"_43":316,"_45":317,"_47":318,"_49":48},"KdqI6nsb",{},[],"2.3.3 Context embedded statically (never resolved over HTTP at runtime)",{"_37":38,"_39":320,"_41":42,"_43":321,"_45":322,"_47":323,"_49":48},"FO9xCCtK",{"_100":101},[],"2.3 Embedded JSON-LD context ",{"_33":325,"_35":375},[326,341,348,355,368],{"_33":327,"_35":328},[],{"_37":38,"_39":329,"_41":42,"_43":330,"_45":331,"_47":340,"_49":48},"1XOAVNwk",{},[332],{"_37":248,"_68":333,"_71":336,"_43":339,"_49":48},[334,335],23,39,[337,338],36,54,{},"2.4.1 pyLODE pipeline: core-skos.ttl → docs/index.html",{"_33":342,"_35":343},[],{"_37":38,"_39":344,"_41":42,"_43":345,"_45":346,"_47":347,"_49":48},"ZNqDez7A",{},[],"2.4.2 Upgrade path: Widoco",{"_33":349,"_35":350},[],{"_37":38,"_39":351,"_41":42,"_43":352,"_45":353,"_47":354,"_49":48},"nlazYufb",{},[],"2.4.3 Exploration tool: Ontospy",{"_33":356,"_35":357},[],{"_37":38,"_39":358,"_41":42,"_43":359,"_45":360,"_47":367,"_49":48},"WfPjZ5vh",{},[361],{"_37":248,"_68":362,"_71":364,"_43":366,"_49":48},[363],59,[365],70,{},"2.4.4 CI integration: re-generation on every commit to the vocabulary/ directory",{"_33":369,"_35":370},[],{"_37":38,"_39":371,"_41":42,"_43":372,"_45":373,"_47":374,"_49":48},"Ql0AlXFL",{},[],"2.4.5 Collaborative editing (future): VoCol",{"_37":38,"_39":376,"_41":42,"_43":377,"_45":378,"_47":379,"_49":48},"MPEJ5eBR",{"_100":101},[],"2.4 Auto-generated documentation ",{"_33":381,"_35":382},[],{"_37":38,"_39":383,"_41":42,"_43":384,"_45":385,"_47":386,"_49":48},"ohoO4y1s",{},[],"2.5 Week 2 deliverables",{"_37":53,"_39":388,"_41":42,"_43":389,"_45":390,"_47":391,"_49":48},"oAk154Nj",{"_100":101},[],"2. Foundation Sprint — Vocabulary & Minimal Tooling (Weeks 1–2)",{"_33":393,"_35":560},[394,449,498,532],{"_33":395,"_35":439},[396,403,410,417,432],{"_33":397,"_35":398},[],{"_37":38,"_39":399,"_41":42,"_43":400,"_45":401,"_47":402,"_49":48},"ahkb2_UU",{},[],"3.1.1 TypeScript types generated from the SKOS vocabulary",{"_33":404,"_35":405},[],{"_37":38,"_39":406,"_41":42,"_43":407,"_45":408,"_47":409,"_49":48},"qRWGjqiI",{},[],"3.1.2 JSON-LD context embedded as a static import",{"_33":411,"_35":412},[],{"_37":38,"_39":413,"_41":42,"_43":414,"_45":415,"_47":416,"_49":48},"ycZx9goh",{},[],"3.1.3 Lightweight builders (~2KB) for each block type",{"_33":418,"_35":419},[],{"_37":38,"_39":420,"_41":42,"_43":421,"_45":422,"_47":431,"_49":48},"hqLQ3tlm",{},[423],{"_37":424,"_68":425,"_71":427,"_43":429,"_49":430},"Link",[426],16,[428],26,{},"http://Schema.org","3.1.4 Type-safe Schema.org integration",{"_33":433,"_35":434},[],{"_37":38,"_39":435,"_41":42,"_43":436,"_45":437,"_47":438,"_49":48},"uS9Bh0mG",{},[],"3.1.5 Zero runtime dependency on any JSON-LD library",{"_37":38,"_39":440,"_41":42,"_43":441,"_45":442,"_47":448,"_49":48},"b8t5joeN",{"_100":101},[443],{"_37":248,"_68":444,"_71":446,"_43":447,"_49":48},[445],4,[250],{},"3.1 @seed/vocabulary npm package ",{"_33":450,"_35":493},[451,458,465,472,479,486],{"_33":452,"_35":453},[],{"_37":38,"_39":454,"_41":42,"_43":455,"_45":456,"_47":457,"_49":48},"IsUyN0jg",{},[],"3.2.1 Option 1 (recommended): Go consumes JSON-LD as native JSON",{"_33":459,"_35":460},[],{"_37":38,"_39":461,"_41":42,"_43":462,"_45":463,"_47":464,"_49":48},"7gJF2t1-",{},[],"3.2.2 Direct CBOR parsing in Go without going through an RDF layer",{"_33":466,"_35":467},[],{"_37":38,"_39":468,"_41":42,"_43":469,"_45":470,"_47":471,"_49":48},"F4RbM5dz",{},[],"3.2.3 Option 2 (if RDF processing needed in Go): lightweight libraries",{"_33":473,"_35":474},[],{"_37":38,"_39":475,"_41":42,"_43":476,"_45":477,"_47":478,"_49":48},"XmdYv8pl",{},[],"3.2.4 Option 3 (hybrid): Python tooling + Go runtime",{"_33":480,"_35":481},[],{"_37":38,"_39":482,"_41":42,"_43":483,"_45":484,"_47":485,"_49":48},"YIZxujOf",{},[],"3.2.5 Option 4 (advanced): CGo bindings to Rust",{"_33":487,"_35":488},[],{"_37":38,"_39":489,"_41":42,"_43":490,"_45":491,"_47":492,"_49":48},"cgUxbrhU",{},[],"3.2.6 Serialization flexibility",{"_37":38,"_39":494,"_41":42,"_43":495,"_45":496,"_47":497,"_49":48},"OVKxgH4T",{"_100":101},[],"3.2 Go backend integration — \"JSON-LD as native JSON\" option ",{"_33":499,"_35":527},[500,507,520],{"_33":501,"_35":502},[],{"_37":38,"_39":503,"_41":42,"_43":504,"_45":505,"_47":506,"_49":48},"MEc4nAFO",{},[],"3.3.1 Single script: YAML → SKOS Turtle → JSON-LD context → TypeScript types → Go struct tags → HTML docs",{"_33":508,"_35":509},[],{"_37":38,"_39":510,"_41":42,"_43":511,"_45":512,"_47":519,"_49":48},"f8NJep7X",{},[513],{"_37":248,"_68":514,"_71":516,"_43":518,"_49":48},[337,515],48,[517,305],44,{},"3.3.2 Integration into the existing Makefile or justfile",{"_33":521,"_35":522},[],{"_37":38,"_39":523,"_41":42,"_43":524,"_45":525,"_47":526,"_49":48},"u-QPCune",{},[],"3.3.3 Non-regression tests: vocabulary compiles, types are valid, examples parse",{"_37":38,"_39":528,"_41":42,"_43":529,"_45":530,"_47":531,"_49":48},"eVMugIrn",{"_100":101},[],"3.3 Build-time generation pipeline ",{"_33":533,"_35":555},[534,541,548],{"_33":535,"_35":536},[],{"_37":38,"_39":537,"_41":42,"_43":538,"_45":539,"_47":540,"_49":48},"SM9q6t8y",{},[],"3.4.1 Scenario: an external developer creates a custom block type",{"_33":542,"_35":543},[],{"_37":38,"_39":544,"_41":42,"_43":545,"_45":546,"_47":547,"_49":48},"zwa6vA6U",{},[],"3.4.2 The developer journey",{"_33":549,"_35":550},[],{"_37":38,"_39":551,"_41":42,"_43":552,"_45":553,"_47":554,"_49":48},"KCnsTOt_",{},[],"3.4.3 Success criteria",{"_37":38,"_39":556,"_41":42,"_43":557,"_45":558,"_47":559,"_49":48},"kYMHwfHG",{"_100":101},[],"3.4 Third-party developer validation (proof of concept) ",{"_37":53,"_39":561,"_41":42,"_43":562,"_45":563,"_47":564,"_49":48},"Jc1hN42Y",{"_100":101},[],"3. Developer Experience Transformation (Weeks 3–4)",{"_33":566,"_35":685},[567,601,622,657],{"_33":568,"_35":596},[569,576,583],{"_33":570,"_35":571},[],{"_37":38,"_39":572,"_41":42,"_43":573,"_45":574,"_47":575,"_49":48},"1SbMx7bw",{},[],"4.1.1 The SKOS vocabulary feeds a navigable block type registry in the editor",{"_33":577,"_35":578},[],{"_37":38,"_39":579,"_41":42,"_43":580,"_45":581,"_47":582,"_49":48},"0mvD07GW",{},[],"4.1.2 Community extensions visible alongside native types",{"_33":584,"_35":585},[],{"_37":38,"_39":586,"_41":42,"_43":587,"_45":588,"_47":595,"_49":48},"3zBNlbrw",{},[589],{"_37":424,"_68":590,"_71":592,"_43":594,"_49":430},[591],24,[593],34,{},"4.1.3 Analogous role to Schema.org",{"_37":38,"_39":597,"_41":42,"_43":598,"_45":599,"_47":600,"_49":48},"KObnXamX",{"_100":101},[],"4.1 Capability discoverability in the interface ",{"_33":602,"_35":617},[603,610],{"_33":604,"_35":605},[],{"_37":38,"_39":606,"_41":42,"_43":607,"_45":608,"_47":609,"_49":48},"-d9TXYHZ",{},[],"4.2.1 Every published document carries its own JSON-LD context (no external resolution)",{"_33":611,"_35":612},[],{"_37":38,"_39":613,"_41":42,"_43":614,"_45":615,"_47":616,"_49":48},"3IULKKml",{},[],"4.2.2 Minimal DCAT metadata embedded: title, author, license, date",{"_37":38,"_39":618,"_41":42,"_43":619,"_45":620,"_47":621,"_49":48},"RvmS9egW",{"_100":101},[],"4.2 Self-describing documents ",{"_33":623,"_35":652},[624,631,638,645],{"_33":625,"_35":626},[],{"_37":38,"_39":627,"_41":42,"_43":628,"_45":629,"_47":630,"_49":48},"xnDor8k_",{},[],"4.3.1 Architectural principle: transitions are metadata operations, never document reformatting",{"_33":632,"_35":633},[],{"_37":38,"_39":634,"_41":42,"_43":635,"_45":636,"_47":637,"_49":48},"ZP-sho13",{},[],"4.3.2 Three levels, one architecture",{"_33":639,"_35":640},[],{"_37":38,"_39":641,"_41":42,"_43":642,"_45":643,"_47":644,"_49":48},"2AYtVHY7",{},[],"4.3.3 Transition table",{"_33":646,"_35":647},[],{"_37":38,"_39":648,"_41":42,"_43":649,"_45":650,"_47":651,"_49":48},"ckEHSzXz",{},[],"4.3.4 Open vocabulary, controlled content",{"_37":38,"_39":653,"_41":42,"_43":654,"_45":655,"_47":656,"_49":48},"IR9m1KIy",{"_100":101},[],"4.3 Access fluidity: private → shared → open ",{"_33":658,"_35":680},[659,666,673],{"_33":660,"_35":661},[],{"_37":38,"_39":662,"_41":42,"_43":663,"_45":664,"_47":665,"_49":48},"vwRkqMvh",{},[],"4.4.1 SKOS native multilingual support",{"_33":667,"_35":668},[],{"_37":38,"_39":669,"_41":42,"_43":670,"_45":671,"_47":672,"_49":48},"UI70Q168",{},[],"4.4.2 Interface adapts to the user's language without ad hoc translation work",{"_33":674,"_35":675},[],{"_37":38,"_39":676,"_41":42,"_43":677,"_45":678,"_47":679,"_49":48},"LnAuSuKG",{},[],"4.4.3 Community-extensible languages",{"_37":38,"_39":681,"_41":42,"_43":682,"_45":683,"_47":684,"_49":48},"jahe8xK1",{"_100":101},[],"4.4 Native multilingual labels ",{"_37":53,"_39":686,"_41":42,"_43":687,"_45":688,"_47":689,"_49":48},"FJJ451Na",{"_100":101},[],"4. User Experience Transformation (Weeks 5–6)",{"_33":691,"_35":879},[692,727,755,783,818,846],{"_33":693,"_35":722},[694,701,708,715],{"_33":695,"_35":696},[],{"_37":38,"_39":697,"_41":42,"_43":698,"_45":699,"_47":700,"_49":48},"shRRxHYT",{},[],"5.1.1 FAIR principles already satisfied by existing architecture (9 of 15)",{"_33":702,"_35":703},[],{"_37":38,"_39":704,"_41":42,"_43":705,"_45":706,"_47":707,"_49":48},"7thHRI4u",{},[],"5.1.2 EU standards mapping (EIF → DCAT → CPSV → SKOS)",{"_33":709,"_35":710},[],{"_37":38,"_39":711,"_41":42,"_43":712,"_45":713,"_47":714,"_49":48},"TKPcRsIl",{},[],"5.1.3 FAIR compliance across access levels (private / shared / open)",{"_33":716,"_35":717},[],{"_37":38,"_39":718,"_41":42,"_43":719,"_45":720,"_47":721,"_49":48},"4SY1JClO",{},[],"5.1.4 CPSV — Core Public Service Vocabulary",{"_37":38,"_39":723,"_41":42,"_43":724,"_45":725,"_47":726,"_49":48},"UAC9_X5E",{"_100":101},[],"5.1 FAIR compliance by construction ",{"_33":728,"_35":750},[729,736,743],{"_33":730,"_35":731},[],{"_37":38,"_39":732,"_41":42,"_43":733,"_45":734,"_47":735,"_49":48},"IQhXC43I",{},[],"5.2.1 Static generation of a catalog JSON-LD endpoint from published documents",{"_33":737,"_35":738},[],{"_37":38,"_39":739,"_41":42,"_43":740,"_45":741,"_47":742,"_49":48},"idfsVygw",{},[],"5.2.2 Catalog lists metadata, not content (compatible with selective sharing)",{"_33":744,"_35":745},[],{"_37":38,"_39":746,"_41":42,"_43":747,"_45":748,"_47":749,"_49":48},"oeTvgCzi",{},[],"5.2.3 Harvesting testable with a local CKAN instance or the EU sandbox",{"_37":38,"_39":751,"_41":42,"_43":752,"_45":753,"_47":754,"_49":48},"SDZd3Ifd",{"_100":101},[],"5.2 DCAT catalog ",{"_33":756,"_35":778},[757,764,771],{"_33":758,"_35":759},[],{"_37":38,"_39":760,"_41":42,"_43":761,"_45":762,"_47":763,"_49":48},"UHgcjBSu",{},[],"5.3.1 Query any format as RDF without conversion",{"_33":765,"_35":766},[],{"_37":38,"_39":767,"_41":42,"_43":768,"_45":769,"_47":770,"_49":48},"gR3NUPUq",{},[],"5.3.2 Practical use cases",{"_33":772,"_35":773},[],{"_37":38,"_39":774,"_41":42,"_43":775,"_45":776,"_47":777,"_49":48},"pd2t3off",{},[],"5.3.3 Strictly tooling / prototyping use (not production)",{"_37":38,"_39":779,"_41":42,"_43":780,"_45":781,"_47":782,"_49":48},"DVT_HTom",{"_100":101},[],"5.3 Exploring existing data with SPARQL Anything ",{"_33":784,"_35":813},[785,792,799,806],{"_33":786,"_35":787},[],{"_37":38,"_39":788,"_41":42,"_43":789,"_45":790,"_47":791,"_49":48},"gEREkM3l",{},[],"5.4.1 The problem with hardcoded conversions",{"_33":793,"_35":794},[],{"_37":38,"_39":795,"_41":42,"_43":796,"_45":797,"_47":798,"_49":48},"FLaMLkVr",{},[],"5.4.2 Declarative mappings as data",{"_33":800,"_35":801},[],{"_37":38,"_39":802,"_41":42,"_43":803,"_45":804,"_47":805,"_49":48},"bCVRJCVg",{},[],"5.4.3 Implementation options",{"_33":807,"_35":808},[],{"_37":38,"_39":809,"_41":42,"_43":810,"_45":811,"_47":812,"_49":48},"TkaCintQ",{},[],"5.4.4 Recommended progression",{"_37":38,"_39":814,"_41":42,"_43":815,"_45":816,"_47":817,"_49":48},"NLUeAwA7",{"_100":101},[],"5.4 Declarative format mappings: FaCade-X and RML ",{"_33":819,"_35":841},[820,827,834],{"_33":821,"_35":822},[],{"_37":38,"_39":823,"_41":42,"_43":824,"_45":825,"_47":826,"_49":48},"YEYu8ttf",{},[],"5.5.1 Shapes for 2–3 critical block types (proof of concept)",{"_33":828,"_35":829},[],{"_37":38,"_39":830,"_41":42,"_43":831,"_45":832,"_47":833,"_49":48},"j8Ac77Sz",{},[],"5.5.2 Validation in CI",{"_33":835,"_35":836},[],{"_37":38,"_39":837,"_41":42,"_43":838,"_45":839,"_47":840,"_49":48},"e3FP2RiZ",{},[],"5.5.3 Adoption conditional on demonstrated value, not systematic",{"_37":38,"_39":842,"_41":42,"_43":843,"_45":844,"_47":845,"_49":48},"2psL_ZqW",{"_100":101},[],"5.5 Optional SHACL validation ",{"_33":847,"_35":874},[848,855,867],{"_33":849,"_35":850},[],{"_37":38,"_39":851,"_41":42,"_43":852,"_45":853,"_47":854,"_49":48},"Z9glsT7v",{},[],"5.6.1 The problem",{"_33":856,"_35":857},[],{"_37":38,"_39":858,"_41":42,"_43":859,"_45":860,"_47":866,"_49":48},"mwSdbuz8",{},[861],{"_37":248,"_68":862,"_71":863,"_43":865,"_49":48},[591],[864],29,{},"5.6.2 Solution: JSON-LD @list",{"_33":868,"_35":869},[],{"_37":38,"_39":870,"_41":42,"_43":871,"_45":872,"_47":873,"_49":48},"5rzwPYz0",{},[],"5.6.3 Alternative: split responsibilities",{"_37":38,"_39":875,"_41":42,"_43":876,"_45":877,"_47":878,"_49":48},"ywN36yBC",{"_100":101},[],"5.6 Handling arrays and ordering ",{"_37":53,"_39":880,"_41":42,"_43":881,"_45":882,"_47":883,"_49":48},"fF5KbvLg",{"_100":101},[],"5. Data Transformation — Interoperability & Compliance (Weeks 7–10)",{"_33":885,"_35":928},[886,893,900,907,914,921],{"_33":887,"_35":888},[],{"_37":38,"_39":889,"_41":42,"_43":890,"_45":891,"_47":892,"_49":48},"cUXwrl5G",{},[],"6.1 Build-time generation (primary strategy)",{"_33":894,"_35":895},[],{"_37":38,"_39":896,"_41":42,"_43":897,"_45":898,"_47":899,"_49":48},"fuBqs1b9",{},[],"6.2 Never resolve @context in the browser",{"_33":901,"_35":902},[],{"_37":38,"_39":903,"_41":42,"_43":904,"_45":905,"_47":906,"_49":48},"famZifDC",{},[],"6.3 In-memory caching (if processing needed)",{"_33":908,"_35":909},[],{"_37":38,"_39":910,"_41":42,"_43":911,"_45":912,"_47":913,"_49":48},"8hEnXBeK",{},[],"6.4 Centralized helpers — no duplication",{"_33":915,"_35":916},[],{"_37":38,"_39":917,"_41":42,"_43":918,"_45":919,"_47":920,"_49":48},"QmZfsATp",{},[],"6.5 CI/CD validation of generated JSON-LD",{"_33":922,"_35":923},[],{"_37":38,"_39":924,"_41":42,"_43":925,"_45":926,"_47":927,"_49":48},"TqR8u75k",{},[],"6.6 Complete frontend architecture",{"_37":53,"_39":929,"_41":42,"_43":930,"_45":931,"_47":932,"_49":48},"Wondc8TY",{"_100":101},[],"6. TypeScript Frontend Optimization — Zero-Overhead JSON-LD (Parallel Track)",{"_33":934,"_35":1045},[935,963,989,1017],{"_33":936,"_35":958},[937,944,951],{"_33":938,"_35":939},[],{"_37":38,"_39":940,"_41":42,"_43":941,"_45":942,"_47":943,"_49":48},"0iAhxa07",{},[],"7.1.1 Concept scheme template for third-party extensions",{"_33":945,"_35":946},[],{"_37":38,"_39":947,"_41":42,"_43":948,"_45":949,"_47":950,"_49":48},"EpzzhX-l",{},[],"7.1.2 Guide: \"Publish a Custom Block Type in 15 Minutes\"",{"_33":952,"_35":953},[],{"_37":38,"_39":954,"_41":42,"_43":955,"_45":956,"_47":957,"_49":48},"VDSv_vV0",{},[],"7.1.3 Discovery mechanism: SKOS resolution via IPFS",{"_37":38,"_39":959,"_41":42,"_43":960,"_45":961,"_47":962,"_49":48},"0tpQ3UkP",{"_100":101},[],"7.1 Community extensions ",{"_33":964,"_35":984},[965,977],{"_33":966,"_35":967},[],{"_37":38,"_39":968,"_41":42,"_43":969,"_45":970,"_47":976,"_49":48},"mxrBGMg-",{},[971],{"_37":424,"_68":972,"_71":974,"_43":975,"_49":430},[973],6,[426],{},"7.2.1 Schema.org mapping",{"_33":978,"_35":979},[],{"_37":38,"_39":980,"_41":42,"_43":981,"_45":982,"_47":983,"_49":48},"NBjM7VJg",{},[],"7.2.2 ActivityPub alignment",{"_37":38,"_39":985,"_41":42,"_43":986,"_45":987,"_47":988,"_49":48},"cYOtSAxL",{"_100":101},[],"7.2 External vocabulary alignment ",{"_33":990,"_35":1012},[991,998,1005],{"_33":992,"_35":993},[],{"_37":38,"_39":994,"_41":42,"_43":995,"_45":996,"_47":997,"_49":48},"EaUGmy6z",{},[],"7.3.1 SKOS → RDFS threshold",{"_33":999,"_35":1000},[],{"_37":38,"_39":1001,"_41":42,"_43":1002,"_45":1003,"_47":1004,"_49":48},"Coxqoj_w",{},[],"7.3.2 RDFS → OWL threshold",{"_33":1006,"_35":1007},[],{"_37":38,"_39":1008,"_41":42,"_43":1009,"_45":1010,"_47":1011,"_49":48},"Cq-V0b8C",{},[],"7.3.3 Architecture Decision Records",{"_37":38,"_39":1013,"_41":42,"_43":1014,"_45":1015,"_47":1016,"_49":48},"y8XOP57h",{"_100":101},[],"7.3 Conditional complexity escalation ",{"_33":1018,"_35":1040},[1019,1026,1033],{"_33":1020,"_35":1021},[],{"_37":38,"_39":1022,"_41":42,"_43":1023,"_45":1024,"_47":1025,"_49":48},"upgHsLZy",{},[],"7.4.1 Vocabulary registration on EU Joinup",{"_33":1027,"_35":1028},[],{"_37":38,"_39":1029,"_41":42,"_43":1030,"_45":1031,"_47":1032,"_49":48},"VRhvm5jJ",{},[],"7.4.2 CPSV alignment",{"_33":1034,"_35":1035},[],{"_37":38,"_39":1036,"_41":42,"_43":1037,"_45":1038,"_47":1039,"_49":48},"47EupX-l",{},[],"7.4.3 High-Value Datasets initiative",{"_37":38,"_39":1041,"_41":42,"_43":1042,"_45":1043,"_47":1044,"_49":48},"coKWG1XE",{"_100":101},[],"7.4 EU & data spaces (if strategically relevant) ",{"_37":53,"_39":1046,"_41":42,"_43":1047,"_45":1048,"_47":1049,"_49":48},"h-NM7-iU",{"_100":101},[],"7. Consolidation & Ecosystem (Months 3–6)",{"_33":1051,"_35":1094},[1052,1059,1066,1073,1080,1087],{"_33":1053,"_35":1054},[],{"_37":38,"_39":1055,"_41":42,"_43":1056,"_45":1057,"_47":1058,"_49":48},"Jdxie4LD",{},[],"8.1 Frugality",{"_33":1060,"_35":1061},[],{"_37":38,"_39":1062,"_41":42,"_43":1063,"_45":1064,"_47":1065,"_49":48},"Q6Gecere",{},[],"8.2 Build-time, not runtime",{"_33":1067,"_35":1068},[],{"_37":38,"_39":1069,"_41":42,"_43":1070,"_45":1071,"_47":1072,"_49":48},"Mg5fVoVX",{},[],"8.3 Single source of truth",{"_33":1074,"_35":1075},[],{"_37":38,"_39":1076,"_41":42,"_43":1077,"_45":1078,"_47":1079,"_49":48},"6oet2oIi",{},[],"8.4 Reversibility",{"_33":1081,"_35":1082},[],{"_37":38,"_39":1083,"_41":42,"_43":1084,"_45":1085,"_47":1086,"_49":48},"FZTtpQCY",{},[],"8.5 RDF as specification, not runtime",{"_33":1088,"_35":1089},[],{"_37":38,"_39":1090,"_41":42,"_43":1091,"_45":1092,"_47":1093,"_49":48},"WlRB4GPj",{},[],"8.6 Content is infrastructure",{"_37":53,"_39":1095,"_41":42,"_43":1096,"_45":1097,"_47":1098,"_49":48},"Zy6oGJxX",{"_100":101},[],"8. Cross-Cutting Principles (Running Thread)",{"_33":1100,"_35":1129},[1101,1108,1115,1122],{"_33":1102,"_35":1103},[],{"_37":38,"_39":1104,"_41":42,"_43":1105,"_45":1106,"_47":1107,"_49":48},"oPRXquwp",{},[],"A. Concern mitigation matrix",{"_33":1109,"_35":1110},[],{"_37":38,"_39":1111,"_41":42,"_43":1112,"_45":1113,"_47":1114,"_49":48},"GWICPxNT",{},[],"B. Key quotes",{"_33":1116,"_35":1117},[],{"_37":38,"_39":1118,"_41":42,"_43":1119,"_45":1120,"_47":1121,"_49":48},"LygKw0n4",{},[],"C. Glossary: SKOS, DCAT, SHACL, JSON-LD, DAG-CBOR, CID, FAIR, EIF, CPSV, RML, SPARQL Anything, FaCade-X, OWL, RDFS",{"_33":1123,"_35":1124},[],{"_37":38,"_39":1125,"_41":42,"_43":1126,"_45":1127,"_47":1128,"_49":48},"hUb-g6-4",{},[],"D. References---",{"_37":53,"_39":1130,"_41":42,"_43":1131,"_45":1132,"_47":1133,"_49":48},"I4yEAFSY",{"_100":101},[],"Appendices",{"_33":1135,"_35":1136},[],{"_37":53,"_39":1137,"_41":42,"_43":1138,"_45":1139,"_47":103,"_49":48},"vZOJH4MO",{},[],{"_33":1141,"_35":1142},[],{"_37":53,"_39":1143,"_41":42,"_43":1144,"_45":1145,"_47":1146,"_49":48},"o7xoO4zv",{},[],"0.1 Single Guiding Principle",{"_33":1148,"_35":1163},[1149],{"_33":1150,"_35":1151},[],{"_37":38,"_39":1152,"_41":42,"_43":1153,"_45":1154,"_47":1162,"_49":48},"XM-3B7UL",{},[1155],{"_37":1156,"_68":1157,"_71":1159,"_43":1161,"_49":48},"Bold",[1158],0,[1160],147,{},"Does this make it easier for a third-party developer, or non-tech product builder, to ship an application on Seed Hypermedia than it was yesterday?",{"_37":38,"_39":1164,"_41":42,"_43":1165,"_45":1167,"_47":1168,"_49":48},"QwdD0IdC",{"_100":1166},"Blockquote",[],"Every technical decision in this roadmap is filtered through one question:",{"_33":1170,"_35":1171},[],{"_37":38,"_39":1172,"_41":42,"_43":1173,"_45":1174,"_47":1175,"_49":48},"eTACLtCz",{},[],"If the answer is no, we simplify. If the answer is yes, we ship.",{"_33":1177,"_35":1178},[],{"_37":38,"_39":1179,"_41":42,"_43":1180,"_45":1181,"_47":1182,"_49":48},"1BSHsIzw",{},[],"\"Ship\" is intentional. Not \"build,\" not \"prototype\" — ship. The full loop: create, test, publish, make available to others. This forces every decision to account for the publish-to-IPFS step, the discoverability story, the community extension mechanism, not just the local development experience. And \"non-tech product builder\" is intentional too: if the semantic layer only serves TypeScript developers, it has failed. The whole point of making capabilities explicit, discoverable, and self-describing is that you should not need to read Go source code to assemble a working application.",{"_33":1184,"_35":1185},[],{"_37":38,"_39":1186,"_41":42,"_43":1187,"_45":1188,"_47":1189,"_49":48},"3fhVG6gF",{},[],"This is not a documentation problem. It is an information architecture problem: the platform's capabilities — block types, document relationships, metadata, possible extensions — live in code today. They are implicit, buried in Go structs and TypeScript interfaces. For a developer who wants to build something new, the path is: read the source, reverse-engineer the conventions, and hope nothing breaks.",{"_33":1191,"_35":1192},[],{"_37":38,"_39":1193,"_41":42,"_43":1194,"_45":1195,"_47":1196,"_49":48},"RDL-lW0B",{},[],"The semantic layer turns that situation into one where a third-party developer can query the platform to find out what exists, build custom interfaces without depending on the core team's documentation, and extend the vocabulary with their own types — compatible with the existing ecosystem, without prior coordination. Without a semantic layer, every new application requires a conversation with the Seed team. With one, the ecosystem can grow in a decentralized fashion — exactly like the web itself.",{"_33":1198,"_35":1199},[],{"_37":53,"_39":1200,"_41":42,"_43":1201,"_45":1202,"_47":1203,"_49":48},"N4Tu0PtD",{},[],"0.2 Rich Hickey's Philosophy Applied: What We Take, What We Leave Behind",{"_33":1205,"_35":1264},[1206,1218,1229,1241,1253],{"_33":1207,"_35":1208},[],{"_37":38,"_39":1209,"_41":42,"_43":1210,"_45":1211,"_47":1217,"_49":48},"JcvZt1GP",{},[1212],{"_37":1156,"_68":1213,"_71":1214,"_43":1216,"_49":48},[1158],[1215],42,{},"\"Effective Programs — 10 Years of Clojure\" (2017, Clojure/conj) — primary source, contains the explicit \"RDF got it right\" slide",{"_33":1219,"_35":1220},[],{"_37":38,"_39":1221,"_41":42,"_43":1222,"_45":1223,"_47":1228,"_49":48},"p6P_OoZH",{},[1224],{"_37":1156,"_68":1225,"_71":1226,"_43":1227,"_49":48},[1158],[864],{},"\"Deconstructing the Database\" (2012, JaxConf) — RDF triples vs. Datomic datoms",{"_33":1230,"_35":1231},[],{"_37":38,"_39":1232,"_41":42,"_43":1233,"_45":1234,"_47":1240,"_49":48},"7zeu69lZ",{},[1235],{"_37":1156,"_68":1236,"_71":1237,"_43":1239,"_49":48},[1158],[1238],35,{},"Cognicast Episode 103: Clojure Spec (2016) — RDF as prior art for property-level specs",{"_33":1242,"_35":1243},[],{"_37":38,"_39":1244,"_41":42,"_43":1245,"_45":1246,"_47":1252,"_49":48},"LF4OdFLh",{},[1247],{"_37":1156,"_68":1248,"_71":1249,"_43":1251,"_49":48},[1158],[1250],14,{},"\"Datomic Ions\" — universal relation (EAVT) as triples-plus-time",{"_33":1254,"_35":1255},[],{"_37":38,"_39":1256,"_41":42,"_43":1257,"_45":1258,"_47":1263,"_49":48},"QMmWIByE",{},[1259],{"_37":1156,"_68":1260,"_71":1261,"_43":1262,"_49":48},[1158],[864],{},"The Datomic Information Model (InfoQ article, 2013) — closed-world vs. open-world",{"_37":38,"_39":1265,"_41":42,"_43":1266,"_45":1267,"_47":1268,"_49":48},"8Mh5cpNR",{"_100":101},[],"Our approach draws directly from Rich Hickey's nuanced position on RDF (thanks for that @Alexandr), synthesized from five public talks and interviews:",{"_33":1270,"_35":1271},[],{"_37":53,"_39":1272,"_41":42,"_43":1273,"_45":1274,"_47":1275,"_49":48},"RmybSUHN",{},[],"What We Take",{"_33":1277,"_35":1278},[],{"_37":38,"_39":1279,"_41":42,"_43":1280,"_45":1281,"_47":1299,"_49":48},"pE29MiDA",{},[1282,1287],{"_37":1156,"_68":1283,"_71":1284,"_43":1286,"_49":48},[1158],[1285],40,{},{"_37":248,"_68":1288,"_71":1293,"_43":1298,"_49":48},[1289,1290,1291,1292],411,423,451,463,[1294,1295,1296,1297],415,429,455,474,{},"URI-based naming — solving parochialism. Hickey's strongest endorsement. In \"Effective Programs\" he introduces \"parochialism\" — the problem where each system defines names inside its own little world (a class, a table, an ADT). He calls RDF's use of URIs for names \"a fantastically good idea\" and models Clojure's namespace-qualified keywords directly on this principle. The core problem: when System A defines name inside Person and System B defines name inside MailingList, merging is brutal. Large enterprises end up introducing a third database — often an RDF database — as a federation point just to resolve these collisions. Global, URI-based naming prevents naming conflicts across independently developed systems. This is foundational for decentralized cooperation.",{"_33":1301,"_35":1302},[],{"_37":38,"_39":1303,"_41":42,"_43":1304,"_45":1305,"_47":1310,"_49":48},"BS-LJ1Bp",{},[1306],{"_37":1156,"_68":1307,"_71":1308,"_43":1309,"_49":48},[1158],[1285],{},"Atomic facts (subject/predicate/object). Hickey considers the triple structure \"generally a good idea\" because \"it seems atomic\" and \"we really do want atomic facts.\" The triple decomposition breaks what he calls the \"tyranny of the container\" — information is not owned by some aggregate structure (table, class, document). Datomic's datom (entity/attribute/value/transaction) is directly derived from this primitive.",{"_33":1312,"_35":1313},[],{"_37":38,"_39":1314,"_41":42,"_43":1315,"_45":1316,"_47":1334,"_49":48},"3vg3DAO3",{},[1317,1322,1328],{"_37":1156,"_68":1318,"_71":1319,"_43":1321,"_49":48},[1158],[1320],37,{},{"_37":67,"_68":1323,"_71":1325,"_43":1327,"_49":48},[1324],68,[1326],244,{},{"_37":248,"_68":1329,"_71":1331,"_43":1333,"_49":48},[1330],286,[1332],298,{},"Properties independent of aggregates. From the Cognicast interview: \"I would definitely point to RDF as prior art in terms of thinking about properties, they called them, independent of aggregates. Property definitions have stood on their own.\" This is the philosophical foundation for clojure.spec defining specs at the keyword level rather than at the struct/aggregate level. Properties (predicates/attributes) are first-class, globally named entities — not things owned by a container. Define semantics at the property/attribute level, not the record/class level. This enables composition and evolution.",{"_33":1336,"_35":1337},[],{"_37":38,"_39":1338,"_41":42,"_43":1339,"_45":1340,"_47":1351,"_49":48},"UldQebdO",{},[1341,1345],{"_37":1156,"_68":1342,"_71":1343,"_43":1344,"_49":48},[1158],[252],{},{"_37":67,"_68":1346,"_71":1348,"_43":1350,"_49":48},[1347],344,[1349],420,{},"Data mergeability across schemas. On a slide titled \"Parochialism — names,\" Hickey states flatly: \"RDF got it right.\" RDF facilitates data merging even when underlying schemas differ. It supports schema evolution over time without requiring all consumers to change. He contrasts this with elaborate type systems that create \"parochial types\" — \"The more elaborate your type system is, the more parochial your types are.\" Interoperability and mergeability are features of the naming and decomposition strategy, not of complex type machinery.",{"_33":1353,"_35":1354},[],{"_37":38,"_39":1355,"_41":42,"_43":1356,"_45":1357,"_47":1368,"_49":48},"eSOFFHkD",{},[1358,1362],{"_37":1156,"_68":1359,"_71":1360,"_43":1361,"_49":48},[1158],[591],{},{"_37":248,"_68":1363,"_71":1365,"_43":1367,"_49":48},[1364],91,[1366],109,{},"Namespace qualification. Clojure's convention of reversed-domain namespace-qualified keys (:com.example/email) is explicitly modeled on RDF's URI-based naming. Hickey notes this makes all Clojure names conflict-free not only with other Clojure names but with Java names too. The namespace convention from RDF is one of the most practically valuable ideas, independent of the rest of the RDF stack.",{"_33":1370,"_35":1371},[],{"_37":38,"_39":1372,"_41":42,"_43":1373,"_45":1374,"_47":1379,"_49":48},"vGMvvc17",{},[1375],{"_37":1156,"_68":1376,"_71":1377,"_43":1378,"_49":48},[1158],[250],{},"Schema-per-attribute (not schema-per-table). Datomic defines schema at the attribute level, not via ontologies or table schemas. This is the right granularity for evolving systems.",{"_33":1381,"_35":1382},[],{"_37":53,"_39":1383,"_41":42,"_43":1384,"_45":1385,"_47":1386,"_49":48},"n63QntJe",{},[],"What We Leave Behind",{"_33":1388,"_35":1389},[],{"_37":38,"_39":1390,"_41":42,"_43":1391,"_45":1392,"_47":1412,"_49":48},"g0Kx64AU",{},[1393,1398],{"_37":1156,"_68":1394,"_71":1395,"_43":1397,"_49":48},[1158],[1396],47,{},{"_37":67,"_68":1399,"_71":1405,"_43":1411,"_49":48},[1400,1401,1402,1403,1404],130,142,185,348,582,[1406,1407,1408,1409,1410],132,146,311,488,794,{},"No temporal dimension — triples are not enough. Hickey's primary and most repeated critique. RDF triples represent that something is, but not when it became true or stopped being true: \"I've argued that that's not enough, because it doesn't let you represent facts, because it doesn't have any temporal aspect.\" From the Datomic Information Model: \"Without a temporal notion or proper representation of retraction, RDF statements are insufficient for representing historical information.\" Datomic uses datoms (EAVT: entity, attribute, value, transaction) rather than triples (SPO). \"It is a relational system, but it has essentially one relation: EAVT. Entity, Attribute, Value, and Time. If you ever worked with RDF or anything like that, there are triples. So this is like triples plus time.\"",{"_33":1414,"_35":1415},[],{"_37":38,"_39":1416,"_41":42,"_43":1417,"_45":1418,"_47":1430,"_49":48},"h4vITQJW",{},[1419,1424],{"_37":1156,"_68":1420,"_71":1421,"_43":1423,"_49":48},[1158],[1422],22,{},{"_37":67,"_68":1425,"_71":1427,"_43":1429,"_49":48},[1426],169,[1428],366,{},"Open-world assumption. RDF and the semantic web assume an open world — anything not stated might still be true. Datomic deliberately adopts the closed-world assumption: \"Being oriented toward business information systems, Datomic adopts the closed-world assumption, avoiding the challenges of universal naming, open-world, shared semantics etc. of the semantic web.\" For situated programs dealing with information you control, you need to know what you don't know. The open-world assumption makes practical validation and reasoning extremely difficult. It is appropriate for the global semantic web vision but impractical for most application-level information systems.",{"_33":1432,"_35":1433},[],{"_37":38,"_39":1434,"_41":42,"_43":1435,"_45":1436,"_47":1446,"_49":48},"0cBhznHX",{},[1437,1441],{"_37":1156,"_68":1438,"_71":1439,"_43":1440,"_49":48},[1158],[305],{},{"_37":67,"_68":1442,"_71":1443,"_43":1445,"_49":48},[309],[1444],173,{},"Properties as \"just names\" without additional machinery. From the Cognicast: \"In RDF, without combining it with RDF schema or something else, the properties are just names.\" Raw RDF gives you naming and linking but not validation, constraints, or operational semantics. You need RDFS, OWL, or SHACL layered on top — and each layer adds complexity that may not be justified. The naming convention is valuable on its own; the rest of the semantic stack should be adopted only when justified by actual requirements.",{"_33":1448,"_35":1449},[],{"_37":38,"_39":1450,"_41":42,"_43":1451,"_45":1452,"_47":1457,"_49":48},"Hz49GoyC",{},[1453],{"_37":1156,"_68":1454,"_71":1455,"_43":1456,"_49":48},[1158],[308],{},"Full stack complexity (OWL, reasoners, SPARQL, triple stores). Hickey never produces a systematic \"bad RDF\" list, but his design choices with Datomic speak clearly. He took what he liked and deliberately dropped the rest. Kept: atomic facts, URI-named attributes, universal relation, schema-per-attribute. Dropped: triple stores, SPARQL, OWL reasoning, blank nodes, open-world semantics, verbose serialization. Datomic uses Datalog (not SPARQL) for queries. It uses a universal relation (not a graph store). It defines schema at the attribute level (not via ontologies). You can capture the essential value of RDF's ideas without adopting the RDF infrastructure.",{"_33":1459,"_35":1460},[],{"_37":38,"_39":1461,"_41":42,"_43":1462,"_45":1463,"_47":1469,"_49":48},"AiKPHsR8",{},[1464],{"_37":1156,"_68":1465,"_71":1466,"_43":1468,"_49":48},[1158],[1467],12,{},"Blank nodes. The Datomic model requires that all entities have stable identifiers. This is a deliberate rejection of RDF's blank node concept — anonymous, non-addressable nodes that cause well-documented problems with merging, querying, and canonicalization. Prefer named resources. Blank nodes are a complexity trap.",{"_33":1471,"_35":1472},[],{"_37":53,"_39":1473,"_41":42,"_43":1474,"_45":1475,"_47":1476,"_49":48},"ondQgWlS",{},[],"Summary: Take vs. Leave",{"_33":1478,"_35":1479},[],{"_37":38,"_39":1480,"_41":42,"_43":1481,"_45":1482,"_47":1498,"_49":48},"x-fDIGGO",{},[1483],{"_37":1156,"_68":1484,"_71":1491,"_43":1497,"_49":48},[1485,1486,1487,1488,1489,1490],25,86,145,210,275,309,[1492,1493,1494,1495,1332,1496],41,98,181,242,329,{},"Take From RDFLeave BehindURI-based naming (global, conflict-free)Open-world assumptionAtomic facts (subject/predicate/object)Triples without timeProperties independent of aggregatesOWL reasoning / RDFS rigidityData mergeability across schemasTriple stores & SPARQL complexityNamespace qualificationBlank nodesSchema-per-attribute (not schema-per-table)Verbose serialization (XML/Turtle)",{"_33":1500,"_35":1565},[1501,1513,1525,1542,1553],{"_33":1502,"_35":1503},[],{"_37":38,"_39":1504,"_41":42,"_43":1505,"_45":1506,"_47":1512,"_49":48},"q424e3gz",{},[1507],{"_37":1156,"_68":1508,"_71":1509,"_43":1511,"_49":48},[1158],[1510],50,{},"Use SKOS + JSON-LD for naming and interoperability — this captures the \"good parts\" (URIs, namespaces, self-describing properties, mergeability) without the infrastructure overhead.",{"_33":1514,"_35":1515},[],{"_37":38,"_39":1516,"_41":42,"_43":1517,"_45":1518,"_47":1524,"_49":48},"0BDw0nGc",{},[1519],{"_37":1156,"_68":1520,"_71":1521,"_43":1523,"_49":48},[1158],[1522],45,{},"Keep runtime data in native formats (CBOR/Go) — just as Datomic stores datoms in its own efficient format while borrowing RDF's conceptual model, Hypermedia can keep DAG-CBOR as the storage/wire format while using RDF as a specification language.",{"_33":1526,"_35":1527},[],{"_37":38,"_39":1528,"_41":42,"_43":1529,"_45":1530,"_47":1541,"_49":48},"QKwDA-0E",{},[1531,1535],{"_37":1156,"_68":1532,"_71":1533,"_43":1534,"_49":48},[1158],[252],{},{"_37":67,"_68":1536,"_71":1538,"_43":1540,"_49":48},[1537],87,[1539],92,{},"RDF as specification, not runtime — Hickey essentially did this with Datomic: took the ideas of RDF (atomic facts, global naming, properties-as-first-class) and implemented them in a system that has zero RDF dependencies at runtime.",{"_33":1543,"_35":1544},[],{"_37":38,"_39":1545,"_41":42,"_43":1546,"_45":1547,"_47":1552,"_49":48},"2496jvNf",{},[1548],{"_37":1156,"_68":1549,"_71":1550,"_43":1551,"_49":48},[1158],[593],{},"Add complexity only when justified — Hickey's progression (simple data → Clojure spec → Datomic schema) mirrors the proposed SKOS → RDFS → OWL upgrade path. Start minimal, formalize when patterns stabilize.",{"_33":1554,"_35":1555},[],{"_37":38,"_39":1556,"_41":42,"_43":1557,"_45":1558,"_47":1564,"_49":48},"XDSWXN2q",{},[1559],{"_37":1156,"_68":1560,"_71":1561,"_43":1563,"_49":48},[1158],[1562],55,{},"Closed-world for your system, open-world for federation — internally, validate with closed-world assumptions (SHACL). Externally, publish SKOS concepts that anyone can extend without coordination. This dual posture is exactly what Datomic achieves: strict internally, composable externally.",{"_37":53,"_39":1566,"_41":42,"_43":1567,"_45":1569,"_47":1570,"_49":48},"l5iFso-7",{"_100":1568},"Ordered",[],"How Hickey's Philosophy Maps to Seed",{"_33":1572,"_35":1573},[],{"_37":53,"_39":1574,"_41":42,"_43":1575,"_45":1576,"_47":1577,"_49":48},"pjYejM6f",{},[],"0.3 Frugality Constraints",{"_33":1579,"_35":1580},[],{"_37":38,"_39":1581,"_41":42,"_43":1582,"_45":1583,"_47":1584,"_49":48},"sxehXBbS",{},[],"Three hard constraints that apply to every section of this roadmap:",{"_33":1586,"_35":1587},[],{"_37":38,"_39":1588,"_41":42,"_43":1589,"_45":1590,"_47":1600,"_49":48},"5GyqZ7Ka",{},[1591,1595],{"_37":1156,"_68":1592,"_71":1593,"_43":1594,"_49":48},[1158],[70],{},{"_37":248,"_68":1596,"_71":1598,"_43":1599,"_49":48},[1597],79,[1539],{},"Zero new runtime dependencies. The Go backend keeps reading CBOR and JSON with encoding/json. No RDF library is imported in production Go code. No JSON-LD processing library ships in the browser bundle. RDF is a specification language, not a runtime system.",{"_33":1602,"_35":1603},[],{"_37":38,"_39":1604,"_41":42,"_43":1605,"_45":1606,"_47":1614,"_49":48},"5w3radGY",{},[1607],{"_37":1156,"_68":1608,"_71":1610,"_43":1613,"_49":48},[1158,1609],236,[1611,1612],19,258,{},"Zero triple stores. We are not adding an RDF database to the architecture. No Jena, no Virtuoso, no GraphDB. Python tools (rdflib, pyshacl, pyLODE) run at development/build time only. The Go runtime never touches RDF. The approach is a virtual semantic layer: in-memory Python processing for development and tooling, generating static artifacts consumed by Go and TypeScript at runtime. No persistent RDF database anywhere in the stack.",{"_33":1616,"_35":1617},[],{"_37":38,"_39":1618,"_41":42,"_43":1619,"_45":1620,"_47":1639,"_49":48},"eaDXZjYh",{},[1621,1627,1633],{"_37":1156,"_68":1622,"_71":1624,"_43":1626,"_49":48},[1158,1623],346,[1250,1625],362,{},{"_37":67,"_68":1628,"_71":1630,"_43":1632,"_49":48},[1629],202,[1631],204,{},{"_37":248,"_68":1634,"_71":1636,"_43":1638,"_49":48},[1635],703,[1637],714,{},"Zero rewrites. Existing formats (DAG-CBOR, gRPC) do not change. The semantic layer overlays: it describes what already exists, then enables extending it. The vocabulary is not a secondary artifact — it is the public specification of what the platform can do. Explicit and discoverable mean nothing without usable: the semantic layer provides the stable contracts developers need — TypeScript types generated from the vocabulary (autocomplete and compile-time checking), embedded JSON-LD contexts (zero network calls, zero runtime dependencies), and validation shapes (SHACL, clear error messages when an extension violates the contract). The goal is not for developers to \"learn RDF.\" It is for them to npm install a package and have everything work.",{"_33":1641,"_35":1642},[],{"_37":53,"_39":1643,"_41":42,"_43":1644,"_45":1645,"_47":1646,"_49":48},"LcPSRF0z",{},[],"0.4 What the Semantic Layer Is Not",{"_33":1648,"_35":1649},[],{"_37":38,"_39":1650,"_41":42,"_43":1651,"_45":1652,"_47":1662,"_49":48},"trmJQBpJ",{},[1653,1657],{"_37":1156,"_68":1654,"_71":1655,"_43":1656,"_49":48},[1158],[1485],{},{"_37":248,"_68":1658,"_71":1660,"_43":1661,"_49":48},[1659],129,[1401],{},"It is not a triple store. We are not adding an RDF database to the architecture. The Go backend keeps reading CBOR and JSON with encoding/json. RDF is a specification language, not a runtime system.",{"_33":1664,"_35":1665},[],{"_37":38,"_39":1666,"_41":42,"_43":1667,"_45":1668,"_47":1673,"_49":48},"2k4hNOkz",{},[1669],{"_37":1156,"_68":1670,"_71":1671,"_43":1672,"_49":48},[1158],[250],{},"It is not a rewrite. Existing formats (DAG-CBOR, gRPC) do not change. The semantic layer overlays: it describes what already exists, then enables extending it.",{"_33":1675,"_35":1676},[],{"_37":38,"_39":1677,"_41":42,"_43":1678,"_45":1679,"_47":1685,"_49":48},"qeadxJgX",{},[1680],{"_37":1156,"_68":1681,"_71":1682,"_43":1684,"_49":48},[1158],[1683],43,{},"It is not heavyweight ontology engineering. We are using SKOS — the simplest W3C standard — not OWL, not reasoners, not automated inference. Complexity gets added only when concrete use cases justify it.",{"_33":1687,"_35":1688},[],{"_37":38,"_39":1689,"_41":42,"_43":1690,"_45":1691,"_47":1697,"_49":48},"dB3pvGio",{},[1692],{"_37":1156,"_68":1693,"_71":1694,"_43":1696,"_49":48},[1158],[1695],31,{},"It is not an academic exercise. Success is measured by third-party developers shipping applications, not by theoretical elegance.",{"_33":1699,"_35":1700},[],{"_37":53,"_39":1701,"_41":42,"_43":1702,"_45":1703,"_47":194,"_49":48},"z2jVR5pj",{},[],{"_33":1705,"_35":1706},[],{"_37":38,"_39":1707,"_41":42,"_43":1708,"_45":1709,"_47":1710,"_49":48},"T0gatCQD",{},[],"Before writing a single line of SKOS Turtle, before generating a single TypeScript type, we need to name our assumptions, design the cheapest possible experiments to test them, and define what failure looks like. This section is the engineering discipline that prevents the roadmap from becoming a plan we execute on faith.",{"_33":1712,"_35":1713},[],{"_37":38,"_39":1714,"_41":42,"_43":1715,"_45":1716,"_47":1717,"_49":48},"5JtcroFD",{},[],"The semantic layer is a bet. It bets that formalizing Seed's implicit capabilities into a structured vocabulary will unlock third-party development. That bet rests on a chain of hypotheses. If any link in the chain breaks, the entire value proposition collapses — or, more usefully, needs rethinking. The Hello World POC exists to stress-test this chain before committing to a multi-week sprint.",{"_33":1719,"_35":1720},[],{"_37":53,"_39":1721,"_41":42,"_43":1722,"_45":1723,"_47":1724,"_49":48},"SkvYryQd",{},[],"1.1 The Hypotheses",{"_33":1726,"_35":1727},[],{"_37":38,"_39":1728,"_41":42,"_43":1729,"_45":1730,"_47":1731,"_49":48},"wSVWp-49",{},[],"Each hypothesis is stated as a falsifiable claim. For each, we define the experiment, the success criterion, the failure signal, and what we learn from failure.",{"_33":1733,"_35":1734},[],{"_37":53,"_39":1735,"_41":42,"_43":1736,"_45":1737,"_47":1738,"_49":48},"AdpSLjnp",{},[],"H1 — Describability Without Breakage",{"_33":1740,"_35":1741},[],{"_37":38,"_39":1742,"_41":42,"_43":1743,"_45":1744,"_47":1749,"_49":48},"gQsd5Zk2",{},[1745],{"_37":1156,"_68":1746,"_71":1747,"_43":1748,"_49":48},[1158],[973],{},"Claim: An existing Seed document (DAG-CBOR, published on IPFS) can be described by a SKOS vocabulary and a JSON-LD context without changing the document format, without breaking existing consumers, and without altering its CID.",{"_33":1751,"_35":1752},[],{"_37":38,"_39":1753,"_41":42,"_43":1754,"_45":1755,"_47":1761,"_49":48},"_3FltJtq",{},[1756],{"_37":1156,"_68":1757,"_71":1758,"_43":1760,"_49":48},[1158],[1759],15,{},"Why it matters: If adding semantic metadata requires reformatting existing documents, the entire \"overlay, don't rewrite\" premise collapses. Every existing document on IPFS would need to be re-published.",{"_33":1763,"_35":1764},[],{"_37":38,"_39":1765,"_41":42,"_43":1766,"_45":1767,"_47":1786,"_49":48},"YVKRLGNU",{},[1768,1773],{"_37":1156,"_68":1769,"_71":1770,"_43":1772,"_49":48},[1158],[1771],11,{},{"_37":248,"_68":1774,"_71":1779,"_43":1785,"_49":48},[1775,1776,1777,1326,1778],120,128,136,257,[1780,1781,1782,1783,1784],126,134,141,253,263,{},"Experiment: Take one real Seed document in DAG-CBOR. Write a minimal JSON-LD context that maps its existing short keys (\"type\", \"text\", \"url\") to qualified URIs. Feed the original CBOR (decoded to JSON) plus the context to a JSON-LD processor (jsonld.js or rdflib). Verify that the expanded output contains valid RDF triples. Verify that the original CBOR bytes are unchanged (same CID). Verify that the Go backend parses the document identically with and without the context.",{"_33":1788,"_35":1789},[],{"_37":38,"_39":1790,"_41":42,"_43":1791,"_45":1792,"_47":1803,"_49":48},"l9oYheeE",{},[1793,1798],{"_37":1156,"_68":1794,"_71":1795,"_43":1797,"_49":48},[1158],[1796],18,{},{"_37":248,"_68":1799,"_71":1801,"_43":1802,"_49":48},[1800],84,[1493],{},"Success criterion: The document is valid JSON-LD without byte-level changes. The Go json.Unmarshal call produces identical output. The IPFS CID is preserved.",{"_33":1805,"_35":1806},[],{"_37":38,"_39":1807,"_41":42,"_43":1808,"_45":1809,"_47":1820,"_49":48},"mXcj3KfP",{},[1810,1814],{"_37":1156,"_68":1811,"_71":1812,"_43":1813,"_49":48},[1158],[1759],{},{"_37":248,"_68":1815,"_71":1817,"_43":1819,"_49":48},[1816],115,[1818],118,{},"Failure signal: The existing key names cannot be cleanly mapped (naming collisions, reserved JSON-LD keywords like @id conflicting with existing fields). The CBOR encoding includes structures that JSON-LD cannot represent (raw binary, CBOR tags).",{"_33":1822,"_35":1823},[],{"_37":38,"_39":1824,"_41":42,"_43":1825,"_45":1826,"_47":1831,"_49":48},"dU5L1PVn",{},[1827],{"_37":1156,"_68":1828,"_71":1829,"_43":1830,"_49":48},[1158],[591],{},"What failure teaches us: If CBOR structures resist JSON-LD mapping, we need a translation layer between the CBOR wire format and the JSON-LD interoperability format, rather than treating them as the same artifact. This changes the architecture from \"overlay\" to \"projection\" — still viable, but different.",{"_33":1833,"_35":1834},[],{"_37":53,"_39":1835,"_41":42,"_43":1836,"_45":1837,"_47":1838,"_49":48},"F-MGzPtP",{},[],"H2 — Discoverability Without Source Code",{"_33":1840,"_35":1841},[],{"_37":38,"_39":1842,"_41":42,"_43":1843,"_45":1844,"_47":1849,"_49":48},"dROWCAaP",{},[1845],{"_37":1156,"_68":1846,"_71":1847,"_43":1848,"_49":48},[1158],[973],{},"Claim: A developer who has never seen the Seed codebase can, given only the published SKOS vocabulary and JSON-LD context, correctly identify the available block types, their properties, and their relationships — and produce a valid document.",{"_33":1851,"_35":1852},[],{"_37":38,"_39":1853,"_41":42,"_43":1854,"_45":1855,"_47":1860,"_49":48},"gbMjf2tw",{},[1856],{"_37":1156,"_68":1857,"_71":1858,"_43":1859,"_49":48},[1158],[1759],{},"Why it matters: This is the core value proposition. If the vocabulary is not self-sufficient for understanding, it is documentation with extra steps, not a semantic layer.",{"_33":1862,"_35":1863},[],{"_37":38,"_39":1864,"_41":42,"_43":1865,"_45":1866,"_47":1871,"_49":48},"d29dxy9A",{},[1867],{"_37":1156,"_68":1868,"_71":1869,"_43":1870,"_49":48},[1158],[1771],{},"Experiment: Write the minimal SKOS vocabulary for 3 block types (Paragraph, Image, Heading). Publish the vocabulary and JSON-LD context as standalone files. Give these files to a person who has not worked on Seed (an intern, a colleague from a different project, a friend). Ask them to: (a) list the available block types, (b) describe the properties of an Image block, (c) produce a JSON document that conforms to the vocabulary. Time them. Record where they get stuck.",{"_33":1873,"_35":1874},[],{"_37":38,"_39":1875,"_41":42,"_43":1876,"_45":1877,"_47":1882,"_49":48},"ae-Ei4JK",{},[1878],{"_37":1156,"_68":1879,"_71":1880,"_43":1881,"_49":48},[1158],[1796],{},"Success criterion: The test subject can complete all three tasks in under 30 minutes using only the vocabulary files and the generated HTML documentation. They produce a valid document without asking a question about the Seed codebase.",{"_33":1884,"_35":1885},[],{"_37":38,"_39":1886,"_41":42,"_43":1887,"_45":1888,"_47":1898,"_49":48},"nJ3A3-S3",{},[1889,1893],{"_37":1156,"_68":1890,"_71":1891,"_43":1892,"_49":48},[1158],[1759],{},{"_37":248,"_68":1894,"_71":1896,"_43":1897,"_49":48},[1895],165,[73],{},"Failure signal: The test subject cannot determine block properties from the SKOS vocabulary alone (SKOS describes concepts and hierarchies but not data properties — skos:prefLabel tells you the name, not the fields). The generated documentation lacks actionable examples. The JSON-LD context is incomprehensible without a tutorial.",{"_33":1900,"_35":1901},[],{"_37":38,"_39":1902,"_41":42,"_43":1903,"_45":1904,"_47":1909,"_49":48},"unc3Dqui",{},[1905],{"_37":1156,"_68":1906,"_71":1907,"_43":1908,"_49":48},[1158],[591],{},"What failure teaches us: SKOS alone may not be sufficient for the developer experience use case. We may need RDFS properties or JSON Schema alongside SKOS earlier than planned. The vocabulary needs example documents, not just definitions. The documentation generator (pyLODE) may need customization or supplementation.",{"_33":1911,"_35":1912},[],{"_37":53,"_39":1913,"_41":42,"_43":1914,"_45":1915,"_47":1916,"_49":48},"-3B2mdRD",{},[],"H3 — Community Extension Without Coordination",{"_33":1918,"_35":1919},[],{"_37":38,"_39":1920,"_41":42,"_43":1921,"_45":1922,"_47":1932,"_49":48},"98vxyLpS",{},[1923,1927],{"_37":1156,"_68":1924,"_71":1925,"_43":1926,"_49":48},[1158],[973],{},{"_37":248,"_68":1928,"_71":1929,"_43":1931,"_49":48},[1537],[1930],99,{},"Claim: A third party can define a new block type that extends the core vocabulary (via skos:broader) and produce a document using that type, without any change to the Seed codebase, without permission, and without coordination with the core team.",{"_33":1934,"_35":1935},[],{"_37":38,"_39":1936,"_41":42,"_43":1937,"_45":1938,"_47":1943,"_49":48},"0u0aGxfM",{},[1939],{"_37":1156,"_68":1940,"_71":1941,"_43":1942,"_49":48},[1158],[1759],{},"Why it matters: Decentralized extension is the difference between \"a platform\" and \"a protocol.\" If extensions require a pull request or a registry update, the ecosystem cannot grow organically.",{"_33":1945,"_35":1946},[],{"_37":38,"_39":1947,"_41":42,"_43":1948,"_45":1949,"_47":1959,"_49":48},"JdnHoIaN",{},[1950,1954],{"_37":1156,"_68":1951,"_71":1952,"_43":1953,"_49":48},[1158],[1771],{},{"_37":248,"_68":1955,"_71":1957,"_43":1958,"_49":48},[1956],167,[73],{},"Experiment: After H2, ask the test subject to invent a new block type (\"Quiz Block,\" \"Map Block,\" whatever they want). They must: (a) define it as a SKOS concept with skos:broader pointing to a core type, (b) write a JSON-LD context for their extension, (c) produce a document that uses both core and custom block types, (d) publish it (even if just as a file, not on IPFS). Verify that standard RDF tools can parse the combined document and correctly resolve both core and custom types.",{"_33":1961,"_35":1962},[],{"_37":38,"_39":1963,"_41":42,"_43":1964,"_45":1965,"_47":1980,"_49":48},"-YLi3LQa",{},[1966,1970],{"_37":1156,"_68":1967,"_71":1968,"_43":1969,"_49":48},[1158],[1796],{},{"_37":248,"_68":1971,"_71":1975,"_43":1979,"_49":48},[1972,1973,1974],72,80,177,[1976,1977,1978],78,89,189,{},"Success criterion: The combined document is valid JSON-LD. An RDF tool (rdflib, jsonld.js) can expand it and identify both the core types and the custom type. The custom type's skos:broader relationship to the core type is traversable.",{"_33":1982,"_35":1983},[],{"_37":38,"_39":1984,"_41":42,"_43":1985,"_45":1986,"_47":1991,"_49":48},"zc35vN6n",{},[1987],{"_37":1156,"_68":1988,"_71":1989,"_43":1990,"_49":48},[1158],[1759],{},"Failure signal: JSON-LD context merging fails (conflicting term definitions between core and extension contexts). The custom block type cannot reference core types across namespace boundaries. The tooling cannot resolve multiple contexts in one document.",{"_33":1993,"_35":1994},[],{"_37":38,"_39":1995,"_41":42,"_43":1996,"_45":1997,"_47":2002,"_49":48},"hs-_WWdh",{},[1998],{"_37":1156,"_68":1999,"_71":2000,"_43":2001,"_49":48},[1158],[591],{},"What failure teaches us: We may need a context-merging strategy (JSON-LD supports multiple contexts via arrays, but edge cases exist). We may need to publish the core context at a stable URL that extension contexts can reference. The \"just publish on IPFS\" story may need a discovery layer.",{"_33":2004,"_35":2005},[],{"_37":53,"_39":2006,"_41":42,"_43":2007,"_45":2008,"_47":2009,"_49":48},"FYRoKMmM",{},[],"H4 — Build-Time Generation Is Complete",{"_33":2011,"_35":2012},[],{"_37":38,"_39":2013,"_41":42,"_43":2014,"_45":2015,"_47":2020,"_49":48},"KQu-1MrG",{},[2016],{"_37":1156,"_68":2017,"_71":2018,"_43":2019,"_49":48},[1158],[973],{},"Claim: A single YAML source file can generate all downstream artifacts — SKOS Turtle, JSON-LD context, TypeScript types, Go struct tags, HTML documentation — without manual intervention, and the generated artifacts are correct and usable.",{"_33":2022,"_35":2023},[],{"_37":38,"_39":2024,"_41":42,"_43":2025,"_45":2026,"_47":2031,"_49":48},"PvsasCXq",{},[2027],{"_37":1156,"_68":2028,"_71":2029,"_43":2030,"_49":48},[1158],[1759],{},"Why it matters: If the generation pipeline is lossy or requires manual fixups, the \"single source of truth\" principle is compromised. Drift between artifacts is the failure mode this architecture is designed to prevent.",{"_33":2033,"_35":2034},[],{"_37":38,"_39":2035,"_41":42,"_43":2036,"_45":2037,"_47":2053,"_49":48},"gXEFDsXK",{},[2038,2042],{"_37":1156,"_68":2039,"_71":2040,"_43":2041,"_49":48},[1158],[1771],{},{"_37":248,"_68":2043,"_71":2048,"_43":2052,"_49":48},[2044,2045,2046,2047],139,149,276,339,[1487,2049,2050,2051],155,288,353,{},"Experiment: Write the YAML for the 3 test block types from H2. Run the generation script. Verify: (a) the Turtle is valid SKOS (parse with rapper or rdflib), (b) the JSON-LD context correctly maps short keys to URIs (expand a test document), (c) the TypeScript types compile (tsc --noEmit), (d) the Go struct tags produce correct parsing (json.Unmarshal round-trip), (e) the HTML documentation contains all concepts with correct labels, definitions, and hierarchies.",{"_33":2055,"_35":2056},[],{"_37":38,"_39":2057,"_41":42,"_43":2058,"_45":2059,"_47":2064,"_49":48},"f5QfaOjb",{},[2060],{"_37":1156,"_68":2061,"_71":2062,"_43":2063,"_49":48},[1158],[1796],{},"Success criterion: All five artifact types are generated from one YAML file, all pass validation, and none require manual editing.",{"_33":2066,"_35":2067},[],{"_37":38,"_39":2068,"_41":42,"_43":2069,"_45":2070,"_47":2075,"_49":48},"z1anlD_9",{},[2071],{"_37":1156,"_68":2072,"_71":2073,"_43":2074,"_49":48},[1158],[1759],{},"Failure signal: The YAML schema cannot express something needed by one of the output formats (e.g., CBOR integer codes have no natural place in YAML). The TypeScript type generator cannot infer field types from SKOS (SKOS describes concepts, not data shapes). The pyLODE output is missing critical information or is unreadable.",{"_33":2077,"_35":2078},[],{"_37":38,"_39":2079,"_41":42,"_43":2080,"_45":2081,"_47":2086,"_49":48},"7k5GvyeH",{},[2082],{"_37":1156,"_68":2083,"_71":2084,"_43":2085,"_49":48},[1158],[591],{},"What failure teaches us: The YAML schema may need to be richer than pure SKOS metadata — it may need to include property definitions (field names, types, cardinality) that go beyond what SKOS expresses. This is fine — the YAML is our canonical source, not a SKOS file. SKOS is an output format, not the input format.",{"_33":2088,"_35":2089},[],{"_37":53,"_39":2090,"_41":42,"_43":2091,"_45":2092,"_47":2093,"_49":48},"ufEY_Kky",{},[],"H5 — Zero Runtime Overhead Is Achievable",{"_33":2095,"_35":2096},[],{"_37":38,"_39":2097,"_41":42,"_43":2098,"_45":2099,"_47":2104,"_49":48},"IrYImqcg",{},[2100],{"_37":1156,"_68":2101,"_71":2102,"_43":2103,"_49":48},[1158],[973],{},"Claim: The semantic layer adds zero measurable overhead to document parsing in Go and zero bytes to the browser JavaScript bundle.",{"_33":2106,"_35":2107},[],{"_37":38,"_39":2108,"_41":42,"_43":2109,"_45":2110,"_47":2115,"_49":48},"R0N1wsot",{},[2111],{"_37":1156,"_68":2112,"_71":2113,"_43":2114,"_49":48},[1158],[1759],{},"Why it matters: If the semantic layer degrades performance, it will be removed. Runtime cost is a hard constraint, not a trade-off.",{"_33":2117,"_35":2118},[],{"_37":38,"_39":2119,"_41":42,"_43":2120,"_45":2121,"_47":2132,"_49":48},"QdvN4byb",{},[2122,2126],{"_37":1156,"_68":2123,"_71":2124,"_43":2125,"_49":48},[1158],[1771],{},{"_37":248,"_68":2127,"_71":2129,"_43":2131,"_49":48},[1485,2128,1977],76,[335,1800,2130],94,{},"Experiment: Benchmark Go json.Unmarshal on a test document with and without @context and @type fields. Benchmark CBOR decoding with and without integer prefix codes. Measure the npm package size (should be <5KB gzipped). Verify that no runtime JavaScript code from the vocabulary package executes in the browser.",{"_33":2134,"_35":2135},[],{"_37":38,"_39":2136,"_41":42,"_43":2137,"_45":2138,"_47":2143,"_49":48},"dEVYi7mT",{},[2139],{"_37":1156,"_68":2140,"_71":2141,"_43":2142,"_49":48},[1158],[1796],{},"Success criterion: Go parsing overhead is <1% (within measurement noise). The npm package ships zero runtime code (types only, plus static JSON). Browser bundle size delta is zero (JSON-LD strings are static, not processed).",{"_33":2145,"_35":2146},[],{"_37":38,"_39":2147,"_41":42,"_43":2148,"_45":2149,"_47":2159,"_49":48},"Kuc3xydE",{},[2150,2154],{"_37":1156,"_68":2151,"_71":2152,"_43":2153,"_49":48},[1158],[1759],{},{"_37":248,"_68":2155,"_71":2156,"_43":2158,"_49":48},[250],[2157],28,{},"Failure signal: The @context field in JSON adds non-trivial bytes to every document. CBOR prefix tables add decoding complexity. The TypeScript types import something that pulls in a dependency chain.",{"_33":2161,"_35":2162},[],{"_37":38,"_39":2163,"_41":42,"_43":2164,"_45":2165,"_47":2170,"_49":48},"HCR9k5-b",{},[2166],{"_37":1156,"_68":2167,"_71":2168,"_43":2169,"_49":48},[1158],[591],{},"What failure teaches us: We may need to separate the interoperability context (shipped alongside the document for external consumers) from the wire format (CBOR, no context overhead). The npm package structure may need stricter tree-shaking boundaries.",{"_33":2172,"_35":2173},[],{"_37":53,"_39":2174,"_41":42,"_43":2175,"_45":2176,"_47":2177,"_49":48},"xVdAZle0",{},[],"H6 — The Vocabulary Is Useful, Not Just Correct",{"_33":2179,"_35":2180},[],{"_37":38,"_39":2181,"_41":42,"_43":2182,"_45":2183,"_47":2188,"_49":48},"NLZE4_vD",{},[2184],{"_37":1156,"_68":2185,"_71":2186,"_43":2187,"_49":48},[1158],[973],{},"Claim: The generated HTML documentation, the TypeScript autocomplete, and the SKOS vocabulary actually help a developer make decisions — not just describe what already exists.",{"_33":2190,"_35":2191},[],{"_37":38,"_39":2192,"_41":42,"_43":2193,"_45":2194,"_47":2199,"_49":48},"KKrQLeMY",{},[2195],{"_37":1156,"_68":2196,"_71":2197,"_43":2198,"_49":48},[1158],[1759],{},"Why it matters: A vocabulary that restates the source code in a different syntax is overhead, not value. The value is in the navigability, the discoverability, the cross-referencing, the examples.",{"_33":2201,"_35":2202},[],{"_37":38,"_39":2203,"_41":42,"_43":2204,"_45":2205,"_47":2215,"_49":48},"Zl3UvXNQ",{},[2206,2210],{"_37":1156,"_68":2207,"_71":2208,"_43":2209,"_49":48},[1158],[1771],{},{"_37":248,"_68":2211,"_71":2212,"_43":2214,"_49":48},[1326],[2213],256,{},"Experiment: Give the H2 test subject a task: \"You have a document with paragraphs and images. You want to add a table of contents. Using only the vocabulary and documentation, figure out how.\" Observe whether the vocabulary helps them find the HeadingBlock type, understand its relationship to document structure, and determine what properties it needs.",{"_33":2217,"_35":2218},[],{"_37":38,"_39":2219,"_41":42,"_43":2220,"_45":2221,"_47":2231,"_49":48},"hA61e1nU",{},[2222,2226],{"_37":1156,"_68":2223,"_71":2224,"_43":2225,"_49":48},[1158],[1796],{},{"_37":248,"_68":2227,"_71":2228,"_43":2230,"_49":48},[1494],[2229],195,{},"Success criterion: The vocabulary and documentation provide enough context for the subject to solve the task without reading source code or asking for help. The SKOS hierarchy, the skos:scopeNote annotations, and the examples are the critical assets.",{"_33":2233,"_35":2234},[],{"_37":38,"_39":2235,"_41":42,"_43":2236,"_45":2237,"_47":2242,"_49":48},"tu-I3ePk",{},[2238],{"_37":1156,"_68":2239,"_71":2240,"_43":2241,"_49":48},[1158],[1759],{},"Failure signal: The subject finds the type definitions but cannot figure out how types compose into a document. The vocabulary describes atomic blocks but not their assembly into documents. The documentation is a flat list, not a navigable resource.",{"_33":2244,"_35":2245},[],{"_37":38,"_39":2246,"_41":42,"_43":2247,"_45":2248,"_47":2259,"_49":48},"icuHOyJo",{},[2249,2253],{"_37":1156,"_68":2250,"_71":2251,"_43":2252,"_49":48},[1158],[591],{},{"_37":248,"_68":2254,"_71":2255,"_43":2258,"_49":48},[1978,1629],[2256,2257],200,213,{},"What failure teaches us: We may need to model document-level composition (how blocks assemble into documents) in the vocabulary, not just block-level taxonomy. We may need RDFS properties (hm:hasBlock, hm:position) earlier than planned. The generated documentation may need custom templates with usage-oriented guides, not just reference pages.",{"_33":2261,"_35":2262},[],{"_37":53,"_39":2263,"_41":42,"_43":2264,"_45":2265,"_47":2266,"_49":48},"lQY-8vtg",{},[],"1.2 Experiment Ordering and Dependencies",{"_33":2268,"_35":2269},[],{"_37":38,"_39":2270,"_41":42,"_43":2271,"_45":2272,"_47":2273,"_49":48},"5gQE7WkY",{},[],"The hypotheses have dependencies. Testing them in the wrong order wastes effort.",{"_33":2275,"_35":2276},[],{"_37":248,"_39":2277,"_41":42,"_43":2278,"_45":2281,"_47":2282,"_49":48},"v3vvOnAH",{"_2279":2280},"language","plaintext",[],"H1 (Describability)\n │\n ├──→ H4 (Build-Time Generation)\n │ │\n │ └──→ H5 (Zero Overhead)\n │\n └──→ H2 (Discoverability)\n │\n ├──→ H3 (Community Extension)\n │\n └──→ H6 (Usefulness)",{"_33":2284,"_35":2285},[],{"_37":38,"_39":2286,"_41":42,"_43":2287,"_45":2288,"_47":2294,"_49":48},"d_RD310u",{},[2289],{"_37":1156,"_68":2290,"_71":2291,"_43":2293,"_49":48},[1158],[2292],52,{},"Phase A (Day 1–2): H1 — Can we describe what exists?",{"_33":2296,"_35":2297},[],{"_37":38,"_39":2298,"_41":42,"_43":2299,"_45":2300,"_47":2301,"_49":48},"QFwv6i3E",{},[],"If the existing CBOR documents resist JSON-LD mapping, nothing else matters. This is the load-bearing hypothesis. One real document, one context file, one round-trip test. Half a day of work, maximum.",{"_33":2303,"_35":2304},[],{"_37":38,"_39":2305,"_41":42,"_43":2306,"_45":2307,"_47":2313,"_49":48},"bmtOGhoQ",{},[2308],{"_37":1156,"_68":2309,"_71":2310,"_43":2312,"_49":48},[1158],[2311],61,{},"Phase B (Day 3–4): H4 — Can we generate everything from YAML?",{"_33":2315,"_35":2316},[],{"_37":38,"_39":2317,"_41":42,"_43":2318,"_45":2319,"_47":2320,"_49":48},"Dwtbc6nS",{},[],"If the generation pipeline works, we have the artifacts for all subsequent tests. If it does not, we know which output formats need special handling. Two days of scripting, producing concrete files.",{"_33":2322,"_35":2323},[],{"_37":38,"_39":2324,"_41":42,"_43":2325,"_45":2326,"_47":2331,"_49":48},"0Q6ZlEXK",{},[2327],{"_37":1156,"_68":2328,"_71":2329,"_43":2330,"_49":48},[1158],[1562],{},"Phase C (Day 5): H5 — Does it cost anything at runtime?",{"_33":2333,"_35":2334},[],{"_37":38,"_39":2335,"_41":42,"_43":2336,"_45":2337,"_47":2338,"_49":48},"HRvxMoK5",{},[],"Quick benchmarks. If performance is fine (expected), move on. If not, we learn early and adjust the architecture before building further.",{"_33":2340,"_35":2341},[],{"_37":38,"_39":2342,"_41":42,"_43":2343,"_45":2344,"_47":2349,"_49":48},"5EMHCxy_",{},[2345],{"_37":1156,"_68":2346,"_71":2347,"_43":2348,"_49":48},[1158],[305],{},"Phase D (Day 6–8): H2 + H6 — Does it help a real person?",{"_33":2351,"_35":2352},[],{"_37":38,"_39":2353,"_41":42,"_43":2354,"_45":2355,"_47":2356,"_49":48},"dAXpg2jM",{},[],"The human test. This is the most important phase. All the technical correctness in the world means nothing if a developer cannot navigate the vocabulary. Give the artifacts to a test subject. Watch what happens. Take notes.",{"_33":2358,"_35":2359},[],{"_37":38,"_39":2360,"_41":42,"_43":2361,"_45":2362,"_47":2367,"_49":48},"1BKJmtuI",{},[2363],{"_37":1156,"_68":2364,"_71":2365,"_43":2366,"_49":48},[1158],[1562],{},"Phase E (Day 9–10): H3 — Can someone extend without us?",{"_33":2369,"_35":2370},[],{"_37":38,"_39":2371,"_41":42,"_43":2372,"_45":2373,"_47":2374,"_49":48},"NOAOeabz",{},[],"The decentralization test. If H2 passed, this should follow naturally. If H3 fails despite H2 passing, the problem is in context merging or namespace resolution, not in the vocabulary itself.",{"_33":2376,"_35":2377},[],{"_37":53,"_39":2378,"_41":42,"_43":2379,"_45":2380,"_47":2381,"_49":48},"ooJSyhAd",{},[],"1.3 The Hello World Artifact",{"_33":2383,"_35":2384},[],{"_37":38,"_39":2385,"_41":42,"_43":2386,"_45":2387,"_47":2388,"_49":48},"beGVXf5x",{},[],"The Hello World is not a demo. It is the minimal artifact that exercises all six hypotheses simultaneously. Concretely, it is:",{"_33":2390,"_35":2391},[],{"_37":38,"_39":2392,"_41":42,"_43":2393,"_45":2394,"_47":2404,"_49":48},"ZzIBikk9",{},[2395,2400],{"_37":1156,"_68":2396,"_71":2397,"_43":2399,"_49":48},[1158],[2398],13,{},{"_37":248,"_68":2401,"_71":2402,"_43":2403,"_49":48},[1759],[1695],{},"One YAML file (hello-world.yaml) defining three block types: Paragraph, Image, Heading.",{"_33":2406,"_35":2407},[],{"_37":38,"_39":2408,"_41":42,"_43":2409,"_45":2410,"_47":2425,"_49":48},"j64y_aIR",{},[2411,2415],{"_37":1156,"_68":2412,"_71":2413,"_43":2414,"_49":48},[1158],[1796],{},{"_37":248,"_68":2416,"_71":2420,"_43":2424,"_49":48},[70,1562,2417,2418,2419],95,124,153,[335,2421,1366,2422,2423],75,138,174,{},"One generation run producing: hello.ttl (SKOS Turtle), hello-context.jsonld (JSON-LD context), hello-types.ts (TypeScript), hello-types.go (Go structs), hello-docs/index.html (pyLODE documentation).",{"_33":2427,"_35":2428},[],{"_37":38,"_39":2429,"_41":42,"_43":2430,"_45":2431,"_47":2441,"_49":48},"YXoGCUZY",{},[2432,2436],{"_37":1156,"_68":2433,"_71":2434,"_43":2435,"_49":48},[1158],[1422],{},{"_37":248,"_68":2437,"_71":2438,"_43":2440,"_49":48},[591],[2439],38,{},"One real Seed document (hello-doc.cbor) taken from the existing codebase, described by the generated context, parsed by Go with and without the context, expanded by a JSON-LD processor.",{"_33":2443,"_35":2444},[],{"_37":38,"_39":2445,"_41":42,"_43":2446,"_45":2447,"_47":2456,"_49":48},"jQpOkapi",{},[2448,2452],{"_37":1156,"_68":2449,"_71":2450,"_43":2451,"_49":48},[1158],[2398],{},{"_37":248,"_68":2453,"_71":2454,"_43":2455,"_49":48},[1759],[593],{},"One extension (hello-extension.ttl) defining a custom block type by a \"third party\" (us pretending), producing a combined document, verifying RDF tool interoperability.",{"_33":2458,"_35":2459},[],{"_37":38,"_39":2460,"_41":42,"_43":2461,"_45":2462,"_47":2467,"_49":48},"rbA_Mag_",{},[2463],{"_37":1156,"_68":2464,"_71":2465,"_43":2466,"_49":48},[1158],[426],{},"One test subject (not from the core team) attempting the H2 and H6 tasks using only the generated artifacts.",{"_33":2469,"_35":2470},[],{"_37":53,"_39":2471,"_41":42,"_43":2472,"_45":2473,"_47":2474,"_49":48},"cQFliOzS",{},[],"1.4 Success and Failure Criteria for the POC",{"_33":2476,"_35":2512},[2477,2484,2491,2498,2505],{"_33":2478,"_35":2479},[],{"_37":38,"_39":2480,"_41":42,"_43":2481,"_45":2482,"_47":2483,"_49":48},"DbZk0xKe",{},[],"All six hypotheses pass (even with minor caveats or known limitations)",{"_33":2485,"_35":2486},[],{"_37":38,"_39":2487,"_41":42,"_43":2488,"_45":2489,"_47":2490,"_49":48},"oSMV5l3R",{},[],"The test subject completes the discoverability task without source code access",{"_33":2492,"_35":2493},[],{"_37":38,"_39":2494,"_41":42,"_43":2495,"_45":2496,"_47":2497,"_49":48},"289DNu9B",{},[],"The generation pipeline runs end-to-end from YAML to all artifacts",{"_33":2499,"_35":2500},[],{"_37":38,"_39":2501,"_41":42,"_43":2502,"_45":2503,"_47":2504,"_49":48},"NHdkoosU",{},[],"Zero runtime overhead is confirmed by benchmarks",{"_33":2506,"_35":2507},[],{"_37":38,"_39":2508,"_41":42,"_43":2509,"_45":2510,"_47":2511,"_49":48},"3ysxV7ng",{},[],"The combined core+extension document is valid and traversable",{"_37":38,"_39":2513,"_41":42,"_43":2514,"_45":2515,"_47":2520,"_49":48},"ZjhScYTg",{"_100":101},[2516],{"_37":1156,"_68":2517,"_71":2518,"_43":2519,"_49":48},[1158],[250],{},"The POC succeeds if:",{"_33":2522,"_35":2565},[2523,2530,2537,2544,2551,2558],{"_33":2524,"_35":2525},[],{"_37":38,"_39":2526,"_41":42,"_43":2527,"_45":2528,"_47":2529,"_49":48},"nhs88Fh2",{},[],"H1 fails → we know the overlay model needs a projection layer (architecture change, not a showstopper)",{"_33":2531,"_35":2532},[],{"_37":38,"_39":2533,"_41":42,"_43":2534,"_45":2535,"_47":2536,"_49":48},"6YZvasF4",{},[],"H2 fails → we know SKOS alone is insufficient and RDFS properties are needed earlier (scope change)",{"_33":2538,"_35":2539},[],{"_37":38,"_39":2540,"_41":42,"_43":2541,"_45":2542,"_47":2543,"_49":48},"WwTzKTxa",{},[],"H3 fails → we know context merging needs explicit design (technical fix, not architecture change)",{"_33":2545,"_35":2546},[],{"_37":38,"_39":2547,"_41":42,"_43":2548,"_45":2549,"_47":2550,"_49":48},"PjPcl2oO",{},[],"H4 fails → we know the YAML schema needs richer property metadata (schema redesign, bounded effort)",{"_33":2552,"_35":2553},[],{"_37":38,"_39":2554,"_41":42,"_43":2555,"_45":2556,"_47":2557,"_49":48},"rnNuYEUB",{},[],"H5 fails → we know interop context and wire format must be separated (already anticipated as a possibility)",{"_33":2559,"_35":2560},[],{"_37":38,"_39":2561,"_41":42,"_43":2562,"_45":2563,"_47":2564,"_49":48},"FT-OMghT",{},[],"H6 fails → we know documentation needs usage guides, not just reference pages (editorial work)",{"_37":38,"_39":2566,"_41":42,"_43":2567,"_45":2568,"_47":2573,"_49":48},"OfqGcgYo",{"_100":101},[2569],{"_37":1156,"_68":2570,"_71":2571,"_43":2572,"_49":48},[1158],[428],{},"The POC fails usefully if:",{"_33":2575,"_35":2597},[2576,2583,2590],{"_33":2577,"_35":2578},[],{"_37":38,"_39":2579,"_41":42,"_43":2580,"_45":2581,"_47":2582,"_49":48},"KsHUOJFp",{},[],"Existing CBOR documents are fundamentally incompatible with JSON-LD (e.g., CBOR tags that have no JSON-LD equivalent) AND the cost of a projection layer exceeds the value of the semantic layer",{"_33":2584,"_35":2585},[],{"_37":38,"_39":2586,"_41":42,"_43":2587,"_45":2588,"_47":2589,"_49":48},"ySngMdq-",{},[],"The generation pipeline requires manual intervention that cannot be automated",{"_33":2591,"_35":2592},[],{"_37":38,"_39":2593,"_41":42,"_43":2594,"_45":2595,"_47":2596,"_49":48},"z_9TTiAA",{},[],"The core team concludes that the vocabulary adds complexity without observable value for their use cases",{"_37":38,"_39":2598,"_41":42,"_43":2599,"_45":2600,"_47":2605,"_49":48},"vR-dIoiK",{"_100":101},[2601],{"_37":1156,"_68":2602,"_71":2603,"_43":2604,"_49":48},[1158],[593],{},"The POC fails catastrophically if:",{"_33":2607,"_35":2608},[],{"_37":38,"_39":2609,"_41":42,"_43":2610,"_45":2611,"_47":2612,"_49":48},"Sw7-xhPJ",{},[],"A catastrophic failure is a valid outcome. It means the semantic layer, as designed, is wrong for this project. Better to learn that in 10 days than in 10 weeks.",{"_33":2614,"_35":2615},[],{"_37":53,"_39":2616,"_41":42,"_43":2617,"_45":2618,"_47":2619,"_49":48},"hXkWPDU2",{},[],"1.5 What We Are Not Testing in the POC",{"_33":2621,"_35":2622},[],{"_37":38,"_39":2623,"_41":42,"_43":2624,"_45":2625,"_47":2626,"_49":48},"iK3GJIOT",{},[],"Equally important: what is explicitly out of scope for the Hello World.",{"_33":2628,"_35":2629},[],{"_37":38,"_39":2630,"_41":42,"_43":2631,"_45":2632,"_47":2637,"_49":48},"yREYL63N",{},[2633],{"_37":1156,"_68":2634,"_71":2635,"_43":2636,"_49":48},[1158],[252],{},"Not testing FAIR/DCAT compliance. EU interoperability is a downstream benefit, not a core hypothesis. If the vocabulary works for developers, DCAT metadata is a 15-line addition later.",{"_33":2639,"_35":2640},[],{"_37":38,"_39":2641,"_41":42,"_43":2642,"_45":2643,"_47":2648,"_49":48},"JiOTjh_J",{},[2644],{"_37":1156,"_68":2645,"_71":2646,"_43":2647,"_49":48},[1158],[864],{},"Not testing SHACL validation. Validation is an optional layer. The POC tests whether the vocabulary is useful, not whether it can be enforced.",{"_33":2650,"_35":2651},[],{"_37":38,"_39":2652,"_41":42,"_43":2653,"_45":2654,"_47":2659,"_49":48},"SQreYSw0",{},[2655],{"_37":1156,"_68":2656,"_71":2657,"_43":2658,"_49":48},[1158],[1285],{},"Not testing SPARQL Anything integration. Querying existing CBOR as virtual RDF is a powerful tool, but it is independent of the vocabulary's value proposition. Test it separately.",{"_33":2661,"_35":2662},[],{"_37":38,"_39":2663,"_41":42,"_43":2664,"_45":2665,"_47":2670,"_49":48},"DsvRZula",{},[2666],{"_37":1156,"_68":2667,"_71":2668,"_43":2669,"_49":48},[1158],[2157],{},"Not testing community scale. One test subject is not a community. The POC tests the mechanism (can one person extend?), not the sociology (will people want to?).",{"_33":2672,"_35":2673},[],{"_37":38,"_39":2674,"_41":42,"_43":2675,"_45":2676,"_47":2681,"_49":48},"ZFzbVWeL",{},[2677],{"_37":1156,"_68":2678,"_71":2679,"_43":2680,"_49":48},[1158],[593],{},"Not testing production deployment. CI/CD pipelines, npm publishing, GitHub Pages hosting — all important, all orthogonal to the core hypotheses. Build the pipeline after the value is confirmed.",{"_33":2683,"_35":2684},[],{"_37":53,"_39":2685,"_41":42,"_43":2686,"_45":2687,"_47":2688,"_49":48},"defvnbgQ",{},[],"1.6 Decision Gate",{"_33":2690,"_35":2691},[],{"_37":38,"_39":2692,"_41":42,"_43":2693,"_45":2694,"_47":2695,"_49":48},"-jh5sfF0",{},[],"At the end of the POC (Day 10), the team makes an explicit go/no-go decision:",{"_33":2697,"_35":2698},[],{"_37":38,"_39":2699,"_41":42,"_43":2700,"_45":2701,"_47":2707,"_49":48},"aEkQJXPr",{},[2702],{"_37":1156,"_68":2703,"_71":2704,"_43":2706,"_49":48},[1158],[2705],3,{},"Go: Proceed to Section 2 (Foundation Sprint). The hypotheses hold. The architecture is sound. The value is observable.",{"_33":2709,"_35":2710},[],{"_37":38,"_39":2711,"_41":42,"_43":2712,"_45":2713,"_47":2718,"_49":48},"zjJ8rZVz",{},[2714],{"_37":1156,"_68":2715,"_71":2716,"_43":2717,"_49":48},[1158],[250],{},"Go with adjustments: Proceed, but modify the roadmap based on POC learnings. Document each adjustment as an Architecture Decision Record. Typical adjustments: \"YAML schema needs property metadata, not just SKOS concepts\" or \"context merging requires a documented strategy.\"",{"_33":2720,"_35":2721},[],{"_37":38,"_39":2722,"_41":42,"_43":2723,"_45":2724,"_47":2729,"_49":48},"ZTA8Qa10",{},[2725],{"_37":1156,"_68":2726,"_71":2727,"_43":2728,"_49":48},[1158],[973],{},"No-go: Stop. The semantic layer is not the right investment for Seed right now. Document why. Revisit when the preconditions change (e.g., when the block type model stabilizes, when a third-party developer actually asks for formal types, when an EU compliance requirement materializes).",{"_33":2731,"_35":2732},[],{"_37":38,"_39":2733,"_41":42,"_43":2734,"_45":2735,"_47":2736,"_49":48},"HqORvatv",{},[],"A no-go is not a failure of the project. It is a success of the POC: we spent 10 days instead of 10 weeks learning that the timing is wrong.",{"_33":2738,"_35":2739},[],{"_37":53,"_39":2740,"_41":42,"_43":2741,"_45":2742,"_47":391,"_49":48},"LQU2dVZ0",{},[],{"_33":2744,"_35":2745},[],{"_37":53,"_39":2746,"_41":42,"_43":2747,"_45":2748,"_47":2749,"_49":48},"f_pD1Lp5",{},[],"2.1 Mapping the Existing Landscape",{"_33":2751,"_35":2752},[],{"_37":53,"_39":2753,"_41":42,"_43":2754,"_45":2755,"_47":2756,"_49":48},"FT4wnM64",{},[],"2.1.1 Inventory of Block Types in Go Code (Structs) and TypeScript (Interfaces)",{"_33":2758,"_35":2759},[],{"_37":38,"_39":2760,"_41":42,"_43":2761,"_45":2762,"_47":2763,"_49":48},"eiTs2j7S",{},[],"Walk the codebase and extract every block type currently defined. In Go, these are structs with CBOR/JSON tags. In TypeScript, these are interfaces or type aliases. The goal is a flat list of every type the platform currently supports, with its fields, field types, and any implicit constraints (required fields, allowed values, references to other types).",{"_33":2765,"_35":2766},[],{"_37":53,"_39":2767,"_41":42,"_43":2768,"_45":2769,"_47":2770,"_49":48},"Of_DZ6UR",{},[],"2.1.2 Extraction of Implicit Relationships Between Types",{"_33":2772,"_35":2773},[],{"_37":38,"_39":2774,"_41":42,"_43":2775,"_45":2776,"_47":2791,"_49":48},"Da3N4Ko4",{},[2777],{"_37":248,"_68":2778,"_71":2784,"_43":2790,"_49":48},[2779,1659,2780,1629,2781,2782,2783],108,161,233,254,319,[2785,1782,2786,2787,1495,2788,2789],122,172,214,267,330,{},"Identify inheritance, composition, and reference relationships that exist in code but are not formalized. A ParagraphBlock and a HeadingBlock might both embed a TextContent struct — that is an implicit skos:broader relationship to a TextBlock concept. A DocumentBlock might reference a list of child blocks — that is a hm:hasBlock relationship waiting to be named.",{"_33":2793,"_35":2794},[],{"_37":53,"_39":2795,"_41":42,"_43":2796,"_45":2797,"_47":2798,"_49":48},"I3Xu3_xG",{},[],"2.1.3 Identification of the 5–7 Priority Block Types for the Initial Vocabulary",{"_33":2800,"_35":2801},[],{"_37":38,"_39":2802,"_41":42,"_43":2803,"_45":2804,"_47":2805,"_49":48},"eioj5I6n",{},[],"Select the block types that cover the most common use cases and that third-party developers are most likely to need. Candidates: Paragraph, Heading, Image, Video, Code, Embed, Comment. The exact list is a question for Eric and the core team.",{"_33":2807,"_35":2808},[],{"_37":53,"_39":2809,"_41":42,"_43":2810,"_45":2811,"_47":2812,"_49":48},"VnHJcMYC",{},[],"2.1.4 Survey of Current Naming Conventions",{"_33":2814,"_35":2815},[],{"_37":38,"_39":2816,"_41":42,"_43":2817,"_45":2818,"_47":2819,"_49":48},"-5jWllN6",{},[],"Document every naming convention currently in use: CBOR field names, JSON key names, gRPC service and message names, TypeScript interface names. The vocabulary must map cleanly to these existing conventions — short keys in CBOR that expand to qualified URIs in JSON-LD, without breaking any existing consumer.",{"_33":2821,"_35":2822},[],{"_37":53,"_39":2823,"_41":42,"_43":2824,"_45":2825,"_47":2826,"_49":48},"cwVQZ5kX",{},[],"2.2 Canonical SKOS Vocabulary",{"_33":2828,"_35":2829},[],{"_37":53,"_39":2830,"_41":42,"_43":2831,"_45":2832,"_47":2833,"_49":48},"VGgvmJbY",{},[],"2.2.1 YAML Source File as Canonical Reference",{"_33":2835,"_35":2836},[],{"_37":38,"_39":2837,"_41":42,"_43":2838,"_45":2839,"_47":2840,"_49":48},"JcRE8yjI",{},[],"The single source of truth for the vocabulary is a YAML file. It is human-readable, version-controllable, diffable, and trivially parseable by any language. Every other artifact — Turtle, JSON-LD, TypeScript types, Go struct tags, HTML documentation — is generated from this file.",{"_33":2842,"_35":2843},[],{"_37":248,"_39":2844,"_41":42,"_43":2845,"_45":2847,"_47":2848,"_49":48},"B-gDsVcz",{"_2279":2846},"yaml",[],"# block-types.yaml — canonical source\nconcept_scheme:\n id: hm:BlockTypes\n label:\n en: \"Hypermedia Block Types\"\n fr: \"Types de blocs Hypermedia\"\n description:\n en: \"Taxonomy of content block types in Seed Hypermedia\"\n\nconcepts:\n - id: hm:Block\n top_concept: true\n label:\n en: \"Block\"\n fr: \"Bloc\"\n definition:\n en: \"Base concept for all content blocks\"\n\n - id: hm:ParagraphBlock\n broader: [hm:Block]\n label:\n en: \"Paragraph Block\"\n fr: \"Bloc Paragraphe\"\n alt_label:\n en: [\"Text Block\"]\n definition:\n en: \"Block containing plain or rich text content\"\n example:\n en: \"A paragraph of text with optional formatting\"\n\n - id: hm:ImageBlock\n broader: [hm:Block]\n label:\n en: \"Image Block\"\n fr: \"Bloc Image\"\n definition:\n en: \"Block containing an image (IPFS CID or HTTP URL)\"\n scope_note:\n en: \"Supports PNG, JPEG, GIF, WebP, SVG formats\"\n\n - id: hm:MediaBlock\n broader: [hm:Block]\n label:\n en: \"Media Block\"\n fr: \"Bloc Média\"\n definition:\n en: \"Block containing media content\"\n\n - id: hm:VideoBlock\n broader: [hm:MediaBlock]\n label:\n en: \"Video Block\"\n fr: \"Bloc Vidéo\"\n\n - id: hm:AudioBlock\n broader: [hm:MediaBlock]\n label:\n en: \"Audio Block\"\n fr: \"Bloc Audio\"\n\n - id: hm:HeadingBlock\n broader: [hm:Block]\n label:\n en: \"Heading Block\"\n fr: \"Bloc Titre\"\n\n - id: hm:CodeBlock\n broader: [hm:Block]\n label:\n en: \"Code Block\"\n fr: \"Bloc Code\"",{"_33":2850,"_35":2851},[],{"_37":53,"_39":2852,"_41":42,"_43":2853,"_45":2854,"_47":254,"_49":48},"3MQLxEZj",{},[2855],{"_37":248,"_68":2856,"_71":2857,"_43":2858,"_49":48},[250],[252],{},{"_33":2860,"_35":2861},[],{"_37":38,"_39":2862,"_41":42,"_43":2863,"_45":2864,"_47":2865,"_49":48},"wLvH-0eu",{},[],"A build script reads the YAML and produces valid SKOS Turtle. The generated output for the above YAML:",{"_33":2867,"_35":2868},[],{"_37":248,"_39":2869,"_41":42,"_43":2870,"_45":2871,"_47":2872,"_49":48},"nQboazRz",{"_2279":47},[],"@prefix hm: .\n@prefix skos: .\n@prefix dcterms: .\n\n# Concept Scheme (the vocabulary itself)\nhm:BlockTypes a skos:ConceptScheme ;\n skos:prefLabel \"Hypermedia Block Types\"@en ;\n skos:prefLabel \"Types de blocs Hypermedia\"@fr ;\n dcterms:description \"Taxonomy of content block types in Seed Hypermedia\"@en .\n\n# Top concepts\nhm:Block a skos:Concept ;\n skos:inScheme hm:BlockTypes ;\n skos:topConceptOf hm:BlockTypes ;\n skos:prefLabel \"Block\"@en ;\n skos:prefLabel \"Bloc\"@fr ;\n skos:definition \"Base concept for all content blocks\"@en .\n\n# Specific concepts\nhm:ParagraphBlock a skos:Concept ;\n skos:inScheme hm:BlockTypes ;\n skos:broader hm:Block ;\n skos:prefLabel \"Paragraph Block\"@en ;\n skos:prefLabel \"Bloc Paragraphe\"@fr ;\n skos:altLabel \"Text Block\"@en ;\n skos:definition \"Block containing plain or rich text content\"@en ;\n skos:example \"A paragraph of text with optional formatting\"@en .\n\nhm:ImageBlock a skos:Concept ;\n skos:inScheme hm:BlockTypes ;\n skos:broader hm:Block ;\n skos:prefLabel \"Image Block\"@en ;\n skos:prefLabel \"Bloc Image\"@fr ;\n skos:definition \"Block containing an image (IPFS CID or HTTP URL)\"@en ;\n skos:scopeNote \"Supports PNG, JPEG, GIF, WebP, SVG formats\"@en .\n\nhm:MediaBlock a skos:Concept ;\n skos:inScheme hm:BlockTypes ;\n skos:broader hm:Block ;\n skos:prefLabel \"Media Block\"@en ;\n skos:prefLabel \"Bloc Média\"@fr ;\n skos:definition \"Block containing media content\"@en .\n\nhm:VideoBlock a skos:Concept ;\n skos:inScheme hm:BlockTypes ;\n skos:broader hm:MediaBlock ;\n skos:prefLabel \"Video Block\"@en .\n\nhm:AudioBlock a skos:Concept ;\n skos:inScheme hm:BlockTypes ;\n skos:broader hm:MediaBlock ;\n skos:prefLabel \"Audio Block\"@en .",{"_33":2874,"_35":2875},[],{"_37":53,"_39":2876,"_41":42,"_43":2877,"_45":2878,"_47":2879,"_49":48},"DGE0vm_7",{},[],"2.2.3 Why SKOS — The 80/20 Solution for RDF",{"_33":2881,"_35":2882},[],{"_37":38,"_39":2883,"_41":42,"_43":2884,"_45":2885,"_47":2886,"_49":48},"thEr23lC",{},[],"SKOS (Simple Knowledge Organization System) is the simplest W3C semantic standard. It provides 80% of RDF benefits with 20% of the complexity.",{"_33":2888,"_35":2889},[],{"_37":38,"_39":2890,"_41":42,"_43":2891,"_45":2892,"_47":2904,"_49":48},"QKY7UFrq",{},[2893,2897],{"_37":1156,"_68":2894,"_71":2895,"_43":2896,"_49":48},[1158],[1238],{},{"_37":248,"_68":2898,"_71":2900,"_43":2903,"_49":48},[2899,1977],57,[2901,2902],69,102,{},"Weak semantics, strong flexibility. SKOS properties like skos:broader (more general) and skos:narrower (more specific) create hierarchies without rigid formal constraints. The semantics are intentionally weak — they express that one concept is \"somehow more general\" than another, without being overly strict about the exact nature of the hierarchical relationship. A concept can have any number of broader concepts — poly-hierarchies are explicitly allowed. This matches how real-world terminology and block type taxonomies evolve organically in decentralized communities.",{"_33":2906,"_35":2907},[],{"_37":38,"_39":2908,"_41":42,"_43":2909,"_45":2910,"_47":2923,"_49":48},"hKe54d_9",{},[2911,2915],{"_37":1156,"_68":2912,"_71":2913,"_43":2914,"_49":48},[1158],[2899],{},{"_37":248,"_68":2916,"_71":2919,"_43":2922,"_49":48},[2917,2918],318,337,[2920,2921],335,354,{},"Self-describing categories for decentralized cooperation. Each concept carries its own labels, definitions, and relationships. No central terminology registry required. Community can publish SKOS concept schemes independently. Relationships discoverable through graph traversal. Multiple languages supported natively (skos:prefLabel@en, skos:prefLabel@fr).",{"_33":2925,"_35":2961},[2926,2933,2940,2947,2954],{"_33":2927,"_35":2928},[],{"_37":38,"_39":2929,"_41":42,"_43":2930,"_45":2931,"_47":2932,"_49":48},"CdAlraBF",{},[],"Library of Congress Subject Headings (~400K concepts)",{"_33":2934,"_35":2935},[],{"_37":38,"_39":2936,"_41":42,"_43":2937,"_45":2938,"_47":2939,"_49":48},"jZwhAH4A",{},[],"Getty Art & Architecture Thesaurus (~370K concepts)",{"_33":2941,"_35":2942},[],{"_37":38,"_39":2943,"_41":42,"_43":2944,"_45":2945,"_47":2946,"_49":48},"P-1kf-it",{},[],"EU Vocabularies (EUROVOC: ~7K concepts, 24 languages)",{"_33":2948,"_35":2949},[],{"_37":38,"_39":2950,"_41":42,"_43":2951,"_45":2952,"_47":2953,"_49":48},"YB3bG6J5",{},[],"AGROVOC (FAO): ~40K agricultural concepts, 40 languages",{"_33":2955,"_35":2956},[],{"_37":38,"_39":2957,"_41":42,"_43":2958,"_45":2959,"_47":2960,"_49":48},"nx3W_GQL",{},[],"Wikidata uses SKOS for category hierarchies",{"_37":38,"_39":2962,"_41":42,"_43":2963,"_45":2964,"_47":2969,"_49":48},"sNjd2g-1",{"_100":101},[2965],{"_37":1156,"_68":2966,"_71":2967,"_43":2968,"_49":48},[1158],[591],{},"Proven at massive scale. SKOS is battle-tested in production systems managing billions of concepts:",{"_33":2971,"_35":2972},[],{"_37":38,"_39":2973,"_41":42,"_43":2974,"_45":2975,"_47":2976,"_49":48},"KVYRWaR8",{},[],"If it works for the Library of Congress, it will work for Hypermedia block types.",{"_33":2978,"_35":2979},[],{"_37":38,"_39":2980,"_41":42,"_43":2981,"_45":2982,"_47":2987,"_49":48},"-uMKUYhh",{},[2983],{"_37":1156,"_68":2984,"_71":2985,"_43":2986,"_49":48},[1158],[337],{},"Natural fit for block type taxonomy. The block type hierarchy maps perfectly to SKOS:",{"_33":2989,"_35":2990},[],{"_37":248,"_39":2991,"_41":42,"_43":2992,"_45":2993,"_47":2994,"_49":48},"d4Y-lmI_",{"_2279":2280},[],"Block (skos:ConceptScheme)\n├── TextBlock (skos:Concept)\n│ ├── ParagraphBlock (skos:narrower)\n│ │ └── RichParagraphBlock (skos:narrower)\n│ └── HeadingBlock (skos:narrower)\n├── MediaBlock (skos:Concept)\n│ ├── ImageBlock (skos:narrower)\n│ ├── VideoBlock (skos:narrower)\n│ └── AudioBlock (skos:narrower)\n└── InteractiveBlock (skos:Concept)\n ├── CommentBlock (skos:narrower)\n └── PollBlock (skos:narrower)",{"_33":2996,"_35":2997},[],{"_37":38,"_39":2998,"_41":42,"_43":2999,"_45":3000,"_47":3007,"_49":48},"_haAQbsJ",{},[3001],{"_37":248,"_68":3002,"_71":3003,"_43":3006,"_49":48},[593,308],[3004,3005],46,74,{},"Community extensions just add new skos:Concept instances with skos:broader relationships. No permission needed, no schema updates, no breaking changes.",{"_33":3009,"_35":3010},[],{"_37":38,"_39":3011,"_41":42,"_43":3012,"_45":3013,"_47":3018,"_49":48},"0lKJRN-D",{},[3014],{"_37":1156,"_68":3015,"_71":3016,"_43":3017,"_49":48},[1158],[515],{},"Poly-hierarchy example for community extensions:",{"_33":3020,"_35":3021},[],{"_37":248,"_39":3022,"_41":42,"_43":3023,"_45":3024,"_47":3025,"_49":48},"Y7_HmfQ8",{"_2279":47},[],"# Base concept (core team defines)\nhm:MediaBlock a skos:Concept ;\n skos:prefLabel \"Media Block\"@en ;\n skos:definition \"Block containing media content\"@en .\n\n# Community extension (poly-hierarchy)\ncommunity:InteractiveVideo a skos:Concept ;\n skos:broader hm:MediaBlock ; # It's a media block\n skos:broader community:InteractiveContent ; # AND interactive content\n skos:prefLabel \"Interactive Video\"@en ;\n skos:altLabel \"Clickable Video\"@en ;\n skos:related community:HotspotTechnology .",{"_33":3027,"_35":3028},[],{"_37":38,"_39":3029,"_41":42,"_43":3030,"_45":3031,"_47":3032,"_49":48},"FkK1fWVJ",{},[],"No single inheritance restriction. No need for complex class modeling. Just navigable relationships.",{"_33":3034,"_35":3035},[],{"_37":53,"_39":3036,"_41":42,"_43":3037,"_45":3038,"_47":3039,"_49":48},"VM-AmP9Y",{},[],"2.2.4 SKOS-XL for Rich Label Management",{"_33":3041,"_35":3042},[],{"_37":38,"_39":3043,"_41":42,"_43":3044,"_45":3045,"_47":3046,"_49":48},"Skzz0M51",{},[],"When you need multilingual support, historical label variants, versioned terminology, or label provenance, SKOS-XL extends SKOS with reified labels (labels as first-class entities):",{"_33":3048,"_35":3049},[],{"_37":248,"_39":3050,"_41":42,"_43":3051,"_45":3052,"_47":3053,"_49":48},"brIbKvJy",{"_2279":47},[],"# Standard SKOS (labels as literals)\nhm:ImageBlock skos:prefLabel \"Image Block\"@en .\n\n# SKOS-XL (labels as resources)\nhm:ImageBlock skosxl:prefLabel [\n a skosxl:Label ;\n skosxl:literalForm \"Image Block\"@en ;\n dcterms:created \"2024-01-15\"^^xsd:date ;\n dcterms:creator ;\n skosxl:labelRelation [\n skosxl:literalForm \"Picture Block\"@en ;\n rdfs:comment \"Deprecated term, use 'Image Block'\"\n ]\n] .",{"_33":3055,"_35":3056},[],{"_37":38,"_39":3057,"_41":42,"_43":3058,"_45":3059,"_47":3060,"_49":48},"w3zAgiMe",{},[],"This enables sophisticated terminology management — tracking that \"Paragraph Block\" was renamed to \"Text Block\" and then to \"RichText Block\" — without complex ontology machinery. Deploy SKOS-XL only when the label management use case is concrete, not speculatively.",{"_33":3062,"_35":3063},[],{"_37":53,"_39":3064,"_41":42,"_43":3065,"_45":3066,"_47":3067,"_49":48},"X7OkAz2O",{},[],"2.2.5 Future-Proof Evolution Path",{"_33":3069,"_35":3070},[],{"_37":38,"_39":3071,"_41":42,"_43":3072,"_45":3073,"_47":3074,"_49":48},"oMBUu9R9",{},[],"SKOS → RDFS → OWL is a well-trodden upgrade path:",{"_33":3076,"_35":3077},[],{"_37":38,"_39":3078,"_41":42,"_43":3079,"_45":3080,"_47":3085,"_49":48},"nsPUeckW",{},[3081],{"_37":1156,"_68":3082,"_71":3083,"_43":3084,"_49":48},[1158],[1250],{},"Stage 1 (Now): SKOS concepts with weak hierarchies. Simple, flexible, decentralized. Community can extend freely.",{"_33":3087,"_35":3088},[],{"_37":38,"_39":3089,"_41":42,"_43":3090,"_45":3091,"_47":3100,"_49":48},"Pa7dYJA0",{},[3092,3096],{"_37":1156,"_68":3093,"_71":3094,"_43":3095,"_49":48},[1158],[250],{},{"_37":248,"_68":3097,"_71":3098,"_43":3099,"_49":48},[3005],[1486],{},"Stage 2 (If needed): Add RDFS properties. Define formal properties (e.g., hm:hasAuthor). Still compatible with SKOS.",{"_33":3102,"_35":3103},[],{"_37":38,"_39":3104,"_41":42,"_43":3105,"_45":3106,"_47":3111,"_49":48},"sxjH25VM",{},[3107],{"_37":1156,"_68":3108,"_71":3109,"_43":3110,"_49":48},[1158],[250],{},"Stage 3 (If needed): Upgrade to OWL. Add stricter constraints. Enable reasoning (if justified by use case).",{"_33":3113,"_35":3114},[],{"_37":38,"_39":3115,"_41":42,"_43":3116,"_45":3117,"_47":3118,"_49":48},"8sl8T9w6",{},[],"You are not locked in. SKOS is the safe starting point that does not close doors. Each escalation is documented via an Architecture Decision Record.",{"_33":3120,"_35":3121},[],{"_37":38,"_39":3122,"_41":42,"_43":3123,"_45":3124,"_47":3125,"_49":48},"mDYpNJTa",{},[],"CriterionSKOS AdvantageComplexitySimplest RDF standard, ~10 properties totalFlexibilityPoly-hierarchies, weak semanticsDecentralizationSelf-describing, no central registryScaleProven with billions of conceptsToolingExcellent support (rdflib, SPARQL Anything)Future-proofEasy upgrade path to RDFS/OWL",{"_33":3127,"_35":3128},[],{"_37":53,"_39":3129,"_41":42,"_43":3130,"_45":3131,"_47":3132,"_49":48},"GnoS6kys",{},[],"2.2.6 Publication as a Standalone Open Artifact",{"_33":3134,"_35":3135},[],{"_37":38,"_39":3136,"_41":42,"_43":3137,"_45":3138,"_47":3139,"_49":48},"BUOws4Dr",{},[],"The vocabulary is published as its own IPFS CID, independent of any document's access level. This is a non-negotiable architectural constraint. The vocabulary is the shared language — block types, property definitions, concept hierarchies. If the vocabulary is gated, no third-party developer can build compatible extensions without prior access. Open vocabulary, controlled content.",{"_33":3141,"_35":3142},[],{"_37":53,"_39":3143,"_41":42,"_43":3144,"_45":3145,"_47":3146,"_49":48},"KhnxBui-",{},[],"2.3 Embedded JSON-LD Context",{"_33":3148,"_35":3149},[],{"_37":53,"_39":3150,"_41":42,"_43":3151,"_45":3152,"_47":3153,"_49":48},"tODkz7Bm",{},[],"2.3.1 Dual Context: JSON-LD for Web, CBOR for Backend",{"_33":3155,"_35":3156},[],{"_37":38,"_39":3157,"_41":42,"_43":3158,"_45":3159,"_47":3160,"_49":48},"XyPTf1_o",{},[],"Two representations of the same context, generated from the same YAML source:",{"_33":3162,"_35":3163},[],{"_37":38,"_39":3164,"_41":42,"_43":3165,"_45":3166,"_47":3171,"_49":48},"TqjMzVwC",{},[3167],{"_37":1156,"_68":3168,"_71":3169,"_43":3170,"_49":48},[1158],[1759],{},"JSON-LD context for web consumers, TypeScript, documentation, and external interoperability:",{"_33":3173,"_35":3174},[],{"_37":248,"_39":3175,"_41":42,"_43":3176,"_45":3177,"_47":3178,"_49":48},"6INPpfPX",{"_2279":20},[],"{\n \"@context\": {\n \"hm\": \"https://hypermedia.foundation/ns/core#\",\n \"skos\": \"http://www.w3.org/2004/02/skos/core#\",\n \"dct\": \"http://purl.org/dc/terms/\",\n \"dcat\": \"http://www.w3.org/ns/dcat#\",\n \"@type\": \"hm:blockType\",\n \"text\": \"hm:text\",\n \"imageUrl\": \"hm:imageUrl\",\n \"altText\": \"hm:altText\",\n \"blocks\": {\n \"@id\": \"hm:hasBlock\",\n \"@container\": \"@list\"\n }\n }\n}",{"_33":3180,"_35":3181},[],{"_37":38,"_39":3182,"_41":42,"_43":3183,"_45":3184,"_47":3189,"_49":48},"CgSgtJEm",{},[3185],{"_37":1156,"_68":3186,"_71":3187,"_43":3188,"_49":48},[1158],[1467],{},"CBOR context for the Go backend and IPFS storage, using integer vocabulary codes for dramatic size reduction:",{"_33":3191,"_35":3192},[],{"_37":248,"_39":3193,"_41":42,"_43":3194,"_45":3195,"_47":3196,"_49":48},"mv8PxcRU",{"_2279":2280},[],"CBOR Prefix Table:\n 1 → \"https://hypermedia.foundation/ns/core#\"\n 2 → \"http://www.w3.org/2004/02/skos/core#\"\n 3 → \"http://purl.org/dc/terms/\"\n 4 → \"http://www.w3.org/ns/dcat#\"\n\nField codes:\n 10 → blockType\n 11 → text\n 12 → imageUrl\n 13 → altText\n 14 → hasBlock",{"_33":3198,"_35":3199},[],{"_37":38,"_39":3200,"_41":42,"_43":3201,"_45":3202,"_47":3203,"_49":48},"lGYzMJUp",{},[],"Same semantics, different wire formats. The JSON-LD context and the CBOR prefix table are both generated from the canonical YAML.",{"_33":3205,"_35":3206},[],{"_37":53,"_39":3207,"_41":42,"_43":3208,"_45":3209,"_47":3210,"_49":48},"3SfWnsUS",{},[],"2.3.2 Mapping Existing Short Keys to Qualified URIs",{"_33":3212,"_35":3213},[],{"_37":38,"_39":3214,"_41":42,"_43":3215,"_45":3216,"_47":3225,"_49":48},"gdFqMH7n",{},[3217],{"_37":248,"_68":3218,"_71":3221,"_43":3224,"_49":48},[1972,1973,3219,3220],88,188,[1976,1486,3222,3223],93,196,{},"The critical design constraint: existing CBOR data uses short keys like \"type\", \"text\", \"url\". These must map cleanly to qualified URIs without breaking any existing consumer. The JSON-LD @context is precisely this mapping:",{"_33":3227,"_35":3228},[],{"_37":248,"_39":3229,"_41":42,"_43":3230,"_45":3231,"_47":3232,"_49":48},"KNDX3zDm",{"_2279":20},[],"{\n \"@context\": {\n \"type\": \"@type\",\n \"text\": \"hm:text\",\n \"url\": \"hm:imageUrl\",\n \"alt\": \"hm:altText\"\n }\n}",{"_33":3234,"_35":3235},[],{"_37":38,"_39":3236,"_41":42,"_43":3237,"_45":3238,"_47":3239,"_49":48},"jkPJQckc",{},[],"Existing JSON remains valid JSON-LD. A tool that understands JSON-LD can expand the short keys to full URIs. A tool that does not understand JSON-LD still reads the same JSON it always did. Zero breakage.",{"_33":3241,"_35":3242},[],{"_37":53,"_39":3243,"_41":42,"_43":3244,"_45":3245,"_47":3246,"_49":48},"h_bKqtm4",{},[],"2.3.3 Context Embedded Statically — Never Resolved Over HTTP at Runtime",{"_33":3248,"_35":3249},[],{"_37":38,"_39":3250,"_41":42,"_43":3251,"_45":3252,"_47":3259,"_49":48},"pOQHLw8X",{},[3253],{"_37":248,"_68":3254,"_71":3256,"_43":3258,"_49":48},[3255],96,[3257],104,{},"This is a critical performance and reliability constraint. JSON-LD libraries, by default, fetch @context URLs over HTTP at runtime. This is slow, unreliable, and unnecessary for our use case. The context is a static artifact. It ships with the document, embedded in the IPFS payload. It ships with the npm package, imported as a local JSON file. It is never fetched over the network.",{"_33":3261,"_35":3262},[],{"_37":38,"_39":3263,"_41":42,"_43":3264,"_45":3265,"_47":3266,"_49":48},"ctb6hHj-",{},[],"IPFS content-addressing makes this even more natural: the context has its own CID. It is immutable. It is the perfect cache candidate — CID = cache key, cache never invalidated.",{"_33":3268,"_35":3269},[],{"_37":53,"_39":3270,"_41":42,"_43":3271,"_45":3272,"_47":3273,"_49":48},"iT0k4Dxa",{},[],"2.4 Auto-Generated Documentation",{"_33":3275,"_35":3276},[],{"_37":53,"_39":3277,"_41":42,"_43":3278,"_45":3279,"_47":3280,"_49":48},"Zcfc8gdg",{},[],"2.4.1 pyLODE Pipeline",{"_33":3282,"_35":3333},[3283,3301,3317],{"_33":3284,"_35":3285},[],{"_37":38,"_39":3286,"_41":42,"_43":3287,"_45":3288,"_47":3300,"_49":48},"1wZb09JU",{},[3289,3294],{"_37":1156,"_68":3290,"_71":3291,"_43":3293,"_49":48},[1158],[3292],7,{},{"_37":424,"_68":3295,"_71":3297,"_43":3298,"_49":3299},[3296],8,[1285],{},"https://github.com/RDFLib/pyLODE","GitHub: https://github.com/RDFLib/pyLODE",{"_33":3302,"_35":3303},[],{"_37":38,"_39":3304,"_41":42,"_43":3305,"_45":3306,"_47":3316,"_49":48},"nMcionMs",{},[3307,3311],{"_37":1156,"_68":3308,"_71":3309,"_43":3310,"_49":48},[1158],[2398],{},{"_37":248,"_68":3312,"_71":3313,"_43":3315,"_49":48},[1250],[3314],32,{},"Installation: pip install pylode",{"_33":3318,"_35":3319},[],{"_37":38,"_39":3320,"_41":42,"_43":3321,"_45":3322,"_47":3332,"_49":48},"PjAGrRdF",{},[3323,3327],{"_37":1156,"_68":3324,"_71":3325,"_43":3326,"_49":48},[1158],[973],{},{"_37":248,"_68":3328,"_71":3329,"_43":3331,"_49":48},[3292],[3330],49,{},"Usage: pylode core-skos.ttl -o documentation.html",{"_37":38,"_39":3334,"_41":42,"_43":3335,"_45":3336,"_47":3337,"_49":48},"cdG7rqnd",{"_100":101},[],"pyLODE is the recommended tool for Phase 1 documentation. It generates clean HTML documentation from RDF ontologies with zero configuration.",{"_33":3339,"_35":3375},[3340,3347,3354,3361,3368],{"_33":3341,"_35":3342},[],{"_37":38,"_39":3343,"_41":42,"_43":3344,"_45":3345,"_47":3346,"_49":48},"sb_MYW3m",{},[],"Class hierarchy with visual diagrams",{"_33":3348,"_35":3349},[],{"_37":38,"_39":3350,"_41":42,"_43":3351,"_45":3352,"_47":3353,"_49":48},"iEDx8Lg0",{},[],"Property tables with domain/range",{"_33":3355,"_35":3356},[],{"_37":38,"_39":3357,"_41":42,"_43":3358,"_45":3359,"_47":3360,"_49":48},"7nzhBRoK",{},[],"Examples embedded inline",{"_33":3362,"_35":3363},[],{"_37":38,"_39":3364,"_41":42,"_43":3365,"_45":3366,"_47":3367,"_49":48},"3eOyH_M7",{},[],"Cross-references between concepts",{"_33":3369,"_35":3370},[],{"_37":38,"_39":3371,"_41":42,"_43":3372,"_45":3373,"_47":3374,"_49":48},"PMTzLw1C",{},[],"Multi-language support (labels in all languages)",{"_37":38,"_39":3376,"_41":42,"_43":3377,"_45":3378,"_47":3383,"_49":48},"PWRREJ8l",{"_100":101},[3379],{"_37":1156,"_68":3380,"_71":3381,"_43":3382,"_49":48},[1158],[1796],{},"What it generates:",{"_33":3385,"_35":3386},[],{"_37":38,"_39":3387,"_41":42,"_43":3388,"_45":3389,"_47":3395,"_49":48},"IIgmzTp6",{},[3390],{"_37":1156,"_68":3391,"_71":3392,"_43":3394,"_49":48},[1158],[3393],17,{},"Output structure:",{"_33":3397,"_35":3398},[],{"_37":248,"_39":3399,"_41":42,"_43":3400,"_45":3401,"_47":3402,"_49":48},"FjiXmCx0",{"_2279":2280},[],"documentation.html\n├── Metadata (title, version, authors)\n├── Table of Contents\n├── Classes\n│ ├── Block (with properties)\n│ ├── ImageBlock (with inheritance)\n│ └── ParagraphBlock\n├── Properties\n│ ├── creator (with domain/range)\n│ └── text\n└── Examples",{"_33":3404,"_35":3405},[],{"_37":38,"_39":3406,"_41":42,"_43":3407,"_45":3408,"_47":3413,"_49":48},"eWEGGFob",{},[3409],{"_37":1156,"_68":3410,"_71":3411,"_43":3412,"_49":48},[1158],[426],{},"Characteristics: Zero configuration, works out-of-box. Pure Python, no Java dependencies. Fast generation (<1 second for typical ontology). Works with SKOS, RDFS, OWL. Used by Australian Government, CSIRO, EU projects.",{"_33":3415,"_35":3416},[],{"_37":38,"_39":3417,"_41":42,"_43":3418,"_45":3419,"_47":3424,"_49":48},"FnxvL1Vc",{},[3420],{"_37":1156,"_68":3421,"_71":3422,"_43":3423,"_49":48},[1158],[1771],{},"Limitation: Single-page output (can be large for huge ontologies). Limited customization of styling. Best for quick documentation of small-to-medium vocabularies (5–100 concepts).",{"_33":3426,"_35":3427},[],{"_37":53,"_39":3428,"_41":42,"_43":3429,"_45":3430,"_47":3431,"_49":48},"LfkkIvxS",{},[],"2.4.2 Upgrade Path: Widoco",{"_33":3433,"_35":3481},[3434,3450,3465],{"_33":3435,"_35":3436},[],{"_37":38,"_39":3437,"_41":42,"_43":3438,"_45":3439,"_47":3449,"_49":48},"Vo9o4YHu",{},[3440,3444],{"_37":1156,"_68":3441,"_71":3442,"_43":3443,"_49":48},[1158],[3292],{},{"_37":424,"_68":3445,"_71":3446,"_43":3447,"_49":3448},[3296],[1492],{},"https://github.com/dgarijo/Widoco","GitHub: https://github.com/dgarijo/Widoco",{"_33":3451,"_35":3452},[],{"_37":38,"_39":3453,"_41":42,"_43":3454,"_45":3455,"_47":3464,"_49":48},"Wlai5k8K",{},[3456,3460],{"_37":1156,"_68":3457,"_71":3458,"_43":3459,"_49":48},[1158],[2398],{},{"_37":248,"_68":3461,"_71":3462,"_43":3463,"_49":48},[1422],[515],{},"Installation: Docker: docker pull dgarijo/widoco",{"_33":3466,"_35":3467},[],{"_37":38,"_39":3468,"_41":42,"_43":3469,"_45":3470,"_47":3480,"_49":48},"yauVVTgW",{},[3471,3475],{"_37":1156,"_68":3472,"_71":3473,"_43":3474,"_49":48},[1158],[973],{},{"_37":248,"_68":3476,"_71":3477,"_43":3479,"_49":48},[3292],[3478],66,{},"Usage: java -jar widoco.jar -ontFile ontology.ttl -outFolder docs/",{"_37":38,"_39":3482,"_41":42,"_43":3483,"_45":3484,"_47":3485,"_49":48},"E7j5ge9c",{"_100":101},[],"When the vocabulary grows beyond ~50 concepts or professional multi-page documentation is needed:",{"_33":3487,"_35":3488},[],{"_37":38,"_39":3489,"_41":42,"_43":3490,"_45":3491,"_47":3496,"_49":48},"9KoElS4I",{},[3492],{"_37":1156,"_68":3493,"_71":3494,"_43":3495,"_49":48},[1158],[1796],{},"What it generates: Multi-page website (index, classes, properties, examples). Visual diagrams (WebVOWL integration). Metadata sections (authors, license, versioning). Provenance tracking (who created what, when). Evaluation reports (ontology quality metrics). Used by W3C Community Groups, EU Horizon projects.",{"_33":3498,"_35":3499},[],{"_37":248,"_39":3500,"_41":42,"_43":3501,"_45":3503,"_47":3504,"_49":48},"xaG7GRX4",{"_2279":3502},"bash",[],"docker run -v $(pwd):/data dgarijo/widoco \\\n -ontFile /data/core-skos.ttl \\\n -outFolder /data/docs \\\n -includeAnnotationProperties \\\n -webVowl",{"_33":3506,"_35":3507},[],{"_37":53,"_39":3508,"_41":42,"_43":3509,"_45":3510,"_47":3511,"_49":48},"RV10AyKL",{},[],"2.4.3 Exploration Tool: Ontospy",{"_33":3513,"_35":3560},[3514,3530,3545],{"_33":3515,"_35":3516},[],{"_37":38,"_39":3517,"_41":42,"_43":3518,"_45":3519,"_47":3529,"_49":48},"2WD4T1b-",{},[3520,3524],{"_37":1156,"_68":3521,"_71":3522,"_43":3523,"_49":48},[1158],[3292],{},{"_37":424,"_68":3525,"_71":3526,"_43":3527,"_49":3528},[3296],[3004],{},"https://github.com/lambdamusic/Ontospy","GitHub: https://github.com/lambdamusic/Ontospy",{"_33":3531,"_35":3532},[],{"_37":38,"_39":3533,"_41":42,"_43":3534,"_45":3535,"_47":3544,"_49":48},"2e53BvCa",{},[3536,3540],{"_37":1156,"_68":3537,"_71":3538,"_43":3539,"_49":48},[1158],[2398],{},{"_37":248,"_68":3541,"_71":3542,"_43":3543,"_49":48},[1250],[252],{},"Installation: pip install ontospy",{"_33":3546,"_35":3547},[],{"_37":38,"_39":3548,"_41":42,"_43":3549,"_45":3550,"_47":3559,"_49":48},"NMRLIjHe",{},[3551,3555],{"_37":1156,"_68":3552,"_71":3553,"_43":3554,"_49":48},[1158],[973],{},{"_37":248,"_68":3556,"_71":3557,"_43":3558,"_49":48},[3292],[2439],{},"Usage: ontospy scan ontology.ttl --viz",{"_37":38,"_39":3561,"_41":42,"_43":3562,"_45":3563,"_47":3564,"_49":48},"8KRd2ci0",{"_100":101},[],"For internal development and ontology exploration:",{"_33":3566,"_35":3567},[],{"_37":38,"_39":3568,"_41":42,"_43":3569,"_45":3570,"_47":3576,"_49":48},"aZ5uD-Zp",{},[3571],{"_37":1156,"_68":3572,"_71":3573,"_43":3575,"_49":48},[1158],[3574],9,{},"Features: Searchable class/property listings. Graph visualizations (D3.js interactive). Statistics dashboard (class count, property usage). Export to various formats (CSV, JSON). Great for exploring third-party ontologies during alignment work.",{"_33":3578,"_35":3579},[],{"_37":248,"_39":3580,"_41":42,"_43":3581,"_45":3583,"_47":3584,"_49":48},"26BCzmoW",{"_2279":3582},"python",[],"from ontospy import Ontospy\n\nmodel = Ontospy(\"core-skos.ttl\")\nfor cls in model.all_classes:\n print(f\"{cls.label}: {len(cls.descendants())} subclasses\")\nmodel.export_visualization(\"docs/\")",{"_33":3586,"_35":3587},[],{"_37":53,"_39":3588,"_41":42,"_43":3589,"_45":3590,"_47":3591,"_49":48},"aC1Xteww",{},[],"2.4.4 CI Integration: Auto-Generation on Every Commit",{"_33":3593,"_35":3594},[],{"_37":38,"_39":3595,"_41":42,"_43":3596,"_45":3597,"_47":3598,"_49":48},"wctfe1Ha",{},[],"Documentation always in sync with vocabulary. Zero manual maintenance.",{"_33":3600,"_35":3601},[],{"_37":248,"_39":3602,"_41":42,"_43":3603,"_45":3604,"_47":3605,"_49":48},"SVBqx8G8",{"_2279":2846},[],"# .github/workflows/docs.yml\nname: Generate Documentation\n\non:\n push:\n paths:\n - 'vocabulary/*.ttl'\n - 'src/block-types.yaml'\n\njobs:\n generate-docs:\n runs-on: ubuntu-latest\n steps:\n - uses: actions/checkout@v2\n\n - name: Install pyLODE\n run: pip install pylode\n\n - name: Generate Documentation\n run: pylode vocabulary/core-skos.ttl -o docs/index.html\n\n - name: Deploy to GitHub Pages\n uses: peaceiris/actions-gh-pages@v3\n with:\n github_token: ${{ secrets.GITHUB_TOKEN }}\n publish_dir: ./docs",{"_33":3607,"_35":3608},[],{"_37":53,"_39":3609,"_41":42,"_43":3610,"_45":3611,"_47":3612,"_49":48},"9CBAMEfU",{},[],"2.4.5 Collaborative Editing (Future): VoCol",{"_33":3614,"_35":3654},[3615,3631,3642],{"_33":3616,"_35":3617},[],{"_37":38,"_39":3618,"_41":42,"_43":3619,"_45":3620,"_47":3630,"_49":48},"mxjCcPpb",{},[3621,3625],{"_37":1156,"_68":3622,"_71":3623,"_43":3624,"_49":48},[1158],[3292],{},{"_37":424,"_68":3626,"_71":3627,"_43":3628,"_49":3629},[3296],[2439],{},"https://github.com/vocol/vocol","GitHub: https://github.com/vocol/vocol",{"_33":3632,"_35":3633},[],{"_37":38,"_39":3634,"_41":42,"_43":3635,"_45":3636,"_47":3641,"_49":48},"5LRcbcUn",{},[3637],{"_37":1156,"_68":3638,"_71":3639,"_43":3640,"_49":48},[1158],[3574],{},"Features: Web-based editor for non-technical contributors. Git version control integrated. Documentation generation built-in. Change tracking and approval workflows.",{"_33":3643,"_35":3644},[],{"_37":38,"_39":3645,"_41":42,"_43":3646,"_45":3647,"_47":3653,"_49":48},"hV_llXym",{},[3648],{"_37":1156,"_68":3649,"_71":3650,"_43":3652,"_49":48},[1158],[3651],10,{},"Trade-off: Complex setup (full web application). Overkill for small teams. Deploy only when the contributor base justifies it.",{"_37":38,"_39":3655,"_41":42,"_43":3656,"_45":3657,"_47":3658,"_49":48},"hz3SEfVc",{"_100":101},[],"If the vocabulary becomes community-driven with 10+ contributors:",{"_33":3660,"_35":3661},[],{"_37":38,"_39":3662,"_41":42,"_43":3663,"_45":3664,"_47":3672,"_49":48},"jXcUAlme",{},[3665],{"_37":1156,"_68":3666,"_71":3669,"_43":3671,"_49":48},[252,1486,3667,3668],133,180,[335,1539,3670,1402],140,{},"ToolComplexityBest Use CaseOutputpyLODELowQuick docs for small vocabulariesSingle HTMLWidocoMediumProfessional multi-page siteWebsiteOntospyMediumInteractive explorationHTML + JSONVoColHighCommunity collaborationWeb app",{"_33":3674,"_35":3675},[],{"_37":53,"_39":3676,"_41":42,"_43":3677,"_45":3678,"_47":3679,"_49":48},"Fx3LuqOx",{},[],"2.5 Week 2 Deliverables",{"_33":3681,"_35":3682},[],{"_37":38,"_39":3683,"_41":42,"_43":3684,"_45":3685,"_47":3686,"_49":48},"CzxRWR7D",{},[],"Target file structure:",{"_33":3688,"_35":3689},[],{"_37":248,"_39":3690,"_41":42,"_43":3691,"_45":3692,"_47":3693,"_49":48},"WnCYS30K",{"_2279":2280},[],"hypermedia-vocab/\n├── src/\n│ └── block-types.yaml # Canonical source\n├── generated/\n│ ├── core-skos.ttl # SKOS Turtle\n│ ├── context.jsonld # JSON-LD context\n│ ├── context.cbor # CBOR context (integer prefixes)\n│ └── types.ts # Generated TypeScript types\n├── docs/\n│ └── index.html # pyLODE documentation\n├── examples/\n│ ├── basic-document.jsonld\n│ └── basic-document.cbor\n└── scripts/\n └── generate.py # YAML → all artifacts",{"_33":3695,"_35":3696},[],{"_37":53,"_39":3697,"_41":42,"_43":3698,"_45":3699,"_47":564,"_49":48},"rLrsttx4",{},[],{"_33":3701,"_35":3702},[],{"_37":53,"_39":3703,"_41":42,"_43":3704,"_45":3705,"_47":3710,"_49":48},"Bzt9vgls",{},[3706],{"_37":248,"_68":3707,"_71":3708,"_43":3709,"_49":48},[445],[250],{},"3.1 @seed/vocabulary npm Package",{"_33":3712,"_35":3713},[],{"_37":53,"_39":3714,"_41":42,"_43":3715,"_45":3716,"_47":3717,"_49":48},"trBoe550",{},[],"3.1.1 TypeScript Types Generated from the SKOS Vocabulary",{"_33":3719,"_35":3720},[],{"_37":38,"_39":3721,"_41":42,"_43":3722,"_45":3723,"_47":3724,"_49":48},"L_H5G74y",{},[],"The build pipeline reads the canonical YAML and generates TypeScript interfaces. These are not hand-maintained — they are derived artifacts, always in sync with the vocabulary.",{"_33":3726,"_35":3727},[],{"_37":248,"_39":3728,"_41":42,"_43":3729,"_45":3731,"_47":3732,"_49":48},"t9E4Eixj",{"_2279":3730},"typescript",[],"// types.ts (auto-generated from block-types.yaml)\nexport interface Block {\n '@context': 'https://hypermedia.foundation/ns/core';\n '@type': string;\n}\n\nexport interface ParagraphBlock extends Block {\n '@type': 'ParagraphBlock';\n text: string;\n}\n\nexport interface ImageBlock extends Block {\n '@type': 'ImageBlock';\n imageUrl: string;\n altText?: string;\n}\n\nexport interface VideoBlock extends Block {\n '@type': 'VideoBlock';\n videoUrl: string;\n duration?: number;\n}\n\nexport type AnyBlock = ParagraphBlock | ImageBlock | VideoBlock;",{"_33":3734,"_35":3735},[],{"_37":53,"_39":3736,"_41":42,"_43":3737,"_45":3738,"_47":3739,"_49":48},"Va_pwK4H",{},[],"3.1.2 JSON-LD Context Embedded as Static Import",{"_33":3741,"_35":3742},[],{"_37":38,"_39":3743,"_41":42,"_43":3744,"_45":3745,"_47":3746,"_49":48},"ZvlAUk9Z",{},[],"The context ships as a JSON file inside the npm package. Never fetched over HTTP.",{"_33":3748,"_35":3749},[],{"_37":248,"_39":3750,"_41":42,"_43":3751,"_45":3752,"_47":3753,"_49":48},"xKF6r7og",{"_2279":3730},[],"// Usage in application code\nimport HM_CONTEXT from '@seed/vocabulary/context.json';\nimport type { ImageBlock } from '@seed/vocabulary';\n\n// The context is a local file, bundled at build time\n// Zero network calls, zero runtime dependencies",{"_33":3755,"_35":3756},[],{"_37":53,"_39":3757,"_41":42,"_43":3758,"_45":3759,"_47":3760,"_49":48},"RrpnWMUC",{},[],"3.1.3 Lightweight Builders (~2KB)",{"_33":3762,"_35":3763},[],{"_37":38,"_39":3764,"_41":42,"_43":3765,"_45":3766,"_47":3767,"_49":48},"uZeDm-He",{},[],"Instead of importing a full JSON-LD library (~100KB+ minified), the package ships tiny, type-safe builder functions:",{"_33":3769,"_35":3770},[],{"_37":248,"_39":3771,"_41":42,"_43":3772,"_45":3773,"_47":3774,"_49":48},"9ic90MBR",{"_2279":3730},[],"// jsonld-builders.ts (~2KB total)\n\nexport function buildImageBlock(data: {\n imageUrl: string;\n altText?: string;\n}): string {\n return JSON.stringify({\n \"@context\": \"https://hypermedia.foundation/ns/core\",\n \"@type\": \"ImageBlock\",\n \"imageUrl\": data.imageUrl,\n \"altText\": data.altText\n });\n}\n\nexport function buildParagraphBlock(data: {\n text: string;\n}): string {\n return JSON.stringify({\n \"@context\": \"https://hypermedia.foundation/ns/core\",\n \"@type\": \"ParagraphBlock\",\n \"text\": data.text\n });\n}\n\n// Fluent alternative\nexport class JsonLdBuilder {\n private data: Record = {};\n\n context(url: string): this {\n this.data['@context'] = url;\n return this;\n }\n\n type(type: string): this {\n this.data['@type'] = type;\n return this;\n }\n\n prop(key: string, value: any): this {\n this.data[key] = value;\n return this;\n }\n\n build(): string {\n return JSON.stringify(this.data);\n }\n}",{"_33":3776,"_35":3777},[],{"_37":38,"_39":3778,"_41":42,"_43":3779,"_45":3780,"_47":3785,"_49":48},"hDSGBR2Z",{},[3781],{"_37":1156,"_68":3782,"_71":3783,"_43":3784,"_49":48},[1158],[1510],{},"Contrast with the heavy approach (do not do this):",{"_33":3787,"_35":3788},[],{"_37":248,"_39":3789,"_41":42,"_43":3790,"_45":3791,"_47":3792,"_49":48},"ThECBv6H",{"_2279":3730},[],"// BAD: 150KB+ for basic structured data\nimport jsonld from 'jsonld'; // ~100KB minified\nimport { schema } from 'jsonld-schema'; // More KB",{"_33":3794,"_35":3795},[],{"_37":53,"_39":3796,"_41":42,"_43":3797,"_45":3798,"_47":3803,"_49":48},"p-pLKu8X",{},[3799],{"_37":424,"_68":3800,"_71":3801,"_43":3802,"_49":430},[426],[428],{},"3.1.4 Type-Safe Schema.org Integration",{"_33":3805,"_35":3806},[],{"_37":38,"_39":3807,"_41":42,"_43":3808,"_45":3809,"_47":3818,"_49":48},"WT0mFx53",{},[3810,3814],{"_37":424,"_68":3811,"_71":3812,"_43":3813,"_49":430},[2157],[2439],{},{"_37":248,"_68":3815,"_71":3816,"_43":3817,"_49":48},[1597],[1977],{},"For block types that map to Schema.org (Article, ImageObject, Person), use the schema-dts package — zero runtime cost, just TypeScript type definitions:",{"_33":3820,"_35":3821},[],{"_37":248,"_39":3822,"_41":42,"_43":3823,"_45":3824,"_47":3825,"_49":48},"eXchEMZ5",{"_2279":3730},[],"import { Article, ImageObject } from 'schema-dts';\n\ninterface HypermediaArticle extends Article {\n '@context': 'https://schema.org';\n '@type': 'Article';\n headline: string;\n author: {\n '@type': 'Person';\n name: string;\n };\n image: ImageObject;\n}\n\nfunction buildArticleJsonLd(meta: ArticleMeta): HypermediaArticle {\n return {\n '@context': 'https://schema.org',\n '@type': 'Article',\n headline: meta.title,\n author: {\n '@type': 'Person',\n name: meta.authorName\n },\n image: {\n '@type': 'ImageObject',\n url: meta.imageUrl\n }\n };\n}",{"_33":3827,"_35":3828},[],{"_37":38,"_39":3829,"_41":42,"_43":3830,"_45":3831,"_47":3832,"_49":48},"buuZNRJN",{},[],"TypeScript compiler catches mistakes. IDE autocomplete for JSON-LD. Predictable structure equals easier optimization.",{"_33":3834,"_35":3835},[],{"_37":38,"_39":3836,"_41":42,"_43":3837,"_45":3838,"_47":3851,"_49":48},"a7fBJW_B",{},[3839,3843,3847],{"_37":1156,"_68":3840,"_71":3841,"_43":3842,"_49":48},[1158],[338],{},{"_37":248,"_68":3844,"_71":3845,"_43":3846,"_49":48},[1562,1775,1895],[306,1776,73],{},{"_37":424,"_68":3848,"_71":3849,"_43":3850,"_49":430},[3219],[1493],{},"Libraries specifically for TypeScript + JSON-LD + SEO: schema-dts (type definitions for Schema.org, zero runtime cost), next-seo (Next.js SEO with JSON-LD support), @artsy/fresnel (responsive JSON-LD for metadata).",{"_33":3853,"_35":3854},[],{"_37":53,"_39":3855,"_41":42,"_43":3856,"_45":3857,"_47":3858,"_49":48},"Iy-9ICE3",{},[],"3.1.5 Zero Runtime Dependency on Any JSON-LD Library",{"_33":3860,"_35":3861},[],{"_37":38,"_39":3862,"_41":42,"_43":3863,"_45":3864,"_47":3874,"_49":48},"mfXI36pq",{},[3865],{"_37":248,"_68":3866,"_71":3869,"_43":3873,"_49":48},[1401,3867,3868],156,168,[3870,3871,3872],151,163,170,{},"The entire npm package contains: generated TypeScript types (zero runtime cost), a JSON file (the context), and ~2KB of builder functions. No jsonld.js, no rdf-ext, no n3. The browser ships static strings.",{"_33":3876,"_35":3877},[],{"_37":53,"_39":3878,"_41":42,"_43":3879,"_45":3880,"_47":3881,"_49":48},"BuYLJh_6",{},[],"3.2 Go Backend Integration — \"JSON-LD as Native JSON\" Option",{"_33":3883,"_35":3884},[],{"_37":53,"_39":3885,"_41":42,"_43":3886,"_45":3887,"_47":3888,"_49":48},"IYZizNuZ",{},[],"3.2.1 Option 1 (Recommended): Go Consumes JSON-LD as Native JSON",{"_33":3890,"_35":3891},[],{"_37":38,"_39":3892,"_41":42,"_43":3893,"_45":3894,"_47":3895,"_49":48},"yZiPbAwA",{},[],"JSON-LD is valid JSON. The Go backend treats it as standard JSON. No RDF-specific libraries needed in production:",{"_33":3897,"_35":3898},[],{"_37":248,"_39":3899,"_41":42,"_43":3900,"_45":3902,"_47":3903,"_49":48},"k_25G43F",{"_2279":3901},"go",[],"// types.go (auto-generated from block-types.yaml, no RDF imports)\npackage hypermedia\n\ntype ImageBlock struct {\n Context string `json:\"@context\"`\n Type string `json:\"@type\"`\n ImageURL string `json:\"imageUrl\"`\n AltText string `json:\"altText,omitempty\"`\n}\n\nfunc ParseBlock(data []byte) (*ImageBlock, error) {\n var block ImageBlock\n err := json.Unmarshal(data, &block) // stdlib only\n return &block, err\n}",{"_33":3905,"_35":3906},[],{"_37":38,"_39":3907,"_41":42,"_43":3908,"_45":3909,"_47":3910,"_49":48},"-FtfxIo8",{},[],"Zero RDF-specific dependencies. Idiomatic Go code. Full performance (no parsing overhead). Interoperability (JSON-LD is valid RDF for other tools).",{"_33":3912,"_35":3913},[],{"_37":53,"_39":3914,"_41":42,"_43":3915,"_45":3916,"_47":3917,"_49":48},"bdWN_rmD",{},[],"3.2.2 Direct CBOR Parsing in Go Without RDF Layer",{"_33":3919,"_35":3920},[],{"_37":38,"_39":3921,"_41":42,"_43":3922,"_45":3923,"_47":3931,"_49":48},"T4LnNfN2",{},[3924],{"_37":248,"_68":3925,"_71":3928,"_43":3930,"_49":48},[3926,3927],171,182,[1444,3929],194,{},"The Go backend reads DAG-CBOR directly. The CBOR prefix table (integer codes mapping to URI prefixes) is a lookup table in Go, not an RDF processing step. CBOR field code 10 maps to hm:blockType. This is a map lookup, not graph processing.",{"_33":3933,"_35":3934},[],{"_37":53,"_39":3935,"_41":42,"_43":3936,"_45":3937,"_47":3938,"_49":48},"minCR3Ds",{},[],"3.2.3 Option 2 (If RDF Processing Needed in Go): Lightweight Libraries",{"_33":3940,"_35":3941},[],{"_37":38,"_39":3942,"_41":42,"_43":3943,"_45":3944,"_47":3945,"_49":48},"f5Y1qSSB",{},[],"If actual RDF graph operations are needed in Go at some future point:",{"_33":3947,"_35":3981},[3948,3959,3970],{"_33":3949,"_35":3950},[],{"_37":38,"_39":3951,"_41":42,"_43":3952,"_45":3953,"_47":3958,"_49":48},"_llCjUVb",{},[3954],{"_37":1156,"_68":3955,"_71":3956,"_43":3957,"_49":48},[1158],[3393],{},"piprate/json-gold: Pure Go JSON-LD processor. Actively maintained (2023+ commits). Implements W3C JSON-LD spec. Good for expansion/compaction.",{"_33":3960,"_35":3961},[],{"_37":38,"_39":3962,"_41":42,"_43":3963,"_45":3964,"_47":3969,"_49":48},"hfSs90Ph",{},[3965],{"_37":1156,"_68":3966,"_71":3967,"_43":3968,"_49":48},[1158],[3574],{},"knakk/rdf: Basic RDF support. Simple triple manipulation. Turtle/N-Triples parsing. Used in production systems.",{"_33":3971,"_35":3972},[],{"_37":38,"_39":3973,"_41":42,"_43":3974,"_45":3975,"_47":3980,"_49":48},"qaJ020s5",{},[3976],{"_37":1156,"_68":3977,"_71":3978,"_43":3979,"_49":48},[1158],[1467],{},"underlay/go-*: Emerging ecosystem. Modern approach to knowledge graphs. Growing community.",{"_37":38,"_39":3982,"_41":42,"_43":3983,"_45":3984,"_47":3989,"_49":48},"icBiJcUR",{"_100":101},[3985],{"_37":1156,"_68":3986,"_71":3987,"_43":3988,"_49":48},[1158],[250],{},"Available libraries:",{"_33":3991,"_35":3992},[],{"_37":248,"_39":3993,"_41":42,"_43":3994,"_45":3995,"_47":3996,"_49":48},"-sfREPDu",{"_2279":3901},[],"// Example using piprate/json-gold (only if needed)\nimport \"github.com/piprate/json-gold/ld\"\n\nproc := ld.NewJsonLdProcessor()\nexpanded, err := proc.Expand(jsonLdDoc, nil)",{"_33":3998,"_35":3999},[],{"_37":53,"_39":4000,"_41":42,"_43":4001,"_45":4002,"_47":4003,"_49":48},"k7OFTsOg",{},[],"3.2.4 Option 3 (Hybrid): Python Tooling + Go Runtime",{"_33":4005,"_35":4006},[],{"_37":38,"_39":4007,"_41":42,"_43":4008,"_45":4009,"_47":4010,"_49":48},"Nk5L47UR",{},[],"Development time: Python tools (rdflib, pyLODE) generate artifacts. Runtime: Go consumes generated JSON-LD contexts and types. Build step: Python generates Go code from RDF vocabulary.",{"_33":4012,"_35":4013},[],{"_37":248,"_39":4014,"_41":42,"_43":4015,"_45":4016,"_47":4017,"_49":48},"vZfUKV6s",{"_2279":3502},[],"# Build time (Python)\npython generate_go_types.py core-skos.ttl > types.go\n\n# Runtime (Pure Go)\n# Uses generated types, no RDF library needed",{"_33":4019,"_35":4020},[],{"_37":53,"_39":4021,"_41":42,"_43":4022,"_45":4023,"_47":4024,"_49":48},"0EavulAr",{},[],"3.2.5 Option 4 (Advanced): CGo Bindings to Rust",{"_33":4026,"_35":4027},[],{"_37":38,"_39":4028,"_41":42,"_43":4029,"_45":4030,"_47":4031,"_49":48},"mkT90M7F",{},[],"If high-performance RDF processing becomes necessary: Oxigraph (Rust triple store) has excellent performance. CGo integration possible. Only if requirements justify the complexity. This is a last resort, not a starting point.",{"_33":4033,"_35":4034},[],{"_37":38,"_39":4035,"_41":42,"_43":4036,"_45":4037,"_47":4042,"_49":48},"OeQ8IxKs",{},[4038],{"_37":1156,"_68":4039,"_71":4040,"_43":4041,"_49":48},[1158],[1759],{},"Recommendation: Start with Option 1. Evaluate based on actual needs. The JSON-LD design allows starting simple (pure JSON) and adding RDF processing later if justified.",{"_33":4044,"_35":4045},[],{"_37":53,"_39":4046,"_41":42,"_43":4047,"_45":4048,"_47":4049,"_49":48},"d1Y2tQzt",{},[],"3.2.6 Serialization Flexibility",{"_33":4051,"_35":4085},[4052,4063,4074],{"_33":4053,"_35":4054},[],{"_37":38,"_39":4055,"_41":42,"_43":4056,"_45":4057,"_47":4062,"_49":48},"55IuLOVa",{},[4058],{"_37":1156,"_68":4059,"_71":4060,"_43":4061,"_49":48},[1158],[1467],{},"Development: Turtle (human-readable, for editing vocabularies)",{"_33":4064,"_35":4065},[],{"_37":38,"_39":4066,"_41":42,"_43":4067,"_45":4068,"_47":4073,"_49":48},"zGFL5pbj",{},[4069],{"_37":1156,"_68":4070,"_71":4071,"_43":4072,"_49":48},[1158],[1467],{},"Runtime/API: JSON-LD (Go-native JSON parsing)",{"_33":4075,"_35":4076},[],{"_37":38,"_39":4077,"_41":42,"_43":4078,"_45":4079,"_47":4084,"_49":48},"SLpDi3av",{},[4080],{"_37":1156,"_68":4081,"_71":4082,"_43":4083,"_49":48},[1158],[3296],{},"Storage: CBOR (compact, IPFS-friendly, compatible with existing DAG-CBOR)",{"_37":38,"_39":4086,"_41":42,"_43":4087,"_45":4088,"_47":4089,"_49":48},"lPfZzeDL",{"_100":101},[],"Same semantics, different syntax. Choose based on context:",{"_33":4091,"_35":4092},[],{"_37":38,"_39":4093,"_41":42,"_43":4094,"_45":4095,"_47":4096,"_49":48},"O0Yhu6AB",{},[],"Content negotiation is a native RDF capability. A document published on IPFS can be served in any serialization from an edge gateway.",{"_33":4098,"_35":4099},[],{"_37":53,"_39":4100,"_41":42,"_43":4101,"_45":4102,"_47":4103,"_49":48},"FkzGxwTe",{},[],"3.3 Build-Time Generation Pipeline",{"_33":4105,"_35":4106},[],{"_37":53,"_39":4107,"_41":42,"_43":4108,"_45":4109,"_47":4110,"_49":48},"hbL54dwX",{},[],"3.3.1 Single Script: YAML → Everything",{"_33":4112,"_35":4113},[],{"_37":38,"_39":4114,"_41":42,"_43":4115,"_45":4116,"_47":4117,"_49":48},"-0ckHdUY",{},[],"One script, one source of truth, all artifacts:",{"_33":4119,"_35":4120},[],{"_37":248,"_39":4121,"_41":42,"_43":4122,"_45":4123,"_47":4124,"_49":48},"HGuDTzu6",{"_2279":2280},[],"block-types.yaml\n ├── → core-skos.ttl (SKOS Turtle)\n ├── → context.jsonld (JSON-LD context)\n ├── → context.cbor (CBOR prefix table)\n ├── → types.ts (TypeScript types)\n ├── → types.go (Go struct tags)\n └── → docs/index.html (HTML documentation via pyLODE)",{"_33":4126,"_35":4127},[],{"_37":248,"_39":4128,"_41":42,"_43":4129,"_45":4130,"_47":4131,"_49":48},"C0gLRMcv",{"_2279":3582},[],"# generate.py — the single build script\nfrom rdflib import Graph, Namespace, Literal, URIRef\nfrom rdflib.namespace import SKOS, RDF, DCTERMS\nimport yaml, json\n\n# Load canonical source\nwith open(\"src/block-types.yaml\") as f:\n vocab = yaml.safe_load(f)\n\n# Build RDF graph\ng = Graph()\nHM = Namespace(\"https://hypermedia.foundation/ns/core#\")\ng.bind(\"hm\", HM)\ng.bind(\"skos\", SKOS)\n\n# Generate concept scheme\nscheme_uri = URIRef(str(HM) + vocab[\"concept_scheme\"][\"id\"].split(\":\")[1])\ng.add((scheme_uri, RDF.type, SKOS.ConceptScheme))\nfor lang, label in vocab[\"concept_scheme\"][\"label\"].items():\n g.add((scheme_uri, SKOS.prefLabel, Literal(label, lang=lang)))\n\n# Generate concepts\nfor concept in vocab[\"concepts\"]:\n concept_uri = URIRef(str(HM) + concept[\"id\"].split(\":\")[1])\n g.add((concept_uri, RDF.type, SKOS.Concept))\n g.add((concept_uri, SKOS.inScheme, scheme_uri))\n for lang, label in concept[\"label\"].items():\n g.add((concept_uri, SKOS.prefLabel, Literal(label, lang=lang)))\n # ... broader, altLabel, definition, example, scopeNote\n\n# Write Turtle\ng.serialize(\"generated/core-skos.ttl\", format=\"turtle\")\n\n# Generate JSON-LD context\ncontext = {\"@context\": {\"hm\": str(HM)}}\n# ... build context from concepts\nwith open(\"generated/context.jsonld\", \"w\") as f:\n json.dump(context, f, indent=2)\n\n# Generate TypeScript types\nwith open(\"generated/types.ts\", \"w\") as f:\n for concept in vocab[\"concepts\"]:\n name = concept[\"id\"].split(\":\")[1]\n f.write(f\"export interface {name} extends Block {{\\n\")\n f.write(f\" '@type': '{name}';\\n\")\n # ... fields from properties\n f.write(\"}\\n\\n\")\n\n# Generate Go struct tags\nwith open(\"generated/types.go\", \"w\") as f:\n f.write(\"package hypermedia\\n\\n\")\n for concept in vocab[\"concepts\"]:\n name = concept[\"id\"].split(\":\")[1]\n f.write(f\"type {name} struct {{\\n\")\n f.write(f'\\tType string `json:\"@type\"`\\n')\n # ... fields from properties\n f.write(\"}\\n\\n\")",{"_33":4133,"_35":4134},[],{"_37":53,"_39":4135,"_41":42,"_43":4136,"_45":4137,"_47":4138,"_49":48},"v2lnB3X-",{},[],"3.3.2 Integration into Existing Build System",{"_33":4140,"_35":4141},[],{"_37":248,"_39":4142,"_41":42,"_43":4143,"_45":4145,"_47":4146,"_49":48},"DP76y8mB",{"_2279":4144},"makefile",[],"# Makefile addition\n.PHONY: vocab\n\nvocab: generated/core-skos.ttl generated/context.jsonld generated/types.ts generated/types.go docs/index.html\n\ngenerated/core-skos.ttl generated/context.jsonld generated/types.ts generated/types.go: src/block-types.yaml\n python scripts/generate.py\n\ndocs/index.html: generated/core-skos.ttl\n pylode generated/core-skos.ttl -o docs/index.html",{"_33":4148,"_35":4149},[],{"_37":53,"_39":4150,"_41":42,"_43":4151,"_45":4152,"_47":4153,"_49":48},"4BSTSA3r",{},[],"3.3.3 Non-Regression Tests",{"_33":4155,"_35":4156},[],{"_37":248,"_39":4157,"_41":42,"_43":4158,"_45":4159,"_47":4160,"_49":48},"fOWm7PfE",{"_2279":3502},[],"# The vocabulary compiles (valid Turtle)\nrapper -c generated/core-skos.ttl\n\n# The TypeScript types are valid\nnpx tsc --noEmit generated/types.ts\n\n# The Go types compile\ngo build ./generated/...\n\n# The examples parse with the generated context\nnode -e \"JSON.parse(require('fs').readFileSync('examples/basic-document.jsonld'))\"\n\n# The JSON-LD context is valid\npython -c \"from rdflib import Graph; g = Graph(); g.parse('examples/basic-document.jsonld', format='json-ld')\"",{"_33":4162,"_35":4163},[],{"_37":53,"_39":4164,"_41":42,"_43":4165,"_45":4166,"_47":4167,"_49":48},"PY820Lvx",{},[],"3.4 Third-Party Developer Validation (Proof of Concept)",{"_33":4169,"_35":4170},[],{"_37":53,"_39":4171,"_41":42,"_43":4172,"_45":4173,"_47":4174,"_49":48},"AHfZlbGq",{},[],"3.4.1 Scenario: External Developer Creates a Custom Block Type",{"_33":4176,"_35":4177},[],{"_37":38,"_39":4178,"_41":42,"_43":4179,"_45":4180,"_47":4181,"_49":48},"o2x2UnDL",{},[],"A developer who has never read the Seed source code wants to create an \"AI-Generated Image\" block type:",{"_33":4183,"_35":4184},[],{"_37":248,"_39":4185,"_41":42,"_43":4186,"_45":4187,"_47":4188,"_49":48},"wiP3gtlB",{"_2279":47},[],"@prefix community: .\n@prefix hm: .\n\ncommunity:AIGeneratedImage a skos:Concept ;\n skos:broader hm:ImageBlock ; # Links to core\n skos:prefLabel \"AI-Generated Image\"@en ;\n skos:definition \"Image created by AI model\"@en ;\n skos:related community:PromptEngineering .",{"_33":4190,"_35":4191},[],{"_37":38,"_39":4192,"_41":42,"_43":4193,"_45":4194,"_47":4195,"_49":48},"yWUlDlXg",{},[],"No coordination needed. Just IPFS publication + discovery.",{"_33":4197,"_35":4198},[],{"_37":53,"_39":4199,"_41":42,"_43":4200,"_45":4201,"_47":4202,"_49":48},"AbRed4lg",{},[],"3.4.2 The Developer Journey",{"_33":4204,"_35":4205},[],{"_37":248,"_39":4206,"_41":42,"_43":4207,"_45":4208,"_47":4209,"_49":48},"YlnQSjq9",{"_2279":3502},[],"# 1. Install the package\nnpm install @seed/vocabulary\n\n# 2. Import types and context\nimport type { ImageBlock } from '@seed/vocabulary';\nimport { buildImageBlock } from '@seed/vocabulary/builders';\nimport HM_CONTEXT from '@seed/vocabulary/context.json';\n\n# 3. Build a document with a custom block type\nconst block = {\n ...buildImageBlock({ imageUrl: 'ipfs://Qm...', altText: 'AI sunset' }),\n '@type': 'AIGeneratedImage', // Custom type\n 'community:prompt': 'A sunset over mountains'\n};\n\n# 4. Publish to IPFS\n# The document is self-describing, carrying its own context",{"_33":4211,"_35":4212},[],{"_37":53,"_39":4213,"_41":42,"_43":4214,"_45":4215,"_47":4216,"_49":48},"lvQ2ljD3",{},[],"3.4.3 Success Criteria",{"_33":4218,"_35":4219},[],{"_37":38,"_39":4220,"_41":42,"_43":4221,"_45":4222,"_47":4223,"_49":48},"y64CH_YG",{},[],"The developer can build and publish a working block type using only the npm package, the published documentation, and the SKOS vocabulary. They never read the Seed source code. They never contact the Seed team. Their custom block type is discoverable by any tool that understands SKOS.",{"_33":4225,"_35":4226},[],{"_37":53,"_39":4227,"_41":42,"_43":4228,"_45":4229,"_47":689,"_49":48},"GYzOQYIM",{},[],{"_33":4231,"_35":4232},[],{"_37":53,"_39":4233,"_41":42,"_43":4234,"_45":4235,"_47":4236,"_49":48},"fZ0RhB4p",{},[],"4.1 Capability Discoverability in the Interface",{"_33":4238,"_35":4239},[],{"_37":53,"_39":4240,"_41":42,"_43":4241,"_45":4242,"_47":4243,"_49":48},"Qb3PPj79",{},[],"4.1.1 SKOS Vocabulary as Block Type Registry",{"_33":4245,"_35":4246},[],{"_37":38,"_39":4247,"_41":42,"_43":4248,"_45":4249,"_47":4259,"_49":48},"NEFNne3P",{},[4250],{"_37":248,"_68":4251,"_71":4255,"_43":4258,"_49":48},[4252,4253,4254],240,259,293,[2782,4256,4257],274,314,{},"The SKOS vocabulary feeds a navigable block type registry in the editor. When a user opens the block selector, the available types come from the vocabulary, not from a hardcoded list. Labels and definitions in the user's language come from skos:prefLabel and skos:definition. Hierarchies from skos:broader/narrower organize the selector into logical groups.",{"_33":4261,"_35":4262},[],{"_37":53,"_39":4263,"_41":42,"_43":4264,"_45":4265,"_47":4266,"_49":48},"z1BqgK9x",{},[],"4.1.2 Community Extensions Visible Alongside Native Types",{"_33":4268,"_35":4269},[],{"_37":38,"_39":4270,"_41":42,"_43":4271,"_45":4272,"_47":4281,"_49":48},"2h2_Yb36",{},[4273],{"_37":248,"_68":4274,"_71":4277,"_43":4280,"_49":48},[4275,4276],105,125,[4278,4279],117,137,{},"Community-published block types appear in the same registry as core types. The mechanism is identical: a skos:Concept with a skos:broader relationship to a core type. The editor does not distinguish between \"official\" and \"community\" — it reads the vocabulary graph.",{"_33":4283,"_35":4284},[],{"_37":53,"_39":4285,"_41":42,"_43":4286,"_45":4287,"_47":4292,"_49":48},"Q_hXrFwK",{},[4288],{"_37":424,"_68":4289,"_71":4290,"_43":4291,"_49":430},[591],[593],{},"4.1.3 Analogous Role to Schema.org",{"_33":4294,"_35":4295},[],{"_37":38,"_39":4296,"_41":42,"_43":4297,"_45":4298,"_47":4303,"_49":48},"hb8jhcM9",{},[4299],{"_37":424,"_68":4300,"_71":4301,"_43":4302,"_49":430},[591],[593],{},"On the traditional web, Schema.org lets search engines understand page content. In the Seed ecosystem, the semantic layer plays an analogous but more ambitious role: it allows any piece of software to discover what a document contains, what it can do with it, and how to interact with it.",{"_33":4305,"_35":4306},[],{"_37":38,"_39":4307,"_41":42,"_43":4308,"_45":4309,"_47":4310,"_49":48},"RCegWzUd",{},[],"A document published on IPFS carries with it the description of its own structure. A third-party tool can traverse relationships between documents without knowing the internal implementation. Community extensions are discoverable through the same mechanism as native types.",{"_33":4312,"_35":4313},[],{"_37":53,"_39":4314,"_41":42,"_43":4315,"_45":4316,"_47":4317,"_49":48},"HXMlohOd",{},[],"4.2 Self-Describing Documents",{"_33":4319,"_35":4320},[],{"_37":53,"_39":4321,"_41":42,"_43":4322,"_45":4323,"_47":4324,"_49":48},"3L4zN7Td",{},[],"4.2.1 Every Published Document Carries Its Own JSON-LD Context",{"_33":4326,"_35":4327},[],{"_37":38,"_39":4328,"_41":42,"_43":4329,"_45":4330,"_47":4331,"_49":48},"jat6_p5c",{},[],"No external resolution needed. The context is embedded in the IPFS payload. A third-party tool can inspect any Seed document and understand its structure without documentation, without network access, without the Seed codebase.",{"_33":4333,"_35":4334},[],{"_37":53,"_39":4335,"_41":42,"_43":4336,"_45":4337,"_47":4338,"_49":48},"goZ92TCp",{},[],"4.2.2 Minimal DCAT Metadata Embedded",{"_33":4340,"_35":4341},[],{"_37":38,"_39":4342,"_41":42,"_43":4343,"_45":4344,"_47":4345,"_49":48},"0T05Fszy",{},[],"Every document carries basic discoverability metadata alongside its block content:",{"_33":4347,"_35":4348},[],{"_37":248,"_39":4349,"_41":42,"_43":4350,"_45":4351,"_47":4352,"_49":48},"sK5Ey8MO",{"_2279":20},[],"{\n \"@context\": {\n \"hm\": \"https://hypermedia.foundation/ns/core#\",\n \"dcat\": \"http://www.w3.org/ns/dcat#\",\n \"dct\": \"http://purl.org/dc/terms/\",\n \"foaf\": \"http://xmlns.com/foaf/0.1/\"\n },\n \"@type\": \"hm:Document\",\n \"dct:title\": \"Document title\",\n \"dct:description\": \"Document summary\",\n \"dct:publisher\": {\n \"@type\": \"foaf:Agent\",\n \"foaf:name\": \"Author or organization\"\n },\n \"dct:issued\": \"2026-02-09\",\n \"dct:license\": \"https://creativecommons.org/licenses/by/4.0/\",\n \"dcat:distribution\": {\n \"@type\": \"dcat:Distribution\",\n \"dcat:mediaType\": \"application/ld+json\",\n \"dcat:accessURL\": \"ipfs://bafyrei...\"\n },\n \"hm:blocks\": {\n \"@list\": [\n {\"@type\": \"hm:ParagraphBlock\", \"hm:text\": \"Hello world\"}\n ]\n }\n}",{"_33":4354,"_35":4355},[],{"_37":38,"_39":4356,"_41":42,"_43":4357,"_45":4358,"_47":4359,"_49":48},"hFsHYjml",{},[],"This is additive — it goes alongside the existing block type vocabulary in the same context, not in a separate system. Adding DCAT metadata properties to the JSON-LD context is roughly 15–20 lines of JSON-LD. No new dependencies, no new tooling, no architectural changes.",{"_33":4361,"_35":4362},[],{"_37":53,"_39":4363,"_41":42,"_43":4364,"_45":4365,"_47":4366,"_49":48},"NK5gW6Y-",{},[],"4.3 Access Fluidity: Private → Shared → Open",{"_33":4368,"_35":4369},[],{"_37":53,"_39":4370,"_41":42,"_43":4371,"_45":4372,"_47":4373,"_49":48},"bey_sqNj",{},[],"4.3.1 Architectural Principle",{"_33":4375,"_35":4376},[],{"_37":38,"_39":4377,"_41":42,"_43":4378,"_45":4379,"_47":4380,"_49":48},"pz8H4kXh",{},[],"The transition between visibility levels is a metadata operation on catalog entries, not a document reformatting. The JSON-LD context, the SKOS types, the DCAT metadata are identical at all three levels. Moving from private to shared to open is toggling a publication flag, not reformatting data.",{"_33":4382,"_35":4383},[],{"_37":38,"_39":4384,"_41":42,"_43":4385,"_45":4386,"_47":4387,"_49":48},"JKtElRsz",{},[],"FAIR does not mean open. The \"A\" in FAIR is Accessible, not Available: metadata must be retrievable even when the data itself is not. This distinction is critical for Seed, where users need fluid control over visibility.",{"_33":4389,"_35":4390},[],{"_37":53,"_39":4391,"_41":42,"_43":4392,"_45":4393,"_47":4394,"_49":48},"XovLdObM",{},[],"4.3.2 Three Levels, One Architecture",{"_33":4396,"_35":4397},[],{"_37":38,"_39":4398,"_41":42,"_43":4399,"_45":4400,"_47":4405,"_49":48},"unmPS6O3",{},[4401],{"_37":1156,"_68":4402,"_71":4403,"_43":4404,"_49":48},[1158],[3292],{},"Private — the document exists on IPFS, self-described with full JSON-LD context and DCAT metadata, but the CID is not published to any catalog. FAIR-compliant in structure, invisible in practice. The owner has a fully interoperable document that nobody else can discover.",{"_33":4407,"_35":4408},[],{"_37":38,"_39":4409,"_41":42,"_43":4410,"_45":4411,"_47":4423,"_49":48},"RXK4gSOL",{},[4412,4416],{"_37":1156,"_68":4413,"_71":4414,"_43":4415,"_49":48},[1158],[1796],{},{"_37":67,"_68":4417,"_71":4420,"_43":4422,"_49":48},[4418,4419],190,219,[3929,4421],223,{},"Selectively shared — the DCAT catalog lists the document's metadata (title, description, topic, SKOS types) but the distribution points to a gated endpoint. A harvester or collaborator sees that the document exists and what it contains, but cannot retrieve it without authorization. This is exactly how EU member states handle sensitive datasets — the catalog entry is public, the data access is controlled.",{"_33":4425,"_35":4426},[],{"_37":38,"_39":4427,"_41":42,"_43":4428,"_45":4429,"_47":4434,"_49":48},"vYHCgev0",{},[4430],{"_37":1156,"_68":4431,"_71":4432,"_43":4433,"_49":48},[1158],[445],{},"Open — full DCAT distribution with an IPFS gateway URL. Anyone can discover, retrieve, and reuse. The document participates fully in the open data ecosystem.",{"_33":4436,"_35":4437},[],{"_37":53,"_39":4438,"_41":42,"_43":4439,"_45":4440,"_47":4441,"_49":48},"IT3SwZ0E",{},[],"4.3.3 Transition Table",{"_33":4443,"_35":4444},[],{"_37":38,"_39":4445,"_41":42,"_43":4446,"_45":4447,"_47":4448,"_49":48},"BSgr5PYR",{},[],"TransitionWhat ChangesWhat Does Not ChangePrivate → SharedMetadata appears in catalog, gated distribution URL addedDocument content, CID, JSON-LD context, SKOS typesShared → OpenDistribution URL switches to public IPFS gatewayDocument content, CID, JSON-LD context, SKOS types, catalog entryOpen → SharedDistribution URL switches to gated endpointDocument content, CID, JSON-LD context, SKOS types, catalog entryShared → PrivateCatalog entry removedDocument content, CID, JSON-LD context, SKOS types",{"_33":4450,"_35":4451},[],{"_37":38,"_39":4452,"_41":42,"_43":4453,"_45":4454,"_47":4455,"_49":48},"6zLZCO43",{},[],"Every transition is a metadata operation. The document is immutable across all states.",{"_33":4457,"_35":4458},[],{"_37":53,"_39":4459,"_41":42,"_43":4460,"_45":4461,"_47":4462,"_49":48},"JyGZ1gGi",{},[],"4.3.4 Open Vocabulary, Controlled Content",{"_33":4464,"_35":4512},[4465,4481,4497],{"_33":4466,"_35":4467},[],{"_37":38,"_39":4468,"_41":42,"_43":4469,"_45":4470,"_47":4480,"_49":48},"lqtHoEJ_",{},[4471,4475],{"_37":1156,"_68":4472,"_71":4473,"_43":4474,"_49":48},[445],[1250],{},{"_37":67,"_68":4476,"_71":4477,"_43":4479,"_49":48},[1485,305],[4478,2128],51,{},"The vocabulary tells you what kinds of things exist and how to describe them — always public",{"_33":4482,"_35":4483},[],{"_37":38,"_39":4484,"_41":42,"_43":4485,"_45":4486,"_47":4496,"_49":48},"mbiMvDxz",{},[4487,4491],{"_37":1156,"_68":4488,"_71":4489,"_43":4490,"_49":48},[445],[1771],{},{"_37":67,"_68":4492,"_71":4493,"_43":4495,"_49":48},[1422,305],[4478,4494],73,{},"The catalog tells you what specific documents exist and what they contain — selectively visible",{"_33":4498,"_35":4499},[],{"_37":38,"_39":4500,"_41":42,"_43":4501,"_45":4502,"_47":4511,"_49":48},"PvBBLTqu",{},[4503,4507],{"_37":1156,"_68":4504,"_71":4505,"_43":4506,"_49":48},[445],[2398],{},{"_37":67,"_68":4508,"_71":4509,"_43":4510,"_49":48},[252],[4478],{},"The documents themselves contain the actual content — access-controlled",{"_37":38,"_39":4513,"_41":42,"_43":4514,"_45":4515,"_47":4516,"_49":48},"vVR4RIcl",{"_100":101},[],"The separation that makes selective sharing work without coordination:",{"_33":4518,"_35":4519},[],{"_37":38,"_39":4520,"_41":42,"_43":4521,"_45":4522,"_47":4523,"_49":48},"1DB3rh6G",{},[],"A developer can build a Seed-compatible application using only the public vocabulary, without ever accessing a single private document. A data portal can index catalog metadata without retrieving gated content. A user can share a document with a collaborator by granting access to the distribution endpoint, without publishing anything to a public catalog.",{"_33":4525,"_35":4526},[],{"_37":53,"_39":4527,"_41":42,"_43":4528,"_45":4529,"_47":4530,"_49":48},"vRGVc8wG",{},[],"4.4 Native Multilingual Labels",{"_33":4532,"_35":4533},[],{"_37":53,"_39":4534,"_41":42,"_43":4535,"_45":4536,"_47":4537,"_49":48},"_PUhIkHd",{},[],"4.4.1 SKOS Native Multilingual Support",{"_33":4539,"_35":4540},[],{"_37":248,"_39":4541,"_41":42,"_43":4542,"_45":4543,"_47":4544,"_49":48},"sByaFyZT",{"_2279":47},[],"hm:ImageBlock\n skos:prefLabel \"Image Block\"@en ;\n skos:prefLabel \"Bloc Image\"@fr ;\n skos:prefLabel \"Bildblock\"@de ;\n skos:prefLabel \"Bloque de Imagen\"@es .",{"_33":4546,"_35":4547},[],{"_37":53,"_39":4548,"_41":42,"_43":4549,"_45":4550,"_47":4551,"_49":48},"KDClvoFX",{},[],"4.4.2 Interface Adapts to User Language",{"_33":4553,"_35":4554},[],{"_37":38,"_39":4555,"_41":42,"_43":4556,"_45":4557,"_47":4558,"_49":48},"6n3yNGp_",{},[],"The block selector, tooltips, and documentation render in the user's language without ad hoc translation work. The vocabulary carries the translations natively.",{"_33":4560,"_35":4561},[],{"_37":53,"_39":4562,"_41":42,"_43":4563,"_45":4564,"_47":4565,"_49":48},"S1sF8aVS",{},[],"4.4.3 Community-Extensible Languages",{"_33":4567,"_35":4568},[],{"_37":38,"_39":4569,"_41":42,"_43":4570,"_45":4571,"_47":4572,"_49":48},"jmCmbkRw",{},[],"A community member can add Japanese labels to the core vocabulary by publishing a SKOS extension:",{"_33":4574,"_35":4575},[],{"_37":248,"_39":4576,"_41":42,"_43":4577,"_45":4578,"_47":4579,"_49":48},"87dGFWS8",{"_2279":47},[],"hm:ImageBlock skos:prefLabel \"画像ブロック\"@ja .",{"_33":4581,"_35":4582},[],{"_37":38,"_39":4583,"_41":42,"_43":4584,"_45":4585,"_47":4586,"_49":48},"Yg_VK94N",{},[],"No coordination with the core team. No pull request. Just IPFS publication.",{"_33":4588,"_35":4589},[],{"_37":53,"_39":4590,"_41":42,"_43":4591,"_45":4592,"_47":883,"_49":48},"xEwvYPf9",{},[],{"_33":4594,"_35":4595},[],{"_37":53,"_39":4596,"_41":42,"_43":4597,"_45":4598,"_47":4599,"_49":48},"7YFzsCMZ",{},[],"5.1 FAIR Compliance by Construction",{"_33":4601,"_35":4602},[],{"_37":53,"_39":4603,"_41":42,"_43":4604,"_45":4605,"_47":4606,"_49":48},"NSCHZJzY",{},[],"5.1.1 FAIR Principles Already Satisfied by Existing Architecture",{"_33":4608,"_35":4708},[4609,4620,4631,4642,4653,4664,4675,4686,4697],{"_33":4610,"_35":4611},[],{"_37":38,"_39":4612,"_41":42,"_43":4613,"_45":4614,"_47":4619,"_49":48},"efk9skjb",{},[4615],{"_37":1156,"_68":4616,"_71":4617,"_43":4618,"_49":48},[1158],[17],{},"F1 (globally unique identifier) — IPFS CID",{"_33":4621,"_35":4622},[],{"_37":38,"_39":4623,"_41":42,"_43":4624,"_45":4625,"_47":4630,"_49":48},"mUAavMjK",{},[4626],{"_37":1156,"_68":4627,"_71":4628,"_43":4629,"_49":48},[1158],[17],{},"F2 (rich metadata) — JSON-LD context with DCAT properties",{"_33":4632,"_35":4633},[],{"_37":38,"_39":4634,"_41":42,"_43":4635,"_45":4636,"_47":4641,"_49":48},"LBqMx_Rx",{},[4637],{"_37":1156,"_68":4638,"_71":4639,"_43":4640,"_49":48},[1158],[17],{},"F3 (metadata includes identifier) — CID in the distribution URL",{"_33":4643,"_35":4644},[],{"_37":38,"_39":4645,"_41":42,"_43":4646,"_45":4647,"_47":4652,"_49":48},"kEuDc3R5",{},[4648],{"_37":1156,"_68":4649,"_71":4650,"_43":4651,"_49":48},[1158],[17],{},"F4 (registered in searchable resource) — any DCAT harvester can index it",{"_33":4654,"_35":4655},[],{"_37":38,"_39":4656,"_41":42,"_43":4657,"_45":4658,"_47":4663,"_49":48},"TED5o1M4",{},[4659],{"_37":1156,"_68":4660,"_71":4661,"_43":4662,"_49":48},[1158],[17],{},"A1 (retrievable by identifier) — IPFS gateway",{"_33":4665,"_35":4666},[],{"_37":38,"_39":4667,"_41":42,"_43":4668,"_45":4669,"_47":4674,"_49":48},"PVS-I-NX",{},[4670],{"_37":1156,"_68":4671,"_71":4672,"_43":4673,"_49":48},[1158],[17],{},"I1 (formal knowledge representation) — JSON-LD / RDF",{"_33":4676,"_35":4677},[],{"_37":38,"_39":4678,"_41":42,"_43":4679,"_45":4680,"_47":4685,"_49":48},"QccAxg59",{},[4681],{"_37":1156,"_68":4682,"_71":4683,"_43":4684,"_49":48},[1158],[17],{},"I2 (FAIR vocabularies) — SKOS + DCAT",{"_33":4687,"_35":4688},[],{"_37":38,"_39":4689,"_41":42,"_43":4690,"_45":4691,"_47":4696,"_49":48},"x0mcGwrC",{},[4692],{"_37":1156,"_68":4693,"_71":4694,"_43":4695,"_49":48},[1158],[17],{},"I3 (qualified references) — URI-based linking",{"_33":4698,"_35":4699},[],{"_37":38,"_39":4700,"_41":42,"_43":4701,"_45":4702,"_47":4707,"_49":48},"qzWHhLkN",{},[4703],{"_37":1156,"_68":4704,"_71":4705,"_43":4706,"_49":48},[1158],[17],{},"R1 (rich metadata with attributes) — DCAT + SKOS descriptions",{"_37":38,"_39":4709,"_41":42,"_43":4710,"_45":4711,"_47":4712,"_49":48},"xCTO9rA3",{"_100":101},[],"A Seed document on IPFS that carries its JSON-LD context with DCAT metadata satisfies:",{"_33":4714,"_35":4715},[],{"_37":38,"_39":4716,"_41":42,"_43":4717,"_45":4718,"_47":4719,"_49":48},"ElZv1xf7",{},[],"That is 9 of the 15 FAIR principles met by the existing architecture plus a small context extension.",{"_33":4721,"_35":4722},[],{"_37":53,"_39":4723,"_41":42,"_43":4724,"_45":4725,"_47":4726,"_49":48},"LRsCwNis",{},[],"5.1.2 EU Standards Mapping",{"_33":4728,"_35":4729},[],{"_37":38,"_39":4730,"_41":42,"_43":4731,"_45":4732,"_47":4733,"_49":48},"pd7Ck9Bc",{},[],"The EU interoperability stack (EIF → DCAT → CPSV → SKOS) maps directly to Seed's architecture:",{"_33":4735,"_35":4736},[],{"_37":38,"_39":4737,"_41":42,"_43":4738,"_45":4739,"_47":4747,"_49":48},"b9WA2lrs",{},[4740],{"_37":1156,"_68":4741,"_71":4743,"_43":4746,"_49":48},[1320,3222,3871,4742],239,[1215,4744,3926,4745],107,248,{},"EIF LayerWhat It MeansSeed EquivalentLegalLicensing, data rightsCreative Commons on documentsOrganizationalBusiness processes, governanceCommunity extensions modelSemanticShared vocabularies, controlled termsSKOS vocabulary for block typesTechnicalProtocols, formats, APIsIPFS + DAG-CBOR + JSON-LD",{"_33":4749,"_35":4750},[],{"_37":38,"_39":4751,"_41":42,"_43":4752,"_45":4753,"_47":4754,"_49":48},"PvrS6sk9",{},[],"We already cover three of the four layers. The semantic layer — the one the EU cares about most — is exactly what we are building.",{"_33":4756,"_35":4757},[],{"_37":38,"_39":4758,"_41":42,"_43":4759,"_45":4760,"_47":4773,"_49":48},"e-Sx9wF1",{},[4761,4766],{"_37":424,"_68":4762,"_71":4763,"_43":4764,"_49":4765},[3574],[1422],{},"http://data.norge.no",{"_37":424,"_68":4767,"_71":4769,"_43":4771,"_49":4772},[4768],220,[4770],234,{},"http://data.europa.eu","Norway's data.norge.no is the reference implementation: FAIR principles enforced through DCAT catalogs, SKOS concept schemes, and machine-readable metadata. Every EU member state data portal follows the same pattern via data.europa.eu.",{"_33":4775,"_35":4776},[],{"_37":53,"_39":4777,"_41":42,"_43":4778,"_45":4779,"_47":4780,"_49":48},"-swAJu7O",{},[],"5.1.3 FAIR Compliance Across Access Levels",{"_33":4782,"_35":4783},[],{"_37":38,"_39":4784,"_41":42,"_43":4785,"_45":4786,"_47":4801,"_49":48},"3G0TVYFi",{},[4787],{"_37":1156,"_68":4788,"_71":4793,"_43":4800,"_49":48},[1695,3478,4789,3870,1494,4790,4791,1408,4792],119,227,278,340,[252,1324,4794,2419,4795,4796,4797,4798,4799],121,183,229,280,313,342,{},"FAIR PrinciplePrivateSharedOpenF1 Unique identifier (CID)YesYesYesF2 Rich metadataYes (local)Yes (catalog)Yes (catalog)F3 Metadata includes IDYesYesYesF4 Searchable registryNoYesYesA1 Retrievable by IDOwner onlyAuthorizedAnyoneA2 Metadata accessible even if data is notN/AYesYesI1 Formal representationYesYesYesI2 FAIR vocabulariesYesYesYesR1 Rich attributesYesYesYes",{"_33":4803,"_35":4804},[],{"_37":38,"_39":4805,"_41":42,"_43":4806,"_45":4807,"_47":4812,"_49":48},"kP77OoGj",{},[4808],{"_37":1156,"_68":4809,"_71":4810,"_43":4811,"_49":48},[1759],[3393],{},"The key row is A2: \"Metadata are accessible even when the data are no longer available.\" DCAT handles this natively — the catalog entry persists and describes the dataset even if the distribution endpoint requires authentication or the data has been retracted. This is how Seed can offer selective sharing without violating FAIR principles.",{"_33":4814,"_35":4815},[],{"_37":53,"_39":4816,"_41":42,"_43":4817,"_45":4818,"_47":721,"_49":48},"feip7dXM",{},[],{"_33":4820,"_35":4821},[],{"_37":38,"_39":4822,"_41":42,"_43":4823,"_45":4824,"_47":4830,"_49":48},"ZHLbXVdF",{},[4825],{"_37":67,"_68":4826,"_71":4828,"_43":4829,"_49":48},[4827],90,[2902],{},"CPSV is more specialized (government services), but the pattern is relevant: it describes capabilities — what a service can do, what inputs it requires, what outputs it produces. This maps to Seed's block type model. A block type is a capability (what the platform can do). Its properties are inputs (what you need to provide). Its rendered output is the result. If Seed ever targets public sector users or EU-funded projects, CPSV compatibility comes nearly for free from the existing SKOS + DCAT foundation.",{"_33":4832,"_35":4833},[],{"_37":53,"_39":4834,"_41":42,"_43":4835,"_45":4836,"_47":4837,"_49":48},"lerK4m4i",{},[],"5.2 DCAT Catalog",{"_33":4839,"_35":4840},[],{"_37":53,"_39":4841,"_41":42,"_43":4842,"_45":4843,"_47":4844,"_49":48},"gMSmWyLk",{},[],"5.2.1 Static Generation of a Catalog Endpoint",{"_33":4846,"_35":4847},[],{"_37":38,"_39":4848,"_41":42,"_43":4849,"_45":4850,"_47":4856,"_49":48},"JYVIIjvF",{},[4851],{"_37":424,"_68":4852,"_71":4854,"_43":4855,"_49":4772},[4853],166,[3668],{},"A DCAT catalog endpoint is a static JSON-LD file listing published documents — generated at build time, same as the HTML documentation. Any DCAT-compliant harvester (data.europa.eu, national portals) can index Seed documents if they expose this endpoint.",{"_33":4858,"_35":4859},[],{"_37":53,"_39":4860,"_41":42,"_43":4861,"_45":4862,"_47":4863,"_49":48},"oezkCYfL",{},[],"5.2.2 Catalog Lists Metadata, Not Content",{"_33":4865,"_35":4866},[],{"_37":38,"_39":4867,"_41":42,"_43":4868,"_45":4869,"_47":4870,"_49":48},"PPTtyXHW",{},[],"The catalog entry describes a dataset (title, author, topics, license, distribution URL) without including the content itself. For selectively shared documents, the distribution URL points to a gated endpoint. For open documents, it points to an IPFS gateway.",{"_33":4872,"_35":4873},[],{"_37":53,"_39":4874,"_41":42,"_43":4875,"_45":4876,"_47":4877,"_49":48},"ucnimdCX",{},[],"5.2.3 Harvesting Testable with Local CKAN or EU Sandbox",{"_33":4879,"_35":4908},[4880,4887,4894,4901],{"_33":4881,"_35":4882},[],{"_37":38,"_39":4883,"_41":42,"_43":4884,"_45":4885,"_47":4886,"_49":48},"vvGmC5Vk",{},[],"Set up a local CKAN instance",{"_33":4888,"_35":4889},[],{"_37":38,"_39":4890,"_41":42,"_43":4891,"_45":4892,"_47":4893,"_49":48},"yk7zto96",{},[],"Point it at the generated DCAT catalog endpoint",{"_33":4895,"_35":4896},[],{"_37":38,"_39":4897,"_41":42,"_43":4898,"_45":4899,"_47":4900,"_49":48},"wzQoFgd8",{},[],"Verify that catalog entries are indexed correctly",{"_33":4902,"_35":4903},[],{"_37":38,"_39":4904,"_41":42,"_43":4905,"_45":4906,"_47":4907,"_49":48},"yaYjy1nH",{},[],"Verify that gated distribution URLs are handled correctly (metadata visible, content requires auth)",{"_37":38,"_39":4909,"_41":42,"_43":4910,"_45":4911,"_47":4912,"_49":48},"kH5rBI5E",{"_100":101},[],"Before registering with a production EU portal, test harvesting locally:",{"_33":4914,"_35":4915},[],{"_37":53,"_39":4916,"_41":42,"_43":4917,"_45":4918,"_47":4919,"_49":48},"y_G2uAwi",{},[],"5.3 Exploring Existing Data with SPARQL Anything",{"_33":4921,"_35":4922},[],{"_37":53,"_39":4923,"_41":42,"_43":4924,"_45":4925,"_47":4926,"_49":48},"pUP_0mzK",{},[],"5.3.1 Query Any Format as RDF Without Conversion",{"_33":4928,"_35":4929},[],{"_37":38,"_39":4930,"_41":42,"_43":4931,"_45":4932,"_47":4939,"_49":48},"PuL4lzPr",{},[4933],{"_37":424,"_68":4934,"_71":4935,"_43":4937,"_49":4938},[3393],[4936],67,{},"https://github.com/SPARQL-Anything/sparql.anything","SPARQL Anything (https://github.com/SPARQL-Anything/sparql.anything) uses a facade architecture. It exposes any data source through a virtual RDF graph. No conversion step. Query on the fly.",{"_33":4941,"_35":4942},[],{"_37":248,"_39":4943,"_41":42,"_43":4944,"_45":4945,"_47":4946,"_49":48},"gtGY9tp0",{"_2279":47},[],"PREFIX xyz: \nPREFIX hm: \n\n-- Query document.cbor without converting it to RDF first\nSELECT ?blockType ?text\nWHERE {\n SERVICE {\n ?doc xyz:type \"document\" ;\n xyz:blocks ?block .\n\n ?block xyz:type ?blockType ;\n xyz:text ?text .\n }\n}",{"_33":4948,"_35":4949},[],{"_37":53,"_39":4950,"_41":42,"_43":4951,"_45":4952,"_47":4953,"_49":48},"I6tUrSDA",{},[],"5.3.2 Practical Use Cases",{"_33":4955,"_35":4956},[],{"_37":38,"_39":4957,"_41":42,"_43":4958,"_45":4959,"_47":4964,"_49":48},"Z0k2WFUx",{},[4960],{"_37":1156,"_68":4961,"_71":4962,"_43":4963,"_49":48},[1158],[337],{},"Find all image blocks in a document:",{"_33":4966,"_35":4967},[],{"_37":248,"_39":4968,"_41":42,"_43":4969,"_45":4970,"_47":4971,"_49":48},"u392p_pV",{"_2279":47},[],"SELECT ?imageUrl\nWHERE {\n SERVICE {\n ?block xyz:type \"image\" ;\n xyz:imageUrl ?imageUrl .\n }\n}",{"_33":4973,"_35":4974},[],{"_37":38,"_39":4975,"_41":42,"_43":4976,"_45":4977,"_47":4983,"_49":48},"P7HDZGuy",{},[4978],{"_37":1156,"_68":4979,"_71":4980,"_43":4982,"_49":48},[1158],[4981],63,{},"Find blocks with missing required fields (accessibility audit):",{"_33":4985,"_35":4986},[],{"_37":248,"_39":4987,"_41":42,"_43":4988,"_45":4989,"_47":4990,"_49":48},"5DmJtfHb",{"_2279":47},[],"SELECT ?block\nWHERE {\n SERVICE {\n ?block xyz:type \"image\" .\n FILTER NOT EXISTS { ?block xyz:altText ?alt }\n }\n}",{"_33":4992,"_35":4993},[],{"_37":38,"_39":4994,"_41":42,"_43":4995,"_45":4996,"_47":5001,"_49":48},"HPIrxGam",{},[4997],{"_37":1156,"_68":4998,"_71":4999,"_43":5000,"_49":48},[1158],[515],{},"Extract all text content for full-text indexing:",{"_33":5003,"_35":5004},[],{"_37":248,"_39":5005,"_41":42,"_43":5006,"_45":5007,"_47":5008,"_49":48},"ljXdqFiG",{"_2279":47},[],"SELECT ?text\nWHERE {\n SERVICE {\n ?block xyz:text ?text .\n }\n}",{"_33":5010,"_35":5011},[],{"_37":53,"_39":5012,"_41":42,"_43":5013,"_45":5014,"_47":5015,"_49":48},"UAcGjwmM",{},[],"5.3.3 Strictly Tooling and Prototyping",{"_33":5017,"_35":5018},[],{"_37":38,"_39":5019,"_41":42,"_43":5020,"_45":5021,"_47":5022,"_49":48},"oh8hOJ7b",{},[],"SPARQL Anything is for development-time exploration and prototyping. Performance is limited (virtual graph, not indexed). Not suitable for production validation. Use it to understand what is in your CBOR data and to prototype queries before building production tooling.",{"_33":5024,"_35":5025},[],{"_37":38,"_39":5026,"_41":42,"_43":5027,"_45":5028,"_47":5034,"_49":48},"RBC99hXd",{},[5029],{"_37":1156,"_68":5030,"_71":5031,"_43":5033,"_49":48},[1158],[5032],21,{},"Recommended workflow:",{"_33":5036,"_35":5037},[],{"_37":248,"_39":5038,"_41":42,"_43":5039,"_45":5040,"_47":5041,"_49":48},"7_Z03BVk",{"_2279":2280},[],"Development/Exploration:\n SPARQL Anything → Query existing CBOR directly\n (Fast prototyping, zero conversion)\n\nProduction/Validation:\n FaCade-X mappings → Convert CBOR to RDF\n pyshacl → Validate against SHACL shapes\n (When you need formal validation)",{"_33":5043,"_35":5044},[],{"_37":53,"_39":5045,"_41":42,"_43":5046,"_45":5047,"_47":5048,"_49":48},"JqHPK2Vp",{},[],"5.4 Declarative Format Mappings: FaCade-X and RML",{"_33":5050,"_35":5051},[],{"_37":53,"_39":5052,"_41":42,"_43":5053,"_45":5054,"_47":5055,"_49":48},"9VIMsEnf",{},[],"5.4.1 The Problem with Hardcoded Conversions",{"_33":5057,"_35":5058},[],{"_37":38,"_39":5059,"_41":42,"_43":5060,"_45":5061,"_47":5062,"_49":48},"Q235hyS4",{},[],"Hard-coding format conversions (CBOR→RDF, JSON→RDF) creates maintenance burden. Every schema change requires updating converter code. Multiple output formats multiply the work.",{"_33":5064,"_35":5065},[],{"_37":53,"_39":5066,"_41":42,"_43":5067,"_45":5068,"_47":5069,"_49":48},"faNNjqW9",{},[],"5.4.2 Declarative Mappings as Data",{"_33":5071,"_35":5072},[],{"_37":38,"_39":5073,"_41":42,"_43":5074,"_45":5075,"_47":5076,"_49":48},"yZbKXz2e",{},[],"Define once how your format maps to RDF, apply everywhere:",{"_33":5078,"_35":5079},[],{"_37":248,"_39":5080,"_41":42,"_43":5081,"_45":5082,"_47":5083,"_49":48},"Vvk5qu-B",{"_2279":2846},[],"# map-cbor-to-rdf.yaml\nsource:\n format: dag-cbor\n root: \"$\"\n\ntarget:\n format: rdf-turtle\n base: \"https://hypermedia.foundation/ns/core#\"\n\nmappings:\n - source_path: \"$.type\"\n target_predicate: \"rdf:type\"\n transform: \n type: \"prefix_namespace\"\n namespace: \"hm:\"\n\n - source_path: \"$.creator\"\n target_predicate: \"hm:creator\"\n target_type: \"uri\"\n transform:\n type: \"ensure_scheme\"\n scheme: \"did:key:\"\n\n - source_path: \"$.blocks[*]\"\n target_predicate: \"hm:hasBlock\"\n iterate: true\n nested_mappings:\n - source_path: \"type\"\n target_predicate: \"rdf:type\"\n transform:\n type: \"concat\"\n parts: [\"hm:\", \"$value\", \"Block\"]\n\n - source_path: \"text\"\n target_predicate: \"hm:text\"\n target_type: \"literal\"\n language: \"en\"",{"_33":5085,"_35":5086},[],{"_37":38,"_39":5087,"_41":42,"_43":5088,"_45":5089,"_47":5094,"_49":48},"KC_iOXve",{},[5090],{"_37":1156,"_68":5091,"_71":5092,"_43":5093,"_49":48},[1158],[3574],{},"Benefits: Mappings are versioned data. Multiple output formats from same source. Easier to maintain than code.",{"_33":5096,"_35":5142},[5097,5114,5131],{"_33":5098,"_35":5099},[],{"_37":38,"_39":5100,"_41":42,"_43":5101,"_45":5102,"_47":5113,"_49":48},"RMEzRNnN",{},[5103,5107],{"_37":1156,"_68":5104,"_71":5105,"_43":5106,"_49":48},[1158],[428],{},{"_37":424,"_68":5108,"_71":5109,"_43":5111,"_49":5112},[365],[5110],85,{},"https://rml.io/","RML (RDF Mapping Language) — W3C standard, most mature, best tooling (https://rml.io/)",{"_33":5115,"_35":5116},[],{"_37":38,"_39":5117,"_41":42,"_43":5118,"_45":5119,"_47":5130,"_49":48},"B6JuNP_n",{},[5120,5124],{"_37":1156,"_68":5121,"_71":5122,"_43":5123,"_49":48},[1158],[3292],{},{"_37":424,"_68":5125,"_71":5127,"_43":5128,"_49":5129},[5126],53,[2128],{},"https://rml.io/yarrrml/","YARRRML — RML in YAML (human-friendly RML authoring, https://rml.io/yarrrml/)",{"_33":5132,"_35":5133},[],{"_37":38,"_39":5134,"_41":42,"_43":5135,"_45":5136,"_47":5141,"_49":48},"nPqCmCiU",{},[5137],{"_37":1156,"_68":5138,"_71":5139,"_43":5140,"_49":48},[1158],[973],{},"Custom — Define your own mapping DSL (more control, more work)",{"_37":53,"_39":5143,"_41":42,"_43":5144,"_45":5145,"_47":5146,"_49":48},"kzvjM5eZ",{"_100":101},[],"5.4.3 Implementation Options",{"_33":5148,"_35":5149},[],{"_37":53,"_39":5150,"_41":42,"_43":5151,"_45":5152,"_47":5153,"_49":48},"VDgyaRkl",{},[],"5.4.4 Recommended Progression",{"_33":5155,"_35":5156},[],{"_37":248,"_39":5157,"_41":42,"_43":5158,"_45":5159,"_47":5160,"_49":48},"YUpsxos7",{"_2279":2280},[],"Week 1-2: SPARQL Anything (ad-hoc exploration)\nWeek 3-4: Simple Python converter (100-200 lines)\nMonth 2+: RML mappings (when mappings get complex)",{"_33":5162,"_35":5163},[],{"_37":38,"_39":5164,"_41":42,"_43":5165,"_45":5166,"_47":5167,"_49":48},"9mY2xaSv",{},[],"Do not over-engineer early. Start simple, formalize when patterns stabilize. Move to RML when you have 5+ different source formats, when mapping logic exceeds 500 lines, or when you need version control of mappings independently from application code.",{"_33":5169,"_35":5170},[],{"_37":53,"_39":5171,"_41":42,"_43":5172,"_45":5173,"_47":5174,"_49":48},"zKodxZRJ",{},[],"5.5 Optional SHACL Validation",{"_33":5176,"_35":5177},[],{"_37":53,"_39":5178,"_41":42,"_43":5179,"_45":5180,"_47":5181,"_49":48},"Ym0l4GwM",{},[],"5.5.1 Shapes for 2–3 Critical Block Types",{"_33":5183,"_35":5184},[],{"_37":248,"_39":5185,"_41":42,"_43":5186,"_45":5187,"_47":5188,"_49":48},"3BAaS_7i",{"_2279":47},[],"# Enforce that all concepts have English labels\nhm:ConceptShape a sh:NodeShape ;\n sh:targetClass skos:Concept ;\n sh:property [\n sh:path skos:prefLabel ;\n sh:minCount 1 ;\n sh:languageIn ( \"en\" ) ;\n ] .\n\n# Image blocks must have alt text for accessibility\nhm:ImageBlockShape a sh:NodeShape ;\n sh:targetClass hm:ImageBlock ;\n sh:property [\n sh:path hm:altText ;\n sh:minCount 1 ;\n sh:message \"Image blocks must have alt text for accessibility\" ;\n ] .",{"_33":5190,"_35":5191},[],{"_37":53,"_39":5192,"_41":42,"_43":5193,"_45":5194,"_47":833,"_49":48},"_Ejo-KKf",{},[],{"_33":5196,"_35":5197},[],{"_37":248,"_39":5198,"_41":42,"_43":5199,"_45":5200,"_47":5201,"_49":48},"T_dP35Zh",{"_2279":3582},[],"# validate.py\nfrom rdflib import Graph\nfrom pyshacl import validate\n\ndata_graph = Graph().parse(\"examples/basic-document.jsonld\", format=\"json-ld\")\nshapes_graph = Graph().parse(\"shapes.ttl\", format=\"turtle\")\n\nconforms, results, text = validate(data_graph, shacl_graph=shapes_graph)\n\nif not conforms:\n print(text) # User-friendly error messages\n exit(1)",{"_33":5203,"_35":5204},[],{"_37":53,"_39":5205,"_41":42,"_43":5206,"_45":5207,"_47":5208,"_49":48},"K7fSFakT",{},[],"5.5.3 Adoption Conditional on Demonstrated Value",{"_33":5210,"_35":5211},[],{"_37":38,"_39":5212,"_41":42,"_43":5213,"_45":5214,"_47":5215,"_49":48},"BSFSFtYF",{},[],"SHACL validation is optional. SKOS works fine without it. Adopt it only when the validation use case is concrete — when extension developers are producing invalid block types and need clear error messages. Do not add SHACL shapes speculatively.",{"_33":5217,"_35":5218},[],{"_37":53,"_39":5219,"_41":42,"_43":5220,"_45":5221,"_47":5222,"_49":48},"H2s1_qQ3",{},[],"5.6 Handling Arrays and Ordering",{"_33":5224,"_35":5225},[],{"_37":53,"_39":5226,"_41":42,"_43":5227,"_45":5228,"_47":5229,"_49":48},"xVH3AoLt",{},[],"5.6.1 The Problem",{"_33":5231,"_35":5232},[],{"_37":38,"_39":5233,"_41":42,"_43":5234,"_45":5235,"_47":5236,"_49":48},"EVBGeG4k",{},[],"RDF triples have no intrinsic order. This is annoying for ordered lists of blocks in a document.",{"_33":5238,"_35":5239},[],{"_37":53,"_39":5240,"_41":42,"_43":5241,"_45":5242,"_47":866,"_49":48},"bJFLyGwG",{},[5243],{"_37":248,"_68":5244,"_71":5245,"_43":5246,"_49":48},[591],[864],{},{"_33":5248,"_35":5249},[],{"_37":38,"_39":5250,"_41":42,"_43":5251,"_45":5252,"_47":5253,"_49":48},"XIJxGAfm",{},[],"JSON-LD extends RDF with ordered collections:",{"_33":5255,"_35":5256},[],{"_37":248,"_39":5257,"_41":42,"_43":5258,"_45":5259,"_47":5260,"_49":48},"IyTZPUa9",{"_2279":20},[],"{\n \"@context\": \"https://hypermedia.foundation/ns/core\",\n \"@type\": \"Document\",\n \"blocks\": {\n \"@list\": [\n {\"@type\": \"ParagraphBlock\", \"text\": \"First\"},\n {\"@type\": \"ImageBlock\", \"url\": \"ipfs://...\"},\n {\"@type\": \"ParagraphBlock\", \"text\": \"Second\"}\n ]\n }\n}",{"_33":5262,"_35":5263},[],{"_37":38,"_39":5264,"_41":42,"_43":5265,"_45":5266,"_47":5272,"_49":48},"4A5bX6Ox",{},[5267],{"_37":248,"_68":5268,"_71":5269,"_43":5271,"_49":48},[1158],[5270],5,{},"@list preserves order in RDF serialization.",{"_33":5274,"_35":5275},[],{"_37":53,"_39":5276,"_41":42,"_43":5277,"_45":5278,"_47":5279,"_49":48},"0LT0g9tZ",{},[],"5.6.3 Alternative: Split Responsibilities",{"_33":5281,"_35":5282},[],{"_37":38,"_39":5283,"_41":42,"_43":5284,"_45":5285,"_47":5286,"_49":48},"RrrDM0RK",{},[],"Do not model ordered lists in RDF. Keep them in your CBOR layer, reference from RDF:",{"_33":5288,"_35":5289},[],{"_37":248,"_39":5290,"_41":42,"_43":5291,"_45":5292,"_47":5293,"_49":48},"5J0yjyZ6",{"_2279":47},[],"# RDF (unordered, for semantics)\n:doc1 hm:hasBlock :block1, :block2, :block3 .\n\n# CBOR (ordered, for rendering)\n{\n \"blocks\": [\n {\"id\": \"block1\", ...},\n {\"id\": \"block2\", ...},\n {\"id\": \"block3\", ...}\n ]\n}",{"_33":5295,"_35":5296},[],{"_37":38,"_39":5297,"_41":42,"_43":5298,"_45":5299,"_47":5304,"_49":48},"Ph182_Ro",{},[5300],{"_37":1156,"_68":5301,"_71":5302,"_43":5303,"_49":48},[1467,517],[426,1396],{},"RDF handles what blocks exist. CBOR handles how to render them. Choose based on whether ordering is semantically meaningful or purely presentational.",{"_33":5306,"_35":5307},[],{"_37":53,"_39":5308,"_41":42,"_43":5309,"_45":5310,"_47":932,"_49":48},"lN8Czvs6",{},[],{"_33":5312,"_35":5313},[],{"_37":38,"_39":5314,"_41":42,"_43":5315,"_45":5316,"_47":5317,"_49":48},"5UF2mHL2",{},[],"This section runs in parallel with sections 3–5. It addresses the \"verbose\" and \"friction\" concerns about JSON-LD while keeping all RDF interoperability benefits.",{"_33":5319,"_35":5320},[],{"_37":53,"_39":5321,"_41":42,"_43":5322,"_45":5323,"_47":5324,"_49":48},"IJn2yjpK",{},[],"6.1 Build-Time Generation (Primary Strategy)",{"_33":5326,"_35":5327},[],{"_37":38,"_39":5328,"_41":42,"_43":5329,"_45":5330,"_47":5331,"_49":48},"ulUI1uJJ",{},[],"Do not process JSON-LD in the browser. Generate it at build time.",{"_33":5333,"_35":5334},[],{"_37":38,"_39":5335,"_41":42,"_43":5336,"_45":5337,"_47":5342,"_49":48},"MecaqixS",{},[5338],{"_37":1156,"_68":5339,"_71":5340,"_43":5341,"_49":48},[1158],[3004],{},"Traditional approach (heavy — do not do this):",{"_33":5344,"_35":5345},[],{"_37":248,"_39":5346,"_41":42,"_43":5347,"_45":5348,"_47":5349,"_49":48},"pelQfKJU",{"_2279":3730},[],"// Runtime - SLOW\nimport jsonld from 'jsonld';\n\nasync function renderBlock(block: Block) {\n const expanded = await jsonld.expand(block); // HTTP fetch @context\n const framed = await jsonld.frame(expanded, frame); // Processing\n return render(framed); // Finally render\n}",{"_33":5351,"_35":5352},[],{"_37":38,"_39":5353,"_41":42,"_43":5354,"_45":5355,"_47":5360,"_49":48},"zcEdDDVo",{},[5356],{"_37":1156,"_68":5357,"_71":5358,"_43":5359,"_49":48},[1158],[337],{},"Optimized approach (fast — do this):",{"_33":5362,"_35":5363},[],{"_37":248,"_39":5364,"_41":42,"_43":5365,"_45":5366,"_47":5367,"_49":48},"uIZ_7PbT",{"_2279":3730},[],"// Build time - FAST\nimport type { Block } from '@seed/vocabulary';\n\nfunction buildBlockJsonLd(block: Block): string {\n return JSON.stringify({\n \"@context\": \"https://hypermedia.foundation/ns/core\",\n \"@type\": block.type,\n \"text\": block.text,\n });\n}\n\n// At build time (Next.js SSG/ISR, Vite, etc.)\nexport async function getStaticProps() {\n const blocks = await fetchBlocks();\n const jsonld = blocks.map(buildBlockJsonLd);\n\n return {\n props: { jsonld } // Pre-generated, static\n };\n}",{"_33":5369,"_35":5370},[],{"_37":38,"_39":5371,"_41":42,"_43":5372,"_45":5373,"_47":5382,"_49":48},"1T-50U--",{},[5374,5378],{"_37":1156,"_68":5375,"_71":5376,"_43":5377,"_49":48},[1158],[3292],{},{"_37":248,"_68":5379,"_71":5380,"_43":5381,"_49":48},[5126],[3219],{},"Result: Zero runtime JSON-LD processing. Just static