@unrdf/diataxis-kit 26.4.2 → 26.4.3

package/ARTIFACTS/diataxis/@unrdf/diataxis-kit/diataxis.json

@@ -0,0 +1,189 @@
+{
+  "confidence": {
+    "explanation": 0.7,
+    "howtos": 0.75,
+    "reference": 1,
+    "tutorials": 0.7
+  },
+  "evidence": {
+    "docsFiles": [],
+    "examplesFiles": [],
+    "fingerprint": "410a70a81597362404956b27666aad623a9f8d5e00c11394a1d7beff88cd96b5",
+    "readmeHeadings": [
+      "Features",
+      "Quick Start",
+      "File Structure",
+      "How It Works",
+      "Determinism",
+      "Testing",
+      "Package Exports",
+      "CLI Tools",
+      "Example Output",
+      "Implementation Details",
+      "Constraints",
+      "Performance",
+      "Future Improvements",
+      "License"
+    ]
+  },
+  "explanation": {
+    "architecture": "Diátaxis documentation kit for monorepo package inventory and deterministic doc scaffold generation. Automatically discovers all workspace packages and generates documentation scaffolds using the Diátaxis framework (Tutorials, How-to Guides, Reference, Explanation).",
+    "concepts": [
+      "diataxis",
+      "documentation",
+      "monorepo",
+      "inventory"
+    ],
+    "confidenceScore": 0.7,
+    "id": "explanation-unrdf-diataxis-kit-explanation",
+    "source": [
+      "keywords",
+      "readme"
+    ],
+    "title": "Understanding @unrdf/diataxis-kit",
+    "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/diataxis-kit",
+      "title": "Handle Errors"
+    },
+    {
+      "confidenceScore": 0.7,
+      "context": "When working with diataxis in your project",
+      "id": "howto-integrate-with-diataxis",
+      "source": [
+        "keywords",
+        "inferred"
+      ],
+      "steps": [
+        "Install dependencies",
+        "Set up integration",
+        "Test integration"
+      ],
+      "task": "Connect @unrdf/diataxis-kit with diataxis",
+      "title": "Integrate with diataxis"
+    },
+    {
+      "confidenceScore": 1,
+      "context": "When you need to use the package from the command line",
+      "id": "howto-use-the-cli",
+      "source": [
+        "bin"
+      ],
+      "steps": [
+        "Install package globally or locally",
+        "Run CLI command with options",
+        "Process command output"
+      ],
+      "task": "Execute diataxis-run command-line interface",
+      "title": "Use the CLI"
+    }
+  ],
+  "packageName": "@unrdf/diataxis-kit",
+  "reference": {
+    "confidenceScore": 1,
+    "id": "reference-unrdf-diataxis-kit-reference",
+    "items": [
+      {
+        "description": "Export: ./classify",
+        "example": "import from \"./src/classify.mjs\"",
+        "name": "./classify",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./evidence",
+        "example": "import from \"./src/evidence.mjs\"",
+        "name": "./evidence",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./hash",
+        "example": "import from \"./src/hash.mjs\"",
+        "name": "./hash",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./inventory",
+        "example": "import from \"./src/inventory.mjs\"",
+        "name": "./inventory",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./scaffold",
+        "example": "import from \"./src/scaffold.mjs\"",
+        "name": "./scaffold",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./stable-json",
+        "example": "import from \"./src/stable-json.mjs\"",
+        "name": "./stable-json",
+        "type": "export"
+      },
+      {
+        "description": "Export: .",
+        "example": "import from \"./src/index.mjs\"",
+        "name": "@unrdf/diataxis-kit",
+        "type": "export"
+      },
+      {
+        "description": "CLI command: diataxis-report",
+        "example": "diataxis-report [options]",
+        "name": "diataxis-report",
+        "type": "bin"
+      },
+      {
+        "description": "CLI command: diataxis-run",
+        "example": "diataxis-run [options]",
+        "name": "diataxis-run",
+        "type": "bin"
+      },
+      {
+        "description": "CLI command: diataxis-verify",
+        "example": "diataxis-verify [options]",
+        "name": "diataxis-verify",
+        "type": "bin"
+      }
+    ],
+    "source": [
+      "exports",
+      "bin"
+    ],
+    "title": "@unrdf/diataxis-kit Reference"
+  },
+  "tutorials": [
+    {
+      "confidenceScore": 0.4,
+      "goal": "Learn how to set up and use @unrdf/diataxis-kit in your project",
+      "id": "tutorial-getting-started-with-unrdf-diataxis-kit",
+      "prerequisites": [],
+      "source": [
+        "readme",
+        "keywords"
+      ],
+      "stepsOutline": [
+        "Install the package",
+        "Import required modules",
+        "Create a basic example",
+        "Run and verify output"
+      ],
+      "title": "Getting Started with @unrdf/diataxis-kit"
+    }
+  ],
+  "version": "26.4.2"
+}

package/ARTIFACTS/diataxis/@unrdf/docs-site/diataxis.json

