@neuroverseos/governance 0.2.3 → 0.3.1

package/dist/chunk-4L6OPKMQ.js

@@ -1,100 +0,0 @@
-import {
-  evaluateGuard
-} from "./chunk-IZSO75NZ.js";
-import {
-  loadWorld
-} from "./chunk-JZPQGIKR.js";
-
-// src/adapters/express.ts
-function methodToCategory(method) {
-  switch (method.toUpperCase()) {
-    case "GET":
-    case "HEAD":
-    case "OPTIONS":
-      return "read";
-    case "POST":
-    case "PUT":
-    case "PATCH":
-      return "write";
-    case "DELETE":
-      return "delete";
-    default:
-      return "other";
-  }
-}
-function defaultMapRequest(req) {
-  const method = (req.method ?? "GET").toUpperCase();
-  const path = req.path ?? req.url ?? "/";
-  return {
-    intent: `${method} ${path}`,
-    tool: "http",
-    scope: path,
-    actionCategory: methodToCategory(method),
-    direction: "input",
-    args: {
-      method,
-      path,
-      ...req.params ?? {},
-      ...req.query ?? {}
-    }
-  };
-}
-function defaultOnBlock(verdict, _req, res, statusCode) {
-  const body = {
-    error: "Governance policy violation",
-    reason: verdict.reason ?? "Action not permitted",
-    ruleId: verdict.ruleId,
-    status: verdict.status
-  };
-  if (res.status && res.json) {
-    res.status(statusCode).json(body);
-  } else if (res.send) {
-    res.statusCode = statusCode;
-    res.send(JSON.stringify(body));
-  } else if (res.end) {
-    res.statusCode = statusCode;
-    res.end();
-  }
-}
-async function createGovernanceMiddleware(worldPath, options) {
-  const world = await loadWorld(worldPath);
-  return createGovernanceMiddlewareFromWorld(world, options);
-}
-function createGovernanceMiddlewareFromWorld(world, options = {}) {
-  const engineOptions = {
-    trace: options.trace ?? false,
-    level: options.level
-  };
-  const mapRequest = options.mapRequest ?? defaultMapRequest;
-  const blockStatusCode = options.blockStatusCode ?? 403;
-  return async function neuroVerseGovernance(req, res, next) {
-    try {
-      const event = mapRequest(req);
-      const verdict = evaluateGuard(event, world, engineOptions);
-      options.onEvaluate?.(verdict, event, req);
-      if (verdict.status === "ALLOW") {
-        next();
-        return;
-      }
-      if (verdict.status === "PAUSE") {
-        const approved = await options.onPause?.(verdict, req);
-        if (approved) {
-          next();
-          return;
-        }
-      }
-      if (options.onBlock) {
-        options.onBlock(verdict, req, res);
-      } else {
-        defaultOnBlock(verdict, req, res, blockStatusCode);
-      }
-    } catch (err) {
-      next(err);
-    }
-  };
-}
-
-export {
-  createGovernanceMiddleware,
-  createGovernanceMiddlewareFromWorld
-};

package/dist/chunk-4NGDRRQH.js

@@ -1,10 +0,0 @@
-// src/contracts/bootstrap-contract.ts
-var BOOTSTRAP_EXIT_CODES = {
-  SUCCESS: 0,
-  FAIL: 1,
-  ERROR: 3
-};
-
-export {
-  BOOTSTRAP_EXIT_CODES
-};

package/dist/chunk-5U2MQO5P.js

@@ -1,57 +0,0 @@
-import {
-  advancePlan,
-  evaluatePlan,
-  getPlanProgress
-} from "./chunk-QLPTHTVB.js";
-
-// src/adapters/shared.ts
-var GovernanceBlockedError = class extends Error {
-  verdict;
-  constructor(verdict, message) {
-    super(message ?? `[NeuroVerse] BLOCKED: ${verdict.reason ?? verdict.ruleId ?? "governance rule"}`);
-    this.name = "GovernanceBlockedError";
-    this.verdict = verdict;
-  }
-};
-function trackPlanProgress(event, state, callbacks) {
-  if (!state.activePlan) return;
-  const planVerdict = evaluatePlan(event, state.activePlan);
-  if (planVerdict.matchedStep) {
-    const advResult = advancePlan(state.activePlan, planVerdict.matchedStep);
-    if (advResult.success && advResult.plan) {
-      state.activePlan = advResult.plan;
-      state.engineOptions.plan = state.activePlan;
-    }
-    const progress = getPlanProgress(state.activePlan);
-    callbacks.onPlanProgress?.(progress);
-    if (progress.completed === progress.total) {
-      callbacks.onPlanComplete?.();
-    }
-  }
-}
-function extractScope(args) {
-  if (typeof args.path === "string") return args.path;
-  if (typeof args.file_path === "string") return args.file_path;
-  if (typeof args.filename === "string") return args.filename;
-  if (typeof args.url === "string") return args.url;
-  if (typeof args.command === "string") return args.command;
-  return void 0;
-}
-function buildEngineOptions(options, plan) {
-  return {
-    trace: options.trace ?? false,
-    level: options.level,
-    plan: plan ?? options.plan
-  };
-}
-function defaultBlockMessage(verdict) {
-  return `Action blocked by governance policy: ${verdict.reason ?? "rule violation"}. Rule: ${verdict.ruleId ?? "unknown"}.`;
-}
-
-export {
-  GovernanceBlockedError,
-  trackPlanProgress,
-  extractScope,
-  buildEngineOptions,
-  defaultBlockMessage
-};

