@visulima/vis 1.0.0-alpha.2 → 1.0.0-alpha.20

package/skills/vis/SKILL.md

@@ -0,0 +1,96 @@
+---
+name: vis
+description: Use when the workspace contains a vis.config.ts (or vis.config.js/json) at the repo root, or when the user mentions "vis", "task-runner", or "@visulima/vis". This skill orchestrates the vis MCP server's eight read-only tools to inspect projects, plan task graphs, and diagnose remote-cache rotations.
+---
+
+# Working with the `vis` task runner
+
+`vis` is the Visulima monorepo task runner — a Turborepo/Nx-class tool with a remote cache, REAPI gRPC backend, and project graph. When this skill is active you have the **`@visulima/vis-mcp` server** mounted, exposing eight read-only tools. Use them in preference to running `vis` shell commands yourself: the tools give you structured JSON and run faster.
+
+The MCP server deliberately does NOT execute targets or scaffold templates — Nx-style "agent prepares, human executes". When the user wants to run `<project>:<target>` or `vis generate <template>`, prepare the command (use `list_targets`/`describe_template` to confirm it exists and capture required arguments) and ask the user to run it themselves; afterwards use `get_run_logs` to read the result of any task run.
+
+## Tools available
+
+| Tool                | Purpose                                                                                                                           |
+| ------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
+| `list_projects`     | All projects in the workspace, optionally filtered by a vis query (`tag=frontend`, `type=application`, …)                         |
+| `describe_project`  | Full metadata for one project: language, layer, tags, root path, all targets                                                      |
+| `list_targets`      | Per-target rows across the workspace, optionally narrowed to a single project                                                     |
+| `list_templates`    | Scaffolding templates discovered in `.vis/templates/`, `.moon/templates/`, and `vis.config.ts` `generator.templates`              |
+| `describe_template` | Variable schema, default destination, and description for a single template — required before suggesting a `vis generate` command |
+| `get_run_logs`      | Most recent run summary from `.task-runner/`, or a specific `runId`, optionally filtered to one task                              |
+| `cache_why`         | Diff a task's cache hash against the previous run — pinpoints what changed (command, nodes, runtime, implicit deps)               |
+| `cache_hash`        | Recorded hash and per-input hash details for a task                                                                               |
+
+## Workflow patterns
+
+### Discovery — "what's in this repo?"
+
+Default opening move when the user asks about the workspace:
+
+1. `list_projects` (no filter). Shows everything with categories and target counts.
+2. If they ask about a specific package, `describe_project` for the full picture rather than re-running list with a filter.
+
+### Plan a build
+
+1. `list_targets` (optionally with `project: "@scope/name"`) to see what `build`/`test`/`lint`/etc. targets exist.
+2. Tell the user the exact command (`vis run @scope/name:build`) and let them run it.
+3. Use `get_run_logs` afterwards to inspect status, cache hits, and stderr tails.
+
+### Investigate a cache miss
+
+When a build that should have been cached re-ran:
+
+1. `get_run_logs` (no args → latest summary) — surfaces all task statuses for the last run.
+2. For any task with status `success` but `cacheStatus: "miss"`, call `cache_why` with that `taskId`. It diffs hashDetails against the previous run and tells you which input rotated (command string, file content, `implicitDependency`, runtime version, …).
+3. If `cache_why` shows the change but the user wants to see the raw hash inputs, `cache_hash` returns the full per-input breakdown.
+
+### Scaffold a new package or component
+
+When the user asks for "a new X" / "scaffold Y":
+
+1. `list_templates` — pick the template whose `name` or `description` matches the user's request.
+2. `describe_template` with that name — read the `variables[]` schema. Identify which variables are `required` and which have sensible `default` values.
+3. Construct the command: `vis generate <name> -- --var1=value1 --var2=value2`. For interactive prompts, drop the `--` overrides and let the user step through. For `--defaults`-friendly templates, add `--defaults` to skip prompts.
+4. Hand the command to the user to execute. Don't fabricate variable values — if the user hasn't told you what to pass for a required variable, ask.
+
+#### Worked example
+
+User: _"Scaffold a new React button component called PrimaryButton."_
+
+1. Call `list_templates` → response contains an entry `{ "name": "component", "source": "native", "description": "Scaffold a React component" }`. That's the closest match.
+2. Call `describe_template` with `{ "name": "component" }` → response shows `variables`:
+    ```json
+    [
+        { "name": "name", "type": "string", "required": true, "prompt": "Component name?" },
+        { "name": "withTest", "type": "boolean", "required": false, "default": true },
+        { "name": "style", "type": "enum", "required": false, "default": "primary", "values": ["primary", "secondary"] }
+    ]
+    ```
+3. The user supplied `name` (`PrimaryButton`) and implied `style=primary` (default already matches). `withTest` is unspecified — the default is fine, no need to override.
+4. Suggested command for the user to run:
+    ```sh
+    vis generate component -- --name=PrimaryButton --style=primary
+    ```
+    Do **not** invent values for required variables the user never mentioned — ask first.
+
+### Diagnose a failed run
+
+1. `get_run_logs` to see which task(s) failed.
+2. `get_run_logs` with `taskId` set to the failing task — returns just that entry, including the captured stderr tail.
+3. Decide: is it a code bug (read the project's source), a cache poisoning issue (`cache_why`), or environmental (look at the run summary's `runtime` block)?
+
+## Safety rules
+
+- **All tools are read-only.** The server does not execute targets. If the user wants something built/tested/linted, give them the command and let them run it.
+- **All tools run in the directory where `vis-mcp` was launched.** Override at server startup by setting `VIS_MCP_WORKSPACE_ROOT`. You can read that path from the server's stderr boot line: `[vis-mcp] ready (workspace: …)`.
+
+## When NOT to use this skill
+
+- The user wants to write a `vis.config.ts` — that's editing source, not running the CLI. Use Read/Edit/Write on the config file directly.
+- The user is asking about Turborepo, Nx, or Bazel specifically (not vis). The tools won't help with those.
+- The repo has no `vis.config.*` and no mention of vis. Don't volunteer the tools.
+
+## Tool-result conventions
+
+All tools return JSON-encoded text in the standard MCP `content[].text` slot. On error, `isError: true` is set and the text payload is `{"error": "<message>"}`. Parse the JSON before reasoning about it — the text field is structured data, not prose.

