@openreef/cli 0.1.0

package/dist/core/packer.js

@@ -0,0 +1,26 @@
+import { create } from 'tar';
+import { join } from 'node:path';
+import { stat } from 'node:fs/promises';
+const EXCLUDE_PATTERNS = [
+    '.git',
+    'node_modules',
+    '.env',
+    '.reef',
+    '.DS_Store',
+];
+export async function pack(formationDir, name, version, outputDir) {
+    const filename = `${name}-${version}.reef.tar.gz`;
+    const outputPath = join(outputDir ?? formationDir, filename);
+    await create({
+        gzip: true,
+        file: outputPath,
+        cwd: formationDir,
+        filter: (path) => {
+            const parts = path.split('/');
+            return !parts.some((p) => EXCLUDE_PATTERNS.includes(p));
+        },
+    }, ['.']);
+    const info = await stat(outputPath);
+    return { outputPath, size: info.size };
+}
+//# sourceMappingURL=packer.js.map

package/dist/core/packer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packer.js","sourceRoot":"","sources":["../../src/core/packer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,MAAM,gBAAgB,GAAG;IACvB,MAAM;IACN,cAAc;IACd,MAAM;IACN,OAAO;IACP,WAAW;CACZ,CAAC;AAOF,MAAM,CAAC,KAAK,UAAU,IAAI,CACxB,YAAoB,EACpB,IAAY,EACZ,OAAe,EACf,SAAkB;IAElB,MAAM,QAAQ,GAAG,GAAG,IAAI,IAAI,OAAO,cAAc,CAAC;IAClD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,IAAI,YAAY,EAAE,QAAQ,CAAC,CAAC;IAE7D,MAAM,MAAM,CACV;QACE,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,YAAY;QACjB,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YACf,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC9B,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1D,CAAC;KACF,EACD,CAAC,GAAG,CAAC,CACN,CAAC;IAEF,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,CAAC;IACpC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;AACzC,CAAC"}

package/dist/core/schema-validator.d.ts

@@ -0,0 +1,3 @@
+import type { ValidationResult } from '../types/validation.js';
+export declare function validateSchema(data: unknown): Promise<ValidationResult>;
+//# sourceMappingURL=schema-validator.d.ts.map

package/dist/core/schema-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.d.ts","sourceRoot":"","sources":["../../src/core/schema-validator.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAwB/D,wBAAsB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAiB7E"}

package/dist/core/schema-validator.js

@@ -0,0 +1,35 @@
+import { readFileSync } from 'node:fs';
+import { getSchemaPath } from '../utils/paths.js';
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let validateFn = null;
+async function getValidator() {
+    if (validateFn)
+        return validateFn;
+    // Dynamic imports to handle CJS/ESM interop cleanly
+    const ajvMod = await import('ajv/dist/2020.js');
+    const formatsMod = await import('ajv-formats');
+    const Ajv2020 = ajvMod.default?.default ?? ajvMod.default ?? ajvMod;
+    const addFormats = formatsMod.default?.default ?? formatsMod.default ?? formatsMod;
+    const ajv = new Ajv2020({ allErrors: true, strict: false });
+    addFormats(ajv);
+    const schemaPath = getSchemaPath();
+    const schema = JSON.parse(readFileSync(schemaPath, 'utf-8'));
+    validateFn = ajv.compile(schema);
+    return validateFn;
+}
+export async function validateSchema(data) {
+    const validate = await getValidator();
+    const valid = validate(data);
+    if (valid) {
+        return { valid: true, issues: [] };
+    }
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const issues = (validate.errors ?? []).map((err) => ({
+        severity: 'error',
+        code: 'SCHEMA_ERROR',
+        message: `${err.instancePath || '/'} ${err.message ?? 'unknown error'}`,
+        path: err.instancePath || '/',
+    }));
+    return { valid: false, issues };
+}
+//# sourceMappingURL=schema-validator.js.map

