agent-governance-check 0.1.0 → 0.2.0

package/bin/cli.js

@@ -9,7 +9,7 @@ import { copyFile, mkdir, access } from 'node:fs/promises';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
 import { scan } from '../src/scanner.js';
-import { report, reportJson } from '../src/reporter.js';
+import { report, reportJson, reportJsonLd } from '../src/reporter.js';
 import { questions } from '../src/questions.js';
 
 const __dirname = dirname(fileURLToPath(import.meta.url));
@@ -21,6 +21,7 @@ const positional = args.filter(a => !a.startsWith('--'));
 
 const targetDir = resolve(positional[0] || '.');
 const jsonMode = flags.has('--json');
+const jsonLdMode = flags.has('--jsonld');
 const initMode = flags.has('--init');
 const verbose = flags.has('--verbose');
 const help = flags.has('--help') || flags.has('-h');
@@ -35,6 +36,7 @@ if (help) {
     npx agent-governance-check ./project    Scan specific path
     npx agent-governance-check --init       Add starter templates to project
     npx agent-governance-check --json       Machine-readable output
+    npx agent-governance-check --jsonld     JSON-LD attestation (VC-compatible)
     npx agent-governance-check --help       Show this help
 
   ${dim('What it checks:')}
@@ -95,7 +97,9 @@ console.log(`  ${dim('Scanning')} ${targetDir === resolve('.') ? '.' : targetDir
 
 const results = await scan(targetDir);
 
-if (jsonMode) {
+if (jsonLdMode) {
+  console.log(reportJsonLd(results));
+} else if (jsonMode) {
   console.log(reportJson(results));
 } else {
   console.log(report(results, targetDir));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent-governance-check",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Five governance questions for your AI agent system. Scan your repo in thirty seconds.",
   "type": "module",
   "bin": {
@@ -26,7 +26,7 @@
   ],
   "license": "MIT",
   "author": "Erin Stanley",
-  "homepage": "https://evoked.dev/diagnostic",
+  "homepage": "https://evoked.dev/registry",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/lowkey-divine/agent-governance-check.git"

package/src/patterns.js

@@ -5,12 +5,18 @@ export const governancePatterns = {
     files: [
       '**/memory-schema.md',
       '**/memory.md',
+      '**/MEMORY.md',
       '**/agent-memory.*',
       '**/agents/*/memory.md',
       '**/agents/*/MEMORY.md',
+      '**/agent-memory/*/MEMORY.md',
+      '**/agent-memory/*/*/MEMORY.md',
       '**/self-record.*',
       '**/decision-log*',
       '**/decision-record*',
+      '**/decision-logs/*.md',
+      '**/decisions/*.md',
+      '**/meetings/*.md',
     ],
     contentSignals: [
       /decision.?log/i,
@@ -19,6 +25,8 @@ export const governancePatterns = {
       /standing.?position/i,
       /memory.?schema/i,
       /persistent.?state/i,
+      /key.?memories/i,
+      /who.?i.?am/i,
     ],
   },
 
@@ -30,6 +38,11 @@ export const governancePatterns = {
       '**/guardrails.*',
       '**/safety-spec.*',
       '**/boundaries.md',
+      '**/red-lines*',
+      '**/red_lines*',
+      '**/PRIME_DIRECTIVE*.md',
+      '**/prime-directive*',
+      '**/prime_directive*',
     ],
     contentSignals: [
       /engine.?withdrawal/i,
@@ -39,6 +52,10 @@ export const governancePatterns = {
       /refusal.?categor/i,
       /fail.?closed/i,
       /agent.*refuse/i,
+      /will.?not/i,
+      /must.?not/i,
+      /red.?lines?/i,
+      /sovereignty.*scope.*dependency/i,
     ],
   },
 
@@ -51,7 +68,11 @@ export const governancePatterns = {
       '**/manifesto.md',
       '**/agency_manifesto.md',
       '**/agents/*/persona.md',
+      '**/personas/*.md',
+      '**/new-generation/*.md',
       '**/AGENTS.md',
+      '**/persona*.md',
+      '**/identity*.md',
     ],
     contentSignals: [
       /agent.?charter/i,
@@ -59,16 +80,21 @@ export const governancePatterns = {
       /agent.?identity/i,
       /persona.?file/i,
       /who.?is.?this.?agent/i,
+      /role.?definition/i,
+      /communication.?style/i,
     ],
   },
 
   'disagreement-protocol': {
     files: [
       '**/deliberation-framework.md',
+      '**/DELIBERATION_FRAMEWORK.md',
       '**/deliberation.*',
       '**/governance-log*',
       '**/dissent*',
       '**/convergent-signal*',
+      '**/CONVERGENT_SIGNAL*',
+      '**/EXISTENTIAL_CHARTER*',
     ],
     contentSignals: [
       /deliberation/i,
@@ -109,4 +135,5 @@ export const frameworkPatterns = [
   { name: 'Evoke', files: ['**/agents/*/persona.md', '**/agents/decision-logs/*'] },
   { name: 'Swarm', files: ['**/swarm.py'] },
   { name: 'Dify', files: ['**/dify.yaml'] },
+  { name: 'OpenClaw', files: ['**/.openclaw/**', '**/SKILL.md', '**/skill.md'] },
 ];

package/src/reporter.js

@@ -110,14 +110,62 @@ export function report(scanResults, targetDir) {
   }
   lines.push(`  ${dim('Free starter kit: https://github.com/lowkey-divine/agent-governance-starter-kit')}`);
   lines.push(`  ${dim('Full framework:   https://evoked.dev/products/agent-governance-starter-kit')}`);
+  lines.push(`  ${dim('Bot Authority:    https://evoked.dev/registry')}`);
   lines.push('');
 
   return lines.join('\n');
 }
 
+export function reportJsonLd(scanResults) {
+  const score = { found: 0, partial: 0, missing: 0, total: 5 };
+  const governanceProperties = {};
+  const evidence = {};
+
+  for (const q of questions) {
+    const result = scanResults.results[q.id];
+    score[result.status]++;
+
+    // Map question IDs to camelCase property names
+    const propName = q.id.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+    governanceProperties[propName] = result.status;
+
+    if (result.evidence.length > 0) {
+      const items = result.evidence.slice(0, 5).map(e => ({
+        file: e.file,
+        type: e.type,
+        ...(e.type === 'content' ? { signal: e.signal } : {}),
+      }));
+      if (result.evidence.length > 5) {
+        items.push({ note: `${result.evidence.length - 5} additional files detected` });
+      }
+      evidence[propName] = items;
+    }
+  }
+
+  const output = {
+    "@context": [
+      "https://www.w3.org/2018/credentials/v1",
+      "https://evoked.dev/schemas/governance/v1"
+    ],
+    "@type": "GovernanceAttestation",
+    issuer: "self",
+    issuanceDate: new Date().toISOString(),
+    tier: 1,
+    tierLabel: "Self-Attested",
+    governanceProperties,
+    score,
+    frameworks: scanResults.frameworks.map(f => f.name),
+    evidence,
+    registryUrl: "https://evoked.dev/registry",
+    verifyUrl: "https://evoked.dev/api/verify-agent",
+  };
+
+  return JSON.stringify(output, null, 2);
+}
+
 export function reportJson(scanResults) {
   const output = {
-    version: '0.1.0',
+    version: '0.2.0',
     frameworks: scanResults.frameworks,
     questions: questions.map(q => ({
       id: q.id,

package/src/scanner.js

@@ -36,7 +36,7 @@ function matchGlob(filePath, pattern) {
       pi++;
       fi++;
     } else if (parts[pi].includes('*')) {
-      const regex = new RegExp('^' + parts[pi].replace(/\*/g, '.*').replace(/\?/g, '.') + '$');
+      const regex = new RegExp('^' + parts[pi].replace(/[.+^${}()|[\]\\]/g, '\\$&').replace(/\*/g, '.*').replace(/\?/g, '.') + '$');
       if (regex.test(fileParts[fi])) {
         pi++;
         fi++;
@@ -128,7 +128,7 @@ export async function scan(targetDir) {
     // Scan code files for governance-related content
     if (evidence.length === 0) {
       const codeFiles = allFiles.filter(f =>
-        /\.(js|mjs|ts|py|yaml|yml|json)$/.test(f)
+        /\.(js|mjs|ts|py|yaml|yml|json|md|txt|toml)$/.test(f)
       );
 
       // Sample up to 50 files for content scanning