@raishin/vanguard-frontier-agentic 2.0.1 → 2.2.0

package/tests/fixtures/hr-maestro-routing/inputs/14-ambiguous.json

@@ -0,0 +1,7 @@
+{
+  "name": "14-ambiguous",
+  "task": "Could you give me an update on the status of things in general?",
+  "tags": [
+    "ambiguous"
+  ]
+}

package/tests/fixtures/hr-maestro-routing/taxonomy.json

@@ -0,0 +1,59 @@
+{
+  "provider": "hr",
+  "domains": {
+    "employee-relations": {
+      "keywords": ["employee relations", "grievance", "manager behavior"],
+      "agent": "hr-employee-relations-agent"
+    },
+    "workplace-investigations": {
+      "keywords": ["workplace investigation", "witness sequencing", "neutrality check"],
+      "agent": "hr-workplace-investigations-agent"
+    },
+    "performance-management": {
+      "keywords": ["performance improvement plan", "coaching plan", "calibration"],
+      "agent": "hr-performance-management-agent"
+    },
+    "termination-readiness": {
+      "keywords": ["termination readiness", "final-pay dependency", "access removal"],
+      "agent": "hr-termination-readiness-agent"
+    },
+    "leave-accommodation": {
+      "keywords": ["leave request", "disability accommodation", "return-to-work"],
+      "agent": "hr-leave-accommodation-agent"
+    },
+    "recruiting-selection": {
+      "keywords": ["recruiting workflow", "selection criteria", "interview structure"],
+      "agent": "hr-recruiting-selection-agent"
+    },
+    "compensation-equity": {
+      "keywords": ["pay equity", "promotion leveling", "bonus eligibility"],
+      "agent": "hr-compensation-equity-agent"
+    },
+    "benefits-payroll": {
+      "keywords": ["payroll process", "benefits administration", "deduction error"],
+      "agent": "hr-benefits-payroll-agent"
+    },
+    "workforce-planning-rif": {
+      "keywords": ["reduction in force", "restructuring", "redeployment"],
+      "agent": "hr-workforce-planning-rif-agent"
+    },
+    "learning-policy": {
+      "keywords": ["compliance training", "manager enablement", "training completion"],
+      "agent": "hr-learning-policy-agent"
+    },
+    "analytics-people-data": {
+      "keywords": ["people analytics", "algorithmic bias", "employee monitoring"],
+      "agent": "hr-analytics-people-data-agent"
+    },
+    "culture-dei": {
+      "keywords": ["inclusion program", "belonging", "anti-harassment prevention"],
+      "agent": "hr-culture-dei-agent"
+    },
+    "hris-process-controls": {
+      "keywords": ["HRIS workflow", "separation of duties", "audit log"],
+      "agent": "hr-hris-process-controls-agent"
+    }
+  },
+  "live_guards": [],
+  "parallel_threshold": 0.8
+}

package/tests/fixtures/legal-maestro-routing/expected/01-contract-review.json

@@ -0,0 +1,6 @@
+{
+  "route": [
+    "legal-contract-review-agent"
+  ],
+  "mode": "single"
+}

package/tests/fixtures/legal-maestro-routing/expected/02-privacy-data-protection.json

@@ -0,0 +1,6 @@
+{
+  "route": [
+    "legal-privacy-data-protection-agent"
+  ],
+  "mode": "single"
+}

package/tests/fixtures/legal-maestro-routing/expected/03-employment-law-risk.json

@@ -0,0 +1,6 @@
+{
+  "route": [
+    "legal-employment-law-risk-agent"
+  ],
+  "mode": "single"
+}

package/tests/fixtures/legal-maestro-routing/expected/04-litigation-discovery-hold.json

@@ -0,0 +1,6 @@
+{
+  "route": [
+    "legal-litigation-discovery-hold-agent"
+  ],
+  "mode": "single"
+}

package/tests/fixtures/legal-maestro-routing/expected/05-regulatory-compliance.json

@@ -0,0 +1,6 @@
+{
+  "route": [
+    "legal-regulatory-compliance-agent"
+  ],
+  "mode": "single"
+}

package/tests/fixtures/legal-maestro-routing/expected/06-ip-open-source.json

@@ -0,0 +1,6 @@
+{
+  "route": [
+    "legal-ip-open-source-agent"
+  ],
+  "mode": "single"
+}

package/tests/fixtures/legal-maestro-routing/expected/07-vendor-procurement-risk.json

