JuliusBrussee/caveman · error · Error

unknown import option ${flag}

Error message

unknown import option ${flag}

What it means

Error "unknown import option ${flag}" thrown in JuliusBrussee/caveman.

Source

Thrown at packages/cli/src/index.ts:1436

		entry_condition: entry ? { status: "inferred_needs_review", value: entry.slice(0, 240) } : { status: "missing" },
		stop_condition: stop ? { status: "inferred_needs_review", value: stop.slice(0, 240) } : { status: "missing" },
		prompt: { bytes, byte_budget: byteBudget, status: bytes <= 8192 ? "bounded_draft" : "needs_deferred_split" },
		resources,
		transformations: { exact_duplicate_blocks_removed: transformations.removedDuplicates, decorative_separators_removed: transformations.removedSeparators },
		conflicts: { status: "needs_review", declared: [] },
		benchmarks: { status: "required", fixtures: [] },
		evidence_status: "unevaluated",
		publication: { status: "blocked", blockers },
	};
}

function importSkill(rest: string[]) {
	const allowed = new Set(["--out", "--dry-run", "--json"]);
	for (let index = 1; index < rest.length; index++) {
		const value = rest[index]!;
		if (!value.startsWith("--")) continue;
		const flag = value.split("=", 1)[0]!;
		if (!allowed.has(flag)) throw new Error(`unknown import option ${flag}`);
		if (flag === "--out" && !value.includes("=")) index++;
	}
	const input = positionalAfterOptions(rest.slice(1), new Set(["--out"]));
	if (!input) return skillsUsage();
	let source: { root: string; file: string };
	try { source = importedSkillSource(input); } catch (error) {
		console.error(`caveman skills import: ${(error as Error).message}`);
		process.exit(2);
	}
	const sourceBytes = readFileSync(source.file);
	let transformed: ReturnType<typeof cavemannifyImportedSkill>;
	try { transformed = cavemannifyImportedSkill(sourceBytes); } catch (error) {
		console.error(`caveman skills import: ${(error as Error).message}`);
		process.exit(2);
	}
	const name = transformed.body.match(/^name:\s*["']?([a-z0-9-]+)["']?\s*$/m)?.[1];
	if (!name || name.length > 63) {
		console.error("caveman skills import: frontmatter name must be lowercase hyphen-case under 64 characters");

View on GitHub (pinned to 27d5a3981a)

Solutions

1. Remove the unknown import option; check the import command usage.

When it happens

Trigger: Thrown at packages/cli/src/index.ts:1436 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of JuliusBrussee/caveman@27d5a3981a (2026-08-15). Data as JSON: /api/errors/27d093678d655287. Report an issue: GitHub.