mdkg 0.3.7 → 0.3.9

package/dist/init/templates/specs/model.MANIFEST.md

@@ -0,0 +1,21 @@
+---
+extends: base.MANIFEST.md
+template_kind: model
+spec_kind: model
+---
+
+# Model Identity
+
+Provider, model id, version, and intended use.
+
+# Capabilities
+
+- Reasoning, coding, browsing, vision, tool-use, or structured-output needs.
+
+# Policy Context
+
+- Data classes, retention, privacy, and allowed prompts.
+
+# Evaluation Checks
+
+- Task families, quality gates, and regression criteria.

package/dist/init/templates/specs/project.MANIFEST.md

@@ -0,0 +1,39 @@
+---
+extends: base.MANIFEST.md
+template_kind: project
+spec_kind: project_service
+---
+
+# Project Role
+
+Describe the repo/service responsibility and non-authorities.
+
+# Canonical Repo
+
+- Local path:
+- Remote:
+- Default branch:
+
+# Owned Capabilities
+
+- Capability ids and optional generic capability URIs.
+
+# Project-Agent Boundary
+
+- Graph writes owned by this project.
+- Read-only surfaces exposed to parent or sibling orchestrators.
+- Queue/event surfaces accepted from external orchestrators.
+
+# Single-Writer Policy
+
+- Project writer key.
+- Branch or graph write policy.
+- Accepted receipt before external refresh.
+
+# Integration Boundaries
+
+- Upstream/downstream repos and APIs.
+
+# Validation Checks
+
+- Build, test, mdkg, security, and release gates.

package/dist/init/templates/specs/runtime-agent.MANIFEST.md

@@ -0,0 +1,49 @@
+---
+extends: agent.MANIFEST.md
+template_kind: runtime_agent
+spec_kind: runtime_agent
+---
+
+# Queue Ownership
+
+- Orchestrator queue and per-agent queue responsibilities.
+
+# Trigger Kinds
+
+- User message, scheduled job, API event, mdkg queue event, runtime event, or
+  internal retry.
+
+# Sandbox Requirements
+
+- Lease refs, workspace bounds, cleanup, and metering requirements.
+
+# SecretGrant Requirements
+
+- Opaque refs and allowed consumers only.
+
+# Single-Writer Keys
+
+- Repo, graph, branch, or room keys that serialize writes.
+
+# Receipt Lifecycle
+
+- TriggerEvent contract.
+- AgentRun contract.
+- AttemptReceipt contract.
+- ValidationReceipt contract.
+- FinalReceipt contract.
+
+# Cancellation And Retry
+
+- Cancellation, retry, backoff, dead-letter, and finalization policy.
+
+# Telemetry Policy
+
+- Aggregate-safe stats and improvement proposals only unless a runtime spec says
+  otherwise.
+
+# Projection Targets
+
+- Local runtime agent manifest.
+- Workflow/runtime protocol manifest.
+- Downstream agent manifest owned outside mdkg canonical source.

package/dist/init/templates/specs/runtime-image.MANIFEST.md

@@ -0,0 +1,21 @@
+---
+extends: base.MANIFEST.md
+template_kind: runtime_image
+spec_kind: runtime_image
+---
+
+# Runtime Image
+
+Image name, digest policy, base image, and supported commands.
+
+# Resource Profile
+
+- CPU, memory, storage, network, and sandbox assumptions.
+
+# Secrets And Mounts
+
+- Opaque refs only; no raw secret values.
+
+# Conformance Checks
+
+- Build, scan, smoke, and cleanup proof.

package/dist/init/templates/specs/tool.MANIFEST.md

@@ -0,0 +1,25 @@
+---
+extends: base.MANIFEST.md
+template_kind: tool
+spec_kind: tool
+---
+
+# Tool Identity
+
+Name, command/API surface, and owner.
+
+# Allowed Operations
+
+- Operations and parameters.
+
+# Required Policy Context
+
+- Auth, sandbox, path, network, and secret boundaries.
+
+# Failure Modes
+
+- Expected errors and retry behavior.
+
+# Audit Events
+
+- Events or receipts emitted by tool use.

package/dist/util/argparse.js

