devlyn-cli 4.2.0 → 4.2.2

package/bin/skill-ownership.js

@@ -0,0 +1,67 @@
+const crypto = require('crypto');
+const fs = require('fs');
+const path = require('path');
+const { spawnSync } = require('child_process');
+
+// A folder-metadata file the OS writes on its own (Finder, Explorer); never user content.
+// Only a regular file: a folder or link under that name is still the user's.
+function isOsMetadata(full) {
+  return ['.DS_Store', 'Thumbs.db'].includes(path.basename(full))
+    && fs.lstatSync(full, { throwIfNoEntry: false })?.isFile() === true;
+}
+
+// SHA-256 of a file with CRLF read as LF: Git for Windows checks text out with CRLF by
+// default, and an unedited clone must still match its shipped copy.
+function contentHash(file) {
+  const bytes = fs.readFileSync(file).toString('latin1').replace(/\r\n/g, '\n');
+  return crypto.createHash('sha256').update(bytes, 'latin1').digest('hex');
+}
+
+// Hash every entry, including empty directories and dotfiles, except OS metadata. Links and
+// special files are never installer-owned.
+function fingerprint(dir) {
+  const entries = [];
+  function visit(full, relative) {
+    const stat = fs.lstatSync(full);
+    if (stat.isDirectory()) {
+      entries.push([relative, 'directory']);
+      for (const name of fs.readdirSync(full).sort()) {
+        if (isOsMetadata(path.join(full, name))) continue;
+        visit(path.join(full, name), relative ? `${relative}/${name}` : name);
+      }
+    } else if (stat.isFile()) {
+      entries.push([relative, 'file', contentHash(full)]);
+    } else {
+      throw new Error(`link or special file: ${full}`);
+    }
+  }
+  if (!fs.lstatSync(dir).isDirectory()) throw new Error('not a real directory');
+  visit(dir, '');
+  return crypto.createHash('sha256').update(JSON.stringify(entries)).digest('hex');
+}
+
+// Use the index, not status: even files deleted locally need ownership checks.
+// Inspect the repository containing this root, including global dotfiles repos.
+function trackedPaths(root) {
+  let cwd = root;
+  while (!fs.existsSync(cwd)) cwd = path.dirname(cwd);
+  const env = { ...process.env, LC_ALL: 'C' };
+  for (const key of ['GIT_DIR', 'GIT_WORK_TREE', 'GIT_INDEX_FILE', 'GIT_COMMON_DIR',
+    'GIT_LITERAL_PATHSPECS', 'GIT_GLOB_PATHSPECS', 'GIT_NOGLOB_PATHSPECS', 'GIT_ICASE_PATHSPECS',
+    'GIT_CEILING_DIRECTORIES', 'GIT_DISCOVERY_ACROSS_FILESYSTEM']) delete env[key];
+  const git = (args) => spawnSync('git', ['-C', cwd, ...args], { encoding: 'utf8', env });
+  const repo = git(['rev-parse', '--show-toplevel']);
+  if (repo.error?.code === 'ENOENT') return [];
+  if (repo.error) throw repo.error;
+  if (repo.status !== 0) {
+    if (repo.status === 128 && repo.stderr.includes('not a git repository')) return [];
+    throw new Error(`cannot inspect Git ownership: ${repo.stderr.trim()}`);
+  }
+  // Conservative case folding also protects index spellings on macOS/Windows volumes.
+  const files = git(['ls-files', '--full-name', '-z', '--', `:(icase,literal)${root}`]);
+  if (files.error) throw files.error;
+  if (files.status !== 0) throw new Error(`cannot inspect Git index: ${files.stderr.trim()}`);
+  return files.stdout.split('\0').filter(Boolean).map((file) => path.resolve(repo.stdout.trim(), file));
+}
+
+module.exports = { contentHash, fingerprint, isOsMetadata, trackedPaths };

package/node_modules/@inquirer/ansi/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2025 Simon Boudrias
+
+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.

package/node_modules/@inquirer/ansi/README.md