package/templates/buildkite-ci/.buildkite/pipeline.yml.tera

@@ -0,0 +1,85 @@
+---
+to: ".buildkite/pipeline.yml"
+---
+# Generated by `vis generate buildkite-ci`.
+# Run `vis ci` against affected packages on every build.{% if withHeal %}
+# Heal block: on failure, `vis ai heal` posts a Buildkite annotation; an
+# allow-listed maintainer manually unblocks the block step to apply +
+# commit the patch via `vis ai heal accept`. The unblocker email
+# (BUILDKITE_UNBLOCKER_EMAIL) must be listed in `ai.heal.allowedActors`
+# in vis.config.ts or the accept step refuses to commit.{% endif %}
+
+steps:
+    - label: ":hammer: vis ci"
+      key: ci
+      timeout_in_minutes: 30
+      command: |
+{% if packageManager == "pnpm" %}          corepack enable
+          pnpm install --frozen-lockfile
+          pnpm vis ci {{ targets }}
+{% endif %}{% if packageManager == "npm" %}          npm ci
+          npx vis ci {{ targets }}
+{% endif %}{% if packageManager == "yarn" %}          corepack enable
+          yarn install --immutable
+          yarn vis ci {{ targets }}
+{% endif %}{% if packageManager == "bun" %}          bun install --frozen-lockfile
+          bunx vis ci {{ targets }}
+{% endif %}      agents:
+          queue: {{ agentQueue }}
+{% if withHeal %}
+    - label: ":sparkles: vis ai heal"
+      key: heal-propose
+      depends_on: ci
+      timeout_in_minutes: 30
+      # Only run when CI failed and the build is for a PR — heal-accept
+      # has nowhere to commit on push-event builds.
+      if: build.failed_jobs > 0 && build.pull_request.id != null
+      command: |
+{% if packageManager == "pnpm" %}          corepack enable
+          pnpm install --frozen-lockfile
+          pnpm vis ai heal
+{% endif %}{% if packageManager == "npm" %}          npm ci
+          npx vis ai heal
+{% endif %}{% if packageManager == "yarn" %}          corepack enable
+          yarn install --immutable
+          yarn vis ai heal
+{% endif %}{% if packageManager == "bun" %}          bun install --frozen-lockfile
+          bunx vis ai heal
+{% endif %}      agents:
+          queue: {{ agentQueue }}
+      # Buildkite has no commit API of its own — `vis ai heal accept`
+      # derives the upstream provider from BUILDKITE_REPO and commits
+      # through GitHub or GitLab. Set GITHUB_TOKEN or GITLAB_TOKEN on
+      # the agent (matching your remote) so heal accept can land the patch.
+
+    - block: ":white_check_mark: Apply AI heal patch?"
+      key: heal-gate
+      depends_on: heal-propose
+      if: build.failed_jobs > 0 && build.pull_request.id != null
+      prompt: |
+          Unblocking applies and commits the patch from the heal annotation.
+          The unblocker email (BUILDKITE_UNBLOCKER_EMAIL) must be listed in
+          `ai.heal.allowedActors` in vis.config.ts, otherwise the accept
+          step will refuse to commit.
+
+    - label: ":robot_face: vis ai heal accept"
+      key: heal-accept
+      depends_on: heal-gate
+      timeout_in_minutes: 30
+      # Defense in depth — heal-accept can't push to a fork and has no
+      # commit target on push-event builds. Refuse early.
+      if: build.pull_request.id != null
+      command: |
+{% if packageManager == "pnpm" %}          corepack enable
+          pnpm install --frozen-lockfile
+          pnpm vis ai heal accept
+{% endif %}{% if packageManager == "npm" %}          npm ci
+          npx vis ai heal accept
+{% endif %}{% if packageManager == "yarn" %}          corepack enable
+          yarn install --immutable
+          yarn vis ai heal accept
+{% endif %}{% if packageManager == "bun" %}          bun install --frozen-lockfile
+          bunx vis ai heal accept
+{% endif %}      agents:
+          queue: {{ agentQueue }}
+{% endif %}

