@ekanos/cli 0.22.0 → 0.23.0

package/dist/icon-findings.js

@@ -1,26 +1,21 @@
 import * as fs from 'node:fs';
 import * as path from 'node:path';
-import { FA_FREE_ICON_NAMES, FA_PRO_TO_FREE_HINTS, } from './generated/fa-free-names.js';
+import { PHOSPHOR_ICON_NAMES } from './generated/phosphor-names.js';
 /**
- * Flags Font Awesome **Pro**-only `fa-*` icon names in a project's widget
- * source — today this is a silent, runtime-only failure: `@ekanos/ui`'s
- * `Icon` warns once via `console.warn` in dev, but ships nothing to
- * `validate`, so a partner only discovers a Pro-only name when the generated
- * harness (Font Awesome **Free**-only, see `@ekanos/harness`) renders the
- * circle-question fallback in place of the intended glyph — or never
- * discovers it, if nobody was watching the console.
+ * Flags icon names in a project's widget source that `@ekanos/ui`'s `Icon`
+ * cannot draw. Icons are Phosphor (phosphoricons.com): a name that is not
+ * one draws the `shapes` fallback, which nobody notices until a screenshot
+ * review. A Font Awesome value from before the move (`fa-house`) still
+ * renders through a translation table, but new code should write the
+ * Phosphor name.
  *
- * `validate` has no live component tree to inspect the way the runtime
- * warning does, and the definition's `component`/`icon` fields are live
- * React values by the time `loadDefinition` resolves them (function
- * references, not paths) — there is no file path to walk back to from an
- * already-imported component. So this scans the project's own `src/**\/*.{ts,tsx}`
- * on disk instead, the same fallback `collectProjectFindings` would use if it
- * needed source text rather than a loaded value.
+ * `validate` has no live component tree, and by the time `loadDefinition`
+ * resolves a definition its `component`/`icon` fields are live values with
+ * no path back to source, so this scans the project's own
+ * `src/**\/*.{ts,tsx}` on disk.
  *
- * WARN, not error: a Pro-only name is broken UX in a Free-only host, not an
- * unbuildable submission — plenty of Ekanos-hosted partners run under Pro,
- * where the exact same name renders correctly.
+ * WARN, not error: an unknown name is broken UX, not an unbuildable
+ * submission.
  */
 export function collectIconFindings(projectDir) {
     const srcDir = path.join(projectDir, 'src');
@@ -44,75 +39,55 @@ function* walkTsFiles(dir) {
     }
 }
 /**
- * One Font Awesome style-family token, e.g. the `fa-solid` in
- * `"fa-solid fa-house"` (the host's icon helper produces exactly this
- * two-token shape). Kept in sync by hand with the host UI package's
- * `FA_ICON_STYLES` — a style name is never itself an icon name, so it must
- * not be treated as one, but that list lives in a browser package this one
- * may not import.
+ * A quoted literal whose entire contents could be an icon value: a Phosphor
+ * name (`house`, `star:fill`) or a Font Awesome value (`fa-solid fa-house`).
+ * Parameterized on its backreference because it is spliced in twice.
  */