package/dist/core/schema-validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-validator.js","sourceRoot":"","sources":["../../src/core/schema-validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD,8DAA8D;AAC9D,IAAI,UAAU,GAAQ,IAAI,CAAC;AAE3B,KAAK,UAAU,YAAY;IACzB,IAAI,UAAU;QAAE,OAAO,UAAU,CAAC;IAElC,oDAAoD;IACpD,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC;IAChD,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IAE/C,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,EAAE,OAAO,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC;IACpE,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,EAAE,OAAO,IAAI,UAAU,CAAC,OAAO,IAAI,UAAU,CAAC;IAEnF,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5D,UAAU,CAAC,GAAG,CAAC,CAAC;IAEhB,MAAM,UAAU,GAAG,aAAa,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAC7D,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACjC,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAa;IAChD,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAY,CAAC;IAExC,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACrC,CAAC;IAED,8DAA8D;IAC9D,MAAM,MAAM,GAAG,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAQ,EAAE,EAAE,CAAC,CAAC;QACxD,QAAQ,EAAE,OAAgB;QAC1B,IAAI,EAAE,cAAc;QACpB,OAAO,EAAE,GAAG,GAAG,CAAC,YAAY,IAAI,GAAG,IAAI,GAAG,CAAC,OAAO,IAAI,eAAe,EAAE;QACvE,IAAI,EAAE,GAAG,CAAC,YAAY,IAAI,GAAG;KAC9B,CAAC,CAAC,CAAC;IAEJ,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC"}

package/dist/core/structural-validator.d.ts

@@ -0,0 +1,4 @@
+import type { ReefManifest } from '../types/manifest.js';
+import type { ValidationResult } from '../types/validation.js';
+export declare function validateStructure(manifest: ReefManifest, formationDir: string): Promise<ValidationResult>;
+//# sourceMappingURL=structural-validator.d.ts.map

package/dist/core/structural-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-validator.d.ts","sourceRoot":"","sources":["../../src/core/structural-validator.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAmB,MAAM,wBAAwB,CAAC;AAIhF,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,YAAY,EACtB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,gBAAgB,CAAC,CAuI3B"}

package/dist/core/structural-validator.js

