@tickernelz/paperclip-pro-adapter-utils 2026.925.0

package/node_modules/skillflag/dist/skillflag.js

@@ -0,0 +1,230 @@
+import process from "node:process";
+import { SkillflagError, toErrorMessage } from "./core/errors.js";
+import { exportSkill } from "./core/export.js";
+import { listSkills, listSkillsJson } from "./core/list.js";
+import { defaultSkillsRoot, resolveSkillDirFromRoots, resolveSkillsRoot, resolveSkillsRoots, } from "./core/paths.js";
+import { showSkill } from "./core/show.js";
+import { collectSkillEntries, createTarStream } from "./core/tar.js";
+import { uniqueValues } from "./utils/collections.js";
+const usageLines = [
+    "Usage:",
+    "  --skill install [<id> ...] [--agent <agent>] [--scope <scope>] [--force]",
+    "  --skill list [--json]",
+    "  --skill export <id>",
+    "  --skill show <id>",
+    "  --skill help",
+];
+export const SKILLFLAG_HELP_TEXT = [
+    "Skillflag help",
+    "",
+    "Install skillflag globally to get both binaries on your PATH:",
+    "  npm install -g skillflag",
+    "",
+    "Prefer not to install globally? Use npx for one-off runs:",
+    "  npx skillflag list",
+    "  npx skillflag install --agent codex --scope repo < ./skill.tar",
+    "",
+    "List available skills:",
+    "  tool --skill list",
+    "  tool --skill list --json",
+    "",
+    "Show a skill's documentation:",
+    "  tool --skill show <id>",
+    "",
+    "Export a skill bundle:",
+    "  tool --skill export <id>",
+    "",
+    "Install a skill bundle:",
+    "  tool --skill install [<id> ...] [--agent <agent>] [--scope <scope>]",
+    "  tool --skill export <id> | skill-install --agent <agent> --scope <scope>",
+    "",
+    "For full details, read docs/SKILLFLAG_SPEC.md.",
+].join("\n");
+async function defaultPromptApi() {
+    const prompts = await import("@clack/prompts");
+    return {
+        multiselect: prompts.multiselect,
+        isCancel: prompts.isCancel,
+    };
+}
+function resolveSkillActionArgs(argv) {
+    const cliArgs = argv.length > 2 ? argv.slice(2) : [...argv];
+    const skillIndex = cliArgs.indexOf("--skill");
+    if (skillIndex >= 0) {
+        return cliArgs.slice(skillIndex + 1);
+    }
+    return cliArgs;
+}
+function parseInstallIds(values) {
+    const ids = [];
+    let index = 0;
+    while (index < values.length) {
+        const value = values[index];
+        if (value.startsWith("-")) {
+            break;
+        }
+        const parsed = value
+            .split(",")
+            .map((part) => part.trim())
+            .filter((part) => part.length > 0);
+        ids.push(...parsed);
+        index += 1;
+    }
+    return {
+        ids: ids.length > 0 ? uniqueValues(ids) : undefined,
+        installArgs: values.slice(index),
+    };
+}
+/**
+ * Parse skillflag action arguments from argv.
+ *
+ * Expected forms:
+ * - Node-style argv: `[execPath, scriptPath, ...cliArgs]`
+ * - Already-trimmed args: `["--skill", "list"]` or `["list"]`
+ *
+ * For producer CLIs, parsing starts right after `--skill`.
+ * For the standalone `skillflag` binary, parsing starts at `cliArgs[0]`.
+ */
+function parseSkillArgs(argv) {
+    const args = resolveSkillActionArgs(argv);
+    const action = args[0];
+    if (!action || action.startsWith("-")) {
+        throw new SkillflagError(`Missing --skill action.\n${usageLines.join("\n")}`);
+    }
+    if (action === "install") {
+        const rest = args.slice(1);
+        const parsed = parseInstallIds(rest);
+        return {
+            kind: "install",
+            ids: parsed.ids,
+            installArgs: parsed.installArgs,
+        };
+    }
+    if (action === "list") {
+        const json = args.slice(1).includes("--json");
+        return { kind: "list", json };
+    }
+    if (action === "help") {
+        return { kind: "help" };
+    }
+    if (action === "export" || action === "show") {
+        const id = args[1];
+        if (!id || id.startsWith("-")) {
+            throw new SkillflagError(`Missing skill id.\n${usageLines.join("\n")}`);
+        }
+        return { kind: action, id };
+    }
+    throw new SkillflagError(`Unknown --skill action: ${action}.\n${usageLines.join("\n")}`);
+}
+function stdinIsTty(stream) {
+    return stream.isTTY === true;
+}
+async function resolveInstallSkillIds(action, rootDirs, stdin, stdout, promptApi) {
+    if (action.ids && action.ids.length > 0) {
+        return action.ids;
+    }
+    const skills = await listSkills(rootDirs);
+    if (skills.length === 0) {
+        throw new SkillflagError("No skills are available to install.");
+    }
+    if (skills.length === 1) {
+        return [skills[0].id];
+    }
+    if (!stdinIsTty(stdin)) {
+        throw new SkillflagError("Multiple skills are available; pass one or more ids with --skill install <id> [...].");
+    }
+    const options = skills.map((skill) => ({
+        value: skill.id,
+        label: skill.id,
+        hint: skill.summary,
+    }));
+    const selected = await promptApi.multiselect({
+        message: "Select skills to install",
+        options,
+        required: true,
+        input: stdin,
+        output: stdout,
+    });
+    if (promptApi.isCancel(selected)) {
+        throw new SkillflagError("Install cancelled.");
+    }
+    return uniqueValues(selected);
+}
+async function runInstallAction(action, rootDirs, opts, stdin, stdout, stderr) {
+    const promptApi = opts.promptApi ?? (await defaultPromptApi());
+    const skillIds = await resolveInstallSkillIds(action, rootDirs, stdin, stdout, promptApi);
+    const inputs = await Promise.all(skillIds.map(async (skillId) => {
+        const skillDir = await resolveSkillDirFromRoots(rootDirs, skillId);
+        const { entries } = await collectSkillEntries(skillDir, skillId);
+        return { kind: "tar", stream: createTarStream(entries) };
+    }));
+    const { runInstallCli } = await import("./install/cli.js");
+    return runInstallCli(["node", "skill-install", ...action.installArgs], {
+        stdin: stdin,
+        stdout: stdout,
+        stderr: stderr,
+        cwd: opts.cwd,
+        providedInputs: inputs,
+        providedSkillIds: skillIds,
+    });
+}
+export async function handleSkillflag(argv, opts) {
+    const stdin = opts.stdin ?? process.stdin;
+    const stdout = opts.stdout ?? process.stdout;
+    const stderr = opts.stderr ?? process.stderr;
+    try {
+        const action = parseSkillArgs(argv);
+        const bundledRoot = resolveSkillsRoot(defaultSkillsRoot());
+        const includeBundled = opts.includeBundledSkill !== false;
+        const rootDirs = resolveSkillsRoots(includeBundled
+            ? [...resolveSkillsRoots(opts.skillsRoot), bundledRoot]
+            : opts.skillsRoot);
+        if (action.kind === "install") {
+            return await runInstallAction(action, rootDirs, opts, stdin, stdout, stderr);
+        }
+        if (action.kind === "list") {
+            if (action.json) {
+                const payload = await listSkillsJson(rootDirs);
+                stdout.write(JSON.stringify(payload));
+            }
+            else {
+                const skills = await listSkills(rootDirs);
+                if (skills.length > 0) {
+                    const lines = skills.map((skill) => skill.summary ? `${skill.id}\t${skill.summary}` : skill.id);
+                    stdout.write(`${lines.join("\n")}\n`);
+                }
+            }
+            return 0;
+        }
+        if (action.kind === "export") {
+            const skillDir = await resolveSkillDirFromRoots(rootDirs, action.id);
+            await exportSkill(skillDir, action.id, stdout);
+            return 0;
+        }
+        if (action.kind === "help") {
+            stdout.write(`${SKILLFLAG_HELP_TEXT}\n`);
+            return 0;
+        }
+        const skillDir = await resolveSkillDirFromRoots(rootDirs, action.id);
+        await showSkill(skillDir, action.id, stdout);
+        return 0;
+    }
+    catch (err) {
+        const message = toErrorMessage(err);
+        stderr.write(`${message}\n`);
+        return err instanceof SkillflagError ? err.exitCode : 1;
+    }
+}
+export async function maybeHandleSkillflag(argv, opts) {
+    if (!argv.includes("--skill")) {
+        return false;
+    }
+    const { exit, ...skillOpts } = opts;
+    const exitCode = await handleSkillflag(argv, skillOpts);
+    if (exit !== false) {
+        const exitFn = exit ?? process.exit;
+        exitFn(exitCode);
+    }
+    return true;
+}
+//# sourceMappingURL=skillflag.js.map

