mdkg 0.1.8 → 0.1.10
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/CHANGELOG.md +30 -0
- package/README.md +10 -4
- package/dist/cli.js +4 -2
- package/dist/core/project_db_events.js +599 -0
- package/dist/core/project_db_materializer.js +462 -0
- package/dist/core/project_db_migrations.js +97 -1
- package/dist/init/AGENT_START.md +7 -4
- package/dist/init/CLI_COMMAND_MATRIX.md +5 -1
- package/dist/init/README.md +7 -4
- package/dist/init/init-manifest.json +4 -4
- package/package.json +4 -2
package/CHANGELOG.md
CHANGED
|
@@ -6,6 +6,36 @@ This project follows a pragmatic changelog style inspired by Keep a Changelog. V
|
|
|
6
6
|
|
|
7
7
|
mdkg is pre-v1 public alpha software. Command, graph, cache, bundle, and DAL contracts may change quickly while the project converges on a stable v1 surface.
|
|
8
8
|
|
|
9
|
+
## 0.1.10 - 2026-06-05
|
|
10
|
+
|
|
11
|
+
### Added
|
|
12
|
+
|
|
13
|
+
- Added an internal queue-backed project DB materializer helper plus packed
|
|
14
|
+
`smoke:db-materializer` coverage for queue delivery, durable events, reducers,
|
|
15
|
+
writer lease/CAS conflicts, receipts, snapshots, stats, index, and validate.
|
|
16
|
+
|
|
17
|
+
### Changed
|
|
18
|
+
|
|
19
|
+
- Publish readiness now requires the compiled materializer helper and seeded docs
|
|
20
|
+
that keep materializer support internal-only.
|
|
21
|
+
|
|
22
|
+
## 0.1.9 - 2026-06-04
|
|
23
|
+
|
|
24
|
+
### Added
|
|
25
|
+
|
|
26
|
+
- Added internal local project DB event, receipt, typed reducer, and writer
|
|
27
|
+
lease/CAS foundations after the queue migration.
|
|
28
|
+
- Added packed `smoke:db-events` coverage for event idempotency, conflict
|
|
29
|
+
receipts, reducer application/replay, writer lease CAS conflicts, snapshots,
|
|
30
|
+
stats, index, and validate.
|
|
31
|
+
|
|
32
|
+
### Changed
|
|
33
|
+
|
|
34
|
+
- Project DB migration order now includes events/receipts and writer leases
|
|
35
|
+
after the `0.1.8` queue foundation.
|
|
36
|
+
- Publish readiness now requires the compiled event helper and seeded docs that
|
|
37
|
+
keep event/reducer/lease support internal-only.
|
|
38
|
+
|
|
9
39
|
## 0.1.8 - 2026-06-04
|
|
10
40
|
|
|
11
41
|
### Added
|
package/README.md
CHANGED
|
@@ -14,7 +14,7 @@ mdkg stays deliberately boring:
|
|
|
14
14
|
- first-class rebuildable SQLite cache through built-in `node:sqlite`
|
|
15
15
|
- no daemon, hosted index, or vector DB
|
|
16
16
|
|
|
17
|
-
Current package version in source: `0.1.
|
|
17
|
+
Current package version in source: `0.1.10`
|
|
18
18
|
|
|
19
19
|
mdkg is still pre-v1 public alpha software. The public package is usable, but graph, cache, bundle, and DAL contracts may continue to change quickly while the project converges on a stable v1 surface.
|
|
20
20
|
|
|
@@ -350,10 +350,16 @@ default. `mdkg db init` does not create an active runtime SQLite database.
|
|
|
350
350
|
Run `mdkg db migrate` after init to create or update the active runtime
|
|
351
351
|
SQLite database at the configured `db.runtime_path`; built-in migrations write
|
|
352
352
|
mdkg-owned generic foundation tables, then the internal local node:sqlite queue
|
|
353
|
-
foundation,
|
|
353
|
+
foundation, then internal local event/receipt/reducer and writer lease/CAS
|
|
354
|
+
foundations, and record migration order, checksums, and applied timestamps.
|
|
354
355
|
Queue state is durable local delivery infrastructure, not canonical event
|
|
355
|
-
history.
|
|
356
|
-
|
|
356
|
+
history. Event rows are the durable local history for project DB state
|
|
357
|
+
transitions, receipts provide audit/review artifacts, reducers gate writes,
|
|
358
|
+
writer leases coordinate snapshot-hash compare-and-swap commits, and
|
|
359
|
+
materializers run local queue-backed reducer passes. These capabilities are
|
|
360
|
+
available only through internal helper modules in this release; there is no
|
|
361
|
+
public `mdkg db queue`, `mdkg db event`, `mdkg db reducer`, `mdkg db lease`, or
|
|
362
|
+
`mdkg db materializer` CLI yet.
|
|
357
363
|
Use `mdkg db verify` for non-mutating health checks over config, layout,
|
|
358
364
|
runtime SQLite integrity, migration metadata, and transient runtime files. Use
|
|
359
365
|
`mdkg db stats` for deterministic table counts, DB size, migration state,
|
package/dist/cli.js
CHANGED
|
@@ -226,13 +226,15 @@ function printDbHelp(log, subcommand) {
|
|
|
226
226
|
log(" - `mdkg db init` creates the generic layout and enables db config");
|
|
227
227
|
log(" - `mdkg db init` does not create an active runtime SQLite database");
|
|
228
228
|
log(" - `mdkg db migrate` creates/updates the active runtime SQLite database");
|
|
229
|
-
log(" - `mdkg db migrate` applies mdkg-owned foundation
|
|
229
|
+
log(" - `mdkg db migrate` applies mdkg-owned foundation plus internal queue, event, receipt, reducer, and lease migrations");
|
|
230
230
|
log(" - queue tables are internal local delivery state; no public `mdkg db queue` CLI is exposed");
|
|
231
|
+
log(" - event rows are durable local history; receipts, reducers, and writer leases remain internal helper surfaces");
|
|
232
|
+
log(" - no public `mdkg db event`, `mdkg db reducer`, or `mdkg db lease` CLI is exposed");
|
|
231
233
|
log(" - `mdkg db verify` checks config, layout, SQLite integrity, migrations, and transient files");
|
|
232
234
|
log(" - `mdkg db stats` reports table counts, migration state, DB size, and receipt counts");
|
|
233
235
|
log(" - `mdkg db snapshot ...` manages opt-in sealed checkpoints and review dumps");
|
|
234
236
|
log(" - active `.mdkg/db/runtime` and transient DB files are ignored by default");
|
|
235
|
-
log(" - no raw SQL, hosted queue, profile, public queue command, or publish behavior is exposed here");
|
|
237
|
+
log(" - no raw SQL, hosted queue/event store, profile, public queue/event/reducer/lease command, or publish behavior is exposed here");
|
|
236
238
|
printGlobalOptions(log);
|
|
237
239
|
}
|
|
238
240
|
}
|