orizu 0.3.5 → 0.3.7

package/dist/index.js

@@ -13,9 +13,12 @@ import { clearServerCredentials, getServerCredentials, saveServerCredentials } f
 import { parseDatasetFile } from './file-parser.js';
 import { streamJsonlRowChunks } from './jsonl-stream.js';
 import { parseDatasetReference } from './dataset-download.js';
+import { extractErrorMessage } from './error-response.js';
 import { parseGlobalFlags } from './global-flags.js';
+import { getCapabilities, renderHelpForArgs, renderRootHelp } from './help.js';
 import { runLocalAppPreview } from './preview-runtime.js';
 import { assertSecureTokenTransport, authedFetch, getBaseUrl, resolveLoginBaseUrl, setGlobalFlags, } from './http.js';
+import { getSkillInstallPath, installSkillTarget, isSkillInstallTarget, SKILL_INSTALL_TARGETS, targetNeedsOverwrite, } from './skill-installer.js';
 import { formatTaskCreateError } from './task-create-error.js';
 const MAX_README_LENGTH = 200_000;
 function getCliVersion() {
@@ -32,16 +35,16 @@ function printVersion() {
     printLine(`orizu ${getCliVersion()}`);
 }
 function printUsage() {
-    printLine(`orizu global options:\n\n  --local                 Use http://localhost:3000\n  --server <url>          Use a specific server origin (for example: https://preview.example.com)\n  --version, -v           Print the orizu CLI version\n\norizu commands:\n\n  orizu login [--no-prompt-if-logged-in]\n  orizu logout\n  orizu whoami\n  orizu env [--project <team/project>] [--project-id <projectId>]\n  orizu log <event_type> --run-id <id> --sequence <n> --payload @event.json\n  orizu teams list\n  orizu teams create [--name <name>]\n  orizu teams members list [--team <teamSlug>]\n  orizu teams members add --email <email> [--team <teamSlug>]\n  orizu teams members remove --email <email> [--team <teamSlug>]\n  orizu teams members role --team <teamSlug> --email <email> --role <admin|member>\n  orizu projects list [--team <teamSlug>]\n  orizu projects create --name <name> [--team <teamSlug>]\n  orizu prompts list --project <team/project>\n  orizu prompts comments <prompt-id-or-name> --project <team/project> [--label <label> | --version <id>] [--json]\n  orizu prompts pull <prompt-id-or-name> --project <team/project> --out <dir> [--label <label> | --version <id>] [--json]\n  orizu prompts push <dir> [--runner-version <id>] [--project <team/project>] [--parent <version-id>] [--json]\n  orizu prompts labels set <prompt-name> <label> --version <version-id> [--project <team/project>] [--json]\n  orizu prompts scorers set-headline <prompt-id> --scorer-version <id> [--dataset-version <id> --split-set <id> --split <name>] [--project <team/project>] [--json]\n  orizu prompts scorers add <prompt-id> --scorer-version <id> [--dataset-version <id> --split-set <id> --split <name>] [--project <team/project>] [--json]\n  orizu scorers list --project <team/project>\n  orizu scorers register --project <team/project> --name <name> --manifest <manifest.json> [--prompt-version <id>] [--runner-version <id>] [--label <label>] [--json]\n  orizu scorers detail <scorer-id-or-name> --project <team/project> [--json]\n  orizu scorers labels set <scorer-name> <label> --version <scorer-version-id> [--project <team/project>] [--json]\n  orizu scorers exec --scorer-version <id> (--subject-version <prompt-version-id> | --optimization-run <id> --candidate <id>) --dataset-version <id> --split-set <id> --split <name> [--subject-results <jsonl>] [--dependency-score-run <alias=id>] [--dependency-results <alias=path>] [--no-submit] [--out <score.json>] [--project <team/project>] [--json]\n  orizu scores submit <results.jsonl|results.json> --scorer-version <id> (--subject-version <prompt-version-id> | --optimization-run <id> --candidate <id>) [--aggregate] [--dataset-version <id> --split-set <id> --split <name>] [--project <team/project>] [--json]\n  orizu judges list --project <team/project>\n  orizu judges pull <judge-id-or-name> --project <team/project> --out <dir> [--label <label> | --version <id>] [--json]\n  orizu judges push <dir> [--runner-version <id>] [--project <team/project>] [--parent <version-id>] [--json]\n  orizu runners push <dir> [--project <team/project>] [--name <name>] [--label <label>] [--json]\n  orizu runners exec (--prompt <prompt-version-id> | --prompt-version <id> --runner-version <id> | --scorer-version <id>) --dataset-version <id> --split-set <id-or-name> --split <name> [--runner-dir <dir>] --out <results.jsonl|results.jsonl.gz>\n  orizu optimizers push <dir> [--project <team/project>] [--name <name>] [--label <label>] [--json]\n  orizu runs submit <results.jsonl|results.jsonl.gz> --prompt-version <id> --runner-version <id> --dataset-version <id> --split-set <id> --split <name> [--project <team/project>]\n  orizu apps list [--project <team/project>]\n  orizu apps create --project <team/project> --name <name> --dataset <datasetId> --file <path> --input-schema <json-path> --output-schema <json-path> [--component <name>]\n  orizu apps update [--app <appId>] [--project <team/project>] --file <path> --input-schema <json-path> --output-schema <json-path> [--component <name>]\n  orizu apps link-dataset --dataset <datasetId> [--app <appId>] [--project <team/project>] [--version <n>]\n  orizu apps detail --app <appId> [--project <team/project>] [--json]\n  orizu apps export [--app <appId>] [--project <team/project>] [--version <n>] [--out <path>]\n  orizu tasks list [--project <team/project>]\n  orizu tasks create --project <team/project> --dataset <datasetId> --app <appId> --title <title> --assignees <userIdOrEmail1,userIdOrEmail2> [--version <n>] [--instructions <text>] [--labels-per-item <n>] [--json]\n  orizu tasks assign --task <taskId> --assignees <userId1,userId2>\n  orizu tasks status --task <taskId> [--json]\n  orizu tasks pause --task <taskId>\n  orizu tasks unpause --task <taskId>\n  orizu datasets upload --file <path> [--project <team/project>] [--name <name>] [--readme-file <README.md> | --readme-text <markdown>]\n  orizu datasets push <path> [--project <team/project>] [--name <name>] [--readme-file <README.md> | --readme-text <markdown>] [--json]\n  orizu datasets readme set <datasetId|dataset-name> [--project <team/project>] (--readme-file <README.md> | --readme-text <markdown>) [--json]\n  orizu datasets versions create <datasetId|dataset-name> [--project <team/project>] [--label <label>] [--readme-file <README.md> | --readme-text <markdown>] [--json]\n  orizu datasets splits create <datasetVersionId> [--from-file <split.json>] [--json]\n  orizu datasets download [--dataset <datasetId|datasetUrl>] [--project <team/project>] [--format <csv|json|jsonl>] [--out <path>]\n  orizu datasets append [--dataset <datasetId|datasetUrl>] [--project <team/project>] --file <path>\n  orizu datasets edit-rows [--dataset <datasetId|datasetUrl>] [--project <team/project>] --file <path>\n  orizu datasets delete-rows [--dataset <datasetId|datasetUrl>] [--project <team/project>] --row-ids <id1,id2>\n  orizu datasets delete [--dataset <datasetId|datasetUrl>] [--project <team/project>]\n  orizu datasets lock [--dataset <datasetId|datasetUrl>] [--project <team/project>] [--reason <text>]\n  orizu datasets clone [--dataset <datasetId|datasetUrl>] [--project <team/project>] [--name <name>]\n  orizu tasks export [--task <taskId>] [--format <csv|json|jsonl>] [--out <path>]`);
-    printPreviewUsage();
+    printLine(renderRootHelp());
 }
 function printPreviewUsage() {
     printLine(`\nLocal app preview:\n\n  orizu apps preview --file <path> --input-schema <json-path> --output-schema <json-path> --sample-row <json-path> [--screenshot <png-path>] [--headed] [--keep-open] [--component <name>]`);
 }
 function printOptimizationUsage() {
-    printLine(`\nOptimization lifecycle commands:\n\n  orizu optimizations start --project <team/project> --optimizer-version <id> --prompt-version <id[,id]> --selection-scorer <id> [--reflection-scorer <id>] [--pareto-scorer <id>] [--best-scorer <id>] --dataset-version <id> --split-set <id> [--train-split <name>] [--validation-split <name>] [--metadata <json|@file>] [--json]\n  orizu optimizations run-gepa --project <team/project> --optimizer-version-id <id> --candidate-version-id <id> --runner-version-id <id> --candidate-runner-dir <dir> --scorer-version-id <id> --scorer-runner-version-id <id> --scorer-runner-dir <dir> --dataset-version-id <id> --split-set-id <id> [--train-split train] [--val-split validation] [--log-dir logs]\n  orizu optimizations export <run-id> [--out <path>] [--json]\n  orizu optimizations pause <run-id> [--reason <text>] [--json]\n  orizu optimizations resume <run-id> [--json]\n  orizu optimizations finish <run-id> [--best-score <n>] [--best-candidate <id>] [--result-prompt-version <id>] [--report <markdown|@file> | --report-file <path>] [--metadata <json|@file>] [--json]\n  orizu optimizations fail <run-id> [--reason <text>] [--report <markdown|@file> | --report-file <path>] [--metadata <json|@file>] [--json]\n  orizu optimizations cancel <run-id> [--reason <text>] [--report <markdown|@file> | --report-file <path>] [--json]`);
+    printLine(`\nOptimization lifecycle commands:\n\n  orizu optimizations start --project <team/project> --optimizer-version <id> --prompt-version <id[,id]> --selection-scorer <id> [--reflection-scorer <id>] [--pareto-scorer <id>] [--best-scorer <id>] --dataset-version <id> --split-set <id> [--train-split <name>] [--validation-split <name>] [--metadata <json|@file>] [--json]\n  orizu optimizations run-gepa --project <team/project> --optimizer-version-id <id> --candidate-version-id <id> --runner-version-id <id> --candidate-runner-dir <dir> --scorer-version-id <id> --scorer-runner-version-id <id> --scorer-runner-dir <dir> --dataset-version-id <id> --split-set-id <id> [--train-split train] [--val-split validation] [--num-threads auto|N] [--log-dir logs] [--no-skip-perfect-parent-reflection]\n  orizu optimizations export <run-id> [--out <path>] [--json]\n  orizu optimizations pause <run-id> [--reason <text>] [--json]\n  orizu optimizations resume <run-id> [--json]\n  orizu optimizations finish <run-id> [--best-score <n>] [--best-candidate <id>] [--result-prompt-version <id>] [--report <markdown|@file> | --report-file <path>] [--metadata <json|@file>] [--json]\n  orizu optimizations fail <run-id> [--reason <text>] [--report <markdown|@file> | --report-file <path>] [--metadata <json|@file>] [--json]\n  orizu optimizations cancel <run-id> [--reason <text>] [--report <markdown|@file> | --report-file <path>] [--json]`);
 }
 let cliArgs = process.argv.slice(2);
+let cliJsonOutput = false;
 function getArg(name) {
     const index = cliArgs.indexOf(name);
     if (index === -1 || index + 1 >= cliArgs.length) {
@@ -49,6 +52,26 @@ function getArg(name) {
     }
     return cliArgs[index + 1];
 }
+function getArgs(name) {
+    const values = [];
+    for (let index = 0; index < cliArgs.length; index += 1) {
+        if (cliArgs[index] !== name) {
+            continue;
+        }
+        const value = cliArgs[index + 1];
+        if (!value || value.startsWith('-')) {
+            throw new Error(`Usage: ${name} <value>`);
+        }
+        values.push(value);
+        index += 1;
+    }
+    return values;
+}
+function rejectDashPrefixedOptionValue(name, value) {
+    if (value && value.startsWith('-')) {
+        throw new Error(`Invalid value for ${name}: option values cannot start with a dash`);
+    }
+}
 export function normalizeSlugInput(slug) {
     return slug.trim().toLowerCase();
 }
@@ -1569,7 +1592,7 @@ async function execScorer() {
         printLine(`Wrote scorer result to ${sanitizeTerminalText(outPath)}`);
     }
 }
-const OPTIMIZATION_REPORT_MAX_BYTES = 2 * 1024 * 1024;
+const MARKDOWN_REPORT_MAX_BYTES = 2 * 1024 * 1024;
 function parseOptionalNumberFlag(name) {
     const value = getArg(name);
     if (!value) {
@@ -1584,9 +1607,11 @@ function parseOptionalNumberFlag(name) {
 function hasObjectKeys(value) {
     return Object.keys(value).length > 0;
 }
-function readOptimizationReportInput() {
+function readMarkdownReportInput(reportLabel) {
     const report = getArg('--report');
     const reportFile = getArg('--report-file');
+    rejectDashPrefixedOptionValue('--report', report);
+    rejectDashPrefixedOptionValue('--report-file', reportFile);
     if (report && reportFile) {
         throw new Error('Use either --report or --report-file, not both');
     }
@@ -1611,13 +1636,19 @@ function readOptimizationReportInput() {
         sourceName = 'inline';
     }
     if (!markdown.trim()) {
-        throw new Error('Optimization report markdown must not be blank');
+        throw new Error(`${reportLabel} report markdown must not be blank`);
     }
-    if (Buffer.byteLength(markdown, 'utf8') > OPTIMIZATION_REPORT_MAX_BYTES) {
-        throw new Error(`Optimization report exceeds ${OPTIMIZATION_REPORT_MAX_BYTES} bytes`);
+    if (Buffer.byteLength(markdown, 'utf8') > MARKDOWN_REPORT_MAX_BYTES) {
+        throw new Error(`${reportLabel} report exceeds ${MARKDOWN_REPORT_MAX_BYTES} bytes`);
     }
     return { markdown, sourceName };
 }
+function readOptimizationReportInput() {
+    return readMarkdownReportInput('Optimization');
+}
+function readTaskReportInput() {
+    return readMarkdownReportInput('Task');
+}
 async function startOptimizationRun() {
     const project = getArg('--project') || await resolveProjectSlug(null);
     const optimizerVersionId = getArg('--optimizer-version');
@@ -1922,11 +1953,106 @@ function readSourceBytes(pathArg) {
     }
 }
 function hasJsonFlag() {
-    return hasArg('--json');
+    return cliJsonOutput || hasArg('--json');
 }
 function printJson(value) {
     printLine(JSON.stringify(value));
 }
+function printCapabilities() {
+    const capabilities = getCapabilities(getCliVersion());
+    if (hasJsonFlag()) {
+        printLine(JSON.stringify(capabilities));
+        return;
+    }
+    printLine('orizu capabilities');
+    printLine('');
+    printLine('Run `orizu capabilities --json` for a machine-readable command manifest.');
+    printLine('');
+    for (const command of capabilities.commands) {
+        printLine(`  ${command.name.padEnd(34)} ${command.help}`);
+    }
+}
+async function askYesNo(question, defaultYes) {
+    const rl = createInterface({ input, output });
+    try {
+        const suffix = defaultYes ? 'Y/n' : 'y/N';
+        const answer = (await rl.question(`${question} (${suffix}) `)).trim().toLowerCase();
+        if (!answer) {
+            return defaultYes;
+        }
+        return answer === 'y' || answer === 'yes';
+    }
+    finally {
+        rl.close();
+    }
+}
+async function promptSkillInstallTargets() {
+    if (!isInteractiveTerminal()) {
+        throw new Error(`Usage: orizu install-skill --target <${SKILL_INSTALL_TARGETS.join('|')}> [--yes] [--dry-run]`);
+    }
+    printLine('Where should the Orizu CLI skill be installed?');
+    const targets = [];
+    for (const target of SKILL_INSTALL_TARGETS) {
+        const defaultYes = target === 'agent-user';
+        if (await askYesNo(`  Install to ${target}?`, defaultYes)) {
+            targets.push(target);
+        }
+    }
+    return targets;
+}
+function parseSkillInstallTargets() {
+    const rawTargets = getArgs('--target');
+    const targets = [];
+    for (const target of rawTargets) {
+        if (!isSkillInstallTarget(target)) {
+            throw new Error(`Unknown skill install target '${target}'. Available targets: ${SKILL_INSTALL_TARGETS.join(', ')}`);
+        }
+        if (!targets.includes(target)) {
+            targets.push(target);
+        }
+    }
+    return targets;
+}
+function formatSkillInstallAction(action) {
+    if (action === 'created')
+        return 'Wrote';
+    if (action === 'updated')
+        return 'Updated';
+    if (action === 'would-create')
+        return 'Would write';
+    return 'Would update';
+}
+async function installSkillCommand() {
+    const skipConfirm = hasArg('--yes');
+    const dryRun = hasArg('--dry-run');
+    let targets = parseSkillInstallTargets();
+    if (targets.length === 0) {
+        targets = await promptSkillInstallTargets();
+    }
+    if (targets.length === 0) {
+        printLine('No targets selected; nothing to do.');
+        return;
+    }
+    for (const target of targets) {
+        let overwrite = skipConfirm;
+        const installPath = getSkillInstallPath(target);
+        if (!dryRun && !overwrite && targetNeedsOverwrite(target)) {
+            if (!isInteractiveTerminal()) {
+                throw new Error(`${installPath} already exists. Pass --yes to replace it.`);
+            }
+            overwrite = await askYesNo(`Replace ${installPath}?`, true);
+            if (!overwrite) {
+                printLine(`Skipped ${installPath}`);
+                continue;
+            }
+        }
+        const result = installSkillTarget(target, {
+            overwrite,
+            dryRun,
+        });
+        printLine(`${formatSkillInstallAction(result.action)} ${result.path}`);
+    }
+}
 function readJsonFile(pathArg) {
     const raw = readSourceFile(pathArg);
     try {
@@ -2283,14 +2409,15 @@ async function createTask() {
     const appId = getArg('--app');
     const title = getArg('--title');
     const assignees = parseCommaSeparated(getArg('--assignees'));
+    const publish = hasArg('--publish');
     const versionArg = getArg('--version');
     const instructions = getArg('--instructions');
     const labelsPerItemArg = getArg('--labels-per-item');
     const labelsPerItem = labelsPerItemArg ? Number(labelsPerItemArg) : 1;
     const parsedVersionNum = versionArg ? Number(versionArg) : Number.NaN;
     const versionNum = Number.isInteger(parsedVersionNum) && parsedVersionNum > 0 ? parsedVersionNum : null;
-    if (!projectSlug || !datasetId || !appId || !title || assignees.length === 0) {
-        throw new Error('Usage: orizu tasks create --project <team/project> --dataset <datasetId> --app <appId> --title <title> --assignees <userIdOrEmail1,userIdOrEmail2> [--version <n>] [--instructions <text>] [--labels-per-item <n>] [--json]');
+    if (!projectSlug || !datasetId || !appId || !title || (publish && assignees.length === 0)) {
+        throw new Error('Usage: orizu tasks create --project <team/project> --dataset <datasetId> --app <appId> --title <title> [--assignees <userIdOrEmail1,userIdOrEmail2>] [--publish] [--version <n>] [--instructions <text>] [--labels-per-item <n>] [--json]');
     }
     if (versionArg && versionNum === null) {
         throw new Error('--version must be a positive integer');
@@ -2305,6 +2432,7 @@ async function createTask() {
             versionNum,
             title,
             memberIds: assignees,
+            publish,
             instructions,
             requiredAssignmentsPerRow: labelsPerItem,
         }),
@@ -2332,6 +2460,13 @@ async function createTask() {
             status: data.task.status,
             requiredAssignmentsPerRow: data.task.requiredAssignmentsPerRow,
             assignmentsCreated: data.assignmentsCreated,
+            draft: data.task.status === 'draft',
+            ...(data.task.status === 'draft'
+                ? {
+                    message: 'Draft created. Test it manually before assigning.',
+                    publishCommand: `orizu tasks publish --task ${data.task.id} --assignees <userId1,userId2>`,
+                }
+                : {}),
             ...(data.assignmentShortfall !== undefined ? { assignmentShortfall: data.assignmentShortfall } : {}),
             ...(data.warning ? { warning: data.warning } : {}),
         }, null, 2));
@@ -2339,14 +2474,56 @@ async function createTask() {
     }
     const baseUrl = getBaseUrl();
     const taskUrl = `${baseUrl}/d/${projectSlug}/tasks/${data.task.id}`;
-    printLine(`Created task ${sanitizeTerminalText(data.task.title)} (${sanitizeTerminalText(data.task.id)}) [${sanitizeTerminalText(data.task.status)}]` +
+    const isDraft = data.task.status === 'draft';
+    printLine(`Created ${isDraft ? 'draft ' : ''}task ${sanitizeTerminalText(data.task.title)} (${sanitizeTerminalText(data.task.id)}) [${sanitizeTerminalText(data.task.status)}]` +
         `\n  Task ID:    ${sanitizeTerminalText(data.task.id)}` +
         `\n  Dataset ID: ${sanitizeTerminalText(datasetId)}` +
         `\n  Version:    v${data.task.versionNum} (${sanitizeTerminalText(data.task.versionId)})` +
         `\n  Labels/row: ${data.task.requiredAssignmentsPerRow}` +
         `\n  Assignments: ${data.assignmentsCreated}` +
         (data.warning ? `\n  Warning:    ${sanitizeTerminalText(data.warning)}` : '') +
-        `\n  URL:        ${sanitizeTerminalText(taskUrl)}`);
+        `\n  URL:        ${sanitizeTerminalText(taskUrl)}` +
+        (isDraft
+            ? `\n\nThis task is a draft. Test it manually before assigning.\nPublish after approval: orizu tasks publish --task ${sanitizeTerminalText(data.task.id)} --assignees <userId1,userId2>`
+            : ''));
+}
+async function publishTask() {
+    const taskId = getArg('--task');
+    const assignees = parseCommaSeparated(getArg('--assignees'));
+    if (!taskId || assignees.length === 0) {
+        throw new Error('Usage: orizu tasks publish --task <taskId> --assignees <userId1,userId2> [--json]');
+    }
+    const response = await authedFetch(`/api/cli/tasks/${encodeURIComponent(taskId)}/publish`, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ memberIds: assignees }),
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to publish task: ${await extractErrorMessage(response)}`);
+    }
+    const data = await parseJsonResponse(response, 'Task publish');
+    if (hasArg('--json')) {
+        printLine(JSON.stringify({
+            taskId: data.task.id,
+            status: data.task.status,
+            assignmentsCreated: data.assignmentsCreated,
+            assignmentsProcessed: data.assignmentsProcessed,
+            ...(data.assignmentsRemoved !== undefined
+                ? { assignmentsRemoved: data.assignmentsRemoved }
+                : {}),
+            ...(data.assignmentShortfall !== undefined
+                ? { assignmentShortfall: data.assignmentShortfall }
+                : {}),
+            ...(data.warning ? { warning: data.warning } : {}),
+        }, null, 2));
+        return;
+    }
+    printLine(`Published task ${sanitizeTerminalText(data.task.id)} [${sanitizeTerminalText(data.task.status)}]` +
+        `\n  Assignments: ${data.assignmentsCreated}` +
+        (data.assignmentsRemoved !== undefined
+            ? `\n  Replaced:    ${data.assignmentsRemoved} old assignments removed`
+            : '') +
+        (data.warning ? `\n  Warning:     ${sanitizeTerminalText(data.warning)}` : ''));
 }
 async function assignTask() {
     const taskId = getArg('--task');
@@ -2425,6 +2602,35 @@ async function updateTaskStatus(targetStatus) {
     const action = targetStatus === 'paused' ? 'Paused' : 'Unpaused';
     printLine(`${action} task ${sanitizeTerminalText(data.task.id)} [${sanitizeTerminalText(data.task.status)}]`);
 }
+async function setTaskReport() {
+    const taskId = getArg('--task');
+    rejectDashPrefixedOptionValue('--task', taskId);
+    if (!taskId) {
+        throw new Error('Usage: orizu tasks report set --task <taskId> (--report <markdown|@file> | --report-file <path>) [--json]');
+    }
+    const report = readTaskReportInput();
+    if (!report) {
+        throw new Error('Usage: orizu tasks report set --task <taskId> (--report <markdown|@file> | --report-file <path>) [--json]');
+    }
+    const response = await authedFetch(`/api/cli/tasks/${encodeURIComponent(taskId)}/report`, {
+        method: 'PATCH',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+            reportMarkdown: report.markdown,
+            reportSourceName: report.sourceName,
+        }),
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to update task report: ${await response.text()}`);
+    }
+    const data = await parseJsonResponse(response, 'Task report update');
+    if (hasJsonFlag()) {
+        printJson(data);
+        return;
+    }
+    printLine(`Uploaded task report for ${sanitizeTerminalText(data.task.id)} ` +
+        `[${sanitizeTerminalText(data.task.status)}]`);
+}
 function defaultAppExportFilename(appName, versionNum) {
     const safeName = appName
         .trim()
@@ -3293,10 +3499,37 @@ async function runnersExec() {
         materializedRunner.cleanup();
     }
 }
+function isHelpToken(value) {
+    return value === '--help' || value === '-h';
+}
+function extractHelpTarget(args) {
+    if (args[0] === 'help') {
+        return helpTargetFromArgs(args.slice(1));
+    }
+    if (!args.some(isHelpToken)) {
+        return null;
+    }
+    return helpTargetFromArgs(args);
+}
+function helpTargetFromArgs(args) {
+    const targetArgs = args.filter(arg => !isHelpToken(arg) && arg !== '--json');
+    const optionIndex = targetArgs.findIndex(arg => arg.startsWith('-'));
+    return optionIndex === -1 ? targetArgs : targetArgs.slice(0, optionIndex);
+}
 export async function main(rawArgs = process.argv.slice(2)) {
     const parsed = parseGlobalFlags(rawArgs);
     setGlobalFlags(parsed.flags);
     cliArgs = parsed.args;
+    cliJsonOutput = false;
+    if (cliArgs[0] === '--json') {
+        cliJsonOutput = true;
+        cliArgs = cliArgs.slice(1);
+    }
+    const helpTarget = extractHelpTarget(cliArgs);
+    if (helpTarget !== null) {
+        printLine(renderHelpForArgs(helpTarget));
+        return;
+    }
     const command = cliArgs[0];
     const subcommand = cliArgs[1];
     if (command === '--version' || command === '-v') {
@@ -3305,9 +3538,20 @@ export async function main(rawArgs = process.argv.slice(2)) {
     }
     if (!command) {
         printUsage();
-        printOptimizationUsage();
         process.exit(1);
     }
+    if (command === 'capabilities') {
+        printCapabilities();
+        return;
+    }
+    if (command === 'install-skill') {
+        await installSkillCommand();
+        return;
+    }
+    if (command === 'skills' && subcommand === 'install') {
+        await installSkillCommand();
+        return;
+    }
     if (command === 'login') {
         await login();
         return;
@@ -3498,6 +3742,10 @@ export async function main(rawArgs = process.argv.slice(2)) {
         await createTask();
         return;
     }
+    if (command === 'tasks' && subcommand === 'publish') {
+        await publishTask();
+        return;
+    }
     if (command === 'tasks' && subcommand === 'assign') {
         await assignTask();
         return;
@@ -3506,6 +3754,12 @@ export async function main(rawArgs = process.argv.slice(2)) {
         await taskStatus();
         return;
     }
+    if (command === 'tasks' &&
+        subcommand === 'report' &&
+        (cliArgs[2] === 'set' || cliArgs[2] === 'upload')) {
+        await setTaskReport();
+        return;
+    }
     if (command === 'tasks' && subcommand === 'pause') {
         await updateTaskStatus('paused');
         return;
@@ -3568,7 +3822,6 @@ export async function main(rawArgs = process.argv.slice(2)) {
         return;
     }
     printUsage();
-    printOptimizationUsage();
     process.exit(1);
 }
 function isCliEntrypoint() {

package/dist/skill-installer.js

@@ -0,0 +1,180 @@
+import { cpSync, existsSync, mkdirSync, readFileSync, rmSync, writeFileSync, } from 'fs';
+import { dirname, isAbsolute, relative, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import { homedir } from 'os';
+export const SKILL_NAME = 'orizu-cli';
+export const AGENTS_START_MARKER = '<!-- orizu-cli:start -->';
+export const AGENTS_END_MARKER = '<!-- orizu-cli:end -->';
+export const SKILL_INSTALL_TARGETS = [
+    'agent-user',
+    'codex-project',
+    'claude-user',
+    'claude-project',
+    'agents-md',
+];
+function getCliRoot() {
+    return resolve(dirname(fileURLToPath(import.meta.url)), '..');
+}
+function isSkillDir(path) {
+    return existsSync(resolve(path, 'SKILL.md'));
+}
+export function isSafeRelativeSkillPath(rel) {
+    return rel !== '..' && !rel.startsWith('../') && !isAbsolute(rel);
+}
+export function formatMissingSkillSourceError(paths) {
+    return `Unable to find bundled ${SKILL_NAME} skill. Reinstall the orizu CLI or run from the Orizu repository.\n`
+        + `Searched:\n- ${paths.join('\n- ')}`;
+}
+export function resolveSkillSourceDir() {
+    const override = process.env.ORIZU_SKILL_SOURCE_DIR;
+    if (override) {
+        const resolvedOverride = resolve(override);
+        if (!isSkillDir(resolvedOverride)) {
+            throw new Error(`ORIZU_SKILL_SOURCE_DIR is not an Orizu skill directory: ${resolvedOverride}`);
+        }
+        return resolvedOverride;
+    }
+    const cliRoot = getCliRoot();
+    const packagedSkill = resolve(cliRoot, 'vendor', 'skills', SKILL_NAME);
+    if (isSkillDir(packagedSkill)) {
+        return packagedSkill;
+    }
+    const repoSkill = resolve(cliRoot, '..', '..', 'skills', SKILL_NAME);
+    if (isSkillDir(repoSkill)) {
+        return repoSkill;
+    }
+    const searchedPaths = [
+        `packaged skill: ${packagedSkill}`,
+        `repository fallback: ${repoSkill}`,
+    ];
+    throw new Error(formatMissingSkillSourceError(searchedPaths));
+}
+function resolveHome(options) {
+    return resolve(options?.homeDir || process.env.HOME || homedir());
+}
+function resolveCwd(options) {
+    return resolve(options?.cwd || process.cwd());
+}
+export function getSkillInstallPath(target, options) {
+    const home = resolveHome(options);
+    const cwd = resolveCwd(options);
+    if (target === 'agent-user') {
+        return resolve(home, '.agents', 'skills', SKILL_NAME);
+    }
+    if (target === 'codex-project') {
+        return resolve(cwd, '.codex', 'skills', SKILL_NAME);
+    }
+    if (target === 'claude-user') {
+        return resolve(home, '.claude', 'skills', SKILL_NAME);
+    }
+    if (target === 'claude-project') {
+        return resolve(cwd, '.claude', 'skills', SKILL_NAME);
+    }
+    return resolve(cwd, 'AGENTS.md');
+}
+function shouldCopySkillPath(sourceRoot, sourcePath) {
+    const rel = relative(sourceRoot, sourcePath).replace(/\\/g, '/');
+    if (!rel) {
+        return true;
+    }
+    if (!isSafeRelativeSkillPath(rel)) {
+        return false;
+    }
+    const parts = rel.split('/');
+    return !parts.some(part => part === '.DS_Store' ||
+        part === '__pycache__' ||
+        part === '.pytest_cache') && !rel.endsWith('.pyc') && !rel.endsWith('.pyo');
+}
+function copySkillTree(sourceDir, targetDir) {
+    rmSync(targetDir, { recursive: true, force: true });
+    mkdirSync(dirname(targetDir), { recursive: true });
+    cpSync(sourceDir, targetDir, {
+        recursive: true,
+        filter: sourcePath => shouldCopySkillPath(sourceDir, sourcePath),
+    });
+}
+function stripFrontmatter(markdown) {
+    const match = markdown.match(/^---\r?\n[\s\S]*?\r?\n---\r?\n/);
+    if (!match) {
+        return markdown;
+    }
+    return markdown.slice(match[0].length).replace(/^[\r\n]+/, '');
+}
+function buildAgentsSection(sourceDir) {
+    const skillMarkdown = readFileSync(resolve(sourceDir, 'SKILL.md'), 'utf8');
+    const body = stripFrontmatter(skillMarkdown).trimEnd();
+    return `${AGENTS_START_MARKER}\n${body}\n${AGENTS_END_MARKER}\n`;
+}
+function installAgentsMd(sourceDir, targetPath, options) {
+    const section = buildAgentsSection(sourceDir);
+    const exists = existsSync(targetPath);
+    const existing = exists ? readFileSync(targetPath, 'utf8') : '';
+    const hasManagedSection = existing.includes(AGENTS_START_MARKER)
+        && existing.includes(AGENTS_END_MARKER);
+    const action = exists ? 'updated' : 'created';
+    if (options?.dryRun) {
+        return {
+            target: 'agents-md',
+            path: targetPath,
+            action: action === 'updated' ? 'would-update' : 'would-create',
+        };
+    }
+    if (hasManagedSection && !options?.overwrite) {
+        throw new Error(`${targetPath} already contains an Orizu CLI section. Pass --yes to replace it.`);
+    }
+    mkdirSync(dirname(targetPath), { recursive: true });
+    if (!exists) {
+        writeFileSync(targetPath, section, 'utf8');
+        return { target: 'agents-md', path: targetPath, action: 'created' };
+    }
+    if (hasManagedSection) {
+        const pattern = new RegExp(`${escapeRegExp(AGENTS_START_MARKER)}[\\s\\S]*?${escapeRegExp(AGENTS_END_MARKER)}\\n?`);
+        writeFileSync(targetPath, existing.replace(pattern, section), 'utf8');
+        return { target: 'agents-md', path: targetPath, action: 'updated' };
+    }
+    const existingPrefix = existing.trim().length === 0 ? '' : existing;
+    const separator = existingPrefix.endsWith('\n') ? '\n' : '\n\n';
+    writeFileSync(targetPath, `${existingPrefix}${existingPrefix ? separator : ''}${section}`, 'utf8');
+    return { target: 'agents-md', path: targetPath, action: 'updated' };
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+export function targetNeedsOverwrite(target, options) {
+    const targetPath = getSkillInstallPath(target, options);
+    if (!existsSync(targetPath)) {
+        return false;
+    }
+    if (target !== 'agents-md') {
+        return true;
+    }
+    const existing = readFileSync(targetPath, 'utf8');
+    return existing.includes(AGENTS_START_MARKER) && existing.includes(AGENTS_END_MARKER);
+}
+export function installSkillTarget(target, options) {
+    const sourceDir = resolveSkillSourceDir();
+    const targetPath = getSkillInstallPath(target, options);
+    const exists = existsSync(targetPath);
+    if (target === 'agents-md') {
+        return installAgentsMd(sourceDir, targetPath, options);
+    }
+    if (options?.dryRun) {
+        return {
+            target,
+            path: targetPath,
+            action: exists ? 'would-update' : 'would-create',
+        };
+    }
+    if (exists && !options?.overwrite) {
+        throw new Error(`${targetPath} already exists. Pass --yes to replace it.`);
+    }
+    copySkillTree(sourceDir, targetPath);
+    return {
+        target,
+        path: targetPath,
+        action: exists ? 'updated' : 'created',
+    };
+}
+export function isSkillInstallTarget(value) {
+    return SKILL_INSTALL_TARGETS.includes(value);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "orizu",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "private": false,
   "type": "module",
   "bin": {
@@ -16,8 +16,8 @@
   ],
   "scripts": {
     "build": "tsc -p tsconfig.json",
-    "prepack": "node scripts/vendor-gepa-python.mjs",
-    "postpack": "node scripts/vendor-gepa-python.mjs --clean"
+    "prepack": "node scripts/vendor-gepa-python.mjs && node scripts/vendor-orizu-skill.mjs",
+    "postpack": "node scripts/vendor-gepa-python.mjs --clean && node scripts/vendor-orizu-skill.mjs --clean"
   },
   "dependencies": {
     "@playwright/test": "^1.60.0",