aero-agent-roles 1.1.0 → 1.2.0

package/lib/mcp.js

@@ -2,12 +2,44 @@
 // Same wire protocol and host-config shape as Aero Agent Skills' MCP
 // server (JetBrains AI Assistant/Junie, Claude Desktop, VS Code, Cursor,
 // Windsurf all speak this identically) — implements initialize, ping,
-// tools/list, tools/call; anything else gets -32601, and requests without
-// an id are notifications and never answered. Offline: every answer comes
-// from the bundled manifest — no network, ever.
+// tools/list, tools/call, plus the SEP-2640 resources model
+// (resources/list, resources/read over role:// URIs) so roles are
+// discoverable as resources, not only through tool calls. Anything else
+// gets -32601, and requests without an id are notifications and never
+// answered. Offline: every answer comes from the bundled manifest — no
+// network, ever.
 'use strict';
 
-const { Catalog, version } = require('./catalog');
+const { Catalog, tokens, version } = require('./catalog');
+const fs = require('fs');
+const path = require('path');
+
+/* Reverse binding index: skill leaf path -> [role slugs that bind it].
+   Built once from ROLE.md frontmatter (skills_bound), cached. Lets a host
+   answer "which role owns the deliverable for this skill?" offline. */
+let _reverseCache = null;
+function reverseIndex(catalog) {
+  if (_reverseCache) return _reverseCache;
+  const inv = new Map();
+  const root = catalog.root; // roles tree (repo checkout or bundled)
+  for (const r of catalog.roles) {
+    const roleMd = path.join(root, r.slug, 'ROLE.md');
+    let text = '';
+    try { text = fs.readFileSync(roleMd, 'utf8'); } catch (e) { continue; }
+    const m = text.match(/^---\n([\s\S]*?)\n---/);
+    if (!m) continue;
+    const fm = m[1];
+    const block = fm.match(/^skills_bound:([\s\S]*?)(?=^[a-z_]+:|\Z)/m);
+    if (!block) continue;
+    for (const lm of block[1].matchAll(/^\s+-\s+([a-z0-9\-/]+)/gm)) {
+      const leaf = lm[1];
+      if (!inv.has(leaf)) inv.set(leaf, []);
+      inv.get(leaf).push(r.slug);
+    }
+  }
+  _reverseCache = inv;
+  return _reverseCache;
+}
 
 const TOOLS = [
   {
@@ -73,6 +105,21 @@ const TOOLS = [
       additionalProperties: false,
     },
   },
+  {
+    name: 'suggest_role',
+    description: 'Reverse binding: given a bound skill leaf path (e.g. avionics/do178c/planning) '
+      + 'or a task in plain words, return the role(s) that own the end-to-end deliverable for it. '
+      + 'Use when a loaded skill says "who executes this method?" — the role pulls the skill '
+      + 'forward; this tool inverts the map. For a task query it ranks roles by title/domain overlap.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        skill: { type: 'string', description: 'Bound skill leaf path (family/pack/skill).' },
+        task: { type: 'string', description: 'Plain-words task to rank roles for (alternative to skill).' },
+      },
+      additionalProperties: false,
+    },
+  },
 ];
 
 function text(t) {
@@ -134,11 +181,71 @@ function callTool(catalog, name, args) {
         `${s.id}: ${s.name}\n  publisher: ${s.publisher}${s.gated ? ' (gated: no verbatim text)' : ''}\n  roles: ${s.roles.join(', ')}`)
         .join('\n\n'));
     }
