@hybridlabor-api/aos 4.16.0 → 4.18.0

package/mcps/mcsc/packages/core/src/adapters/codex.js

@@ -1,5 +1,6 @@
 import { spawn } from 'node:child_process';
 import { emitTrail } from '../trail.js';
+import { childEnv } from '../depth.js';
 
 const MAX_OUTPUT = 1024 * 1024 * 50; // 50MB, mirrors the old execFile maxBuffer
 
@@ -39,7 +40,7 @@ export async function delegate(req) {
   };
   emitTrail({ ...trailEvent, hook_event_name: 'SessionStart' });
 
-  const env = { ...process.env, MCSC_CALLER: 'codex' };
+  const env = childEnv('codex');
   const args = ['exec', '--json', '--skip-git-repo-check'];
   if (req.model) args.push('-m', req.model);
   args.push(req.prompt);

package/mcps/mcsc/packages/core/src/adapters/opencode.js

@@ -1,6 +1,7 @@
 import { spawn } from 'node:child_process';
 import path from 'node:path';
 import { emitTrail } from '../trail.js';
+import { childEnv } from '../depth.js';
 
 const MAX_OUTPUT = 1024 * 1024 * 50; // 50MB, mirrors the old execFile maxBuffer
 
@@ -25,7 +26,7 @@ export async function delegate(req) {
   };
   emitTrail({ ...trailEvent, hook_event_name: 'SessionStart' });
 
-  const env = { ...process.env, MCSC_CALLER: 'opencode' };
+  const env = childEnv('opencode');
   const args = ['run', '--auto', '--format', 'json'];
   if (req.model) args.push('--model', req.model);
   if (req.variant) args.push('--variant', String(req.variant));

package/mcps/mcsc/packages/core/src/depth.js

@@ -0,0 +1,16 @@
+// One level of delegation, like a fork: every adapter raises MCSC_DEPTH for its child,
+// and a server that starts with depth >= MAX_DEPTH refuses to delegate.
+export const MAX_DEPTH = 1;
+
+export const currentDepth = (env = process.env) => {
+  const n = Number.parseInt(env.MCSC_DEPTH ?? '', 10);
+  return Number.isInteger(n) && n > 0 ? n : 0;
+};
+
+export const childEnv = (caller, env = process.env) => ({
+  ...env,
+  MCSC_CALLER: caller,
+  MCSC_DEPTH: String(currentDepth(env) + 1),
+});
+
+export const depthExceeded = (env = process.env) => currentDepth(env) >= MAX_DEPTH;

package/mcps/mcsc/packages/mcp/server.js

@@ -11,6 +11,7 @@ import { getCached, setCached } from "../core/src/detect/cache.js";
 import { delegate as agyDelegate } from "../core/src/adapters/agy.js";
 import { delegate as opencodeDelegate } from "../core/src/adapters/opencode.js";
 import { delegate as codexDelegate } from "../core/src/adapters/codex.js";
+import { depthExceeded } from "../core/src/depth.js";
 import { decide } from "../core/src/rulebook/resolve.js";
 import { loadRulebook } from "../core/src/rulebook/load.js";
 import { buildOfferTable } from "../core/src/capabilities/buildOfferTable.js";
