@kisev/skills-opencode 1.1.0 → 1.1.1

package/README.md

@@ -16,7 +16,7 @@ npx --yes skills add kisev/skills --agent opencode --skill '*' --copy --yes
 
 Для одного skill укажите `--skill <name>`. Для воспроизводимой установки можно
 передать URL GitHub tag, например
-`https://github.com/kisev/skills/tree/v1.1.0`. Package никогда не устанавливает
+`https://github.com/kisev/skills/tree/v1.1.1`. Package никогда не устанавливает
 и не обновляет skills. Если команда не нашла skill, она сообщает точную команду
 `npx skills add` для его установки.
 
@@ -25,16 +25,18 @@ npx --yes skills add kisev/skills --agent opencode --skill '*' --copy --yes
 Установите npm package там, где OpenCode сможет разрешить plugin:
 
 ```shell
-npm install @kisev/skills-opencode@1.1.0
+npm install @kisev/skills-opencode@1.1.1
 ```
 
-Сначала покажите план installer. Эта команда не создаёт files:
+Сначала покажите план installer. По умолчанию CLI выводит короткую сводку:
+счётчики по группам, только изменяемые paths, conflicts, restart flag, digest и
+готовую confirm-команду. Эта команда не меняет deployment:
 
 ```shell
 npm exec -- skills-opencode install --scope global --dry-run
 ```
 
-Проверьте exact operations и примените только показанный digest:
+Проверьте сводку и примените только показанный digest:
 
 ```shell
 npm exec -- skills-opencode install --scope global --confirm <digest>
@@ -54,6 +56,14 @@ Project assets находятся в `.opencode/agents`, `.opencode/commands` и
 перезаписывает неизвестные или изменённые files и сохраняет ownership manifests
 только после confirmed apply.
 
+Для automation добавьте `--json`. Этот режим сохраняет полный стабильный
+machine-readable plan, включая `operations` и `requires_restart`:
+
+```shell
+npm exec -- skills-opencode install --scope global --dry-run --json
+npm exec -- skills-opencode agent list --scope global --json
+```
+
 Добавьте plugin в `opencode.json` вручную:
 
 ```json
