@hasna/skills 0.6.0 → 0.6.1

package/bin/index.js

@@ -47,6 +47,14 @@ var __export = (target, all) => {
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
 var __require = import.meta.require;
 
+// src/cli/output.ts
+async function writeCliOutput(text, newline = true) {
+  await new Promise((resolve, reject) => {
+    process.stdout.write(newline ? `${text}
+` : text, (error) => error ? reject(error) : resolve());
+  });
+}
+
 // ../../node_modules/.bun/react@18.3.1/node_modules/react/cjs/react.development.js
 var require_react_development = __commonJS((exports, module) => {
   if (true) {
@@ -36860,7 +36868,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/skills",
-    version: "0.6.0",
+    version: "0.6.1",
     description: "Skills library for AI coding agents",
     type: "module",
     bin: {
@@ -53548,7 +53556,7 @@ function registerContextCommands(parent) {
         sessionId: options.session,
         file: options.file
       });
-      console.log(options.json ? JSON.stringify(result2) : result2.content);
+      await writeCliOutput(options.json ? JSON.stringify(result2) : result2.content);
     } catch (error) {
       reportContextError(error, options.json);
     }
@@ -53565,7 +53573,7 @@ function registerContextCommands(parent) {
         maxChars: Number(options.maxChars),
         maxSkills: Number(options.maxSkills)
       });
-      console.log(options.json ? JSON.stringify(result2) : result2.context);
+      await writeCliOutput(options.json ? JSON.stringify(result2) : result2.context);
     } catch (error) {
       reportContextError(error, options.json);
     }
@@ -53656,9 +53664,9 @@ async function handleProfileSync(options, dependencies = {}) {
       check: options.check ?? dependencies.check
     });
     if (options.json)
-      console.log(JSON.stringify(result2));
+      await writeCliOutput(JSON.stringify(result2));
     else