package/templates/buildkite-ci/template.yml

@@ -0,0 +1,20 @@
+"title": "Buildkite CI"
+"description": "A Buildkite pipeline.yml that runs `vis ci` against affected packages, with an optional `vis ai heal` block-step flow."
+"variables":
+    "targets":
+        "type": "string"
+        "default": "lint,test,build"
+        "prompt": "Comma-separated list of `vis ci` targets to run"
+    "packageManager":
+        "type": "enum"
+        "values": ["pnpm", "npm", "yarn", "bun"]
+        "default": "pnpm"
+        "prompt": "Package manager (used in the install line)"
+    "withHeal":
+        "type": "boolean"
+        "default": false
+        "prompt": "Include the `vis ai heal` propose + block-step accept flow?"
+    "agentQueue":
+        "type": "string"
+        "default": "default"
+        "prompt": "Buildkite agent queue to schedule on"

package/dist/ai-analysis.d.ts

@@ -1,40 +0,0 @@
-import type { AiProviderInfo } from "@visulima/find-ai-runner";
-import type { OutdatedEntry } from "./catalog.d.ts";
-interface AiConfig {
-    /** Cache TTL in milliseconds. Overrides default (1h / 30min for security). */
-    cacheTtl?: number;
-    /** Override default provider priority. Higher = preferred. */
-    priority?: Record<string, number>;
-    /** Use a specific provider, skip auto-detection. */
-    provider?: string;
-}
-type AnalysisType = "compatibility" | "impact" | "recommend" | "security";
-declare const DEFAULT_PRIORITY: Record<string, number>;
-/** Resolve which AI provider to use based on config and availability. */
-declare const resolveProvider: (config?: AiConfig) => AiProviderInfo | undefined;
-interface AiRecommendation {
-    action: "defer" | "review" | "skip" | "update";
-    breakingChanges: string[];
-    effort: "high" | "low" | "medium";
-    package: string;
-    reason: string;
-    riskLevel: "critical" | "high" | "low" | "medium";
-}
-interface AiAnalysisResult {
-    analysisType: AnalysisType;
-    provider: string;
-    recommendations: AiRecommendation[];
-    summary: string;
-    warnings: string[];
-}
-declare const validateAnalysisType: (type: string) => AnalysisType;
-declare const buildAnalysisPrompt: (outdated: OutdatedEntry[], analysisType?: AnalysisType) => string;
-declare const extractJson: (text: string) => unknown | undefined;
-declare const normalizeRecommendation: (raw: Record<string, unknown>) => AiRecommendation;
-declare const parseAiResponse: (text: string, provider: string, analysisType: AnalysisType) => AiAnalysisResult;
-declare const ruleBasedAnalysis: (outdated: OutdatedEntry[], analysisType: AnalysisType) => AiAnalysisResult;
-declare const formatAiAnalysis: (result: AiAnalysisResult) => string;
-declare const formatAiAnalysisJson: (result: AiAnalysisResult) => string;
-declare const runAiAnalysis: (outdated: OutdatedEntry[], logger: Console, config?: AiConfig, analysisType?: AnalysisType) => Promise<AiAnalysisResult>;
-export type { AiAnalysisResult, AiConfig, AiRecommendation, AnalysisType };
-export { buildAnalysisPrompt, DEFAULT_PRIORITY, extractJson, formatAiAnalysis, formatAiAnalysisJson, normalizeRecommendation, parseAiResponse, resolveProvider, ruleBasedAnalysis, runAiAnalysis, validateAnalysisType, };

