@openreef/cli 0.3.3 → 0.4.0

package/dist/utils/tarball.d.ts

@@ -1,12 +1,25 @@
+export interface ResolveOptions {
+    registryUrl?: string;
+    skipCache?: boolean;
+}
+export interface ResolvedFormation {
+    formationPath: string;
+    tempDir: string | null;
+    registryRef?: {
+        name: string;
+        version: string;
+    };
+}
 /**
- * If the given path looks like a tarball (.tar.gz or .tgz), extract it
- * to a temp directory and return the extracted path. Otherwise return
- * the original path unchanged.
+ * Resolve a formation source to a local directory path.
+ *
+ * Resolution order (local-first):
+ * 1. Tarball (.tar.gz, .tgz) → extract to temp dir
+ * 2. Local path exists → use as-is (local always wins)
+ * 3. Bare formation name → resolve from registry
+ * 4. Otherwise → treat as local path (fails naturally in manifest loader)
  *
  * Caller is responsible for cleaning up the temp directory if one was created.
  */
-export declare function resolveFormationPath(inputPath: string): Promise<{
-    formationPath: string;
-    tempDir: string | null;
-}>;
+export declare function resolveFormationPath(inputPath: string, options?: ResolveOptions): Promise<ResolvedFormation>;
 //# sourceMappingURL=tarball.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tarball.d.ts","sourceRoot":"","sources":["../../src/utils/tarball.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;IAAE,aAAa,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAQ5D"}
+{"version":3,"file":"tarball.d.ts","sourceRoot":"","sources":["../../src/utils/tarball.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,cAAc;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,WAAW,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CACjD;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,oBAAoB,CACxC,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,cAAc,GACvB,OAAO,CAAC,iBAAiB,CAAC,CA6B5B"}

package/dist/utils/tarball.js

@@ -1,23 +1,50 @@
 import { mkdtemp } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
 import { join } from 'node:path';
 import { tmpdir } from 'node:os';
 import { extract } from 'tar';
+import { isBareFormationName, parseRegistryRef, resolveFromRegistry, } from '../core/registry.js';
 /**
- * If the given path looks like a tarball (.tar.gz or .tgz), extract it
- * to a temp directory and return the extracted path. Otherwise return
- * the original path unchanged.
+ * Resolve a formation source to a local directory path.
+ *
+ * Resolution order (local-first):
+ * 1. Tarball (.tar.gz, .tgz) → extract to temp dir
+ * 2. Local path exists → use as-is (local always wins)
+ * 3. Bare formation name → resolve from registry
+ * 4. Otherwise → treat as local path (fails naturally in manifest loader)
  *
  * Caller is responsible for cleaning up the temp directory if one was created.
  */
-export async function resolveFormationPath(inputPath) {
-    if (!isTarball(inputPath)) {
+export async function resolveFormationPath(inputPath, options) {
+    // 1. Tarball?
+    if (isTarball(inputPath)) {
+        const tempDir = await mkdtemp(join(tmpdir(), 'reef-install-'));
+        await extract({ file: inputPath, cwd: tempDir });
+        return { formationPath: tempDir, tempDir };
+    }
+    // 2. Local path exists? (local always wins)
+    if (existsSync(inputPath)) {
         return { formationPath: inputPath, tempDir: null };
     }
-    const tempDir = await mkdtemp(join(tmpdir(), 'reef-install-'));
-    await extract({ file: inputPath, cwd: tempDir });
-    return { formationPath: tempDir, tempDir };
+    // 3. Bare formation name? → resolve from registry
+    if (isBareFormationName(inputPath)) {
+        const { name, version } = parseRegistryRef(inputPath);
+        const result = await resolveFromRegistry(name, version, {
+            registryUrl: options?.registryUrl,
+            skipCache: options?.skipCache,
+        });
+        return {
+            formationPath: result.formationPath,
+            tempDir: result.tempDir,
+            registryRef: { name: result.name, version: result.version },
+        };
+    }
+    // 4. Fallthrough → treat as local path
+    return { formationPath: inputPath, tempDir: null };
 }
 function isTarball(path) {
-    return path.endsWith('.tar.gz') || path.endsWith('.tgz') || path.endsWith('.reef.tar.gz');
+    return (path.endsWith('.tar.gz') ||
+        path.endsWith('.tgz') ||
+        path.endsWith('.reef.tar.gz'));
 }
 //# sourceMappingURL=tarball.js.map

package/dist/utils/tarball.js.map

@@ -1 +1 @@
-{"version":3,"file":"tarball.js","sourceRoot":"","sources":["../../src/utils/tarball.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAAiB;IAEjB,IAAI,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACrD,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC;IAC/D,MAAM,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;IACjD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC7C,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;AAC5F,CAAC"}
+{"version":3,"file":"tarball.js","sourceRoot":"","sources":["../../src/utils/tarball.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAC9B,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAa7B;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAAiB,EACjB,OAAwB;IAExB,cAAc;IACd,IAAI,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,eAAe,CAAC,CAAC,CAAC;QAC/D,MAAM,OAAO,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;QACjD,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;IAC7C,CAAC;IAED,4CAA4C;IAC5C,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IACrD,CAAC;IAED,kDAAkD;IAClD,IAAI,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;QACnC,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,MAAM,mBAAmB,CAAC,IAAI,EAAE,OAAO,EAAE;YACtD,WAAW,EAAE,OAAO,EAAE,WAAW;YACjC,SAAS,EAAE,OAAO,EAAE,SAAS;SAC9B,CAAC,CAAC;QACH,OAAO;YACL,aAAa,EAAE,MAAM,CAAC,aAAa;YACnC,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,WAAW,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE;SAC5D,CAAC;IACJ,CAAC;IAED,uCAAuC;IACvC,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACrD,CAAC;AAED,SAAS,SAAS,CAAC,IAAY;IAC7B,OAAO,CACL,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;QACxB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAC9B,CAAC;AACJ,CAAC"}

package/dist/version.d.ts

@@ -0,0 +1,2 @@
+export declare const VERSION: string;
+//# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,OAAO,EAAE,MAAoB,CAAC"}

package/dist/version.js

@@ -0,0 +1,5 @@
+import { createRequire } from 'node:module';
+const require = createRequire(import.meta.url);
+const pkg = require('../package.json');
+export const VERSION = pkg.version;
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAE9D,MAAM,CAAC,MAAM,OAAO,GAAW,GAAG,CAAC,OAAO,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openreef/cli",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "CLI toolchain for OpenReef formations — package and deploy multi-agent teams",
   "type": "module",
   "bin": {

package/schema/reef.schema.json

@@ -176,12 +176,6 @@
           "agent": {
             "type": "string",
             "description": "Agent slug to bind."
-          },
-          "direction": {
-            "type": "string",
-            "description": "Binding direction.",
-            "enum": ["inbound", "outbound", "bidirectional"],
-            "default": "bidirectional"
           }
         }
       }