@ekanos/cli 0.16.0 → 0.17.0

package/dist/index.js

@@ -9,12 +9,16 @@ var __rest = (this && this.__rest) || function (s, e) {
         }
     return t;
 };
+import { isRepoRoot } from '@ekanos/integration-schema/repo';
 import * as fs from 'node:fs';
+import * as path from 'node:path';
 import { runAgents } from './commands/agents.js';
 import { TEMPLATE_EDIT_HELP } from './commands/agents-edit.js';
 import { runApps } from './commands/apps.js';
+import { runAudiences } from './commands/audiences.js';
 import { runCatalog } from './commands/catalog.js';
 import { runDev } from './commands/dev.js';
+import { EXPERIENCE_COMMANDS } from './commands/index-experience.js';
 import { runInit } from './commands/init.js';
 import { runKnowledge } from './commands/knowledge.js';
 import { runLogin } from './commands/login.js';
@@ -36,7 +40,7 @@ import { runWhoami } from './commands/whoami.js';
 import { runWorkflows } from './commands/workflows.js';
 import { CliContext } from './context.js';
 import { SDK_DOCS_URL, docsPage } from './docs-links.js';
-import { toCliError, usageError } from './errors.js';
+import { preconditionError, toCliError, usageError } from './errors.js';
 import { detectInvocation, setInvocation } from './invocation.js';
 import { parseArgv } from './parse-argv.js';
 import { unknownCommand } from './unknown-command.js';
@@ -97,6 +101,10 @@ const COMMAND_SPECS = {
             type: 'string',
             description: 'Kebab-case id of the integration, e.g. acme-crm',
         },
+        kind: {
+            type: 'string',
+            description: 'What to scaffold: integration (default), experience (widgets and workflows that depend on integrations) or repo (one repo holding many of both)',
+        },
         dir: {
             type: 'string',
             description: 'Target directory (default ./<slug>; --dir . scaffolds in place)',
@@ -133,7 +141,11 @@ const COMMAND_SPECS = {
         },
         start: {
             type: 'boolean',
-            description: 'Start the server even in JSON mode; --no-start only scaffolds',
+            description: 'Start the server even in JSON mode or under an agent (non-interactive runs only scaffold and print the command); --no-start only scaffolds',
+        },
+        'contracts-dir': {
+            type: 'string',
+            description: 'Experiences: a directory of <integration>.contract.json files to resolve integrations from (offline registry)',
         },
     },
     test: {
@@ -232,6 +244,42 @@ const COMMAND_SPECS = {
         },
         page: { type: 'string', description: 'people: which page, from 1' },
     },