package/dist/ai-cache.d.ts

@@ -1,21 +0,0 @@
-import type { AiAnalysisResult, AnalysisType } from "./ai-analysis.d.ts";
-import type { OutdatedEntry } from "./catalog.d.ts";
-interface CacheEntry {
-    createdAt: number;
-    result: AiAnalysisResult;
-    ttlMs: number;
-}
-interface CacheStats {
-    entries: number;
-    newestEntry: number | undefined;
-    oldestEntry: number | undefined;
-    totalSizeBytes: number;
-}
-declare const buildCacheKey: (provider: string, analysisType: string, outdated: Pick<OutdatedEntry, "currentRange" | "packageName" | "targetVersion">[]) => string;
-declare const getCachedAnalysis: (cacheKey: string) => AiAnalysisResult | undefined;
-declare const setCachedAnalysis: (cacheKey: string, result: AiAnalysisResult, ttlMs: number) => void;
-declare const getTtlForAnalysisType: (analysisType: AnalysisType | string, configTtl?: number) => number;
-declare const getCacheStats: () => CacheStats;
-declare const clearCache: () => number;
-export type { CacheEntry, CacheStats };
-export { buildCacheKey, clearCache, getCachedAnalysis, getCacheStats, getTtlForAnalysisType, setCachedAnalysis };

package/dist/bin.d.ts

@@ -1 +0,0 @@
-export {};

package/dist/catalog.d.ts

