@jaybeeuu/agent-cortex 1.20.0

package/skills/productivity/validate-agent-dir/scripts/pnpm-lock.yaml

@@ -0,0 +1,329 @@
+lockfileVersion: '9.0'
+
+settings:
+  autoInstallPeers: true
+  excludeLinksFromLockfile: false
+
+importers:
+
+  .:
+    devDependencies:
+      '@types/node':
+        specifier: ^22.20.1
+        version: 22.20.1
+      tsx:
+        specifier: ^4.23.0
+        version: 4.23.5
+      typescript:
+        specifier: ^5.0.0
+        version: 5.9.3
+
+packages:
+
+  '@esbuild/aix-ppc64@0.28.1':
+    resolution: {integrity: sha512-Svl7tq8k/08+p6CXPpRjQ1fKX+1odH/BQbb48fV6fj3CWHhsoIOoY87w1oHXm0qEpkIK3ZfVgp0hed3XBXzXMQ==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [aix]
+
+  '@esbuild/android-arm64@0.28.1':
+    resolution: {integrity: sha512-34EGEbCIAgosYz6goLcopX6Mo7NyGv9tfwEM2/7Ce2VcVRk568iSvniGWcUXIy7wEDR1wzolcxcriFVrWYcwBg==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [android]
+
+  '@esbuild/android-arm@0.28.1':
+    resolution: {integrity: sha512-0k2F129Xdio1TdJfzJ8sy1Q47vUD2NnwdhiAf7drUN1EBTfPf4hsFCtmMgu/6m8JSzsBrlmVjudMBQqOfG8usQ==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [android]
+
+  '@esbuild/android-x64@0.28.1':
+    resolution: {integrity: sha512-dbwY7ltSMDWsRatcRpCnES4F+im88OCUgGZjy52shC7GqHRE/cYlxNbB4Z4UpJswpcc4Qxd2oE/ufM0p61IKng==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [android]
+
+  '@esbuild/darwin-arm64@0.28.1':
+    resolution: {integrity: sha512-TZbWkQY7kvTAXbXUT7uVACR5cMHsDiSz9z7ZKAX/RTq/WJEk3QyRr0wZpNhBDX+/0CtdqUIJlOiodQcta6tY3Q==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [darwin]
+
+  '@esbuild/darwin-x64@0.28.1':
+    resolution: {integrity: sha512-zfdzgK9ACBNZLI/CyHTOx81SyNbM6YXn7rxSgX97VjyiPl9W1i4Ka4fgKECEoFCKGpvBj5qArWIGgQjOwkgskQ==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [darwin]
+
+  '@esbuild/freebsd-arm64@0.28.1':
+    resolution: {integrity: sha512-wG2EA8ENdEI0qhkSZMjfqrdY+ziCYCPMmtZjjIwOmXFjmyzEHn+UUxk5of+SYsjtfs3VpnlC7QLzSI5hY/rOAw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [freebsd]
+
+  '@esbuild/freebsd-x64@0.28.1':
+    resolution: {integrity: sha512-i7dZ9vQgnvSCzi/rYCXNgtF/U+eKZNJBzu3eTQbRgHnM7tNSizLOkRFAl3qzVc/Op/u5YkHHa4pf/3DOYHthLQ==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [freebsd]
+
+  '@esbuild/linux-arm64@0.28.1':
+    resolution: {integrity: sha512-yHs+0uc8+nvEAfAfxrWQKK5peSNzBc4PegcMO0EJ2hT71uA7vB8Ihg2e77R2P7SG5uYjPbHlLLmve4LLLRCf0g==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [linux]
+
+  '@esbuild/linux-arm@0.28.1':
+    resolution: {integrity: sha512-qVXBOHQS+d5Y722GwJzJUtOLlX7km3CraOaGormF1pDtPd2C/l1SHRPgjLunLGe51Sh5YYWKMFDyV4SxgMQYTQ==}
+    engines: {node: '>=18'}
+    cpu: [arm]
+    os: [linux]
+
+  '@esbuild/linux-ia32@0.28.1':
+    resolution: {integrity: sha512-d1z4ZuP0ajrfz/FhGT4vv278rX8KnPPJx8i5+AtK7TYbx9Le9F1hyzurZpkEyjkGa9dUGhQow4C1NmeGvqxN2w==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [linux]
+
+  '@esbuild/linux-loong64@0.28.1':
+    resolution: {integrity: sha512-M5sRjUVZrkm1OAPR3dlOYzNmN+loZKGVi1VUQGrwuqLcbR6qeAz+famMhjASeH3YVKvZz+zT1jlh/keC3Rj/lg==}
+    engines: {node: '>=18'}
+    cpu: [loong64]
+    os: [linux]
+
+  '@esbuild/linux-mips64el@0.28.1':
+    resolution: {integrity: sha512-mRObBZeHh2OxcBFPWE/FjylkRgZdYuiTR3vaTozquCGOH14iP9oN4x4Ge81CoIDYQrXmIxpFumJBu5MtZpnQJQ==}
+    engines: {node: '>=18'}
+    cpu: [mips64el]
+    os: [linux]
+
+  '@esbuild/linux-ppc64@0.28.1':
+    resolution: {integrity: sha512-slScBsMAb3GFDcdrCgLwZtPYRoH2H/youv10QiZyRjmsP48fznoveWytSgCI/R0ZcUgpc0ZhIUEx6LHts8yrfQ==}
+    engines: {node: '>=18'}
+    cpu: [ppc64]
+    os: [linux]
+
+  '@esbuild/linux-riscv64@0.28.1':
+    resolution: {integrity: sha512-kw0owk1o0GFETUJyW0jc0G4Yzs0BHZn0JDZ8JRT088vjJYX777BAs1fDGxAC+q831qOs2DTC96mNsG2opdfyyQ==}
+    engines: {node: '>=18'}
+    cpu: [riscv64]
+    os: [linux]
+
+  '@esbuild/linux-s390x@0.28.1':
+    resolution: {integrity: sha512-/lAIjX8aYFRByhh6L5rYtPEDRqa9de/4V/juOXcta5frjvzXO4/sqEtyytse0g3zZFuWu5cDN0MkLz2qRDD2Ag==}
+    engines: {node: '>=18'}
+    cpu: [s390x]
+    os: [linux]
+
+  '@esbuild/linux-x64@0.28.1':
+    resolution: {integrity: sha512-u/anNYF2mmVOEDwLtnQ1wOr3EZ9sTNGLWrsYGYwHWzGA3Si84IOkHXlbWTD1NB+9/1lcnweYKO54uhxZydNzfA==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [linux]
+
+  '@esbuild/netbsd-arm64@0.28.1':
+    resolution: {integrity: sha512-oks0DYbLwWMmaakTsCb+zL4E+aHRVLom9IJZOAthMQEPiQmydXHkziYEsGYRx0uNV/IjEKGAV941JzH02pflqw==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [netbsd]
+
+  '@esbuild/netbsd-x64@0.28.1':
+    resolution: {integrity: sha512-aeL6lAnN89Hz43Mlh1G8ARasbuoYvSITDEx0tHh5b7jJnHcssqgjy9Yx430GDpmCa6OyrKoS0aNRjKundRizGg==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [netbsd]
+
+  '@esbuild/openbsd-arm64@0.28.1':
+    resolution: {integrity: sha512-MEFJe5C3R8pwXdZ5Y21oo6m7ePiS0d9pWucn99O/wvyJZChoIQKrQDxKrGeW8F5+T0okTHesAmDeiHDTIq0V/Q==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [openbsd]
+
+  '@esbuild/openbsd-x64@0.28.1':
+    resolution: {integrity: sha512-i/ZLIOafE0Z8cI/XANJAixoJL/uRAoS2xOA3rb0xN+KK0K177cMAsQYkzHtBrtMXAKuAc7HGgcWiZ/sRC1Nxgw==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [openbsd]
+
+  '@esbuild/openharmony-arm64@0.28.1':
+    resolution: {integrity: sha512-ge+Z7EXFNt2BO1oAMsVpiQ8EwndV9i1xXerAeTIK7AtPs3bKFXQM7nlRxDSIUIMeueR1CNXxqztLzdNeReKBJg==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [openharmony]
+
+  '@esbuild/sunos-x64@0.28.1':
+    resolution: {integrity: sha512-BEjgtECkL3vY+SaSQ6nzVfiALUeFxpawyp8Jmf5PtYhf1Ug40N1h/hxlhts+f1FvSvarEigdxS3BlSMI2PJLcQ==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [sunos]
+
+  '@esbuild/win32-arm64@0.28.1':
+    resolution: {integrity: sha512-lCv9eK/H6ZJWbE7bh2nw54CZ9M2nupBxJcTsdk/QQnWkdSjKGuxmmH8/GWrlT1eMmZfn4dGcCjRte397WqfQXA==}
+    engines: {node: '>=18'}
+    cpu: [arm64]
+    os: [win32]
+
+  '@esbuild/win32-ia32@0.28.1':
+    resolution: {integrity: sha512-zvb/mB2bSCoJOpoCBgYKKpX6YM6mJBlBUVUtVj41DlZJVEB6/0CKlRYxP5wWl1C1ILiCoAU5wZZ4q1P3qeS6Eg==}
+    engines: {node: '>=18'}
+    cpu: [ia32]
+    os: [win32]
+
+  '@esbuild/win32-x64@0.28.1':
+    resolution: {integrity: sha512-bm4Mowrv+GXMlpWX++EcXw/iLyd1o3+bJkC2DkWXYVvgZCqD/bSj9ctZeAMC3cIxgjRVR2Dufaiu4YPxr5gW1A==}
+    engines: {node: '>=18'}
+    cpu: [x64]
+    os: [win32]
+
+  '@types/node@22.20.1':
+    resolution: {integrity: sha512-EANqOCF9QFyra+4pfxUcX9STKJpCLjMbObVzljIJomAWSnuSIEAvyzEU53GaajbXJEgdh0iEcPL+DGvpUd4k1Q==}
+
+  esbuild@0.28.1:
+    resolution: {integrity: sha512-HrJrvZv5ayxBzPfwphOoNzkzOIIlifzk0KJrGK2c8R4+LKpMtpYLQeUdjnwjWv/LZlkH2laZk+4w78pi99D4Vw==}
+    engines: {node: '>=18'}
+    hasBin: true
+
+  fsevents@2.3.3:
+    resolution: {integrity: sha512-5xoDfX+fL7faATnagmWPpbFtwh/R77WmMMqqHGS65C3vvB0YHrgF+B1YmZ3441tMj5n63k0212XNoJwzlhffQw==}
+    engines: {node: ^8.16.0 || ^10.6.0 || >=11.0.0}
+    os: [darwin]
+
+  tsx@4.23.5:
+    resolution: {integrity: sha512-rw55FUaqOoI7RvlQwLbhO4nSDApnQ4/CykPuiQ/EPvtrX3WA9Ig55jIt9VvbBJbzJuj12ueRu4PMZ2SxPVbihg==}
+    engines: {node: '>=18.0.0'}
+    hasBin: true
+
+  typescript@5.9.3:
+    resolution: {integrity: sha512-jl1vZzPDinLr9eUt3J/t7V6FgNEw9QjvBPdysz9KfQDD41fQrC2Y4vKQdiaUpFT4bXlb1RHhLpp8wtm6M5TgSw==}
+    engines: {node: '>=14.17'}
+    hasBin: true
+
+  undici-types@6.21.0:
+    resolution: {integrity: sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ==}
+
+snapshots:
+
+  '@esbuild/aix-ppc64@0.28.1':
+    optional: true
+
+  '@esbuild/android-arm64@0.28.1':
+    optional: true
+
+  '@esbuild/android-arm@0.28.1':
+    optional: true
+
+  '@esbuild/android-x64@0.28.1':
+    optional: true
+
+  '@esbuild/darwin-arm64@0.28.1':
+    optional: true
+
+  '@esbuild/darwin-x64@0.28.1':
+    optional: true
+
+  '@esbuild/freebsd-arm64@0.28.1':
+    optional: true
+
+  '@esbuild/freebsd-x64@0.28.1':
+    optional: true
+
+  '@esbuild/linux-arm64@0.28.1':
+    optional: true
+
+  '@esbuild/linux-arm@0.28.1':
+    optional: true
+
+  '@esbuild/linux-ia32@0.28.1':
+    optional: true
+
+  '@esbuild/linux-loong64@0.28.1':
+    optional: true
+
+  '@esbuild/linux-mips64el@0.28.1':
+    optional: true
+
+  '@esbuild/linux-ppc64@0.28.1':
+    optional: true
+
+  '@esbuild/linux-riscv64@0.28.1':
+    optional: true
+
+  '@esbuild/linux-s390x@0.28.1':
+    optional: true
+
+  '@esbuild/linux-x64@0.28.1':
+    optional: true
+
+  '@esbuild/netbsd-arm64@0.28.1':
+    optional: true
+
+  '@esbuild/netbsd-x64@0.28.1':
+    optional: true
+
+  '@esbuild/openbsd-arm64@0.28.1':
+    optional: true
+
+  '@esbuild/openbsd-x64@0.28.1':
+    optional: true
+
+  '@esbuild/openharmony-arm64@0.28.1':
+    optional: true
+
+  '@esbuild/sunos-x64@0.28.1':
+    optional: true
+
+  '@esbuild/win32-arm64@0.28.1':
+    optional: true
+
+  '@esbuild/win32-ia32@0.28.1':
+    optional: true
+
+  '@esbuild/win32-x64@0.28.1':
+    optional: true
+
+  '@types/node@22.20.1':
+    dependencies:
+      undici-types: 6.21.0
+
+  esbuild@0.28.1:
+    optionalDependencies:
+      '@esbuild/aix-ppc64': 0.28.1
+      '@esbuild/android-arm': 0.28.1
+      '@esbuild/android-arm64': 0.28.1
+      '@esbuild/android-x64': 0.28.1
+      '@esbuild/darwin-arm64': 0.28.1
+      '@esbuild/darwin-x64': 0.28.1
+      '@esbuild/freebsd-arm64': 0.28.1
+      '@esbuild/freebsd-x64': 0.28.1
+      '@esbuild/linux-arm': 0.28.1
+      '@esbuild/linux-arm64': 0.28.1
+      '@esbuild/linux-ia32': 0.28.1
+      '@esbuild/linux-loong64': 0.28.1
+      '@esbuild/linux-mips64el': 0.28.1
+      '@esbuild/linux-ppc64': 0.28.1
+      '@esbuild/linux-riscv64': 0.28.1
+      '@esbuild/linux-s390x': 0.28.1
+      '@esbuild/linux-x64': 0.28.1
+      '@esbuild/netbsd-arm64': 0.28.1
+      '@esbuild/netbsd-x64': 0.28.1
+      '@esbuild/openbsd-arm64': 0.28.1
+      '@esbuild/openbsd-x64': 0.28.1
+      '@esbuild/openharmony-arm64': 0.28.1
+      '@esbuild/sunos-x64': 0.28.1
+      '@esbuild/win32-arm64': 0.28.1
+      '@esbuild/win32-ia32': 0.28.1
+      '@esbuild/win32-x64': 0.28.1
+
+  fsevents@2.3.3:
+    optional: true
+
+  tsx@4.23.5:
+    dependencies:
+      esbuild: 0.28.1
+    optionalDependencies:
+      fsevents: 2.3.3
+
+  typescript@5.9.3: {}
+
+  undici-types@6.21.0: {}

package/skills/productivity/validate-agent-dir/scripts/pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+allowBuilds:
+  esbuild: true

package/skills/productivity/validate-agent-dir/scripts/tsconfig.json

@@ -0,0 +1,19 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "allowImportingTsExtensions": true,
+    "noEmit": true,
+    "outDir": "./dist",
+    "rootDir": ".",
+    "declaration": true,
+    "sourceMap": true
+  },
+  "include": ["*.ts"],
+  "exclude": ["node_modules", "dist"]
+}

package/skills/productivity/validate-agent-dir/scripts/validate-agent-dir.test.ts

@@ -0,0 +1,317 @@
+import { describe, it } from "node:test";
+import assert from "node:assert/strict";
+import { mkdtempSync, mkdirSync, writeFileSync, rmSync } from "node:fs";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+
+import {
+  validateFrontmatter,
+  validateAgentDir,
+  type AgentDir,
+  type Frontmatter,
+} from "./validate-agent-dir.ts";
+
+// ─── Fixtures ─────────────────────────────────────────────────────────────────
+
+function makeFrontmatter(overrides: Partial<Frontmatter> = {}): Frontmatter {
+  return {
+    name: "agent-cortex:ralph",
+    description: "Parallel task orchestration agent",
+    tools: ["bash", "task", "read_agent"],
+    ...overrides,
+  };
+}
+
+function createAgentDir(
+  tmpDir: string,
+  name: string,
+  frontmatter: Frontmatter,
+  body: string = "# Shared body\n\nYou are an agent.",
+  sections?: Record<string, string>
+): void {
+  const agentDir = join(tmpDir, "agents", name);
+  mkdirSync(agentDir, { recursive: true });
+
+  // Write agent.md
+  writeFileSync(join(agentDir, "agent.md"), body, "utf-8");
+
+  // Write frontmatter.json for PI harness
+  const piDir = join(agentDir, "pi");
+  mkdirSync(piDir, { recursive: true });
+  writeFileSync(join(piDir, "frontmatter.json"), JSON.stringify(frontmatter), "utf-8");
+
+  // Write optional sections
+  if (sections) {
+    for (const [filename, content] of Object.entries(sections)) {
+      writeFileSync(join(piDir, filename), content, "utf-8");
+    }
+  }
+}
+
+// ─── Behavior 1: validate frontmatter.json ────────────────────────────────────
+
+describe("validateFrontmatter", () => {
+  it("accepts valid frontmatter with required fields", () => {
+    const fm = makeFrontmatter();
+    const result = validateFrontmatter(fm);
+    assert.equal(result.ok, true);
+  });
+
+  it("accepts frontmatter with optional model field", () => {
+    const fm = makeFrontmatter({ model: "claude-sonnet-4-5" });
+    const result = validateFrontmatter(fm);
+    assert.equal(result.ok, true);
+  });
+
+  it("accepts frontmatter with optional argumentHint field", () => {
+    const fm = makeFrontmatter({ argumentHint: "Run all pending beads" });
+    const result = validateFrontmatter(fm);
+    assert.equal(result.ok, true);
+  });
+
+  it("rejects frontmatter missing name", () => {
+    const fm = { description: "desc", tools: ["bash"] } as any;
+    const result = validateFrontmatter(fm);
+    assert.equal(result.ok, false);
+    assert.ok(result.errors.some((e) => e.includes("name")));
+  });
+
+  it("rejects frontmatter missing description", () => {
+    const fm = { name: "test", tools: ["bash"] } as any;
+    const result = validateFrontmatter(fm);
+    assert.equal(result.ok, false);
+    assert.ok(result.errors.some((e) => e.includes("description")));
+  });
+
+  it("rejects frontmatter missing tools", () => {
+    const fm = { name: "test", description: "desc" } as any;
+    const result = validateFrontmatter(fm);
+    assert.equal(result.ok, false);
+    assert.ok(result.errors.some((e) => e.includes("tools")));
+  });
+
+  it("rejects frontmatter with non-array tools", () => {
+    const fm = { name: "test", description: "desc", tools: "bash" } as any;
+    const result = validateFrontmatter(fm);
+    assert.equal(result.ok, false);
+    assert.ok(result.errors.some((e) => e.includes("tools")));
+  });
+
+  it("rejects frontmatter with empty name", () => {
+    const fm = makeFrontmatter({ name: "" });
+    const result = validateFrontmatter(fm);
+    assert.equal(result.ok, false);
+    assert.ok(result.errors.some((e) => e.includes("name")));
+  });
+
+  it("rejects frontmatter with empty description", () => {
+    const fm = makeFrontmatter({ description: "" });
+    const result = validateFrontmatter(fm);
+    assert.equal(result.ok, false);
+    assert.ok(result.errors.some((e) => e.includes("description")));
+  });
+
+  it("rejects frontmatter with empty tools array", () => {
+    const fm = makeFrontmatter({ tools: [] });
+    const result = validateFrontmatter(fm);
+    assert.equal(result.ok, false);
+    assert.ok(result.errors.some((e) => e.includes("tools")));
+  });
+
+  it("rejects frontmatter with unknown fields", () => {
+    const fm = makeFrontmatter({ unknownField: "value" } as any);
+    const result = validateFrontmatter(fm);
+    assert.equal(result.ok, false);
+    assert.ok(result.errors.some((e) => e.includes("unknown")));
+  });
+});
+
+// ─── Behavior 2: validate agent directory structure ───────────────────────────
+
+describe("validateAgentDir", () => {
+  let tmpDir: string;
+
+  it("accepts valid agent directory with agent.md and pi/frontmatter.json", () => {
+    tmpDir = mkdtempSync(join(tmpdir(), "agent-dir-test-"));
+    try {
+      createAgentDir(tmpDir, "ralph", makeFrontmatter());
+      const result = validateAgentDir(join(tmpDir, "agents", "ralph"));
+      assert.equal(result.ok, true);
+    } finally {
+      rmSync(tmpDir, { recursive: true, force: true });
+    }
+  });
+
+  it("accepts agent directory with multiple harness subdirectories", () => {
+    tmpDir = mkdtempSync(join(tmpdir(), "agent-dir-test-"));
+    try {
+      const agentDir = join(tmpDir, "agents", "ralph");
+      mkdirSync(agentDir, { recursive: true });
+      writeFileSync(join(agentDir, "agent.md"), "# Body", "utf-8");
+
+      // PI harness
+      const piDir = join(agentDir, "pi");
+      mkdirSync(piDir, { recursive: true });
+      writeFileSync(
+        join(piDir, "frontmatter.json"),
+        JSON.stringify(makeFrontmatter({ tools: ["bash", "task"] })),
+        "utf-8"
+      );
+
+      // Claude harness
+      const claudeDir = join(agentDir, "claude");
+      mkdirSync(claudeDir, { recursive: true });
+      writeFileSync(
+        join(claudeDir, "frontmatter.json"),
+        JSON.stringify(makeFrontmatter({ tools: ["bash", "task"] })),
+        "utf-8"
+      );
+
+      const result = validateAgentDir(agentDir);
+      assert.equal(result.ok, true);
+    } finally {
+      rmSync(tmpDir, { recursive: true, force: true });
+    }
+  });
+
+  it("accepts agent directory with section files", () => {
+    tmpDir = mkdtempSync(join(tmpdir(), "agent-dir-test-"));
+    try {
+      createAgentDir(
+        tmpDir,
+        "ralph",
+        makeFrontmatter(),
+        "# Body\n\n{{SECTION:polling}}",
+        { "polling.md": "# Polling loop\n\nYou poll every 2 minutes." }
+      );
+      const result = validateAgentDir(join(tmpDir, "agents", "ralph"));
+      assert.equal(result.ok, true);
+    } finally {
+      rmSync(tmpDir, { recursive: true, force: true });
+    }
+  });
+
+  it("rejects agent directory missing agent.md", () => {
+    tmpDir = mkdtempSync(join(tmpdir(), "agent-dir-test-"));
+    try {
+      const agentDir = join(tmpDir, "agents", "ralph");
+      mkdirSync(agentDir, { recursive: true });
+      mkdirSync(join(agentDir, "pi"), { recursive: true });
+      writeFileSync(
+        join(agentDir, "pi", "frontmatter.json"),
+        JSON.stringify(makeFrontmatter()),
+        "utf-8"
+      );
+
+      const result = validateAgentDir(agentDir);
+      assert.equal(result.ok, false);
+      assert.ok(result.errors.some((e) => e.includes("agent.md")));
+    } finally {
+      rmSync(tmpDir, { recursive: true, force: true });
+    }
+  });
+
+  it("rejects agent directory with no harness subdirectories", () => {
+    tmpDir = mkdtempSync(join(tmpdir(), "agent-dir-test-"));
+    try {
+      const agentDir = join(tmpDir, "agents", "ralph");
+      mkdirSync(agentDir, { recursive: true });
+      writeFileSync(join(agentDir, "agent.md"), "# Body", "utf-8");
+
+      const result = validateAgentDir(agentDir);
+      assert.equal(result.ok, false);
+      assert.ok(result.errors.some((e) => e.includes("harness")));
+    } finally {
+      rmSync(tmpDir, { recursive: true, force: true });
+    }
+  });
+
+  it("rejects agent directory with invalid frontmatter in harness", () => {
+    tmpDir = mkdtempSync(join(tmpdir(), "agent-dir-test-"));
+    try {
+      const agentDir = join(tmpDir, "agents", "ralph");
+      mkdirSync(agentDir, { recursive: true });
+      writeFileSync(join(agentDir, "agent.md"), "# Body", "utf-8");
+
+      const piDir = join(agentDir, "pi");
+      mkdirSync(piDir, { recursive: true });
+      // Invalid frontmatter: missing tools
+      writeFileSync(
+        join(piDir, "frontmatter.json"),
+        JSON.stringify({ name: "test", description: "desc" }),
+        "utf-8"
+      );
+
+      const result = validateAgentDir(agentDir);
+      assert.equal(result.ok, false);
+      assert.ok(result.errors.some((e) => e.includes("tools")));
+    } finally {
+      rmSync(tmpDir, { recursive: true, force: true });
+    }
+  });
+});
+
+// ─── Behavior 3: token format validation ──────────────────────────────────────
+
+describe("token format in agent.md body", () => {
+  it("accepts valid {{TOOL:name}} tokens", () => {
+    const body = "# Body\n\nUse {{TOOL:task}} to spawn subagents.";
+    const tokens = extractTokens(body);
+    assert.deepEqual(tokens.tools, ["task"]);
+  });
+
+  it("accepts valid {{PATH:name}} tokens", () => {
+    const body = "# Body\n\nRead {{PATH:skills/workflow/plan/SKILL.md}}";
+    const tokens = extractTokens(body);
+    assert.deepEqual(tokens.paths, ["skills/workflow/plan/SKILL.md"]);
+  });
+
+  it("accepts valid {{SECTION:name}} tokens", () => {
+    const body = "# Body\n\n{{SECTION:polling}}";
+    const tokens = extractTokens(body);
+    assert.deepEqual(tokens.sections, ["polling"]);
+  });
+
+  it("extracts multiple tokens of different types", () => {
+    const body = `
+# Body
+
+Use {{TOOL:task}} to spawn.
+Read {{PATH:skills/plan/SKILL.md}}.
+{{SECTION:polling}}
+`;
+    const tokens = extractTokens(body);
+    assert.deepEqual(tokens.tools, ["task"]);
+    assert.deepEqual(tokens.paths, ["skills/plan/SKILL.md"]);
+    assert.deepEqual(tokens.sections, ["polling"]);
+  });
+});
+
+// ─── Helper: extract tokens from markdown ─────────────────────────────────────
+
+function extractTokens(body: string): {
+  tools: string[];
+  paths: string[];
+  sections: string[];
+} {
+  const toolPattern = /\{\{TOOL:([^}]+)\}\}/g;
+  const pathPattern = /\{\{PATH:([^}]+)\}\}/g;
+  const sectionPattern = /\{\{SECTION:([^}]+)\}\}/g;
+
+  const tools: string[] = [];
+  const paths: string[] = [];
+  const sections: string[] = [];
+
+  let match;
+  while ((match = toolPattern.exec(body)) !== null) {
+    tools.push(match[1]!);
+  }
+  while ((match = pathPattern.exec(body)) !== null) {
+    paths.push(match[1]!);
+  }
+  while ((match = sectionPattern.exec(body)) !== null) {
+    sections.push(match[1]!);
+  }
+
+  return { tools, paths, sections };
+}