@@ -15,7 +15,9 @@ const VALUE_FLAGS = new Set([
     "--edges",
     "--format",
     "--out",
+    "--json-out",
     "--output",
+    "--limit",
     "--relates",
     "--scope",
     "--blocked-by",
@@ -123,6 +125,7 @@ const BOOLEAN_FLAGS = new Set([
     "--dry-run",
     "--apply",
     "--json",
+    "--summary",
     "--xml",
     "--toon",
     "--md",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mdkg",
-  "version": "0.3.7",
-  "description": "Markdown Knowledge Graph",
+  "version": "0.3.9",
+  "description": "Git-native project memory for AI coding agents",
   "license": "MIT",
   "bin": {
     "mdkg": "dist/cli.js"
@@ -35,7 +35,23 @@
     "smoke:semantic-refs": "npm run build && node scripts/smoke-semantic-refs.js",
     "smoke:checkpoint-templates": "npm run build && node scripts/smoke-checkpoint-templates.js",
     "smoke:handoff": "npm run build && node scripts/smoke-handoff.js",
+    "smoke:warning-ux": "npm run build && node scripts/smoke-warning-ux.js",
     "smoke:integration-ux": "npm run build && node scripts/smoke-integration-ux.js",
+    "docs:generate": "npm run build && node scripts/generate-docs-reference.js --write && node scripts/generate-release-notes-data.js --write",
+    "docs:release-notes": "node scripts/generate-release-notes-data.js --write",
+    "docs:release-notes:check": "node scripts/generate-release-notes-data.js --check",
+    "docs:check": "npm run build && node scripts/generate-docs-reference.js --check && node scripts/generate-release-notes-data.js --check && node scripts/check-doc-command-examples.js",
+    "docs:check-commands": "npm run build && node scripts/check-doc-command-examples.js",
+    "smoke:mdkg-dev": "npm run build && node scripts/smoke-mdkg-dev.js",
+    "smoke:mdkg-dev-docs": "npm run build && node scripts/smoke-mdkg-dev-docs.js",
+    "smoke:mdkg-dev-seo": "npm run build && node scripts/smoke-mdkg-dev-seo.js",
+    "smoke:mdkg-dev-polish-pass2": "npm run build && node scripts/smoke-mdkg-dev-polish-pass2.js",
+    "smoke:mdkg-dev-polish-pass3": "npm run build && node scripts/smoke-mdkg-dev-polish-pass3.js",
+    "smoke:mdkg-dev-polish-pass4": "npm run build && node scripts/smoke-mdkg-dev-polish-pass4.js",
+    "smoke:mdkg-dev-polish-pass5": "npm run build && node scripts/smoke-mdkg-dev-polish-pass5.js",
+    "smoke:mdkg-dev-a11y": "npm run build && node scripts/smoke-mdkg-dev-a11y.js",
+    "smoke:mdkg-dev-perf": "npm run build && node scripts/smoke-mdkg-dev-perf.js",
+    "smoke:demo-graph": "npm run build && node scripts/smoke-demo-graph.js",
     "smoke:bundle": "npm run build && node scripts/smoke-bundle.js",
     "smoke:graph-clone": "npm run build && node scripts/smoke-graph-clone.js",
     "smoke:mcp": "npm run build && node scripts/smoke-mcp.js",
@@ -48,7 +64,7 @@
     "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 && 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:id-repair && npm run smoke:command-docs && npm run smoke:spike && npm run smoke:goal-lifecycle && npm run smoke:semantic-refs && npm run smoke:checkpoint-templates && npm run smoke:handoff && npm run smoke:integration-ux && npm run smoke:bundle && npm run smoke:graph-clone && npm run smoke:mcp && 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 && npm run docs: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:operator-health && npm run smoke:fix-plan && npm run smoke:branch-conflicts && npm run smoke:id-repair && npm run smoke:command-docs && npm run smoke:spike && npm run smoke:goal-lifecycle && npm run smoke:semantic-refs && npm run smoke:checkpoint-templates && npm run smoke:handoff && npm run smoke:warning-ux && npm run smoke:integration-ux && npm run smoke:mdkg-dev && npm run smoke:mdkg-dev-docs && npm run smoke:mdkg-dev-seo && npm run smoke:mdkg-dev-polish-pass2 && npm run smoke:mdkg-dev-polish-pass3 && npm run smoke:mdkg-dev-polish-pass4 && npm run smoke:mdkg-dev-polish-pass5 && npm run smoke:mdkg-dev-a11y && npm run smoke:mdkg-dev-perf && npm run smoke:demo-graph && npm run smoke:bundle && npm run smoke:graph-clone && npm run smoke:mcp && 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"
   },