@@ -1,110 +0,0 @@
-type UpdateTarget = "latest" | "minor" | "patch";
-interface ParsedVersion {
-    major: number;
-    minor: number;
-    patch: number;
-    prerelease: string;
-}
-interface SecurityVulnerability {
-    cvssScore?: number;
-    fixedVersions: string[];
-    id: string;
-    severity: "CRITICAL" | "HIGH" | "LOW" | "MODERATE" | "UNKNOWN";
-    summary: string;
-}
-interface OutdatedEntry {
-    catalogName: string;
-    currentRange: string;
-    newRange: string;
-    packageName: string;
-    targetVersion: string;
-    updateType: "major" | "minor" | "patch";
-    vulnerabilities?: SecurityVulnerability[];
-}
-interface CatalogCheckOptions {
-    exclude: string[];
-    include: string[];
-    includePrerelease: boolean;
-    security?: boolean;
-    target: UpdateTarget;
-}
-interface ReadCatalogOptions {
-    dev?: boolean;
-    prod?: boolean;
-}
-declare const parseVersion: (input: string) => ParsedVersion | undefined;
-declare const extractPrefix: (range: string) => string;
-declare const getUpdateType: (current: ParsedVersion, target: ParsedVersion) => "major" | "minor" | "none" | "patch";
-declare const isNewer: (current: ParsedVersion, target: ParsedVersion) => boolean;
-declare const matchesPattern: (name: string, pattern: string) => boolean;
-declare const matchesFilters: (name: string, include: string[], exclude: string[]) => boolean;
-declare const parseCatalogsFromYaml: (content: string) => Map<string, Map<string, string>>;
-interface BunPackageJson {
-    workspaces?: {
-        catalog?: Record<string, string>;
-        catalogs?: Record<string, Record<string, string>>;
-        packages?: string[];
-    };
-}
-declare const parseBunCatalogs: (pkg: BunPackageJson) => Map<string, Map<string, string>>;
-declare const parseCompositeCatalogName: (name: string) => {
-    depType: string;
-    relativePath: string;
-} | undefined;
-declare const readPackageJsonDeps: (workspaceRoot: string, options?: ReadCatalogOptions) => Map<string, Map<string, string>>;
-declare const hasPackageJsonDeps: (workspaceRoot: string) => boolean;
-declare const applyPackageJsonUpdates: (workspaceRoot: string, updates: OutdatedEntry[]) => void;
-type CatalogProvider = "bun" | "pnpm";
-declare const hasCatalogs: (workspaceRoot: string, packageManager?: string) => boolean;
-declare const readCatalogs: (workspaceRoot: string, packageManager?: string, options?: ReadCatalogOptions) => Map<string, Map<string, string>>;
-interface NpmrcConfig {
-    authTokens: Map<string, string>;
-    defaultRegistry: string;
-    registries: Map<string, string>;
-}
-declare const parseNpmrc: (content: string) => NpmrcConfig;
-declare const loadNpmrc: (workspaceRoot: string) => NpmrcConfig;
-declare const getRegistryForPackage: (packageName: string, config: NpmrcConfig) => {
-    token?: string;
-    url: string;
-};
-interface RegistryVersionInfo {
-    latest: string;
-    versions: string[];
-}
-declare const fetchPackageVersions: (packageName: string, registryConfig?: {
-    authToken?: string;
-    url: string;
-}, timeoutMs?: number) => Promise<RegistryVersionInfo>;
-declare const fetchVulnerabilities: (packages: {
-    name: string;
-    version: string;
-}[], timeoutMs?: number) => Promise<Map<string, SecurityVulnerability[]>>;
-declare const findTargetVersion: (versions: string[], latest: string, currentRange: string, target: UpdateTarget, includePrerelease: boolean) => string | undefined;
-interface CheckOutdatedResult {
-    failed: string[];
-    outdated: OutdatedEntry[];
-}
-declare const checkOutdated: (catalogs: Map<string, Map<string, string>>, options: CatalogCheckOptions, npmrcConfig?: NpmrcConfig, onProgress?: (current: number, total: number) => void) => Promise<CheckOutdatedResult>;
-declare const createBackup: (workspaceRoot: string, packageManager?: string, updates?: OutdatedEntry[]) => string | undefined;
-declare const restoreFromBackup: (workspaceRoot: string, packageManager?: string) => boolean;
-declare const hasBackup: (workspaceRoot: string, packageManager?: string) => boolean;
-type OutputFormat = "json" | "minimal" | "table";
-declare const formatOutdatedJson: (result: CheckOutdatedResult) => string;
-declare const formatOutdatedMinimal: (outdated: OutdatedEntry[]) => string;
-declare const toFilterArray: (value: string | string[] | undefined) => string[];
-declare const groupByCatalog: (entries: OutdatedEntry[]) => Map<string, OutdatedEntry[]>;
-declare const formatOutdatedTable: (outdated: OutdatedEntry[], logger: Console) => void;
-declare const formatSummary: (outdated: OutdatedEntry[]) => string;
-declare const detectJsonIndent: (content: string) => number | string;
-declare const applyCatalogUpdates: (workspaceRoot: string, updates: OutdatedEntry[], packageManager?: string, backup?: boolean) => string | undefined;
-declare const promptPackageSelection: (outdated: OutdatedEntry[]) => Promise<OutdatedEntry[]>;
-interface ChangelogInfo {
-    npmUrl: string;
-    packageName: string;
-    releaseUrl?: string;
-    repoUrl?: string;
-}
-declare const fetchChangelogInfo: (packages: OutdatedEntry[], timeoutMs?: number) => Promise<ChangelogInfo[]>;
-export type { CatalogCheckOptions, CatalogProvider, ChangelogInfo, CheckOutdatedResult, NpmrcConfig, OutdatedEntry, OutputFormat, ParsedVersion, ReadCatalogOptions, SecurityVulnerability, UpdateTarget, };
-export { applyCatalogUpdates, applyPackageJsonUpdates, checkOutdated, createBackup, detectJsonIndent, extractPrefix, fetchChangelogInfo, fetchPackageVersions, fetchVulnerabilities, findTargetVersion, formatOutdatedJson, formatOutdatedMinimal, formatOutdatedTable, formatSummary, getRegistryForPackage, getUpdateType, groupByCatalog, hasBackup, hasCatalogs, hasPackageJsonDeps, isNewer, loadNpmrc, matchesFilters, matchesPattern, parseBunCatalogs, parseCatalogsFromYaml, parseCompositeCatalogName, parseNpmrc, parseVersion, promptPackageSelection, readCatalogs, readPackageJsonDeps, restoreFromBackup, toFilterArray, };

