ruvnet/ruflo · error · Error

Unknown permissions preset: ${name}. Valid presets: ${valid}

Error message

Unknown permissions preset: ${name}. Valid presets: ${valid}

What it means

Error "Unknown permissions preset: ${name}. Valid presets: ${valid}" thrown in ruvnet/ruflo.

Source

Thrown at v3/@claude-flow/cli/src/permission/permission-set.ts:138

      deniedTools: [],
      allowedPaths: ['**/*'],
      deniedPaths: [],
      allowedNetworkHosts: ['*'],
      notes: 'No restriction. Kept for opt-in compatibility; see #2768 for why this is not the default.',
    },
  ],
};

export type PresetName = keyof typeof PRESETS;

/**
 * Resolve a preset name to its per-role sets. Throws on unknown preset —
 * fail loud so a typo doesn't silently degrade to permissive.
 */
export function resolvePreset(name: string): PermissionSet[] {
  if (!(name in PRESETS)) {
    const valid = Object.keys(PRESETS).join(', ');
    throw new Error(`Unknown permissions preset: ${name}. Valid presets: ${valid}`);
  }
  return PRESETS[name as PresetName];
}

/**
 * Sanity-check a permission set: role name shape, no null entries.
 * Path validation is deferred to the enforcement side (PathValidator)
 * so this module has no @claude-flow/security runtime dep beyond a
 * type-only import.
 */
export function validatePermissionSet(set: PermissionSet, _validator?: PathValidator): string[] {
  const errors: string[] = [];
  if (!set.role || typeof set.role !== 'string') errors.push('role must be a non-empty string');
  const arrays: [keyof PermissionSet, unknown][] = [
    ['allowedTools', set.allowedTools],
    ['deniedTools', set.deniedTools],
    ['allowedPaths', set.allowedPaths],
    ['deniedPaths', set.deniedPaths],

View on GitHub (pinned to 6b01dc5a68)

When it happens

Trigger: Thrown at v3/@claude-flow/cli/src/permission/permission-set.ts:138 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of ruvnet/ruflo@6b01dc5a68 (2026-08-12). Data as JSON: /api/errors/26e0e442215da821. Report an issue: GitHub.