package/dist/chunk-6BB55YJI.js

@@ -1,113 +0,0 @@
-import {
-  GovernanceBlockedError,
-  buildEngineOptions,
-  extractScope,
-  trackPlanProgress
-} from "./chunk-5U2MQO5P.js";
-import {
-  evaluateGuard
-} from "./chunk-IZSO75NZ.js";
-import {
-  loadWorld
-} from "./chunk-JZPQGIKR.js";
-
-// src/adapters/openclaw.ts
-var GovernanceBlockedError2 = class extends GovernanceBlockedError {
-  action;
-  constructor(verdict, action) {
-    super(verdict);
-    this.action = action;
-  }
-};
-function defaultMapAction(action, direction) {
-  return {
-    intent: action.type,
-    tool: action.tool ?? action.type,
-    args: action.input,
-    direction,
-    scope: action.input ? extractScope(action.input) : void 0
-  };
-}
-var NeuroVersePlugin = class {
-  name = "neuroverse-governance";
-  world;
-  options;
-  engineOptions;
-  mapAction;
-  activePlan;
-  constructor(world, options = {}) {
-    this.world = world;
-    this.options = options;
-    this.activePlan = options.plan;
-    this.engineOptions = buildEngineOptions(options, this.activePlan);
-    this.mapAction = options.mapAction ?? defaultMapAction;
-  }
-  /**
-   * Evaluate an action before execution.
-   *
-   * @throws GovernanceBlockedError if BLOCKED
-   * @returns HookResult with verdict details
-   */
-  beforeAction(action) {
-    const event = this.mapAction(action, "input");
-    this.engineOptions.plan = this.activePlan;
-    const verdict = evaluateGuard(event, this.world, this.engineOptions);
-    const result = {
-      allowed: verdict.status === "ALLOW",
-      verdict,
-      action
-    };
-    this.options.onEvaluate?.(result);
-    if (verdict.status === "BLOCK") {
-      throw new GovernanceBlockedError2(verdict, action);
-    }
-    if (verdict.status === "ALLOW") {
-      trackPlanProgress(event, this, this.options);
-    }
-    return result;
-  }
-  /**
-   * Evaluate an action's output (post-execution governance).
-   * Only runs if evaluateOutputs is enabled.
-   *
-   * @returns HookResult or null if output evaluation is disabled
-   */
-  afterAction(action, _output) {
-    if (!this.options.evaluateOutputs) return null;
-    const event = this.mapAction(action, "output");
-    const verdict = evaluateGuard(event, this.world, this.engineOptions);
-    const result = {
-      allowed: verdict.status === "ALLOW",
-      verdict,
-      action
-    };
-    this.options.onEvaluate?.(result);
-    if (verdict.status === "BLOCK") {
-      throw new GovernanceBlockedError2(verdict, action);
-    }
-    return result;
-  }
-  /**
-   * Get the plugin hooks object for agent.use().
-   */
-  hooks() {
-    return {
-      beforeAction: (action) => this.beforeAction(action),
-      afterAction: (action, output) => this.afterAction(action, output)
-    };
-  }
-};
-async function createNeuroVersePlugin(worldPath, options) {
-  const world = await loadWorld(worldPath);
-  return new NeuroVersePlugin(world, options);
-}
-function createNeuroVersePluginFromWorld(world, options) {
-  return new NeuroVersePlugin(world, options);
-}
-
-export {
-  GovernanceBlockedError2 as GovernanceBlockedError,
-  NeuroVersePlugin,
-  createNeuroVersePlugin,
-  createNeuroVersePluginFromWorld
-};

package/dist/chunk-6CZSKEY5.js