@@ -0,0 +1,134 @@
+import { join } from 'node:path';
+import { isDirectory } from '../utils/fs.js';
+import { scanVariableTokens } from '../utils/fs.js';
+export async function validateStructure(manifest, formationDir) {
+    const issues = [];
+    const agentSlugs = Object.keys(manifest.agents);
+    // Check agent source directories and SOUL.md
+    for (const [slug, agent] of Object.entries(manifest.agents)) {
+        const agentDir = join(formationDir, agent.source);
+        if (!(await isDirectory(agentDir))) {
+            issues.push({
+                severity: 'error',
+                code: 'AGENT_DIR_MISSING',
+                message: `Agent "${slug}" source directory not found: ${agent.source}`,
+                path: `agents.${slug}.source`,
+            });
+        }
+        else {
+            // Check for SOUL.md
+            try {
+                const { stat } = await import('node:fs/promises');
+                const soulPath = join(agentDir, 'SOUL.md');
+                await stat(soulPath);
+            }
+            catch {
+                issues.push({
+                    severity: 'error',
+                    code: 'SOUL_MD_MISSING',
+                    message: `Agent "${slug}" is missing required SOUL.md in ${agent.source}`,
+                    path: `agents.${slug}.source`,
+                });
+            }
+        }
+    }
+    // Check agentToAgent references
+    if (manifest.agentToAgent) {
+        for (const [source, targets] of Object.entries(manifest.agentToAgent)) {
+            if (!agentSlugs.includes(source)) {
+                issues.push({
+                    severity: 'error',
+                    code: 'AGENT_REF_INVALID',
+                    message: `agentToAgent source "${source}" is not a declared agent`,
+                    path: `agentToAgent.${source}`,
+                });
+            }
+            for (const target of targets) {
+                if (!agentSlugs.includes(target)) {
+                    issues.push({
+                        severity: 'error',
+                        code: 'AGENT_REF_INVALID',
+                        message: `agentToAgent target "${target}" (from "${source}") is not a declared agent`,
+                        path: `agentToAgent.${source}`,
+                    });
+                }
+            }
+        }
+    }
+    // Check binding agent references
+    if (manifest.bindings) {
+        for (const binding of manifest.bindings) {
+            if (!agentSlugs.includes(binding.agent)) {
+                issues.push({
+                    severity: 'error',
+                    code: 'BINDING_REF_INVALID',
+                    message: `Binding for channel "${binding.channel}" references unknown agent "${binding.agent}"`,
+                    path: 'bindings',
+                });
+            }
+        }
+    }
+    // Check cron agent references
+    if (manifest.cron) {
+        for (const job of manifest.cron) {
+            if (!agentSlugs.includes(job.agent)) {
+                issues.push({
+                    severity: 'error',
+                    code: 'CRON_REF_INVALID',
+                    message: `Cron job references unknown agent "${job.agent}"`,
+                    path: 'cron',
+                });
+            }
+        }
+    }
+    // Warning: type/agent-count mismatch
+    const agentCount = agentSlugs.length;
+    if (manifest.type === 'solo' && agentCount !== 1) {
+        issues.push({
+            severity: 'warning',
+            code: 'TYPE_COUNT_MISMATCH',
+            message: `Formation type is "solo" but has ${agentCount} agent(s) (expected 1)`,
+            path: 'type',
+        });
+    }
+    if (manifest.type === 'team' && (agentCount < 2 || agentCount > 5)) {
+        issues.push({
+            severity: 'warning',
+            code: 'TYPE_COUNT_MISMATCH',
+            message: `Formation type is "team" but has ${agentCount} agent(s) (expected 2-5)`,
+            path: 'type',
+        });
+    }
+    if (manifest.type === 'swarm' && agentCount < 6) {
+        issues.push({
+            severity: 'warning',
+            code: 'TYPE_COUNT_MISMATCH',
+            message: `Formation type is "swarm" but has ${agentCount} agent(s) (expected 6+)`,
+            path: 'type',
+        });
+    }
+    // Warning: undeclared variable tokens in .md files
+    const declaredVars = new Set(Object.keys(manifest.variables ?? {}));
+    const builtinVars = new Set(['namespace', 'tools']);
+    for (const [slug, agent] of Object.entries(manifest.agents)) {
+        const agentDir = join(formationDir, agent.source);
+        if (!(await isDirectory(agentDir)))
+            continue;
+        const tokens = await scanVariableTokens(agentDir);
+        for (const token of tokens) {
+            if (!declaredVars.has(token) && !builtinVars.has(token)) {
+                issues.push({
+                    severity: 'warning',
+                    code: 'UNDECLARED_VARIABLE',
+                    message: `Agent "${slug}" references undeclared variable "{{${token}}}"`,
+                    path: `agents.${slug}`,
+                });
+            }
+        }
+    }
+    return {
+        valid: issues.every((i) => i.severity !== 'error'),
+        issues,
+    };
+}
+//# sourceMappingURL=structural-validator.js.map

package/dist/core/structural-validator.js.map

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

package/dist/core/template-interpolator.d.ts

@@ -0,0 +1,2 @@
+export declare function interpolate(template: string, variables: Record<string, string>): string;
+//# sourceMappingURL=template-interpolator.d.ts.map

package/dist/core/template-interpolator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-interpolator.d.ts","sourceRoot":"","sources":["../../src/core/template-interpolator.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,MAAM,CAQR"}

package/dist/core/template-interpolator.js

@@ -0,0 +1,11 @@
+const TOKEN_PATTERN = /\{\{(\w+)\}\}/g;
+export function interpolate(template, variables) {
+    return template.replace(TOKEN_PATTERN, (match, name) => {
+        if (name in variables) {
+            return variables[name];
+        }
+        // Leave undeclared tokens untouched per spec
+        return match;
+    });
+}
+//# sourceMappingURL=template-interpolator.js.map

package/dist/core/template-interpolator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-interpolator.js","sourceRoot":"","sources":["../../src/core/template-interpolator.ts"],"names":[],"mappings":"AAAA,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAEvC,MAAM,UAAU,WAAW,CACzB,QAAgB,EAChB,SAAiC;IAEjC,OAAO,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,IAAY,EAAE,EAAE;QAC7D,IAAI,IAAI,IAAI,SAAS,EAAE,CAAC;YACtB,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QACD,6CAA6C;QAC7C,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/core/variable-resolver.d.ts