@@ -0,0 +1,6 @@
+{
+  "route": [
+    "legal-vendor-procurement-risk-agent"
+  ],
+  "mode": "single"
+}

package/tests/fixtures/legal-maestro-routing/expected/08-ethics-investigations.json

@@ -0,0 +1,6 @@
+{
+  "route": [
+    "legal-ethics-investigations-agent"
+  ],
+  "mode": "single"
+}

package/tests/fixtures/legal-maestro-routing/expected/09-policy-governance.json

@@ -0,0 +1,6 @@
+{
+  "route": [
+    "legal-policy-governance-agent"
+  ],
+  "mode": "single"
+}

package/tests/fixtures/legal-maestro-routing/expected/10-public-disclosure.json

@@ -0,0 +1,6 @@
+{
+  "route": [
+    "legal-public-disclosure-agent"
+  ],
+  "mode": "single"
+}

package/tests/fixtures/legal-maestro-routing/expected/11-knowledge-management.json

@@ -0,0 +1,6 @@
+{
+  "route": [
+    "legal-knowledge-management-agent"
+  ],
+  "mode": "single"
+}

package/tests/fixtures/legal-maestro-routing/expected/12-ambiguous.json

@@ -0,0 +1,4 @@
+{
+  "route": [],
+  "mode": "unclassified"
+}

package/tests/fixtures/legal-maestro-routing/inputs/01-contract-review.json

@@ -0,0 +1,7 @@
+{
+  "name": "01-contract-review",
+  "task": "Review the indemnity and limitation of liability terms in this commercial agreement.",
+  "tags": [
+    "happy-path"
+  ]
+}

package/tests/fixtures/legal-maestro-routing/inputs/02-privacy-data-protection.json

@@ -0,0 +1,7 @@
+{
+  "name": "02-privacy-data-protection",
+  "task": "Assess data protection risk and DPIA readiness for a new cross-border transfer.",
+  "tags": [
+    "happy-path"
+  ]
+}

package/tests/fixtures/legal-maestro-routing/inputs/03-employment-law-risk.json

@@ -0,0 +1,7 @@
+{
+  "name": "03-employment-law-risk",
+  "task": "Flag the employment-law risk and wrongful termination exposure in this people matter.",
+  "tags": [
+    "happy-path"
+  ]
+}

package/tests/fixtures/legal-maestro-routing/inputs/04-litigation-discovery-hold.json

@@ -0,0 +1,7 @@
+{
+  "name": "04-litigation-discovery-hold",
+  "task": "Triage a litigation hold and discovery preservation after a subpoena arrived.",
+  "tags": [
+    "happy-path"
+  ]
+}

package/tests/fixtures/legal-maestro-routing/inputs/05-regulatory-compliance.json

@@ -0,0 +1,7 @@
+{
+  "name": "05-regulatory-compliance",
+  "task": "Map our regulatory obligation set and flag any licensing gap or enforcement exposure.",
+  "tags": [
+    "happy-path"
+  ]
+}

package/tests/fixtures/legal-maestro-routing/inputs/06-ip-open-source.json

@@ -0,0 +1,7 @@
+{
+  "name": "06-ip-open-source",
+  "task": "Review open-source license obligations and copyright and trademark exposure.",
+  "tags": [
+    "happy-path"
+  ]
+}

package/tests/fixtures/legal-maestro-routing/inputs/07-vendor-procurement-risk.json

@@ -0,0 +1,7 @@
+{
+  "name": "07-vendor-procurement-risk",
+  "task": "Review a vendor contract for procurement risk and undisclosed subprocessor terms.",
+  "tags": [
+    "happy-path"
+  ]
+}

package/tests/fixtures/legal-maestro-routing/inputs/08-ethics-investigations.json

@@ -0,0 +1,7 @@
+{
+  "name": "08-ethics-investigations",
+  "task": "Triage a whistleblower report involving a conflict of interest and an anti-bribery concern.",
+  "tags": [
+    "happy-path"
+  ]
+}

package/tests/fixtures/legal-maestro-routing/inputs/09-policy-governance.json

@@ -0,0 +1,7 @@
+{
+  "name": "09-policy-governance",
+  "task": "Review policy governance, the approval matrix, and delegated authority for this control.",
+  "tags": [
+    "happy-path"
+  ]
+}

package/tests/fixtures/legal-maestro-routing/inputs/10-public-disclosure.json

@@ -0,0 +1,7 @@
+{
+  "name": "10-public-disclosure",
+  "task": "Assess public disclosure and materiality with securities-law sensitivity for this matter.",
+  "tags": [
+    "happy-path"
+  ]
+}