+    audiences: {
+        host: HOST,
+        source: SOURCE,
+        dir: DIR,
+        yes: {
+            type: 'boolean',
+            description: 'set: confirm dropping a product people then stop seeing',
+        },
+        name: { type: 'string', description: 'set: rename the audience' },
+        description: {
+            type: 'string',
+            description: 'create|set: what the audience is for',
+        },
+        products: {
+            type: 'string',
+            description: 'create|set: the products it shows, as a,b (set: replaces them; none empties it)',
+        },
+        widgets: {
+            type: 'string',
+            repeatable: true,
+            description: 'create|set: <product>=<id>,<id> shows only those widgets of the product (<product>= lifts the rule)',
+        },
+        tools: {
+            type: 'string',
+            repeatable: true,
+            description: 'create|set: <product>=<name>,<name> allows only those tools of the product (<product>= lifts the rule)',
+        },
+        default: {
+            type: 'boolean',
+            description: 'create|set: new teams of the Source start on it',
+        },
+        'all-entitled': {
+            type: 'boolean',
+            description: 'create|set: show every product the Source has, now and later (--no-all-entitled turns it off)',
+        },
+    },
     catalog: {
         host: HOST,
         source: SOURCE,
@@ -264,6 +312,14 @@ const COMMAND_SPECS = {
         }, self: {
             type: 'boolean',
             description: 'members add: you join the team now, with no invitation email',
+        }, 
+        // `teams audience`.
+        member: {
+            type: 'string',
+            description: "audience: one member's own audience, by email",
+        }, inherit: {
+            type: 'boolean',
+            description: "audience --member: clear their own audience so the team's applies",
         } }, SECRET_INPUT), { clear: {
             type: 'string',
             repeatable: true,
@@ -677,6 +733,14 @@ const COMMAND_SPECS = {
             type: 'boolean',
             description: 'Publish to the ekanos.json source without asking (needed in a script with several seats)',
         },
+        'dry-run': {
+            type: 'boolean',
+            description: 'Experiences and repos: gate, build and pack every package under .ekanos/publish/, publish nothing (publishing an experience is not supported by the host yet)',
+        },
+        all: {
+            type: 'boolean',
+            description: 'In a repo: publish every package',
+        },
     },
     upgrade: {
         dir: DIR,
@@ -700,9 +764,12 @@ const COMMAND_SPECS = {
 /** Commands that take positional arguments, and what each means, in order. Every other command is positional-free. */
 const POSITIONAL_COMMANDS = {
     use: ['source-slug'],
+    // In a repo: `publish <package>...` (repeatable, see VARIADIC_COMMANDS).
+    publish: ['package'],
     // `sources scopes add <scope> <product>` is the longest form.
     sources: ['subcommand', 'verb', 'product-or-scope', 'product-slug'],
     catalog: ['product-slug'],
+    audiences: ['subcommand', 'audience'],
     apps: ['subcommand', 'product-slug'],
     // `teams agents policy <team> <key> set <tool> auto` is the longest form.
     teams: [
@@ -725,12 +792,32 @@ const POSITIONAL_COMMANDS = {
     // `triggers <key> add event <trigger-key>` is the longest form: five tokens.
     agents: ['subcommand', 'key-or-path', 'action', 'arg', 'value'],
 };
+for (const command of EXPERIENCE_COMMANDS) {
+    COMMAND_SPECS[command.name] = command.specs;
+    if (command.positionals)
+        POSITIONAL_COMMANDS[command.name] = command.positionals;
+}
+/** Commands that act on one package: refused at a repo root, with the way in. */
+const REPO_ROOT_REFUSED = new Set([
+    'validate',
+    'test',
+    'check',
+    'build',
+    'sync',
+    'add',
+    'codegen',
+    'contract',
+]);
+/** Commands whose last positional repeats. */
+const VARIADIC_COMMANDS = new Set(['publish']);
 const COMMANDS = Object.keys(COMMAND_SPECS);
 const USAGE = [
     'Usage: ekanos <command> [options]',
     '',
     'Commands:',
-    '  init       Scaffold a new integration project into ./<slug> (--slug <slug> --yes)',
+    '  init       Scaffold a new integration project into ./<slug> (--slug <slug> --yes);',
+    '             --kind experience for an experience, --kind repo for a repo of many',
+    ...EXPERIENCE_COMMANDS.flatMap((command) => command.usage),
     '  validate   Validate ekanos.json + the integration definition (--json)',
     '  dev        Scaffold .ekanos/harness and run it with your own Next',
     '  test       Run the project test script via its package manager (--json).',
@@ -765,6 +852,14 @@ const USAGE = [
     "             roles: never changed or deleted; a held role isn't deleted) |",
     '             people [--search <text>] [--page <n>] (everyone with access, one',
     '             row per person, with their teams and role on each)',
+    "  audiences  A source's audiences, for its Source admin (they replace product",
+    '             scopes): list | show <audience> | create <name> [--products a,b |',
+    '             --all-entitled] [--description <text>] [--default] [--widgets',
+    '             <product>=<id>,…]… [--tools <product>=<name>,…]… | set <audience>',
+    '             [--name] [--description] [--default] [--all-entitled] [--products',
+    '             a,b|none] [--widgets …]… [--tools …]… [--yes] (--products replaces;',
+    '             dropping a product needs --yes). A team or member is put on one',
+    '             with "teams audience <team> [<audience>] [--member <email>]"',
     '  catalog    What a source can already use, and how to set it up:',
     '             Experiences, then Integrations; one product shows its tools',
     '             with their inputs and whose connection agent runs use',
@@ -838,7 +933,11 @@ const USAGE = [
     '             events <team> [<product>] [--product <slug>] [--since 24h|7d|<date>]',
     '             [--limit <n>] (the integration events recorded for the team, each',
     '             with its status, last error and the runs it started, or why none did)',
-    '             | scope show <team> (the product scopes it holds and the products',
+    '             | audience <team> [<audience>] [--member <email> [--inherit]] [--yes]',
+    "             (the audience a team starts its members on; a member's own, a Source",
+    "             admin's only, overrides it; --inherit clears it; moving people to an",
+    '             audience that shows less needs --yes)',
+    '             | scope show <team> (DEPRECATED, use audience: the product scopes it holds and the products',
     '             it sees in the app) | scope set <team> <scope> [<scope>…] [--yes]',
     '             (replaces them; dropping one needs --yes)',
     "             A team's agents, for the Source admin (teams <area> <verb> <team> …):",
@@ -988,7 +1087,9 @@ const USAGE = [
     '             <run-id> | runs cancel <run-id> [--yes] | approvals list |',
     '             approvals approve|reject <id> [--reason "…"]',
     '  use        Set this project\'s publish target ("ekanos use <source-slug>")',
-    '  publish    Validate, pack and submit the integration to an Ekanos host',
+    '  publish    Validate, pack and submit the integration to an Ekanos host.',
+    '             In a repo: publish [<package>...] | --all [--dry-run] (integrations',
+    '             first, each package gated, artifacts under .ekanos/publish/)',
     '  upgrade    Move this toolchain to a coherent target version, with',
     '             verify-and-rollback (--check --yes --no-verify --host <url>)',
     '',
@@ -1077,13 +1178,17 @@ export async function run(argv, options = {}) {
         if (positionalNames.length === 0 && parsed.positionals.length > 0) {
             throw usageError(`"${command}" takes no positional arguments (got "${parsed.positionals[0]}").`, `Pass options as flags, e.g. "--dir <path>". See "ekanos ${command} --help".`);
         }
-        if (parsed.positionals.length > positionalNames.length) {
+        if (parsed.positionals.length > positionalNames.length &&
+            !VARIADIC_COMMANDS.has(command)) {
             const usage = positionalNames.map((name) => `<${name}>`).join(' ');
             throw usageError(`"${command}" takes at most ${positionalNames.length} positional ` +
                 `argument${positionalNames.length === 1 ? '' : 's'} (${usage}), ` +
                 `got ${parsed.positionals.length}.`, `e.g. "ekanos ${command} ${usage}". See "ekanos ${command} --help".`);
         }
         const dir = (_f = parsed.flags.dir) !== null && _f !== void 0 ? _f : cwd;
+        if (REPO_ROOT_REFUSED.has(command) && isRepoRoot(path.resolve(dir))) {
+            throw preconditionError(`"${command}" works on one package, and ${dir} is a repo root.`, `Run it inside a package (cd integrations/<slug> or cd experiences/<slug>), or use "ekanos publish --all" for the whole repo.`);
+        }
         switch (command) {
             case 'init':
                 return await runInit(ctx, {
@@ -1093,6 +1198,7 @@ export async function run(argv, options = {}) {
                     force: parsed.flags.force === true,
                     yes: parsed.flags.yes === true,
                     docs: parsed.flags.docs,
+                    kind: parsed.flags.kind,
                     stdinIsTTY: options.stdinIsTTY,
                 });
             case 'validate':
@@ -1104,6 +1210,7 @@ export async function run(argv, options = {}) {
                     host: parsed.flags.host,
                     force: parsed.flags.force === true,
                     start: parsed.flags.start,
+                    contractsDir: parsed.flags['contracts-dir'],
                     env,
                 });
             case 'test':
@@ -1159,6 +1266,16 @@ export async function run(argv, options = {}) {
                     stdinIsTTY: options.stdinIsTTY,
                     ask: options.ask,
                 });
+            case 'audiences':
+                return await runAudiences(ctx, {
+                    host: parsed.flags.host,
+                    source: parsed.flags.source,
+                    positionals: parsed.positionals,
+                    yes: parsed.flags.yes === true,
+                    flags: parsed.flags,
+                    dir,
+                    env,
+                });
             case 'catalog':
                 return await runCatalog(ctx, {
                     host: parsed.flags.host,
@@ -1359,6 +1476,9 @@ export async function run(argv, options = {}) {
                     source: parsed.flags.source,
                     dir,
                     yes: parsed.flags.yes === true,
+                    dryRun: parsed.flags['dry-run'] === true,
+                    packages: parsed.positionals,
+                    all: parsed.flags.all === true,
                     env,
                     stdinIsTTY: options.stdinIsTTY,
                     confirm: options.confirm,
@@ -1374,9 +1494,21 @@ export async function run(argv, options = {}) {
                     stdinIsTTY: options.stdinIsTTY,
                     confirm: options.confirm,
                 });
-            default:
+            default: {
+                const experienceCommand = EXPERIENCE_COMMANDS.find((candidate) => candidate.name === command);
+                if (experienceCommand) {
+                    return await experienceCommand.run(ctx, {
+                        flags: parsed.flags,
+                        positionals: parsed.positionals,
+                        passthrough: parsed.passthrough,
+                        dir,
+                        cwd,
+                        env,
+                    });
+                }
                 // Unreachable — COMMANDS gate above — but keeps the switch total.
                 throw usageError(`Unknown command "${command}".`, `Run one of: ${COMMANDS.join(', ')}.`);
+            }
         }
     }
     catch (error) {