oh-my-opencode 5.0.0-beta.5 → 5.0.0-beta.51

package/packages/omo-codex/plugin/test/migrate-omo-sot.test.mjs

@@ -1,179 +0,0 @@
-import assert from "node:assert/strict";
-import { mkdir, mkdtemp, readFile, writeFile } from "node:fs/promises";
-import { tmpdir } from "node:os";
-import { join } from "node:path";
-import test from "node:test";
-
-import { migrateOmoSotConfig } from "../scripts/migrate-omo-sot.mjs";
-
-test("#given no OMO SOT #when seeding #then creates a parseable scaffold once", async () => {
-	const home = await mkdtemp(join(tmpdir(), "omo-sot-seed-"));
-
-	const first = await migrateOmoSotConfig({ env: { HOME: home }, seed: true });
-	const before = await readFile(join(home, ".omo", "config.jsonc"), "utf8");
-	const second = await migrateOmoSotConfig({ env: { HOME: home }, seed: true });
-	const after = await readFile(join(home, ".omo", "config.jsonc"), "utf8");
-
-	assert.equal(first.seeded, true);
-	assert.equal(second.seeded, false);
-	assert.equal(after, before);
-	assert.equal(parseJsonc(after)["[codex]"].codegraph.enabled, undefined);
-	assert.equal(parseJsonc(after).codegraph.enabled, undefined);
-	assert.match(after, /"enabled"/);
-	assert.match(after, /"\[opencode\]"/);
-});
-
-test("#given no OMO SOT and legacy CodeGraph env #when seeding #then creates scaffold with Codex scoped migration", async () => {
-	const home = await mkdtemp(join(tmpdir(), "omo-sot-seed-env-"));
-
-	await migrateOmoSotConfig({
-		env: {
-			HOME: home,
-			CODEX_CODEGRAPH_AUTO_PROVISION: "yes",
-			CODEX_CODEGRAPH_ENABLED: "1",
-			OMO_CODEGRAPH_INSTALL_DIR: "/tmp/codegraph",
-			OMO_CODEGRAPH_TELEMETRY: "false",
-		},
-		seed: true,
-	});
-
-	const content = await readFile(join(home, ".omo", "config.jsonc"), "utf8");
-	const parsed = parseJsonc(content);
-	assert.equal(parsed.codegraph.enabled, undefined);
-	assert.deepEqual(parsed["[codex]"].codegraph, {
-		auto_provision: true,
-		enabled: true,
-		install_dir: "/tmp/codegraph",
-		telemetry: false,
-	});
-	assert.match(content, /Shared OMO settings/);
-	assert.match(content, /"\[opencode\]"/);
-});
-
-test("#given legacy CodeGraph env #when migrating #then adds Codex scoped codegraph values", async () => {
-	const home = await mkdtemp(join(tmpdir(), "omo-sot-env-"));
-	await mkdir(join(home, ".omo"), { recursive: true });
-	await writeFile(join(home, ".omo", "config.jsonc"), "{\n}\n");
-
-	const result = await migrateOmoSotConfig({
-		env: {
-			HOME: home,
-			CODEX_CODEGRAPH_AUTO_PROVISION: "0",
-			CODEX_CODEGRAPH_ENABLED: "false",
-			OMO_CODEGRAPH_INSTALL_DIR: "/tmp/codegraph",
-			OMO_CODEGRAPH_TELEMETRY: "1",
-		},
-		seed: true,
-	});
-
-	const parsed = parseJsonc(await readFile(join(home, ".omo", "config.jsonc"), "utf8"));
-	assert.equal(result.changed, true);
-	assert.deepEqual(parsed["[codex]"].codegraph, {
-		auto_provision: false,
-		enabled: false,
-		install_dir: "/tmp/codegraph",
-		telemetry: true,
-	});
-});
-
-test("#given existing user SOT #when migrating env #then preserves user values and comments", async () => {
-	const home = await mkdtemp(join(tmpdir(), "omo-sot-preserve-"));
-	const configPath = join(home, ".omo", "config.jsonc");
-	await mkdir(join(home, ".omo"), { recursive: true });
-	await writeFile(
-		configPath,
-		[
-			"{",
-			"  // keep my debounce",
-			'  "codegraph": {',
-			"    \"watch_debounce_ms\": 4242",
-			"  }",
-			"}",
-			"",
-		].join("\n"),
-	);
-
-	await migrateOmoSotConfig({ env: { HOME: home, CODEX_CODEGRAPH_ENABLED: "0" }, seed: true });
-
-	const content = await readFile(configPath, "utf8");
-	const parsed = parseJsonc(content);
-	assert.match(content, /keep my debounce/);
-	assert.equal(parsed.codegraph.watch_debounce_ms, 4242);
-	assert.equal(parsed["[codex]"].codegraph.enabled, false);
-});
-
-test("#given existing Codex scoped SOT #when migrating env #then user value wins", async () => {
-	const home = await mkdtemp(join(tmpdir(), "omo-sot-user-wins-"));
-	const configPath = join(home, ".omo", "config.jsonc");
-	await mkdir(join(home, ".omo"), { recursive: true });
-	await writeFile(configPath, '{\n  "[codex]": { "codegraph": { "enabled": true } }\n}\n');
-
-	await migrateOmoSotConfig({ env: { HOME: home, CODEX_CODEGRAPH_ENABLED: "0" }, seed: true });
-
-	const parsed = parseJsonc(await readFile(configPath, "utf8"));
-	assert.equal(parsed["[codex]"].codegraph.enabled, true);
-});
-
-test("#given opencode scoped SOT #when migrating env #then opencode block is not changed", async () => {
-	const home = await mkdtemp(join(tmpdir(), "omo-sot-opencode-"));
-	const configPath = join(home, ".omo", "config.jsonc");
-	await mkdir(join(home, ".omo"), { recursive: true });
-	await writeFile(configPath, '{\n  "[opencode]": { "codegraph": { "enabled": true } }\n}\n');
-
-	await migrateOmoSotConfig({ env: { HOME: home, CODEX_CODEGRAPH_ENABLED: "0" }, seed: true });
-
-	const parsed = parseJsonc(await readFile(configPath, "utf8"));
-	assert.equal(parsed["[opencode]"].codegraph.enabled, true);
-	assert.equal(parsed["[codex]"].codegraph.enabled, false);
-});
-
-test("#given malformed existing SOT #when migrating #then leaves it untouched and warns", async () => {
-	const home = await mkdtemp(join(tmpdir(), "omo-sot-malformed-"));
-	const configPath = join(home, ".omo", "config.jsonc");
-	await mkdir(join(home, ".omo"), { recursive: true });
-	await writeFile(configPath, '{ "codegraph":');
-
-	const result = await migrateOmoSotConfig({ env: { HOME: home, CODEX_CODEGRAPH_ENABLED: "0" }, seed: true });
-
-	assert.equal(await readFile(configPath, "utf8"), '{ "codegraph":');
-	assert.equal(result.changed, false);
-	assert.equal(result.seeded, false);
-	assert.match(result.warnings.join("\n"), /Could not parse/);
-});
-
-function parseJsonc(content) {
-	return JSON.parse(stripTrailingCommas(stripJsonComments(content)));
-}
-
-function stripJsonComments(content) {
-	let result = "";
-	let inString = false;
-	let escape = false;
-	for (let index = 0; index < content.length; index += 1) {
-		const char = content[index];
-		const next = content[index + 1];
-		if (inString) {
-			result += char;
-			if (escape) escape = false;
-			else if (char === "\\") escape = true;
-			else if (char === "\"") inString = false;
-			continue;
-		}
-		if (char === "\"") {
-			inString = true;
-			result += char;
-			continue;
-		}
-		if (char === "/" && next === "/") {
-			while (index < content.length && content[index] !== "\n") index += 1;
-			result += "\n";
-			continue;
-		}
-		result += char;
-	}
-	return result;
-}
-
-function stripTrailingCommas(content) {
-	return content.replace(/,\s*([}\]])/g, "$1");
-}

