@openreef/cli 0.4.0 → 0.5.0

package/dist/utils/download.js

@@ -0,0 +1,72 @@
+import { createHash } from 'node:crypto';
+import { existsSync } from 'node:fs';
+import { mkdir, readFile, writeFile, unlink } from 'node:fs/promises';
+import { join } from 'node:path';
+export class ArtifactDownloadError extends Error {
+    cause;
+    constructor(message, cause) {
+        super(message);
+        this.cause = cause;
+        this.name = 'ArtifactDownloadError';
+    }
+}
+export class ArtifactIntegrityError extends Error {
+    expected;
+    actual;
+    constructor(expected, actual) {
+        super(`Integrity check failed: expected sha256 ${expected}, got ${actual}`);
+        this.expected = expected;
+        this.actual = actual;
+        this.name = 'ArtifactIntegrityError';
+    }
+}
+function validateUrlScheme(url) {
+    if (!url.startsWith('https://') && !url.startsWith('http://')) {
+        throw new ArtifactDownloadError(`Invalid URL scheme: only https:// and http:// are allowed, got "${url}"`);
+    }
+}
+export async function downloadArtifact(options) {
+    const { url, sha256, cacheDir, cacheName, userAgent } = options;
+    const hasHash = !!sha256;
+    const subdir = hasHash ? 'verified' : 'unverified';
+    const cachePath = join(cacheDir, subdir, cacheName);
+    // Verified artifacts: reuse from cache after re-checking hash
+    if (hasHash && existsSync(cachePath)) {
+        const cached = await readFile(cachePath);
+        const cachedHash = createHash('sha256').update(cached).digest('hex');
+        if (cachedHash === sha256) {
+            return cachePath;
+        }
+        await unlink(cachePath).catch(() => { });
+    }
+    if (!hasHash) {
+        console.warn(`WARNING: No integrity hash — artifact is UNVERIFIED`);
+    }
+    validateUrlScheme(url);
+    let response;
+    try {
+        response = await fetch(url, {
+            headers: { 'User-Agent': userAgent },
+        });
+    }
+    catch (err) {
+        throw new ArtifactDownloadError(`Failed to download: ${err instanceof Error ? err.message : String(err)}`, err);
+    }
+    if (!response.ok) {
+        throw new ArtifactDownloadError(`Download returned HTTP ${response.status}: ${response.statusText}`);
+    }
+    const buffer = Buffer.from(await response.arrayBuffer());
+    // Verify SHA-256 if present
+    if (sha256) {
+        const actual = createHash('sha256').update(buffer).digest('hex');
+        if (actual !== sha256) {
+            throw new ArtifactIntegrityError(sha256, actual);
+        }
+    }
+    // Write to cache
+    const parentDir = join(cacheDir, subdir);
+    await mkdir(parentDir, { recursive: true });
+    await writeFile(cachePath, buffer);
+    return cachePath;
+}
+//# sourceMappingURL=download.js.map

package/dist/utils/download.js.map

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

package/dist/utils/plan-display.d.ts

@@ -0,0 +1,3 @@
+import type { MigrationPlan } from '../core/migration-planner.js';
+export declare function displayMigrationPlan(plan: MigrationPlan, namespace: string, name: string): void;
+//# sourceMappingURL=plan-display.d.ts.map

package/dist/utils/plan-display.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan-display.d.ts","sourceRoot":"","sources":["../../src/utils/plan-display.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAOlE,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,aAAa,EACnB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,GACX,IAAI,CAuFN"}

package/dist/utils/plan-display.js

@@ -0,0 +1,80 @@
+import chalk from 'chalk';
+import { header, label } from './output.js';
+import { extractChannelType, isBareChannel, } from '../core/config-patcher.js';
+export function displayMigrationPlan(plan, namespace, name) {
+    console.log('');
+    const versionStr = plan.versionChange
+        ? ` v${plan.versionChange.from} → v${plan.versionChange.to}`
+        : '';
+    console.log(header(`Migration Plan: ${namespace}/${name}${versionStr}`));
+    console.log('');
+    // Agents
+    console.log(label('Agents:'));
+    for (const a of plan.agents) {
+        switch (a.type) {
+            case 'add':
+                console.log(`  ${chalk.green('+')} ${a.slug} (add)`);
+                break;
+            case 'remove':
+                console.log(`  ${chalk.red('-')} ${a.slug} (remove)`);
+                break;
+            case 'update':
+                console.log(`  ${chalk.yellow('~')} ${a.slug} (${a.changedFiles?.length} files changed)`);
+                break;
+            case 'unchanged':
+                console.log(`  ${chalk.dim('=')} ${a.slug} (unchanged)`);
+                break;
+        }
+    }
+    // Bindings
+    if (plan.bindings.length > 0) {
+        console.log('');
+        console.log(label('Bindings:'));
+        for (const b of plan.bindings) {
+            if (b.type === 'add') {
+                const channelType = extractChannelType(b.binding.match.channel);
+                const bare = isBareChannel(b.binding.match.channel);
+                let annotation = '';
+                if (bare) {
+                    annotation = chalk.dim(' (bare channel — shadows main)');
+                }
+                console.log(`  ${chalk.green('+')} ${b.binding.match.channel} → ${b.binding.agentId}${annotation}`);
+            }
+            else {
+                console.log(`  ${chalk.red('-')} ${b.binding.match.channel} → ${b.binding.agentId}`);
+            }
+        }
+    }
+    // Cron
+    if (plan.cron.length > 0) {
+        console.log('');
+        console.log(label('Cron Jobs:'));
+        for (const c of plan.cron) {
+            switch (c.type) {
+                case 'add':
+                    console.log(`  ${chalk.green('+')} ${c.name}`);
+                    break;
+                case 'remove':
+                    console.log(`  ${chalk.red('-')} ${c.name}`);
+                    break;
+                case 'update':
+                    console.log(`  ${chalk.yellow('~')} ${c.name}`);
+                    break;
+            }
+        }
+    }
+    // A2a
+    if (plan.a2a.length > 0) {
+        console.log('');
+        console.log(label('Agent-to-Agent:'));
+        for (const edge of plan.a2a) {
+            const prefix = edge.type === 'add'
+                ? chalk.green('+')
+                : edge.type === 'remove'
+                    ? chalk.red('-')
+                    : chalk.yellow('~');
+            console.log(`  ${prefix} ${edge.from} → ${edge.to}`);
+        }
+    }
+}
+//# sourceMappingURL=plan-display.js.map

package/dist/utils/plan-display.js.map

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

package/dist/utils/semver.d.ts

@@ -0,0 +1,12 @@
+export declare class UnsupportedSemverRange extends Error {
+    constructor(range: string);
+}
+export declare function parseSemver(v: string): {
+    major: number;
+    minor: number;
+    patch: number;
+};
+export declare function compareSemver(a: string, b: string): number;
+export declare function satisfiesRange(version: string, range: string): boolean;
+export declare function resolveRange(versions: string[], range: string): string | null;
+//# sourceMappingURL=semver.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"semver.d.ts","sourceRoot":"","sources":["../../src/utils/semver.ts"],"names":[],"mappings":"AAAA,qBAAa,sBAAuB,SAAQ,KAAK;gBACnC,KAAK,EAAE,MAAM;CAI1B;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAWtF;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAM1D;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAoDtE;AAED,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAK7E"}

package/dist/utils/semver.js

@@ -0,0 +1,82 @@
+export class UnsupportedSemverRange extends Error {
+    constructor(range) {
+        super(`Unsupported semver range: "${range}"`);
+        this.name = 'UnsupportedSemverRange';
+    }
+}
+export function parseSemver(v) {
+    const cleaned = v.startsWith('v') ? v.slice(1) : v;
+    const match = /^(\d+)\.(\d+)\.(\d+)$/.exec(cleaned);
+    if (!match) {
+        throw new Error(`Invalid semver version: "${v}"`);
+    }
+    return {
+        major: parseInt(match[1], 10),
+        minor: parseInt(match[2], 10),
+        patch: parseInt(match[3], 10),
+    };
+}
+export function compareSemver(a, b) {
+    const pa = parseSemver(a);
+    const pb = parseSemver(b);
+    if (pa.major !== pb.major)
+        return pa.major - pb.major;
+    if (pa.minor !== pb.minor)
+        return pa.minor - pb.minor;
+    return pa.patch - pb.patch;
+}
+export function satisfiesRange(version, range) {
+    const trimmed = range.trim();
+    // Wildcard — matches everything
+    if (trimmed === '*')
+        return true;
+    // Exact match: 1.2.3
+    if (/^\d+\.\d+\.\d+$/.test(trimmed)) {
+        return compareSemver(version, trimmed) === 0;
+    }
+    // Caret: ^1.2.3
+    const caretMatch = /^\^(\d+\.\d+\.\d+)$/.exec(trimmed);
+    if (caretMatch) {
+        const base = parseSemver(caretMatch[1]);
+        const v = parseSemver(version);
+        if (base.major > 0) {
+            // ^1.2.3 := >=1.2.3, <2.0.0
+            return v.major === base.major &&
+                compareSemver(version, caretMatch[1]) >= 0;
+        }
+        if (base.minor > 0) {
+            // ^0.2.3 := >=0.2.3, <0.3.0
+            return v.major === 0 &&
+                v.minor === base.minor &&
+                compareSemver(version, caretMatch[1]) >= 0;
+        }
+        // ^0.0.3 := >=0.0.3, <0.0.4
+        return v.major === 0 &&
+            v.minor === 0 &&
+            v.patch === base.patch;
+    }
+    // Tilde: ~1.2.3
+    const tildeMatch = /^~(\d+\.\d+\.\d+)$/.exec(trimmed);
+    if (tildeMatch) {
+        const base = parseSemver(tildeMatch[1]);
+        const v = parseSemver(version);
+        // ~1.2.3 := >=1.2.3, <1.3.0
+        return v.major === base.major &&
+            v.minor === base.minor &&
+            compareSemver(version, tildeMatch[1]) >= 0;
+    }
+    // GTE: >=1.2.3
+    const gteMatch = /^>=(\d+\.\d+\.\d+)$/.exec(trimmed);
+    if (gteMatch) {
+        return compareSemver(version, gteMatch[1]) >= 0;
+    }
+    throw new UnsupportedSemverRange(range);
+}
+export function resolveRange(versions, range) {
+    const matching = versions.filter((v) => satisfiesRange(v, range));
+    if (matching.length === 0)
+        return null;
+    matching.sort(compareSemver);
+    return matching[matching.length - 1];
+}
+//# sourceMappingURL=semver.js.map

package/dist/utils/semver.js.map

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

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@openreef/cli",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "CLI toolchain for OpenReef formations — package and deploy multi-agent teams",
   "type": "module",
   "bin": {
-    "reef": "./dist/index.js"
+    "reef": "dist/index.js"
   },
   "files": [
     "dist",
@@ -51,6 +51,6 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/openreefai/openreef.git"
+    "url": "git+https://github.com/openreefai/openreef.git"
   }
 }