@openreef/cli 0.1.0

package/dist/utils/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"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"}

package/dist/utils/output.d.ts

@@ -0,0 +1,11 @@
+export declare const icons: {
+    success: string;
+    error: string;
+    warning: string;
+    info: string;
+};
+export declare function header(text: string): string;
+export declare function label(text: string): string;
+export declare function value(text: string): string;
+export declare function table(rows: string[][], columnGap?: number): string;
+//# sourceMappingURL=output.d.ts.map

package/dist/utils/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,KAAK;;;;;CAKjB,CAAC;AAEF,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE3C;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1C;AAED,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,SAAI,GAAG,MAAM,CAmB7D"}

package/dist/utils/output.js

@@ -0,0 +1,31 @@
+import chalk from 'chalk';
+export const icons = {
+    success: chalk.green('\u2714'),
+    error: chalk.red('\u2716'),
+    warning: chalk.yellow('\u26A0'),
+    info: chalk.blue('\u2139'),
+};
+export function header(text) {
+    return chalk.bold.underline(text);
+}
+export function label(text) {
+    return chalk.dim(text);
+}
+export function value(text) {
+    return chalk.cyan(text);
+}
+export function table(rows, columnGap = 2) {
+    if (rows.length === 0)
+        return '';
+    const colCount = Math.max(...rows.map((r) => r.length));
+    const widths = [];
+    for (let c = 0; c < colCount; c++) {
+        widths[c] = Math.max(...rows.map((r) => (r[c] ?? '').length));
+    }
+    return rows
+        .map((row) => row
+        .map((cell, i) => i < row.length - 1 ? cell.padEnd(widths[i] + columnGap) : cell)
+        .join(''))
+        .join('\n');
+}
+//# sourceMappingURL=output.js.map

package/dist/utils/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../../src/utils/output.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC9B,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC;IAC1B,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC;IAC/B,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC;CAC3B,CAAC;AAEF,MAAM,UAAU,MAAM,CAAC,IAAY;IACjC,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,IAAY;IAChC,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,IAAY;IAChC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,IAAgB,EAAE,SAAS,GAAG,CAAC;IACnD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEjC,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IACxD,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,MAAM,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CACX,GAAG;SACA,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CACf,CAAC,GAAG,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,CAC/D;SACA,IAAI,CAAC,EAAE,CAAC,CACZ;SACA,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/utils/paths.d.ts

@@ -0,0 +1,3 @@
+export declare function getSchemaPath(): string;
+export declare function getTemplatePath(): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/utils/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AASA,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/utils/paths.js

@@ -0,0 +1,14 @@
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+function getPackageRoot() {
+    const currentFile = fileURLToPath(import.meta.url);
+    // Works from both src/utils/ and dist/utils/
+    return resolve(dirname(currentFile), '..', '..');
+}
+export function getSchemaPath() {
+    return resolve(getPackageRoot(), 'schema', 'reef.schema.json');
+}
+export function getTemplatePath() {
+    return resolve(getPackageRoot(), 'template');
+}
+//# sourceMappingURL=paths.js.map

package/dist/utils/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAE7C,SAAS,cAAc;IACrB,MAAM,WAAW,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnD,6CAA6C;IAC7C,OAAO,OAAO,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,aAAa;IAC3B,OAAO,OAAO,CAAC,cAAc,EAAE,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,OAAO,CAAC,cAAc,EAAE,EAAE,UAAU,CAAC,CAAC;AAC/C,CAAC"}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@openreef/cli",
+  "version": "0.1.0",
+  "description": "CLI toolchain for OpenReef formations — package and deploy multi-agent teams",
+  "type": "module",
+  "bin": {
+    "reef": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "schema",
+    "template"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "tsc --noEmit",
+    "smoke": "npm run build && reef validate ./template && reef init smoke-test --yes && reef validate ./smoke-test && reef pack ./smoke-test"
+  },
+  "dependencies": {
+    "ajv": "^8.18.0",
+    "ajv-formats": "^3.0.1",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "dotenv": "^17.3.1",
+    "@inquirer/prompts": "^8.2.1",
+    "ora": "^9.3.0",
+    "tar": "^7.5.7"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "json-schema-to-ts": "^3.1.1",
+    "typescript": "^5.9.3",
+    "vitest": "^4.0.18"
+  },
+  "keywords": [
+    "openreef",
+    "openclaw",
+    "ai-agents",
+    "formations",
+    "multi-agent",
+    "cli"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/openreefai/openreef.git"
+  }
+}