@@ -0,0 +1,12 @@
+import type { Variable } from '../types/manifest.js';
+export interface ResolveOptions {
+    cliOverrides?: Record<string, string>;
+    envFilePath?: string;
+    interactive?: boolean;
+}
+export interface ResolveResult {
+    resolved: Record<string, string>;
+    missing: string[];
+}
+export declare function resolveVariables(variables: Record<string, Variable>, formationDir: string, options?: ResolveOptions): Promise<ResolveResult>;
+//# sourceMappingURL=variable-resolver.d.ts.map

package/dist/core/variable-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-resolver.d.ts","sourceRoot":"","sources":["../../src/core/variable-resolver.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,EACnC,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,aAAa,CAAC,CA+BxB"}

package/dist/core/variable-resolver.js

@@ -0,0 +1,38 @@
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { parse as parseDotenv } from 'dotenv';
+export async function resolveVariables(variables, formationDir, options = {}) {
+    const resolved = {};
+    const missing = [];
+    // Load .env file if present
+    let envFileVars = {};
+    const envPath = options.envFilePath ?? join(formationDir, '.env');
+    try {
+        const envContent = await readFile(envPath, 'utf-8');
+        envFileVars = parseDotenv(Buffer.from(envContent));
+    }
+    catch {
+        // .env file not found — that's fine
+    }
+    for (const [name, config] of Object.entries(variables)) {
+        // Precedence: CLI > .env > env > defaults
+        if (options.cliOverrides?.[name] !== undefined) {
+            resolved[name] = options.cliOverrides[name];
+        }
+        else if (envFileVars[name] !== undefined) {
+            resolved[name] = envFileVars[name];
+        }
+        else if (process.env[name] !== undefined) {
+            resolved[name] = process.env[name];
+        }
+        else if (config.default !== undefined) {
+            resolved[name] = String(config.default);
+        }
+        else if (config.required) {
+            // Interactive prompting would go here for `reef install`
+            missing.push(name);
+        }
+    }
+    return { resolved, missing };
+}
+//# sourceMappingURL=variable-resolver.js.map