package/dist/commands/affected.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const affected: Command;
-export default affected;

package/dist/commands/ai.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const ai: Command;
-export default ai;

package/dist/commands/analyze.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const analyze: Command;
-export default analyze;

package/dist/commands/check.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const check: Command;
-export default check;

package/dist/commands/graph.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const graph: Command;
-export default graph;

package/dist/commands/hook/constants.d.ts

@@ -1,8 +0,0 @@
-declare const HOOKS: readonly ["pre-commit", "pre-merge-commit", "prepare-commit-msg", "commit-msg", "post-commit", "applypatch-msg", "pre-applypatch", "post-applypatch", "pre-rebase", "post-rewrite", "post-checkout", "post-merge", "pre-push", "pre-auto-gc"];
-declare const DEFAULT_HOOKS_DIRECTORY = ".vis-hooks";
-interface InstallResult {
-    isError: boolean;
-    message: string;
-}
-export type { InstallResult };
-export { DEFAULT_HOOKS_DIRECTORY, HOOKS };

package/dist/commands/hook/index.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const hook: Command;
-export default hook;

package/dist/commands/hook/install.d.ts

@@ -1,7 +0,0 @@
-import type { InstallResult } from "./constants.d.ts";
-/**
- * Generates the shell script that dispatches to user-defined hooks.
- */
-declare const hookScript: (directory: string) => string;
-declare const installHooks: (directory?: string) => InstallResult;
-export { hookScript, installHooks };

package/dist/commands/hook/migrate.d.ts

@@ -1,27 +0,0 @@
-import type { PackageManagerType } from "../migrate/types.d.ts";
-import type { InstallResult } from "./constants.d.ts";
-/**
- * Detects which husky directory is in use, if any.
- */
-declare const detectHuskyDirectory: (root: string) => string | undefined;
-/**
- * Transforms a husky hook script for vis.
- * Removes the common.sh sourcing line since vis handles PATH setup in its dispatcher.
- */
-declare const transformHookScript: (content: string) => string;
-/**
- * Detects the package manager used in the project.
- */
-declare const detectPackageManager: (root: string) => PackageManagerType;
-/**
- * Cleans husky references from package.json scripts.
- */
-declare const cleanPackageJsonScripts: (root: string) => {
-    modified: boolean;
-    removedScriptReferences: string[];
-};
-/**
- * Migrates from husky to vis hooks.
- */
-declare const migrateFromHusky: (root: string, hooksDirectory: string, logger: Console) => InstallResult;
-export { cleanPackageJsonScripts, detectHuskyDirectory, detectPackageManager, migrateFromHusky, transformHookScript };

package/dist/commands/hook/uninstall.d.ts

@@ -1,3 +0,0 @@
-import type { InstallResult } from "./constants.d.ts";
-declare const uninstallHooks: (directory?: string) => InstallResult;
-export { uninstallHooks };

package/dist/commands/migrate/constants.d.ts

