network-ai 5.3.2 → 5.4.1

package/dist/lib/env-manager.js

@@ -0,0 +1,500 @@
+"use strict";
+/**
+ * EnvironmentManager — Multi-environment isolation for Network-AI
+ *
+ * Provides strict data directory separation between environments
+ * (dev, st, sit, qa, sandbox, preprod, prod) with promotion chain
+ * enforcement, approval gates, and automatic backup/restore.
+ *
+ * Promotion chain: dev → st → sit → qa → preprod → prod
+ * Sandbox is a dead-end (non-promotable testing space).
+ *
+ * Gate types:
+ *   - auto:     promotion proceeds without human interaction
+ *   - confirm:  promotion requires `confirmedBy` string to be set
+ *   - approval: promotion requires `approvedBy` string to be set
+ *
+ * @module EnvironmentManager
+ * @version 1.0.0
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvironmentManager = void 0;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const crypto_1 = require("crypto");
+// ============================================================================
+// DEFAULTS
+// ============================================================================
+/** Default promotion chain. */
+const DEFAULT_CHAIN = ['dev', 'st', 'sit', 'qa', 'preprod', 'prod'];
+/** Default gate configuration. */
+const DEFAULT_GATES = {
+    dev: 'auto',
+    st: 'auto',
+    sit: 'auto',
+    qa: 'auto',
+    sandbox: 'auto',
+    preprod: 'confirm',
+    prod: 'approval',
+};
+/**
+ * Files that ARE copied during promotion (config artefacts only).
+ * Live operational state is never promoted.
+ */
+const PROMOTE_INCLUDE = [
+    'trust_levels.json',
+    'budget_ceilings.json',
+    'validation_rules.json',
+];
+/**
+ * Files/directories that are NEVER copied during promotion.
+ * Matches by name prefix or exact name.
+ */
+const PROMOTE_EXCLUDE = [
+    'audit_log.jsonl',
+    'active_grants.json',
+    'pending_changes',
+    '.backups',
+];
+// ============================================================================
+// MAIN CLASS
+// ============================================================================
+/**
+ * Manages isolated data directories for multiple deployment environments.
+ *
+ * @example
+ * ```typescript
+ * const mgr = new EnvironmentManager('/path/to/project/data');
+ * mgr.initAll();
+ * const devDir = mgr.getDataDir('dev');  // → /path/to/project/data/dev
+ * mgr.promote('dev', 'st');              // auto-gate
+ * mgr.promote('qa', 'preprod', { confirmedBy: 'ops-lead' });
+ * mgr.promote('preprod', 'prod', { approvedBy: 'cto@example.com' });
+ * ```
+ */
+class EnvironmentManager {
+    baseDir;
+    config;
+    /**
+     * @param baseDir - Root data directory (e.g. `path.join(process.cwd(), 'data')`).
+     * @param config - Optional overrides for chain, gates, and backup retention.
+     */
+    constructor(baseDir, config) {
+        this.baseDir = (0, path_1.resolve)(baseDir);
+        this.config = {
+            chain: config?.chain ?? DEFAULT_CHAIN,
+            gates: { ...DEFAULT_GATES, ...(config?.gates ?? {}) },
+            backupRetain: config?.backupRetain ?? 10,
+        };
+        // Load env-config.json if present (overrides constructor config)
+        this._loadEnvConfig();
+    }
+    // --------------------------------------------------------------------------
+    // Path helpers
+    // --------------------------------------------------------------------------
+    /**
+     * Returns the isolated data directory for the given environment.
+     * Creates it if it does not exist.
+     */
+    getDataDir(env) {
+        const envPath = (0, path_1.join)(this.baseDir, env);
+        // Normalise and guard against traversal
+        const safe = (0, path_1.resolve)(envPath);
+        if (!safe.startsWith(this.baseDir + require('path').sep) && safe !== this.baseDir) {
+            throw new Error(`Environment name '${env}' would escape the base directory`);
+        }
+        return safe;
+    }
+    // --------------------------------------------------------------------------
+    // Init
+    // --------------------------------------------------------------------------
+    /**
+     * Scaffold the standard subdirectory layout for a single environment.
+     * Idempotent — safe to call multiple times.
+     */
+    init(env) {
+        const base = this.getDataDir(env);
+        const dirs = [
+            base,
+            (0, path_1.join)(base, 'blackboard'),
+            (0, path_1.join)(base, 'pending_changes'),
+            (0, path_1.join)(base, '.backups'),
+        ];
+        for (const d of dirs) {
+            (0, fs_1.mkdirSync)(d, { recursive: true, mode: 0o700 });
+        }
+        // Touch empty state files so downstream code never hits ENOENT
+        this._touchJson((0, path_1.join)(base, 'trust_levels.json'), {});
+        this._touchJson((0, path_1.join)(base, 'active_grants.json'), []);
+        this._touchJson((0, path_1.join)(base, 'project-context.json'), { env });
+        this._touchFile((0, path_1.join)(base, 'audit_log.jsonl'));
+    }
+    /** Scaffold all environments in the promotion chain plus sandbox. */
+    initAll() {
+        const envs = new Set([...this.config.chain, 'sandbox']);
+        for (const env of envs) {
+            this.init(env);
+        }
+    }
+    // --------------------------------------------------------------------------
+    // Promotion
+    // --------------------------------------------------------------------------
+    /**
+     * Promotes configuration artefacts from one environment to the next.
+     * Live state (audit log, active grants, pending changes, blackboard entries)
+     * is never promoted.
+     *
+     * @throws {Error} If gate requirements are not met, or sandbox is the source.
+     */
+    promote(from, to, options = {}) {
+        if (!this.isPromotable(from)) {
+            throw new Error(`Environment '${from}' is not promotable (sandbox is a dead-end)`);
+        }
+        const chain = this.config.chain;
+        const fromIdx = chain.indexOf(from);
+        const toIdx = chain.indexOf(to);
+        if (fromIdx === -1)
+            throw new Error(`Environment '${from}' is not in the promotion chain`);
+        if (toIdx === -1)
+            throw new Error(`Environment '${to}' is not in the promotion chain`);
+        if (toIdx !== fromIdx + 1) {
+            throw new Error(`Can only promote one step at a time (${from} → ${chain[fromIdx + 1]}, not ${to})`);
+        }
+        // Gate enforcement
+        const gate = this.getGateType(to);
+        if (gate === 'confirm' && !options.confirmedBy) {
+            throw new Error(`Promotion to '${to}' requires confirmedBy (gate: confirm)`);
+        }
+        if (gate === 'approval' && !options.approvedBy) {
+            throw new Error(`Promotion to '${to}' requires approvedBy (gate: approval)`);
+        }
+        // Auto-backup destination before overwriting
+        if ((0, fs_1.existsSync)(this.getDataDir(to))) {
+            this.backup(to);
+        }
+        const fromDir = this.getDataDir(from);
+        const toDir = this.getDataDir(to);
+        this.init(to);
+        const copied = [];
+        const skipped = [];
+        // Copy only promotion-safe config files
+        for (const file of PROMOTE_INCLUDE) {
+            const src = (0, path_1.join)(fromDir, file);
+            const dst = (0, path_1.join)(toDir, file);
+            if ((0, fs_1.existsSync)(src)) {
+                (0, fs_1.copyFileSync)(src, dst);
+                copied.push(file);
+            }
+            else {
+                skipped.push(file);
+            }
+        }
+        const result = {
+            from,
+            to,
+            configsCopied: copied,
+            skipped,
+            timestamp: new Date().toISOString(),
+        };
+        if (options.approvedBy)
+            result.approvedBy = options.approvedBy;
+        if (options.confirmedBy)
+            result.confirmedBy = options.confirmedBy;
+        return result;
+    }
+    // --------------------------------------------------------------------------
+    // Diff
+    // --------------------------------------------------------------------------
+    /**
+     * Compares configuration artefacts between two environments.
+     * Only compares promotion-safe files.
+     */
+    diff(env1, env2) {
+        const dir1 = this.getDataDir(env1);
+        const dir2 = this.getDataDir(env2);
+        const differences = [];
+        const files1 = this._listConfigFiles(dir1);
+        const files2 = this._listConfigFiles(dir2);
+        const allFiles = new Set([...files1, ...files2]);
+        for (const file of allFiles) {
+            const p1 = (0, path_1.join)(dir1, file);
+            const p2 = (0, path_1.join)(dir2, file);
+            const has1 = (0, fs_1.existsSync)(p1);
+            const has2 = (0, fs_1.existsSync)(p2);
+            if (has1 && !has2) {
+                differences.push({ file, status: 'removed' });
+            }
+            else if (!has1 && has2) {
+                differences.push({ file, status: 'added' });
+            }
+            else if (has1 && has2) {
+                const c1 = (0, fs_1.readFileSync)(p1, 'utf-8');
+                const c2 = (0, fs_1.readFileSync)(p2, 'utf-8');
+                if (c1 !== c2) {
+                    differences.push({ file, status: 'changed' });
+                }
+            }
+        }
+        return { env1, env2, differences };
+    }
+    // --------------------------------------------------------------------------
+    // Listing
+    // --------------------------------------------------------------------------
+    /** List all environments, whether they exist, and how many blackboard keys each has. */
+    list() {
+        const envs = new Set([...this.config.chain, 'sandbox']);
+        return Array.from(envs).map(name => {
+            const dir = (0, path_1.join)(this.baseDir, name);
+            const exists = (0, fs_1.existsSync)(dir);
+            let keyCount = 0;
+            if (exists) {
+                const bbDir = (0, path_1.join)(dir, 'blackboard');
+                if ((0, fs_1.existsSync)(bbDir)) {
+                    try {
+                        keyCount = (0, fs_1.readdirSync)(bbDir).filter(f => f.endsWith('.json')).length;
+                    }
+                    catch { /* ignore */ }
+                }
+            }
+            return { name, exists, keyCount };
+        });
+    }
+    /** Returns the configured promotion chain. */
+    getChain() {
+        return [...this.config.chain];
+    }
+    /**
+     * Returns true if the environment can be used as a promotion source.
+     * 'sandbox' is always false.
+     */
+    isPromotable(env) {
+        if (env === 'sandbox')
+            return false;
+        return this.config.chain.includes(env);
+    }
+    /**
+     * Returns the next environment in the chain after `env`, or null if `env`
+     * is the last in the chain or not in the chain.
+     */
+    getNextEnv(env) {
+        const idx = this.config.chain.indexOf(env);
+        if (idx === -1 || idx === this.config.chain.length - 1)
+            return null;
+        return this.config.chain[idx + 1];
+    }
+    /** Returns the gate type controlling promotion INTO the given environment. */
+    getGateType(env) {
+        return this.config.gates[env] ?? 'auto';
+    }
+    // --------------------------------------------------------------------------
+    // Backup / Restore
+    // --------------------------------------------------------------------------
+    /**
+     * Creates a timestamped backup of an environment's data directory.
+     * Stored at `data/<env>/.backups/<backupId>/`.
+     * Automatically prunes old backups to retain at most `backupRetain` copies.
+     */
+    backup(env) {
+        const envDir = this.getDataDir(env);
+        const backupsDir = (0, path_1.join)(envDir, '.backups');
+        (0, fs_1.mkdirSync)(backupsDir, { recursive: true, mode: 0o700 });
+        const backupId = new Date().toISOString().replace(/[:.]/g, '-') + '_' + (0, crypto_1.randomUUID)().slice(0, 8);
+        const backupPath = (0, path_1.join)(backupsDir, backupId);
+        (0, fs_1.mkdirSync)(backupPath, { recursive: true, mode: 0o700 });
+        const files = this._collectBackupFiles(envDir);
+        for (const rel of files) {
+            const src = (0, path_1.join)(envDir, rel);
+            const dst = (0, path_1.join)(backupPath, rel);
+            (0, fs_1.mkdirSync)((0, path_1.join)(backupPath, rel.includes('/') ? rel.substring(0, rel.lastIndexOf('/')) : '.'), { recursive: true });
+            try {
+                (0, fs_1.copyFileSync)(src, dst);
+            }
+            catch { /* skip unreadable */ }
+        }
+        // Write manifest
+        const manifest = {
+            backupId,
+            env,
+            timestamp: new Date().toISOString(),
+            sizeBytes: this._dirSize(backupPath),
+            path: backupPath,
+        };
+        (0, fs_1.writeFileSync)((0, path_1.join)(backupPath, '_manifest.json'), JSON.stringify(manifest, null, 2), 'utf-8');
+        // Prune old backups
+        this.pruneBackups(env, this.config.backupRetain);
+        return { backupId, env, path: backupPath, filesCount: files.length };
+    }
+    /**
+     * Restores an environment from a previously created backup.
+     *
+     * @param env - The environment to restore into.
+     * @param backupId - The backup ID (from `listBackups()`).
+     */
+    restore(env, backupId) {
+        const envDir = this.getDataDir(env);
+        const backupsDir = (0, path_1.join)(envDir, '.backups');
+        const backupPath = (0, path_1.join)(backupsDir, backupId);
+        if (!(0, fs_1.existsSync)(backupPath)) {
+            throw new Error(`Backup '${backupId}' not found for environment '${env}'`);
+        }
+        // Create a safety backup of the current state before restoring
+        this.backup(env);
+        const files = this._collectBackupFiles(backupPath);
+        let restored = 0;
+        for (const rel of files) {
+            if (rel === '_manifest.json')
+                continue;
+            const src = (0, path_1.join)(backupPath, rel);
+            const dst = (0, path_1.join)(envDir, rel);
+            try {
+                (0, fs_1.mkdirSync)((0, path_1.join)(envDir, rel.includes('/') ? rel.substring(0, rel.lastIndexOf('/')) : '.'), { recursive: true });
+                (0, fs_1.copyFileSync)(src, dst);
+                restored++;
+            }
+            catch { /* skip */ }
+        }
+        return { backupId, env, filesRestored: restored };
+    }
+    /**
+     * Lists all backups for an environment, newest first.
+     */
+    listBackups(env) {
+        const envDir = this.getDataDir(env);
+        const backupsDir = (0, path_1.join)(envDir, '.backups');
+        if (!(0, fs_1.existsSync)(backupsDir))
+            return [];
+        const entries = [];
+        for (const name of (0, fs_1.readdirSync)(backupsDir)) {
+            const manifest = (0, path_1.join)(backupsDir, name, '_manifest.json');
+            if ((0, fs_1.existsSync)(manifest)) {
+                try {
+                    const entry = JSON.parse((0, fs_1.readFileSync)(manifest, 'utf-8'));
+                    entries.push(entry);
+                }
+                catch { /* corrupt manifest, skip */ }
+            }
+        }
+        // Sort newest first
+        return entries.sort((a, b) => new Date(b.timestamp).getTime() - new Date(a.timestamp).getTime());
+    }
+    /**
+     * Removes old backups for an environment, keeping only the `keep` most recent.
+     * @returns Number of backups deleted.
+     */
+    pruneBackups(env, keep) {
+        const all = this.listBackups(env);
+        if (all.length <= keep)
+            return 0;
+        const toDelete = all.slice(keep);
+        let deleted = 0;
+        for (const entry of toDelete) {
+            try {
+                (0, fs_1.rmSync)(entry.path, { recursive: true, force: true });
+                deleted++;
+            }
+            catch { /* ignore */ }
+        }
+        return deleted;
+    }
+    // --------------------------------------------------------------------------
+    // Private helpers
+    // --------------------------------------------------------------------------
+    _loadEnvConfig() {
+        const configPath = (0, path_1.join)(this.baseDir, 'env-config.json');
+        if (!(0, fs_1.existsSync)(configPath))
+            return;
+        try {
+            const raw = JSON.parse((0, fs_1.readFileSync)(configPath, 'utf-8'));
+            if (Array.isArray(raw.chain))
+                this.config.chain = raw.chain;
+            if (raw.gates && typeof raw.gates === 'object') {
+                Object.assign(this.config.gates, raw.gates);
+            }
+            if (typeof raw.backupRetain === 'number')
+                this.config.backupRetain = raw.backupRetain;
+        }
+        catch { /* malformed config — silently ignore */ }
+    }
+    _touchJson(filePath, defaultValue) {
+        try {
+            const fd = (0, fs_1.openSync)(filePath, (fs_1.constants.O_CREAT | fs_1.constants.O_EXCL | fs_1.constants.O_WRONLY), 0o600);
+            try {
+                (0, fs_1.writeFileSync)(fd, JSON.stringify(defaultValue, null, 2));
+            }
+            finally {
+                (0, fs_1.closeSync)(fd);
+            }
+        }
+        catch { /* file already exists — that's fine */ }
+    }
+    _touchFile(filePath) {
+        try {
+            const fd = (0, fs_1.openSync)(filePath, (fs_1.constants.O_CREAT | fs_1.constants.O_EXCL | fs_1.constants.O_WRONLY), 0o600);
+            (0, fs_1.closeSync)(fd);
+        }
+        catch { /* file already exists — that's fine */ }
+    }
+    _listConfigFiles(dir) {
+        if (!(0, fs_1.existsSync)(dir))
+            return [];
+        try {
+            return (0, fs_1.readdirSync)(dir).filter(f => {
+                if (PROMOTE_EXCLUDE.some(ex => f === ex || f.startsWith(ex)))
+                    return false;
+                // Only include regular files, not directories
+                try {
+                    return (0, fs_1.statSync)((0, path_1.join)(dir, f)).isFile();
+                }
+                catch {
+                    return false;
+                }
+            });
+        }
+        catch {
+            return [];
+        }
+    }
+    _collectBackupFiles(dir) {
+        const results = [];
+        const walk = (current, prefix) => {
+            let entries;
+            try {
+                entries = (0, fs_1.readdirSync)(current);
+            }
+            catch {
+                return;
+            }
+            for (const entry of entries) {
+                if (entry === '.backups')
+                    continue; // don't back up backups
+                const full = (0, path_1.join)(current, entry);
+                const rel = prefix ? `${prefix}/${entry}` : entry;
+                try {
+                    const info = (0, fs_1.statSync)(full);
+                    if (info.isDirectory()) {
+                        walk(full, rel);
+                    }
+                    else {
+                        results.push(rel);
+                    }
+                }
+                catch { /* skip */ }
+            }
+        };
+        walk(dir, '');
+        return results;
+    }
+    _dirSize(dir) {
+        let size = 0;
+        const files = this._collectBackupFiles(dir);
+        for (const rel of files) {
+            try {
+                size += (0, fs_1.statSync)((0, path_1.join)(dir, rel)).size;
+            }
+            catch { /* skip */ }
+        }
+        return size;
+    }
+}
+exports.EnvironmentManager = EnvironmentManager;
+//# sourceMappingURL=env-manager.js.map

