sot-verify 0.1.0

package/README.md

@@ -0,0 +1,63 @@
+# sot-verify
+
+Quick pass/fail verification for Source of Truth (`.sot`) files — optimized for CI/CD pipelines.
+
+[![npm version](https://badge.fury.io/js/sot-verify.svg)](https://www.npmjs.com/package/sot-verify)
+[![License: CC BY 4.0](https://img.shields.io/badge/License-CC_BY_4.0-lightgrey.svg)](https://creativecommons.org/licenses/by/4.0/)
+
+## When to Use
+
+| Tool | Use Case |
+|------|----------|
+| **sot-verify** | CI/CD pipelines, git hooks, quick checks |
+| **sot-validator** | Detailed reports, debugging, development |
+
+## Installation
+
+```bash
+npm install -g sot-verify
+```
+
+## CLI Usage
+
+```bash
+# Quick check - exit 0 if valid, exit 1 if invalid
+sot-verify project.sot
+
+# Multiple files
+sot-verify docs/*.sot
+
+# Silent mode (only exit code, no output)
+sot-verify project.sot --silent
+```
+
+## In CI/CD
+
+```yaml
+# GitHub Actions
+- run: npx sot-verify docs/*.sot
+
+# Pre-commit hook
+sot-verify $(git diff --cached --name-only -- '*.sot')
+```
+
+## API
+
+```javascript
+// Re-exports everything from sot-validator
+const { validate, isValid, detect } = require('sot-verify');
+
+if (isValid(content)) {
+  console.log('Valid');
+}
+```
+
+## Related
+
+- [sot-validator](https://www.npmjs.com/package/sot-validator) - Detailed validation with warnings
+- [cgd-verify](https://www.npmjs.com/package/cgd-verify) - Quick verification for .cgd files
+- [Clarity Gate](https://github.com/frmoretto/clarity-gate) - Full ecosystem
+
+## License
+
+CC BY 4.0

package/bin/cli.js

@@ -0,0 +1,76 @@
+#!/usr/bin/env node
+
+/**
+ * sot-verify CLI
+ * Quick pass/fail verification for CI/CD pipelines
+ * 
+ * For detailed output with warnings, use sot-validator instead.
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { validate, VERSION } = require('sot-validator');
+
+const args = process.argv.slice(2);
+
+if (args.includes('--version') || args.includes('-v')) {
+  console.log(`sot-verify v${VERSION}`);
+  process.exit(0);
+}
+
+if (args.includes('--help') || args.includes('-h') || args.length === 0) {
+  console.log(`
+sot-verify v${VERSION}
+Quick pass/fail verification for Source of Truth (.sot) files
+
+Usage:
+  sot-verify <file.sot> [file2.sot ...]
+
+Options:
+  -h, --help     Show this help message
+  -v, --version  Show version number
+  -s, --silent   No output, only exit code
+
+Exit codes:
+  0 = All files valid
+  1 = One or more files invalid
+
+For detailed validation with warnings, use: sot-validator
+
+Part of the Clarity Gate ecosystem:
+  https://github.com/frmoretto/clarity-gate
+`);
+  process.exit(0);
+}
+
+const silent = args.includes('-s') || args.includes('--silent');
+const files = args.filter(a => !a.startsWith('-'));
+
+if (files.length === 0) {
+  console.error('Error: No files specified');
+  process.exit(1);
+}
+
+let allValid = true;
+
+for (const file of files) {
+  const filePath = path.resolve(file);
+  
+  if (!fs.existsSync(filePath)) {
+    if (!silent) console.log(`✗ ${file}: NOT FOUND`);
+    allValid = false;
+    continue;
+  }
+  
+  const content = fs.readFileSync(filePath, 'utf8');
+  const result = validate(content);
+  
+  if (result.valid) {
+    if (!silent) console.log(`✓ ${file}`);
+  } else {
+    if (!silent) console.log(`✗ ${file}`);
+    allValid = false;
+  }
+}
+
+process.exit(allValid ? 0 : 1);

package/index.js

@@ -0,0 +1,16 @@
+/**
+ * sot-verify
+ * 
+ * Quick verification for Source of Truth (.sot) files
+ * Lightweight wrapper around sot-validator for CI/CD pipelines
+ * 
+ * For detailed validation with warnings, use sot-validator instead.
+ * 
+ * @see https://github.com/frmoretto/clarity-gate
+ * @license CC-BY-4.0
+ */
+
+// Re-export from sot-validator
+const sotValidator = require('sot-validator');
+
+module.exports = sotValidator;

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "sot-verify",
+  "version": "0.1.0",
+  "description": "Quick verification for Source of Truth (.sot) files - returns pass/fail for CI/CD pipelines",
+  "main": "index.js",
+  "bin": {
+    "sot-verify": "./bin/cli.js"
+  },
+  "scripts": {
+    "test": "echo \"Tests coming soon\" && exit 0"
+  },
+  "keywords": [
+    "sot",
+    "source-of-truth",
+    "verify",
+    "validator",
+    "epistemic",
+    "ai-safety",
+    "rag",
+    "ci-cd",
+    "clarity-gate"
+  ],
+  "author": "Francesco Marinoni Moretto",
+  "license": "CC-BY-4.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/frmoretto/clarity-gate"
+  },
+  "homepage": "https://github.com/frmoretto/clarity-gate",
+  "bugs": {
+    "url": "https://github.com/frmoretto/clarity-gate/issues"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "dependencies": {
+    "sot-validator": "^0.1.0"
+  }
+}