@h-rig/server 0.0.6-alpha.0

package/dist/src/inspector/skills.js

@@ -0,0 +1,155 @@
+// @bun
+// packages/server/src/inspector/skills.ts
+var UNIVERSAL_REQUIRED_SKILLS = [
+  {
+    name: "test-driven-development",
+    rationale: "Write failing tests first for code and behavior changes unless a narrow exception is recorded."
+  }
+];
+var INSPECTOR_REQUIRED_SKILLS = [
+  {
+    name: "verification-before-completion",
+    rationale: "Do not claim completion or stability without direct verification evidence."
+  },
+  {
+    name: "no-bs",
+    rationale: "Respect the machine no-bs gates, keep evidence up to date, and do not stop early."
+  }
+];
+var UNIVERSAL_RECOMMENDED_SKILLS = [
+  {
+    name: "verification-before-completion",
+    rationale: "Gather direct evidence before claiming a repair, review result, or task completion."
+  },
+  {
+    name: "systematic-debugging",
+    rationale: "Use disciplined debugging when a run, harness path, or validator fails."
+  },
+  {
+    name: "dispatching-parallel-agents",
+    rationale: "Split independent analysis and review work when that shortens the critical path."
+  },
+  {
+    name: "subagent-driven-development",
+    rationale: "Delegate bounded work to specialist subagents while keeping one context owner."
+  },
+  {
+    name: "requesting-code-review",
+    rationale: "Run local review before landing meaningful implementation work."
+  },
+  {
+    name: "receiving-code-review",
+    rationale: "Handle review feedback rigorously instead of applying it blindly."
+  },
+  {
+    name: "using-git-worktrees",
+    rationale: "Use isolated worktrees for risky or parallel implementation branches."
+  },
+  {
+    name: "writing-plans",
+    rationale: "Plan multi-step changes explicitly when the work is broad or risky."
+  },
+  {
+    name: "executing-plans",
+    rationale: "Execute validated plans in a staged, reviewable way."
+  },
+  {
+    name: "writing-skills",
+    rationale: "Improve or add agent skills when the harness needs new reusable behavior."
+  },
+  {
+    name: "find-skills",
+    rationale: "Discover existing local skills before inventing new workflows."
+  },
+  {
+    name: "openai-docs",
+    rationale: "Use primary OpenAI documentation when the inspector needs current provider facts."
+  },
+  {
+    name: "linear",
+    rationale: "Create or update follow-up work in the task tracker when oversight detects needed action."
+  },
+  {
+    name: "playwright",
+    rationale: "Inspect browser flows directly when a run touches web behavior or UI verification."
+  },
+  {
+    name: "playwright-interactive",
+    rationale: "Keep a live browser session when iterative UI inspection is more efficient than restarts."
+  }
+];
+var INSPECTOR_ONLY_RECOMMENDED_SKILLS = [
+  {
+    name: "vercel:agent-browser",
+    rationale: "Perform high-fidelity browser inspection when a run or preview needs interactive verification."
+  },
+  {
+    name: "vercel:agent-browser-verify",
+    rationale: "Run an automated visual gut-check against dev servers and previews."
+  },
+  {
+    name: "vercel:verification",
+    rationale: "Verify end-to-end browser to API behavior when the change spans multiple surfaces."
+  },
+  {
+    name: "vercel:investigation-mode",
+    rationale: "Triages broken or stuck flows systematically when the harness or a preview misbehaves."
+  }
+];
+function uniqueSkills(skills) {
+  const seen = new Set;
+  const deduped = [];
+  for (const skill of skills) {
+    if (seen.has(skill.name)) {
+      continue;
+    }
+    seen.add(skill.name);
+    deduped.push(skill);
+  }
+  return deduped;
+}
+function buildInspectorSkillCatalog(options) {
+  const required = [...UNIVERSAL_REQUIRED_SKILLS];
+  const recommended = [...UNIVERSAL_RECOMMENDED_SKILLS];
+  if (options.role === "inspector") {
+    required.push(...INSPECTOR_REQUIRED_SKILLS);
+    recommended.push(...INSPECTOR_ONLY_RECOMMENDED_SKILLS);
+  } else if (options.role === "reviewer") {
+    recommended.push({
+      name: "receiving-code-review",
+      rationale: "Review lanes should reason about findings carefully and defensibly."
+    });
+  }
+  if (options.taskKind === "bugfix") {
+    recommended.push({
+      name: "systematic-debugging",
+      rationale: "Bugfix work should start from a disciplined failure-class analysis."
+    });
+  }
+  return {
+    required: uniqueSkills(required),
+    recommended: uniqueSkills(recommended)
+  };
+}
+function buildSkillProvisioningDecision(options) {
+  const exceptionRecorded = Boolean(options.exception);
+  const catalog = buildInspectorSkillCatalog({
+    role: options.role,
+    taskKind: options.taskKind
+  });
+  const requiredSkills = catalog.required.map((skill) => skill.name);
+  const preferredSkills = catalog.recommended.map((skill) => skill.name);
+  return {
+    role: options.role,
+    taskKind: options.taskKind,
+    requiredSkills,
+    preferredSkills,
+    tddMode: exceptionRecorded ? "exception-recorded" : "required",
+    exceptionRecorded,
+    exception: options.exception ?? null
+  };
+}
+export {
+  buildSkillProvisioningDecision,
+  buildInspectorSkillCatalog
+};