package/tests/fixtures/legal-maestro-routing/inputs/11-knowledge-management.json

@@ -0,0 +1,7 @@
+{
+  "name": "11-knowledge-management",
+  "task": "Review the clause library, the legal playbook, and the matter taxonomy for gaps.",
+  "tags": [
+    "happy-path"
+  ]
+}

package/tests/fixtures/legal-maestro-routing/inputs/12-ambiguous.json

@@ -0,0 +1,7 @@
+{
+  "name": "12-ambiguous",
+  "task": "Please help me think through a general question about our operations.",
+  "tags": [
+    "ambiguous"
+  ]
+}

package/tests/fixtures/legal-maestro-routing/taxonomy.json

@@ -0,0 +1,51 @@
+{
+  "provider": "legal",
+  "domains": {
+    "contract-review": {
+      "keywords": ["indemnity", "limitation of liability", "warranty clause"],
+      "agent": "legal-contract-review-agent"
+    },
+    "privacy-data-protection": {
+      "keywords": ["data protection", "cross-border transfer", "DPIA"],
+      "agent": "legal-privacy-data-protection-agent"
+    },
+    "employment-law-risk": {
+      "keywords": ["employment-law risk", "wrongful termination exposure"],
+      "agent": "legal-employment-law-risk-agent"
+    },
+    "litigation-discovery-hold": {
+      "keywords": ["litigation hold", "discovery preservation", "subpoena"],
+      "agent": "legal-litigation-discovery-hold-agent"
+    },
+    "regulatory-compliance": {
+      "keywords": ["regulatory obligation", "licensing gap", "enforcement exposure"],
+      "agent": "legal-regulatory-compliance-agent"
+    },
+    "ip-open-source": {
+      "keywords": ["open-source license", "copyright", "trademark"],
+      "agent": "legal-ip-open-source-agent"
+    },
+    "vendor-procurement-risk": {
+      "keywords": ["vendor contract", "procurement risk", "subprocessor"],
+      "agent": "legal-vendor-procurement-risk-agent"
+    },
+    "ethics-investigations": {
+      "keywords": ["whistleblower report", "conflict of interest", "anti-bribery"],
+      "agent": "legal-ethics-investigations-agent"
+    },
+    "policy-governance": {
+      "keywords": ["policy governance", "approval matrix", "delegated authority"],
+      "agent": "legal-policy-governance-agent"
+    },
+    "public-disclosure": {
+      "keywords": ["public disclosure", "materiality", "securities-law"],
+      "agent": "legal-public-disclosure-agent"
+    },
+    "knowledge-management": {
+      "keywords": ["clause library", "legal playbook", "matter taxonomy"],
+      "agent": "legal-knowledge-management-agent"
+    }
+  },
+  "live_guards": [],
+  "parallel_threshold": 0.8
+}

package/tests/validate-readme-counts.mjs

