@north-light/crouter 0.3.180 → 0.3.182

package/dist/commands/pkg/market-manage.js

@@ -9,6 +9,44 @@ import { pathExists, ensureDir, removePath, isSymlink, nowIso } from '../../core
 import { clone, pull, deriveNameFromUrl, currentSha, isGitRepo } from '../../core/git.js';
 import { readMarketplaceManifest } from '../../core/manifest.js';
 import { resolveInstallScope } from './shared.js';
+/** Clone a marketplace repo into `scope` and register it in that scope's
+ *  config. Shared by the `pkg market add` leaf and `crtr sys setup`, which
+ *  offers the official marketplace as a checked-by-default entry. */
+export function addMarketplace(opts) {
+    const { url, ref, scope } = opts;
+    const root = requireScopeRoot(scope);
+    ensureScopeInitialized(scope, root);
+    const tempName = deriveNameFromUrl(url);
+    const mktsDir = join(root, 'marketplaces');
+    ensureDir(mktsDir);
+    const tempDest = join(mktsDir, tempName);
+    if (pathExists(tempDest)) {
+        removePath(tempDest);
+    }
+    clone(url, tempDest, { depth: 1, ref: ref !== undefined ? ref : undefined });
+    const manifest = readMarketplaceManifest(tempDest);
+    if (!manifest) {
+        removePath(tempDest);
+        throw notFound(`marketplace manifest not found at ${tempDest}/.crouter-marketplace/marketplace.json — not a valid marketplace`);
+    }
+    const finalName = manifest.name;
+    const finalDest = join(mktsDir, finalName);
+    if (finalName !== tempName) {
+        if (pathExists(finalDest)) {
+            removePath(finalDest);
+        }
+        renameSync(tempDest, finalDest);
+    }
+    const effectiveRef = ref !== undefined ? ref : 'main';
+    updateConfig(scope, (cfg) => {
+        cfg.marketplaces[finalName] = {
+            url,
+            ref: effectiveRef,
+            installed_at: nowIso(),
+        };
+    });
+    return { name: finalName, scope, path: finalDest };
+}
 export const marketAdd = defineLeaf({
     name: 'add',
     description: 'add a marketplace by git URL',
@@ -33,39 +71,7 @@ export const marketAdd = defineLeaf({
         const url = input['url'];
         const ref = input['ref'];
         const scopeInput = input['scope'];
-        const scope = resolveInstallScope(scopeInput);
-        const root = requireScopeRoot(scope);
-        ensureScopeInitialized(scope, root);
-        const tempName = deriveNameFromUrl(url);
-        const mktsDir = join(root, 'marketplaces');
-        ensureDir(mktsDir);
-        const tempDest = join(mktsDir, tempName);
-        if (pathExists(tempDest)) {
-            removePath(tempDest);
-        }
-        clone(url, tempDest, { depth: 1, ref: ref !== undefined ? ref : undefined });
-        const manifest = readMarketplaceManifest(tempDest);
-        if (!manifest) {
-            removePath(tempDest);
-            throw notFound(`marketplace manifest not found at ${tempDest}/.crouter-marketplace/marketplace.json — not a valid marketplace`);
-        }
-        const finalName = manifest.name;
-        const finalDest = join(mktsDir, finalName);
-        if (finalName !== tempName) {
-            if (pathExists(finalDest)) {
-                removePath(finalDest);
-            }
-            renameSync(tempDest, finalDest);
-        }
-        const effectiveRef = ref !== undefined ? ref : 'main';
-        updateConfig(scope, (cfg) => {
-            cfg.marketplaces[finalName] = {
-                url,
-                ref: effectiveRef,
-                installed_at: nowIso(),
-            };
-        });
-        return { name: finalName, scope, path: finalDest };
+        return addMarketplace({ url, ref, scope: resolveInstallScope(scopeInput) });
     },
 });
 export const marketRemove = defineLeaf({

package/dist/commands/pkg/plugin-inspect.js

@@ -4,7 +4,7 @@ import { paginate } from '../../core/pagination.js';
 import { listInstalledPlugins, findPluginByName, } from '../../core/resolver.js';
 import { listPluginMemoryDocs } from '../../core/memory-resolver.js';
 import { validatePluginCommands, validateEffectiveCommandPlugins } from '../../core/command-plugins/discovery.js';
-import { SUBTREE_NAMES } from '../../build-root.js';
+import { SUBTREE_NAMES, coreCommandPaths } from '../../build-root.js';
 import { resolveScopeArg, projectScopeRoot } from '../../core/scope.js';
 export const pluginList = defineLeaf({
     name: 'list',
@@ -120,13 +120,14 @@ export const pluginShow = defineLeaf({
         let commands;
         if (typeof found.manifest.commands === 'string' && found.manifest.commands.length > 0) {
             const reserved = new Set(SUBTREE_NAMES);
+            const corePaths = await coreCommandPaths();
             // Validate against the whole effective set so cross-plugin top-level
             // name collisions show up in this plugin's issues (a collided command is
             // NOT mounted). A copy outside the effective set (disabled, or shadowed
             // by a higher-precedence copy) cannot collide, so the per-plugin
             // validator is exact for it.
-            const v = validateEffectiveCommandPlugins(reserved).find((x) => x.plugin.root === found.root) ??
-                validatePluginCommands(found, reserved);
+            const v = validateEffectiveCommandPlugins(reserved, undefined, undefined, corePaths).find((x) => x.plugin.root === found.root) ??
+                validatePluginCommands(found, reserved, corePaths);
             commands = {
                 manifestPath: v.manifestPath,
                 mounts: v.contributions.map((c) => c.node.name),

package/dist/commands/pkg/plugin-manage.js

@@ -13,22 +13,23 @@ import { validatePluginCommands, validateEffectiveCommandPlugins } from '../../c
 import { normalizeEndpoint, validateEndpoint, validateHttpPluginTransport } from '../../core/command-plugins/endpoint.js';
 import { validatePluginBundle } from '../../core/command-plugins/bundle.js';
 import { fetchHttpPluginBundle } from '../../core/command-plugins/transport/http-fetch.js';
-import { SUBTREE_NAMES } from '../../build-root.js';
+import { SUBTREE_NAMES, coreCommandPaths } from '../../build-root.js';
 import { isGitUrl, setPluginEnabled, resolveInstallScope } from './shared.js';
 /** Validate a just-installed/updated plugin's command manifest, if it declares
  *  one. Returns undefined for plugins without a `commands` pointer. Never
  *  executes the plugin binary — validation is fully static. */
-function commandReport(name, scope) {
+async function commandReport(name, scope) {
     const plugin = findPluginByName(name, scope);
     if (plugin === null || typeof plugin.manifest.commands !== 'string' || plugin.manifest.commands.length === 0) {
         return undefined;
     }
     const reserved = new Set(SUBTREE_NAMES);
+    const corePaths = await coreCommandPaths();
     // Report from the effective set so a cross-plugin top-level collision is
     // visible at install time (a collided command is NOT mounted). A copy
     // outside the effective set (disabled, or shadowed) cannot collide.
-    const v = validateEffectiveCommandPlugins(reserved).find((x) => x.plugin.root === plugin.root) ??
-        validatePluginCommands(plugin, reserved);
+    const v = validateEffectiveCommandPlugins(reserved, undefined, undefined, corePaths).find((x) => x.plugin.root === plugin.root) ??
+        validatePluginCommands(plugin, reserved, corePaths);
     return { mounts: v.contributions.map((c) => c.node.name), issues: v.issues };
 }
 const PLUGIN_NAME_RE = /^[a-z][a-z0-9]*(-[a-z0-9]+)*$/;
@@ -65,9 +66,9 @@ function writeStagedBundle(stagingRoot, manifest, bundle) {
         writeFileSync(target, document.bytes);
     }
 }
-function validateStagedBundle(name, scope, root, manifest) {
+async function validateStagedBundle(name, scope, root, manifest) {
     const staged = { name, scope, root, manifest, enabled: true };
-    const validation = validatePluginCommands(staged, new Set(SUBTREE_NAMES));
+    const validation = validatePluginCommands(staged, new Set(SUBTREE_NAMES), await coreCommandPaths());
     if (validation.issues.length > 0) {
         throw general(`bundle staged package for "${name}" is invalid`, { issues: validation.issues });
     }
@@ -104,7 +105,7 @@ async function replaceBundlePlugin(name, bundleSource, scope, options) {
             throw network(message);
         throw general(message);
     }
-    const validated = await validatePluginBundle(fetched.raw, { reservedCoreNames: new Set(SUBTREE_NAMES) });
+    const validated = await validatePluginBundle(fetched.raw, { reservedCoreNames: new Set(SUBTREE_NAMES), coreCommandPaths: await coreCommandPaths() });
     if (validated.bundle === undefined)
         throw general(`HTTP plugin bundle for "${name}" is invalid`, { issues: validated.issues });
     const version = createHash('sha256').update(fetched.raw).digest('hex').slice(0, 12);
@@ -126,7 +127,7 @@ async function replaceBundlePlugin(name, bundleSource, scope, options) {
     try {
         ensureDir(staging);
         writeStagedBundle(staging, manifest, validated.bundle);
-        validateStagedBundle(name, scope, staging, manifest);
+        await validateStagedBundle(name, scope, staging, manifest);
         let movedPrevious = false;
         if (pathExists(root)) {
             renameSync(root, previous);
@@ -155,7 +156,7 @@ async function replaceBundlePlugin(name, bundleSource, scope, options) {
             state.plugins[name] = {};
         state.plugins[name].last_updated = nowIso();
     });
-    const commands = commandReport(name, scope);
+    const commands = await commandReport(name, scope);
     if (commands === undefined)
         throw general(`bundle plugin "${name}" has no staged command report`);
     return { name, scope, path: root, transport: 'http', version, docs: validated.bundle.memory.length, commands };
@@ -368,7 +369,7 @@ async function updateOnePlugin(plugin, marketplaceCache, opts) {
     }
     const manifest = readPluginManifest(plugin.root);
     updatePluginVersion(plugin.scope, plugin.name, marketplaceVersion ?? manifest?.version);
-    const commands = commandReport(plugin.name, plugin.scope);
+    const commands = await commandReport(plugin.name, plugin.scope);
     return {
         name: plugin.name,
         ...(plugin.manifest.transport !== undefined ? { transport: plugin.manifest.transport.kind } : {}),
@@ -435,7 +436,7 @@ export const pluginInstall = defineLeaf({
             : classified.kind === 'local' ? installFromLocal(classified.value, scope)
                 : installFromGit(classified.value, gitRef, scope);
         const plugin = findPluginByName(installed.name, installed.scope);
-        const commands = commandReport(installed.name, installed.scope);
+        const commands = await commandReport(installed.name, installed.scope);
         return {
             ...installed,
             ...(plugin?.manifest.transport !== undefined ? { transport: plugin.manifest.transport.kind } : {}),

package/dist/commands/surface/node/focus.js

@@ -1,7 +1,6 @@
 // `crtr surface node focus` — bring one viewer forward.
 import { defineLeaf } from '../../../core/command.js';
 import { InputError } from '../../../core/io.js';
-import { inboxHint } from '../../../core/keybindings/index.js';
 import { cliClient, rethrowAsCliError } from '../../api-client.js';
 import { currentTmux, displayPopup, focusViewer, shellQuote } from './placement.js';
 export const surfaceNodeFocusLeaf = defineLeaf({
@@ -39,7 +38,7 @@ export const surfaceNodeFocusLeaf = defineLeaf({
             throw new InputError({
                 error: 'not_focusable',
                 message: `node ${id} is a human-ask (kind:human), not a conversation — it has no pi session to focus.`,
-                next: `The pending question is queued for the human (${inboxHint()} opens the inbox); see it with \`crtr human list\`, or retract it with \`crtr human cancel ${id}\`.`,
+                next: `The pending question is queued for the human; see it with \`crtr human list\`, or retract it with \`crtr human cancel ${id}\`.`,
             });
         }
         // Opening history is not resuming work. A terminal/canceled/crashed node has

package/dist/commands/sys/doctor.js

@@ -13,7 +13,7 @@ import { readFault } from '../../core/runtime/fault.js';
 import { detectNerdFont, nerdFontInstallCommand, NERD_FONT_SELECT_HINT } from '../../core/runtime/nerd-font.js';
 import { detectPackageManager } from './setup-core.js';
 import { validateEffectiveCommandPlugins } from '../../core/command-plugins/discovery.js';
-import { SUBTREE_NAMES } from '../../build-root.js';
+import { SUBTREE_NAMES, coreCommandPaths } from '../../build-root.js';
 import { processGeneration, processLocatedGeneration, runtimeManifest, selectedGeneration } from './shared.js';
 function pass(scope, name, message) {
     return { scope, name, status: 'pass', message };
@@ -109,14 +109,14 @@ function faultRemediation(fault, nodeId) {
  * disable/update/remove the plugin). Only plugins whose scope is in `scopes`
  * are reported, so `--scope` narrows these checks too.
  */
-function runCommandPluginChecks(scopes) {
+async function runCommandPluginChecks(scopes) {
     const results = [];
     const inScope = new Set(scopes);
     const reserved = new Set(SUBTREE_NAMES);
     // Validate the whole effective set together so cross-plugin top-level name
     // collisions surface here — a collided command is NOT mounted, and every
     // claimant must fail, not pass.
-    for (const v of validateEffectiveCommandPlugins(reserved)) {
+    for (const v of validateEffectiveCommandPlugins(reserved, undefined, undefined, await coreCommandPaths())) {
         const plugin = v.plugin;
         if (!inScope.has(plugin.scope))
             continue;
@@ -442,7 +442,7 @@ export const sysDoctorLeaf = defineLeaf({
         }
         if (scopes.includes('user'))
             allResults.push(runNerdFontCheck());
-        allResults.push(...runCommandPluginChecks(scopes));
+        allResults.push(...await runCommandPluginChecks(scopes));
         allResults.push(...await runFaultChecks());
         const processLocation = processGeneration();
         allResults.push(...await generationChecks('selected', selectedGeneration(), processLocation === null));

package/dist/commands/sys/setup-core.d.ts

@@ -1,16 +1,20 @@
 import { type BindingId, type BindingResolution, type KeybindingDiagnostic, type SparseKeybindingOverrides } from '../../core/keybindings/index.js';
-export type SetupPackageId = 'crtr-extensions' | 'oauth-adapter' | 'capture-plugin';
+export declare const OFFICIAL_MARKETPLACE_NAME = "crouter-official-marketplace";
+export declare const OFFICIAL_MARKETPLACE_URL = "https://github.com/crouton-labs/crouter-official-marketplace.git";
+export declare const OFFICIAL_MARKETPLACE_REF = "main";
+export type SetupPackageId = 'official-marketplace' | 'crtr-extensions' | 'oauth-adapter' | 'capture-plugin';
 /** `nerd-font` is not a command on PATH like the other two — it is an installed
  *  font face, detected by fontconfig/font-directory scan. The viewer renders
  *  every tool and command icon with Nerd Font codepoints, so without it a fresh
  *  machine shows tofu boxes. */
 export type SetupTool = 'tmux' | 'nvim' | 'nerd-font';
-/** `marketplace-plugin` installs a crtr plugin from a registered marketplace
- *  (`installSource` is a `<marketplace>/<plugin>` ref) instead of running the
- *  bundled pi CLI. Offered in setup and NOT installed by first-run bootstrap:
- *  an install that never runs setup — a Northlight guest image, CI — should not
- *  carry a command whose external binary it lacks. */
-export type SetupPackageSourceKind = 'local-path' | 'npm' | 'marketplace-plugin';
+/** `marketplace-source` clones and registers a marketplace repo
+ *  (`installSource` is its git URL); `marketplace-plugin` installs one plugin
+ *  from a registered marketplace (`installSource` is a `<marketplace>/<plugin>`
+ *  ref). Neither runs the bundled pi CLI, and neither happens anywhere but
+ *  setup: an install that never runs setup — a Northlight guest image, CI —
+ *  fetches no catalog and carries no command whose external binary it lacks. */
+export type SetupPackageSourceKind = 'local-path' | 'npm' | 'marketplace-source' | 'marketplace-plugin';
 export type SetupPackageIdentity = string;
 export type PackageManager = 'brew' | 'apt-get' | 'dnf' | 'pacman' | 'manual';
 export interface SetupPackageManifestEntry {
@@ -83,6 +87,9 @@ export declare class SetupKeybindingsDraft {
     markSaved(overrides: SparseKeybindingOverrides<BindingId>, tmuxPassthrough?: readonly BindingId[]): void;
 }
 export declare function buildSetupManifest(resolveBuiltinPackageDir?: (name: string) => string): SetupPackageManifestEntry[];
+/** One-line description of what installing an entry will actually run — the
+ *  wizard's confirm step and the non-TTY dump both show it. */
+export declare function packagePlanAction(entry: SetupPackageManifestEntry): string;
 export declare function normalizePackageIdentity(source: string, settingsDir: string, homeDir: string): SetupPackageIdentity;
 export declare function detectInstalledSetupPackageIds(settingsJson: unknown, manifest?: SetupPackageManifestEntry[], settingsPath?: string, homeDir?: string): Set<SetupPackageId>;
 export declare function detectCommandOnPath(command: string): boolean;

package/dist/commands/sys/setup-core.js

@@ -13,8 +13,12 @@ import { normalizeTmuxPassthrough } from '../../core/config.js';
 import { detectNerdFont, nerdFontInstallCommand, NERD_FONT_SELECT_HINT } from '../../core/runtime/nerd-font.js';
 import { ensureRenderer, isRendererReady } from '../../core/termrender/termrender.js';
 import { installFromMarketplace } from '../pkg/plugin-manage.js';
-import { findPluginByName } from '../../core/resolver.js';
+import { addMarketplace } from '../pkg/market-manage.js';
+import { findPluginByName, findMarketplaceByName } from '../../core/resolver.js';
 import { expandTilde } from '../../core/fs-utils.js';
+export const OFFICIAL_MARKETPLACE_NAME = 'crouter-official-marketplace';
+export const OFFICIAL_MARKETPLACE_URL = 'https://github.com/crouton-labs/crouter-official-marketplace.git';
+export const OFFICIAL_MARKETPLACE_REF = 'main';
 function isKeybindingsObject(value) {
     return value !== null && typeof value === 'object' && !Array.isArray(value);
 }
@@ -169,6 +173,11 @@ export class SetupKeybindingsDraft {
     }
 }
 const PACKAGE_COPY = {
+    'official-marketplace': {
+        name: OFFICIAL_MARKETPLACE_NAME,
+        shortDescription: 'the official crtr plugin catalog — registered as a source so its plugins are installable by ref.',
+        longDescription: 'Shallow-clones github.com/crouton-labs/crouter-official-marketplace into the user scope and registers it, which is what makes `crtr pkg plugin install crouter-official-marketplace/<name>` resolve and what fills `crtr pkg market browse`. Registering the source installs no plugin by itself. Uncheck it on a machine that should reach no external catalog — a plugin selected below still registers the marketplace it comes from, because its ref cannot resolve otherwise.',
+    },
     'crtr-extensions': {
         name: 'pi-crtr-extensions',
         shortDescription: 'crtr companion extensions — command palette, help gating, statusline, subscription/OAuth rotation, nested context.',
@@ -186,17 +195,22 @@ const PACKAGE_COPY = {
     },
 };
 const PACKAGE_SOURCES = {
+    'official-marketplace': { kind: 'marketplace-source', source: OFFICIAL_MARKETPLACE_URL },
     'crtr-extensions': { kind: 'local-path', source: builtinPiPackageDir('pi-crtr-extensions') },
     'oauth-adapter': { kind: 'npm', source: 'npm:pi-claude-oauth-adapter@0.1.2' },
     'capture-plugin': { kind: 'marketplace-plugin', source: 'crouter-official-marketplace/capture' },
 };
 const LOCAL_PACKAGE_NAME_ALIASES = {
+    'official-marketplace': [],
     'crtr-extensions': ['pi-crtr-extensions'],
     'oauth-adapter': [],
     'capture-plugin': [],
 };
 export function buildSetupManifest(resolveBuiltinPackageDir = builtinPiPackageDir) {
+    // Order matters at execution: the marketplace source registers before the
+    // plugin whose ref needs it.
     return [
+        'official-marketplace',
         'crtr-extensions',
         'oauth-adapter',
         'capture-plugin',
@@ -215,6 +229,18 @@ export function buildSetupManifest(resolveBuiltinPackageDir = builtinPiPackageDi
         };
     });
 }
+/** One-line description of what installing an entry will actually run — the
+ *  wizard's confirm step and the non-TTY dump both show it. */
+export function packagePlanAction(entry) {
+    switch (entry.sourceKind) {
+        case 'marketplace-source':
+            return `clone + register ${entry.installSource}`;
+        case 'marketplace-plugin':
+            return `crtr pkg plugin install ${entry.installSource}`;
+        default:
+            return `pi install ${entry.installSource}`;
+    }
+}
 function npmPackageName(source) {
     if (!source.startsWith('npm:'))
         return null;
@@ -390,7 +416,7 @@ export function buildSetupInitialState(opts = {}) {
     const manifest = opts.manifest ?? buildSetupManifest(builtinPiPackageDir);
     const settingsJson = readJsonIfExists(settingsPath);
     const installedPackageIds = detectInstalledSetupPackageIds(settingsJson, manifest, settingsPath, homeDir);
-    for (const id of detectInstalledMarketplacePlugins(manifest))
+    for (const id of detectInstalledMarketplaceEntries(manifest))
         installedPackageIds.add(id);
     const commandExists = opts.commandExists ?? detectCommandOnPath;
     const packageManager = opts.packageManager ?? detectPackageManager(process.platform, commandExists);
@@ -468,21 +494,37 @@ export function formatSetupExecutionSummary(summary) {
         summary.exaKeyWritten ? `exa key written: ${summary.exaKeyPath}` : 'exa key written: no',
     ].join('\n') + '\n';
 }
-/** Marketplace-plugin manifest entries already installed in any scope — the
- *  plugin registry is their install record, not pi's settings.json. */
-function detectInstalledMarketplacePlugins(manifest) {
+/** Marketplace manifest entries already present in any scope — the marketplace
+ *  and plugin registries are their install record, not pi's settings.json. */
+function detectInstalledMarketplaceEntries(manifest) {
     const installed = [];
     for (const entry of manifest) {
-        if (entry.sourceKind !== 'marketplace-plugin')
-            continue;
         try {
-            if (findPluginByName(entry.name) !== null)
-                installed.push(entry.id);
+            if (entry.sourceKind === 'marketplace-source') {
+                if (findMarketplaceByName(entry.name) !== null)
+                    installed.push(entry.id);
+            }
+            else if (entry.sourceKind === 'marketplace-plugin') {
+                if (findPluginByName(entry.name) !== null)
+                    installed.push(entry.id);
+            }
         }
         catch { /* unreadable scope config — treat as not installed */ }
     }
     return installed;
 }
+/** A `<marketplace>/<plugin>` ref only resolves once its marketplace is
+ *  registered, so selecting a plugin selects its source. Returns the
+ *  marketplace name when this call registered it. */
+function ensureMarketplaceRegistered(name) {
+    if (findMarketplaceByName(name) !== null)
+        return null;
+    if (name !== OFFICIAL_MARKETPLACE_NAME) {
+        throw new Error(`marketplace not registered: ${name}`);
+    }
+    addMarketplace({ url: OFFICIAL_MARKETPLACE_URL, ref: OFFICIAL_MARKETPLACE_REF, scope: 'user' });
+    return name;
+}
 export async function executeSetupSubmission(submission) {
     const installedPackages = [];
     const skippedPackages = [];
@@ -493,15 +535,28 @@ export async function executeSetupSubmission(submission) {
             skippedPackages.push(`${entry.name} (already installed)`);
             continue;
         }
+        // A marketplace that will not clone or refresh (offline, diverged cache,
+        // moved repo) must not abort the rest of setup.
+        if (entry.sourceKind === 'marketplace-source') {
+            try {
+                addMarketplace({ url: entry.installSource, ref: OFFICIAL_MARKETPLACE_REF, scope: 'user' });
+                installedPackages.push(entry.name);
+            }
+            catch (e) {
+                skippedPackages.push(`${entry.name} (${e instanceof Error ? e.message : String(e)})`);
+            }
+            continue;
+        }
         if (entry.sourceKind === 'marketplace-plugin') {
             const [marketplace, plugin] = entry.installSource.split('/');
             try {
+                const registered = ensureMarketplaceRegistered(marketplace);
+                if (registered !== null)
+                    installedPackages.push(registered);
                 installFromMarketplace({ marketplace: marketplace, plugin: plugin }, 'user');
                 installedPackages.push(entry.name);
             }
             catch (e) {
-                // A marketplace that will not refresh (offline, diverged cache) must not
-                // abort the rest of setup.
                 skippedPackages.push(`${entry.name} (${e instanceof Error ? e.message : String(e)})`);
             }
             continue;

package/dist/commands/sys/setup-wizard.js

@@ -7,7 +7,7 @@
 // confirmed install, that one is a persistent editor that saves as you go.
 import { matchesKey, truncateToWidth, visibleWidth, } from "@earendil-works/pi-tui";
 import { formatGesture, matchesPiTuiInput, } from "../../core/keybindings/index.js";
-import { buildSetupInitialState, executeSetupSubmission, formatSetupExecutionSummary, reconcileInboxFrontDoor, renderSetupStaticInstructions, resolveExaKeyPath, } from "./setup-core.js";
+import { buildSetupInitialState, executeSetupSubmission, formatSetupExecutionSummary, packagePlanAction, reconcileInboxFrontDoor, renderSetupStaticInstructions, resolveExaKeyPath, } from "./setup-core.js";
 import { runSetupSettingsProcess } from "./setup-settings-runner.js";
 import { DependenciesPanel } from "./panels/dependencies-panel.js";
 import { KeysPanel } from "./panels/keys-panel.js";
@@ -239,7 +239,7 @@ export class SetupWizard {
         if (submission.packages.length) {
             out.push(truncateToWidth(theme.fg("accent", "Packages"), width));
             for (const entry of submission.packages)
-                out.push(truncateToWidth(`  \u2022 ${entry.name} ${theme.fg("dim", "\u2192")} ${this.installedPackageIds.has(entry.id) ? theme.fg("success", "skip (already installed)") : theme.fg("muted", `pi install ${entry.installSource}`)}`, width));
+                out.push(truncateToWidth(`  \u2022 ${entry.name} ${theme.fg("dim", "\u2192")} ${this.installedPackageIds.has(entry.id) ? theme.fg("success", "skip (already installed)") : theme.fg("muted", packagePlanAction(entry))}`, width));
         }
         if (submission.systemDeps.length) {
             out.push(truncateToWidth(theme.fg("accent", "System deps"), width));

package/dist/commands/sys/setup.js

@@ -23,7 +23,7 @@ export const sysSetupLeaf = defineLeaf({
             'Opens a four-step pi-tui installer. Step one logs in to a model provider (pi\'s real OAuth/API-key flow, same as in-app /login) so a fresh install has credentials before running any node.',
             'The remaining steps collect companion package installs, system dependency installs, and an Exa API key, then confirm them all at once.',
             'Runs the bundled pi CLI to install the selected companion packages, writes EXA_API_KEY to ~/.crouter/exa.key when provided, and prints a summary.',
-            'The companion-package list includes crtr marketplace plugins (currently `capture`), checked by default and installed into the user scope when left checked. An unreachable marketplace is reported as skipped rather than failing setup.',
+            'The companion-package list includes the official crtr marketplace and the plugins installed from it (currently `capture`), all checked by default and registered or installed into the user scope when left checked. Nothing else registers a marketplace, so an install that never runs setup fetches no catalog. An unreachable marketplace is reported as skipped rather than failing setup.',
             'On every invocation (best-effort, idempotent), refreshes crouter-owned tmux bindings and registers known nodes\' interaction roots so resolved tickets can call back into the asking node. The inbox popup toggle is a crouter-owned keybinding, editable on the keybindings tab.',
         ],
     },

package/dist/core/__tests__/cron-held-settlement.test.d.ts

@@ -0,0 +1 @@
+export {};