@zenalexa/unicli 0.207.1 → 0.209.0

package/dist/commands/agents.js

@@ -20,7 +20,14 @@ export function registerAgentsCommand(program) {
         .command("generate")
         .description("Auto-generate AGENTS.md from loaded adapters")
         .option("--output <path>", "output file path", "AGENTS.md")
+        .option("--for <harness>", "target harness format (claude|cursor|codex|goose|generic)")
         .action((opts) => {
+        const harness = opts.for ?? "claude";
+        if (!["claude", "cursor", "codex", "goose", "generic"].includes(harness)) {
+            console.error(chalk.red(`Unknown harness: ${harness}. Available: claude, cursor, codex, goose, generic`));
+            process.exitCode = 1;
+            return;
+        }
         const adapters = getAllAdapters();
         const commands = listCommands();
         if (adapters.length === 0) {
@@ -81,11 +88,84 @@ export function registerAgentsCommand(program) {
         lines.push("---");
         lines.push(`<!-- Generated by Uni-CLI v${VERSION} on ${date} -->`);
         lines.push("");
-        const content = lines.join("\n");
+        // Transform content based on target harness
+        let content;
+        const baseContent = lines.join("\n");
+        switch (harness) {
+            case "cursor": {
+                // Cursor Rules format — .cursorrules file
+                const cursorLines = [
+                    "# Uni-CLI Integration Rules",
+                    "",
+                    `Uni-CLI provides ${cmdCount} commands across ${siteCount} sites.`,
+                    "Use `unicli <site> <command>` to interact with websites and services.",
+                    "Pipe output is always JSON — no flags needed.",
+                    "",
+                    "## Available Sites",
+                    "",
+                ];
+                for (const adapter of adapters) {
+                    const cmds = Object.keys(adapter.commands).sort().join(", ");
+                    cursorLines.push(`- **${adapter.name}**: ${cmds}`);
+                }
+                cursorLines.push("");
+                cursorLines.push("## Error Handling");
+                cursorLines.push("On failure, unicli outputs structured JSON to stderr with `adapter_path` and `suggestion` fields.");
+                cursorLines.push("Read the YAML adapter at that path to understand and fix the issue.");
+                content = cursorLines.join("\n");
+                break;
+            }
+            case "codex": {
+                // Codex-optimized format — concise, tool-use oriented
+                const codexLines = [
+                    `# unicli — ${siteCount} sites, ${cmdCount} commands`,
+                    "",
+                    "## Usage",
+                    "```",
+                    "unicli <site> <command> [args] [--json]",
+                    "```",
+                    "",
+                    "Piped output auto-switches to JSON. Exit codes follow sysexits.h.",
+                    "",
+                    "## Sites",
+                    "",
+                ];
+                for (const adapter of adapters) {
+                    codexLines.push(`### ${adapter.name}`);
+                    for (const [cmd, info] of Object.entries(adapter.commands)) {
+                        const desc = info.description ?? "";
+                        codexLines.push(`- \`unicli ${adapter.name} ${cmd}\` — ${desc}`);
+                    }
+                }
+                content = codexLines.join("\n");
+                break;
+            }
+            case "goose": {
+                // Goose recipe format
+                const gooseLines = [
+                    "name: unicli",
+                    `description: CLI interface to ${siteCount} websites and services`,
+                    "version: " + VERSION,
+                    "tools:",
+                ];
+                for (const cmd of commands) {
+                    gooseLines.push(`  - name: unicli_${cmd.site}_${cmd.command}`);
+                    gooseLines.push(`    command: unicli ${cmd.site} ${cmd.command}`);
+                    gooseLines.push(`    description: ${cmd.description}`);
+                }
+                content = gooseLines.join("\n");
+                break;
+            }
+            case "generic":
+                content = baseContent;
+                break;
+            default:
+                content = baseContent;
+        }
         const outPath = resolve(opts.output);
         writeFileSync(outPath, content, "utf-8");
         // Summary to stderr so it doesn't pollute piped output
-        console.error(chalk.green(`Generated ${outPath} (${siteCount} sites, ${cmdCount} commands)`));
+        console.error(chalk.green(`Generated ${outPath} (${siteCount} sites, ${cmdCount} commands, format: ${harness})`));
     });
 }
 //# sourceMappingURL=agents.js.map

package/dist/commands/agents.js.map

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

package/dist/commands/eval.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Eval harness — declarative regression suite for adapters.
+ *
+ *   unicli eval list                       # list available evals
+ *   unicli eval run smoke/bilibili         # run one eval file
+ *   unicli eval run --all smoke/           # run a directory
+ *   unicli eval ci --since 7d              # run only adapters touched in N days
+ *
+ * Eval files are YAML, located at:
+ *   - `evals/` (bundled with the npm package)
+ *   - `~/.unicli/evals/` (user-local)
+ *
+ * Format:
+ *   name: bilibili-smoke
+ *   adapter: bilibili
+ *   cases:
+ *     - command: rank
+ *       args: {}
+ *       judges:
+ *         - { type: arrayMinLength, path: data, min: 5 }
+ *         - { type: contains, field: data[0].title, value: "" }
+ *
+ * Why this exists:
+ *   v0.207 shipped the eval *primitive* (`src/engine/repair/eval.ts`).
+ *   v0.208 ships the *content*: a starter catalog so the self-repair loop
+ *   has measurable baselines. Without baselines, claimed improvements are
+ *   noise. The CLI command is the on-ramp; the YAML files are the data.
+ */
+import type { Command } from "commander";
+/** Bundled evals ship in the package — resolved relative to dist/src. */
+declare const BUNDLED_EVALS_DIR: string;
+declare const USER_EVALS_DIR: string;
+export interface EvalCase {
+    command: string;
+    args?: Record<string, string | number | boolean>;
+    /** Optional pre-canned positional values */
+    positional?: Array<string | number>;
+    judges: Judge[];
+}
+export type Judge = {
+    type: "arrayMinLength";
+    path?: string;
+    min: number;
+} | {
+    type: "contains";
+    field?: string;
+    value: string;
+} | {
+    type: "nonEmpty";
+} | {
+    type: "matchesPattern";
+    pattern: string;
+} | {
+    type: "exitCode";
+    equals: number;
+};
+export interface EvalFile {
+    name: string;
+    adapter: string;
+    description?: string;
+    cases: EvalCase[];
+}
+export interface CaseResult {
+    case: EvalCase;
+    passed: boolean;
+    output?: string;
+    exitCode?: number;
+    error?: string;
+    judgeResults: Array<{
+        judge: Judge;
+        passed: boolean;
+        reason?: string;
+    }>;
+}
+export interface EvalRunResult {
+    file: EvalFile;
+    passed: number;
+    total: number;
+    cases: CaseResult[];
+}
+/** Return every eval file path discovered across bundled + user directories. */
+export declare function discoverEvalFiles(): Array<{
+    path: string;
+    relative: string;
+}>;
+/** Load + parse one eval file. Throws on YAML errors so callers can report. */
+export declare function loadEvalFile(file: string): EvalFile;
+/**
+ * Apply one judge to a (parsed JSON) output. The output may be an array
+ * (Uni-CLI's normal shape) or an object (less common). The judge logic
+ * intentionally treats both shapes uniformly via path resolution.
+ */
+export declare function applyJudge(parsedOutput: unknown, rawOutput: string, exitCode: number, judge: Judge): {
+    passed: boolean;
+    reason?: string;
+};
+export declare function runCase(adapter: string, c: EvalCase, options?: {
+    timeout?: number;
+    cliCommand?: string;
+}): CaseResult;
+export declare function runEvalFile(file: EvalFile, options?: {
+    timeout?: number;
+    cliCommand?: string;
+}): EvalRunResult;
+export declare function registerEvalCommand(program: Command): void;
+export { BUNDLED_EVALS_DIR, USER_EVALS_DIR };
+/**
+ * Helper used only by tests: ensure user evals directory exists. Not used
+ * by production code paths.
+ */
+export declare function ensureUserEvalsDir(): string;
+//# sourceMappingURL=eval.d.ts.map

package/dist/commands/eval.d.ts.map

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