+    case 'suggest_role': {
+      const inv = reverseIndex(catalog);
+      if (args.skill) {
+        const skill = String(args.skill).replace(/\/+$/, '');
+        const roles = inv.get(skill) || [];
+        if (roles.length === 0) {
+          const prefixHits = [...inv.entries()].filter(([p]) => p.startsWith(skill + '/')).slice(0, 10);
+          if (prefixHits.length === 0) return toolError(`no role binds skill '${skill}' (unbound leaf — wave candidate).`);
+          return text(`leaves under ${skill} bound by roles:\n` + prefixHits.map(([p, rs]) => `${p}: ${rs.join(', ')}`).join('\n'));
+        }
+        return text(`${skill}\n  bound by roles:\n` + roles.map((r) => `    -> roles/${r}/ROLE.md`).join('\n'));
+      }
+      if (args.task) {
+        const q = new Set(tokens(String(args.task)));
+        const scored = catalog.roles.map((r) => {
+          const hay = new Set(tokens(`${r.title} ${r.deliverable_type} ${r.domain} ${r.slug}`));
+          let s = 0; for (const w of q) if (hay.has(w)) s += 1;
+          return { r, s };
+        }).filter((x) => x.s > 0).sort((a, b) => b.s - a.s || (a.r.slug < b.r.slug ? -1 : 1)).slice(0, 8);
+        if (scored.length === 0) return toolError('no role matches that task. Call list_domains to browse.');
+        return text(scored.map(({ r, s }) => `${r.slug} (score ${s}): ${r.title} — ${r.deliverable_type}`).join('\n'));
+      }
+      return toolError('suggest_role needs a skill leaf path or a task query.');
+    }
     default:
       return toolError(`unknown tool '${name}'`);
   }
 }
 