package/dist/core/variable-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"variable-resolver.js","sourceRoot":"","sources":["../../src/core/variable-resolver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,KAAK,IAAI,WAAW,EAAE,MAAM,QAAQ,CAAC;AAc9C,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,SAAmC,EACnC,YAAoB,EACpB,UAA0B,EAAE;IAE5B,MAAM,QAAQ,GAA2B,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,4BAA4B;IAC5B,IAAI,WAAW,GAA2B,EAAE,CAAC;IAC7C,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IAClE,IAAI,CAAC;QACH,MAAM,UAAU,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpD,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,oCAAoC;IACtC,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;QACvD,0CAA0C;QAC1C,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAC/C,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QAC9C,CAAC;aAAM,IAAI,WAAW,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3C,QAAQ,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;aAAM,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YAC3C,QAAQ,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;QACtC,CAAC;aAAM,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACxC,QAAQ,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC1C,CAAC;aAAM,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC3B,yDAAyD;YACzD,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AAC/B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { inspect } from './commands/inspect.js';
+import { validate } from './commands/validate.js';
+import { init } from './commands/init.js';
+import { pack } from './commands/pack.js';
+const program = new Command();
+program
+    .name('reef')
+    .description('OpenReef CLI — package and deploy multi-agent formations')
+    .version('0.1.0');
+program
+    .command('init [name]')
+    .description('Scaffold a new formation from the bundled template')
+    .option('--name <name>', 'Formation name')
+    .option('--namespace <namespace>', 'Namespace prefix')
+    .option('--type <type>', 'Formation type (solo, team, swarm)', 'team')
+    .option('--yes', 'Skip confirmation prompts')
+    .action(async (name, options) => {
+    try {
+        await init(name, options);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+});
+program
+    .command('inspect <path>')
+    .description('Parse reef.json and pretty-print formation contents')
+    .action(async (path) => {
+    try {
+        await inspect(path);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+});
+program
+    .command('validate <path>')
+    .description('Run schema and structural validation on a formation')
+    .option('--quiet', 'Suppress output, exit code only')
+    .option('--json', 'Output results as JSON')
+    .action(async (path, options) => {
+    try {
+        const result = await validate(path, options);
+        process.exit(result.valid ? 0 : 1);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+});
+program
+    .command('pack <path>')
+    .description('Package a formation into a .tar.gz archive')
+    .option('--output <dir>', 'Output directory')
+    .action(async (path, options) => {
+    try {
+        await pack(path, options);
+    }
+    catch (err) {
+        console.error(err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/types/manifest.d.ts

@@ -0,0 +1,75 @@
+export interface AgentTools {
+    allow?: string[];
+}
+export interface AgentSandbox {
+    network?: boolean;
+    filesystem?: 'full' | 'restricted' | 'none';
+}
+export interface Agent {
+    source: string;
+    description: string;
+    role?: string;
+    model?: string;
+    tools?: AgentTools;
+    sandbox?: AgentSandbox;
+}
+export interface Variable {
+    type: 'string' | 'number' | 'boolean';
+    description?: string;
+    default?: string | number | boolean;
+    required?: boolean;
+    sensitive?: boolean;
+}
+export interface Binding {
+    channel: string;
+    agent: string;
+    direction?: 'inbound' | 'outbound' | 'bidirectional';
+}
+export interface CronJob {
+    schedule: string;
+    agent: string;
+    prompt: string;
+    timezone?: string;
+}
+export interface Service {
+    name: string;
+    url?: string;
+    required?: boolean;
+    description?: string;
+}
+export interface Dependencies {
+    skills?: Record<string, string>;
+    services?: Service[];
+}
+export interface ValidationConfig {
+    agent_exists?: boolean;
+    file_exists?: boolean;
+    binding_active?: boolean;
+    cron_exists?: boolean;
+    agent_responds?: {
+        enabled?: boolean;
+        timeout?: number;
+    };
+}
+export interface Compatibility {
+    openclaw?: string;
+}
+export interface ReefManifest {
+    reef: '1.0';
+    type: 'solo' | 'team' | 'swarm';
+    name: string;
+    version: string;
+    description: string;
+    author?: string;
+    license?: string;
+    compatibility?: Compatibility;
+    namespace: string;
+    variables?: Record<string, Variable>;
+    agents: Record<string, Agent>;
+    agentToAgent?: Record<string, string[]>;
+    bindings?: Binding[];
+    cron?: CronJob[];
+    dependencies?: Dependencies;
+    validation?: ValidationConfig;
+}
+//# sourceMappingURL=manifest.d.ts.map

package/dist/types/manifest.d.ts.map

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

package/dist/types/manifest.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=manifest.js.map

package/dist/types/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/types/manifest.ts"],"names":[],"mappings":""}

package/dist/types/platform.d.ts

@@ -0,0 +1,29 @@
+/**
+ * PlatformAdapter — architectural seam for OpenClaw Gateway RPC.
+ *
+ * The offline commands (init, inspect, validate, pack) operate directly on
+ * the filesystem via node:fs and don't need this adapter. It exists purely
+ * to establish the interface for when `reef install` is built later.
+ */
+export interface PlatformAdapter {
+    createAgent(id: string, config: Record<string, unknown>): Promise<void>;
+    getAgent(id: string): Promise<Record<string, unknown> | null>;
+    deleteAgent(id: string): Promise<void>;
+    listAgents(namespace: string): Promise<string[]>;
+    writeFile(agentId: string, path: string, content: string): Promise<void>;
+    readFile(agentId: string, path: string): Promise<string>;
+    fileExists(agentId: string, path: string): Promise<boolean>;
+    deleteFile(agentId: string, path: string): Promise<void>;
+    createBinding(agentId: string, binding: Record<string, unknown>): Promise<void>;
+    deleteBinding(agentId: string, bindingId: string): Promise<void>;
+    listBindings(agentId: string): Promise<Record<string, unknown>[]>;
+    isBindingActive(agentId: string, bindingId: string): Promise<boolean>;
+    createCron(agentId: string, cron: Record<string, unknown>): Promise<void>;
+    deleteCron(agentId: string, cronId: string): Promise<void>;
+    listCrons(agentId: string): Promise<Record<string, unknown>[]>;
+    sendPing(agentId: string): Promise<boolean>;
+    readState(key: string): Promise<string | null>;
+    writeState(key: string, value: string): Promise<void>;
+    deleteState(key: string): Promise<void>;
+}
+//# sourceMappingURL=platform.d.ts.map

package/dist/types/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/types/platform.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAE9B,WAAW,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxE,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9D,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAGjD,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzE,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IACzD,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC5D,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAGzD,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChF,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjE,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAClE,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAGtE,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3D,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;IAG/D,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAG5C,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC/C,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACzC"}

package/dist/types/platform.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=platform.js.map

package/dist/types/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/types/platform.ts"],"names":[],"mappings":""}

package/dist/types/validation.d.ts

@@ -0,0 +1,12 @@
+export type IssueSeverity = 'error' | 'warning' | 'info';
+export interface ValidationIssue {
+    severity: IssueSeverity;
+    code: string;
+    message: string;
+    path?: string;
+}
+export interface ValidationResult {
+    valid: boolean;
+    issues: ValidationIssue[];
+}
+//# sourceMappingURL=validation.d.ts.map

package/dist/types/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/types/validation.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,aAAa,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B"}

package/dist/types/validation.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=validation.js.map

package/dist/types/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/types/validation.ts"],"names":[],"mappings":""}

package/dist/utils/fs.d.ts

@@ -0,0 +1,5 @@
+export declare function isDirectory(path: string): Promise<boolean>;
+export declare function copyDir(src: string, dest: string, exclude?: string[]): Promise<void>;
+export declare function listFiles(dir: string): Promise<string[]>;
+export declare function scanVariableTokens(dir: string): Promise<string[]>;
+//# sourceMappingURL=fs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../src/utils/fs.ts"],"names":[],"mappings":"AAGA,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOhE;AAED,wBAAsB,OAAO,CAC3B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,MAAM,EAAE,GACjB,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED,wBAAsB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAiB9D;AAED,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAevE"}

package/dist/utils/fs.js

@@ -0,0 +1,60 @@
+import { readdir, stat, mkdir, copyFile, readFile } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+export async function isDirectory(path) {
+    try {
+        const s = await stat(path);
+        return s.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+export async function copyDir(src, dest, exclude) {
+    await mkdir(dest, { recursive: true });
+    const entries = await readdir(src, { withFileTypes: true });
+    for (const entry of entries) {
+        if (exclude?.includes(entry.name))
+            continue;
+        const srcPath = join(src, entry.name);
+        const destPath = join(dest, entry.name);
+        if (entry.isDirectory()) {
+            await copyDir(srcPath, destPath, exclude);
+        }
+        else {
+            await copyFile(srcPath, destPath);
+        }
+    }
+}
+export async function listFiles(dir) {
+    const results = [];
+    async function walk(current) {
+        const entries = await readdir(current, { withFileTypes: true });
+        for (const entry of entries) {
+            const fullPath = join(current, entry.name);
+            if (entry.isDirectory()) {
+                await walk(fullPath);
+            }
+            else {
+                results.push(relative(dir, fullPath));
+            }
+        }
+    }
+    await walk(dir);
+    return results.sort();
+}
+export async function scanVariableTokens(dir) {
+    const tokens = new Set();
+    const files = await listFiles(dir);
+    const pattern = /\{\{(\w+)\}\}/g;
+    for (const file of files) {
+        if (!file.endsWith('.md'))
+            continue;
+        const content = await readFile(join(dir, file), 'utf-8');
+        let match;
+        while ((match = pattern.exec(content)) !== null) {
+            tokens.add(match[1]);
+        }
+    }
+    return [...tokens].sort();
+}
+//# sourceMappingURL=fs.js.map