@@ -0,0 +1,121 @@
+# @inquirer/ansi
+
+A lightweight package providing ANSI escape sequences for terminal cursor manipulation and screen clearing.
+
+# Installation
+
+<table>
+<tr>
+  <th>yarn</th>
+  <th>pnpm</th>
+</tr>
+<tr>
+<td>
+
+```sh
+yarn add @inquirer/ansi
+```
+
+</td>
+<td>
+
+```sh
+pnpm add @inquirer/ansi
+```
+
+</td>
+</tr>
+<tr>
+  <th>bun</th>
+  <th>deno</th>
+</tr>
+<tr>
+<td>
+
+```sh
+bun add @inquirer/ansi
+```
+
+</td>
+<td>
+
+```sh
+deno add npm:@inquirer/ansi
+```
+
+</td>
+</tr>
+<tr>
+<th colSpan="2">npm</th>
+</tr>
+<tr>
+<td colSpan="2">
+
+```sh
+npm install @inquirer/ansi
+```
+
+</td>
+</tr>
+</table>
+
+## Usage
+
+```js
+import {
+  cursorUp,
+  cursorDown,
+  cursorTo,
+  cursorLeft,
+  cursorHide,
+  cursorShow,
+  eraseLines,
+} from '@inquirer/ansi';
+
+// Move cursor up 3 lines
+process.stdout.write(cursorUp(3));
+
+// Move cursor to specific position (x: 10, y: 5)
+process.stdout.write(cursorTo(10, 5));
+
+// Hide/show cursor
+process.stdout.write(cursorHide);
+process.stdout.write(cursorShow);
+
+// Clear 5 lines
+process.stdout.write(eraseLines(5));
+```
+
+Or when used inside an inquirer prompt:
+
+```js
+import { cursorHide } from '@inquirer/ansi';
+import { createPrompt } from '@inquirer/core';
+
+export default createPrompt((config, done: (value: void) => void) => {
+  return `Choose an option${cursorHide}`;
+});
+```
+
+## API
+
+### Cursor Movement
+
+- **`cursorUp(count?: number)`** - Move cursor up by `count` lines (default: 1)
+- **`cursorDown(count?: number)`** - Move cursor down by `count` lines (default: 1)
+- **`cursorTo(x: number, y?: number)`** - Move cursor to position (x, y). If y is omitted, only moves horizontally
+- **`cursorLeft`** - Move cursor to beginning of line
+
+### Cursor Visibility
+
+- **`cursorHide`** - Hide the cursor
+- **`cursorShow`** - Show the cursor
+
+### Screen Manipulation
+
+- **`eraseLines(count: number)`** - Clear `count` lines and position cursor at the beginning of the first cleared line
+
+# License
+
+Copyright (c) 2025 Simon Boudrias (twitter: [@vaxilart](https://twitter.com/Vaxilart))<br/>
+Licensed under the MIT license.

package/node_modules/@inquirer/ansi/dist/index.d.ts

@@ -0,0 +1,14 @@
+/** Move cursor to first column */
+export declare const cursorLeft: string;
+/** Hide the cursor */
+export declare const cursorHide: string;
+/** Show the cursor */
+export declare const cursorShow: string;
+/** Move cursor up by count rows */
+export declare const cursorUp: (rows?: number) => string;
+/** Move cursor down by count rows */
+export declare const cursorDown: (rows?: number) => string;
+/** Move cursor to position (x, y) */
+export declare const cursorTo: (x: number, y?: number) => string;
+/** Erase the specified number of lines above the cursor */
+export declare const eraseLines: (lines: number) => string;

package/node_modules/@inquirer/ansi/dist/index.js

@@ -0,0 +1,21 @@
+const ESC = '\u001B[';
+/** Move cursor to first column */
+export const cursorLeft = ESC + 'G';
+/** Hide the cursor */
+export const cursorHide = ESC + '?25l';
+/** Show the cursor */
+export const cursorShow = ESC + '?25h';
+/** Move cursor up by count rows */
+export const cursorUp = (rows = 1) => (rows > 0 ? `${ESC}${rows}A` : '');
+/** Move cursor down by count rows */
+export const cursorDown = (rows = 1) => rows > 0 ? `${ESC}${rows}B` : '';
+/** Move cursor to position (x, y) */
+export const cursorTo = (x, y) => {
+    if (typeof y === 'number' && !Number.isNaN(y)) {
+        return `${ESC}${y + 1};${x + 1}H`;
+    }
+    return `${ESC}${x + 1}G`;
+};
+const eraseLine = ESC + '2K';
+/** Erase the specified number of lines above the cursor */
+export const eraseLines = (lines) => lines > 0 ? (eraseLine + cursorUp(1)).repeat(lines - 1) + eraseLine + cursorLeft : '';

package/node_modules/@inquirer/ansi/package.json

@@ -0,0 +1,79 @@
+{
+  "name": "@inquirer/ansi",
+  "version": "2.0.9",
+  "keywords": [
+    "ansi",
+    "answer",
+    "answers",
+    "ask",
+    "base",
+    "cli",
+    "command",
+    "command-line",
+    "confirm",
+    "enquirer",
+    "generate",
+    "generator",
+    "hyper",
+    "input",
+    "inquire",
+    "inquirer",
+    "interface",
+    "iterm",
+    "javascript",
+    "menu",
+    "node",
+    "nodejs",
+    "prompt",
+    "promptly",
+    "prompts",
+    "question",
+    "readline",
+    "scaffold",
+    "scaffolder",
+    "scaffolding",
+    "stdin",
+    "stdout",
+    "terminal",
+    "tty",
+    "ui",
+    "yeoman",
+    "yo",
+    "zsh"
+  ],
+  "homepage": "https://github.com/SBoudrias/Inquirer.js/blob/main/packages/ansi/README.md",
+  "license": "MIT",
+  "author": "Simon Boudrias <admin@simonboudrias.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/SBoudrias/Inquirer.js.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "tsc": "tsc"
+  },
+  "devDependencies": {
+    "@repo/tsconfig": "0.0.0",
+    "typescript": "^6.0.2"
+  },
+  "engines": {
+    "node": ">=23.5.0 || ^22.13.0 || ^20.17.0"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "gitHead": "a9436bd94d55a439df308f50e77a7cd0b2078e98"
+}

package/node_modules/@inquirer/checkbox/LICENSE

@@ -0,0 +1,22 @@
+Copyright (c) 2025 Simon Boudrias
+
+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.

package/node_modules/@inquirer/checkbox/README.md

@@ -0,0 +1,265 @@
+# `@inquirer/checkbox`
+
+Simple interactive command line prompt to display a list of checkboxes (multi select).
+
+![Checkbox prompt](https://cdn.rawgit.com/SBoudrias/Inquirer.js/28ae8337ba51d93e359ef4f7ee24e79b69898962/assets/screenshots/checkbox.svg)
+
+# Installation
+
+<table>
+<tr>
+  <th>yarn</th>
+  <th>pnpm</th>
+</tr>
+<tr>
+<td>
+
+```sh
+yarn add @inquirer/prompts
+```
+
+</td>
+<td>
+
+```sh
+pnpm add @inquirer/prompts
+```
+
+</td>
+</tr>
+<tr>
+  <th>bun</th>
+  <th>deno</th>
+</tr>
+<tr>
+<td>
+
+```sh
+bun add @inquirer/prompts
+```
+
+</td>
+<td>
+
+```sh
+deno add npm:@inquirer/prompts
+```
+
+</td>
+</tr>
+<tr>
+<th colSpan="2">npm</th>
+</tr>
+<tr>
+<td colSpan="2">
+
+```sh
+npm install @inquirer/prompts
+```
+
+</td>
+</tr>
+<tr>
+<td colSpan="2" align="center">Or</td>
+</tr>
+<tr>
+  <th>yarn</th>
+  <th>pnpm</th>
+</tr>
+<tr>
+<td>
+
+```sh
+yarn add @inquirer/checkbox
+```
+
+</td>
+<td>
+
+```sh
+pnpm add @inquirer/checkbox
+```
+
+</td>
+</tr>
+<tr>
+  <th>bun</th>
+  <th>deno</th>
+</tr>
+<tr>
+<td>
+
+```sh
+bun add @inquirer/checkbox
+```
+
+</td>
+<td>
+
+```sh
+deno add npm:@inquirer/checkbox
+```
+
+</td>
+</tr>
+<tr>
+<th colSpan="2">npm</th>
+</tr>
+<tr>
+<td colSpan="2">
+
+```sh
+npm install @inquirer/checkbox
+```
+
+</td>
+</tr>
+</table>
+
+On Deno, prompts detect the terminal's unicode and color support from the environment, so run your script with `--allow-env`.
+
+# Usage
+
+```js
+import { checkbox, Separator } from '@inquirer/prompts';
+// Or
+// import checkbox, { Separator } from '@inquirer/checkbox';
+
+const answer = await checkbox({
+  message: 'Select a package manager',
+  choices: [
+    { name: 'npm', value: 'npm' },
+    { name: 'yarn', value: 'yarn' },
+    new Separator(),
+    { name: 'pnpm', value: 'pnpm', disabled: true },
+    {
+      name: 'pnpm',
+      value: 'pnpm',
+      disabled: '(pnpm is not available)',
+    },
+  ],
+});
+```
+
+## Options
+
+| Property  | Type                                    | Required | Description                                                                                                                                                                                           |
+| --------- | --------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| message   | `string`                                | yes      | The question to ask                                                                                                                                                                                   |
+| choices   | `Choice[]`                              | yes      | List of the available choices.                                                                                                                                                                        |
+| pageSize  | `number`                                | no       | By default, lists of choice longer than 7 will be paginated. Use this option to control how many choices will appear on the screen at once.                                                           |
+| loop      | `boolean`                               | no       | Defaults to `true`. When set to `false`, the cursor will be constrained to the top and bottom of the choice list without looping.                                                                     |
+| required  | `boolean`                               | no       | When set to `true`, ensures at least one choice must be selected.                                                                                                                                     |
+| validate  | `async (Choice[]) => boolean \| string` | no       | On submit, validate the choices. When returning a string, it'll be used as the error message displayed to the user. Note: returning a rejected promise, we'll assume a code error happened and crash. |
+| shortcuts | [See Shortcuts](#Shortcuts)             | no       | Customize shortcut keys for `all` and `invert`.                                                                                                                                                       |
+| theme     | [See Theming](#Theming)                 | no       | Customize look of the prompt.                                                                                                                                                                         |
+
+`Separator` objects can be used in the `choices` array to render non-selectable lines in the choice list. By default it'll render a line, but you can provide the text as argument (`new Separator('-- Dependencies --')`). This option is often used to add labels to groups within long list of options.
+
+### `Choice` object
+
+The `Choice` object is typed as
+
+```ts
+type Choice<Value> = {
+  value: Value;
+  name?: string;
+  checkedName?: string;
+  description?: string;
+  short?: string;
+  checked?: boolean;
+  disabled?: boolean | string;
+};
+```
+
+Here's each property:
+
+- `value`: The value is what will be returned by `await checkbox()`.
+- `name`: This is the string displayed in the choice list.
+- `checkedName`: Alternative `name` (or format) displayed when the choice is checked.
+- `description`: Option for a longer description string that'll appear under the list when the cursor highlight a given choice.
+- `short`: Once the prompt is done (press enter), we'll use `short` if defined to render next to the question. By default we'll use `name`.
+- `checked`: If `true`, the option will be checked by default.
+- `disabled`: Disallow the option from being selected. If `disabled` is a string, it'll be used as a help tip explaining why the choice isn't available.
+
+Also note the `choices` array can contain `Separator`s to help organize long lists.
+
+`choices` can also be an array of string, in which case the string will be used both as the `value` and the `name`.
+
+## Keybindings
+
+Set `INQUIRER_KEYBINDINGS=vim`, `INQUIRER_KEYBINDINGS=emacs`, or `INQUIRER_KEYBINDINGS=vim,emacs` to enable alternative navigation keybindings globally.
+
+You can override the environment setting per prompt with `theme.keybindings`.
+
+## Shortcuts
+
+You can customize the shortcut keys for `all` and `invert` or disable them by setting them to `null`.
+
+```ts
+type Shortcuts = {
+  all?: string | null; // default: 'a'
+  invert?: string | null; // default: 'i'
+};
+```
+
+## Theming
+
+You can theme a prompt by passing a `theme` object option. The theme object only need to includes the keys you wish to modify, we'll fallback on the defaults for the rest.
+
+```ts
+type Theme = {
+  prefix: string | { idle: string; done: string };
+  spinner: {
+    interval: number;
+    frames: string[];
+  };
+  style: {
+    answer: (text: string) => string;
+    message: (text: string, status: 'idle' | 'done' | 'loading') => string;
+    error: (text: string) => string;
+    defaultAnswer: (text: string) => string;
+    help: (text: string) => string;
+    highlight: (text: string) => string;
+    key: (text: string) => string;
+    disabledChoice: (text: string) => string;
+    description: (text: string) => string;
+    renderSelectedChoices: <T>(
+      selectedChoices: ReadonlyArray<Choice<T>>,
+      allChoices: ReadonlyArray<Choice<T> | Separator>,
+    ) => string;
+    keysHelpTip: (keys: [key: string, action: string][]) => string | undefined;
+  };
+  icon: {
+    checked: string;
+    unchecked: string;
+    cursor: string;
+  };
+  keybindings: readonly ('emacs' | 'vim')[];
+};
+```
+
+### `theme.style.keysHelpTip`
+
+This function allows you to customize the keyboard shortcuts help tip displayed below the prompt. It receives an array of key-action pairs and should return a formatted string. You can also hook here to localize the labels to different languages.
+
+It can also returns `undefined` to hide the help tip entirely.
+
+```js
+theme: {
+  style: {
+    keysHelpTip: (keys) => {
+      // Return undefined to hide the help tip completely
+      return undefined;
+
+      // Or customize the formatting. Or localize the labels.
+      return keys.map(([key, action]) => `${key}: ${action}`).join(' | ');
+    };
+  }
+}
+```
+
+# License
+
+Copyright (c) 2023 Simon Boudrias (twitter: [@vaxilart](https://twitter.com/Vaxilart))<br/>
+Licensed under the MIT license.

package/node_modules/@inquirer/checkbox/dist/index.d.ts

@@ -0,0 +1,67 @@
+import { Separator, type Theme } from '@inquirer/core';
+import type { PartialDeep } from '@inquirer/type';
+type CheckboxTheme = {
+    icon: {
+        checked: string;
+        unchecked: string;
+        cursor: string;
+        disabledChecked: string;
+        disabledUnchecked: string;
+    };
+    style: {
+        disabled: (text: string) => string;
+        renderSelectedChoices: <T>(selectedChoices: ReadonlyArray<NormalizedChoice<T>>, allChoices: ReadonlyArray<NormalizedChoice<T> | Separator>) => string;
+        description: (text: string) => string;
+        keysHelpTip: (keys: [key: string, action: string][]) => string | undefined;
+    };
+    i18n: {
+        disabledError: string;
+    };
+};
+type CheckboxShortcuts = {
+    all?: string | null;
+    invert?: string | null;
+};
+type Choice<Value> = {
+    value: Value;
+    name?: string;
+    checkedName?: string;
+    description?: string;
+    short?: string;
+    disabled?: boolean | string;
+    checked?: boolean;
+    type?: never;
+};
+type NormalizedChoice<Value> = {
+    value: Value;
+    name: string;
+    checkedName: string;
+    description?: string;
+    short: string;
+    disabled: boolean | string;
+    checked: boolean;
+};
+type CheckboxConfig<Value = string> = {
+    message: string;
+    prefix?: string;
+    pageSize?: number;
+    choices: ReadonlyArray<Value | Choice<Value> | Separator>;
+    loop?: boolean;
+    required?: boolean;
+    validate?: (choices: readonly NormalizedChoice<Value>[]) => boolean | string | Promise<string | boolean>;
+    theme?: PartialDeep<Theme<CheckboxTheme>>;
+    shortcuts?: CheckboxShortcuts;
+};
+declare const _default: <const Value>(config: {
+    message: string;
+    prefix?: string | undefined;
+    pageSize?: number | undefined;
+    choices: readonly (Separator | Value | Choice<Value>)[];
+    loop?: boolean | undefined;
+    required?: boolean | undefined;
+    validate?: ((choices: readonly NormalizedChoice<Value>[]) => boolean | string | Promise<string | boolean>) | undefined;
+    theme?: PartialDeep<Theme<CheckboxTheme>> | undefined;
+    shortcuts?: CheckboxShortcuts | undefined;
+} & CheckboxConfig<Value>, context?: import("@inquirer/type").Context) => Promise<Value[]>;
+export default _default;
+export { Separator } from '@inquirer/core';