+function resourcesList(catalog) {
+  // SEP-2640: roles are resources under the role:// namespace. Every role
+  // is listed so hosts can enumerate without guessing slugs; domains are
+  // collection URIs.
+  const out = [];
+  const seen = new Set();
+  const push = (uri, name, kind) => {
+    if (seen.has(uri)) return;
+    seen.add(uri);
+    out.push({ uri, name, mimeType: 'text/markdown', description: `${kind} — ${name}` });
+  };
+  for (const r of catalog.roles) {
+    push(`role://${r.slug}`, r.slug, 'role');
+    push(`role://${r.domain}`, r.domain, 'role domain');
+  }
+  push('role://', 'role bank root', 'role');
+  return out;
+}
+
+function readResource(catalog, uri) {
+  const u = String(uri || '');
+  if (u === 'role://' || u === 'role:') {
+    return text(`Aero Agent Roles — resource root\n\nDomains:\n${domainsSummary(catalog)}\n\nLoad a domain or role with role://<domain> or role://<slug>\n`);
+  }
+  if (!u.startsWith('role://')) return toolError(`unknown resource uri '${uri}' (expected role://…)`);
+  const path = u.slice('role://'.length).replace(/\/+$/, '');
+  if (!path) return text(`Aero Agent Roles — resource root\n\n${domainsSummary(catalog)}\n`);
+  const role = catalog.find(path);
+  if (role) return text(catalog.readRoleMd(role.slug));
+  const inDomain = catalog.roles.filter((r) => r.domain === path);
+  if (inDomain.length > 0) {
+    return text(`${path} — ${inDomain.length} roles\n` + inDomain.map((r) => `${r.slug}: ${r.title} — ${r.deliverable_type}`).join('\n'));
+  }
+  return toolError(`no role or domain '${path}'. Closest: ${catalog.search(path.replace(/-/g, ' '), 3).map((h) => h.role.slug).join(', ') || 'none'}`);
+}
+
 function serve() {
   const catalog = new Catalog();
   let buffer = '';
@@ -156,7 +263,10 @@ function serve() {
       case 'initialize':
         return reply(req.id, {
           protocolVersion: (req.params && req.params.protocolVersion) || '2025-06-18',
-          capabilities: { tools: { listChanged: false } },
+          capabilities: {
+            tools: { listChanged: false },
+            resources: { subscribe: false, listChanged: false },
+          },
           serverInfo: { name: 'aero-agent-roles', version: version() },
         });
       case 'ping':
@@ -169,6 +279,20 @@ function serve() {
         } catch (e) {
           return reply(req.id, toolError(`tool failed: ${e.message}`));
         }
+      case 'resources/list':
+        try {
+          return reply(req.id, { resources: resourcesList(catalog) });
+        } catch (e) {
+          return reply(req.id, undefined, { code: -32603, message: `resources/list failed: ${e.message}` });
+        }
+      case 'resources/read':
+        try {
+          const uri = req.params && req.params.uri;
+          const res = readResource(catalog, uri);
+          return reply(req.id, { contents: [{ uri, mimeType: 'text/markdown', text: res.content[0].text }] });
+        } catch (e) {
+          return reply(req.id, undefined, { code: -32603, message: `resources/read failed: ${e.message}` });
+        }
       default:
         if (isNotification) return undefined;
         return reply(req.id, undefined, { code: -32601, message: `method not found: ${req.method}` });
@@ -196,4 +320,4 @@ function serve() {
   process.stdin.on('end', () => process.exit(0));
 }
 
-module.exports = { serve, callTool, TOOLS };
+module.exports = { serve, callTool, TOOLS, resourcesList, readResource };

package/manifest.json

@@ -1,13 +1,26 @@
 {
  "schema": "aero-agent-roles/manifest@1",
  "counts": {
-  "roles": 25,
+  "roles": 38,
   "domains": 12,
-  "skills_bound": 466,
-  "tests": 966,
-  "standards": 22
+  "skills_bound": 597,
+  "tests": 1519,
+  "standards": 27
  },
  "roles": [
+  {
+   "slug": "adcs-engineer",
+   "title": "ADCS Engineer",
+   "domain": "space-systems",
+   "deliverable_type": "Attitude Determination and Control Subsystem Report",
+   "status": "draft",
+   "standards": [
+    "ecss"
+   ],
+   "skills_bound": 14,
+   "tests": 46,
+   "stage_preview": "adcs/pointing-error-budget -> adcs/environmental-disturbance-tor -> adcs/gravity-gradient-stabilizatio -> adcs/star-tracker -> adcs/magnetometer-calibration"
+  },
   {
    "slug": "aerodynamics-engineer",
    "title": "Aerodynamics Engineer",
@@ -34,6 +47,34 @@
    "tests": 27,
    "stage_preview": "constraint-analysis -> sizing-mission-profile -> openvsp-geometry -> ws-tw-trade -> weight-estimation + tow-estimation"
   },
+  {
+   "slug": "aircraft-performance-engineer",
+   "title": "Aircraft Performance Engineer",
+   "domain": "flight-mechanics",
+   "deliverable_type": "Aircraft Performance Analysis Report",
+   "status": "draft",
+   "standards": [
+    "far-25",
+    "far-29"
+   ],
+   "skills_bound": 9,
+   "tests": 73,
+   "stage_preview": "(workbook planning) -> flight-mechanics/performance/balan -> flight-mechanics/performance/prope -> flight-mechanics/performance/rotor -> flight-mechanics/performance/rotor"
+  },
+  {
+   "slug": "aircraft-systems-sizing-engineer",
+   "title": "Aircraft Systems Sizing Engineer",
+   "domain": "vehicle-design",
+   "deliverable_type": "Aircraft System Sizing Report",
+   "status": "draft",
+   "standards": [
+    "far-25",
+    "cs-25"
+   ],
+   "skills_bound": 14,
+   "tests": 30,
+   "stage_preview": "sizing/aircraft-electrical-load-an -> sizing/air-cycle-machine-sizing -> sizing/avionics-bay-cooling-sizing -> sizing/aircraft-oxygen-system-sizi -> sizing/brake-energy-sizing, sizing"
+  },
   {
    "slug": "airworthiness-compliance-engineer",
    "title": "Airworthiness Compliance Engineer",
@@ -61,6 +102,46 @@
    "tests": 32,
    "stage_preview": "as9100/internal-quality-audit -> as9100/document-control -> as9100/management-review -> as9100/risk-management + quality -> as9100/nonconformance-control + co"
   },
+  {
+   "slug": "autopilot-control-engineer",
+   "title": "Autopilot Control Engineer",
+   "domain": "gnc-autonomy",
+   "deliverable_type": "autopilot control law design package",
+   "status": "draft",
+   "standards": [
+    "mil-std-1797a"
+   ],
+   "skills_bound": 12,
+   "tests": 46,
+   "stage_preview": "gnc-autonomy/control/state-space-a -> gnc-autonomy/control/pid-control-d -> gnc-autonomy/control/frequency-res -> gnc-autonomy/control/root-locus-de -> gnc-autonomy/control/frequency-res"
+  },
+  {
+   "slug": "boundary-layer-engineer",
+   "title": "Boundary-Layer Engineer",
+   "domain": "aerodynamics",
+   "deliverable_type": "boundary-layer and viscous drag analysis report",
+   "status": "draft",
+   "standards": [
+    "naca-tr-824"
+   ],
+   "skills_bound": 10,
+   "tests": 27,
+   "stage_preview": "aerodynamics/boundary-layer/bounda -> aerodynamics/boundary-layer/squire -> aerodynamics/boundary-layer/mangle -> aerodynamics/boundary-layer/lamina -> aerodynamics/boundary-layer/rough-"
+  },
+  {
+   "slug": "composites-structures-engineer",
+   "title": "Composite Structures Engineer (Analysis + Certification Evidence)",
+   "domain": "structures",
+   "deliverable_type": "composite structure analysis + certification report",
+   "status": "draft",
+   "standards": [
+    "far-25",
+    "cmh-17"
+   ],
+   "skills_bound": 12,
+   "tests": 36,
+   "stage_preview": "cmh17-allowables -> laminate-stiffness, laminate-first -> failure-criteria, laminate-first-p -> laminate-hygrothermal-response -> laminate-plate-buckling"
+  },
   {
    "slug": "data-bus-avionics-engineer",
    "title": "Data Bus / Avionics Network Engineer",
@@ -129,6 +210,21 @@
    "tests": 41,
    "stage_preview": "isa-atmosphere + density-altitude  -> finite-difference-derivatives + nu -> least-squares-regression + optimiz -> eigenvalue-decomposition + singula -> fast-fourier-transform + fir-filte"
   },
+  {
+   "slug": "fem-analysis-engineer",
+   "title": "Finite Element Analysis Engineer",
+   "domain": "structures",
+   "deliverable_type": "Finite Element Analysis Report",
+   "status": "draft",
+   "standards": [
+    "far-25",
+    "cs-25",
+    "mmpsd"
+   ],
+   "skills_bound": 8,
+   "tests": 27,
+   "stage_preview": "structures/fem/truss-analysis -> structures/fem/beam-frame-analysis -> structures/fem/beam-column-analysi -> structures/fem/buckling-analysis -> structures/fem/beam-vibration"
+  },
   {
    "slug": "flight-management-engineer",
    "title": "Flight Management Engineer",
@@ -158,6 +254,19 @@
    "tests": 42,
    "stage_preview": "breguet-range + breguet-endurance  -> climb-performance + descent-perfor -> oei-climb-gradient + energy-height -> rotorcraft-hover-performance + rot -> longitudinal-stability + lateral-d"
   },
+  {
+   "slug": "flight-software-engineer",
+   "title": "Flight Software Engineer",
+   "domain": "avionics",
+   "deliverable_type": "Flight Software Design and Verification Plan",
+   "status": "draft",
+   "standards": [
+    "do-178c"
+   ],
+   "skills_bound": 4,
+   "tests": 54,
+   "stage_preview": "avionics/fsw/cfs-architecture -> avionics/fsw/fprime-component -> avionics/fsw/fprime-component -> avionics/fsw/cfs-architecture -> avionics/fsw/real-time-scheduling"
+  },
   {
    "slug": "flight-test-engineer",
    "title": "Flight Test Engineer",
@@ -186,6 +295,20 @@
    "tests": 45,
    "stage_preview": "flight-test-data-reduction -> (ISA physics, climb leaf method) -> takeoff-distance-determination + e -> landing-distance-determination -> level-acceleration-test + engine-f"
   },
+  {
+   "slug": "flight-test-planning-engineer",
+   "title": "Flight Test Planning Engineer",
+   "domain": "flight-test-operations",
+   "deliverable_type": "Flight Test Plan and Requirements Traceability",
+   "status": "draft",
+   "standards": [
+    "far-25",
+    "cs-25"
+   ],
+   "skills_bound": 7,
+   "tests": 54,
+   "stage_preview": "role core (standalone traceability -> flight-test-operations/planning/te -> flight-test-operations/planning/fl -> flight-test-operations/planning/te -> flight-test-operations/planning/pc"
+  },
   {
    "slug": "gnc-engineer",
    "title": "Guidance, Navigation and Control (GNC) Engineer",
@@ -241,6 +364,21 @@
    "tests": 49,
    "stage_preview": "mbse/requirements-modeling -> mbse/systems-engineering -> mbse/sysml-modeling -> mbse/systems-engineering -> mbse/trade-study-analysis, mbse/sy"
   },
+  {
+   "slug": "navigation-engineer",
+   "title": "Navigation Engineer",
+   "domain": "gnc-autonomy",
+   "deliverable_type": "navigation architecture and position error analysis report",
+   "status": "draft",
+   "standards": [
+    "do-229",
+    "do-208",
+    "icao-annex-10"
+   ],
+   "skills_bound": 13,
+   "tests": 27,
+   "stage_preview": "navigation-frames -> inertial-navigation -> gnss-pseudorange-positioning + dil -> gnss-raim-fde -> gnss-carrier-smoothing + gnss-dopp"
+  },
   {
    "slug": "ndt-engineer",
    "title": "NDT Engineer",
@@ -281,6 +419,32 @@
    "tests": 31,
    "stage_preview": "gas-turbine-cycle + real-cycle-eff -> bypass-ratio-trade + regenerative- -> turbofan-off-design -> compressor-map + multi-stage-compr -> turbine-blade-cooling"
   },
+  {
+   "slug": "quality-management-engineer",
+   "title": "AS9100 Quality Management Engineer",
+   "domain": "manufacturing-quality",
+   "deliverable_type": "AS9100 quality management system audit report",
+   "status": "draft",
+   "standards": [
+    "as9100"
+   ],
+   "skills_bound": 10,
+   "tests": 42,
+   "stage_preview": "manufacturing-quality/as9100/gage- -> manufacturing-quality/as9100/gage- -> manufacturing-quality/as9100/attri -> manufacturing-quality/as9100/stati -> manufacturing-quality/as9100/indiv"
+  },
+  {
+   "slug": "rocket-propulsion-engineer",
+   "title": "Rocket Propulsion Engineer",
+   "domain": "propulsion",
+   "deliverable_type": "rocket propulsion system design report",
+   "status": "draft",
+   "standards": [
+    "ecss"
+   ],
+   "skills_bound": 14,
+   "tests": 38,
+   "stage_preview": "propulsion/rocket/propellant-selec -> propulsion/rocket/rocket-sizing, r -> propulsion/rocket/rocket-gravity-l -> propulsion/rocket/rocket-engine-cy -> propulsion/rocket/combustion-chamb"
+  },
   {
    "slug": "safety-assessment-engineer",
    "title": "Safety Assessment Engineer (ARP4761A)",
@@ -310,6 +474,20 @@
    "tests": 33,
    "stage_preview": "mission-delta-v-budget + keplerian -> hohmann-transfer + bi-elliptic-tra -> launch-window-analysis + c3-depart -> satellite-coverage + walker-delta- -> eclipse-time + orbital-perturbatio"
   },
+  {
+   "slug": "stability-control-flight-test-engineer",
+   "title": "Stability and Control Flight Test Engineer",
+   "domain": "flight-test-operations",
+   "deliverable_type": "Stability and Control Flight Test Report",
+   "status": "draft",
+   "standards": [
+    "far-25",
+    "cs-25"
+   ],
+   "skills_bound": 4,
+   "tests": 53,
+   "stage_preview": "(item facts; no leaf) -> flight-test-operations/stability/s -> flight-test-operations/stability/d -> flight-test-operations/stability/l -> flight-test-operations/stability/c"
+  },
   {
    "slug": "state-estimation-engineer",
    "title": "State Estimation Engineer",
@@ -412,7 +590,8 @@
    "gated": true,
    "roles": [
     "as9100-quality-auditor",
-    "ndt-engineer"
+    "ndt-engineer",
+    "quality-management-engineer"
    ]
   },
   {
@@ -433,16 +612,29 @@
     "engineering-analysis-engineer"
    ]
   },
+  {
+   "id": "cmh-17",
+   "name": "cmh-17",
+   "publisher": "unknown",
+   "gated": true,
+   "roles": [
+    "composites-structures-engineer"
+   ]
+  },
   {
    "id": "cs-25",
    "name": "EASA CS-25, Certification Specifications",
    "publisher": "EASA",
    "gated": true,
    "roles": [
+    "aircraft-systems-sizing-engineer",
     "airworthiness-compliance-engineer",
+    "fem-analysis-engineer",
     "flight-test-performance-engineer",
+    "flight-test-planning-engineer",
     "guidance-engineer",
-    "safety-assessment-engineer"
+    "safety-assessment-engineer",
+    "stability-control-flight-test-engineer"
    ]
   },
   {
@@ -460,7 +652,26 @@
    "publisher": "RTCA/EUROCAE",
    "gated": true,
    "roles": [
-    "do178c-cert-engineer"
+    "do178c-cert-engineer",
+    "flight-software-engineer"
+   ]
+  },
+  {
+   "id": "do-208",
+   "name": "RTCA DO-208, Minimum Operational Performance Standards for Airborne Supplemental Navigation Equipment Using GPS",
+   "publisher": "RTCA",
+   "gated": true,
+   "roles": [
+    "navigation-engineer"
+   ]
+  },
+  {
+   "id": "do-229",
+   "name": "RTCA DO-229, Minimum Operational Performance Standards for GPS/WAAS Airborne Equipment",
+   "publisher": "RTCA",
+   "gated": true,
+   "roles": [
+    "navigation-engineer"
    ]
   },
   {
@@ -496,6 +707,8 @@
    "publisher": "ECSS",
    "gated": true,
    "roles": [
+    "adcs-engineer",
+    "rocket-propulsion-engineer",
     "space-systems-engineer"
    ]
   },
@@ -507,15 +720,30 @@
    "roles": [
     "aerodynamics-engineer",
     "aircraft-design-engineer",
+    "aircraft-performance-engineer",
+    "aircraft-systems-sizing-engineer",
     "airworthiness-compliance-engineer",
+    "composites-structures-engineer",
+    "fem-analysis-engineer",
     "flight-mechanics-engineer",
     "flight-test-engineer",
     "flight-test-performance-engineer",
+    "flight-test-planning-engineer",
     "guidance-engineer",
     "safety-assessment-engineer",
+    "stability-control-flight-test-engineer",
     "structures-loads-engineer"
    ]
   },
+  {
+   "id": "far-29",
+   "name": "far-29",
+   "publisher": "unknown",
+   "gated": true,
+   "roles": [
+    "aircraft-performance-engineer"
+   ]
+  },
   {
    "id": "far-33",
    "name": "14 CFR Part 33, Airworthiness Standards: Aircraft Engines",
@@ -525,6 +753,15 @@
     "propulsion-engineer"
    ]
   },
+  {
+   "id": "icao-annex-10",
+   "name": "ICAO Annex 10, Aeronautical Telecommunications (Vol I: Radio Navigation Aids)",
+   "publisher": "ICAO",
+   "gated": true,
+   "roles": [
+    "navigation-engineer"
+   ]
+  },
   {
    "id": "mil-std-1553",
    "name": "MIL-STD-1553B, Digital Time Division Command/Response Multiplex Data Bus",
@@ -538,8 +775,9 @@
    "id": "mil-std-1797a",
    "name": "MIL-STD-1797A, Flying Qualities of Piloted Aircraft",
    "publisher": "US DoD",
-   "gated": false,
+   "gated": true,
    "roles": [
+    "autopilot-control-engineer",
     "flight-mechanics-engineer",
     "flight-test-engineer",
     "gnc-engineer"
@@ -551,6 +789,7 @@
    "publisher": "Battelle / FAA",
    "gated": true,
    "roles": [
+    "fem-analysis-engineer",
     "structures-loads-engineer"
    ]
   },
@@ -560,6 +799,7 @@
    "publisher": "NACA/NASA (public domain)",
    "gated": true,
    "roles": [
+    "boundary-layer-engineer",
     "high-speed-aerodynamics-engineer"
    ]
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aero-agent-roles",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "The role layer for aerospace engineering agents: professional roles that bind verified Aero Agent Skills into end-to-end deliverables, with evidence gates and a human sign-off. A CLI and an MCP server. By Ashforde OU.",
   "license": "Apache-2.0",
   "author": "Ashforde OU <contact@ashforde.org> (https://ashforde.org)",
@@ -22,7 +22,9 @@
   ],
   "scripts": {
     "prepack": "node scripts/prepack.js",
-    "test": "node test/smoke.mjs"
+    "test": "node test/smoke.mjs",
+    "mcp": "node bin/aero-agent-roles.js mcp",
+    "mcp:verify": "node test/smoke.mjs"
   },
   "engines": {
     "node": ">=18"