@0xsarwagya/ontoly-diagnostics 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Sarwagya
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,21 @@
+# @0xsarwagya/ontoly-diagnostics
+
+Shared diagnostic constructors for Ontoly.
+
+This package is part of [Ontoly](https://github.com/0xsarwagya/ontoly), a TypeScript-native software intelligence engine that builds a deterministic Software Graph.
+
+## Installation
+
+```bash
+pnpm add @0xsarwagya/ontoly-diagnostics
+```
+
+## Status
+
+Alpha package for Ontoly v0.1.0-alpha.1. The public API is versioned with the Software Graph and RFC process.
+
+## Links
+
+- [Repository](https://github.com/0xsarwagya/ontoly)
+- [Documentation](https://oss.sarwagya.wtf/ontoly)
+- [Issues](https://github.com/0xsarwagya/ontoly/issues)

package/dist/index.d.ts

@@ -0,0 +1,15 @@
+import { type DiagnosticSeverity, type JsonObject, type SoftwareGraphDiagnostic, type SourceSpan } from "@0xsarwagya/ontoly-core";
+export interface CreateDiagnosticInput {
+    readonly code: string;
+    readonly severity: DiagnosticSeverity;
+    readonly message: string;
+    readonly nodeId?: string | undefined;
+    readonly edgeId?: string | undefined;
+    readonly span?: SourceSpan | undefined;
+    readonly metadata?: JsonObject | undefined;
+}
+export declare function createDiagnostic(input: CreateDiagnosticInput): SoftwareGraphDiagnostic;
+export declare function brokenImportDiagnostic(file: string, specifier: string): SoftwareGraphDiagnostic;
+export declare function circularImportDiagnostic(path: readonly string[]): SoftwareGraphDiagnostic;
+export declare function lowConfidenceDiagnostic(message: string, metadata?: JsonObject): SoftwareGraphDiagnostic;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,UAAU,EACf,KAAK,uBAAuB,EAC5B,KAAK,UAAU,EAChB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CAC5C;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,qBAAqB,GAAG,uBAAuB,CAkBtF;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,uBAAuB,CAO/F;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,uBAAuB,CAOzF;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,UAAU,GACpB,uBAAuB,CAOzB"}

package/dist/index.js

@@ -0,0 +1,56 @@
+// src/index.ts
+import {
+  createDiagnosticId
+} from "@0xsarwagya/ontoly-core";
+function createDiagnostic(input) {
+  const location = input.span ? `${input.span.file}:${input.span.startLine}:${input.span.startColumn}` : input.nodeId ?? input.edgeId ?? "";
+  const base = {
+    id: createDiagnosticId(input.code, input.message, location),
+    code: input.code,
+    severity: input.severity,
+    message: input.message
+  };
+  return withOptionalDiagnosticProperties(base, {
+    nodeId: input.nodeId,
+    edgeId: input.edgeId,
+    span: input.span,
+    metadata: input.metadata
+  });
+}
+function brokenImportDiagnostic(file, specifier) {
+  return createDiagnostic({
+    code: "BROKEN_IMPORT",
+    severity: "warning",
+    message: `Could not resolve import "${specifier}" from ${file}.`,
+    metadata: { file, specifier }
+  });
+}
+function circularImportDiagnostic(path) {
+  return createDiagnostic({
+    code: "CIRCULAR_IMPORT",
+    severity: "warning",
+    message: `Circular import detected: ${path.join(" -> ")}.`,
+    metadata: { path: [...path] }
+  });
+}
+function lowConfidenceDiagnostic(message, metadata) {
+  return createDiagnostic({
+    code: "LOW_CONFIDENCE_INFERENCE",
+    severity: "info",
+    message,
+    metadata
+  });
+}
+function withOptionalDiagnosticProperties(target, optional) {
+  return {
+    ...target,
+    ...Object.fromEntries(Object.entries(optional).filter(([, value]) => value !== void 0))
+  };
+}
+export {
+  brokenImportDiagnostic,
+  circularImportDiagnostic,
+  createDiagnostic,
+  lowConfidenceDiagnostic
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import {\n  createDiagnosticId,\n  type DiagnosticSeverity,\n  type JsonObject,\n  type SoftwareGraphDiagnostic,\n  type SourceSpan,\n} from \"@0xsarwagya/ontoly-core\";\n\nexport interface CreateDiagnosticInput {\n  readonly code: string;\n  readonly severity: DiagnosticSeverity;\n  readonly message: string;\n  readonly nodeId?: string | undefined;\n  readonly edgeId?: string | undefined;\n  readonly span?: SourceSpan | undefined;\n  readonly metadata?: JsonObject | undefined;\n}\n\nexport function createDiagnostic(input: CreateDiagnosticInput): SoftwareGraphDiagnostic {\n  const location = input.span\n    ? `${input.span.file}:${input.span.startLine}:${input.span.startColumn}`\n    : input.nodeId ?? input.edgeId ?? \"\";\n\n  const base: SoftwareGraphDiagnostic = {\n    id: createDiagnosticId(input.code, input.message, location),\n    code: input.code,\n    severity: input.severity,\n    message: input.message,\n  };\n\n  return withOptionalDiagnosticProperties(base, {\n    nodeId: input.nodeId,\n    edgeId: input.edgeId,\n    span: input.span,\n    metadata: input.metadata,\n  });\n}\n\nexport function brokenImportDiagnostic(file: string, specifier: string): SoftwareGraphDiagnostic {\n  return createDiagnostic({\n    code: \"BROKEN_IMPORT\",\n    severity: \"warning\",\n    message: `Could not resolve import \"${specifier}\" from ${file}.`,\n    metadata: { file, specifier },\n  });\n}\n\nexport function circularImportDiagnostic(path: readonly string[]): SoftwareGraphDiagnostic {\n  return createDiagnostic({\n    code: \"CIRCULAR_IMPORT\",\n    severity: \"warning\",\n    message: `Circular import detected: ${path.join(\" -> \")}.`,\n    metadata: { path: [...path] },\n  });\n}\n\nexport function lowConfidenceDiagnostic(\n  message: string,\n  metadata?: JsonObject,\n): SoftwareGraphDiagnostic {\n  return createDiagnostic({\n    code: \"LOW_CONFIDENCE_INFERENCE\",\n    severity: \"info\",\n    message,\n    metadata,\n  });\n}\n\nfunction withOptionalDiagnosticProperties(\n  target: SoftwareGraphDiagnostic,\n  optional: Omit<SoftwareGraphDiagnostic, \"id\" | \"code\" | \"severity\" | \"message\">,\n): SoftwareGraphDiagnostic {\n  return {\n    ...target,\n    ...Object.fromEntries(Object.entries(optional).filter(([, value]) => value !== undefined)),\n  } as SoftwareGraphDiagnostic;\n}\n"],"mappings":";AAAA;AAAA,EACE;AAAA,OAKK;AAYA,SAAS,iBAAiB,OAAuD;AACtF,QAAM,WAAW,MAAM,OACnB,GAAG,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,WAAW,KACpE,MAAM,UAAU,MAAM,UAAU;AAEpC,QAAM,OAAgC;AAAA,IACpC,IAAI,mBAAmB,MAAM,MAAM,MAAM,SAAS,QAAQ;AAAA,IAC1D,MAAM,MAAM;AAAA,IACZ,UAAU,MAAM;AAAA,IAChB,SAAS,MAAM;AAAA,EACjB;AAEA,SAAO,iCAAiC,MAAM;AAAA,IAC5C,QAAQ,MAAM;AAAA,IACd,QAAQ,MAAM;AAAA,IACd,MAAM,MAAM;AAAA,IACZ,UAAU,MAAM;AAAA,EAClB,CAAC;AACH;AAEO,SAAS,uBAAuB,MAAc,WAA4C;AAC/F,SAAO,iBAAiB;AAAA,IACtB,MAAM;AAAA,IACN,UAAU;AAAA,IACV,SAAS,6BAA6B,SAAS,UAAU,IAAI;AAAA,IAC7D,UAAU,EAAE,MAAM,UAAU;AAAA,EAC9B,CAAC;AACH;AAEO,SAAS,yBAAyB,MAAkD;AACzF,SAAO,iBAAiB;AAAA,IACtB,MAAM;AAAA,IACN,UAAU;AAAA,IACV,SAAS,6BAA6B,KAAK,KAAK,MAAM,CAAC;AAAA,IACvD,UAAU,EAAE,MAAM,CAAC,GAAG,IAAI,EAAE;AAAA,EAC9B,CAAC;AACH;AAEO,SAAS,wBACd,SACA,UACyB;AACzB,SAAO,iBAAiB;AAAA,IACtB,MAAM;AAAA,IACN,UAAU;AAAA,IACV;AAAA,IACA;AAAA,EACF,CAAC;AACH;AAEA,SAAS,iCACP,QACA,UACyB;AACzB,SAAO;AAAA,IACL,GAAG;AAAA,IACH,GAAG,OAAO,YAAY,OAAO,QAAQ,QAAQ,EAAE,OAAO,CAAC,CAAC,EAAE,KAAK,MAAM,UAAU,MAAS,CAAC;AAAA,EAC3F;AACF;","names":[]}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@0xsarwagya/ontoly-diagnostics",
+  "version": "0.1.0-alpha.1",
+  "description": "Shared diagnostic constructors for Ontoly.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/0xsarwagya/ontoly.git",
+    "directory": "packages/diagnostics"
+  },
+  "homepage": "https://oss.sarwagya.wtf/ontoly",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@0xsarwagya/ontoly-core": "0.1.0-alpha.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.3",
+    "tsup": "^8.3.5",
+    "typescript": "5.9.2"
+  },
+  "bugs": {
+    "url": "https://github.com/0xsarwagya/ontoly/issues"
+  },
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/sponsors/0xsarwagya"
+  },
+  "engines": {
+    "node": ">=22.0.0",
+    "pnpm": ">=11.0.0"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "keywords": [
+    "ontoly",
+    "software-graph",
+    "typescript",
+    "static-analysis",
+    "developer-tools",
+    "diagnostics",
+    "graph-validation"
+  ],
+  "scripts": {
+    "build": "tsup && tsc -p tsconfig.build.json",
+    "check-types": "tsc --noEmit"
+  }
+}