@disclosureos/cli 1.0.0 → 1.1.0

package/CHANGELOG.md

@@ -4,11 +4,49 @@ All notable changes to `@disclosureos/cli` are documented here. The format is ba
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and this project adheres to
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## 1.1.0
+
+### Minor Changes
+
+- e6ff99c: Add the instruments layer: the UAP Sensor Manifest standard
+  (`@disclosureos/instruments@1.0.0`, first published alongside this release —
+  see its own changelog).
+
+  - **`@disclosureos/records`** — `SensorReading` gains optional `sensorRef`
+    (`"<org-slug>:<sensor-id>"`, with `sensorRef`/`isSensorRef`/`parseSensorRef`
+    helpers in `records/shared`); `SensorType` gains 18 instrument classes
+    (infrasonic/ultrasonic sensors, ADS-B receiver, RF spectrum analyzer, passive
+    radar, particle detector, atomic clock, GNSS receiver, fluxgate magnetometer,
+    air-quality sensor, barometer, lightning detector, IMU, EEG, GSR, pulse
+    oximeter, pupillometer, hardware RNG); `DetectionMethod` gains 7 methods
+    (particle, gnss, time_reference, chemical, inertial, physiological, pressure).
+    Records schema artifact bumped to `1.1.0`.
+  - **`@disclosureos/schema`** — composed enriched-observation artifact re-emitted
+    at `1.1.0` to carry the records changes.
+  - **`@disclosureos/cli`** — new `disclosureos manifest validate <path...>`
+    command (`--recursive`, `--json`) delegating to `validateSensorManifest`.
+
+### Patch Changes
+
+- c351793: `disclosureos validate` now warns when a `SensorReading.sensorRef` does not
+  match the `"<org-slug>:<sensor-id>"` manifest convention — mirroring the
+  existing malformed/dangling warnings for claim `evidenceRefs`.
+- Updated dependencies [b373962]
+- Updated dependencies [e6ff99c]
+- Updated dependencies [19bad3d]
+  - @disclosureos/instruments@1.0.0
+  - @disclosureos/records@1.1.0
+  - @disclosureos/schema@1.1.0
+  - @disclosureos/scoring@1.1.0
+  - @disclosureos/observables@1.0.1
+  - @disclosureos/origins@1.0.1
+
 ## 1.0.0
 
 Initial public release — developer tools for the DisclosureOS ecosystem.
 
 ### Added
+
 - `scaffold` — generate typed observation/data-structure templates.
 - `validate` — validate observation JSON files through `parseEnrichedObservation`;
   warns on dangling `evidenceRefs`.

package/dist/index.js

@@ -395,7 +395,7 @@ Generate typed templates for DisclosureOS data structures.
 }
 
 // src/commands/validate.ts
