@zenera/cli 1.1.15 → 1.1.16

package/dist/banner.d.ts

@@ -6,8 +6,12 @@ export interface BannerText {
     /** the line underneath, dim */
     subtitle: string;
 }
+export interface PrintBannerOptions {
+    /** Render the block face even when the terminal is narrower than it. */
+    readonly full?: boolean;
+}
 export declare const NEO_BANNER: BannerText;
 export declare function bannerLines(text: BannerText, columns?: number): string[];
 /** Narration, and only for someone watching. */
-export declare function printBanner(text: BannerText): void;
+export declare function printBanner(text: BannerText, options?: PrintBannerOptions): void;
 //# sourceMappingURL=banner.d.ts.map

package/dist/banner.js

@@ -112,12 +112,12 @@ export function bannerLines(text, columns = process.stderr.columns || 80) {
     return lines;
 }
 /** Narration, and only for someone watching. */
-export function printBanner(text) {
+export function printBanner(text, options = {}) {
     if (!process.stderr.isTTY) {
         return;
     }
     note('');
-    for (const line of bannerLines(text)) {
+    for (const line of bannerLines(text, options.full ? Infinity : undefined)) {
         note(line);
     }
     note('');

package/dist/command.d.ts

@@ -9,6 +9,11 @@ export interface Command {
     readonly usage: string;
     /** lines printed under the usage line by `zen help <command>` */
     readonly details?: readonly string[];
+    /**
+     * Answers `--help` itself, for a command whose arguments select a page the
+     * frame cannot see. Without it the frame prints this command's own page.
+     */
+    help?(ctx: Context): Promise<void> | void;
     run(ctx: Context): Promise<void>;
 }
 //# sourceMappingURL=command.d.ts.map

package/dist/main.js

@@ -57,9 +57,11 @@ async function main(argv) {
     // Narration, so `--json` and every pipe are untouched by it. A command
     // living in another package brings its own brand, but only once it is
     // actually there — a banner over "not installed" is a claim about nothing.
-    if (!json) {
+    const ragSearch = name === 'rag' && ['docs', 'schema'].includes(rest[0]) && rest[1] === 'search';
+    const interactive = rest.includes('--interactive');
+    if (!json && (!ragSearch || interactive)) {
         const brand = external && hasExternal(external) ? external.banner : undefined;
-        printBanner(brand ?? NEO_BANNER);
+        printBanner(brand ?? NEO_BANNER, { full: ragSearch && interactive });
     }
     if (parts.name === 'help') {
         await usage(rest[0]);
@@ -73,15 +75,17 @@ async function main(argv) {
         fail(`unknown command "${parts.name}"`, `run ${bold(`${NAME} --help`)} for the list`);
         return EXIT.usage;
     }
-    if (values.help) {
-        await usage(name);
-        return EXIT.ok;
-    }
     // `-C` is consumed here so no command ever reads `process.cwd()` itself,
     // and every relative path in every command means the same thing.
     const cwd = resolve(values.directory ?? process.cwd());
     try {
         const one = command ?? (await loadExternal(name, external));
+        if (values.help) {
+            // A command that nests its own pages answers for them; the frame
+            // only knows the one page it printed the command's name on.
+            await (one.help ? one.help({ args: rest, json, cwd }) : usage(name));
+            return EXIT.ok;
+        }
         await one.run({ args: rest, json, cwd });
         return EXIT.ok;
     }

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@zenera/cli",
-    "version": "1.1.15",
+    "version": "1.1.16",
     "description": "Command-line front end for @zenera/neo: agentic projects you can run, share and commit.",
     "keywords": [
         "agents",
@@ -51,7 +51,7 @@
         "@inkjs/ui": "^2.0.0",
         "ink": "^7.1.1",
         "react": "^19.2.8",
-        "@zenera/neo": "^1.1.15",
+        "@zenera/neo": "^1.1.16",
         "@anthropic-ai/sdk": "^0.120.0",
         "@google/genai": "^2.18.0",
         "@openrouter/sdk": "^1.2.80",