mdkg 0.3.0 → 0.3.2

package/dist/init/init-manifest.json

@@ -1,7 +1,7 @@
 {
   "schema_version": 1,
   "tool": "mdkg",
-  "mdkg_version": "0.3.0",
+  "mdkg_version": "0.3.2",
   "files": [
     {
       "path": ".mdkg/config.json",
@@ -46,7 +46,7 @@
     {
       "path": ".mdkg/core/rule-5-release-and-versioning.md",
       "category": "core",
-      "sha256": "e97b00aa3ade29011f1f2b482042ec292f74aad8b1d72e2f8e691cdeca5d4f70"
+      "sha256": "d7862806f999ae23b1d8bc3446f8c81b3a7fdd7d87920d966f59795a84978a03"
     },
     {
       "path": ".mdkg/core/rule-6-templates-and-schemas.md",
@@ -61,7 +61,7 @@
     {
       "path": ".mdkg/README.md",
       "category": "mdkg_doc",
-      "sha256": "353aa7318974d4b3dbdf772ae5a3deb2d41b5d71ea5308d260aab8081121548b"
+      "sha256": "c08de01602698af7eb46b70e9459df9c2fa6e6c32c06b2daab3f697baa450e0d"
     },
     {
       "path": ".mdkg/skills/build-pack-and-execute-task/SKILL.md",
@@ -163,6 +163,11 @@
       "category": "template",
       "sha256": "8c96e0b6dafa65acb83a2d84519e05a7354896aec8991c148650e9ec58196c77"
     },
+    {
+      "path": ".mdkg/templates/default/spike.md",
+      "category": "template",
+      "sha256": "ac805dca7e6edcdad35e24b615dc7399cbae3bed676b9da57e24a393eb425245"
+    },
     {
       "path": ".mdkg/templates/default/task.md",
       "category": "template",
@@ -256,7 +261,7 @@
     {
       "path": "CLI_COMMAND_MATRIX.md",
       "category": "startup_doc",
-      "sha256": "48c1b7fbef3a01faf5ddf8bb232b19362b49ef2a371a7c38ae11302c8b3bccac"
+      "sha256": "888c5ce1372c0a7ba2c24bfe0aea97e221804cab1fa8940e06dc050330830a76"
     },
     {
       "path": "llms.txt",

package/dist/init/templates/default/spike.md

@@ -0,0 +1,81 @@
+---
+id: {{id}}
+type: spike
+title: {{title}}
+status: {{status}}
+priority: {{priority}}
+epic: {{epic}}
+parent: {{parent}}
+prev: {{prev}}
+next: {{next}}
+tags: []
+owners: []
+links: []
+artifacts: []
+relates: []
+blocked_by: []
+blocks: []
+refs: []
+aliases: []
+skills: []
+created: {{created}}
+updated: {{updated}}
+---
+
+# Research Question
+
+State the question this spike must answer.
+
+# Context And Constraints
+
+- constraint 1
+- constraint 2
+
+# Search Plan
+
+- source or query 1
+- source or query 2
+
+# Findings
+
+- finding 1
+- finding 2
+
+# Options And Tradeoffs
+
+- option 1: tradeoff
+- option 2: tradeoff
+
+# Recommendation
+
+Summarize the recommended direction and why.
+
+# Follow-Up Nodes To Create
+
+- task/test/decision candidate 1
+- task/test/decision candidate 2
+
+# Skill Candidates
+
+- skill candidate 1
+- skill candidate 2
+
+# Data Structures And Algorithms Notes
+
+- note 1
+
+# UX Notes
+
+- note 1
+
+# Security Notes
+
+- note 1
+
+# mdkg.dev Launch Implications
+
+- implication 1
+
+# Evidence And Sources
+
+- source 1

package/dist/pack/order.js

@@ -21,9 +21,10 @@ const FALLBACK_TYPES = [
     "feat",
     "task",
     "bug",
+    "spike",
     "checkpoint",
 ];
-const WORK_TYPES = ["goal", "epic", "feat", "task", "bug", "checkpoint"];
+const WORK_TYPES = ["goal", "epic", "feat", "task", "bug", "spike", "checkpoint"];
 function idNumber(id) {
     const match = id.match(/-(\d+)$/);
     if (!match) {
@@ -76,7 +77,7 @@ function buildOrderKey(index, rootQid, qid, depths) {
     const node = index.nodes[qid];
     const root = index.nodes[rootQid];
     const depth = depths.get(qid);
-    const rootIsTask = root.type === "task" || root.type === "bug";
+    const rootIsTask = root.type === "task" || root.type === "bug" || root.type === "spike";
     if (qid === rootQid) {
         return {
             group: 0,

package/dist/util/argparse.js

@@ -94,6 +94,7 @@ const VALUE_FLAGS = new Set([
     "--requires",
     "--target",
     "--snapshot",
+    "--family",
 ]);
 const BOOLEAN_FLAGS = new Set([
     "--tolerant",

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "mdkg",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "description": "Markdown Knowledge Graph",
   "license": "MIT",
   "bin": {
     "mdkg": "dist/cli.js"
   },
   "scripts": {
-    "build": "node scripts/clean-build-output.js && tsc -p tsconfig.build.json && node scripts/add-shebang.js && node scripts/copy-init-assets.js",
+    "build": "node scripts/clean-build-output.js && tsc -p tsconfig.build.json && node scripts/add-shebang.js && node scripts/copy-init-assets.js && node scripts/generate-command-contract.js --write",
     "build:test": "node scripts/clean-build-output.js tests && tsc -p tsconfig.test.json",
     "test": "npm run build && npm run build:test && node --test dist/tests/**/*.test.js",
     "test:coverage": "npm run build && npm run build:test && node --test --experimental-test-coverage dist/tests/**/*.test.js",
@@ -25,6 +25,11 @@
     "smoke:archive-work": "npm run build && node scripts/smoke-archive-work.js",
     "smoke:work-invocation": "npm run build && node scripts/smoke-work-invocation.js",
     "smoke:cli-ux-polish": "npm run build && node scripts/smoke-cli-ux-polish.js",
+    "smoke:operator-health": "npm run build && node scripts/smoke-operator-health.js",
+    "smoke:fix-plan": "npm run build && node scripts/smoke-fix-plan.js",
+    "smoke:branch-conflicts": "npm run build && node scripts/smoke-branch-conflicts.js",
+    "smoke:command-docs": "npm run build && node scripts/smoke-command-docs.js",
+    "smoke:spike": "npm run build && node scripts/smoke-spike.js",
     "smoke:bundle": "npm run build && node scripts/smoke-bundle.js",
     "smoke:bundle-import": "npm run smoke:subgraph",
     "smoke:visibility": "npm run build && node scripts/smoke-visibility.js",
@@ -33,8 +38,9 @@
     "smoke:goal": "npm run build && node scripts/smoke-goal.js",
     "cli:snapshot": "npm run build && node scripts/cli_help_snapshot.js",
     "cli:check": "npm run build && node scripts/cli_help_snapshot.js --check",
+    "cli:contract": "npm run build && node scripts/generate-command-contract.js --check",
     "prepack": "npm run build && node scripts/assert-publish-ready.js",
-    "prepublishOnly": "npm run test && npm run cli:check && node dist/cli.js validate && npm run smoke:consumer && npm run smoke:matrix && npm run smoke:upgrade && npm run smoke:init && npm run smoke:capabilities && npm run smoke:db && npm run smoke:db-queue && npm run smoke:db-queue-cli && npm run smoke:db-events && npm run smoke:db-materializer && npm run smoke:db-snapshot && npm run smoke:archive-work && npm run smoke:work-invocation && npm run smoke:cli-ux-polish && npm run smoke:bundle && npm run smoke:subgraph && npm run smoke:visibility && npm run smoke:sqlite && npm run smoke:parallel && npm run smoke:goal && node scripts/assert-publish-ready.js",
+    "prepublishOnly": "npm run test && npm run cli:check && npm run cli:contract && node dist/cli.js validate && npm run smoke:consumer && npm run smoke:matrix && npm run smoke:upgrade && npm run smoke:init && npm run smoke:capabilities && npm run smoke:db && npm run smoke:db-queue && npm run smoke:db-queue-cli && npm run smoke:db-events && npm run smoke:db-materializer && npm run smoke:db-snapshot && npm run smoke:archive-work && npm run smoke:work-invocation && npm run smoke:cli-ux-polish && npm run smoke:operator-health && npm run smoke:fix-plan && npm run smoke:branch-conflicts && npm run smoke:command-docs && npm run smoke:spike && npm run smoke:bundle && npm run smoke:subgraph && npm run smoke:visibility && npm run smoke:sqlite && npm run smoke:parallel && npm run smoke:goal && node scripts/assert-publish-ready.js",
     "postinstall": "node scripts/postinstall.js",
     "smoke:subgraph": "npm run build && node scripts/smoke-subgraph.js"
   },
@@ -44,6 +50,7 @@
   },
   "files": [
     "dist/cli.js",
+    "dist/command-contract.json",
     "dist/commands/",
     "dist/core/",
     "dist/graph/",
@@ -53,6 +60,7 @@
     "dist/util/",
     "scripts/postinstall.js",
     "README.md",
+    "CLI_COMMAND_MATRIX.md",
     "CHANGELOG.md",
     "CONTRIBUTING.md",
     "LICENSE"