-import { parseEvidenceRef } from "@disclosureos/records/shared";
+import { parseEvidenceRef, isSensorRef } from "@disclosureos/records/shared";
 import { parseEnrichedObservation } from "@disclosureos/schema";
 function validate(args2) {
   if (args2.flags["help"]) {
@@ -503,7 +503,7 @@ function validateFileStructured(filePath, strict) {
   const obs = data;
   const structuralErrors = parseEnrichedObservation(obs).issues;
   const semanticErrors = validateSemantics(obs);
-  const warnings = [...validateEvidenceRefs(obs), ...strict ? validateStrict(obs) : []];
+  const warnings = [...validateEvidenceRefs(obs), ...validateSensorRefs(obs), ...strict ? validateStrict(obs) : []];
   const allErrors = [...structuralErrors, ...semanticErrors];
   return {
     file: filePath,
@@ -527,7 +527,7 @@ function validateFile(filePath, strict) {
   const obs = data;
   const structuralErrors = parseEnrichedObservation(obs).issues;
   const semanticErrors = validateSemantics(obs);
-  const warnings = [...validateEvidenceRefs(obs), ...strict ? validateStrict(obs) : []];
+  const warnings = [...validateEvidenceRefs(obs), ...validateSensorRefs(obs), ...strict ? validateStrict(obs) : []];
   const allErrors = [...structuralErrors, ...semanticErrors];
   if (allErrors.length > 0 || warnings.length > 0) {
     console.log(`
@@ -628,6 +628,25 @@ function validateEvidenceRefs(obs) {
   }
   return warnings;
 }
+function validateSensorRefs(obs) {
+  const warnings = [];
+  const sensorEvidence = obs["sensorEvidence"];
+  if (!sensorEvidence || typeof sensorEvidence !== "object") return warnings;
+  const sensors = sensorEvidence["sensors"];
+  if (!Array.isArray(sensors)) return warnings;
+  sensors.forEach((sensor, i) => {
+    if (!sensor || typeof sensor !== "object") return;
+    const ref = sensor["sensorRef"];
+    if (ref === void 0) return;
+    if (typeof ref !== "string" || !isSensorRef(ref)) {
+      warnings.push({
+        path: `sensorEvidence.sensors[${i}].sensorRef`,
+        message: `malformed sensor ref ${JSON.stringify(ref)} (expected "<org-slug>:<sensor-id>", e.g. "eldaeon:dionysus-passive-radar")`
+      });
+    }
+  });
+  return warnings;
+}
 function validateStrict(obs) {
   const warnings = [];
   const recommended = ["summary", "description", "objectCharacteristics", "sourceData", "witnesses"];
@@ -679,6 +698,7 @@ Validate observation JSON files against the full schema.
   console.log(`  \u2022 OCS node IDs in origin classifications (if present)`);
   console.log(`  \u2022 Unknown top-level keys rejected (third-party data belongs under "extensions")`);
   console.log(`  \u2022 Evidence refs on claims resolve to in-record evidence (warns on dangling)`);
+  console.log(`  \u2022 Sensor refs follow the "<org-slug>:<sensor-id>" manifest convention (warns on malformed)`);
   console.log(`  \u2022 Semantic sanity (non-negative duration, speed, counts)
 `);
   console.log(`${dim("Examples:")}`);
@@ -690,17 +710,142 @@ Validate observation JSON files against the full schema.
 `);
 }
 
+// src/commands/manifest.ts
+import { validateSensorManifest } from "@disclosureos/instruments";
+function manifest(args2) {
+  if (args2.flags["help"] || args2.subcommand !== "validate") {
+    printUsage3();
+    if (!args2.flags["help"] && args2.subcommand !== void 0 && args2.subcommand !== "validate") {
+      process.exit(1);
+    }
+    return;
+  }
+  const targets = args2.positional.filter((t) => !!t);
+  if (targets.length === 0) {
+    printUsage3();
+    return;
+  }
+  const recursive = !!args2.flags["recursive"];
+  const jsonMode = !!args2.flags["json"];
+  const files = [...new Set(targets.flatMap((target) => findJSONFiles(target, recursive)))];
+  if (files.length === 0) {
+    console.log(error(`No JSON files found at: ${targets.join(", ")}`));
+    process.exit(1);
+  }
+  const results = files.map(validateManifestFile);
+  if (jsonMode) {
+    const valid = results.every((result) => result.valid);
+    console.log(JSON.stringify({ files: results, valid }, null, 2));
+    if (!valid) process.exit(1);
+    return;
+  }
+  let failed = false;
+  for (const result of results) {
+    if (!result.valid) {
+      failed = true;
+      console.log(`
+${error(`${result.file} INVALID`)}`);
+      for (const issue of result.errors) {
+        console.log(`  ${error(`${issue.path}: ${issue.message}`)}`);
+      }
+      continue;
+    }
+    const summary = result.summary;
+    console.log(`
+${success(`${result.file}`)}`);
+    console.log(`  ${dim(formatManifestLine(summary))}`);
+    console.log(`  ${dim("by modality:")} ${Object.entries(summary.byModality).map(([m, n]) => `${m} ${n}`).join(", ")}`);
+    if (summary.proposedSensorTypes.length > 0) {
+      console.log(`  ${dim(`proposed sensor types (${summary.proposedSensorTypes.length}):`)} ${summary.proposedSensorTypes.join(", ")}`);
+    }
+    if (summary.proposedDetectionMethods.length > 0) {
+      console.log(`  ${dim(`proposed detection methods (${summary.proposedDetectionMethods.length}):`)} ${summary.proposedDetectionMethods.join(", ")}`);
+    }
+  }
+  console.log("");
+  if (failed) {
+    console.log(error(`Validation failed`));
+    process.exit(1);
+  }
+  console.log(success(`All ${files.length} manifest(s) valid`));
+}
+function formatManifestLine(summary) {
+  return `${summary.org} (${summary.orgSlug}) \u2014 ${summary.sensors} sensors, ${summary.futureUpgrades} future upgrades`;
+}
+function validateManifestFile(file) {
+  let data;
+  try {
+    data = readJSON(file);
+  } catch {
+    return { file, valid: false, errors: [{ path: "", message: "Failed to parse JSON" }] };
+  }
+  const issues = validateSensorManifest(data);
+  if (issues.length > 0) {
+    return { file, valid: false, errors: issues };
+  }
+  const parsed = data;
+  const byModality = {};
+  const proposedSensorTypes = [];
+  const proposedDetectionMethods = [];
+  for (const sensor of parsed.sensors) {
+    byModality[sensor.modality] = (byModality[sensor.modality] ?? 0) + 1;
+    if (sensor.recordsMapping?.proposedSensorType && sensor.recordsMapping.sensorType) {
+      proposedSensorTypes.push(sensor.recordsMapping.sensorType);
+    }
+    if (sensor.recordsMapping?.proposedDetectionMethod && sensor.recordsMapping.detectionMethod) {
+      proposedDetectionMethods.push(sensor.recordsMapping.detectionMethod);
+    }
+  }
+  return {
+    file,
+    valid: true,
+    errors: [],
+    summary: {
+      org: parsed.org,
+      orgSlug: parsed.orgSlug,
+      sensors: parsed.sensors.length,
+      byModality,
+      proposedSensorTypes,
+      proposedDetectionMethods,
+      futureUpgrades: parsed.futureUpgrades?.length ?? 0
+    }
+  };
+}
+function printUsage3() {
+  console.log(heading(`${BRAND} manifest`));
+  console.log(`
+Validate sensor-manifest JSON files (@disclosureos/instruments).
+`);
+  console.log(`${dim("Usage:")}`);
+  console.log(`  disclosureos manifest validate <path...> [options]
+`);
+  console.log(`${dim("Options:")}`);
+  console.log(`  --recursive, -r      Validate all JSON files in directories recursively`);
+  console.log(`  --json, -j           Output results as structured JSON (for CI and scripts)`);
+  console.log(`  --help, -h           Show this help message
+`);
+  console.log(`${dim("Validation checks:")}`);
+  console.log(`  \u2022 Manifest structure (org, orgSlug, sensors, calibration, timing, measurements)`);
+  console.log(`  \u2022 Sensor ids unique and kebab-case`);
+  console.log(`  \u2022 recordsMapping values exist in the records enums or carry proposed* flags
+`);
+  console.log(`${dim("Examples:")}`);
+  console.log(`  disclosureos manifest validate ./manifests/eldaeon-sensors.json`);
+  console.log(`  disclosureos manifest validate ./manifests/ --recursive --json
+`);
+}
+
 // src/commands/completeness.ts
 import { parseEnrichedObservation as parseEnrichedObservation2 } from "@disclosureos/schema";
 import { getCompleteness } from "@disclosureos/scoring";
 function completeness(args2) {
   if (args2.flags["help"]) {
-    printUsage3();
+    printUsage4();
     return;
   }
   const targets = [args2.subcommand, ...args2.positional].filter((t) => !!t);
   if (targets.length === 0) {
-    printUsage3();
+    printUsage4();
     return;
   }
   const recursive = !!args2.flags["recursive"];
@@ -866,7 +1011,7 @@ function scoreFileQuiet(filePath) {
     missing: comp.missing
   };
 }
-function printUsage3() {
+function printUsage4() {
   console.log(heading(`${BRAND} completeness`));
   console.log(`
 Measure how fully observation JSON files populate the records schema.
@@ -916,7 +1061,7 @@ import {
 } from "@disclosureos/origins";
 function registry(args2) {
   if (args2.flags["help"]) {
-    printUsage4();
+    printUsage5();
     return;
   }
   const sub = args2.subcommand;
@@ -931,7 +1076,7 @@ function registry(args2) {
       registryOrigins(args2);
       break;
     default:
-      printUsage4();
+      printUsage5();
   }
 }
 function registryFields(args2) {
@@ -1070,7 +1215,7 @@ ${label("ID", node.id)}`);
   }
   console.log("");
 }
-function printUsage4() {
+function printUsage5() {
   console.log(heading(`${BRAND} registry`));
   console.log(`
 Introspect DisclosureOS field, observable, and origin registries.
@@ -1110,7 +1255,7 @@ import {
 var FIELD_PATH_COUNT = deriveFieldPaths2().length;
 function info(args2) {
   if (args2.flags["help"]) {
-    printUsage5();
+    printUsage6();
     return;
   }
   const sub = args2.subcommand;
@@ -1257,7 +1402,7 @@ ${label("ID", node.id)}`);
   }
   console.log("");
 }
-function printUsage5() {
+function printUsage6() {
   console.log(heading(`${BRAND} info`));
   console.log(`
 Quick reference for DisclosureOS types and definitions.
@@ -1291,6 +1436,9 @@ if (args.flags["version"]) {
     case "validate":
       validate(args);
       break;
+    case "manifest":
+      manifest(args);
+      break;
     case "completeness":
       completeness(args);
       break;
@@ -1322,6 +1470,7 @@ function printHelp() {
   console.log(`${dim("Commands:")}`);
   console.log(`  scaffold       Generate typed data structure templates`);
   console.log(`  validate       Validate observation JSON files`);
+  console.log(`  manifest       Validate sensor-manifest JSON files`);
   console.log(`  completeness   Measure how fully observations populate the schema`);
   console.log(`  registry       Introspect field, observable, and origin registries`);
   console.log(`  info           Quick reference for types and definitions`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@disclosureos/cli",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Developer tools for the DisclosureOS ecosystem — scaffold, validate, and inspect observations",
   "license": "MIT",
   "repository": {
@@ -42,11 +42,12 @@
   ],
   "dependencies": {
     "picocolors": "^1.1.1",
-    "@disclosureos/records": "1.0.0",
-    "@disclosureos/observables": "1.0.0",
-    "@disclosureos/origins": "1.0.0",
-    "@disclosureos/schema": "1.0.0",
-    "@disclosureos/scoring": "1.0.0"
+    "@disclosureos/records": "1.1.0",
+    "@disclosureos/instruments": "1.0.0",
+    "@disclosureos/observables": "1.0.1",
+    "@disclosureos/scoring": "1.1.0",
+    "@disclosureos/origins": "1.0.1",
+    "@disclosureos/schema": "1.1.0"
   },
   "devDependencies": {
     "@types/node": "^20",