@@ -1,12 +0,0 @@
-declare const LINT_STAGED_JSON_CONFIG_FILES: readonly [".lintstagedrc.json", ".lintstagedrc"];
-declare const LINT_STAGED_OTHER_CONFIG_FILES: readonly [".lintstagedrc.yaml", ".lintstagedrc.yml", ".lintstagedrc.mjs", "lint-staged.config.mjs", ".lintstagedrc.cjs", "lint-staged.config.cjs", ".lintstagedrc.js", "lint-staged.config.js", ".lintstagedrc.ts", "lint-staged.config.ts", ".lintstagedrc.mts", "lint-staged.config.mts", ".lintstagedrc.cts", "lint-staged.config.cts"];
-declare const LINT_STAGED_ALL_CONFIG_FILES: ReadonlyArray<string>;
-declare const STALE_LINT_STAGED_PATTERNS: ReadonlyArray<RegExp>;
-declare const REPLACED_PACKAGES: readonly ["husky", "lint-staged"];
-declare const HUSKY_SCRIPT_PATTERNS: ReadonlyArray<RegExp>;
-/**
- * Remove husky references from a single script value.
- * Returns the cleaned script, or undefined if the entire script should be removed.
- */
-declare const cleanHuskyFromScript: (scriptValue: string) => string | undefined;
-export { cleanHuskyFromScript, HUSKY_SCRIPT_PATTERNS, LINT_STAGED_ALL_CONFIG_FILES, LINT_STAGED_JSON_CONFIG_FILES, LINT_STAGED_OTHER_CONFIG_FILES, REPLACED_PACKAGES, STALE_LINT_STAGED_PATTERNS, };

package/dist/commands/migrate/deps.d.ts

@@ -1,32 +0,0 @@
-import type { VisConfig } from "../../workspace.d.ts";
-import type { MigrationReport, PackageManagerType } from "./types.d.ts";
-interface MigrateLogger {
-    info: (message: string) => void;
-    warn: (message: string) => void;
-}
-/**
- * Rewrite scripts in package.json to replace husky/lint-staged references.
- */
-declare const rewriteScripts: (scripts: Record<string, string>, report: MigrationReport) => {
-    modified: boolean;
-    scripts: Record<string, string>;
-};
-/**
- * Rewrite a single package.json: remove replaced packages, add overrides, rewrite scripts.
- */
-declare const rewritePackageJson: (root: string, packageManager: PackageManagerType, overrides: Record<string, string>, report: MigrationReport) => void;
-/**
- * Iterate over all workspace packages and rewrite their package.json files.
- */
-declare const migrateMonorepoPackages: (root: string, packageManager: PackageManagerType, overrides: Record<string, string>, report: MigrationReport) => void;
-/**
- * Update pnpm-workspace.yaml catalog with override entries.
- */
-declare const updatePnpmWorkspaceCatalog: (root: string, overrides: Record<string, string>) => void;
-/**
- * Top-level orchestrator for dependency migration.
- */
-declare const migrateDeps: (root: string, packageManager: PackageManagerType, visConfig: VisConfig, options: {
-    dryRun: boolean;
-}, logger: MigrateLogger, report: MigrationReport) => void;
-export { migrateDeps, migrateMonorepoPackages, rewritePackageJson, rewriteScripts, updatePnpmWorkspaceCatalog };

package/dist/commands/migrate/index.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const migrate: Command;
-export default migrate;

package/dist/commands/migrate/json.d.ts

@@ -1,20 +0,0 @@
-/**
- * Reads and parses a JSON file. Returns undefined if the file doesn't exist or isn't valid JSON.
- */
-declare const readJsonFile: <T>(filePath: string) => T | undefined;
-/**
- * Checks if a file exists and contains valid JSON.
- */
-declare const isJsonFile: (filePath: string) => boolean;
-/**
- * Detect the indentation used in a JSON file by looking at the first indented line.
- */
-declare const detectJsonIndent: (content: string) => number;
-/**
- * Edits a JSON file in place using a mutator function.
- * The mutator receives the parsed data and should return the modified data,
- * or undefined to skip writing. Returns true if the file was modified.
- * Preserves the original indentation style.
- */
-declare const editJsonFile: <T>(filePath: string, mutator: (data: T) => T | undefined) => boolean;
-export { detectJsonIndent, editJsonFile, isJsonFile, readJsonFile };

package/dist/commands/migrate/lint-staged.d.ts

