@jaybeeuu/agent-cortex 2.1.0 → 2.2.0

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

@@ -1,329 +0,0 @@
-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

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

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

@@ -1,19 +0,0 @@
-{
-  "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

@@ -1,317 +0,0 @@
-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 };
-}

package/skills/workflow/run-pipeline-stage/REFERENCE.md

@@ -1,22 +0,0 @@
-# Reference — run-pipeline-stage
-
-Rarely-needed detail for the `run-pipeline-stage` skill. The main workflow lives in
-`SKILL.md`; this file covers maintenance of its scripts package only.
-
-## Scripts package maintenance
-
-The scripts package (`skills/workflow/run-pipeline-stage/scripts`, a private workspace
-package `@agent-cortex/run-pipeline-stage-scripts`) backs the progress-doc generator used
-in `SKILL.md` step 6.
-
-Typecheck and test it with:
-
-```bash
-pnpm --prefix skills/workflow/run-pipeline-stage/scripts typecheck
-pnpm --prefix skills/workflow/run-pipeline-stage/scripts test
-```
-
-### Data-fetch / renderer split
-
-The data-fetch layer (`parseBdList` / `parseBdShow`) is kept separate from the renderer
-so the `bd` output format can be swapped without re-fetching.