agentix-cli 0.16.0 → 0.18.0

package/dist/agent-RDVGL2TW.js

@@ -0,0 +1,2 @@
+import{A as a,B as b,C as c}from"./chunk-JXEPJ3YD.js";import"./chunk-SFQUP3BP.js";import"./chunk-JGXE2YNV.js";import"./chunk-VJUTQAPJ.js";import"./chunk-DJEZ2HVU.js";import"./chunk-DSYKYZMT.js";import"./chunk-QOYAX2FT.js";import"./chunk-HPDHNIA3.js";export{a as createAgentContext,b as generate,c as generateStream};
+//# sourceMappingURL=agent-RDVGL2TW.js.map

package/dist/audit-Z47AQFFD.js

@@ -0,0 +1,3 @@
+import"./chunk-HPDHNIA3.js";function h(e,t,o,n){let r=[],s=e.frontmatter,f=e.instructions??"",l="PASS";if(s.references?.length)for(let i of s.references)m(i,t)||(l="FAILING",r.push(`references: "${i}" does not resolve in the registry`));if(s.delegatesTo?.length)for(let i of s.delegatesTo)n.has(i)||(l="FAILING",r.push(`delegatesTo: "${i}" has no installed SKILL.md`));k(f)&&(l!=="FAILING"&&(l="REVIEW"),r.push("body contains raw `python3 ~/scripts/...` inside a code block \u2014 delegate to the relevant skill instead"));let d=["deploy","ssh","email","gitlab","ops"],p=(s.category||"").toLowerCase(),I=(s.tags||[]).map(i=>i.toLowerCase());(d.includes(p)||I.some(i=>d.includes(i))||/\b(deploy|ssh|gitlab|hotmail|server|host)\b/i.test(s.description||""))&&(!s.references||s.references.length===0)&&(l==="PASS"&&(l="REVIEW"),r.push("infrastructure-flavored skill has no `references:` frontmatter \u2014 facts should be cited from the registry"));let c=f.match(/\b\d{1,3}(?:\.\d{1,3}){3}\b/g);if(c&&c.length>0){let i=new Set([...t.byId.values()].flatMap(a=>Object.values(a.fields).filter(g=>typeof g=="string"))),u=c.filter(a=>!i.has(a));u.length>0&&(l==="PASS"&&(l="REVIEW"),r.push(`body contains raw IP(s) not in the registry: ${[...new Set(u)].slice(0,3).join(", ")}`))}return{skill:e,name:s.name,verdict:l,reasons:r}}function S(e,t){let o=new Set;for(let r of e.recipes)for(let s of r.skills)o.add(s);let n=[];for(let r of o)t.has(r)||n.push({skill:null,name:r,verdict:"FAILING",reasons:["required by a recipe, but no SKILL.md is installed"]});return n}function A(e){let t=new Set(e.skills.map(n=>n.frontmatter.name));return[...e.skills.map(n=>h(n,e.references,e.recipes,t)),...S(e.recipes,t)]}function k(e){let t=!1;for(let o of e.split(`
+`)){if(/^\s*```/.test(o)){t=!t;continue}if(t&&/python3\s+~\/scripts\//.test(o))return!0}return!1}function m(e,t){if(e.endsWith(".*")){let o=e.slice(0,-2);for(let n of t.byId.keys())if(n===o||n.startsWith(`${o}.`))return!0;return!1}return t.byId.has(e)}export{A as auditAll,S as auditMissingSkills,h as auditSkill};
+//# sourceMappingURL=audit-Z47AQFFD.js.map

package/dist/audit-Z47AQFFD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/agent/skills/audit.ts"],"sourcesContent":["import type { Skill } from \"./types\"\nimport type { ReferenceIndex } from \"@/agents/references/types\"\nimport type { RecipeIndex } from \"@/agents/references/recipes\"\n\n// --- Skill audit lint ---\n//\n// Verdicts:\n//   PASS    — skill is deterministic and consistent with the references registry\n//   REVIEW  — skill works but embeds raw infra facts that should live in references,\n//             or carries known-bad anti-patterns (e.g. raw `python3 ~/scripts/...`)\n//   FAILING — skill cites references that don't resolve, OR a recipe requires this\n//             skill but its SKILL.md is missing, OR delegatesTo points at a\n//             non-existent skill\n\nexport type SkillAuditVerdict = \"PASS\" | \"REVIEW\" | \"FAILING\"\n\nexport interface SkillAuditResult {\n  skill: Skill | null\n  /** Either skill.frontmatter.name or — when missing — the requiredName. */\n  name: string\n  verdict: SkillAuditVerdict\n  reasons: string[]\n}\n\nexport interface AuditInput {\n  skills: Skill[]\n  references: ReferenceIndex\n  recipes: RecipeIndex\n}\n\n/**\n * Audit a single skill against the reference + recipe indices.\n * Pure function — easy to test, no I/O.\n */\nexport function auditSkill(\n  skill: Skill,\n  references: ReferenceIndex,\n  recipes: RecipeIndex,\n  knownSkillNames: Set<string>,\n): SkillAuditResult {\n  const reasons: string[] = []\n  const fm = skill.frontmatter\n  const body = skill.instructions ?? \"\"\n  let verdict: SkillAuditVerdict = \"PASS\"\n\n  // --- FAILING: unresolved references ---\n  if (fm.references?.length) {\n    for (const ref of fm.references) {\n      if (!referenceResolves(ref, references)) {\n        verdict = \"FAILING\"\n        reasons.push(`references: \"${ref}\" does not resolve in the registry`)\n      }\n    }\n  }\n\n  // --- FAILING: delegatesTo points at a missing skill ---\n  if (fm.delegatesTo?.length) {\n    for (const delegate of fm.delegatesTo) {\n      if (!knownSkillNames.has(delegate)) {\n        verdict = \"FAILING\"\n        reasons.push(`delegatesTo: \"${delegate}\" has no installed SKILL.md`)\n      }\n    }\n  }\n\n  // --- REVIEW: hardcoded raw script invocations inside fenced code blocks ---\n  // Flagging only fenced code blocks avoids false positives from prose like\n  // \"Do not invoke `python3 ~/scripts/...`\" — the skill is *recommending*\n  // the script when it puts it inside ```...``` (or indented as a runnable\n  // command), not when it explicitly forbids it.\n  if (containsRawScriptInCodeFence(body)) {\n    if (verdict !== \"FAILING\") verdict = \"REVIEW\"\n    reasons.push(\"body contains raw `python3 ~/scripts/...` inside a code block — delegate to the relevant skill instead\")\n  }\n\n  // --- REVIEW: deploy/ssh/email/gitlab skills with no references frontmatter ---\n  const infraCategory = [\"deploy\", \"ssh\", \"email\", \"gitlab\", \"ops\"]\n  const cat = (fm.category || \"\").toLowerCase()\n  const tags = (fm.tags || []).map(t => t.toLowerCase())\n  const looksInfra =\n    infraCategory.includes(cat) ||\n    tags.some(t => infraCategory.includes(t)) ||\n    /\\b(deploy|ssh|gitlab|hotmail|server|host)\\b/i.test(fm.description || \"\")\n  if (looksInfra && (!fm.references || fm.references.length === 0)) {\n    if (verdict === \"PASS\") verdict = \"REVIEW\"\n    reasons.push(\n      \"infrastructure-flavored skill has no `references:` frontmatter — facts should be cited from the registry\",\n    )\n  }\n\n  // --- REVIEW: raw IP/email patterns embedded that look like deterministic facts ---\n  const ipMatches = body.match(/\\b\\d{1,3}(?:\\.\\d{1,3}){3}\\b/g)\n  if (ipMatches && ipMatches.length > 0) {\n    const known = new Set(\n      [...references.byId.values()].flatMap(c =>\n        Object.values(c.fields).filter(v => typeof v === \"string\"),\n      ),\n    )\n    const stranded = ipMatches.filter(ip => !known.has(ip))\n    if (stranded.length > 0) {\n      if (verdict === \"PASS\") verdict = \"REVIEW\"\n      reasons.push(\n        `body contains raw IP(s) not in the registry: ${[...new Set(stranded)].slice(0, 3).join(\", \")}`,\n      )\n    }\n  }\n\n  return { skill, name: fm.name, verdict, reasons }\n}\n\n/**\n * Audit every recipe-required skill: if a recipe lists a skill name that has\n * no SKILL.md, report it as a FAILING phantom-skill row. The non-existent\n * skill is reported under its required name with skill=null.\n */\nexport function auditMissingSkills(\n  recipes: RecipeIndex,\n  knownSkillNames: Set<string>,\n): SkillAuditResult[] {\n  const required = new Set<string>()\n  for (const recipe of recipes.recipes) {\n    for (const s of recipe.skills) required.add(s)\n  }\n  const results: SkillAuditResult[] = []\n  for (const name of required) {\n    if (!knownSkillNames.has(name)) {\n      results.push({\n        skill: null,\n        name,\n        verdict: \"FAILING\",\n        reasons: [`required by a recipe, but no SKILL.md is installed`],\n      })\n    }\n  }\n  return results\n}\n\n/**\n * Convenience: audit every skill in `input.skills`, plus phantom-skill rows.\n */\nexport function auditAll(input: AuditInput): SkillAuditResult[] {\n  const knownNames = new Set(input.skills.map(s => s.frontmatter.name))\n  const results = input.skills.map(s =>\n    auditSkill(s, input.references, input.recipes, knownNames),\n  )\n  return [...results, ...auditMissingSkills(input.recipes, knownNames)]\n}\n\nfunction containsRawScriptInCodeFence(body: string): boolean {\n  let inFence = false\n  for (const line of body.split(\"\\n\")) {\n    if (/^\\s*```/.test(line)) {\n      inFence = !inFence\n      continue\n    }\n    if (inFence && /python3\\s+~\\/scripts\\//.test(line)) return true\n  }\n  return false\n}\n\nfunction referenceResolves(ref: string, idx: ReferenceIndex): boolean {\n  if (ref.endsWith(\".*\")) {\n    const prefix = ref.slice(0, -2)\n    for (const id of idx.byId.keys()) {\n      if (id === prefix || id.startsWith(`${prefix}.`)) return true\n    }\n    return false\n  }\n  return idx.byId.has(ref)\n}\n"],"mappings":"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","names":["auditSkill","skill","references","recipes","knownSkillNames","reasons","fm","body","verdict","ref","referenceResolves","delegate","containsRawScriptInCodeFence","infraCategory","cat","tags","t","ipMatches","known","c","v","stranded","ip","auditMissingSkills","required","recipe","results","name","auditAll","input","knownNames","s","inFence","line","idx","prefix","id"]}