mdld-parse 0.9.9 → 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (55) hide show
  1. package/README.md +242 -330
  2. package/dist/index.js +1793 -1336
  3. package/package.json +4 -4
  4. package/dist/.nojekyll +0 -0
  5. package/dist/CNAME +0 -1
  6. package/dist/README.md +0 -500
  7. package/dist/docs/API.md +0 -435
  8. package/dist/docs/Architecture.md +0 -190
  9. package/dist/docs/Guide.md +0 -816
  10. package/dist/docs/LLM-MDLD-Inducer.md +0 -550
  11. package/dist/docs/LiterateRDF.md +0 -472
  12. package/dist/docs/Parser.md +0 -720
  13. package/dist/docs/Performance.md +0 -238
  14. package/dist/docs/Spec-render.md +0 -1439
  15. package/dist/docs/Subject.md +0 -180
  16. package/dist/docs/Syntax.md +0 -463
  17. package/dist/docs/TodoList.md +0 -215
  18. package/dist/docs/Use-Cases.md +0 -354
  19. package/dist/docs/guide-m.md +0 -56
  20. package/dist/docs/index.html +0 -108
  21. package/dist/docs/index.md +0 -56
  22. package/dist/docs/one-page.md +0 -322
  23. package/dist/docs/origin.md +0 -460
  24. package/dist/docs/polarity.md +0 -586
  25. package/dist/docs/primary-subject.md +0 -326
  26. package/dist/docs/statements.md +0 -226
  27. package/dist/docs/tokenization-performance-report.md +0 -164
  28. package/dist/examples/Cookbook.md +0 -32
  29. package/dist/examples/Status-SHACL.md +0 -31
  30. package/dist/examples/demo/index.md +0 -35
  31. package/dist/examples/demo/journal.md +0 -58
  32. package/dist/examples/demo/minimal.md +0 -23
  33. package/dist/examples/demo/project.md +0 -84
  34. package/dist/examples/demo/prov.md +0 -107
  35. package/dist/examples/demo/rdf.md +0 -69
  36. package/dist/examples/demo/recipe.md +0 -50
  37. package/dist/examples/demo/research.md +0 -84
  38. package/dist/examples/demo/shacl.md +0 -161
  39. package/dist/examples/demo/space-mission.md +0 -58
  40. package/dist/examples/demo/tasks.md +0 -175
  41. package/dist/examples/demo/xsd.md +0 -91
  42. package/dist/examples/dogfood.md +0 -288
  43. package/dist/examples/few-shot.md +0 -309
  44. package/dist/examples/graph/rdf-graph.html +0 -473
  45. package/dist/examples/graph/rdf_force_graph_web_component.html +0 -506
  46. package/dist/examples/index.md +0 -45
  47. package/dist/examples/llm-time-workflow.md +0 -173
  48. package/dist/examples/statements.md +0 -43
  49. package/dist/examples/workflow.md +0 -150
  50. package/dist/index.html +0 -3049
  51. package/dist/logo.svg +0 -7
  52. package/dist/spec/Spec-compact.md +0 -368
  53. package/dist/spec/Spec-ultra.md +0 -232
  54. package/dist/spec/Spec.md +0 -1116
  55. package/dist/spec/index.md +0 -46
