mdkg 0.1.10 → 0.2.0

package/dist/init/templates/specs/base.SPEC.md

@@ -0,0 +1,87 @@
+---
+id: {{spec_id}}
+type: spec
+title: {{title}}
+version: 0.1.0
+role: subagent
+runtime_mode: room_orchestrated
+work_contracts: []
+requested_capabilities: []
+skill_refs: []
+tool_refs: []
+model_refs: []
+wasm_component_refs: []
+runtime_image_refs: []
+subagent_refs: []
+resource_profile: builder
+update_policy: manual
+tags: [spec]
+owners: []
+links: []
+artifacts: []
+relates: []
+refs: []
+aliases: []
+created: {{created}}
+updated: {{updated}}
+---
+
+# Identity
+
+Name, stable id, owner, status, and source mdkg nodes.
+
+# Purpose
+
+What durable capability or contract this SPEC defines.
+
+# Scope
+
+Included behavior and resources.
+
+# Non-goals
+
+What this SPEC explicitly does not define.
+
+# Resource URIs
+
+- Optional draft URI: `omni://resource/...`
+
+# Capabilities
+
+- Capability id and optional draft URI: `omni://capability/...`
+
+# Inputs
+
+- Required input contract.
+
+# Outputs
+
+- Required output or receipt contract.
+
+# Dependencies
+
+- Other specs, skills, tools, models, services, or runtime images.
+
+# Security Boundaries
+
+- Authority, secret, data, and mutation boundaries.
+
+# Validation Checks
+
+- Commands or review checks.
+
+# Closeout Evidence
+
+- Evidence required to accept this SPEC or implementation.
+
+# Projection Targets
+
+- `.codex/agents`, runtime manifest, package, API, or protocol projection.
+
+# Versioning
+
+- Compatibility and change policy.
+
+# Open Questions
+
+- Decision needed before implementation.

package/dist/init/templates/specs/capability.SPEC.md

@@ -0,0 +1,32 @@
+---
+extends: base.SPEC.md
+template_kind: capability
+---
+
+# Capability Name
+
+Stable mdkg capability id.
+
+# Draft Omni URI
+
+Optional: `omni://capability/...`
+
+# Resource Types
+
+- Optional draft resource URI: `omni://resource/...`
+
+# Allowed Principals
+
+- Roles or agents allowed to use this capability.
+
+# Delegation Rules
+
+- Whether and how the capability can be delegated.
+
+# Revocation Rules
+
+- Conditions that revoke or disable the capability.
+
+# Audit Events
+
+- Receipts, summaries, or metrics created by use.

package/dist/init/templates/specs/integration.SPEC.md

@@ -0,0 +1,24 @@
+---
+extends: base.SPEC.md
+template_kind: integration
+---
+
+# Integration Boundary
+
+Systems, repos, protocols, and ownership split.
+
+# Data Flow
+
+- Inputs, outputs, transformations, and receipts.
+
+# Failure And Retry
+
+- Retry, idempotency, dead-letter, and cleanup policy.
+
+# Security
+
+- Auth, secret refs, network, and data minimization.
+
+# Conformance
+
+- Contract tests and fixture expectations.

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

@@ -0,0 +1,20 @@
+---
+extends: base.SPEC.md
+template_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/omniruntime-agent.SPEC.md

@@ -0,0 +1,39 @@
+---
+extends: agent.SPEC.md
+template_kind: omniruntime_agent
+---
+
+# Queue Ownership
+
+- Orchestrator queue and per-agent queue responsibilities.
+
+# Trigger Kinds
+
+- User message, scheduled job, API event, mdkg queue 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.
+
+# Receipts
+
+- 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.

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

@@ -0,0 +1,26 @@
+---
+extends: base.SPEC.md
+template_kind: project
+---
+
+# Project Role
+
+Describe the repo/service responsibility and non-authorities.
+
+# Canonical Repo
+
+- Local path:
+- Remote:
+- Default branch:
+
+# Owned Capabilities
+
+- Capability ids and optional draft Omni URIs.
+
+# Integration Boundaries
+
+- Upstream/downstream repos and APIs.
+
+# Validation Checks
+
+- Build, test, mdkg, security, and release gates.

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

@@ -0,0 +1,20 @@
+---
+extends: base.SPEC.md
+template_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.SPEC.md

@@ -0,0 +1,24 @@
+---
+extends: base.SPEC.md
+template_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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mdkg",
-  "version": "0.1.10",
+  "version": "0.2.0",
   "description": "Markdown Knowledge Graph",
   "license": "MIT",
   "bin": {
@@ -18,6 +18,7 @@
     "smoke:capabilities": "npm run build && node scripts/smoke-capabilities.js",
     "smoke:db": "npm run build && node scripts/smoke-db.js",
     "smoke:db-queue": "npm run build && node scripts/smoke-db-queue.js",
+    "smoke:db-queue-cli": "npm run build && node scripts/smoke-db-queue-cli.js",
     "smoke:db-events": "npm run build && node scripts/smoke-db-events.js",
     "smoke:db-materializer": "npm run build && node scripts/smoke-db-materializer.js",
     "smoke:db-snapshot": "npm run build && node scripts/smoke-db-snapshot.js",
@@ -31,7 +32,7 @@
     "cli:snapshot": "npm run build && node scripts/cli_help_snapshot.js",
     "cli:check": "npm run build && node scripts/cli_help_snapshot.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-events && npm run smoke:db-materializer && npm run smoke:db-snapshot && npm run smoke:archive-work && 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 && 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: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"
   },