@@ -1,62 +0,0 @@
-import type { MigrationReport } from "./types.d.ts";
-interface MigrateLogger {
-    info: (message: string) => void;
-    warn: (message: string) => void;
-}
-/**
- * Check if a standalone lint-staged config file exists.
- */
-declare const hasStandaloneLintStagedConfig: (root: string) => boolean;
-/**
- * Check if a standalone lint-staged config exists in a format that can't be
- * auto-migrated (non-JSON files like .yaml, .mjs, .cjs, .js, or a non-JSON .lintstagedrc).
- */
-declare const hasUnsupportedLintStagedConfig: (root: string) => boolean;
-/**
- * Check if vis.config.ts already has a `staged` config key.
- */
-declare const hasStagedConfigInVisConfig: (root: string) => boolean;
-/**
- * Detect lint-staged config: returns the source ("package.json", a filename, or undefined).
- */
-declare const detectLintStagedConfig: (root: string) => string | undefined;
-/**
- * Extract lint-staged config from package.json.
- */
-declare const extractLintStagedFromPackageJson: (root: string) => Record<string, string | string[]> | undefined;
-/**
- * Parse a JSON lint-staged config file.
- */
-declare const parseLintStagedJsonFile: (filePath: string) => Record<string, string | string[]> | undefined;
-/**
- * Generate a TypeScript snippet for the staged block.
- */
-declare const generateStagedConfigSnippet: (config: Record<string, string | string[]>) => string;
-/**
- * Insert staged config into vis.config.ts. Creates the file if it doesn't exist.
- */
-declare const insertStagedIntoVisConfig: (root: string, config: Record<string, string | string[]>, logger: MigrateLogger) => boolean;
-/**
- * Remove `lint-staged` key, config, and dependency from package.json in a single read/write.
- * Returns which removals were performed.
- */
-declare const removeLintStagedFromPackageJson: (root: string) => {
-    configRemoved: boolean;
-    dependencyRemoved: boolean;
-};
-/**
- * Remove standalone lint-staged config files.
- */
-declare const removeLintStagedConfigFiles: (root: string, report: MigrationReport) => void;
-/**
- * Rewrite pre-commit hook to replace lint-staged invocations with `vis staged`.
- */
-declare const rewritePreCommitHook: (root: string, hooksDirectory: string) => boolean;
-/**
- * Migrates lint-staged configuration to vis.config.ts staged block.
- */
-declare const migrateLintStaged: (root: string, options: {
-    dryRun: boolean;
-    silent?: boolean;
-}, logger: MigrateLogger, report: MigrationReport) => boolean;
-export { detectLintStagedConfig, extractLintStagedFromPackageJson, generateStagedConfigSnippet, hasStagedConfigInVisConfig, hasStandaloneLintStagedConfig, hasUnsupportedLintStagedConfig, insertStagedIntoVisConfig, migrateLintStaged, parseLintStagedJsonFile, removeLintStagedConfigFiles, removeLintStagedFromPackageJson, rewritePreCommitHook, };

package/dist/commands/migrate/types.d.ts

@@ -1,20 +0,0 @@
-interface MigrateLogger {
-    info: (message: string) => void;
-    warn: (message: string) => void;
-}
-interface MigrationReport {
-    gitHooksConfigured: boolean;
-    inlinedLintStagedConfigCount: number;
-    manualSteps: string[];
-    mergedStagedConfigCount: number;
-    removedConfigCount: number;
-    removedPackageCount: number;
-    rewrittenScriptCount: number;
-    warnings: string[];
-}
-declare const createMigrationReport: () => MigrationReport;
-declare const addMigrationWarning: (report: MigrationReport | undefined, warning: string) => void;
-declare const addManualStep: (report: MigrationReport | undefined, step: string) => void;
-type PackageManagerType = "bun" | "npm" | "pnpm" | "yarn";
-export type { MigrateLogger, MigrationReport, PackageManagerType };
-export { addManualStep, addMigrationWarning, createMigrationReport };

package/dist/commands/run.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const run: Command;
-export default run;

package/dist/commands/staged.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const staged: Command;
-export default staged;

package/dist/commands/update.d.ts

@@ -1,3 +0,0 @@
-import type { Command } from "@visulima/cerebro";
-declare const update: Command;
-export default update;