@north-light/crouter 0.3.184 → 0.3.186

package/dist/commands/memory/list.js

@@ -22,9 +22,13 @@ export function listMemoryDocs(kindFilter, scopeFilter, quiet = false, docs = li
         if (kindFilter !== undefined && sub.kind !== kindFilter)
             continue;
         // A directory INDEX surfaces as a dir entry: its dir path with a trailing
-        // slash, flagged is_dir, so the inventory distinguishes it from a doc.
+        // slash, flagged is_dir, so the inventory distinguishes it from a doc. A
+        // store-root INDEX has no dir path, so it keeps its canonical `INDEX`
+        // name — every name in this column must be one `crtr memory read` and a
+        // `[[link]]` accept, and a bare `/` is neither.
         const isDir = isIndexName(sub.name);
-        const name = isDir ? indexDirOf(sub.name) + '/' : sub.name;
+        const dirPath = isDir ? indexDirOf(sub.name) : '';
+        const name = dirPath === '' ? sub.name : dirPath + '/';
         addItem({ name, kind: sub.kind, scope: sub.scope, path: sub.path, shortForm: sub.shortForm, isDir, slash: sub.slash });
     }
     items.sort((a, b) => {
@@ -53,7 +57,7 @@ export const listLeaf = defineLeaf({
             { kind: 'flag', name: 'cursor', type: 'string', required: false, constraint: 'Opaque token from next_cursor. Omit on first call.' },
         ],
         output: [
-            { name: 'items', type: 'object[]', required: true, constraint: 'One row per document: {name, short_form, kind, scope, is_dir}. path is included only with --paths. A directory INDEX.md surfaces as a dir entry (is_dir true, name = the directory path with a trailing slash); is_dir is false for an ordinary doc. short_form is the abbreviated hook — shown here and nowhere else. Sorted by scope then kind then name ascending.' },
+            { name: 'items', type: 'object[]', required: true, constraint: 'One row per document: {name, short_form, kind, scope, is_dir}. path is included only with --paths. A directory INDEX.md surfaces as a dir entry (is_dir true, name = the directory path with a trailing slash, or `INDEX` for a store-root INDEX that has no directory path); is_dir is false for an ordinary doc. Every name is readable as-is with `crtr memory read`. short_form is the abbreviated hook — shown here and nowhere else. Sorted by scope then kind then name ascending.' },
             { name: 'next_cursor', type: 'string | null', required: true, constraint: 'Opaque token for the next page; null means no more items.' },
             { name: 'total', type: 'integer | null', required: true, constraint: 'Exact total across all pages when cheap to compute (always cheap here); never null in practice for this leaf.' },
             { name: 'follow_up', type: 'string', required: true, constraint: 'Concrete next commands — read a document in full or narrow the inventory.' },

package/dist/commands/pkg/browse/actions.d.ts

@@ -0,0 +1,7 @@
+import type { ActionPresentation, ActionRequest, ActionOutcome } from "./model.js";
+/** How an action reads before it runs — and whether it needs confirming. */
+export declare function presentAction(request: ActionRequest): ActionPresentation;
+/** Actions available for a request's subject right now, in offer order. */
+export declare function availableActions(request: Pick<ActionRequest, "entry" | "marketplace" | "scope">): ActionRequest[];
+/** Run one action. Never throws: a failure comes back as `ok: false`. */
+export declare function runAction(request: ActionRequest): Promise<ActionOutcome>;

package/dist/commands/pkg/browse/actions.js

@@ -0,0 +1,199 @@
+// Mutations for `crtr pkg browse`. Each action delegates to the same leaf the
+// CLI runs, so the browser and `crtr pkg …` can never drift.
+import { marketAdd, marketRemove, marketUpdate } from "../market-manage.js";
+import { pluginDisable, pluginEnable, pluginInstall, pluginRemove, pluginUpdate, } from "../plugin-manage.js";
+import { listAllMarketplaces } from "../../../core/resolver.js";
+import { projectScopeRoot } from "../../../core/scope.js";
+function pluginName(request) {
+    return request.entry?.name ?? "plugin";
+}
+function marketplaceName(request) {
+    return request.marketplace ?? "marketplace";
+}
+/** How an action reads before it runs — and whether it needs confirming. */
+export function presentAction(request) {
+    switch (request.kind) {
+        case "install": {
+            const scope = request.scope ?? "user";
+            return { label: `Install into ${scope} scope`, progress: `Installing ${pluginName(request)}…` };
+        }
+        case "remove":
+            return {
+                label: `Remove ${pluginName(request)}`,
+                progress: `Removing ${pluginName(request)}…`,
+                confirm: `Remove ${pluginName(request)} and delete its files?`,
+            };
+        case "enable":
+            return { label: `Enable ${pluginName(request)}`, progress: `Enabling ${pluginName(request)}…` };
+        case "disable":
+            return { label: `Disable ${pluginName(request)}`, progress: `Disabling ${pluginName(request)}…` };
+        case "update":
+            return { label: `Update ${pluginName(request)}`, progress: `Updating ${pluginName(request)}…` };
+        case "market-add":
+            return {
+                label: "Add marketplace",
+                progress: `Adding ${request.url ?? "marketplace"}…`,
+            };
+        case "market-update":
+            return { label: `Update ${marketplaceName(request)}`, progress: `Updating ${marketplaceName(request)}…` };
+        case "market-remove":
+            return {
+                label: `Remove ${marketplaceName(request)}`,
+                progress: `Removing ${marketplaceName(request)}…`,
+                confirm: `Remove ${marketplaceName(request)} and its sourced plugins?`,
+            };
+    }
+    return { label: "Run action", progress: "Running action…" };
+}
+/** Actions available for a request's subject right now, in offer order. */
+export function availableActions(request) {
+    if (request.entry !== undefined) {
+        const { entry } = request;
+        if (entry.install.kind === "absent") {
+            return [
+                { kind: "install", entry, scope: "user" },
+                ...(projectScopeRoot() === null ? [] : [{ kind: "install", entry, scope: "project" }]),
+            ];
+        }
+        const actions = [
+            { kind: entry.install.enabled ? "disable" : "enable", entry },
+        ];
+        if (entry.install.scope !== "builtin")
+            actions.push({ kind: "remove", entry });
+        if (entry.install.updateAvailable)
+            actions.push({ kind: "update", entry });
+        return actions;
+    }
+    if (request.marketplace !== undefined) {
+        const matching = marketplacesNamed(request.marketplace);
+        const scope = matching.length === 1 ? matching[0].scope : request.scope;
+        return [
+            ...(scope === undefined ? [] : [{ kind: "market-update", marketplace: request.marketplace, scope }]),
+            ...(scope === undefined ? [] : [{ kind: "market-remove", marketplace: request.marketplace, scope }]),
+        ];
+    }
+    return [];
+}
+function marketplacesNamed(name) {
+    try {
+        return listAllMarketplaces().filter((marketplace) => marketplace.name === name);
+    }
+    catch {
+        return [];
+    }
+}
+function asRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
+}
+function strings(value) {
+    return Array.isArray(value) ? value.filter((item) => typeof item === "string") : [];
+}
+function commandDetail(value) {
+    const commands = asRecord(value);
+    const mounts = strings(commands["mounts"]);
+    const issues = Array.isArray(commands["issues"]) ? commands["issues"] : [];
+    return [
+        ...mounts.map((mount) => `Mounted: crtr ${mount}`),
+        ...issues.map((issue) => {
+            const detail = asRecord(issue);
+            const message = detail["message"];
+            return `Command issue: ${typeof message === "string" ? message : "invalid command manifest"}`;
+        }),
+    ];
+}
+function updateDetail(value, noun) {
+    const updated = Array.isArray(asRecord(value)["updated"]) ? asRecord(value)["updated"] : [];
+    return updated.flatMap((item) => {
+        const result = asRecord(item);
+        const name = typeof result["name"] === "string" ? result["name"] : noun.toLowerCase();
+        const sha = typeof result["sha"] === "string" && result["sha"] !== "" ? ` at ${result["sha"].slice(0, 12)}` : "";
+        const state = result["updated"] === true ? `${noun} ${name} updated${sha}.` : `${noun} ${name} is already current${sha}.`;
+        return [state, ...commandDetail(result["commands"]), ...(typeof result["error"] === "string" ? [`${noun} ${name}: ${result["error"]}`] : [])];
+    });
+}
+function missing(message) {
+    return { ok: false, message };
+}
+/** Run one action. Never throws: a failure comes back as `ok: false`. */
+export async function runAction(request) {
+    try {
+        switch (request.kind) {
+            case "install": {
+                if (request.entry === undefined)
+                    return missing("Choose a plugin to install.");
+                if (request.scope === undefined)
+                    return missing("Choose an install scope.");
+                if (request.entry.marketplace !== undefined && marketplacesNamed(request.entry.marketplace).length > 1) {
+                    return missing(`Cannot safely install ${request.entry.name}: marketplace "${request.entry.marketplace}" exists in more than one scope.`);
+                }
+                const result = await pluginInstall.run({ installRef: request.entry.ref, scope: request.scope });
+                const installed = asRecord(result);
+                const name = typeof installed["name"] === "string" ? installed["name"] : request.entry.name;
+                const scope = typeof installed["scope"] === "string" ? installed["scope"] : request.scope;
+                return { ok: true, message: `Installed ${name} in ${scope} scope.`, detail: commandDetail(installed["commands"]) };
+            }
+            case "remove": {
+                if (request.entry === undefined || request.entry.install.kind !== "installed")
+                    return missing("Choose an installed plugin to remove.");
+                const result = asRecord(await pluginRemove.run({ name: request.entry.name, scope: request.entry.install.scope }));
+                const scopes = strings(result["scopes"]);
+                return { ok: true, message: `Removed ${request.entry.name}${scopes.length > 0 ? ` from ${scopes.join(", ")} scope${scopes.length === 1 ? "" : "s"}` : ""}.` };
+            }
+            case "enable": {
+                if (request.entry === undefined || request.entry.install.kind !== "installed")
+                    return missing("Choose an installed plugin to enable.");
+                const result = asRecord(await pluginEnable.run({ name: request.entry.name, scope: request.entry.install.scope }));
+                const scope = typeof result["scope"] === "string" ? result["scope"] : request.entry.install.scope;
+                return { ok: true, message: `Enabled ${request.entry.name} in ${scope} scope.` };
+            }
+            case "disable": {
+                if (request.entry === undefined || request.entry.install.kind !== "installed")
+                    return missing("Choose an installed plugin to disable.");
+                const result = asRecord(await pluginDisable.run({ name: request.entry.name, scope: request.entry.install.scope }));
+                const scope = typeof result["scope"] === "string" ? result["scope"] : request.entry.install.scope;
+                return { ok: true, message: `Disabled ${request.entry.name} in ${scope} scope.` };
+            }
+            case "update": {
+                if (request.entry === undefined || request.entry.install.kind !== "installed")
+                    return missing("Choose an installed plugin to update.");
+                const result = await pluginUpdate.run({ name: request.entry.name, scope: request.entry.install.scope });
+                const detail = updateDetail(result, "Plugin");
+                return { ok: true, message: detail[0] ?? `Updated ${request.entry.name}.`, detail };
+            }
+            case "market-add": {
+                if (request.url === undefined || request.url === "")
+                    return missing("Enter a marketplace git URL.");
+                const result = asRecord(await marketAdd.run({
+                    url: request.url,
+                    ...(request.ref !== undefined ? { ref: request.ref } : {}),
+                    ...(request.scope !== undefined ? { scope: request.scope } : {}),
+                }));
+                const name = typeof result["name"] === "string" ? result["name"] : request.url;
+                const scope = typeof result["scope"] === "string" ? result["scope"] : request.scope;
+                return { ok: true, message: `Added marketplace ${name}${scope === undefined ? "" : ` in ${scope} scope`}.` };
+            }
+            case "market-update": {
+                if (request.marketplace === undefined)
+                    return missing("Choose a marketplace to update.");
+                if (request.scope === undefined)
+                    return missing("Choose a marketplace scope to update.");
+                const result = await marketUpdate.run({ name: request.marketplace, scope: request.scope });
+                const detail = updateDetail(result, "Marketplace");
+                return { ok: true, message: detail[0] ?? `Updated ${request.marketplace}.`, detail };
+            }
+            case "market-remove": {
+                if (request.marketplace === undefined)
+                    return missing("Choose a marketplace to remove.");
+                if (request.scope === undefined)
+                    return missing("Choose a marketplace scope to remove.");
+                const result = asRecord(await marketRemove.run({ name: request.marketplace, scope: request.scope }));
+                const name = typeof result["name"] === "string" ? result["name"] : request.marketplace;
+                return { ok: true, message: `Removed marketplace ${name}.` };
+            }
+        }
+        return missing("Unsupported action.");
+    }
+    catch (error) {
+        return { ok: false, message: error instanceof Error ? error.message : String(error) };
+    }
+}

package/dist/commands/pkg/browse/catalog.d.ts

@@ -0,0 +1,9 @@
+import { type Catalog, type PluginCapability, type PluginEntry } from "./model.js";
+/** Every rail source with its rows: the installed library first, then each
+ *  registered marketplace. Called on open and after any action that could
+ *  change install state. Must never throw for a broken marketplace — record it
+ *  in `warnings` and keep the rest of the catalog. */
+export declare function loadCatalog(): Catalog;
+/** What the focused plugin adds to this machine. Resolved from `entry.root`;
+ *  null when the plugin has no directory on disk yet. */
+export declare function loadCapability(entry: PluginEntry): Promise<PluginCapability | null>;