@unrdf/diataxis-kit 26.4.2 → 26.4.4

package/ARTIFACTS/diataxis/@unrdf/daemon/diataxis.json

@@ -0,0 +1,270 @@
+{
+  "confidence": {
+    "explanation": 1,
+    "howtos": 0.75,
+    "reference": 0.7,
+    "tutorials": 1
+  },
+  "evidence": {
+    "docsFiles": [
+      "ECOSYSTEM-COMPOSITION-REPORT.md",
+      "INDEX.md",
+      "INTEGRATION-QUALITY-REPORT.md",
+      "INTEGRATION_COVERAGE_MATRIX.md",
+      "README.md",
+      "SECURITY_INTEGRATION_COMPLETE.md",
+      "SECURITY_VALIDATION_EXAMPLES.md",
+      "SLO-README.md",
+      "benchmarking.md",
+      "consensus-guide.md",
+      "dashboard-guide.md",
+      "e2e-jtbd-guide.md",
+      "error-path-scenarios.md",
+      "error-path-validation.md",
+      "explanation.md",
+      "federation-query-guide.md",
+      "hooks-policy-integration.md",
+      "how-to.md",
+      "integration-topology.md",
+      "kgc-4d-sourcing.md",
+      "knowledge-rules-guide.md",
+      "nitro-tasks-integration.md",
+      "observability-metrics.md",
+      "operational-runbooks.md",
+      "performance-tuning.md",
+      "production-deployment.md",
+      "receipts-merkle-audit.md",
+      "reference.md",
+      "security-audit.md",
+      "security-hardening.md",
+      "slo-constraint-analysis.md",
+      "slo-definitions.md",
+      "slo-monitoring-guide.md",
+      "slo-tracking-sheet.csv",
+      "tutorial.md",
+      "v6-deltagate-integration.md",
+      "yawl-error-handling.md",
+      "yawl-integration-coverage-matrix.md",
+      "yawl-integration-guide.md",
+      "yawl-patterns-cookbook.md",
+      "yawl-slo-definitions.md"
+    ],
+    "examplesFiles": [
+      "01-basic-daemon.mjs",
+      "01-basic-scheduled-workflow.mjs",
+      "01-basic.mjs",
+      "02-distributed-cluster.mjs",
+      "02-reactive-event-workflow.mjs",
+      "03-approval-workflow.mjs",
+      "03-event-sourcing.mjs",
+      "04-distributed-orchestration.mjs",
+      "05-policy-controlled-workflow.mjs",
+      "06-api-key-authentication.mjs",
+      "07-rate-limiting.mjs",
+      "07-security-hardening.mjs",
+      "nitro-app-integration.mjs"
+    ],
+    "fingerprint": "fb638e56ca96c2a4d66eeb8e6eb21b7925e9ccb63532f827132e302c8b136543",
+    "readmeHeadings": [
+      "Features",
+      "Installation",
+      "Quick Start",
+      "Core Components",
+      "Configuration",
+      "Events",
+      "Health & Metrics",
+      "Testing",
+      "Security",
+      "Integration Examples",
+      "Examples",
+      "Documentation",
+      "Package Exports",
+      "Performance",
+      "Quality Metrics",
+      "License"
+    ]
+  },
+  "explanation": {
+    "architecture": "Background daemon for managing scheduled tasks and event-driven operations in UNRDF with enterprise-grade security and comprehensive RDF integration.",
+    "concepts": [
+      "daemon",
+      "background-tasks",
+      "event-emitter",
+      "scheduling",
+      "task-queue"
+    ],
+    "confidenceScore": 1,
+    "id": "explanation-unrdf-daemon-explanation",
+    "source": [
+      "keywords",
+      "readme",
+      "docs",
+      "inferred"
+    ],
+    "title": "Understanding @unrdf/daemon",
+    "tradeoffs": [
+      "Ease of use vs. advanced configuration options",
+      "Memory usage vs. processing speed",
+      "Bundle size vs. feature completeness"
+    ]
+  },
+  "generatedAt": "2000-01-01T00:00:00.000Z",
+  "howtos": [
+    {
+      "confidenceScore": 1,
+      "context": "When you need to customize package behavior",
+      "id": "howto-configure-unrdf-daemon",
+      "source": [
+        "readme"
+      ],
+      "steps": [
+        "Create configuration file",
+        "Define configuration options",
+        "Apply configuration to package"
+      ],
+      "task": "Set up custom configuration for @unrdf/daemon",
+      "title": "Configure @unrdf/daemon"
+    },
+    {
+      "confidenceScore": 0.5,
+      "context": "When you need robust error handling in production",
+      "id": "howto-handle-errors",
+      "source": [
+        "tests"
+      ],
+      "steps": [
+        "Set up try-catch blocks",
+        "Handle common error types",
+        "Log errors appropriately"
+      ],
+      "task": "Implement error handling for @unrdf/daemon",
+      "title": "Handle Errors"
+    },
+    {
+      "confidenceScore": 0.7,
+      "context": "When working with daemon in your project",
+      "id": "howto-integrate-with-daemon",
+      "source": [
+        "keywords",
+        "inferred"
+      ],
+      "steps": [
+        "Install dependencies",
+        "Set up integration",
+        "Test integration"
+      ],
+      "task": "Connect @unrdf/daemon with daemon",
+      "title": "Integrate with daemon"
+    }
+  ],
+  "packageName": "@unrdf/daemon",
+  "reference": {
+    "confidenceScore": 1,
+    "id": "reference-unrdf-daemon-reference",
+    "items": [
+      {
+        "description": "Export: ./daemon",
+        "example": "import from \"./src/daemon.mjs\"",
+        "name": "./daemon",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./integrations/nitro-tasks",
+        "example": "import from \"./src/integrations/nitro-tasks.mjs\"",
+        "name": "./integrations/nitro-tasks",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./integrations/yawl",
+        "example": "import from \"./src/integrations/yawl.mjs\"",
+        "name": "./integrations/yawl",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./mcp",
+        "example": "import from \"./src/mcp/index.mjs\"",
+        "name": "./mcp",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./middleware/rate-limiter",
+        "example": "import from \"./src/middleware/rate-limiter.mjs\"",
+        "name": "./middleware/rate-limiter",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./middleware/rate-limiter-schema",
+        "example": "import from \"./src/middleware/rate-limiter.schema.mjs\"",
+        "name": "./middleware/rate-limiter-schema",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./schemas",
+        "example": "import from \"./src/schemas.mjs\"",
+        "name": "./schemas",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./trigger-evaluator",
+        "example": "import from \"./src/trigger-evaluator.mjs\"",
+        "name": "./trigger-evaluator",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./v6-deltagate",
+        "example": "import from \"./src/integrations/v6-deltagate.mjs\"",
+        "name": "./v6-deltagate",
+        "type": "export"
+      },
+      {
+        "description": "Export: .",
+        "example": "import from \"./src/index.mjs\"",
+        "name": "@unrdf/daemon",
+        "type": "export"
+      }
+    ],
+    "source": [
+      "exports"
+    ],
+    "title": "@unrdf/daemon Reference"
+  },
+  "tutorials": [
+    {
+      "confidenceScore": 0.8,
+      "goal": "Complete your first practical examples",
+      "id": "tutorial-first-steps",
+      "prerequisites": [
+        "Completed \"Getting Started with @unrdf/daemon\""
+      ],
+      "source": [
+        "examples"
+      ],
+      "stepsOutline": [
+        "Work through 01-basic-daemon.mjs",
+        "Work through 01-basic-scheduled-workflow.mjs",
+        "Work through 01-basic.mjs",
+        "Work through 02-distributed-cluster.mjs",
+        "Work through 02-reactive-event-workflow.mjs"
+      ],
+      "title": "First Steps"
+    },
+    {
+      "confidenceScore": 0.9999999999999999,
+      "goal": "Learn how to set up and use @unrdf/daemon in your project",
+      "id": "tutorial-getting-started-with-unrdf-daemon",
+      "prerequisites": [],
+      "source": [
+        "examples",
+        "readme",
+        "keywords"
+      ],
+      "stepsOutline": [
+        "Installation",
+        "Integration Examples",
+        "Examples"
+      ],
+      "title": "Getting Started with @unrdf/daemon"
+    }
+  ],
+  "version": "26.4.3"
+}