@@ -1,164 +0,0 @@
-// src/engine/plan-parser.ts
-function slugify(text) {
-  return text.toLowerCase().replace(/[^a-z0-9\s]/g, "").trim().replace(/\s+/g, "_");
-}
-function extractBracketAnnotation(line, key) {
-  const regex = new RegExp(`\\[${key}:\\s*([^\\]]+)\\]`, "i");
-  const match = line.match(regex);
-  if (!match) return null;
-  return match[1].split(",").map((s) => s.trim()).filter(Boolean);
-}
-function extractParenAnnotation(line, key) {
-  const regex = new RegExp(`\\(${key}:\\s*([^)]+)\\)`, "i");
-  const match = line.match(regex);
-  if (!match) return null;
-  return match[1].split(",").map((s) => s.trim()).filter(Boolean);
-}
-function stripAnnotations(line) {
-  return line.replace(/\[(?:tools|tag|verify|type):\s*[^\]]+\]/gi, "").replace(/\((?:after):\s*[^)]+\)/gi, "").trim();
-}
-function parseFrontmatter(content) {
-  const frontmatter = {};
-  const fmMatch = content.match(/^---\s*\n([\s\S]*?)\n---\s*\n/);
-  if (!fmMatch) {
-    return { frontmatter, body: content };
-  }
-  const fmBody = fmMatch[1];
-  for (const line of fmBody.split("\n")) {
-    const colonIndex = line.indexOf(":");
-    if (colonIndex > 0) {
-      const key = line.slice(0, colonIndex).trim();
-      const value = line.slice(colonIndex + 1).trim();
-      frontmatter[key] = value;
-    }
-  }
-  return { frontmatter, body: content.slice(fmMatch[0].length) };
-}
-function parseSections(body) {
-  const steps = [];
-  const constraints = [];
-  let currentSection = "none";
-  for (const line of body.split("\n")) {
-    const trimmed = line.trim();
-    if (/^#+\s*Steps/i.test(trimmed)) {
-      currentSection = "steps";
-      continue;
-    }
-    if (/^#+\s*Constraints/i.test(trimmed)) {
-      currentSection = "constraints";
-      continue;
-    }
-    if (/^#+\s/.test(trimmed) && currentSection !== "none") {
-      currentSection = "none";
-      continue;
-    }
-    if (trimmed.startsWith("- ")) {
-      const item = trimmed.slice(2).trim();
-      if (currentSection === "steps") {
-        steps.push(item);
-      } else if (currentSection === "constraints") {
-        constraints.push(item);
-      }
-    }
-  }
-  return { steps, constraints };
-}
-function parseStep(raw) {
-  const label = stripAnnotations(raw);
-  const id = slugify(label);
-  const tools = extractBracketAnnotation(raw, "tools");
-  const tags = extractBracketAnnotation(raw, "tag");
-  const verifyArr = extractBracketAnnotation(raw, "verify");
-  const requires = extractParenAnnotation(raw, "after");
-  return {
-    id,
-    label,
-    tools: tools ?? void 0,
-    tags: tags ?? void 0,
-    verify: verifyArr?.[0] ?? void 0,
-    requires: requires ?? void 0,
-    status: "pending"
-  };
-}
-function parseConstraint(raw, index) {
-  const typeAnnotation = extractBracketAnnotation(raw, "type");
-  const description = stripAnnotations(raw);
-  const id = `constraint_${index}`;
-  let type = "custom";
-  let enforcement = "block";
-  let limit;
-  let unit;
-  if (typeAnnotation?.[0] === "approval") {
-    type = "approval";
-    enforcement = "pause";
-  } else if (/budget|\$|spending|cost/i.test(description)) {
-    type = "budget";
-    const amountMatch = description.match(/\$?([\d,]+)/);
-    if (amountMatch) {
-      limit = parseInt(amountMatch[1].replace(/,/g, ""), 10);
-      unit = "USD";
-    }
-  } else if (/time|hour|minute|day|deadline/i.test(description)) {
-    type = "time";
-  } else if (/scope|access|database|production/i.test(description)) {
-    type = "scope";
-  }
-  const trigger = description.toLowerCase();
-  return {
-    id,
-    type,
-    description,
-    enforcement,
-    limit,
-    unit,
-    trigger
-  };
-}
-function parsePlanMarkdown(markdown) {
-  const errors = [];
-  const { frontmatter, body } = parseFrontmatter(markdown.trim());
-  const { steps: stepLines, constraints: constraintLines } = parseSections(body);
-  if (!frontmatter.plan_id) {
-    errors.push("Missing required field: plan_id");
-  }
-  if (stepLines.length === 0) {
-    errors.push("Plan must have at least one step");
-  }
-  if (errors.length > 0) {
-    return { success: false, errors };
-  }
-  const steps = stepLines.map((line) => parseStep(line));
-  const constraints = constraintLines.map((line, i) => parseConstraint(line, i));
-  let expires_at;
-  if (frontmatter.expires) {
-    expires_at = new Date(frontmatter.expires).toISOString();
-  }
-  const completionRaw = frontmatter.completion?.toLowerCase();
-  const completion = completionRaw === "verified" ? "verified" : "trust";
-  const plan = {
-    plan_id: frontmatter.plan_id,
-    objective: frontmatter.objective ?? "",
-    sequential: frontmatter.sequential === "true",
-    completion,
-    steps,
-    constraints,
-    world_id: frontmatter.world ?? void 0,
-    created_at: (/* @__PURE__ */ new Date()).toISOString(),
-    expires_at
-  };
-  return { success: true, plan, errors: [] };
-}
-
-// src/contracts/plan-contract.ts
-var PLAN_EXIT_CODES = {
-  ON_PLAN: 0,
-  OFF_PLAN: 1,
-  CONSTRAINT_VIOLATED: 2,
-  ERROR: 3,
-  PLAN_COMPLETE: 4
-};
-
-export {
-  parsePlanMarkdown,
-  PLAN_EXIT_CODES
-};