package/schema/reef.schema.json

@@ -0,0 +1,306 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://openreef.dev/schema/reef.schema.json",
+  "title": "OpenReef Formation Manifest",
+  "description": "Schema for reef.json — the manifest file for an OpenReef formation.",
+  "type": "object",
+  "required": ["reef", "type", "name", "version", "description", "namespace", "agents"],
+  "additionalProperties": false,
+  "properties": {
+    "reef": {
+      "type": "string",
+      "description": "Specification version.",
+      "const": "1.0"
+    },
+    "type": {
+      "type": "string",
+      "description": "Formation category: solo (1 agent), team (2-5 agents), or swarm (6+ agents).",
+      "enum": ["solo", "team", "swarm"]
+    },
+    "name": {
+      "type": "string",
+      "description": "Formation name. Lowercase alphanumeric with hyphens.",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "minLength": 1,
+      "maxLength": 128
+    },
+    "version": {
+      "type": "string",
+      "description": "Semantic version of the formation.",
+      "pattern": "^\\d+\\.\\d+\\.\\d+(-[a-zA-Z0-9.]+)?(\\+[a-zA-Z0-9.]+)?$"
+    },
+    "description": {
+      "type": "string",
+      "description": "Brief description of what the formation does.",
+      "minLength": 1,
+      "maxLength": 500
+    },
+    "author": {
+      "type": "string",
+      "description": "Formation author or organization."
+    },
+    "license": {
+      "type": "string",
+      "description": "SPDX license identifier."
+    },
+    "compatibility": {
+      "type": "object",
+      "description": "Platform compatibility constraints.",
+      "additionalProperties": false,
+      "properties": {
+        "openclaw": {
+          "type": "string",
+          "description": "Required OpenClaw version range (semver)."
+        }
+      }
+    },
+    "namespace": {
+      "type": "string",
+      "description": "Prefix for all agent IDs in this formation.",
+      "pattern": "^[a-z][a-z0-9-]*$",
+      "minLength": 1,
+      "maxLength": 64
+    },
+    "variables": {
+      "type": "object",
+      "description": "User-supplied configuration values.",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["type"],
+        "additionalProperties": false,
+        "properties": {
+          "type": {
+            "type": "string",
+            "description": "Value type.",
+            "enum": ["string", "number", "boolean"]
+          },
+          "description": {
+            "type": "string",
+            "description": "Human-readable description of the variable."
+          },
+          "default": {
+            "description": "Default value if not provided."
+          },
+          "required": {
+            "type": "boolean",
+            "description": "Whether a value must be supplied.",
+            "default": false
+          },
+          "sensitive": {
+            "type": "boolean",
+            "description": "If true, value is never stored in plaintext.",
+            "default": false
+          }
+        }
+      }
+    },
+    "agents": {
+      "type": "object",
+      "description": "Agent definitions keyed by slug.",
+      "minProperties": 1,
+      "additionalProperties": {
+        "type": "object",
+        "required": ["source", "description"],
+        "additionalProperties": false,
+        "properties": {
+          "source": {
+            "type": "string",
+            "description": "Relative path to the agent's directory."
+          },
+          "description": {
+            "type": "string",
+            "description": "What this agent does."
+          },
+          "role": {
+            "type": "string",
+            "description": "Agent's role label."
+          },
+          "model": {
+            "type": "string",
+            "description": "LLM model identifier."
+          },
+          "tools": {
+            "type": "object",
+            "description": "Tool configuration.",
+            "additionalProperties": false,
+            "properties": {
+              "allow": {
+                "type": "array",
+                "description": "List of allowed tool/skill names.",
+                "items": {
+                  "type": "string"
+                }
+              }
+            }
+          },
+          "sandbox": {
+            "type": "object",
+            "description": "OpenClaw sandbox configuration.",
+            "properties": {
+              "network": {
+                "type": "boolean",
+                "description": "Whether the agent can access the network."
+              },
+              "filesystem": {
+                "type": "string",
+                "description": "Filesystem access level.",
+                "enum": ["full", "restricted", "none"]
+              }
+            }
+          }
+        }
+      }
+    },
+    "agentToAgent": {
+      "type": "object",
+      "description": "Communication topology as directed adjacency list. Keys are source agent slugs, values are arrays of target agent slugs.",
+      "additionalProperties": {
+        "type": "array",
+        "items": {
+          "type": "string"
+        }
+      }
+    },
+    "bindings": {
+      "type": "array",
+      "description": "Channel routing rules.",
+      "items": {
+        "type": "object",
+        "required": ["channel", "agent"],
+        "additionalProperties": false,
+        "properties": {
+          "channel": {
+            "type": "string",
+            "description": "Channel identifier."
+          },
+          "agent": {
+            "type": "string",
+            "description": "Agent slug to bind."
+          },
+          "direction": {
+            "type": "string",
+            "description": "Binding direction.",
+            "enum": ["inbound", "outbound", "bidirectional"],
+            "default": "bidirectional"
+          }
+        }
+      }
+    },
+    "cron": {
+      "type": "array",
+      "description": "Scheduled jobs with agent assignment.",
+      "items": {
+        "type": "object",
+        "required": ["schedule", "agent", "prompt"],
+        "additionalProperties": false,
+        "properties": {
+          "schedule": {
+            "type": "string",
+            "description": "Cron expression."
+          },
+          "agent": {
+            "type": "string",
+            "description": "Agent slug to trigger."
+          },
+          "prompt": {
+            "type": "string",
+            "description": "Message sent to the agent."
+          },
+          "timezone": {
+            "type": "string",
+            "description": "IANA timezone.",
+            "default": "UTC"
+          }
+        }
+      }
+    },
+    "dependencies": {
+      "type": "object",
+      "description": "Required skills and services.",
+      "additionalProperties": false,
+      "properties": {
+        "skills": {
+          "type": "object",
+          "description": "Required ClawHub skills with semver version ranges.",
+          "additionalProperties": {
+            "type": "string"
+          }
+        },
+        "services": {
+          "type": "array",
+          "description": "Required external services (informational).",
+          "items": {
+            "type": "object",
+            "required": ["name"],
+            "additionalProperties": false,
+            "properties": {
+              "name": {
+                "type": "string",
+                "description": "Service name."
+              },
+              "url": {
+                "type": "string",
+                "description": "Service URL."
+              },
+              "required": {
+                "type": "boolean",
+                "description": "Whether the service is required.",
+                "default": true
+              },
+              "description": {
+                "type": "string",
+                "description": "What the service is used for."
+              }
+            }
+          }
+        }
+      }
+    },
+    "validation": {
+      "type": "object",
+      "description": "Post-deploy health check configuration.",
+      "additionalProperties": false,
+      "properties": {
+        "agent_exists": {
+          "type": "boolean",
+          "description": "Verify all agents were created.",
+          "default": true
+        },
+        "file_exists": {
+          "type": "boolean",
+          "description": "Verify workspace files were written.",
+          "default": true
+        },
+        "binding_active": {
+          "type": "boolean",
+          "description": "Verify all bindings are active.",
+          "default": true
+        },
+        "cron_exists": {
+          "type": "boolean",
+          "description": "Verify cron jobs were created.",
+          "default": true
+        },
+        "agent_responds": {
+          "type": "object",
+          "description": "Functional connectivity check. Opt-in only — requires --verify-connectivity flag.",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "description": "Whether agent_responds check is enabled.",
+              "default": false
+            },
+            "timeout": {
+              "type": "number",
+              "description": "Timeout in seconds for agent response.",
+              "default": 30,
+              "minimum": 1,
+              "maximum": 300
+            }
+          }
+        }
+      }
+    }
+  }
+}