package/ARTIFACTS/diataxis/@unrdf/dark-matter/diataxis.json

@@ -0,0 +1,121 @@
+{
+  "confidence": {
+    "explanation": 0.4,
+    "howtos": 0.25,
+    "reference": 0.5,
+    "tutorials": 0.1
+  },
+  "evidence": {
+    "docsFiles": [],
+    "examplesFiles": [],
+    "fingerprint": "eb06e6f3d365e2084befa3c74eae7aa6cafe03ddbe0e68e2b1629b261a3a702d",
+    "readmeHeadings": []
+  },
+  "explanation": {
+    "architecture": "@unrdf/dark-matter is a package in the UNRDF ecosystem",
+    "concepts": [
+      "rdf",
+      "optimization",
+      "performance",
+      "sparql",
+      "80-20"
+    ],
+    "confidenceScore": 0.4,
+    "id": "explanation-unrdf-dark-matter-explanation",
+    "source": [
+      "keywords",
+      "inferred"
+    ],
+    "title": "Understanding @unrdf/dark-matter",
+    "tradeoffs": [
+      "Ease of use vs. advanced configuration options",
+      "Memory usage vs. processing speed",
+      "Bundle size vs. feature completeness"
+    ]
+  },
+  "generatedAt": "2000-01-01T00:00:00.000Z",
+  "howtos": [
+    {
+      "confidenceScore": 0.7,
+      "context": "When working with rdf in your project",
+      "id": "howto-integrate-with-rdf",
+      "source": [
+        "keywords",
+        "inferred"
+      ],
+      "steps": [
+        "Install dependencies",
+        "Set up integration",
+        "Test integration"
+      ],
+      "task": "Connect @unrdf/dark-matter with rdf",
+      "title": "Integrate with rdf"
+    },
+    {
+      "confidenceScore": 0.4,
+      "context": "When encountering issues during usage",
+      "id": "howto-troubleshoot-common-issues",
+      "source": [
+        "inferred"
+      ],
+      "steps": [
+        "Check configuration",
+        "Review error messages",
+        "Apply fixes"
+      ],
+      "task": "Resolve common problems and errors",
+      "title": "Troubleshoot Common Issues"
+    }
+  ],
+  "packageName": "@unrdf/dark-matter",
+  "reference": {
+    "confidenceScore": 1,
+    "id": "reference-unrdf-dark-matter-reference",
+    "items": [
+      {
+        "description": "Export: ./analyzer",
+        "example": "import from \"./src/analyzer.mjs\"",
+        "name": "./analyzer",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./optimizer",
+        "example": "import from \"./src/optimizer.mjs\"",
+        "name": "./optimizer",
+        "type": "export"
+      },
+      {
+        "description": "Export: .",
+        "example": "import from \"./src/index.mjs\"",
+        "name": "@unrdf/dark-matter",
+        "type": "export"
+      }
+    ],
+    "source": [
+      "exports"
+    ],
+    "title": "@unrdf/dark-matter Reference"
+  },
+  "tutorials": [
+    {
+      "confidenceScore": 0.1,
+      "goal": "Learn how to set up and use @unrdf/dark-matter in your project",
+      "id": "tutorial-getting-started-with-unrdf-dark-matter",
+      "prerequisites": [
+        "Basic RDF knowledge",
+        "Understanding of graph databases"
+      ],
+      "source": [
+        "keywords"
+      ],
+      "stepsOutline": [
+        "Install the package",
+        "Import required modules",
+        "Create a basic example",
+        "Run and verify output"
+      ],
+      "title": "Getting Started with @unrdf/dark-matter"
+    }
+  ],
+  "version": "26.4.3"
+}

