@savvy-web/lint-staged 0.6.6 → 0.7.0

package/README.md

@@ -64,7 +64,7 @@ export default {
 ## Presets
 
 | Preset | Handlers |
-| ------ | -------- |
+| --- | --- |
 | `minimal()` | PackageJson, Biome |
 | `standard()` | + Markdown, Yaml, PnpmWorkspace, ShellScripts |
 | `silk()` | + TypeScript |
@@ -72,7 +72,7 @@ export default {
 ## Available Handlers
 
 | Handler | Files | Description |
-| ------- | ----- | ----------- |
+| --- | --- | --- |
 | `PackageJson` | `**/package.json` | Sort and format with Biome |
 | `Biome` | `*.{js,ts,jsx,tsx,json,jsonc}` | Format and lint |
 | `Markdown` | `**/*.{md,mdx}` | Lint with markdownlint-cli2 |
@@ -95,17 +95,31 @@ savvy-lint fmt yaml          # Format YAML files with Prettier
 savvy-lint fmt pnpm-workspace  # Sort and format pnpm-workspace.yaml
 ```
 
+## Claude Code Plugin
+
+A companion Claude Code plugin is available that automatically injects code
+quality context (Biome, markdownlint, and TypeScript conventions) at session
+start.
+
+```bash
+# Add the Savvy Web plugin marketplace (one-time setup)
+/plugin marketplace add savvy-web/systems
+
+# Install the lint-staged plugin for this project
+/plugin install lint-staged@savvy-web-systems --scope project
+```
+
 ## Documentation
 
-- [Handler Configuration](./docs/handlers.md) -- Detailed options for each handler
-- [Configuration API](./docs/configuration.md) -- createConfig and Preset APIs
-- [CLI Reference](./docs/cli.md) -- `savvy-lint init`, `check`, and `fmt`
-- [Utilities](./docs/utilities.md) -- Command, Filter, and advanced utilities
-- [Migration Guide](./docs/migration.md) -- Migrating from raw lint-staged configs
+- [Handler Configuration](../docs/handlers.md) -- Detailed options for each handler
+- [Configuration API](../docs/configuration.md) -- createConfig and Preset APIs
+- [CLI Reference](../docs/cli.md) -- `savvy-lint init`, `check`, and `fmt`
+- [Utilities](../docs/utilities.md) -- Command, Filter, and advanced utilities
+- [Migration Guide](../docs/migration.md) -- Migrating from raw lint-staged configs
 
 ## Contributing
 
-Contributions welcome! See [CONTRIBUTING.md](./CONTRIBUTING.md) for setup
+Contributions welcome! See [CONTRIBUTING.md](../CONTRIBUTING.md) for setup
 and guidelines.
 
 ## License

package/biome/silk.jsonc

@@ -133,7 +133,8 @@
 			"!**/.vitest",
 			"!**/.coverage",
 			"!coverage",
-			"!**/__test__/fixtures",
+			"!**/__test__/**/fixtures",
+			"!**/__test__/**/snapshots",
 			"!**/__fixtures__"
 		]
 	}

package/index.d.ts

@@ -19,14 +19,21 @@
  * @packageDocumentation
  */
 
+import { BiomeSchemaSync } from '@savvy-web/silk-effects';
 import { Command as Command_2 } from '@effect/cli';
+import { ConfigDiscovery } from '@savvy-web/silk-effects';
+import { ConfigDiscoveryLive } from '@savvy-web/silk-effects';
+import { ConfigLocation } from '@savvy-web/silk-effects';
 import { FileSystem } from '@effect/platform';
 import { FileSystem as FileSystem_2 } from '@effect/platform/FileSystem';
 import { JsoncModificationError } from 'jsonc-effect';
 import { JsoncParseError } from 'jsonc-effect';
+import { ManagedSection } from '@savvy-web/silk-effects';
 import { Option } from 'effect/Option';
 import { PlatformError } from '@effect/platform/Error';
-import { UnknownException } from 'effect/Cause';
+import { SectionParseError } from '@savvy-web/silk-effects';
+import { SectionWriteError } from '@savvy-web/silk-effects';
+import { ToolDiscovery } from '@savvy-web/silk-effects';
 
 /**
  * Base options shared by all handlers.
@@ -146,7 +153,7 @@ export declare interface BiomeOptions extends BaseHandlerOptions {
  * Validates the current lint-staged setup and displays detected settings.
  * With --quiet flag, only outputs warnings (for postinstall usage).
  */
-export declare const checkCommand: Command_2.Command<"check", FileSystem.FileSystem, JsoncParseError | UnknownException | PlatformError, {
+export declare const checkCommand: Command_2.Command<"check", BiomeSchemaSync | ConfigDiscovery | FileSystem.FileSystem | ManagedSection | ToolDiscovery, JsoncParseError | SectionParseError | PlatformError, {
     readonly quiet: boolean;
 }>;
 
@@ -159,11 +166,10 @@ export declare class Command {
     /** Cached project root path */
     private static cachedRoot;
     /**
-     * Find the project root directory using workspace-tools.
+     * Find the project root directory by walking up from `cwd`.
      *
-     * Uses `findProjectRoot()` from `workspace-tools` to locate the nearest
-     * directory containing a `package.json`. Falls back to the provided `cwd`
-     * (or `process.cwd()`) on error.
+     * Searches upward for the nearest directory containing a `package.json`.
+     * Falls back to the provided `cwd` (or `process.cwd()`) when none is found.
      *
      * @remarks
      * This is more reliable than `process.cwd()` in environments like Husky
@@ -299,128 +305,11 @@ export declare class Command {
     static execSilent(command: string): boolean;
 }
 
-/**
- * Static utility class for discovering configuration files.
- *
- * Searches in a prioritized order:
- * 1. `lib/configs/` directory first (agency convention)
- * 2. Standard locations (repo root, package.json, etc.)
- *
- * @example
- * ```typescript
- * import { ConfigSearch } from '@savvy-web/lint-staged';
- *
- * // Find markdownlint config
- * const result = ConfigSearch.find('markdownlint');
- * if (result.found) {
- *   console.log(`Found config at: ${result.filepath}`);
- * }
- *
- * // Find with custom search locations
- * const custom = ConfigSearch.findFile('myapp', {
- *   libConfigFiles: ['myapp.config.js'],
- *   standardPlaces: ['myapp.config.js', '.myapprc'],
- * });
- * ```
- */
-export declare class ConfigSearch {
-    /**
-     * Default directory for agency config files.
-     */
-    static readonly libConfigDir = "lib/configs";
-    /**
-     * Find a configuration file for a known tool.
-     *
-     * Supported tools: 'markdownlint', 'biome', 'eslint', 'prettier', 'yamllint'
-     *
-     * @param tool - The tool name
-     * @param options - Search options
-     * @returns Search result with filepath if found
-     *
-     * @example
-     * ```typescript
-     * const result = ConfigSearch.find('markdownlint');
-     * if (result.found) {
-     *   // Use result.filepath
-     * }
-     * ```
-     */
-    static find(tool: "markdownlint" | "biome" | "eslint" | "prettier" | "yamllint", options?: ConfigSearchOptions): ConfigSearchResult;
-    /**
-     * Find a configuration file with custom search locations.
-     *
-     * @param moduleName - The cosmiconfig module name
-     * @param options - Search configuration
-     * @returns Search result with filepath if found
-     *
-     * @example
-     * ```typescript
-     * const result = ConfigSearch.findFile('myapp', {
-     *   libConfigFiles: ['myapp.config.js'],
-     *   standardPlaces: ['myapp.config.js', '.myapprc'],
-     * });
-     * ```
-     */
-    static findFile(moduleName: string, options?: ConfigSearchOptions & {
-        libConfigFiles?: string[];
-        standardPlaces?: string[];
-    }): ConfigSearchResult;
-    /**
-     * Check if a config file exists at a specific path.
-     *
-     * @param filepath - Path to check
-     * @returns true if the file exists
-     */
-    static exists(filepath: string): boolean;
-    /**
-     * Get the path to a config file, checking lib/configs/ first.
-     *
-     * This is a simpler method that just checks for a specific filename
-     * in lib/configs/ first, then falls back to the provided default.
-     *
-     * @param filename - The config filename to look for
-     * @param fallback - Fallback path if not found in lib/configs/
-     * @returns The resolved config path
-     *
-     * @example
-     * ```typescript
-     * // Returns 'lib/configs/.markdownlint-cli2.jsonc' if it exists,
-     * // otherwise returns './.markdownlint-cli2.jsonc'
-     * const config = ConfigSearch.resolve(
-     *   '.markdownlint-cli2.jsonc',
-     *   './.markdownlint-cli2.jsonc'
-     * );
-     * ```
-     */
-    static resolve(filename: string, fallback: string): string;
-}
+export { ConfigDiscovery }
 
-/**
- * Options for config search.
- */
-export declare interface ConfigSearchOptions {
-    /** Starting directory for search (defaults to cwd) */
-    searchFrom?: string;
-    /** Stop searching when reaching this directory */
-    stopDir?: string;
-}
+export { ConfigDiscoveryLive }
 
-/**
- * Configuration file discovery utility using cosmiconfig.
- *
- * Searches for config files in a prioritized order:
- * 1. `lib/configs/` directory (agency convention)
- * 2. Standard locations (repo root, etc.)
- */
-/**
- * Result of a config search.
- */
-export declare interface ConfigSearchResult {
-    /** The resolved file path, or undefined if not found */
-    filepath: string | undefined;
-    /** Whether a config file was found */
-    found: boolean;
-}
+export { ConfigLocation }
 
 /**
  * Create a complete lint-staged configuration with all handlers.
@@ -851,7 +740,7 @@ export declare interface ImportGraphResult {
  * The managed section feature allows users to add custom hooks above/below
  * the savvy-lint section without them being overwritten on updates.
  */
-export declare const initCommand: Command_2.Command<"init", FileSystem.FileSystem, Error | JsoncModificationError | JsoncParseError | PlatformError, {
+export declare const initCommand: Command_2.Command<"init", BiomeSchemaSync | FileSystem.FileSystem | ManagedSection, Error | JsoncModificationError | JsoncParseError | SectionWriteError | PlatformError, {
     readonly force: boolean;
     readonly config: string;
     readonly preset: "minimal" | "silk" | "standard";
@@ -1316,7 +1205,7 @@ export declare type PresetExtendOptions = CreateConfigOptions;
 export declare type PresetType = "minimal" | "standard" | "silk";
 
 /** Root command for the CLI with all subcommands. */
-export declare const rootCommand: Command_2.Command<"savvy-lint", FileSystem_2, Error | JsoncModificationError | JsoncParseError | PlatformError, {
+export declare const rootCommand: Command_2.Command<"savvy-lint", BiomeSchemaSync | ConfigDiscovery | FileSystem_2 | ManagedSection | ToolDiscovery, Error | JsoncModificationError | JsoncParseError | SectionParseError | SectionWriteError | PlatformError, {
     readonly subcommand: Option<    {
     readonly force: boolean;
     readonly config: string;
@@ -1513,8 +1402,8 @@ export declare interface TsDocLintResult {
  * Resolves files for TSDoc linting based on workspace configuration.
  *
  * @remarks
- * This class handles both single-package repos and monorepos. It uses
- * `workspace-tools` to detect workspaces and checks for `tsdoc.json`
+ * This class handles both single-package repos and monorepos. It detects
+ * workspaces from pnpm-workspace.yaml or package.json and checks for `tsdoc.json`
  * configuration files to determine which packages need TSDoc linting.
  *
  * A workspace is enabled for TSDoc linting if: