mdld-parse 0.9.8 → 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.
- package/README.md +243 -262
- package/dist/index.js +1797 -1324
- package/package.json +5 -5
- package/dist/.nojekyll +0 -0
- package/dist/CNAME +0 -1
- package/dist/README.md +0 -431
- package/dist/docs/API.md +0 -435
- package/dist/docs/Architecture.md +0 -190
- package/dist/docs/Guide.md +0 -816
- package/dist/docs/LLM-MDLD-Inducer.md +0 -550
- package/dist/docs/LiterateRDF.md +0 -472
- package/dist/docs/Parser.md +0 -720
- package/dist/docs/Performance.md +0 -238
- package/dist/docs/Spec-render.md +0 -1439
- package/dist/docs/Subject.md +0 -180
- package/dist/docs/Syntax.md +0 -463
- package/dist/docs/TodoList.md +0 -215
- package/dist/docs/Use-Cases.md +0 -354
- package/dist/docs/guide-m.md +0 -56
- package/dist/docs/index.html +0 -108
- package/dist/docs/index.md +0 -56
- package/dist/docs/one-page.md +0 -322
- package/dist/docs/origin.md +0 -459
- package/dist/docs/polarity.md +0 -586
- package/dist/docs/primary-subject.md +0 -326
- package/dist/docs/statements.md +0 -226
- package/dist/docs/tokenization-performance-report.md +0 -164
- package/dist/examples/Cookbook.md +0 -32
- package/dist/examples/Status-SHACL.md +0 -31
- package/dist/examples/demo/index.md +0 -35
- package/dist/examples/demo/journal.md +0 -60
- package/dist/examples/demo/minimal.md +0 -23
- package/dist/examples/demo/project.md +0 -84
- package/dist/examples/demo/prov.md +0 -107
- package/dist/examples/demo/rdf.md +0 -69
- package/dist/examples/demo/recipe.md +0 -50
- package/dist/examples/demo/research.md +0 -84
- package/dist/examples/demo/shacl.md +0 -161
- package/dist/examples/demo/space-mission.md +0 -58
- package/dist/examples/demo/tasks.md +0 -175
- package/dist/examples/demo/xsd.md +0 -91
- package/dist/examples/dogfood.md +0 -288
- package/dist/examples/few-shot.md +0 -309
- package/dist/examples/graph/rdf-graph.html +0 -473
- package/dist/examples/graph/rdf_force_graph_web_component.html +0 -506
- package/dist/examples/index.md +0 -45
- package/dist/examples/llm-time-workflow.md +0 -173
- package/dist/examples/statements.md +0 -43
- package/dist/examples/workflow.md +0 -150
- package/dist/index.html +0 -3023
- package/dist/logo.svg +0 -7
- package/dist/spec/Spec-compact.md +0 -368
- package/dist/spec/Spec-ultra.md +0 -232
- package/dist/spec/Spec.md +0 -1116
- package/dist/spec/index.md +0 -46
package/dist/docs/LiterateRDF.md
DELETED
|
@@ -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.
|