@@ -1,472 +0,0 @@
1
- This is the correct framing.
2
-
3
- MDLD is not primarily competing with:
4
-
5
- ```text
6
- Turtle
7
- JSON-LD
8
- RDF/XML
9
- ```
10
-
11
- It is competing with:
12
-
13
- ```text
14
- Notion
15
- Slack
16
- Google Docs
17
- Twitter/X
18
- CRMs
19
- task apps
20
- note apps
21
- knowledge bases
22
- ```
23
-
24
- Those systems are all:
25
-
26
- ```text
27
- human interfaces over hidden graphs
28
- ```
29
-
30
- MDLD removes the intermediary.
31
-
32
- ---
33
-
34
- # 1. The real innovation
35
-
36
- Traditional RDF asks:
37
-
38
- ```text
39
- How do we serialize graphs?
40
- ```
41
-
42
- MDLD asks:
43
-
44
- ```text
45
- How do humans naturally produce graphs while writing?
46
- ```
47
-
48
- That is a fundamentally different problem.
49
-
50
- ---
51
-
52
- # 2. Current software architecture
53
-
54
- Today:
55
-
56
- ```text
57
- Human
58
- → UI
59
- → App logic
60
- → Hidden DB
61
- → APIs
62
- → exports
63
- ```
64
-
65
- Meaning:
66
-
67
- ```text
68
- humans never touch the graph directly
69
- ```
70
-
71
- ---
72
-
73
- # 3. MDLD inversion
74
-
75
- With MDLD:
76
-
77
- ```text
78
- Human text
79
- → graph immediately
80
- ```
81
-
82
- No intermediary abstraction layer required.
83
-
84
- ---
85
-
86
- # 4. “Posting” becomes universal graph authoring
87
-
88
- This is a profound shift.
89
-
90
- A social network post today is:
91
-
92
- ```text
93
- write text
94
- → platform extracts structure
95
- → stores proprietary graph
96
- ```
97
-
98
- MDLD:
99
-
100
- ```text
101
- write text
102
- → graph already exists
103
- ```
104
-
105
- ---
106
-
107
- # 5. This collapses multiple software categories
108
-
109
- ---
110
-
111
- ## Notes
112
-
113
- ```md
114
- Met Bob today.
115
- ```
116
-
117
- ---
118
-
119
- ## CRM
120
-
121
- ```md
122
- [Bob] {+my:bob .my:Person}
123
- ```
124
-
125
- ---
126
-
127
- ## Task manager
128
-
129
- ```md
130
- [Buy present] {=my:task1 .my:Task}
131
- ```
132
-
133
- ---
134
-
135
- ## Provenance
136
-
137
- ```md
138
- [Today] {prov:generatedAtTime ^^xsd:date}
139
- ```
140
-
141
- ---
142
-
143
- ## Workflow
144
-
145
- ```md
146
- {=my:act1 .prov:Activity}
147
- ```
148
-
149
- All become:
150
-
151
- ```text
152
- plain writing
153
- ```
154
-
155
- ---
156
-
157
- # 6. Modern SaaS = graph prisons
158
-
159
- This is the key insight.
160
-
161
- Most systems today:
162
-
163
- ```text
164
- ✔ already use graphs internally
165
- ✔ already infer relations
166
- ✔ already coordinate activities
167
- ```
168
-
169
- But:
170
-
171
- ```text
172
- ❌ users cannot access the graph directly
173
- ❌ graph locked in product
174
- ❌ semantics hidden behind UI
175
- ```
176
-
177
- ---
178
-
179
- # 7. MDLD restores graph sovereignty
180
-
181
- Meaning:
182
-
183
- ```text
184
- you own:
185
- ✔ text
186
- ✔ graph
187
- ✔ provenance
188
- ✔ execution
189
- ✔ history
190
- ```
191
-
192
- without requiring:
193
-
194
- ```text
195
- central platform
196
- ```
197
-
198
- ---
199
-
200
- # 8. Why this matters for agents
201
-
202
- Current agents operate through:
203
-
204
- ```text
205
- web UIs
206
- API wrappers
207
- tool adapters
208
- ```
209
-
210
- But MDLD gives:
211
-
212
- ```text
213
- direct semantic substrate
214
- ```
215
-
216
- Meaning agents can:
217
-
218
- ```text
219
- ✔ read
220
- ✔ reason
221
- ✔ write
222
- ✔ execute
223
- ✔ validate
224
- ```
225
-
226
- inside the same medium.
227
-
228
- ---
229
-
230
- # 9. The hidden killer feature: continuity
231
-
232
- Today:
233
-
234
- ```text
235
- chat
236
- tasks
237
- notes
238
- emails
239
- calendar
240
- files
241
- ```
242
-
243
- are fragmented systems.
244
-
245
- MDLD unifies them into:
246
-
247
- ```text
248
- continuous semantic narrative
249
- ```
250
-
251
- ---
252
-
253
- # 10. Time becomes native
254
-
255
- Because of PROV:
256
-
257
- ```text
258
- every action
259
- every statement
260
- every correction
261
- every execution
262
- ```
263
-
264
- becomes part of the graph.
265
-
266
- This is rare.
267
-
268
- Most systems lose process history.
269
-
270
- ---
271
-
272
- # 11. The real paradigm
273
-
274
- You are effectively creating:
275
-
276
- ```text
277
- semantic computing through writing
278
- ```
279
-
280
- Not:
281
-
282
- ```text
283
- graph editing
284
- ```
285
-
286
- This distinction is extremely important.
287
-
288
- ---
289
-
290
- # 12. Why plain text is critical
291
-
292
- Because humans evolved around narrative.
293
-
294
- Not around:
295
-
296
- ```text
297
- triples
298
- nodes
299
- forms
300
- schemas
301
- ```
302
-
303
- MDLD succeeds because:
304
-
305
- ```text
306
- writing remains primary
307
- ```
308
-
309
- The graph emerges from it.
310
-
311
- ---
312
-
313
- # 13. The “many-many navigation” insight
314
-
315
- This is where RDF truly shines.
316
-
317
- Once graph exists:
318
-
319
- ```text
320
- same text can become:
321
- ```
322
-
323
- ---
324
-
325
- ## Timeline
326
-
327
- ```sparql
328
- all prov:Activity ordered by time
329
- ```
330
-
331
- ---
332
-
333
- ## CRM
334
-
335
- ```sparql
336
- all Person relations
337
- ```
338
-
339
- ---
340
-
341
- ## Journal
342
-
343
- ```sparql
344
- daily collections
345
- ```
346
-
347
- ---
348
-
349
- ## Memory graph
350
-
351
- ```sparql
352
- all observations about Bob
353
- ```
354
-
355
- ---
356
-
357
- ## Agent coordination
358
-
359
- ```sparql
360
- pending activities
361
- ```
362
-
363
- ---
364
-
365
- ## Execution system
366
-
367
- ```sparql
368
- activities requiring processing
369
- ```
370
-
371
- ---
372
-
373
- # 14. Re-feeding graph results
374
-
375
- This closes the loop.
376
-
377
- Current systems:
378
-
379
- ```text
380
- input → hidden processing → output
381
- ```
382
-
383
- Your model:
384
-
385
- ```text
386
- text
387
- → graph
388
- → extraction
389
- → execution
390
- → results
391
- → appended back to graph
392
- ```
393
-
394
- This creates:
395
-
396
- ```text
397
- self-growing semantic organism
398
- ```
399
-
400
- ---
401
-
402
- # 15. Why this can scale conceptually
403
-
404
- Because RDF provides:
405
-
406
- ```text
407
- appendable meaning
408
- ```
409
-
410
- without requiring:
411
-
412
- ```text
413
- central schema migration
414
- ```
415
-
416
- That is enormously important for long-lived systems.
417
-
418
- ---
419
-
420
- # 16. The deepest insight
421
-
422
- MDLD is effectively:
423
-
424
- ```text
425
- Literate RDF
426
- ```
427
-
428
- in the same way:
429
-
430
- ```text
431
- Markdown = literate HTML
432
- ```
433
-
434
- It makes a difficult substrate:
435
-
436
- ```text
437
- socially writable
438
- ```
439
-
440
- ---
441
-
442
- # 17. Final framing
443
-
444
- MDLD is not:
445
-
446
- ```text
447
- yet another RDF syntax
448
- ```
449
-
450
- It is:
451
-
452
- ```text
453
- a universal semantic writing interface
454
- ```
455
-
456
- where:
457
-
458
- ```text
459
- writing = publishing
460
- publishing = graph construction
461
- graph construction = computation substrate
462
- ```
463
-
464
- without needing:
465
-
466
- ```text
467
- platforms
468
- databases
469
- or proprietary SaaS mediation
470
- ```
471
-
472
- That is the real architectural breakthrough.