package/packages/omo-codex/plugin/test/sync-skills-orchestration.test.mjs

@@ -1,314 +0,0 @@
-import assert from "node:assert/strict";
-import { readdir, readFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import test from "node:test";
-import { fileURLToPath } from "node:url";
-import { codexHarnessToolCompatibility, insertCodexCompatibilityGuidance } from "../scripts/sync-skills.mjs";
-
-const root = dirname(dirname(fileURLToPath(import.meta.url)));
-
-async function listSkillNames() {
-	const skillsRoot = join(root, "skills");
-	const entries = await readdir(skillsRoot, { withFileTypes: true });
-	return entries
-		.filter((entry) => entry.isDirectory())
-		.map((entry) => entry.name)
-		.sort();
-}
-
-async function readSkill(skillName) {
-	return readFile(join(root, "skills", skillName, "SKILL.md"), "utf8");
-}
-
-async function readSharedSkill(skillName) {
-	return readFile(join(root, "../../shared-skills/skills", skillName, "SKILL.md"), "utf8");
-}
-
-function patternFromParts(parts, flags) {
-	return new RegExp(parts.join(""), flags);
-}
-
-const multiAgentV2RoleGuidance =
-	"If instead a flat `spawn_agent` with a required `task_name` exists (`multi_agent_v2`), rewrite every `multi_agent_v1.*` example:";
-const loadSkillsGuidance =
-	"When translating `load_skills=[...]`, include the requested skill names in the spawned agent's `message`.";
-
-test("#given synced aggregate Codex skills #when they contain OpenCode orchestration examples #then Codex tool compatibility guidance is injected", async () => {
-	// given
-	const opencodeOnlyToolPattern = /\b(?:call_omo_agent|background_output|team_[a-z_]+|task)\s*\(/;
-
-	// when / then
-	for (const skillName of await listSkillNames()) {
-		const content = await readSkill(skillName);
-		if (!opencodeOnlyToolPattern.test(content)) continue;
-
-		const compatibilityMatches = content.match(/## Codex Harness Tool Compatibility/g) ?? [];
-		const compatibilityIndex = content.indexOf("## Codex Harness Tool Compatibility");
-		assert.notEqual(compatibilityIndex, -1, `${skillName} is missing Codex compatibility guidance`);
-		assert.equal(compatibilityMatches.length, 1, `${skillName} must not duplicate Codex compatibility guidance`);
-		assert.ok(
-			compatibilityIndex < content.search(opencodeOnlyToolPattern),
-			`${skillName} must explain Codex tool translation before OpenCode-only examples`,
-		);
-		assert.ok(content.includes(multiAgentV2RoleGuidance), `${skillName} missing multi_agent_v2 role guidance`);
-		assert.ok(content.includes(loadSkillsGuidance), `${skillName} missing load_skills guidance`);
-	}
-});
-
-test("#given late variant Codex compatibility guidance #when adapting a skill #then it is moved without duplication", () => {
-	// given
-	const content = `---
-name: example
----
-
-# Example Skill
-
-call_omo_agent(subagent_type="explore", prompt="inspect")
-
-## Codex Harness Tool Compatibility
-
-Older variant guidance.
-
-When translating \`load_skills=[...]\`, name the skills inside the spawned agent's \`message\`. If a code block below conflicts with this section, this section wins.
-
----
-
-## Next Section
-
-task(category="quick", prompt="verify")
-`;
-
-	// when
-	const adapted = insertCodexCompatibilityGuidance(content);
-
-	// then
-	const compatibilityIndex = adapted.indexOf("## Codex Harness Tool Compatibility");
-	const firstToolIndex = adapted.search(/\b(?:call_omo_agent|task)\s*\(/);
-	assert.notEqual(compatibilityIndex, -1);
-	assert.ok(compatibilityIndex < firstToolIndex);
-	assert.equal(adapted.match(/## Codex Harness Tool Compatibility/g)?.length, 1);
-	assert.doesNotMatch(adapted, /Older variant guidance/);
-	assert.doesNotMatch(adapted, /name the skills inside the spawned agent's `message`/);
-	assert.match(adapted, /\n---\n\n## Next Section/);
-});
-
-test("#given early custom Codex compatibility guidance #when adapting a skill #then it is preserved exactly", () => {
-	// given
-	const content = `---
-name: example
----
-
-## Codex Harness Tool Compatibility
-
-Custom guidance for this skill, including \`dispatchInternalPrompt(...)\`.
-
-# Example Skill
-
-call_omo_agent(subagent_type="explore", prompt="inspect")
-`;
-
-	// when
-	const adapted = insertCodexCompatibilityGuidance(content);
-
-	// then
-	assert.equal(adapted, content);
-});
-
-test("#given early generated stale Codex compatibility guidance #when adapting a skill #then it is replaced", () => {
-	// given
-	const content = `---
-name: example
----
-
-## Codex Harness Tool Compatibility
-
-This skill may include examples copied from the OpenCode harness. In Codex, do not call OpenCode-only tools such as \`call_omo_agent(...)\`, \`task(...)\`, \`background_output(...)\`, or \`team_*(...)\` literally. Translate those examples to Codex native tools:
-
-| OpenCode example | Codex tool to use |
-| --- | --- |
-| \`call_omo_agent(subagent_type="explore", ...)\` | \`spawn_agent({"task_name":"...","message":"TASK: act as an explorer. ..."})\` |
-| \`background_output(task_id="...")\` | \`wait_agent(...)\` for mailbox signals |
-
-Obsolete generated compatibility prose.
-
-More obsolete generated compatibility prose.
-
-When translating \`load_skills=[...]\`, include the requested skill names in the spawned agent's \`message\`. If a code block below conflicts with this section, this section wins.
-
-# Example Skill
-
-call_omo_agent(subagent_type="explore", prompt="inspect")
-`;
-
-	// when
-	const adapted = insertCodexCompatibilityGuidance(content);
-
-	// then
-	assert.match(adapted, /multi_agent_v1\.spawn_agent/);
-	assert.match(adapted, /fork_context":false/);
-	assert.match(adapted, /"agent_type":"explorer"/);
-	assert.match(adapted, /multi_agent_v1\.wait_agent/);
-	assert.match(adapted, /"task_name":"<lowercase_digits_underscores>"/);
-	assert.match(adapted, /fork_turns/);
-	assert.doesNotMatch(adapted, /\| `spawn_agent\({"task_name"/);
-	assert.doesNotMatch(adapted, /Obsolete generated compatibility prose/);
-});
-
-test("#given generated Codex compatibility guidance #when adapting a skill #then multi-agent role and load_skills guidance are both present", () => {
-	// given
-	const content = `---
-name: example
----
-
-# Example Skill
-
-task(subagent_type="oracle", load_skills=["debugging"], prompt="verify")
-`;
-
-	// when
-	const adapted = insertCodexCompatibilityGuidance(content);
-
-	// then
-	assert.ok(adapted.includes(multiAgentV2RoleGuidance));
-	assert.ok(adapted.includes(loadSkillsGuidance));
-});
-
-test("#given generated guidance before a template export #when adapting a skill #then the export wrapper is preserved", () => {
-	// given
-	const content = `---
-name: refactor
----
-
-## Codex Harness Tool Compatibility
-
-Older variant guidance.
-
-When translating \`load_skills=[...]\`, name the skills inside the spawned agent's \`message\`. If a code block below conflicts with this section, this section wins.
-
-export const REFACTOR_TEMPLATE = \`# Refactor
-
-call_omo_agent(subagent_type="explore", prompt="inspect")
-\`
-`;
-
-	// when
-	const adapted = insertCodexCompatibilityGuidance(content);
-
-	// then
-	assert.match(adapted, /export const REFACTOR_TEMPLATE = `# Refactor/);
-	assert.match(adapted, /multi_agent_v1\.spawn_agent/);
-	assert.doesNotMatch(adapted, /Older variant guidance/);
-});
-
-test("#given synced aggregate Codex skills #when they describe background orchestration #then liveness is framed as progress rather than timeout failure", async () => {
-	// given
-	const orchestrationPattern = /\b(?:run_in_background|background_output|wait_agent)\b/;
-	const requiredPatterns = [
-		["working progress message", /WORKING:/],
-		["blocked progress message", /BLOCKED:/],
-		["mailbox timeout framing", /timeout only means no new mailbox update arrived/],
-		// Skills route by session tool surface: the namespaced V1 tool or the flat V2 tool both count.
-		["wait-agent tool ref", /multi_agent_v1\.wait_agent|`wait_agent`/],
-		["explicit fallback conditions", /Fallback only when|Mark a file for retry only when/],
-	];
-	const bannedPatterns = [
-		["timeout as failure", patternFromParts(["fails or ", "times out"], "i")],
-		["failed or timed out", patternFromParts(["failed or ", "timed out"], "i")],
-		["two waits heuristic", patternFromParts(["After two ", "waits"])],
-		["unresponsive timeout framing", patternFromParts(["timeout", ".*", "un" + "responsive"], "i")],
-		["old status-tool warning", patternFromParts(["polling or ", "status tool"])],
-		["large status replay wording", patternFromParts(["large agent status", " and latest-message"])],
-		["old wait-agent aphorism", patternFromParts(["wait_agent", ".*", "signal, not ", "proof"], "i")],
-	];
-
-	// when / then
-	for (const skillName of await listSkillNames()) {
-		const content = await readSkill(skillName);
-		if (!orchestrationPattern.test(content)) continue;
-
-		for (const [label, pattern] of requiredPatterns) {
-			assert.match(content, pattern, `${skillName} missing ${label}`);
-		}
-		for (const [label, pattern] of bannedPatterns) {
-			assert.doesNotMatch(content, pattern, `${skillName} still has ${label}`);
-		}
-	}
-});
-
-test("#given packaged start-work and ulw-plan skills #when inspected #then PR delivery options and the handoff explanation ship", async () => {
-	// given
-	const startWork = await readSkill("start-work");
-	const workflow = await readFile(join(root, "skills", "ulw-plan", "references", "full-workflow.md"), "utf8");
-
-	// when / then
-	assert.match(startWork, /--make-pr/);
-	assert.match(startWork, /--ship/);
-	assert.match(startWork, /implies `--make-pr`/i);
-	assert.match(startWork, /IMPLIES worktree mode/i);
-	assert.match(startWork, /Goal and todo discipline/i);
-	assert.match(startWork, /create_goal/);
-	assert.match(startWork, /one todo per column-zero checkbox/i);
-
-	assert.match(workflow, /Handoff explanation/i);
-	assert.match(workflow, /Added beyond the request/i);
-	assert.match(workflow, /\$start-work <plan-name>/);
-	assert.match(workflow, /--make-pr/);
-	assert.match(workflow, /--ship/);
-	assert.match(workflow, /COUNT the rows/i);
-});
-
-test("#given start-work skill #when synced for Codex #then the difficulty-tier delegation guidance survives the overlay", async () => {
-	const content = await readSkill("start-work");
-
-	assert.match(content, /lazycodex-worker-medium/);
-	assert.match(content, /Codex tier mapping for the delegation router/);
-	assert.match(content, /Global Review and Debugging Gate/);
-	assert.match(content, /full commit SHA/);
-	assert.match(content, /re-read the ledger record/);
-	assert.match(content, /exact lane\/SHA pair/);
-	assert.doesNotMatch(content, /works the same on both surfaces/);
-});
-
-test("#given review-work skill #when some lanes do not finish #then aggregate result remains bounded", async () => {
-	const content = await readSkill("review-work");
-
-	assert.match(content, /pending\/PASS\/FAIL\/INCONCLUSIVE/);
-	assert.match(content, /Preserve completed lane results immediately/);
-	assert.match(content, /ALL 5 lanes have a terminal state/);
-	assert.match(content, /REVIEW INCONCLUSIVE - not approved/);
-	assert.match(content, /Overall Verdict: PASSED \/ FAILED \/ INCONCLUSIVE/);
-	assert.match(content, /PASS\/FAIL\/INCONCLUSIVE \| HIGH\/MED\/LOW/);
-	assert.match(content, /Do not spin in repeated/);
-	assert.match(content, /bare REJECT\/FAIL token without findings is not a verdict/);
-	assert.match(content, /cites the violated goal criterion/);
-	assert.match(content, /append a durable task-evidence record/);
-	assert.match(content, /full commit SHA/);
-	assert.match(content, /re-read that record/);
-	assert.match(content, /exact lane\/SHA pair/);
-	assert.match(content, /Do not use `multi_agent_v1\.send_input` as an interrupt/);
-});
-
-test("#given PR and review skills #when synced for Codex #then worktree lifecycle is mandatory", async () => {
-	const startWork = await readSkill("start-work");
-	const reviewWork = await readSkill("review-work");
-	const sharedStartWork = await readSharedSkill("start-work");
-
-	assert.match(startWork, /PR creation, PR handoff, branch handoff, or merge/);
-	assert.match(startWork, /Finish the PR\/branch lifecycle from its task-owned worktree/);
-	assert.match(startWork, /merge by default unless explicitly opted out/);
-	assert.match(startWork, /No PR\/branch implementation or review in the main worktree/);
-
-	assert.match(sharedStartWork, /required for PR\/branch work/);
-	assert.match(sharedStartWork, /No PR\/branch implementation, review, or merge in the main worktree/);
-	assert.doesNotMatch(sharedStartWork, /If worktree mode was used/);
-	assert.doesNotMatch(sharedStartWork, /merge or hand off exactly as requested/);
-
-	assert.match(reviewWork, /dedicated review worktree attached to that branch/);
-	assert.match(reviewWork, /Never\s+checkout, test, or edit the review branch in the main worktree/);
-});
-
-test("#given generated Codex compatibility guidance #when multi-agent lifecycle tools are mentioned #then optional tools are guarded by the active tools list", () => {
-	assert.match(codexHarnessToolCompatibility, /when exposed in the active tools list/, "send_input/close_agent must be marked optional (lazycodex#116)");
-	assert.match(codexHarnessToolCompatibility, /multi_agent_v1\.spawn_agent/);
-	assert.match(codexHarnessToolCompatibility, /multi_agent_v1\.wait_agent/);
-});

package/packages/omo-codex/plugin/test/ulw-plan-scope-contract.test.mjs

@@ -1,24 +0,0 @@
-import assert from "node:assert/strict";
-import { readFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
-import test from "node:test";
-import { fileURLToPath } from "node:url";
-
-const pluginRoot = dirname(dirname(fileURLToPath(import.meta.url)));
-const repositoryRoot = dirname(dirname(dirname(pluginRoot)));
-const componentReference = join(pluginRoot, "components", "ultrawork", "skills", "ulw-plan", "references", "intent-unclear.md");
-const sharedReference = join(repositoryRoot, "packages", "shared-skills", "skills", "ulw-plan", "references", "intent-unclear.md");
-
-test("#given an unclear auth-improvement request #when ulw-plan derives its full-scope components #then it preserves evidenced intent without inventing reduction or MFA expansion", async () => {
-	const [component, shared] = await Promise.all([
-		readFile(componentReference, "utf8"),
-		readFile(sharedReference, "utf8"),
-	]);
-
-	for (const reference of [component, shared]) {
-		assert.match(reference, /components that refine the user's requested or evidence-backed intent/i);
-		assert.match(reference, /neither collapse into an invented reduced subset nor expand into adjacent features/i);
-		assert.match(reference, /MFA is an adjacent capability.*Scope OUT unless the user asks.*evidence establishes/i);
-		assert.doesNotMatch(reference, /MFA - all four planned in full/i);
-	}
-});

package/packages/shared-skills/skills/data-scientist/references/common-scenarios.md

@@ -1,176 +0,0 @@
-# Common Scenarios with Tool Selection
-
-## Scenario 1: Simple Calculation
-
-**Decision: Python (always)**
-
-```python
-uv run --with numpy python -c "
-import numpy as np
-result = np.sum([1, 2, 3, 4, 5])
-print(f'Result: {result}')
-"
-```
-
-## Scenario 2: CSV Quick Analysis
-
-**Decision: DuckDB (direct query, no memory load)**
-
-```python
-uv run --with numpy --with duckdb python -c "
-import duckdb
-result = duckdb.sql('''
-    SELECT * FROM 'data.csv'
-    LIMIT 10
-''').pl()
-print(result)
-"
-```
-
-## Scenario 3: Filter + Sort on Large Dataset
-
-**Decision: Polars (128x faster filtering, 12x faster sorting)**
-
-```python
-uv run --with numpy --with polars python -c "
-import polars as pl
-result = (
-    pl.scan_csv('large.csv')
-    .filter(pl.col('value') > 1000)
-    .sort('value', descending=True)
-    .head(100)
-    .collect()
-)
-print(result)
-"
-```
-
-## Scenario 4: Multi-Table Join + Aggregation
-
-**Decision: DuckDB (best for joins and aggregations)**
-
-```python
-uv run --with numpy --with duckdb python -c "
-import duckdb
-result = duckdb.sql('''
-    SELECT
-        a.category,
-        COUNT(*) as count,
-        SUM(b.amount) as total
-    FROM 'table1.csv' a
-    JOIN 'table2.csv' b ON a.id = b.id
-    GROUP BY a.category
-    ORDER BY total DESC
-''').pl()
-print(result)
-"
-```
-
-## Scenario 5: Data Exploration
-
-**Decision: DuckDB for quick exploration**
-
-```python
-uv run --with numpy --with duckdb python -c "
-import duckdb
-
-# Show first few rows
-print('**Sample Data**')
-print(duckdb.sql('SELECT * FROM \"data.csv\" LIMIT 5').pl())
-
-# Show summary statistics
-print('\\n**Summary Statistics**')
-print(duckdb.sql('DESCRIBE SELECT * FROM \"data.csv\"').pl())
-
-# Show row count
-print('\\n**Row Count**')
-print(duckdb.sql('SELECT COUNT(*) as total_rows FROM \"data.csv\"').pl())
-"
-```
-
-## Scenario 6: Time-Series Analysis
-
-**Decision: DuckDB for aggregation + matplotlib for visualization**
-
-```python
-uv run --with numpy --with duckdb --with pyarrow --with matplotlib python -c "
-import duckdb
-import matplotlib.pyplot as plt
-
-# Aggregate by date
-result = duckdb.sql('''
-    SELECT
-        DATE_TRUNC('day', timestamp) as date,
-        COUNT(*) as count,
-        AVG(value) as avg_value
-    FROM 'timeseries.csv'
-    GROUP BY date
-    ORDER BY date
-''').pl()
-
-# Plot
-plt.figure(figsize=(12, 6))
-plt.subplot(2, 1, 1)
-plt.plot(result['date'], result['count'])
-plt.title('Daily Count')
-
-plt.subplot(2, 1, 2)
-plt.plot(result['date'], result['avg_value'])
-plt.title('Daily Average Value')
-
-plt.tight_layout()
-plt.savefig('timeseries.png')
-print('Saved to timeseries.png')
-"
-```
-
-## Scenario 7: Complex Transformation
-
-**Decision: Polars for efficient transformations**
-
-```python
-uv run --with numpy --with polars python -c "
-import polars as pl
-
-result = (
-    pl.scan_csv('data.csv')
-    .with_columns([
-        # Create new calculated columns
-        (pl.col('price') * pl.col('quantity')).alias('total'),
-        pl.col('date').str.strptime(pl.Date, '%Y-%m-%d').alias('parsed_date'),
-        pl.col('name').str.to_uppercase().alias('upper_name'),
-    ])
-    .filter(pl.col('total') > 100)
-    .select(['parsed_date', 'upper_name', 'total'])
-    .collect()
-)
-
-print(result)
-"
-```
-
-## Scenario 8: Large File Processing
-
-**Decision: Polars streaming mode**
-
-```python
-uv run --with numpy --with polars python -c "
-import polars as pl
-
-# Process file larger than RAM
-result = (
-    pl.scan_csv('huge_file.csv')
-    .filter(pl.col('active') == True)
-    .groupby('category')
-    .agg([
-        pl.count().alias('count'),
-        pl.sum('amount').alias('total'),
-        pl.mean('amount').alias('average'),
-    ])
-    .collect(streaming=True)  # Streaming mode
-)
-
-print(result)
-print(f'\\nProcessed {result[\"count\"].sum():,} rows')
-"
-```