@@ -0,0 +1,179 @@
+#!/usr/bin/env node
+/**
+ * Standalone validator: fails CI if README.md count markers have drifted
+ * from the real computed values derived from disk.
+ *
+ * Count contract:
+ *   skills    = files matching skills/STAR-STAR/SKILL.md  (recursive)
+ *   agents    = files matching agents/STAR-STAR/metadata.json  (recursive)
+ *   providers = distinct `provider` values across all agents/STAR-STAR/metadata.json
+ *   roles     = number of keys under .roles in catalog/install-roles.json
+ *   rules     = length of JSON array in catalog/rules.json
+ *   mcp       = length of JSON array in catalog/mcp-references.json
+ *
+ * Run: node tests/validate-readme-counts.mjs
+ */
+
+import fs from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/** Recursively collect files whose basename matches `basename`. */
+function findFiles(dir, basename) {
+  const results = [];
+  if (!fs.existsSync(dir)) return results;
+  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+    const full = path.join(dir, entry.name);
+    if (entry.isDirectory()) {
+      results.push(...findFiles(full, basename));
+    } else if (entry.isFile() && entry.name === basename) {
+      results.push(full);
+    }
+  }
+  return results;
+}
+
+// ---------------------------------------------------------------------------
+// Compute counts from disk
+// ---------------------------------------------------------------------------
+
+const skillFiles = findFiles(path.join(repoRoot, "skills"), "SKILL.md");
+const computedSkills = skillFiles.length;
+
+const agentMetaFiles = findFiles(path.join(repoRoot, "agents"), "metadata.json");
+const computedAgents = agentMetaFiles.length;
+
+const providerSet = new Set();
+for (const f of agentMetaFiles) {
+  try {
+    const data = JSON.parse(fs.readFileSync(f, "utf8"));
+    if (typeof data.provider === "string" && data.provider.length > 0) {
+      providerSet.add(data.provider);
+    }
+  } catch {
+    // malformed metadata — skip silently
+  }
+}
+const computedProviders = providerSet.size;
+
+const rolesDoc = JSON.parse(
+  fs.readFileSync(path.join(repoRoot, "catalog", "install-roles.json"), "utf8")
+);
+const computedRoles = Object.keys(rolesDoc.roles ?? {}).length;
+
+const rulesArr = JSON.parse(
+  fs.readFileSync(path.join(repoRoot, "catalog", "rules.json"), "utf8")
+);
+const computedRules = Array.isArray(rulesArr) ? rulesArr.length : 0;
+
+const mcpArr = JSON.parse(
+  fs.readFileSync(path.join(repoRoot, "catalog", "mcp-references.json"), "utf8")
+);
+const computedMcp = Array.isArray(mcpArr) ? mcpArr.length : 0;
+
+/** Map from canonical KEY (as used in inline spans) → computed value. */
+const computed = {
+  skills: computedSkills,
+  agents: computedAgents,
+  providers: computedProviders,
+  roles: computedRoles,
+  rules: computedRules,
+  mcp: computedMcp,
+};
+
+// ---------------------------------------------------------------------------
+// Read README.md
+// ---------------------------------------------------------------------------
+
+const readmePath = path.join(repoRoot, "README.md");
+const readme = fs.readFileSync(readmePath, "utf8");
+
+// ---------------------------------------------------------------------------
+// Extract and validate marker block
+// ---------------------------------------------------------------------------
+
+const blockMatch = readme.match(
+  /<!--\s*readme-counts:start\s*-->([\s\S]*?)<!--\s*readme-counts:end\s*-->/
+);
+
+if (!blockMatch) {
+  process.stderr.write(
+    "FAIL [readme-counts] marker block not found in README.md\n"
+  );
+  process.exit(1);
+}
+
+const blockContent = blockMatch[1];
+
+/**
+ * Map from table label → canonical KEY used in `computed`.
+ * Keys are lower-cased for case-insensitive matching.
+ */
+const labelToKey = {
+  "skills": "skills",
+  "agents": "agents",
+  "providers": "providers",
+  "install roles": "roles",
+  "rules": "rules",
+  "mcp references": "mcp",
+};
+
+const failures = [];
+
+// Parse table rows: | Label | Number |
+// Tolerate extra whitespace around cell content.
+const tableRowRe = /\|\s*([^|]+?)\s*\|\s*(\d+)\s*\|/g;
+let rowMatch;
+while ((rowMatch = tableRowRe.exec(blockContent)) !== null) {
+  const rawLabel = rowMatch[1].trim().toLowerCase();
+  const shownValue = parseInt(rowMatch[2], 10);
+  const key = labelToKey[rawLabel];
+  if (key === undefined) continue; // header row or unknown label — skip
+  const computedValue = computed[key];
+  if (shownValue !== computedValue) {
+    failures.push(
+      `FAIL [readme-counts] ${rowMatch[1].trim()}: README shows ${shownValue}, computed ${computedValue}`
+    );
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Find and validate all inline count spans
+// ---------------------------------------------------------------------------
+
+// <!-- count:KEY -->NUMBER<!-- /count -->
+const spanRe = /<!--\s*count:(skills|agents|providers|roles|rules|mcp)\s*-->(\d+)<!--\s*\/count\s*-->/g;
+let spanMatch;
+while ((spanMatch = spanRe.exec(readme)) !== null) {
+  const key = spanMatch[1];
+  const shownValue = parseInt(spanMatch[2], 10);
+  const computedValue = computed[key];
+  if (shownValue !== computedValue) {
+    failures.push(
+      `FAIL [readme-counts] ${key} (inline span): README shows ${shownValue}, computed ${computedValue}`
+    );
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Report
+// ---------------------------------------------------------------------------
+
+if (failures.length > 0) {
+  for (const line of failures) {
+    process.stderr.write(line + "\n");
+  }
+  process.exit(1);
+}
+
+console.log(
+  `OK: README counts match catalog (skills=${computedSkills} agents=${computedAgents} ` +
+  `providers=${computedProviders} roles=${computedRoles} rules=${computedRules} mcp=${computedMcp})`
+);
+process.exit(0);