-const FA_STYLE_TOKEN = '(?:solid|regular|light|thin|duotone|sharp|brands|classic)';
-/**
- * A quoted string literal whose ENTIRE contents are a bare `fa-<name>` value
- * or a two-token `fa-<style> fa-<name>` value — anchored to the quote
- * boundaries (the backreference to the opening quote must follow the name
- * pattern immediately) so this cannot match a `fa-`-prefixed SUBSTRING inside
- * a longer, unrelated string.
- *
- * Parameterized on its own backreference number because it is spliced into
- * `FA_ICON_CONTEXT_RE` twice — each copy opens its own capture group, so a
- * hardcoded `\1` in the second copy would wrongly point at the FIRST copy's
- * quote group instead of its own.
- */
-function faIconLiteral(quoteGroup) {
-    return `(['"\`])(?:fa-${FA_STYLE_TOKEN}\\s+)?fa-([a-z][a-z0-9]*(?:-[a-z0-9]+)*)\\${quoteGroup}`;
+function iconLiteral(quoteGroup) {
+    return `(['"\`])((?:fa-[a-z]+\\s+)?[a-z][a-z0-9]*(?:-[a-z0-9]+)*(?::fill)?)\\${quoteGroup}`;
 }
 /**
- * Only literals in a position that plausibly HOLDS an icon name: the `name`/
- * `icon` prop or object key an `<Icon>`, a widget's `category.icon`, or a
- * config object typically uses, or a direct argument to `resolveIcon`/
- * `renderIcon` (`@ekanos/ui`'s runtime helpers).
- *
- * This is a heuristic, not a parser — it will miss an icon name built up any
- * other way (a variable, a template with interpolation, an indirect prop
- * name), and in principle a `name`/`icon` key on some unrelated object could
- * coincidentally hold an `fa-`-shaped string and get flagged. Both failure
- * modes are accepted: a scan that required full TS type information to be
- * exact is not worth the cost here, and this project's own convention names
- * icon props/keys `name` or `icon` specifically to keep that collision rare.
- * Group numbers: 1 = quote, 2 = name for the `name`/`icon` branch; 3 = quote,
- * 4 = name for the `resolveIcon`/`renderIcon` branch.
+ * Only literals in a position that plausibly holds an icon name: the `icon`
+ * prop or key, an `<Icon name=…>`, or a direct argument to `resolveIcon` /
+ * `renderIcon`. A heuristic, not a parser: it misses names built any other
+ * way. Groups: 1 = quote, 2 = value for the `icon` key; 3/4 for `<Icon
+ * name>`; 5/6 for the helper calls.
  */
-const FA_ICON_CONTEXT_RE = new RegExp(`\\b(?:name|icon)\\s*[:=]\\s*\\{?\\s*${faIconLiteral(1)}` +
-    `|\\b(?:resolveIcon|renderIcon)\\(\\s*${faIconLiteral(3)}`, 'g');
+const ICON_CONTEXT_RE = new RegExp(`\\bicon\\s*[:=]\\s*\\{?\\s*${iconLiteral(1)}` +
+    `|<Icon\\b[^>]*?\\bname=\\{?\\s*${iconLiteral(3)}` +
+    `|\\b(?:resolveIcon|renderIcon)\\(\\s*${iconLiteral(5)}`, 'g');
 function collectIconFindingsInFile(file) {
-    var _a;
+    var _a, _b;
     const source = fs.readFileSync(file, 'utf8');
     const findings = [];
-    const seen = new Set();
-    for (const match of source.matchAll(FA_ICON_CONTEXT_RE)) {
-        const iconName = (_a = match[2]) !== null && _a !== void 0 ? _a : match[4];
-        if (!iconName || FA_FREE_ICON_NAMES.has(iconName))
+    for (const match of source.matchAll(ICON_CONTEXT_RE)) {
+        const value = (_b = (_a = match[2]) !== null && _a !== void 0 ? _a : match[4]) !== null && _b !== void 0 ? _b : match[6];
+        if (!value)
             continue;
-        const dedupeKey = `${iconName}@${match.index}`;
-        if (seen.has(dedupeKey))
-            continue;
-        seen.add(dedupeKey);
         const line = source.slice(0, match.index).split('\n').length;
-        const alternative = FA_PRO_TO_FREE_HINTS.get(iconName);
+        if (value.startsWith('fa-')) {
+            findings.push({
+                check: 'icons/font-awesome',
+                severity: 'warn',
+                file,
+                line,
+                message: `"${value}" is a Font Awesome value. Ekanos draws Phosphor icons; ` +
+                    'this one still renders through a translation table, but may not ' +
+                    'be the glyph you meant.',
+                hint: 'Write the Phosphor name from phosphoricons.com (e.g. "house").',
+            });
+            continue;
+        }
+        if (PHOSPHOR_ICON_NAMES.has(value.replace(/:fill$/, '')))
+            continue;
         findings.push({
-            check: 'icons/pro-only',
+            check: 'icons/unknown',
             severity: 'warn',
             file,
             line,
-            message: `"fa-${iconName}" is not in the Font Awesome Free set. Ekanos itself ` +
-                'loads Font Awesome Pro, so this renders fine there, but the ' +
-                'generated harness (and any other Free-only host) shows the ' +
-                'circle-question placeholder instead of the intended glyph.',
-            hint: alternative
-                ? `Use "fa-${alternative}" instead — the nearest Free equivalent.`
-                : 'Pick a Free icon name — Pro names render as placeholder discs ' +
-                    'outside Pro-licensed hosts.',
+            message: `"${value}" is not a Phosphor icon, so it draws the "shapes" ` +
+                'fallback instead of the glyph you meant.',
+            hint: 'Pick a name from phosphoricons.com (e.g. "house", "caret-down").',
         });
     }
     return findings;

package/dist/icon-findings.js.map

@@ -1 +1 @@
-{"version":3,"file":"icon-findings.js","sourceRoot":"","sources":["../src/icon-findings.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Finding } from '@ekanos/integration-schema';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\n\nimport {\n  FA_FREE_ICON_NAMES,\n  FA_PRO_TO_FREE_HINTS,\n} from './generated/fa-free-names';\n\n/**\n * Flags Font Awesome **Pro**-only `fa-*` icon names in a project's widget\n * source — today this is a silent, runtime-only failure: `@ekanos/ui`'s\n * `Icon` warns once via `console.warn` in dev, but ships nothing to\n * `validate`, so a partner only discovers a Pro-only name when the generated\n * harness (Font Awesome **Free**-only, see `@ekanos/harness`) renders the\n * circle-question fallback in place of the intended glyph — or never\n * discovers it, if nobody was watching the console.\n *\n * `validate` has no live component tree to inspect the way the runtime\n * warning does, and the definition's `component`/`icon` fields are live\n * React values by the time `loadDefinition` resolves them (function\n * references, not paths) — there is no file path to walk back to from an\n * already-imported component. So this scans the project's own `src/**\\/*.{ts,tsx}`\n * on disk instead, the same fallback `collectProjectFindings` would use if it\n * needed source text rather than a loaded value.\n *\n * WARN, not error: a Pro-only name is broken UX in a Free-only host, not an\n * unbuildable submission — plenty of Ekanos-hosted partners run under Pro,\n * where the exact same name renders correctly.\n */\nexport function collectIconFindings(projectDir: string): Finding[] {\n  const srcDir = path.join(projectDir, 'src');\n  if (!fs.existsSync(srcDir)) return [];\n\n  const findings: Finding[] = [];\n  for (const file of walkTsFiles(srcDir)) {\n    findings.push(...collectIconFindingsInFile(file));\n  }\n  return findings;\n}\n\nfunction* walkTsFiles(dir: string): Generator<string> {\n  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {\n    const full = path.join(dir, entry.name);\n    if (entry.isDirectory()) {\n      yield* walkTsFiles(full);\n    } else if (/\\.(ts|tsx)$/.test(entry.name)) {\n      yield full;\n    }\n  }\n}\n\n/**\n * One Font Awesome style-family token, e.g. the `fa-solid` in\n * `\"fa-solid fa-house\"` (the host's icon helper produces exactly this\n * two-token shape). Kept in sync by hand with the host UI package's\n * `FA_ICON_STYLES` — a style name is never itself an icon name, so it must\n * not be treated as one, but that list lives in a browser package this one\n * may not import.\n */\nconst FA_STYLE_TOKEN =\n  '(?:solid|regular|light|thin|duotone|sharp|brands|classic)';\n\n/**\n * A quoted string literal whose ENTIRE contents are a bare `fa-<name>` value\n * or a two-token `fa-<style> fa-<name>` value — anchored to the quote\n * boundaries (the backreference to the opening quote must follow the name\n * pattern immediately) so this cannot match a `fa-`-prefixed SUBSTRING inside\n * a longer, unrelated string.\n *\n * Parameterized on its own backreference number because it is spliced into\n * `FA_ICON_CONTEXT_RE` twice — each copy opens its own capture group, so a\n * hardcoded `\\1` in the second copy would wrongly point at the FIRST copy's\n * quote group instead of its own.\n */\nfunction faIconLiteral(quoteGroup: number): string {\n  return `(['\"\\`])(?:fa-${FA_STYLE_TOKEN}\\\\s+)?fa-([a-z][a-z0-9]*(?:-[a-z0-9]+)*)\\\\${quoteGroup}`;\n}\n\n/**\n * Only literals in a position that plausibly HOLDS an icon name: the `name`/\n * `icon` prop or object key an `<Icon>`, a widget's `category.icon`, or a\n * config object typically uses, or a direct argument to `resolveIcon`/\n * `renderIcon` (`@ekanos/ui`'s runtime helpers).\n *\n * This is a heuristic, not a parser — it will miss an icon name built up any\n * other way (a variable, a template with interpolation, an indirect prop\n * name), and in principle a `name`/`icon` key on some unrelated object could\n * coincidentally hold an `fa-`-shaped string and get flagged. Both failure\n * modes are accepted: a scan that required full TS type information to be\n * exact is not worth the cost here, and this project's own convention names\n * icon props/keys `name` or `icon` specifically to keep that collision rare.\n * Group numbers: 1 = quote, 2 = name for the `name`/`icon` branch; 3 = quote,\n * 4 = name for the `resolveIcon`/`renderIcon` branch.\n */\nconst FA_ICON_CONTEXT_RE = new RegExp(\n  `\\\\b(?:name|icon)\\\\s*[:=]\\\\s*\\\\{?\\\\s*${faIconLiteral(1)}` +\n    `|\\\\b(?:resolveIcon|renderIcon)\\\\(\\\\s*${faIconLiteral(3)}`,\n  'g',\n);\n\nfunction collectIconFindingsInFile(file: string): Finding[] {\n  const source = fs.readFileSync(file, 'utf8');\n  const findings: Finding[] = [];\n  const seen = new Set<string>();\n\n  for (const match of source.matchAll(FA_ICON_CONTEXT_RE)) {\n    const iconName = match[2] ?? match[4];\n    if (!iconName || FA_FREE_ICON_NAMES.has(iconName)) continue;\n\n    const dedupeKey = `${iconName}@${match.index}`;\n    if (seen.has(dedupeKey)) continue;\n    seen.add(dedupeKey);\n\n    const line = source.slice(0, match.index).split('\\n').length;\n    const alternative = FA_PRO_TO_FREE_HINTS.get(iconName);\n\n    findings.push({\n      check: 'icons/pro-only',\n      severity: 'warn',\n      file,\n      line,\n      message:\n        `\"fa-${iconName}\" is not in the Font Awesome Free set. Ekanos itself ` +\n        'loads Font Awesome Pro, so this renders fine there, but the ' +\n        'generated harness (and any other Free-only host) shows the ' +\n        'circle-question placeholder instead of the intended glyph.',\n      hint: alternative\n        ? `Use \"fa-${alternative}\" instead — the nearest Free equivalent.`\n        : 'Pick a Free icon name — Pro names render as placeholder discs ' +\n          'outside Pro-licensed hosts.',\n    });\n  }\n\n  return findings;\n}\n"]}
+{"version":3,"file":"icon-findings.js","sourceRoot":"","sources":["../src/icon-findings.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Finding } from '@ekanos/integration-schema';\nimport * as fs from 'node:fs';\nimport * as path from 'node:path';\n\nimport { PHOSPHOR_ICON_NAMES } from './generated/phosphor-names';\n\n/**\n * Flags icon names in a project's widget source that `@ekanos/ui`'s `Icon`\n * cannot draw. Icons are Phosphor (phosphoricons.com): a name that is not\n * one draws the `shapes` fallback, which nobody notices until a screenshot\n * review. A Font Awesome value from before the move (`fa-house`) still\n * renders through a translation table, but new code should write the\n * Phosphor name.\n *\n * `validate` has no live component tree, and by the time `loadDefinition`\n * resolves a definition its `component`/`icon` fields are live values with\n * no path back to source, so this scans the project's own\n * `src/**\\/*.{ts,tsx}` on disk.\n *\n * WARN, not error: an unknown name is broken UX, not an unbuildable\n * submission.\n */\nexport function collectIconFindings(projectDir: string): Finding[] {\n  const srcDir = path.join(projectDir, 'src');\n  if (!fs.existsSync(srcDir)) return [];\n\n  const findings: Finding[] = [];\n  for (const file of walkTsFiles(srcDir)) {\n    findings.push(...collectIconFindingsInFile(file));\n  }\n  return findings;\n}\n\nfunction* walkTsFiles(dir: string): Generator<string> {\n  for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {\n    const full = path.join(dir, entry.name);\n    if (entry.isDirectory()) {\n      yield* walkTsFiles(full);\n    } else if (/\\.(ts|tsx)$/.test(entry.name)) {\n      yield full;\n    }\n  }\n}\n\n/**\n * A quoted literal whose entire contents could be an icon value: a Phosphor\n * name (`house`, `star:fill`) or a Font Awesome value (`fa-solid fa-house`).\n * Parameterized on its backreference because it is spliced in twice.\n */\nfunction iconLiteral(quoteGroup: number): string {\n  return `(['\"\\`])((?:fa-[a-z]+\\\\s+)?[a-z][a-z0-9]*(?:-[a-z0-9]+)*(?::fill)?)\\\\${quoteGroup}`;\n}\n\n/**\n * Only literals in a position that plausibly holds an icon name: the `icon`\n * prop or key, an `<Icon name=…>`, or a direct argument to `resolveIcon` /\n * `renderIcon`. A heuristic, not a parser: it misses names built any other\n * way. Groups: 1 = quote, 2 = value for the `icon` key; 3/4 for `<Icon\n * name>`; 5/6 for the helper calls.\n */\nconst ICON_CONTEXT_RE = new RegExp(\n  `\\\\bicon\\\\s*[:=]\\\\s*\\\\{?\\\\s*${iconLiteral(1)}` +\n    `|<Icon\\\\b[^>]*?\\\\bname=\\\\{?\\\\s*${iconLiteral(3)}` +\n    `|\\\\b(?:resolveIcon|renderIcon)\\\\(\\\\s*${iconLiteral(5)}`,\n  'g',\n);\n\nfunction collectIconFindingsInFile(file: string): Finding[] {\n  const source = fs.readFileSync(file, 'utf8');\n  const findings: Finding[] = [];\n\n  for (const match of source.matchAll(ICON_CONTEXT_RE)) {\n    const value = match[2] ?? match[4] ?? match[6];\n    if (!value) continue;\n    const line = source.slice(0, match.index).split('\\n').length;\n\n    if (value.startsWith('fa-')) {\n      findings.push({\n        check: 'icons/font-awesome',\n        severity: 'warn',\n        file,\n        line,\n        message:\n          `\"${value}\" is a Font Awesome value. Ekanos draws Phosphor icons; ` +\n          'this one still renders through a translation table, but may not ' +\n          'be the glyph you meant.',\n        hint: 'Write the Phosphor name from phosphoricons.com (e.g. \"house\").',\n      });\n      continue;\n    }\n\n    if (PHOSPHOR_ICON_NAMES.has(value.replace(/:fill$/, ''))) continue;\n\n    findings.push({\n      check: 'icons/unknown',\n      severity: 'warn',\n      file,\n      line,\n      message:\n        `\"${value}\" is not a Phosphor icon, so it draws the \"shapes\" ` +\n        'fallback instead of the glyph you meant.',\n      hint: 'Pick a name from phosphoricons.com (e.g. \"house\", \"caret-down\").',\n    });\n  }\n\n  return findings;\n}\n"]}

package/dist/index.js

@@ -30,7 +30,7 @@ import { runRoutes } from './commands/routes.js';
 import { runApprovals, runRuns } from './commands/runs.js';
 import { runSkills } from './commands/skills.js';
 import { runSources } from './commands/sources.js';
-import { runStatus } from './commands/status.js';
+import { parseTimeoutMinutes, runStatus } from './commands/status.js';
 import { TEAM_AGENT_AREAS, usageFor } from './commands/team-agents.js';
 import { runTeams } from './commands/teams.js';
 import { runTest } from './commands/test.js';
@@ -200,6 +200,14 @@ const COMMAND_SPECS = {
             type: 'boolean',
             description: "Wait until this project's current version reaches a gate verdict",
         },
+        wait: {
+            type: 'boolean',
+            description: 'Same as --watch',
+        },
+        timeout: {
+            type: 'string',
+            description: 'With --watch/--wait: give up after this many minutes (default 30; exit 11)',
+        },
     },
     sources: {
         host: HOST,
@@ -751,6 +759,14 @@ const COMMAND_SPECS = {
             type: 'boolean',
             description: 'In a repo: publish every package',
         },
+        wait: {
+            type: 'boolean',
+            description: 'After submitting, wait for the gate verdict and print its findings (exit 10 if rejected)',
+        },
+        timeout: {
+            type: 'string',
+            description: 'With --wait: give up after this many minutes (default 30; exit 11)',
+        },
     },
     upgrade: {
         dir: DIR,
@@ -843,8 +859,9 @@ const USAGE = [
     '             a compact list of the sources you hold a seat on',
     "  status     Show login state and this project's submissions on the host",
     '             (--findings for full gate findings, --all to expand other',
-    '             integrations in the source, --watch to block until this',
-    "             project's current version reaches a gate verdict)",
+    '             integrations in the source, --watch (or --wait) to block until',
+    "             this project's current version reaches a gate verdict, up to",
+    '             --timeout <minutes>, default 30)',
     '  sources    List every source you hold a developer/source-admin seat on |',
     '             products [--source <slug>] (each product, Experience or',
     '             Integration, and whether it is enabled for the Source) |',
@@ -1105,7 +1122,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',
+    '             (--dry-run gates and packs, sends nothing; --wait [--timeout',
+    '             <minutes>] then waits for the gate verdict).',
     '             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',
@@ -1268,7 +1287,8 @@ export async function run(argv, options = {}) {
                     env,
                     findings: parsed.flags.findings === true,
                     all: parsed.flags.all === true,
-                    watch: parsed.flags.watch === true,
+                    watch: parsed.flags.watch === true || parsed.flags.wait === true,
+                    timeoutMinutes: parseTimeoutMinutes(parsed.flags.timeout),
                     sleep: options.sleep,
                     now: options.now,
                 });
@@ -1506,6 +1526,9 @@ export async function run(argv, options = {}) {
                     dryRun: parsed.flags['dry-run'] === true,
                     packages: parsed.positionals,
                     all: parsed.flags.all === true,
+                    wait: parsed.flags.wait === true,
+                    timeoutMinutes: parseTimeoutMinutes(parsed.flags.timeout),
+                    sleep: options.sleep,
                     env,
                     stdinIsTTY: options.stdinIsTTY,
                     confirm: options.confirm,