package/node_modules/skillflag/dist/skillflag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillflag.js","sourceRoot":"","sources":["../src/skillflag.ts"],"names":[],"mappings":"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"}

package/node_modules/skillflag/dist/utils/collections.d.ts

@@ -0,0 +1,3 @@
+export declare function compareStrings(a: string, b: string): number;
+export declare function uniqueValues<T>(values: readonly T[]): T[];
+//# sourceMappingURL=collections.d.ts.map

package/node_modules/skillflag/dist/utils/collections.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.d.ts","sourceRoot":"","sources":["../../src/utils/collections.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAO3D;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,EAAE,CAQzD"}

package/node_modules/skillflag/dist/utils/collections.js

@@ -0,0 +1,18 @@
+export function compareStrings(a, b) {
+    // Compare by UTF-8 bytes, the cross-implementation contract for tar entry
+    // and skill-id ordering (see docs/DETERMINISTIC_TAR.md). localeCompare
+    // would depend on the host locale, and plain string comparison would order
+    // by UTF-16 code units, which disagrees with UTF-8 byte order for
+    // supplementary-plane characters.
+    return Buffer.compare(Buffer.from(a, "utf8"), Buffer.from(b, "utf8"));
+}
+export function uniqueValues(values) {
+    const out = [];
+    for (const value of values) {
+        if (!out.includes(value)) {
+            out.push(value);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=collections.js.map

package/node_modules/skillflag/dist/utils/collections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collections.js","sourceRoot":"","sources":["../../src/utils/collections.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,CAAS,EAAE,CAAS;IACjD,0EAA0E;IAC1E,uEAAuE;IACvE,2EAA2E;IAC3E,kEAAkE;IAClE,kCAAkC;IAClC,OAAO,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,YAAY,CAAI,MAAoB;IAClD,MAAM,GAAG,GAAQ,EAAE,CAAC;IACpB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;YACzB,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/node_modules/skillflag/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "skillflag",
+  "version": "0.2.1",
+  "description": "Skillflag producer CLI reference implementation.",
+  "license": "MIT",
+  "author": "Onur Solmaz <info@solmaz.io>",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/osolmaz/skillflag.git",
+    "directory": "typescript"
+  },
+  "bugs": {
+    "url": "https://github.com/osolmaz/skillflag/issues"
+  },
+  "homepage": "https://github.com/osolmaz/skillflag#readme",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "skillflag": "dist/bin/skillflag.js",
+    "skill-install": "dist/bin/skill-install.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "build:test": "tsc -p tsconfig.test.json",
+    "format": "prettier --write . --ignore-unknown",
+    "format:check": "prettier --check . --ignore-unknown",
+    "lint": "eslint . --max-warnings 0",
+    "prepack": "npm run build",
+    "prepare": "cd .. && husky typescript/.husky",
+    "release": "release-it",
+    "release:ci": "release-it --ci",
+    "test": "npm run -s build:test && node --test dist-test/test/integration/*.test.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "skills"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@clack/prompts": "^1.0.1",
+    "tar-stream": "^3.1.7"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.0.0",
+    "@types/node": "^18.19.0",
+    "@types/tar-stream": "^3.1.3",
+    "eslint": "^9.0.0",
+    "husky": "^9.1.7",
+    "lint-staged": "^15.5.2",
+    "prettier": "^3.0.0",
+    "release-it": "^19.2.4",
+    "typescript": "^5.6.0",
+    "typescript-eslint": "^8.0.0"
+  },
+  "lint-staged": {
+    "*.{js,ts}": [
+      "prettier --write --ignore-unknown",
+      "eslint --fix"
+    ],
+    "*.{json,md}": [
+      "prettier --write --ignore-unknown"
+    ]
+  }
+}