-      console.log(options.check ? result2.changed ? "Skills profile or cached bundles need syncing." : "Skills profile and cached bundles are current." : `Synced Skills profile ${result2.profile.profileId} at ${result2.profile.profileRevision}; ${result2.downloaded} bundle(s) downloaded.`);
+      await writeCliOutput(options.check ? result2.changed ? "Skills profile or cached bundles need syncing." : "Skills profile and cached bundles are current." : `Synced Skills profile ${result2.profile.profileId} at ${result2.profile.profileRevision}; ${result2.downloaded} bundle(s) downloaded.`);
     if (options.check && result2.changed)
       process.exitCode = 1;
   } catch (error) {
@@ -77924,7 +77932,7 @@ function registerRuntime(parent) {
       try {
         const client = await CloudExecutionClient.configured();
         const value = operation === "show" ? await client.get(id) : await client[operation](id);
-        console.log(JSON.stringify(value, null, 2));
+        await writeCliOutput(JSON.stringify(value, null, 2));
       } catch (error2) {
         console.error(JSON.stringify({ error: error2.message }));
         process.exitCode = 1;
@@ -78260,9 +78268,9 @@ async function handleRun(name, args2, options) {
           throw new Error("Selected local execution accepts arguments and structured --input only");
         const result4 = await executeSelectedLocal(selected, { args: args2, input, cwd: process.cwd() });
         if (options.json)
-          console.log(JSON.stringify(result4, null, 2));
+          await writeCliOutput(JSON.stringify(result4, null, 2));
         else {
-          process.stdout.write(result4.stdout);
+          await writeCliOutput(result4.stdout, false);
           process.stderr.write(result4.stderr);
           console.error(JSON.stringify({ selection: result4.selection, target: result4.target, exitCode: result4.exitCode, runDirectory: result4.runDirectory }));
         }
@@ -78281,7 +78289,7 @@ async function handleRun(name, args2, options) {
       if (options.wait)
         console.error(JSON.stringify({ executionId: admitted.id, status: admitted.status }));
       const result3 = options.wait ? await client2.wait(admitted.id, { timeoutMs, intervalMs }) : admitted;
-      console.log(JSON.stringify(result3, null, 2));
+      await writeCliOutput(JSON.stringify(result3, null, 2));
       if (["failed", "cancelled"].includes(result3.status))
         process.exitCode = 1;
     } catch (error2) {
@@ -78484,7 +78492,7 @@ async function handleRun(name, args2, options) {
     console.log(JSON.stringify({ skill: skill.name, args: args2, ...result2, run: completed }, null, 2));
   else {
     if (result2.stdout)
-      process.stdout.write(result2.stdout);
+      await writeCliOutput(result2.stdout, false);
     if (result2.stderr)
       process.stderr.write(result2.stderr);
     if (result2.error)
@@ -79856,15 +79864,15 @@ function agents(value) {
 }
 function registerAgentIntegration(parent) {
   const hook = parent.command("hook").description("Load selected Skills context through agent lifecycle hooks");
-  hook.command("install").option("--agent <agent>", "Agent to configure: claude, codex, all", "all").option("--command <path>", "Skills executable used by the hook", "skills").option("--selection-profile <id>", "Shared selection profile", "default").option("--include-vendor", "Also disable discovered vendor system skills in Codex", false).option("--allow-root-aliases", "Allow home .claude/.codex aliases to existing directories within this home", false).option("--apply", "Apply the plan, preserving prior configuration in private backups", false).option("--json", "Output a receipt as JSON", false).description("Plan or install prompt hooks and disable native skill invocation").action((options) => {
+  hook.command("install").option("--agent <agent>", "Agent to configure: claude, codex, all", "all").option("--command <path>", "Skills executable used by the hook", "skills").option("--selection-profile <id>", "Shared selection profile", "default").option("--include-vendor", "Also disable discovered vendor system skills in Codex", false).option("--allow-root-aliases", "Allow home .claude/.codex aliases to existing directories within this home", false).option("--apply", "Apply the plan, preserving prior configuration in private backups", false).option("--json", "Output a receipt as JSON", false).description("Plan or install prompt hooks and disable native skill invocation").action(async (options) => {
     try {
       const plan = planAgentIntegration({ agents: agents(options.agent), command: options.command, profileId: options.selectionProfile, includeVendor: options.includeVendor, allowRootAliases: options.allowRootAliases });
       const result2 = options.apply ? applyAgentIntegration(plan) : { changed: [], backups: [] };
       const receipt = { applied: options.apply, planned: plan.changes.map((change) => change.path), ...result2, rootAliases: plan.rootAliases ?? [], nativeSkills: plan.nativeSkills.map((entry) => ({ agent: entry.agent, path: entry.path, managed: entry.managed, vendor: entry.vendor })) };
       if (options.json)
-        console.log(JSON.stringify(receipt));
+        await writeCliOutput(JSON.stringify(receipt));
       else
-        console.log(`${options.apply ? "Configured" : "Planned"} ${plan.changes.length} agent configuration change(s).${options.apply ? " Restart the agent and trust the installed hook configuration." : " Use --apply to install."}`);
+        await writeCliOutput(`${options.apply ? "Configured" : "Planned"} ${plan.changes.length} agent configuration change(s).${options.apply ? " Restart the agent and trust the installed hook configuration." : " Use --apply to install."}`);
     } catch (error2) {
       console.error(error2.message);
       process.exitCode = 1;
@@ -79906,29 +79914,29 @@ function registerAgentIntegration(parent) {
         const result2 = JSON.parse(stdout);
         if (typeof result2.context !== "string")
           throw new Error("Invalid Skills context response");
-        console.log(JSON.stringify(hookContextOutput(event, result2)));
+        await writeCliOutput(JSON.stringify(hookContextOutput(event, result2)));
       } finally {
         clearTimeout(timer);
       }
     } catch {
       const reason = "Skills context is unavailable. Run skills sync --selection-profile <id> and skills context --stdin --json to diagnose the selected profile.";
       if (event === "UserPromptSubmit")
-        console.log(JSON.stringify({ decision: "block", reason }));
+        await writeCliOutput(JSON.stringify({ decision: "block", reason }));
       else if (event === "SessionStart")
-        console.log(JSON.stringify({ continue: false, stopReason: reason, systemMessage: reason }));
+        await writeCliOutput(JSON.stringify({ continue: false, stopReason: reason, systemMessage: reason }));
       else
-        console.log(JSON.stringify({ systemMessage: reason, hookSpecificOutput: { hookEventName: "SubagentStart", additionalContext: "Required Skills context was unavailable. Report this to the parent before performing task actions." } }));
+        await writeCliOutput(JSON.stringify({ systemMessage: reason, hookSpecificOutput: { hookEventName: "SubagentStart", additionalContext: "Required Skills context was unavailable. Report this to the parent before performing task actions." } }));
     }
   });
   const migrate = parent.command("migrate").description("Preserve and retire native agent skill copies");
-  migrate.command("native").option("--project <directory>", "Also inventory native skills in a project directory").option("--include-unmanaged", "Archive user-authored skills as well as Skills-managed copies", false).option("--allow-root-aliases", "Allow home .claude/.codex aliases to existing directories within this home", false).option("--apply", "Move selected skills to private archives outside agent discovery roots", false).option("--json", "Output inventory and archive receipt as JSON", false).description("Inventory native skill copies; preserve complete directories before retiring them").action((options) => {
+  migrate.command("native").option("--project <directory>", "Also inventory native skills in a project directory").option("--include-unmanaged", "Archive user-authored skills as well as Skills-managed copies", false).option("--allow-root-aliases", "Allow home .claude/.codex aliases to existing directories within this home", false).option("--apply", "Move selected skills to private archives outside agent discovery roots", false).option("--json", "Output inventory and archive receipt as JSON", false).description("Inventory native skill copies; preserve complete directories before retiring them").action(async (options) => {
     try {
       const inventory = inventoryNativeSkills(undefined, { projectDir: options.project, allowRootAliases: options.allowRootAliases });
       const result2 = options.apply ? archiveNativeSkills(inventory, { includeUnmanaged: options.includeUnmanaged, allowRootAliases: options.allowRootAliases }) : { entries: [] };
       if (options.json)
-        console.log(JSON.stringify({ applied: options.apply, inventory, ...result2 }));
+        await writeCliOutput(JSON.stringify({ applied: options.apply, inventory, ...result2 }));
       else
-        console.log(`${inventory.length} native skill(s) found; ${result2.entries.length} archived with recovery receipts.${options.apply ? "" : " Use --apply to archive managed copies."}`);
+        await writeCliOutput(`${inventory.length} native skill(s) found; ${result2.entries.length} archived with recovery receipts.${options.apply ? "" : " Use --apply to archive managed copies."}`);
     } catch (error2) {
       console.error(error2.message);
       process.exitCode = 1;
@@ -80008,7 +80016,7 @@ function registerProfiles(parent) {
       if (options.save)
         writeFileSync22(options.save, `${text2}
 `, { mode: 384, flag: "wx" });
-      console.log(options.json ? text2 : `${profile.id} at ${profile.revision}: ${profile.selections.map((skill) => `${skill.slug}@${skill.version}`).join(", ")}`);
+      await writeCliOutput(options.json ? text2 : `${profile.id} at ${profile.revision}: ${profile.selections.map((skill) => `${skill.slug}@${skill.version}`).join(", ")}`);
     } catch (error2) {
       console.error(error2.message);
       process.exitCode = 1;
@@ -80021,7 +80029,7 @@ function registerProfiles(parent) {
         throw new Error("Profile input exceeds the size limit");
       const input = JSON.parse(text2);
       const profile = await saveSkillProfile(id2, input.selections, options.ifMatch);
-      console.log(options.json ? JSON.stringify(profile) : `Saved ${profile.id} at ${profile.revision}`);
+      await writeCliOutput(options.json ? JSON.stringify(profile) : `Saved ${profile.id} at ${profile.revision}`);
     } catch (error2) {
       console.error(error2.message);
       process.exitCode = 1;
@@ -80029,7 +80037,7 @@ function registerProfiles(parent) {
   });
   parent.command("station-state <id>").description("Read this actor's last applied skill selection on a station").option("--json", "Output the station receipt as JSON", false).action(async (id2) => {
     try {
-      console.log(JSON.stringify(await readStationSkillState(id2), null, 2));
+      await writeCliOutput(JSON.stringify(await readStationSkillState(id2), null, 2));
     } catch (error2) {
       console.error(error2.message);
       process.exitCode = 1;
@@ -83147,7 +83155,6 @@ var init_registry_reconcile2 = __esm(() => {
   init_selection_cache();
   init_registry_reconcile();
 });
-
 // ../../node_modules/.bun/ink@5.2.1+6e93904c7bfe2418/node_modules/ink/build/render.js
 import { Stream } from "stream";
 import process12 from "process";
@@ -90963,8 +90970,8 @@ program2.command("interactive", { isDefault: true }).alias("i").allowExcessArgum
     process.exit(1);
   }
   if (!isTTY2) {
-    console.log(JSON.stringify(loadBasicRegistry().map(getCompactSkillDiscovery)));
-    process.exit(0);
+    await writeCliOutput(JSON.stringify(loadBasicRegistry().map(getCompactSkillDiscovery)));
+    return;
   }
   render_default(/* @__PURE__ */ jsx_dev_runtime7.jsxDEV(App2, {}, undefined, false, undefined, this));
 });

package/bin/mcp.js

@@ -5586,7 +5586,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@hasna/skills",
-    version: "0.6.0",
+    version: "0.6.1",
     description: "Skills library for AI coding agents",
     type: "module",
     bin: {
@@ -26973,7 +26973,6 @@ var init_selection_resolver = __esm(() => {
   init_selected_document();
   init_selection_cache();
 });
-
 // src/lib/skill-context.ts
 var init_skill_context = __esm(() => {
   init_selection_resolver();

package/bin/migrate.js

@@ -7,7 +7,7 @@ import { join as join6 } from "path";
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.6.0",
+  version: "0.6.1",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {

package/bin/server.js

@@ -23100,7 +23100,7 @@ var init_dist_es9 = __esm(() => {
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.6.0",
+  version: "0.6.1",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {

package/bin/worker.js

@@ -23103,7 +23103,7 @@ import { randomUUID as randomUUID5 } from "crypto";
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.6.0",
+  version: "0.6.1",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {

package/dist/cli/commands/runtime.d.ts

@@ -1,5 +1,2 @@
-/**
- * run / mcp / self-update — runtime commands
- */
 import type { Command } from "commander";
 export declare function registerRuntime(parent: Command): void;

package/dist/cli/output.d.ts

@@ -0,0 +1,2 @@
+/** Finish pipe writes before an async command returns, including under backpressure. */
+export declare function writeCliOutput(text: string, newline?: boolean): Promise<void>;

package/dist/index.js

@@ -13710,7 +13710,7 @@ import { dirname as dirname8, relative as relative6 } from "path";
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.6.0",
+  version: "0.6.1",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {

package/dist/sdk/index.js

@@ -24427,7 +24427,7 @@ var init_event_sink = __esm(() => {
 // package.json
 var package_default = {
   name: "@hasna/skills",
-  version: "0.6.0",
+  version: "0.6.1",
   description: "Skills library for AI coding agents",
   type: "module",
   bin: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/skills",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Skills library for AI coding agents",
   "type": "module",
   "bin": {