unfairly 0.8.1 → 0.8.3

package/plugin/scripts/capture.cjs

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+const { spawn, spawnSync } = require("node:child_process");
+const fs = require("node:fs");
+const os = require("node:os");
+const path = require("node:path");
+
+const event = process.argv[2] || process.env.HOOK_EVENT_NAME || "Unknown";
+const source = process.env.GEMINI_CLI_HOME
+  ? "gemini_cli"
+  : process.env.CURSOR_PLUGIN_ROOT || process.env.CURSOR_PROJECT_DIR
+    ? "cursor"
+  : process.env.PLUGIN_ROOT
+    ? "codex"
+    : "claude_code";
+
+// Prefer the runtime bundled with this plugin, so installing the plugin from
+// an AI client's plugin store is the whole install. Fall back to a runtime
+// placed by `npx unfairly`, then to a global `unfairly`.
+const bundled = path.join(__dirname, "..", "runtime", "unfairly-intelligence.mjs");
+let command = "unfairly";
+let args = ["pace", "capture", "--source", source, "--event", event];
+let connectArgs = null;
+if (fs.existsSync(bundled)) {
+  command = process.execPath;
+  args = [bundled, "capture", source, event];
+  connectArgs = [bundled, "connect", source, event];
+} else {
+  try {
+    const pointer = JSON.parse(fs.readFileSync(path.join(os.homedir(), ".unfairly", "runtime", "current.json"), "utf8"));
+    if (typeof pointer.node === "string" && typeof pointer.entrypoint === "string") {
+      command = pointer.node;
+      args = [pointer.entrypoint, ...args];
+    }
+  } catch {
+    // Compatibility fallback for existing global installs.
+  }
+}
+
+// On session start, check the connection synchronously (bounded) so a
+// first-run "connect this machine" link can reach the person.
+if (connectArgs && (event === "SessionStart" || event === "sessionStart")) {
+  try {
+    const result = spawnSync(command, connectArgs, { encoding: "utf8", timeout: 4000, env: process.env, stdio: ["ignore", "pipe", "ignore"] });
+    if (result.stdout && result.stdout.trim()) process.stdout.write(result.stdout);
+  } catch {
+    // Never block or fail the session over telemetry.
+  }
+}
+
+// Read the hook payload, hand it to a detached runtime process, and return at
+// once: summarizing transcripts and uploading must never make the AI client wait.
+const chunks = [];
+process.stdin.on("data", (chunk) => chunks.push(chunk));
+process.stdin.on("error", () => process.exit(0));
+process.stdin.on("end", () => {
+  let child;
+  try {
+    child = spawn(command, args, { stdio: ["pipe", "ignore", "ignore"], env: process.env, detached: true });
+  } catch {
+    process.exit(0);
+  }
+  child.on("error", () => process.exit(0));
+  child.stdin.on("error", () => undefined);
+  child.stdin.end(Buffer.concat(chunks), () => {
+    child.unref();
+    process.exit(0);
+  });
+});

package/plugin/skills/find-company-playbook/SKILL.md

@@ -0,0 +1,12 @@
+---
+name: find-company-playbook
+description: Find and apply an approved company playbook when an employee asks how the organization handles a task, wants a reusable workflow, or starts work that may match an existing method.
+---
+
+# Find a company playbook
+
+Search the company's approved methods before inventing a new workflow: use the Unfairly connector's `find_skill` tool (then `run_skill` to load one), or `unfairly intelligence playbooks --query "<employee goal>"` if the Unfairly CLI is installed. Prefer a published playbook; label a pilot-ready playbook as a pilot.
+
+Show the employee the playbook title, intended outcome, owner, source requirements, and ordered steps. Ask before taking consequential actions. When the playbook is used, preserve its identifier and version in Unfairly Intelligence workflow context so reuse and downstream outcomes can be measured.
+
+Never expose another employee's prompts, responses, files, source code, or private session history. If no playbook matches, complete the work normally and offer to propose the successful method as a new learning.

package/plugin/skills/publish-learning/SKILL.md

@@ -0,0 +1,8 @@
+---
+name: publish-learning
+description: Propose a reusable, content-safe team playbook from a successful workflow when the user asks to share or publish a learning.
+---
+
+# Publish an Unfairly Intelligence learning
+
+Summarize the reusable workflow, not the private work product. Include the goal, tools and skills used, ordered steps, verification method, common failures, and resulting artifact type. Exclude prompts, responses, secrets, source code, customer data, file contents, and raw command output. Ask the employee to approve the proposed playbook before publishing it through Unfairly.