@moreih29/nexus-core 0.4.0 → 0.6.0

package/scripts/validate.ts

@@ -0,0 +1,90 @@
+#!/usr/bin/env bun
+
+import path from 'node:path';
+import {
+  loadSchemas,
+  runAll as runSchemaAndIntegrity,
+  type ValidationResult,
+} from './lib/validate.ts';
+import {
+  checkHarnessSpecific,
+  checkConcreteModel,
+  checkPromptOnly,
+  checkTagTriggerConsistency,
+} from './lib/lint.ts';
+import {
+  checkDirectoryStrict,
+  checkIdMatch,
+} from './lib/structure.ts';
+
+const IS_GITHUB_ACTIONS = process.env.GITHUB_ACTIONS === 'true';
+
+async function main(): Promise<void> {
+  const root = process.cwd();
+  const allResults: ValidationResult[] = [];
+
+  // Gate 1-5: schema + referential integrity + manifest generation
+  // (runAll internally does per-file fail-forward and generates manifest on success)
+  await loadSchemas(root);
+  const schemaResults = await runSchemaAndIntegrity(root);
+  allResults.push(...schemaResults);
+
+  // Gate 6: harness-specific tool names
+  const harnessResults = await checkHarnessSpecific(root);
+  allResults.push(...harnessResults);
+
+  // Gate 7: concrete model names
+  const modelResults = await checkConcreteModel(root);
+  allResults.push(...modelResults);
+
+  // Gate 8: prompt-only enforcement
+  const promptOnlyResults = await checkPromptOnly(root);
+  allResults.push(...promptOnlyResults);
+
+  // Gate 9: directory strict
+  const dirResults = await checkDirectoryStrict(root);
+  allResults.push(...dirResults);
+
+  // Gate 10: id ↔ directory name + kebab pattern
+  const idResults = await checkIdMatch(root);
+  allResults.push(...idResults);
+
+  // Gate 11: tag trigger consistency
+  const tagTriggerResults = await checkTagTriggerConsistency(root);
+  allResults.push(...tagTriggerResults);
+
+  // Report
+  const errors = allResults.filter((r) => r.severity === 'error');
+  const warnings = allResults.filter((r) => r.severity === 'warning');
+
+  if (allResults.length === 0) {
+    console.log('All 11 validation gates passed.');
+    return;
+  }
+
+  if (IS_GITHUB_ACTIONS) {
+    // GitHub annotations format
+    for (const r of allResults) {
+      const level = r.severity === 'error' ? 'error' : 'warning';
+      const lineAttr = r.line ? `,line=${r.line}` : '';
+      console.log(`::${level} file=${r.file}${lineAttr}::[${r.gate}] ${r.message}`);
+    }
+  } else {
+    // Human-readable format
+    for (const r of allResults) {
+      const loc = r.line ? `${r.file}:${r.line}` : r.file;
+      console.log(`${loc}  [${r.gate}] ${r.severity.toUpperCase()}: ${r.message}`);
+    }
+    console.log('');
+    console.log(`Summary: ${errors.length} error(s), ${warnings.length} warning(s)`);
+  }
+
+  if (errors.length > 0) {
+    process.exit(1);
+  }
+}
+
+main().catch((err) => {
+  console.error('Fatal error in validate.ts:', err);
+  process.exit(2);
+});

package/conformance/lifecycle/session-end.json

@@ -1,31 +0,0 @@
-{
-  "test_id": "session_end",
-  "description": "Verifies that session_end removes runtime.json and agent-tracker.json, completing the full session lifecycle deletion",
-  "precondition": {
-    "state_files": {
-      ".nexus/state/runtime.json": {
-        "teams_enabled": true,
-        "session_started_at": "2026-04-13T00:00:00.000Z",
-        "plugin_version": "0.4.0"
-      },
-      ".nexus/state/agent-tracker.json": []
-    }
-  },
-  "event": {
-    "type": "session_end",
-    "description": "Harness session hook fires at shutdown, cleaning up all runtime state files"
-  },
-  "postcondition": {
-    "state_files": {
-      ".nexus/state/runtime.json": null,
-      ".nexus/state/agent-tracker.json": null
-    }
-  },
-  "covers": {
-    "state_schemas": {
-      "runtime.schema.json": ["teams_enabled", "session_started_at", "plugin_version"],
-      "agent-tracker.schema.json": []
-    },
-    "description": "Covers deletion aspect of the full runtime/agent-tracker lifecycle — absence of both files after session_end"
-  }
-}

package/conformance/lifecycle/session-start.json

@@ -1,36 +0,0 @@
-{
-  "test_id": "session_start",
-  "description": "Verifies that session_start writes runtime.json with required fields and initializes agent-tracker.json as an empty array",
-  "precondition": {
-    "state_files": {
-      ".nexus/state/runtime.json": null,
-      ".nexus/state/agent-tracker.json": null
-    }
-  },
-  "event": {
-    "type": "session_start",
-    "params": {
-      "teams_enabled": true,
-      "plugin_version": "0.4.0"
-    },
-    "description": "Harness session hook fires at startup, injecting runtime configuration and initializing the agent registry"
-  },
-  "postcondition": {
-    "state_files": {
-      ".nexus/state/runtime.json": {
-        "$.teams_enabled": true,
-        "$.session_started_at": { "type": "iso8601" },
-        "$.plugin_version": { "type": "string", "minLength": 1 }
-      },
-      ".nexus/state/agent-tracker.json": {
-        "$.length": 0
-      }
-    }
-  },
-  "covers": {
-    "state_schemas": {
-      "runtime.schema.json": ["teams_enabled", "session_started_at", "plugin_version"],
-      "agent-tracker.schema.json": []
-    }
-  }
-}

package/conformance/state-schemas/runtime.schema.json

@@ -1,25 +0,0 @@
-{
-  "$schema": "https://json-schema.org/draft/2020-12/schema",
-  "$id": "conformance/state-schemas/runtime.schema.json",
-  "title": "Nexus Runtime State",
-  "description": "Schema for .nexus/state/runtime.json — ephemeral runtime configuration written by the harness at session start",
-  "type": "object",
-  "additionalProperties": false,
-  "required": ["teams_enabled", "session_started_at", "plugin_version"],
-  "properties": {
-    "teams_enabled": {
-      "type": "boolean",
-      "description": "Whether multi-agent team orchestration is active in this session"
-    },
-    "session_started_at": {
-      "type": "string",
-      "format": "date-time",
-      "description": "ISO 8601 timestamp when the current harness session was started"
-    },
-    "plugin_version": {
-      "type": "string",
-      "minLength": 1,
-      "description": "Version string of the harness plugin that wrote this file"
-    }
-  }
-}