@@ -0,0 +1,100 @@
+{
+  "confidence": {
+    "explanation": 0,
+    "howtos": 0,
+    "reference": 0,
+    "tutorials": 0
+  },
+  "evidence": {
+    "docsFiles": [],
+    "examplesFiles": [],
+    "fingerprint": "eb06e6f3d365e2084befa3c74eae7aa6cafe03ddbe0e68e2b1629b261a3a702d",
+    "readmeHeadings": []
+  },
+  "explanation": {
+    "architecture": "@unrdf/docs-site is a package in the UNRDF ecosystem",
+    "concepts": [
+      "core functionality"
+    ],
+    "confidenceScore": 0,
+    "id": "explanation-unrdf-docs-site-explanation",
+    "source": [
+      "inferred"
+    ],
+    "title": "Understanding @unrdf/docs-site",
+    "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.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"
+    },
+    {
+      "confidenceScore": 0.4,
+      "context": "When you need to accomplish common tasks",
+      "id": "howto-use-unrdf-docs-site",
+      "source": [
+        "inferred"
+      ],
+      "steps": [
+        "Import the package",
+        "Initialize with options",
+        "Execute operations"
+      ],
+      "task": "Perform basic operations with @unrdf/docs-site",
+      "title": "Use @unrdf/docs-site"
+    }
+  ],
+  "packageName": "@unrdf/docs-site",
+  "reference": {
+    "confidenceScore": 0.5,
+    "id": "reference-unrdf-docs-site-reference",
+    "items": [
+      {
+        "description": "Reference documentation to be added",
+        "example": null,
+        "name": "unknown",
+        "type": "unknown"
+      }
+    ],
+    "source": [
+      "inferred"
+    ],
+    "title": "@unrdf/docs-site Reference"
+  },
+  "tutorials": [
+    {
+      "confidenceScore": 0,
+      "goal": "Learn how to set up and use @unrdf/docs-site in your project",
+      "id": "tutorial-getting-started-with-unrdf-docs-site",
+      "prerequisites": [],
+      "source": [
+        "inferred"
+      ],
+      "stepsOutline": [
+        "Install the package",
+        "Import required modules",
+        "Create a basic example",
+        "Run and verify output"
+      ],
+      "title": "Getting Started with @unrdf/docs-site"
+    }
+  ],
+  "version": "1.0.0"
+}

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