@@ -95,11 +105,12 @@ npm exec -- skills-opencode critic add security --scope global \
 npm exec -- skills-opencode critic remove security --scope global --dry-run
 ```
 
-Для любой mutation замените `--dry-run` на `--confirm <digest>` и повторите те же
-аргументы. Plan содержит TLDR operations без полного diff. Digest связан с
-одноразовым private receipt, действует 10 минут и повторно не применяется.
-Успешный machine-readable result содержит `requires_restart`; после `true`
-полностью перезапустите OpenCode.
+Для любой mutation используйте готовую confirm-команду из preview либо замените
+`--dry-run` на `--confirm <digest>` и повторите те же аргументы. Человекочитаемый
+plan не печатает полный JSON и сворачивает длинные группы paths. Digest связан с
+одноразовым private receipt, действует 10 минут и повторно не применяется. Для
+machine-readable result добавьте `--json`; поле `requires_restart` сообщает о
+необходимости полностью перезапустить OpenCode.
 
 В global scope profile configuration хранится в
 `~/.config/opencode/.skills-opencode/agent-profiles.json`, а semantic deployment

package/dist/cli-output.d.ts

@@ -0,0 +1,11 @@
+import type { AgentInventory, AgentProfilePlan } from "./agent-profiles.js";
+import type { Plan as InstallerPlan } from "./installer.js";
+type DisplayPlan = InstallerPlan | AgentProfilePlan;
+export declare function terminalSafe(value: string): string;
+export declare function renderPlan(plan: DisplayPlan, options: {
+    applied: boolean;
+    confirmationCommand?: string;
+}): string;
+export declare function renderInventory(inventory: AgentInventory): string;
+export declare function shellCommand(arguments_: readonly string[]): string;
+export {};

package/dist/cli-output.js

@@ -0,0 +1,149 @@
+const GROUPS = ["Agents", "Commands", "Plugins", "State"];
+const OPERATIONS = ["create", "update", "remove", "conflict", "missing", "unchanged"];
+const UNSAFE_TERMINAL_CHARACTER = /[\p{Cc}\p{Cf}\p{Zl}\p{Zp}]/u;
+export function terminalSafe(value) {
+    return [...value]
+        .map((character) => {
+        const code = character.codePointAt(0);
+        const unsafe = character === "\\" || UNSAFE_TERMINAL_CHARACTER.test(character);
+        if (!unsafe)
+            return character;
+        if (character === "\\")
+            return "\\\\";
+        if (character === "\n")
+            return "\\n";
+        if (character === "\r")
+            return "\\r";
+        if (character === "\t")
+            return "\\t";
+        if (code <= 0xff)
+            return `\\x${code.toString(16).padStart(2, "0")}`;
+        if (code <= 0xffff)
+            return `\\u${code.toString(16).padStart(4, "0")}`;
+        return `\\u{${code.toString(16)}}`;
+    })
+        .join("");
+}
+function groupFor(path) {
+    if (path.startsWith("agents/"))
+        return "Agents";
+    if (path.startsWith("commands/"))
+        return "Commands";
+    if (path.startsWith("plugins/"))
+        return "Plugins";
+    return "State";
+}
+function actionName(action) {
+    return {
+        install: "Install",
+        uninstall: "Uninstall",
+        "model-set": "Configure agent model",
+        "critic-add": "Add critic",
+        "critic-remove": "Remove critic",
+        reconcile: "Reconcile agents",
+    }[action];
+}
+function operationSummary(operations) {
+    return OPERATIONS.map((operation) => {
+        const count = operations.filter((item) => item.operation === operation).length;
+        return count ? `${operation} ${count}` : undefined;
+    })
+        .filter(Boolean)
+        .join(", ");
+}
+function shortPath(path, group) {
+    if (group === "State")
+        return terminalSafe(path);
+    const value = path.slice(path.indexOf("/") + 1);
+    return terminalSafe(value.endsWith(".md") || value.endsWith(".js") ? value.slice(0, -3) : value);
+}
+function detailLines(operations) {
+    const lines = [];
+    for (const group of GROUPS) {
+        const grouped = operations.filter((item) => groupFor(item.path) === group && item.operation !== "unchanged");
+        for (const operation of OPERATIONS.filter((value) => value !== "unchanged" && grouped.some((item) => item.operation === value))) {
+            const values = grouped
+                .filter((item) => item.operation === operation)
+                .map((item) => operation === "conflict"
+                ? `${shortPath(item.path, group)} (${terminalSafe(item.reason ?? "conflict")})`
+                : shortPath(item.path, group));
+            const visible = operation === "conflict" ? values : values.slice(0, 8);
+            const rest = values.length - visible.length;
+            lines.push(`  ${group}/${operation}: ${visible.join(", ")}${rest ? ` (+${rest} more)` : ""}`);
+        }
+    }
+    return lines;
+}
+function migrationSummary(operations) {
+    const count = operations.filter((item) => item.reason === "v1.0.0 ownership transfer").length;
+    return count
+        ? `  Ownership migration: ${count} agent${count === 1 ? "" : "s"} from v1.0.0`
+        : undefined;
+}
+export function renderPlan(plan, options) {
+    const version = "package_version" in plan ? ` @kisev/skills-opencode ${plan.package_version}` : "";
+    const lines = [
+        `${actionName(plan.action)}${version} (${plan.scope})`,
+        `Target: ${terminalSafe(plan.root)}`,
+        "",
+        options.applied ? "Applied changes:" : "Planned changes:",
+    ];
+    for (const group of GROUPS) {
+        const operations = plan.operations.filter((item) => groupFor(item.path) === group);
+        if (operations.length)
+            lines.push(`  ${group}: ${operationSummary(operations)}`);
+    }
+    const migration = migrationSummary(plan.operations);
+    if (migration)
+        lines.push(migration);
+    const details = detailLines(plan.operations);
+    if (details.length)
+        lines.push("", "Details:", ...details);
+    const conflicts = plan.operations.filter((item) => item.operation === "conflict").length;
+    lines.push("", `Conflicts: ${conflicts || "none"}`);
+    lines.push(options.applied
+        ? `Restart required: ${plan.requires_restart ? "yes" : "no"}`
+        : `Restart after apply: ${plan.requires_restart ? "yes" : "no"}`);
+    if (!options.applied) {
+        if (plan.receipt_expires_at)
+            lines.push(`Confirmation expires: ${plan.receipt_expires_at}`);
+        lines.push(`Digest: ${plan.digest}`);
+        if (options.confirmationCommand)
+            lines.push("", "Apply:", `  ${options.confirmationCommand}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+function table(rows) {
+    const widths = rows[0].map((_, column) => Math.max(...rows.map((row) => row[column]?.length ?? 0)));
+    return rows.map((row) => row
+        .map((value, column) => value.padEnd(widths[column]))
+        .join("  ")
+        .trimEnd());
+}
+export function renderInventory(inventory) {
+    const rows = [
+        ["NAME", "MODEL", "VARIANT", "OWNER", "STATE"],
+        ...inventory.profiles.map((profile) => [
+            terminalSafe(profile.name),
+            terminalSafe(profile.model ?? "default"),
+            terminalSafe(profile.variant ?? "-"),
+            profile.ownership,
+            profile.state,
+        ]),
+    ];
+    return `${[
+        `OpenCode agents (${inventory.scope})`,
+        `Target: ${terminalSafe(inventory.root)}`,
+        "",
+        ...table(rows),
+        "",
+        `Critic pool: ${inventory.critic_pool.map(terminalSafe).join(", ")}`,
+        `Collisions: ${inventory.collisions.length ? inventory.collisions.map(terminalSafe).join(", ") : "none"}`,
+        `Drift: ${inventory.drift.length ? inventory.drift.map(terminalSafe).join(", ") : "none"}`,
+    ].join("\n")}\n`;
+}
+export function shellCommand(arguments_) {
+    return ["npm", "exec", "--", "skills-opencode", ...arguments_]
+        .map((value) => /^[A-Za-z0-9_./:@=-]+$/.test(value) ? value : `'${value.replaceAll("'", `'"'"'`)}'`)
+        .join(" ");
+}

package/dist/cli.js

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
 import { createInterface } from "node:readline/promises";
 import { AgentProfileError, applyAgentProfileChange, availableModels, availableModelVariants, FIXED_AGENT_ROLES, listAgentProfiles, previewAgentProfileChange, validateAgentName, validateModel, validateVariant, } from "./agent-profiles.js";
-import { apply, InstallerError, preview, result } from "./installer.js";
+import { renderInventory, renderPlan, shellCommand, terminalSafe } from "./cli-output.js";
+import { apply, InstallerError, preview } from "./installer.js";
 import { LifecycleError } from "./lifecycle.js";
 function parseOptions(values) {
-    const options = { dryRun: false };
+    const options = { dryRun: false, json: false };
     for (let index = 0; index < values.length; index += 1) {
         const value = values[index];
         if (!value.startsWith("--")) {
@@ -52,6 +53,11 @@ function parseOptions(values) {
                 throw new InstallerError("invalid_input", "Use only one variant option");
             options.variant = null;
         }
+        else if (value === "--json") {
+            if (options.json)
+                throw new InstallerError("invalid_input", "--json may be supplied once");
+            options.json = true;
+        }
         else {
             throw new InstallerError("invalid_input", `Unknown argument: ${value}`);
         }
@@ -133,12 +139,33 @@ async function runProfile(request, options) {
     requireConfirmationMode(options);
     if (options.dryRun) {
         const plan = await previewAgentProfileChange(request, options.scope);
-        process.stdout.write(`${JSON.stringify({ status: "ok", applied: false, requires_restart: false, plan }, null, 2)}\n`);
+        if (options.json)
+            process.stdout.write(`${JSON.stringify({ status: "ok", applied: false, requires_restart: false, plan }, null, 2)}\n`);
+        else
+            process.stdout.write(renderPlan(plan, { applied: false, confirmationCommand: shellCommand(profileConfirmationArguments(request, options.scope, plan.digest)) }));
     }
     else {
-        process.stdout.write(`${JSON.stringify(await applyAgentProfileChange(request, options.scope, options.confirm), null, 2)}\n`);
+        const applied = await applyAgentProfileChange(request, options.scope, options.confirm);
+        if (options.json)
+            process.stdout.write(`${JSON.stringify(applied, null, 2)}\n`);
+        else
+            process.stdout.write(renderPlan(applied.plan, { applied: true }));
     }
 }
+function profileConfirmationArguments(request, scope, digest) {
+    if (request.action === "reconcile")
+        return ["agent", "reconcile", "--scope", scope, "--confirm", digest];
+    if (request.action === "critic-remove")
+        return ["critic", "remove", request.name, "--scope", scope, "--confirm", digest];
+    const command = request.action === "critic-add" ? ["critic", "add", request.name] : ["agent", "model-set", request.name];
+    command.push("--scope", scope, "--model", request.model);
+    if (request.variant)
+        command.push("--variant", request.variant);
+    else if (request.action === "model-set")
+        command.push("--clear-variant");
+    command.push("--confirm", digest);
+    return command;
+}
 async function run(arguments_) {
     const [domain, operation, ...rest] = arguments_;
     if (domain === "install" || domain === "uninstall") {
@@ -151,14 +178,31 @@ async function run(arguments_) {
             throw new InstallerError("invalid_input", "Installer accepts only scope and confirmation options");
         requireConfirmationMode(options);
         const action = domain;
-        process.stdout.write(`${result(options.dryRun ? await preview(action, options.scope) : await apply(action, options.scope, options.confirm), !options.dryRun)}\n`);
+        if (options.dryRun) {
+            const plan = await preview(action, options.scope);
+            if (options.json)
+                process.stdout.write(`${JSON.stringify({ status: "ok", applied: false, requires_restart: false, plan }, null, 2)}\n`);
+            else
+                process.stdout.write(renderPlan(plan, { applied: false, confirmationCommand: shellCommand([action, "--scope", options.scope, "--confirm", plan.digest]) }));
+        }
+        else {
+            const plan = await apply(action, options.scope, options.confirm);
+            if (options.json)
+                process.stdout.write(`${JSON.stringify({ status: "ok", applied: true, requires_restart: plan.requires_restart, plan }, null, 2)}\n`);
+            else
+                process.stdout.write(renderPlan(plan, { applied: true }));
+        }
         return;
     }
     if (domain === "agent" && operation === "list") {
         const options = parseOptions(rest);
         if (options.dryRun || options.confirm || options.name || options.provider || options.model || options.variant !== undefined)
             throw new InstallerError("invalid_input", "agent list accepts only --scope");
-        process.stdout.write(`${JSON.stringify({ status: "ok", inventory: await listAgentProfiles(options.scope) }, null, 2)}\n`);
+        const inventory = await listAgentProfiles(options.scope);
+        if (options.json)
+            process.stdout.write(`${JSON.stringify({ status: "ok", inventory }, null, 2)}\n`);
+        else
+            process.stdout.write(renderInventory(inventory));
         return;
     }
     if (domain === "agent" && operation === "configure") {
@@ -212,7 +256,10 @@ async function main() {
     }
     catch (error) {
         const known = error instanceof LifecycleError ? error : new InstallerError("internal_error", error instanceof Error ? error.message : String(error));
-        process.stdout.write(`${JSON.stringify({ status: "error", error: { code: known.code, message: known.message } })}\n`);
+        if (process.argv.includes("--json"))
+            process.stdout.write(`${JSON.stringify({ status: "error", error: { code: known.code, message: known.message } })}\n`);
+        else
+            process.stderr.write(`Error [${known.code}]: ${terminalSafe(known.message)}\n`);
         process.exitCode = 2;
     }
 }

package/dist/index.js

@@ -17,7 +17,7 @@ const CATALOG = {
     skills: ["attempt", "goal", "schedule", "multi-run", "usage", "overview", "lsp-report"],
     plugins: ["background-attempts", "goal-loop", "schedule", "autonomy-policy", "rules-injector", "rtk", "zed-bell", "zed-clickable-paths"],
     replacements: ["capabilities", "route", "doctor", "agent_profiles"],
-    version: "1.1.0",
+    version: "1.1.1",
 };
 const plugin = (async (input) => {
     const gate = new RoutingGate();

package/dist/installer.js

@@ -179,7 +179,7 @@ async function build(action, scope, cwd = process.cwd(), home = homedir()) {
         mutations.push({ path: MANIFEST_NAME, operation: "remove", expected: { sha256: sha256(owned.raw) } });
     }
     const sorted = operations.sort((left, right) => left.path.localeCompare(right.path) || left.operation.localeCompare(right.operation));
-    const base = { schema_version: 1, action, scope, root, package_version: packageVersion(), operations: sorted, requires_restart: profiles.plan.requires_restart || sorted.some((item) => item.path.startsWith("commands/") || item.path.startsWith("plugins/")) };
+    const base = { schema_version: 1, action, scope, root, package_version: packageVersion(), operations: sorted, requires_restart: (action === "install" && owned.manifest?.version !== packageVersion()) || profiles.plan.requires_restart || mutations.some((item) => item.path.startsWith("agents/") || item.path.startsWith("commands/") || item.path.startsWith("plugins/")) };
     return {
         plan: { ...base, digest: digest(base) },
         mutations,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kisev/skills-opencode",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "OpenCode integration and opt-in installer for portable Agent Skills.",
   "license": "MIT",
   "repository": {