package/ARTIFACTS/diataxis/@unrdf/decision-fabric/diataxis.json

@@ -0,0 +1,147 @@
+{
+  "confidence": {
+    "explanation": 0.7,
+    "howtos": 0.5,
+    "reference": 0.7,
+    "tutorials": 0.7
+  },
+  "evidence": {
+    "docsFiles": [],
+    "examplesFiles": [],
+    "fingerprint": "d12d9e248e6f8d14e069443a06351ee8fe8395b45f7d058e565558f0eeaad6d7",
+    "readmeHeadings": [
+      "Overview",
+      "Key Capabilities (2030 Vision)",
+      "Installation",
+      "Quick Start",
+      "Architecture",
+      "Big Bang 80/20 Methodology",
+      "Socratic AI Reasoning",
+      "Performance Targets",
+      "Integration with Existing Packages",
+      "Examples",
+      "Testing",
+      "Contributing",
+      "License",
+      "References"
+    ]
+  },
+  "explanation": {
+    "architecture": "The Decision Fabric implements the 2030 vision for eclipsing \"Database as Canvas\" whiteboards through mathematical inevitability.",
+    "concepts": [
+      "rdf",
+      "knowledge-graph",
+      "decision-support",
+      "hyperdimensional",
+      "mu-operators"
+    ],
+    "confidenceScore": 0.7,
+    "id": "explanation-unrdf-decision-fabric-explanation",
+    "source": [
+      "keywords",
+      "readme"
+    ],
+    "title": "Understanding @unrdf/decision-fabric",
+    "tradeoffs": [
+      "Performance vs. flexibility tradeoffs discussed in README"
+    ]
+  },
+  "generatedAt": "2000-01-01T00:00:00.000Z",
+  "howtos": [
+    {
+      "confidenceScore": 0.5,
+      "context": "When you need robust error handling in production",
+      "id": "howto-handle-errors",
+      "source": [
+        "tests"
+      ],
+      "steps": [
+        "Set up try-catch blocks",
+        "Handle common error types",
+        "Log errors appropriately"
+      ],
+      "task": "Implement error handling for @unrdf/decision-fabric",
+      "title": "Handle Errors"
+    },
+    {
+      "confidenceScore": 0.7,
+      "context": "When working with rdf in your project",
+      "id": "howto-integrate-with-rdf",
+      "source": [
+        "keywords",
+        "inferred"
+      ],
+      "steps": [
+        "Install dependencies",
+        "Set up integration",
+        "Test integration"
+      ],
+      "task": "Connect @unrdf/decision-fabric with rdf",
+      "title": "Integrate with rdf"
+    }
+  ],
+  "packageName": "@unrdf/decision-fabric",
+  "reference": {
+    "confidenceScore": 1,
+    "id": "reference-unrdf-decision-fabric-reference",
+    "items": [
+      {
+        "description": "Export: ./engine",
+        "example": "import from \"./src/engine.mjs\"",
+        "name": "./engine",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./operators",
+        "example": "import from \"./src/operators.mjs\"",
+        "name": "./operators",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./pareto",
+        "example": "import from \"./src/pareto-analyzer.mjs\"",
+        "name": "./pareto",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./socratic",
+        "example": "import from \"./src/socratic-agent.mjs\"",
+        "name": "./socratic",
+        "type": "export"
+      },
+      {
+        "description": "Export: .",
+        "example": "import from \"./src/index.mjs\"",
+        "name": "@unrdf/decision-fabric",
+        "type": "export"
+      }
+    ],
+    "source": [
+      "exports"
+    ],
+    "title": "@unrdf/decision-fabric Reference"
+  },
+  "tutorials": [
+    {
+      "confidenceScore": 0.4,
+      "goal": "Learn how to set up and use @unrdf/decision-fabric in your project",
+      "id": "tutorial-getting-started-with-unrdf-decision-fabric",
+      "prerequisites": [
+        "Basic RDF knowledge",
+        "Understanding of graph databases"
+      ],
+      "source": [
+        "readme",
+        "keywords"
+      ],
+      "stepsOutline": [
+        "Install the package",
+        "Import required modules",
+        "Create a basic example",
+        "Run and verify output"
+      ],
+      "title": "Getting Started with @unrdf/decision-fabric"
+    }
+  ],
+  "version": "26.4.3"
+}