package/dist/lib/env-manager.js.map

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

package/dist/lib/locked-blackboard.d.ts

@@ -29,6 +29,12 @@ export interface LockedBlackboardOptions {
     conflictResolution?: ConflictResolutionStrategy;
     /** Minimum milliseconds between consecutive write/commit operations (0 = no throttle) */
     throttleMs?: number;
+    /**
+     * Environment name (e.g. `'dev'`, `'prod'`).  When set, all data is scoped
+     * to `<basePath>/<env>/` keeping environments completely isolated.
+     * Falls back to the `NETWORK_AI_ENV` environment variable when not provided.
+     */
+    env?: string;
 }
 export interface BlackboardEntry {
     key: string;

package/dist/lib/locked-blackboard.d.ts.map

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

package/dist/lib/locked-blackboard.js

@@ -227,23 +227,42 @@ class LockedBlackboard {
         // Resolve to an absolute path to prevent insecure relative/temp-dir path propagation
         const resolvedBase = (0, path_1.resolve)(basePath);
         this.basePath = resolvedBase;
-        this.blackboardPath = (0, path_1.join)(resolvedBase, 'swarm-blackboard.md');
-        this.lockPath = (0, path_1.join)(resolvedBase, 'data', '.blackboard.lock');
-        this.pendingDir = (0, path_1.join)(resolvedBase, 'data', 'pending_changes');
-        this.lock = new FileLock(this.lockPath);
         // Support both signatures:
         //   new LockedBlackboard(path, auditLogger, options)
         //   new LockedBlackboard(path, options)
-        if (auditLoggerOrOptions && typeof auditLoggerOrOptions === 'object' && ('conflictResolution' in auditLoggerOrOptions || 'throttleMs' in auditLoggerOrOptions)) {
+        let env;
+        if (auditLoggerOrOptions && typeof auditLoggerOrOptions === 'object' && ('conflictResolution' in auditLoggerOrOptions || 'throttleMs' in auditLoggerOrOptions || 'env' in auditLoggerOrOptions)) {
             const opts = auditLoggerOrOptions;
             this.conflictResolution = opts.conflictResolution ?? 'first-commit-wins';
             this.throttleMs = opts.throttleMs ?? 0;
+            env = opts.env;
         }
         else {
             this.auditLogger = auditLoggerOrOptions;
             this.conflictResolution = options?.conflictResolution ?? 'first-commit-wins';
             this.throttleMs = options?.throttleMs ?? 0;
+            env = options?.env;
+        }
+        // Fall back to NETWORK_AI_ENV environment variable when env not supplied
+        const activeEnv = env ?? process.env['NETWORK_AI_ENV'] ?? '';
+        // Validate env name to prevent path traversal (CWE-22)
+        if (activeEnv && !/^[a-zA-Z0-9_-]+$/.test(activeEnv)) {
+            throw new Error(`Invalid environment name '${activeEnv}': only alphanumeric, dash, and underscore are allowed`);
+        }
+        if (activeEnv) {
+            // Scope all data to <basePath>/<env>/ for full environment isolation
+            const envBase = (0, path_1.join)(resolvedBase, activeEnv);
+            this.blackboardPath = (0, path_1.join)(envBase, 'swarm-blackboard.md');
+            this.lockPath = (0, path_1.join)(envBase, '.blackboard.lock');
+            this.pendingDir = (0, path_1.join)(envBase, 'pending_changes');
         }
+        else {
+            // Legacy paths — backward compatible with existing deployments
+            this.blackboardPath = (0, path_1.join)(resolvedBase, 'swarm-blackboard.md');
+            this.lockPath = (0, path_1.join)(resolvedBase, 'data', '.blackboard.lock');
+            this.pendingDir = (0, path_1.join)(resolvedBase, 'data', 'pending_changes');
+        }
+        this.lock = new FileLock(this.lockPath);
         this.initialize();
     }
     initialize() {