@neuroverseos/governance 0.3.0 → 0.3.1

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-4QXB6PEO.js

@@ -1,232 +0,0 @@
-// src/engine/plan-engine.ts
-function keywordMatch(eventText, step) {
-  const stepText = [
-    step.label,
-    step.description ?? "",
-    ...step.tags ?? []
-  ].join(" ").toLowerCase();
-  const keywords = stepText.split(/\s+/).filter((w) => w.length > 3);
-  if (keywords.length === 0) return false;
-  const matched = keywords.filter((kw) => eventText.includes(kw));
-  return matched.length >= Math.ceil(keywords.length * 0.5);
-}
-function tokenSimilarity(a, b) {
-  const tokensA = new Set(a.toLowerCase().split(/\s+/).filter((w) => w.length > 2));
-  const tokensB = new Set(b.toLowerCase().split(/\s+/).filter((w) => w.length > 2));
-  if (tokensA.size === 0 || tokensB.size === 0) return 0;
-  let intersection = 0;
-  for (const t of tokensA) {
-    if (tokensB.has(t)) intersection++;
-  }
-  const union = (/* @__PURE__ */ new Set([...tokensA, ...tokensB])).size;
-  return union > 0 ? intersection / union : 0;
-}
-function findMatchingStep(eventText, event, steps) {
-  const pendingOrActive = steps.filter((s) => s.status === "pending" || s.status === "active");
-  if (pendingOrActive.length === 0) {
-    return { matched: null, closest: null, closestScore: 0 };
-  }
-  for (const step of pendingOrActive) {
-    if (keywordMatch(eventText, step)) {
-      if (step.tools && event.tool && !step.tools.includes(event.tool)) {
-        continue;
-      }
-      return { matched: step, closest: step, closestScore: 1 };
-    }
-  }
-  const intentText = [event.intent, event.tool ?? "", event.scope ?? ""].join(" ");
-  let bestStep = null;
-  let bestScore = 0;
-  for (const step of pendingOrActive) {
-    const stepText = [step.label, step.description ?? "", ...step.tags ?? []].join(" ");
-    const score = tokenSimilarity(intentText, stepText);
-    if (score > bestScore) {
-      bestScore = score;
-      bestStep = step;
-    }
-  }
-  const SIMILARITY_THRESHOLD = 0.35;
-  if (bestScore >= SIMILARITY_THRESHOLD && bestStep) {
-    if (bestStep.tools && event.tool && !bestStep.tools.includes(event.tool)) {
-      return { matched: null, closest: bestStep, closestScore: bestScore };
-    }
-    return { matched: bestStep, closest: bestStep, closestScore: bestScore };
-  }
-  return { matched: null, closest: bestStep, closestScore: bestScore };
-}
-function isSequenceValid(step, plan) {
-  if (!plan.sequential) return true;
-  if (!step.requires || step.requires.length === 0) return true;
-  return step.requires.every((reqId) => {
-    const reqStep = plan.steps.find((s) => s.id === reqId);
-    return reqStep?.status === "completed";
-  });
-}
-function checkConstraints(event, eventText, constraints) {
-  const checks = [];
-  for (const constraint of constraints) {
-    if (constraint.type === "approval") {
-      if (constraint.trigger && eventText.includes(constraint.trigger.substring(0, 10).toLowerCase())) {
-        checks.push({ constraintId: constraint.id, passed: false, reason: constraint.description });
-        return { violated: constraint, checks };
-      }
-      const keywords = constraint.description.toLowerCase().split(/\s+/).filter((w) => w.length > 3);
-      const relevant = keywords.some((kw) => eventText.includes(kw));
-      if (relevant) {
-        checks.push({ constraintId: constraint.id, passed: false, reason: constraint.description });
-        return { violated: constraint, checks };
-      }
-      checks.push({ constraintId: constraint.id, passed: true });
-      continue;
-    }
-    if (constraint.type === "scope" && constraint.trigger) {
-      const keywords = constraint.trigger.split(/\s+/).filter((w) => w.length > 3);
-      const violated = keywords.length > 0 && keywords.every((kw) => eventText.includes(kw));
-      checks.push({
-        constraintId: constraint.id,
-        passed: !violated,
-        reason: violated ? constraint.description : void 0
-      });
-      if (violated) {
-        return { violated: constraint, checks };
-      }
-      continue;
-    }
-    checks.push({ constraintId: constraint.id, passed: true });
-  }
-  return { violated: null, checks };
-}
-function getPlanProgress(plan) {
-  const completed = plan.steps.filter((s) => s.status === "completed").length;
-  const total = plan.steps.length;
-  return {
-    completed,
-    total,
-    percentage: total > 0 ? Math.round(completed / total * 100) : 0
-  };
-}
-function advancePlan(plan, stepId, evidence) {
-  const step = plan.steps.find((s) => s.id === stepId);
-  if (!step) {
-    return { success: false, reason: `Step "${stepId}" not found in plan.` };
-  }
-  if (step.status === "completed") {
-    return { success: false, reason: `Step "${stepId}" is already completed.` };
-  }
-  const mode = plan.completion ?? "trust";
-  if (mode === "verified" && step.verify) {
-    if (!evidence) {
-      return {
-        success: false,
-        reason: `Step "${step.label}" requires evidence (verify: ${step.verify}). Provide evidence to advance.`
-      };
-    }
-    if (evidence.type !== step.verify) {
-      return {
-        success: false,
-        reason: `Evidence type "${evidence.type}" does not match required verification "${step.verify}".`
-      };
-    }
-  }
-  const updatedPlan = {
-    ...plan,
-    steps: plan.steps.map(
-      (s) => s.id === stepId ? { ...s, status: "completed" } : s
-    )
-  };
-  return {
-    success: true,
-    plan: updatedPlan,
-    evidence: evidence ?? void 0
-  };
-}
-function evaluatePlan(event, plan) {
-  const progress = getPlanProgress(plan);
-  if (plan.expires_at) {
-    const expiresAt = new Date(plan.expires_at).getTime();
-    if (Date.now() > expiresAt) {
-      return {
-        allowed: true,
-        status: "PLAN_COMPLETE",
-        reason: "Plan has expired.",
-        progress
-      };
-    }
-  }
-  if (progress.completed === progress.total) {
-    return {
-      allowed: true,
-      status: "PLAN_COMPLETE",
-      reason: "All plan steps are completed.",
-      progress
-    };
-  }
-  const eventText = [
-    event.intent,
-    event.tool ?? "",
-    event.scope ?? ""
-  ].join(" ").toLowerCase();
-  const { matched, closest, closestScore } = findMatchingStep(eventText, event, plan.steps);
-  if (!matched) {
-    return {
-      allowed: false,
-      status: "OFF_PLAN",
-      reason: "Action does not match any plan step.",
-      closestStep: closest?.label,
-      similarityScore: closestScore,
-      progress
-    };
-  }
-  if (!isSequenceValid(matched, plan)) {
-    const pendingDeps = (matched.requires ?? []).filter((reqId) => plan.steps.find((s) => s.id === reqId)?.status !== "completed").join(", ");
-    return {
-      allowed: false,
-      status: "OFF_PLAN",
-      reason: `Step "${matched.label}" requires completion of: ${pendingDeps}`,
-      matchedStep: matched.id,
-      progress
-    };
-  }
-  const { violated } = checkConstraints(event, eventText, plan.constraints);
-  if (violated) {
-    return {
-      allowed: false,
-      status: "CONSTRAINT_VIOLATED",
-      reason: violated.description,
-      matchedStep: matched.id,
-      progress
-    };
-  }
-  return {
-    allowed: true,
-    status: "ON_PLAN",
-    reason: `Matches step: ${matched.label}`,
-    matchedStep: matched.id,
-    progress
-  };
-}
-function buildPlanCheck(event, plan, verdict) {
-  const eventText = [event.intent, event.tool ?? "", event.scope ?? ""].join(" ").toLowerCase();
-  const { matched, closest, closestScore } = findMatchingStep(eventText, event, plan.steps);
-  const { checks: constraintChecks } = checkConstraints(event, eventText, plan.constraints);
-  const progress = getPlanProgress(plan);
-  return {
-    planId: plan.plan_id,
-    matched: !!matched,
-    matchedStepId: matched?.id,
-    matchedStepLabel: matched?.label,
-    closestStepId: !matched ? closest?.id : void 0,
-    closestStepLabel: !matched ? closest?.label : void 0,
-    similarityScore: !matched ? closestScore : void 0,
-    sequenceValid: matched ? isSequenceValid(matched, plan) : void 0,
-    constraintsChecked: constraintChecks,
-    progress: { completed: progress.completed, total: progress.total }
-  };
-}
-
-export {
-  getPlanProgress,
-  advancePlan,
-  evaluatePlan,
-  buildPlanCheck
-};

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
-};