package/node_modules/skillflag/skills/skillflag/SKILL.md

@@ -0,0 +1,144 @@
+---
+name: skillflag
+description: Skillflag producer/installer usage and install guidance (requires skill-install).
+---
+
+# Skillflag + skill-install
+
+This skill documents how to use the Skillflag producer CLI (`skillflag`) and the installer CLI (`skill-install`).
+
+## What this repo provides
+
+- `skillflag --skill list` lists bundled skill IDs
+- `skillflag --skill export <id>` exports a skill bundle as a tar stream
+- `skill-install` consumes a skill directory or tar stream and installs it into a target agent scope
+
+## Quick start
+
+List skills:
+
+```
+skillflag --skill list
+```
+
+Export the bundled skill and install into Codex repo scope:
+
+```
+skillflag --skill export skillflag | skill-install --agent codex --scope repo
+```
+
+Export the bundled skill and install into Claude repo scope:
+
+```
+skillflag --skill export skillflag | skill-install --agent claude --scope repo
+```
+
+## skill-install inputs
+
+Directory input:
+
+```
+skill-install ./skills/skillflag --agent codex --scope repo
+```
+
+Tar stream input (from producer):
+
+```
+skillflag --skill export skillflag | skill-install --agent codex --scope repo
+```
+
+Tar stream input with interactive target selection (when a TTY is available):
+
+```
+skillflag --skill export skillflag | skill-install
+```
+
+Show installer usage/help:
+
+```
+skill-install --help
+```
+
+## Notes
+
+- `skillflag` is the producer interface; it never installs.
+- `skill-install` validates `SKILL.md` frontmatter and installs by copy.
+- The full specification lives at `docs/SKILLFLAG_SPEC.md`.
+
+## Spec essentials (producer)
+
+- Producer CLIs MUST implement:
+  - `--skill list`
+  - `--skill export <id>`
+- `--skill list --json` MAY be provided and must emit a single JSON object to stdout.
+- `--skill list` writes only skill IDs to stdout (no banners).
+- `--skill export <id>` streams a tar with a single top‑level `<id>/` and `<id>/SKILL.md`.
+- Export output MUST be deterministic: sorted entries, fixed `mtime = 0`, `uid/gid = 0`.
+- All errors go to stderr, exit code `1` on failure.
+- Skills should be bundled under `skills/<id>/SKILL.md` or `.agents/skills/<id>/SKILL.md`.
+
+## Adding Skillflag to a Node CLI (library integration)
+
+Install the library:
+
+```
+npm install skillflag
+```
+
+Global install (exposes `skillflag` and `skill-install` on PATH):
+
+```
+npm install -g skillflag
+```
+
+Run without installing (uses bundled binaries):
+
+```
+npx skillflag --skill list
+npx skillflag install --agent codex --scope repo ./skills/skillflag
+```
+
+Early‑intercept in your CLI entrypoint so stdout stays clean:
+
+```ts
+// src/bin/cli.ts
+import { findSkillsRoot, maybeHandleSkillflag } from "skillflag";
+
+await maybeHandleSkillflag(process.argv, {
+  skillsRoot: findSkillsRoot(import.meta.url),
+  // includeBundledSkill: false, // opt out of the built-in skillflag skill
+});
+
+// ... normal CLI startup here
+```
+
+Repository layout (bundled skills):
+
+```
+skills/
+  my-skill/
+    SKILL.md
+    templates/...
+```
+
+Portable agent-skill layout is also supported:
+
+```
+.agents/
+  skills/
+    my-skill/
+      SKILL.md
+      templates/...
+```
+
+Package distribution:
+
+- Ensure `skills/` or `.agents/skills/` is included in `package.json` `files` so it ships with the npm tarball.
+
+## Installing without global install
+
+Use the `skillflag install` convenience command to avoid a global install:
+
+```
+npx skillflag install --agent codex --scope repo ./skills/skillflag
+```

package/node_modules/streamx/LICENSE

@@ -0,0 +1,21 @@
+The MIT License (MIT)
+
+Copyright (c) 2019 Mathias Buus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.