@@ -92,13 +93,14 @@ const server = new Server(
 // --- Tool Registration ---
 server.setRequestHandler(ListToolsRequestSchema, async () => {
   const tools = [];
+  if (depthExceeded()) return { tools };
 
   // delegate_agy
   const agyHealth = inventory.get('agy');
   if (agyHealth && agyHealth.status === 'ready' && caller !== 'agy') {
     tools.push({
       name: "delegate_agy",
-      description: "Delegate a task to Antigravity CLI (Gemini 3.8 Flash or Claude 3.7 Sonnet). Provides full coding capabilities.",
+      description: "Delegate a READ-ONLY task to Antigravity CLI (Gemini 3.8 Flash or Claude 3.7 Sonnet). Write tasks are untested: do not rely on it for edits.",
       inputSchema: {
         type: "object",
         properties: {
@@ -110,6 +112,10 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             type: "string",
             description: "Optional model hint for the subagent (e.g., 'flash', 'pro'). Default varies by tool.",
             default: "flash"
+          },
+          write: {
+            type: "boolean",
+            description: "UNTESTED. Adds --mode accept-edits for a write task. Leave unset: delegate_agy is documented read-only."
           }
         },
         required: ["prompt"]
@@ -194,7 +200,13 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
 
 // --- Tool Execution ---
 server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
-  const { name, arguments: args } = request.params;
+  const { name, arguments: args = {} } = request.params;
+  if (depthExceeded()) {
+    return {
+      content: [{ type: "text", text: "Delegation refused: MCSC_DEPTH limit reached (one level of delegation, like a fork). Do the task yourself." }],
+      isError: true,
+    };
+  }
   const signal = extra.signal;
 
   const req = {
@@ -202,6 +214,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request, extra) => {
     prompt: args.prompt,
     model: args.model,
     variant: args.variant,
+    write: args.write === true,
     signal
   };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hybridlabor-api/aos",
-  "version": "4.16.0",
+  "version": "4.18.0",
   "description": "AOS — A Curated AI AGENT OS. Optimized agent skills and add-ons like memB, OpenWiki, Heimdall Token Saver, and Godmode architectures.",
   "main": "installer.js",
   "engines": {
@@ -29,7 +29,7 @@
     "plugin:build": "node scripts/build-plugin-manifest.mjs",
     "plugin:check": "node scripts/build-plugin-manifest.mjs --check",
     "doctor": "node bin/aos-doctor.mjs",
-    "test": "node scripts/validate-skills.mjs --selftest && node scripts/validate-skills.mjs && node scripts/build-plugin-manifest.mjs --check && node --test tests/opencode-graph-gate.test.js && node --test tests/cross-harness-hooks.test.js && node --test tests/plan-canvas-security.test.mjs && node --test tests/plan-canvas-modes.test.mjs && node --test tests/swarm-wiring.test.js && node tests/aos-store.test.mjs && node --test tests/aos-store-ui.test.mjs && node tests/aos-store-scenario.test.mjs && node tests/aos-doctor.test.mjs && node tests/build-plugin-manifest.test.mjs && node --test tests/agent-models.test.js && node --test tests/installer-p3.test.js && node --test tests/installer-binary.test.js && node --test tests/installer-version.test.js && node --test tests/mcsc-server.test.js && node --test tests/antigravity-hooks.test.js && node --test tests/windows-hooks.test.js && node --test tests/plan-builder.test.mjs && node --test tests/plan-builder-trail.test.mjs && node --test tests/plan-builder-showcase.test.mjs && node --test tests/plan-builder-templates.test.mjs && node --test tests/plan-canvas-home.test.mjs && node --test tests/launchpad-installer.test.js && node --test tests/launchpad-plan-canvas.test.js && node --test tests/go-token.test.js && node --test tests/master-session-skill.test.js && node --test tests/aos-acp.test.js && node --test tests/opencode-go-token.test.js && node --test tests/opencode-adapter.test.js && node --test tests/pr-recap.test.mjs && node --test tests/bdb-visual-edit.test.mjs && node --test tests/opencode-trail-autostart.test.mjs && node --test tests/trail-autostart-hook.test.mjs && node --test tests/agenttrail-ensure.test.mjs && node --test tests/aos-bus.test.js && node --test tests/installer-quick-update.test.js"
+    "test": "node scripts/validate-skills.mjs --selftest && node scripts/validate-skills.mjs && node scripts/build-plugin-manifest.mjs --check && node --test tests/opencode-graph-gate.test.js && node --test tests/cross-harness-hooks.test.js && node --test tests/plan-canvas-security.test.mjs && node --test tests/plan-canvas-modes.test.mjs && node --test tests/swarm-wiring.test.js && node tests/aos-store.test.mjs && node --test tests/aos-store-ui.test.mjs && node tests/aos-store-scenario.test.mjs && node tests/aos-doctor.test.mjs && node tests/build-plugin-manifest.test.mjs && node --test tests/plugin-commands.test.js && node --test tests/playbooks.test.mjs && node --test tests/agent-models.test.js && node --test tests/installer-p3.test.js && node --test tests/plugin-migration.test.js && node --test tests/installer-binary.test.js && node --test tests/installer-version.test.js && node --test tests/mcsc-server.test.js && node --test tests/antigravity-hooks.test.js && node --test tests/windows-hooks.test.js && node --test tests/plan-builder.test.mjs && node --test tests/plan-builder-trail.test.mjs && node --test tests/plan-builder-showcase.test.mjs && node --test tests/plan-builder-templates.test.mjs && node --test tests/plan-canvas-home.test.mjs && node --test tests/launchpad-installer.test.js && node --test tests/launchpad-plan-canvas.test.js && node --test tests/go-token.test.js && node --test tests/go-gate-modes.test.js && node --test tests/go-gate-review.test.js && node --test tests/go-gate-review2.test.js && node --test tests/opencode-gogate.test.js && node --test tests/master-session-skill.test.js && node --test tests/aos-acp.test.js && node --test tests/opencode-go-token.test.js && node --test tests/opencode-adapter.test.js && node --test tests/opencode-install.test.js && node --test tests/pr-recap.test.mjs && node --test tests/bdb-visual-edit.test.mjs && node --test tests/opencode-trail-autostart.test.mjs && node --test tests/trail-autostart-hook.test.mjs && node --test tests/agenttrail-ensure.test.mjs && node --test tests/aos-bus.test.js && node --test tests/installer-quick-update.test.js && node --test tests/no-builderio-visual.test.mjs && node --test tests/retired-skills.test.mjs && node --test tests/plan-canvas-annotate-server.test.mjs && node --test tests/plan-canvas-annotation-schema.test.mjs && node --test tests/plan-canvas-annotate-client.test.mjs && node --test tests/plan-canvas-trail-on-approve.test.mjs && node --test tests/plan-canvas-revive.test.mjs && node --test tests/plan-canvas-route.test.mjs && node --test tests/bdb-visual-edit-locate.test.mjs && node --test tests/agenttrail-worktrees.test.mjs && node --test tests/plan-canvas-e2e-app.test.mjs && node --test tests/plan-canvas-r1.test.mjs && node --test tests/agenttrail-lanes.test.mjs && node --test tests/memb-ambient.test.js && node --test tests/mcsc-depth.test.js && node --test tests/go-check.test.js && node --test tests/coordination-hygiene.test.js && node --test tests/codex-gate-smoke.test.js && node --test tests/setup-subagents-resolve.test.js && node --test tests/codenotch.test.js"
   },
   "publishConfig": {
     "access": "public"
@@ -54,6 +54,11 @@
     ".agents/",
     ".claude/",
     ".codex-plugin/",
+    "plugin.json",
+    "plugin-commands.json",
+    "commands/",
+    "agy-commands/",
+    "plugins/bdb-aos-codex/",
     ".opencode/",
     "docs/",
     "!docs/handover/**",

package/plugin-commands.json

@@ -0,0 +1,143 @@
+{
+  "commands": {
+    "setup": {
+      "description": "Bring this machine to a complete, verified AOS installation (skills, MCP servers, gate hooks, memB, OpenWiki, Synapse).",
+      "skills": [
+        "aos-setup"
+      ],
+      "bodies": {
+        "claude": "Run the `aos-setup` skill for this machine. Report what is installed, what was repaired and what is still missing. Arguments: $ARGUMENTS"
+      }
+    },
+    "init": {
+      "description": "Set up the current project folder for AOS: slug, wiki, memory, Synapse map, AGENTS.md.",
+      "skills": [
+        "aos-project-init"
+      ],
+      "bodies": {
+        "claude": "Run the `aos-project-init` skill for the current project folder. This is project setup, not machine setup (that is `/bdb-aos:setup`). Arguments: $ARGUMENTS"
+      }
+    },
+    "doctor": {
+      "description": "Check the machine and the current project, and print suggested permissions.allow entries without writing any settings.",
+      "skills": [
+        "aos-project-init"
+      ],
+      "bodies": {
+        "claude": "Run `aos-doctor` (machine check) and report the result. If the current folder is an AOS project, also run the project check `node <aos-project-init skill dir>/scripts/aos-project-doctor.mjs` (it covers `.aos/project.json`, AGENTS.md and the wiki). Print suggested `permissions.allow` entries as text for the human to copy. Never write to settings.json or settings.local.json. Arguments: $ARGUMENTS"
+      }
+    },
+    "store": {
+      "description": "Browse and preview AOS skills, agents and playbooks in the local store UI.",
+      "skills": [
+        "aos-store"
+      ],
+      "bodies": {
+        "claude": "Start the `aos-store` interface. Preview freely, but install nothing until the human says yes for that specific item. Arguments: $ARGUMENTS"
+      }
+    },
+    "mastersession": {
+      "description": "Supervise other Claude Code sessions on this machine: roster, status requests, GO board, idle notices.",
+      "skills": [
+        "master-session"
+      ],
+      "bodies": {
+        "claude": "Act as the master session with the `master-session` skill (ACP bridge: `bin/aos-acp.mjs`, see docs/master-session-acp.md). Keep the overview, relay the human's decisions, never decide for the human. Arguments: $ARGUMENTS"
+      }
+    },
+    "orchestrator": {
+      "description": "Coordinate parallel coding agents across repositories through the AO daemon.",
+      "skills": [
+        "ao-orchestrator"
+      ],
+      "bodies": {
+        "claude": "Use the `ao-orchestrator` skill. It needs the AO daemon; check that it is running first and stop with a clear message if not. Do not confuse it with `agent-orchestrator`. Arguments: $ARGUMENTS"
+      }
+    },
+    "plan": {
+      "description": "Plan end to end: draft, render in plan-canvas or Plan Builder, annotate, await approval, then hand off.",
+      "skills": [
+        "concise-planning",
+        "plan-canvas",
+        "writing-plans"
+      ],
+      "bodies": {
+        "claude": "Run the full planning pipeline: 1) draft the plan with `concise-planning`; 2) always offer the choice between plan-canvas and Plan Builder (`aos-plan-canvas open <dir> --mode bdb-plan-builder`) for rendering; 3) collect annotations and wait for the human's approval; 4) only after approval continue with `writing-plans` or `/bdb-aos:graph`. Topic: $ARGUMENTS"
+      }
+    },
+    "brainstorm": {
+      "description": "Brainstorm a topic with the matching skill: bdbrainstorm, bdbmediastorm for event tech, grill-me for a stress test.",
+      "skills": [
+        "bdbrainstorm",
+        "bdbmediastorm",
+        "grill-me"
+      ],
+      "bodies": {
+        "claude": "Pick by topic: `bdbmediastorm` for live event technology and show control, `grill-me` when the human wants an existing idea stress-tested, `bdbrainstorm` otherwise. Say which one you chose. Topic: $ARGUMENTS"
+      }
+    },
+    "startproject": {
+      "description": "Start a new composition: project init, brainstorm, then ask whether graph or startcycle follows.",
+      "skills": [
+        "aos-project-init",
+        "bdbrainstorm",
+        "startcycle-graph",
+        "startcycle"
+      ],
+      "bodies": {
+        "claude": "Sequence: 1) `aos-project-init`; 2) `bdbrainstorm`; 3) stop and ask the human whether `/bdb-aos:graph` (startcycle-graph) or `startcycle` follows. Do not start a pipeline on your own. Idea: $ARGUMENTS"
+      }
+    },
+    "graph": {
+      "description": "Run the startcycle-graph pipeline: durable state, repair loop, quality gate, escalation.",
+      "skills": [
+        "startcycle-graph"
+      ],
+      "bodies": {
+        "claude": "Run the `startcycle-graph` skill; its contract defines the flow. Task: $ARGUMENTS"
+      }
+    },
+    "shipping": {
+      "description": "Pre-ship framing and the technical release gate, with approvals under the go-gate rules.",
+      "skills": [
+        "bdb-shipping-skill",
+        "godmode-shipping"
+      ],
+      "bodies": {
+        "claude": "Use `bdb-shipping-skill` for the pre-flight and `godmode-shipping` for the gate. The playbook `pb-ship` can drive the whole flow. Push, merge and publish need the human's GO under the go-gate rules; never request one on the human's behalf. Arguments: $ARGUMENTS"
+      }
+    },
+    "memb": {
+      "description": "Query or store long-term memory with memB.",
+      "skills": [
+        "memb-skill",
+        "memb-ingest"
+      ],
+      "bodies": {
+        "claude": "Use `memb-skill` to search or remember and `memb-ingest` to import material. Never store secrets, tokens or credentials. Arguments: $ARGUMENTS"
+      }
+    },
+    "playbooks": {
+      "description": "List all pb-* playbooks with duration, difficulty and requirements, and start one.",
+      "skills": [
+        "pb-*",
+        "bdb-aos"
+      ],
+      "bodies": {
+        "claude": "Run `node <bdb-aos skill dir>/scripts/list-playbooks.mjs` and show its output (name, est_time, difficulty, requires of every `pb-*` skill). If the human names a playbook in the arguments or picks one, start that `pb-*` skill; start nothing otherwise. Each playbook keeps its own go-gate points. Arguments: $ARGUMENTS"
+      }
+    },
+    "loop": {
+      "description": "Run a prompt repeatedly on an interval, using the harness built-in plus loop templates.",
+      "skills": [
+        "loop-templates"
+      ],
+      "bodies": {
+        "claude": "Use the built-in `/loop <interval> <prompt>` (omit the interval to self-pace). Offer a `loop-templates` template when the human has no prompt yet. Safety: a loop prompt never issues a GO, never types or runs `gogate`, never sets a mode or grant, and never merges, pushes or publishes unless a valid grant covers the action. Act on a guarded step only if the human's immediately preceding message is a literal GO or a valid grant covers it; a loop iteration never satisfies the first condition, so it must STOP and report instead of continuing a blocked guarded step. Templates (CI until green, follow a PR to merge, review rounds until no blockers, daily session summary) live in the `loop-templates` skill with run and duration limits and a stop condition each. Arguments: $ARGUMENTS",
+        "opencode": "OpenCode has no built-in loop. Use `opencode-loop`, the opt-in package (AOS_OPENCODE_OPTIONAL=loop, see docs/opencode-setup.md); without it, say so and stop. Do not schedule gated commands through its shell loop. Offer a `loop-templates` template when the human has no prompt yet. Safety: a loop prompt never issues a GO, never types or runs `gogate`, never sets a mode or grant, and never merges, pushes or publishes unless a valid grant covers the action. Act on a guarded step only if the human's immediately preceding message is a literal GO or a valid grant covers it; a loop iteration never satisfies the first condition, so it must STOP and report instead of continuing a blocked guarded step. Templates (CI until green, follow a PR to merge, review rounds until no blockers, daily session summary) live in the `loop-templates` skill with run and duration limits and a stop condition each. Arguments: $ARGUMENTS",
+        "codex": "Codex has no /loop. Use `/goal` with the filled `loop-templates` template as the goal, keeping its limits and stop condition. Codex /goal is unverified in AOS docs; confirm with `codex --help`. Safety: a loop prompt never issues a GO, never types or runs `gogate`, never sets a mode or grant, and never merges, pushes or publishes unless a valid grant covers the action. Act on a guarded step only if the human's immediately preceding message is a literal GO or a valid grant covers it; a loop iteration never satisfies the first condition, so it must STOP and report instead of continuing a blocked guarded step. Templates (CI until green, follow a PR to merge, review rounds until no blockers, daily session summary) live in the `loop-templates` skill with run and duration limits and a stop condition each. Arguments: whatever the user wrote after the command name",
+        "agy": "Unverified, no loop mechanism confirmed for agy. Manual repeat: fill a `loop-templates` template, re-send it yourself at each interval, and stop at its limits or stop condition. Safety: a loop prompt never issues a GO, never types or runs `gogate`, never sets a mode or grant, and never merges, pushes or publishes unless a valid grant covers the action. Act on a guarded step only if the human's immediately preceding message is a literal GO or a valid grant covers it; a loop iteration never satisfies the first condition, so it must STOP and report instead of continuing a blocked guarded step. Templates (CI until green, follow a PR to merge, review rounds until no blockers, daily session summary) live in the `loop-templates` skill with run and duration limits and a stop condition each. Arguments: whatever the user wrote after the command name"
+      }
+    }
+  }
+}

package/plugin.json

@@ -0,0 +1,299 @@
+{
+  "name": "bdb-aos",
+  "version": "4.18.0",
+  "description": "Full BDB Agent OS suite: 200+ curated skills, 13 subagents and the startcycle pipelines for Claude Code. Gate hooks and MCP servers are installed by the AOS installer.",
+  "author": {
+    "name": "Tim Rennings / Hybridlabor Global LLC",
+    "email": "hybridlabor@gmail.com"
+  },
+  "homepage": "https://github.com/hybridlabor-api/aos",
+  "repository": "https://github.com/hybridlabor-api/aos",
+  "license": "Apache-2.0",
+  "keywords": [
+    "skills",
+    "agent-os",
+    "cicd",
+    "multiagent",
+    "startcycle",
+    "bdb"
+  ],
+  "skills": [
+    "./skills/basic/ao-orchestrator",
+    "./skills/basic/bdb-eventagency-skill",
+    "./skills/basic/bdb-shipping-skill",
+    "./skills/basic/bdbhtmlmanueldocs",
+    "./skills/basic/bdbmediastorm",
+    "./skills/basic/godmode-3d-creation",
+    "./skills/basic/godmode-engineering",
+    "./skills/basic/godmode-eventtech",
+    "./skills/basic/godmode-hardware-pcb",
+    "./skills/basic/godmode-media-creation",
+    "./skills/basic/godmode-shipping",
+    "./skills/basic/godmode-ui-ux",
+    "./skills/basic/master-session",
+    "./skills/basic/startcycle",
+    "./skills/basic/startcycle-graph",
+    "./skills/basic/startcycle-graph-user",
+    "./skills/basic/teamwork-preview",
+    "./skills/bdb-aos",
+    "./skills/bdbrainstorm",
+    "./skills/github-repo",
+    "./skills/global_config/agent-manager-skill",
+    "./skills/global_config/agent-memory-mcp",
+    "./skills/global_config/agent-orchestrator",
+    "./skills/global_config/agent-pipeline",
+    "./skills/global_config/agent-tool-builder",
+    "./skills/global_config/agentic-harness-patterns",
+    "./skills/global_config/agenttrail",
+    "./skills/global_config/ai-agent-development",
+    "./skills/global_config/ai-product",
+    "./skills/global_config/aos-project-init",
+    "./skills/global_config/aos-setup",
+    "./skills/global_config/aos-store",
+    "./skills/global_config/api-design-principles",
+    "./skills/global_config/api-patterns",
+    "./skills/global_config/apify-lead-generation",
+    "./skills/global_config/apify-ultimate-scraper",
+    "./skills/global_config/archify",
+    "./skills/global_config/architect-review",
+    "./skills/global_config/ask-tim",
+    "./skills/global_config/bash-linux",
+    "./skills/global_config/bash-script-generator",
+    "./skills/global_config/bash-script-validator",
+    "./skills/global_config/bdb-adobe-suite-mcp",
+    "./skills/global_config/bdb-after-effects-mcp",
+    "./skills/global_config/bdb-blender-mcp",
+    "./skills/global_config/bdb-computer-use-mcp",
+    "./skills/global_config/bdb-davinci-mcp",
+    "./skills/global_config/bdb-deploy",
+    "./skills/global_config/bdb-grandma3-mcp",
+    "./skills/global_config/bdb-memb-mcp",
+    "./skills/global_config/bdb-resolume-mcp",
+    "./skills/global_config/bdb-rhino-mcp",
+    "./skills/global_config/bdb-security-audit",
+    "./skills/global_config/bdb-touchdesigner-mcp",
+    "./skills/global_config/bdb-unreal-mcp",
+    "./skills/global_config/bdb-updater",
+    "./skills/global_config/bdb-vectorworks-mcp",
+    "./skills/global_config/bdb-visual-edit",
+    "./skills/global_config/bdbdesignpro",
+    "./skills/global_config/bdbresilience",
+    "./skills/global_config/brag",
+    "./skills/global_config/brainstorming",
+    "./skills/global_config/browser-automation",
+    "./skills/global_config/ci-pipeline",
+    "./skills/global_config/clean-code",
+    "./skills/global_config/cloudflare-workers-expert",
+    "./skills/global_config/concise-planning",
+    "./skills/global_config/copywriting",
+    "./skills/global_config/crewai",
+    "./skills/global_config/database-design",
+    "./skills/global_config/debugger",
+    "./skills/global_config/deep-research",
+    "./skills/global_config/deja-memory",
+    "./skills/global_config/design-control-loop",
+    "./skills/global_config/design-spells",
+    "./skills/global_config/dispatching-parallel-agents",
+    "./skills/global_config/docker-expert",
+    "./skills/global_config/dockerfile-generator",
+    "./skills/global_config/dockerfile-validator",
+    "./skills/global_config/documentation",
+    "./skills/global_config/domain-modeling",
+    "./skills/global_config/drizzle-orm-expert",
+    "./skills/global_config/editable-design",
+    "./skills/global_config/executing-plans",
+    "./skills/global_config/factory-collect",
+    "./skills/global_config/factory-human-digest",
+    "./skills/global_config/factory-lookback",
+    "./skills/global_config/factory-review-prs",
+    "./skills/global_config/finishing-a-development-branch",
+    "./skills/global_config/frontend-dev-guidelines",
+    "./skills/global_config/gemini-api-dev",
+    "./skills/global_config/gemini-api-integration",
+    "./skills/global_config/geo-fundamentals",
+    "./skills/global_config/git-advanced-workflows",
+    "./skills/global_config/git-pr-review",
+    "./skills/global_config/github",
+    "./skills/global_config/github-actions-generator",
+    "./skills/global_config/github-actions-templates",
+    "./skills/global_config/github-actions-validator",
+    "./skills/global_config/github-workflow-automation",
+    "./skills/global_config/go-concurrency-patterns",
+    "./skills/global_config/go-playwright",
+    "./skills/global_config/gogate",
+    "./skills/global_config/golang-pro",
+    "./skills/global_config/grill-me",
+    "./skills/global_config/grill-with-docs",
+    "./skills/global_config/grilling",
+    "./skills/global_config/landing-page-generator",
+    "./skills/global_config/linear-claude-skill",
+    "./skills/global_config/live-preview-canvas",
+    "./skills/global_config/llm-app-patterns",
+    "./skills/global_config/llm-application-dev-ai-assistant",
+    "./skills/global_config/llm-prompt-optimizer",
+    "./skills/global_config/llm-structured-output",
+    "./skills/global_config/local-llm-expert",
+    "./skills/global_config/loop-templates",
+    "./skills/global_config/makefile-generator",
+    "./skills/global_config/makefile-validator",
+    "./skills/global_config/mcp-manage",
+    "./skills/global_config/mcsc",
+    "./skills/global_config/memb-skill",
+    "./skills/global_config/microservices-patterns",
+    "./skills/global_config/modern-javascript-patterns",
+    "./skills/global_config/monorepo-management",
+    "./skills/global_config/n8n-code-javascript",
+    "./skills/global_config/n8n-code-python",
+    "./skills/global_config/n8n-expression-syntax",
+    "./skills/global_config/n8n-mcp-tools-expert",
+    "./skills/global_config/n8n-workflow-patterns",
+    "./skills/global_config/neon-postgres",
+    "./skills/global_config/nextjs-app-router-patterns",
+    "./skills/global_config/nextjs-best-practices",
+    "./skills/global_config/notion-automation",
+    "./skills/global_config/obsidian-markdown",
+    "./skills/global_config/openapi-spec-generation",
+    "./skills/global_config/openwiki-skill",
+    "./skills/global_config/os-scripting",
+    "./skills/global_config/plan-arbiter",
+    "./skills/global_config/plan-canvas",
+    "./skills/global_config/planning-with-files",
+    "./skills/global_config/playwright-skill",
+    "./skills/global_config/posix-shell-pro",
+    "./skills/global_config/postgres-best-practices",
+    "./skills/global_config/postgresql",
+    "./skills/global_config/pr-recap",
+    "./skills/global_config/prisma-expert",
+    "./skills/global_config/product-manager-toolkit",
+    "./skills/global_config/programmatic-seo",
+    "./skills/global_config/prompt-engineer",
+    "./skills/global_config/prompt-engineering-patterns",
+    "./skills/global_config/prototype",
+    "./skills/global_config/python-patterns",
+    "./skills/global_config/python-performance-optimization",
+    "./skills/global_config/python-pro",
+    "./skills/global_config/quick-recap",
+    "./skills/global_config/rag-engineer",
+    "./skills/global_config/rag-implementation",
+    "./skills/global_config/react-best-practices",
+    "./skills/global_config/react-component-performance",
+    "./skills/global_config/react-patterns",
+    "./skills/global_config/read-the-damn-docs",
+    "./skills/global_config/readme",
+    "./skills/global_config/remotion",
+    "./skills/global_config/requesting-code-review",
+    "./skills/global_config/schema-markup",
+    "./skills/global_config/senior-frontend",
+    "./skills/global_config/seo",
+    "./skills/global_config/seo-audit",
+    "./skills/global_config/seo-technical",
+    "./skills/global_config/shadcn",
+    "./skills/global_config/simplify-code",
+    "./skills/global_config/slack-automation",
+    "./skills/global_config/software-architecture",
+    "./skills/global_config/spline-3d-integration",
+    "./skills/global_config/stay-within-limits",
+    "./skills/global_config/subagent-driven-development",
+    "./skills/global_config/subagent-setup",
+    "./skills/global_config/systematic-debugging",
+    "./skills/global_config/tailwind-patterns",
+    "./skills/global_config/tanstack-query-expert",
+    "./skills/global_config/tdd-workflow",
+    "./skills/global_config/test-driven-development",
+    "./skills/global_config/threejs-skills",
+    "./skills/global_config/tmux",
+    "./skills/global_config/token-saver-config",
+    "./skills/global_config/triage",
+    "./skills/global_config/turborepo-caching",
+    "./skills/global_config/typescript-pro",
+    "./skills/global_config/ui-component",
+    "./skills/global_config/ui-page",
+    "./skills/global_config/ui-pattern",
+    "./skills/global_config/ui-review",
+    "./skills/global_config/ui-tokens",
+    "./skills/global_config/ui-ux-pro-max",
+    "./skills/global_config/using-git-worktrees",
+    "./skills/global_config/using-neon",
+    "./skills/global_config/ux-audit",
+    "./skills/global_config/ux-feedback",
+    "./skills/global_config/ux-flow",
+    "./skills/global_config/ux-persuasion-engineer",
+    "./skills/global_config/vector-database-engineer",
+    "./skills/global_config/vercel-ai-sdk-expert",
+    "./skills/global_config/vercel-deployment",
+    "./skills/global_config/verification-before-completion",
+    "./skills/global_config/wcag-audit-patterns",
+    "./skills/global_config/web-artifacts-builder",
+    "./skills/global_config/web-performance-optimization",
+    "./skills/global_config/web-scraper",
+    "./skills/global_config/webapp-testing",
+    "./skills/global_config/writing-plans",
+    "./skills/global_config/writing-plans-legacy",
+    "./skills/global_config/zustand-store-ts",
+    "./skills/memb-ingest",
+    "./skills/playbooks/pb-bug-fix",
+    "./skills/playbooks/pb-ci-fix",
+    "./skills/playbooks/pb-clip-from-moodboard",
+    "./skills/playbooks/pb-crew-call-sheet",
+    "./skills/playbooks/pb-deploy-saas",
+    "./skills/playbooks/pb-docs-site",
+    "./skills/playbooks/pb-event-tracker",
+    "./skills/playbooks/pb-focus-chunks",
+    "./skills/playbooks/pb-handover",
+    "./skills/playbooks/pb-harness-work",
+    "./skills/playbooks/pb-health-weekly",
+    "./skills/playbooks/pb-idea-to-launch",
+    "./skills/playbooks/pb-image-to-3d",
+    "./skills/playbooks/pb-inbox-zero",
+    "./skills/playbooks/pb-invoice-check",
+    "./skills/playbooks/pb-landing-page",
+    "./skills/playbooks/pb-launch-video",
+    "./skills/playbooks/pb-machine-setup",
+    "./skills/playbooks/pb-master",
+    "./skills/playbooks/pb-meeting-actions",
+    "./skills/playbooks/pb-newsletter",
+    "./skills/playbooks/pb-offer",
+    "./skills/playbooks/pb-open-source",
+    "./skills/playbooks/pb-pcb-to-case",
+    "./skills/playbooks/pb-project-new",
+    "./skills/playbooks/pb-redesign-app",
+    "./skills/playbooks/pb-release-aos",
+    "./skills/playbooks/pb-security-sweep",
+    "./skills/playbooks/pb-ship",
+    "./skills/playbooks/pb-show-build",
+    "./skills/playbooks/pb-social-pack",
+    "./skills/playbooks/pb-todo",
+    "./skills/playbooks/pb-week-plan",
+    "./skills/playbooks/pb-worktrees-land",
+    "./skills/synapse-integration-skill",
+    "./skills/workspace_agents/firecrawl",
+    "./skills/workspace_agents/firecrawl-agent",
+    "./skills/workspace_agents/firecrawl-build",
+    "./skills/workspace_agents/firecrawl-build-interact",
+    "./skills/workspace_agents/firecrawl-build-onboarding",
+    "./skills/workspace_agents/firecrawl-build-scrape",
+    "./skills/workspace_agents/firecrawl-build-search",
+    "./skills/workspace_agents/firecrawl-crawl",
+    "./skills/workspace_agents/firecrawl-download",
+    "./skills/workspace_agents/firecrawl-interact",
+    "./skills/workspace_agents/firecrawl-map",
+    "./skills/workspace_agents/firecrawl-scrape",
+    "./skills/workspace_agents/firecrawl-search"
+  ],
+  "commands": [
+    "./commands/brainstorm.md",
+    "./commands/doctor.md",
+    "./commands/graph.md",
+    "./commands/init.md",
+    "./agy-commands/loop.md",
+    "./commands/mastersession.md",
+    "./commands/memb.md",
+    "./commands/orchestrator.md",
+    "./commands/plan.md",
+    "./commands/playbooks.md",
+    "./commands/setup.md",
+    "./commands/shipping.md",
+    "./commands/startproject.md",
+    "./commands/store.md"
+  ]
+}

package/plugins/bdb-aos-codex/.codex-plugin/plugin.json

@@ -0,0 +1,38 @@
+{
+  "name": "bdb-aos",
+  "version": "4.18.0",
+  "description": "Full BDB Agent OS suite for Codex: command entry points ($bdb-aos:setup, $bdb-aos:init, ...) generated from plugin-commands.json.",
+  "author": {
+    "name": "Tim Rennings / Hybridlabor Global LLC",
+    "email": "hybridlabor@gmail.com"
+  },
+  "homepage": "https://github.com/hybridlabor-api/aos",
+  "repository": "https://github.com/hybridlabor-api/aos",
+  "license": "Apache-2.0",
+  "keywords": [
+    "skills",
+    "agent-os",
+    "cicd",
+    "multiagent",
+    "startcycle",
+    "bdb"
+  ],
+  "skills": "./skills/",
+  "interface": {
+    "displayName": "BDB Agent OS",
+    "shortDescription": "AOS commands for setup, planning and pipelines",
+    "longDescription": "Entry-point skills for the BDB Agent OS suite: invoke $bdb-aos:<command> to run setup, project init, planning and the startcycle pipelines.",
+    "developerName": "Hybridlabor Global LLC",
+    "category": "Developer Tools",
+    "capabilities": [
+      "Interactive",
+      "Read",
+      "Write"
+    ],
+    "websiteURL": "https://github.com/hybridlabor-api/aos",
+    "defaultPrompt": [
+      "$bdb-aos:setup",
+      "$bdb-aos:doctor"
+    ]
+  }
+}

package/plugins/bdb-aos-codex/skills/brainstorm/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: brainstorm
+description: "Brainstorm a topic with the matching skill: bdbrainstorm, bdbmediastorm for event tech, grill-me for a stress test. Generated from plugin-commands.json; invoke as $bdb-aos:brainstorm."
+---
+
+Pick by topic: `bdbmediastorm` for live event technology and show control, `grill-me` when the human wants an existing idea stress-tested, `bdbrainstorm` otherwise. Say which one you chose. Topic: whatever the user wrote after the skill name

package/plugins/bdb-aos-codex/skills/doctor/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: doctor
+description: "Check the machine and the current project, and print suggested permissions.allow entries without writing any settings. Generated from plugin-commands.json; invoke as $bdb-aos:doctor."
+---
+
+Run `aos-doctor` (machine check) and report the result. If the current folder is an AOS project, also run the project check `node <aos-project-init skill dir>/scripts/aos-project-doctor.mjs` (it covers `.aos/project.json`, AGENTS.md and the wiki). Print suggested `permissions.allow` entries as text for the human to copy. Never write to settings.json or settings.local.json. Arguments: whatever the user wrote after the skill name