@@ -0,0 +1,107 @@
+{
+  "confidence": {
+    "explanation": 0.4,
+    "howtos": 0.25,
+    "reference": 0.5,
+    "tutorials": 0.1
+  },
+  "evidence": {
+    "docsFiles": [],
+    "examplesFiles": [],
+    "fingerprint": "eb06e6f3d365e2084befa3c74eae7aa6cafe03ddbe0e68e2b1629b261a3a702d",
+    "readmeHeadings": []
+  },
+  "explanation": {
+    "architecture": "@unrdf/domain is a package in the UNRDF ecosystem",
+    "concepts": [
+      "rdf",
+      "domain",
+      "models",
+      "types"
+    ],
+    "confidenceScore": 0.4,
+    "id": "explanation-unrdf-domain-explanation",
+    "source": [
+      "keywords",
+      "inferred"
+    ],
+    "title": "Understanding @unrdf/domain",
+    "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/domain 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/domain",
+  "reference": {
+    "confidenceScore": 1,
+    "id": "reference-unrdf-domain-reference",
+    "items": [
+      {
+        "description": "Export: .",
+        "example": "import from \"./src/index.mjs\"",
+        "name": "@unrdf/domain",
+        "type": "export"
+      }
+    ],
+    "source": [
+      "exports"
+    ],
+    "title": "@unrdf/domain Reference"
+  },
+  "tutorials": [
+    {
+      "confidenceScore": 0.1,
+      "goal": "Learn how to set up and use @unrdf/domain in your project",
+      "id": "tutorial-getting-started-with-unrdf-domain",
+      "prerequisites": [
+        "Basic RDF knowledge"
+      ],
+      "source": [
+        "keywords"
+      ],
+      "stepsOutline": [
+        "Install the package",
+        "Import required modules",
+        "Create a basic example",
+        "Run and verify output"
+      ],
+      "title": "Getting Started with @unrdf/domain"
+    }
+  ],
+  "version": "26.4.2"
+}

package/ARTIFACTS/diataxis/@unrdf/engine-gateway/diataxis.json

@@ -0,0 +1,127 @@
+{
+  "confidence": {
+    "explanation": 0.4,
+    "howtos": 0.25,
+    "reference": 0.5,
+    "tutorials": 0.1
+  },
+  "evidence": {
+    "docsFiles": [],
+    "examplesFiles": [],
+    "fingerprint": "eb06e6f3d365e2084befa3c74eae7aa6cafe03ddbe0e68e2b1629b261a3a702d",
+    "readmeHeadings": []
+  },
+  "explanation": {
+    "architecture": "@unrdf/engine-gateway is a package in the UNRDF ecosystem",
+    "concepts": [
+      "rdf",
+      "gateway",
+      "oxigraph",
+      "enforcement",
+      "validation"
+    ],
+    "confidenceScore": 0.4,
+    "id": "explanation-unrdf-engine-gateway-explanation",
+    "source": [
+      "keywords",
+      "inferred"
+    ],
+    "title": "Understanding @unrdf/engine-gateway",
+    "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/engine-gateway 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/engine-gateway",
+  "reference": {
+    "confidenceScore": 1,
+    "id": "reference-unrdf-engine-gateway-reference",
+    "items": [
+      {
+        "description": "Export: ./gateway",
+        "example": "import from \"./src/gateway.mjs\"",
+        "name": "./gateway",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./operation-detector",
+        "example": "import from \"./src/operation-detector.mjs\"",
+        "name": "./operation-detector",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./validators",
+        "example": "import from \"./src/validators.mjs\"",
+        "name": "./validators",
+        "type": "export"
+      },
+      {
+        "description": "Export: .",
+        "example": "import from \"./src/index.mjs\"",
+        "name": "@unrdf/engine-gateway",
+        "type": "export"
+      }
+    ],
+    "source": [
+      "exports"
+    ],
+    "title": "@unrdf/engine-gateway Reference"
+  },
+  "tutorials": [
+    {
+      "confidenceScore": 0.1,
+      "goal": "Learn how to set up and use @unrdf/engine-gateway in your project",
+      "id": "tutorial-getting-started-with-unrdf-engine-gateway",
+      "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/engine-gateway"
+    }
+  ],
+  "version": "26.4.2"
+}

package/ARTIFACTS/diataxis/@unrdf/event-automation/diataxis.json

@@ -0,0 +1,154 @@
+{
+  "confidence": {
+    "explanation": 0.7,
+    "howtos": 0.5,
+    "reference": 0.5,
+    "tutorials": 0.7
+  },
+  "evidence": {
+    "docsFiles": [],
+    "examplesFiles": [],
+    "fingerprint": "9050ef5ee62a84b468260a03b82a59e5919f702ba7ef4381a2596fc36ebcf085",
+    "readmeHeadings": [
+      "Features",
+      "Installation",
+      "Quick Start",
+      "Core Components",
+      "Policy Triggers",
+      "Event Replay",
+      "Performance Targets",
+      "Statistics & Monitoring",
+      "Error Handling",
+      "Integration with V6-Core",
+      "Testing",
+      "License",
+      "Contributing"
+    ]
+  },
+  "explanation": {
+    "architecture": "Event-driven automation for UNRDF v6.1.0 with automatic delta processing, receipt generation, and policy enforcement.",
+    "concepts": [
+      "unrdf",
+      "event-automation",
+      "delta-processing",
+      "receipts",
+      "hooks"
+    ],
+    "confidenceScore": 0.7,
+    "id": "explanation-unrdf-event-automation-explanation",
+    "source": [
+      "keywords",
+      "readme",
+      "inferred"
+    ],
+    "title": "Understanding @unrdf/event-automation",
+    "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.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/event-automation",
+      "title": "Handle Errors"
+    },
+    {
+      "confidenceScore": 0.7,
+      "context": "When working with unrdf in your project",
+      "id": "howto-integrate-with-unrdf",
+      "source": [
+        "keywords",
+        "inferred"
+      ],
+      "steps": [
+        "Install dependencies",
+        "Set up integration",
+        "Test integration"
+      ],
+      "task": "Connect @unrdf/event-automation with unrdf",
+      "title": "Integrate with unrdf"
+    }
+  ],
+  "packageName": "@unrdf/event-automation",
+  "reference": {
+    "confidenceScore": 1,
+    "id": "reference-unrdf-event-automation-reference",
+    "items": [
+      {
+        "description": "Export: ./delta-processor",
+        "example": "import from \"./src/delta-processor.mjs\"",
+        "name": "./delta-processor",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./engine",
+        "example": "import from \"./src/event-automation-engine.mjs\"",
+        "name": "./engine",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./policy-enforcer",
+        "example": "import from \"./src/policy-enforcer.mjs\"",
+        "name": "./policy-enforcer",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./receipt-tracker",
+        "example": "import from \"./src/receipt-tracker.mjs\"",
+        "name": "./receipt-tracker",
+        "type": "export"
+      },
+      {
+        "description": "Export: ./schemas",
+        "example": "import from \"./src/schemas.mjs\"",
+        "name": "./schemas",
+        "type": "export"
+      },
+      {
+        "description": "Export: .",
+        "example": "import from \"./src/index.mjs\"",
+        "name": "@unrdf/event-automation",
+        "type": "export"
+      }
+    ],
+    "source": [
+      "exports"
+    ],
+    "title": "@unrdf/event-automation Reference"
+  },
+  "tutorials": [
+    {
+      "confidenceScore": 0.4,
+      "goal": "Learn how to set up and use @unrdf/event-automation in your project",
+      "id": "tutorial-getting-started-with-unrdf-event-automation",
+      "prerequisites": [
+        "Basic RDF knowledge"
+      ],
+      "source": [
+        "readme",
+        "keywords"
+      ],
+      "stepsOutline": [
+        "Install the package",
+        "Import required modules",
+        "Create a basic example",
+        "Run and verify output"
+      ],
+      "title": "Getting Started with @unrdf/event-automation"
+    }
+  ],
+  "version": "26.4.2"
+}