@aioschema/cli 0.5.5

package/LICENSE.md

@@ -0,0 +1,42 @@
+# License
+
+---
+
+## AIOSchema Specification
+
+The AIOSchema v0.5.5 Specification is published under the **Creative Commons Attribution 4.0 International (CC-BY 4.0)** license.
+
+You are free to implement the specification in any language, for any purpose, including commercial use, provided you include attribution to AIOSchema.
+
+Full text: https://creativecommons.org/licenses/by/4.0/  
+Specification: https://aioschema.org
+
+---
+
+## Reference Implementations
+
+The Python, TypeScript, Node.js, Go, and Rust reference implementations of AIOSchema are open source, licensed under the **Apache License 2.0**.
+
+```
+Copyright 2026 Ovidiu Ancuta / AIOSchema Contributors
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    https://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.
+```
+
+---
+
+## Attribution
+
+AIOSchema is authored and maintained by Ovidiu Ancuta.  
+Website: https://aioschema.org  
+Hub: https://aioschemahub.com

package/README.md

@@ -0,0 +1,64 @@
+# @aioschema/cli
+
+**AIOSchema v0.5.5 — Command-line tool for generating and verifying provenance manifests.**
+
+- Spec: [aioschema.org](https://aioschema.org)
+- Hub: [aioschemahub.com](https://aioschemahub.com)
+
+---
+
+## Install
+
+```bash
+npm install -g @aioschema/cli
+```
+
+---
+
+## Usage
+
+```bash
+# Generate a manifest for any file
+aioschema generate myfile.pdf
+
+# Generate with SHA-384
+aioschema generate myfile.pdf --algorithm sha384
+
+# Generate with your creator ID
+aioschema generate myfile.pdf --creator-id ed25519-fp-ebc64203390ddefc442ade9038e1ae18
+
+# Verify a file against its manifest
+aioschema verify myfile.pdf myfile.pdf.aios.json
+
+# Help
+aioschema --help
+
+# Version
+aioschema --version
+```
+
+---
+
+## What it produces
+
+Running `aioschema generate` writes a `.aios.json` manifest alongside your file:
+
+```
+myfile.pdf
+myfile.pdf.aios.json   ← manifest
+```
+
+The manifest cryptographically describes your file — what it is, when it existed, and who created it. Verifiable forever by any conforming AIOSchema implementation.
+
+---
+
+## Library
+
+For programmatic use, see [@aioschema/js](../implementations/js/README.md).
+
+---
+
+## License
+
+Apache 2.0. See [LICENSE.md](./LICENSE.md).  
+Specification: CC-BY 4.0 — [aioschema.org](https://aioschema.org)

package/cli.js

@@ -0,0 +1,165 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * AIOSchema v0.5.5 — CLI
+ * ======================
+ * Usage:
+ *   aioschema generate <file> [--algorithm sha256|sha384] [--creator-id <id>]
+ *   aioschema verify <file> <manifest.aios.json>
+ *   aioschema --version
+ *   aioschema --help
+ */
+
+const fs   = require("node:fs");
+const path = require("node:path");
+const aios = require("./aioschema_v055.js");
+
+const { generateManifest, verifyManifest, sidecarPath, SPEC_VERSION } = aios;
+
+// ── Argument parsing ──────────────────────────────────────────────────────────
+
+const args = process.argv.slice(2);
+
+if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
+  printHelp();
+  process.exit(0);
+}
+
+if (args[0] === "--version" || args[0] === "-v") {
+  console.log(`AIOSchema v${SPEC_VERSION}`);
+  process.exit(0);
+}
+
+const command = args[0];
+
+if (command === "generate") {
+  runGenerate(args.slice(1));
+} else if (command === "verify") {
+  runVerify(args.slice(1));
+} else {
+  console.error(`Unknown command: ${command}`);
+  console.error(`Run 'aioschema --help' for usage.`);
+  process.exit(1);
+}
+
+// ── Commands ──────────────────────────────────────────────────────────────────
+
+function runGenerate(args) {
+  // Parse: <file> [--algorithm sha256|sha384] [--creator-id <id>]
+  const positional = [];
+  const opts       = {};
+
+  for (let i = 0; i < args.length; i++) {
+    if (args[i] === "--algorithm" || args[i] === "-a") {
+      opts.hashAlgorithm = args[++i];
+    } else if (args[i] === "--creator-id") {
+      opts.creatorId = args[++i];
+    } else {
+      positional.push(args[i]);
+    }
+  }
+
+  const filePath = positional[0];
+  if (!filePath) {
+    console.error("Error: file path required.\nUsage: aioschema generate <file>");
+    process.exit(1);
+  }
+  if (!fs.existsSync(filePath)) {
+    console.error(`Error: file not found: ${filePath}`);
+    process.exit(1);
+  }
+
+  try {
+    const manifest = generateManifest(filePath, opts);
+    const out      = sidecarPath(filePath);
+    console.log(`✓ Manifest written: ${out}`);
+    console.log(`  asset_id:         ${manifest.core.asset_id}`);
+    console.log(`  hash_original:    ${Array.isArray(manifest.core.hash_original)
+      ? manifest.core.hash_original.join(", ")
+      : manifest.core.hash_original}`);
+    console.log(`  core_fingerprint: ${manifest.core.core_fingerprint}`);
+    console.log(`  creator_id:       ${manifest.core.creator_id}`);
+  } catch (err) {
+    console.error(`Error generating manifest: ${err.message}`);
+    process.exit(1);
+  }
+}
+
+async function runVerify(args) {
+  const filePath     = args[0];
+  const manifestPath = args[1];
+
+  if (!filePath || !manifestPath) {
+    console.error("Error: file path and manifest path required.");
+    console.error("Usage: aioschema verify <file> <manifest.aios.json>");
+    process.exit(1);
+  }
+  if (!fs.existsSync(filePath)) {
+    console.error(`Error: file not found: ${filePath}`);
+    process.exit(1);
+  }
+  if (!fs.existsSync(manifestPath)) {
+    console.error(`Error: manifest not found: ${manifestPath}`);
+    process.exit(1);
+  }
+
+  let manifest;
+  try {
+    manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+  } catch (err) {
+    console.error(`Error reading manifest: ${err.message}`);
+    process.exit(1);
+  }
+
+  try {
+    const result = await verifyManifest(filePath, manifest);
+
+    if (result.success) {
+      console.log(`◈ VERIFIED`);
+      console.log(`  match_type: ${result.match_type}`);
+      if (result.signature_verified) console.log(`  signature:  verified`);
+      if (result.warnings && result.warnings.length > 0) {
+        result.warnings.forEach(w => console.log(`  warning:    ${w}`));
+      }
+    } else {
+      console.log(`✗ FAILED`);
+      console.log(`  reason: ${result.message}`);
+      process.exit(2);
+    }
+  } catch (err) {
+    console.error(`Error during verification: ${err.message}`);
+    process.exit(1);
+  }
+}
+
+// ── Help ──────────────────────────────────────────────────────────────────────
+
+function printHelp() {
+  console.log(`
+AIOSchema v${SPEC_VERSION} — Cryptographic content provenance
+
+USAGE
+  aioschema generate <file> [options]
+  aioschema verify <file> <manifest.aios.json>
+
+COMMANDS
+  generate    Generate a .aios.json manifest for a file
+  verify      Verify a file against its manifest
+
+OPTIONS (generate)
+  --algorithm, -a   Hash algorithm: sha256 (default) or sha384
+  --creator-id      Creator ID in ed25519-fp-<hex> format
+
+GLOBAL
+  --version, -v     Print version
+  --help, -h        Print this help
+
+EXAMPLES
+  aioschema generate report.pdf
+  aioschema generate image.png --algorithm sha384
+  aioschema verify report.pdf report.pdf.aios.json
+
+SPEC    https://aioschema.org
+HUB     https://aioschemahub.com
+`);
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@aioschema/cli",
+  "version": "0.5.5",
+  "description": "AIOSchema v0.5.5 — command-line tool for generating and verifying provenance manifests.",
+  "main": "cli.js",
+  "bin": {
+    "aioschema": "./cli.js"
+  },
+  "files": [
+    "cli.js",
+    "README.md",
+    "LICENSE.md"
+  ],
+  "dependencies": {
+    "@aioschema/js": "0.5.5"
+  },
+  "keywords": [
+    "aioschema",
+    "provenance",
+    "cli",
+    "content-integrity",
+    "manifest",
+    "cryptographic-hash"
+  ],
+  "author": "Ovidiu Ancuta <ovidiu@aioschema.org>",
+  "license": "SEE LICENSE IN LICENSE.md",
+  "homepage": "https://aioschema.org",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aioschema/aioschema.git",
+    "directory": "cli"
+  },
+  "bugs": {
+    "url": "https://github.com/aioschema/aioschema/issues"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}