@ontrails/adapter-kit 1.0.0-beta.19 → 1.0.0-beta.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ontrails/adapter-kit",
-  "version": "1.0.0-beta.19",
+  "version": "1.0.0-beta.22",
   "description": "Internal adapter authoring kit for Trails metadata, scaffolding, and checks.",
   "files": [
     "src/**/*.ts",

package/src/check.ts

@@ -46,6 +46,7 @@ export interface AdapterCheckDiagnostic {
 }
 
 export interface AdapterCheckSubject {
+  readonly adapterType?: string | undefined;
   readonly conformanceTestPaths: readonly string[];
   readonly key: string;
   readonly ownerPackage: string;
@@ -58,8 +59,36 @@ export interface AdapterCheckSubject {
   readonly testingImport?: string | undefined;
 }
 
+export type AdapterFactKind = 'available' | 'configured' | 'observed' | 'used';
+
+export type AdapterFactProvenanceSource =
+  | 'adapter-package-manifest'
+  | 'conformance-test'
+  | 'owner-package-manifest'
+  | 'runtime-observation';
+
+export interface AdapterFactProvenance {
+  readonly packageJsonPath?: string | undefined;
+  readonly paths?: readonly string[] | undefined;
+  readonly source: AdapterFactProvenanceSource;
+}
+
+export interface AdapterFact {
+  readonly adapterType?: string | undefined;
+  readonly key: string;
+  readonly kind: AdapterFactKind;
+  readonly ownerPackage?: string | undefined;
+  readonly packageName?: string | undefined;
+  readonly placement?: AdapterTargetPlacement | undefined;
+  readonly placements?: readonly AdapterTargetPlacement[] | undefined;
+  readonly provenance: AdapterFactProvenance;
+  readonly target: string;
+  readonly targetKey?: string | undefined;
+}
+
 export interface AdapterCheckReport {
   readonly diagnostics: readonly AdapterCheckDiagnostic[];
+  readonly facts: readonly AdapterFact[];
   readonly subjects: readonly AdapterCheckSubject[];
   readonly targets: readonly AdapterTargetCatalogEntry[];
 }
@@ -323,6 +352,64 @@ const targetEntriesByTarget = (
 ): ReadonlyMap<string, AdapterTargetCatalogEntry> =>
   new Map(targets.map((target) => [target.target, target]));
 
+const adapterFacts = (
+  targets: readonly AdapterTargetCatalogEntry[],
+  subjects: readonly AdapterCheckSubject[]
+): readonly AdapterFact[] => {
+  const facts: AdapterFact[] = [];
+
+  for (const target of targets) {
+    facts.push({
+      key: `${target.key}:available`,
+      kind: 'available',
+      ownerPackage: target.ownerPackage,
+      placements: target.placements,
+      provenance: {
+        packageJsonPath: target.packageJsonPath,
+        source: 'owner-package-manifest',
+      },
+      target: target.target,
+      targetKey: target.key,
+    });
+  }
+
+  for (const subject of subjects) {
+    facts.push({
+      key: `${subject.key}:${subject.target}:configured`,
+      kind: 'configured',
+      ownerPackage: subject.ownerPackage,
+      packageName: subject.packageName,
+      placement: subject.placement,
+      provenance: {
+        packageJsonPath: subject.packageJsonPath,
+        source: 'adapter-package-manifest',
+      },
+      target: subject.target,
+      targetKey: subject.targetKey,
+      ...(subject.adapterType ? { adapterType: subject.adapterType } : {}),
+    });
+
+    if (subject.conformanceTestPaths.length > 0) {
+      facts.push({
+        key: `${subject.key}:${subject.target}:used`,
+        kind: 'used',
+        ownerPackage: subject.ownerPackage,
+        packageName: subject.packageName,
+        placement: subject.placement,
+        provenance: {
+          paths: subject.conformanceTestPaths,
+          source: 'conformance-test',
+        },
+        target: subject.target,
+        targetKey: subject.targetKey,
+        ...(subject.adapterType ? { adapterType: subject.adapterType } : {}),
+      });
+    }
+  }
+
+  return facts;
+};
+
 const collectSourceFiles = (dir: string): readonly string[] => {
   if (!existsSync(dir)) {
     return [];
@@ -2033,6 +2120,9 @@ const checkAdapterPackage = (
       placement,
       target: targetEntry.target,
       targetKey: targetEntry.key,
+      ...(conformance?.adapterType
+        ? { adapterType: conformance.adapterType }
+        : {}),
       ...(testingImport ? { testingImport } : {}),
     },
   };
@@ -2054,11 +2144,14 @@ export const checkAdapters = (rootDir: string): AdapterCheckReport => {
     }
   }
 
+  const sortedSubjects = subjects.toSorted((left, right) =>
+    left.key.localeCompare(right.key)
+  );
+
   return {
     diagnostics,
-    subjects: subjects.toSorted((left, right) =>
-      left.key.localeCompare(right.key)
-    ),
+    facts: adapterFacts(catalog.targets, sortedSubjects),
+    subjects: sortedSubjects,
     targets: catalog.targets,
   };
 };

package/src/index.ts

@@ -3,6 +3,10 @@ export type {
   AdapterCheckDiagnostic,
   AdapterCheckDiagnosticCode,
   AdapterCheckDiagnosticSeverity,
+  AdapterFact,
+  AdapterFactKind,
+  AdapterFactProvenance,
+  AdapterFactProvenanceSource,
   AdapterCheckReport,
   AdapterCheckSubject,
 } from './check.js';