package/template/.env.example

@@ -0,0 +1,3 @@
+# OpenReef Formation Variables
+MISSION_GOAL="Research"
+OPENAI_API_KEY=

package/template/README.md

@@ -0,0 +1,48 @@
+# My Formation
+
+> TODO: Describe what your formation does
+
+## Requirements
+
+- [OpenClaw](https://github.com/openclaw/openclaw) installed and running
+- [OpenReef CLI](https://github.com/openreef/openreef) installed
+- OpenAI API key
+
+## Variables
+
+| Variable | Description | Required | Default |
+|----------|-------------|----------|---------|
+| `OPENAI_API_KEY` | OpenAI API key for LLM calls | Yes | — |
+| `MISSION_GOAL` | Primary mission for the agent team | No | `Research` |
+
+## Quick Start
+
+```bash
+# 1. Copy the environment template and fill in your values
+cp .env.example .env
+
+# 2. Deploy the formation
+reef install .
+```
+
+## Agents
+
+### Manager
+
+**Role:** Coordinator
+
+Coordinates the team, delegates tasks, and synthesizes results. Communicates with the researcher to assign topics and collect findings.
+
+### Researcher
+
+**Role:** Researcher
+
+Conducts deep research on assigned topics and reports findings back to the manager.
+
+## Communication Topology
+
+```
+manager ↔ researcher
+```
+
+The manager can send tasks to the researcher, and the researcher reports findings back to the manager.

package/template/agents/manager/IDENTITY.md

@@ -0,0 +1,6 @@
+# Identity
+
+- **Name:** Manager
+- **Role:** Coordinator
+- **Formation:** {{namespace}}
+- **Description:** Coordinates the team, delegates tasks, and synthesizes results

package/template/agents/manager/SOUL.md

@@ -0,0 +1,29 @@
+# Manager Agent
+
+You are the **manager** of the {{namespace}} formation.
+
+## Mission
+
+{{MISSION_GOAL}}
+
+## Personality
+
+You are a focused, organized coordinator. You break down complex goals into concrete research tasks, delegate them to your team, and synthesize the results into actionable insights. You communicate clearly and keep the team aligned on priorities.
+
+## Behavior
+
+- When you receive a new mission or goal, decompose it into specific research questions
+- Delegate research tasks to the researcher agent
+- Collect and synthesize findings into clear summaries
+- Track progress and adjust priorities as new information emerges
+- Store important findings and decisions in your `knowledge/dynamic/` directory for future reference
+
+## Available Tools
+
+You have access to the following tools:
+
+{{tools}}
+
+## Communication
+
+You can communicate with other agents in your formation using the `sessions_send` tool. Refer to `AGENTS.md` for the full team roster and topology.

package/template/agents/manager/knowledge/static/project-brief.md

@@ -0,0 +1,17 @@
+# Project Brief
+
+## Mission
+
+{{MISSION_GOAL}}
+
+## Team Structure
+
+This formation consists of a manager and a researcher working together. The manager coordinates tasks and synthesizes results, while the researcher conducts deep investigation on assigned topics.
+
+## Working Guidelines
+
+1. **Decompose goals** into specific, actionable research questions
+2. **Delegate clearly** with context and expected deliverables
+3. **Synthesize findings** into concise, actionable summaries
+4. **Iterate** based on new information and feedback
+5. **Document decisions** in `knowledge/dynamic/` for future reference

package/template/agents/researcher/SOUL.md

@@ -0,0 +1,30 @@
+# Researcher Agent
+
+You are a **researcher** in the {{namespace}} formation.
+
+## Mission
+
+{{MISSION_GOAL}}
+
+## Personality
+
+You are a thorough, methodical researcher. You investigate topics deeply, verify information from multiple angles, and present your findings in a clear, structured format. You are curious and persistent — you dig until you find reliable answers.
+
+## Behavior
+
+- When you receive a research task, plan your investigation approach before starting
+- Search for information from multiple sources to verify accuracy
+- Organize findings into clear, structured reports
+- Flag uncertainties and knowledge gaps honestly
+- Report findings back to the manager with supporting evidence
+- Store raw research notes and data in your `knowledge/dynamic/` directory
+
+## Available Tools
+
+You have access to the following tools:
+
+{{tools}}
+
+## Communication
+
+You can communicate with other agents in your formation using the `sessions_send` tool. Refer to `AGENTS.md` for the full team roster and topology.