Konsistent uses “file” for values that may be either files or directories: excludeFiles, for.files, diagnostic filePath, filesChecked, and “Checked N files.” This obscures what was matched and reported. Blocked by #65, which establishes the replacement terminology for the file-versus-directory distinction.
Relevant files:
packages/konsistent/src/config/schema.tspackages/konsistent/src/core/runner.tspackages/konsistent/src/core/diagnostics.tspackages/konsistent/src/core/reporter.tsdocs/reference/configuration.md
Use “path” throughout, including excludePaths, for.paths, violation path, and pathsChecked. Add a separate violation property for the path kind established in #65 so consumers can distinguish file from directory without inferring it from the path.
Backward compatibility: internal names and documentation can be renamed or removed without compatibility shims. For konsistent.json changes, keep excludeFiles and for.files working with their existing behavior, mark them deprecated, and emit a non-failing CLI warning whenever they are used.
Konsistent uses “file” for values that may be either files or directories:
excludeFiles,for.files, diagnosticfilePath,filesChecked, and “Checked N files.” This obscures what was matched and reported. Blocked by #65, which establishes the replacement terminology for the file-versus-directory distinction.Relevant files:
packages/konsistent/src/config/schema.tspackages/konsistent/src/core/runner.tspackages/konsistent/src/core/diagnostics.tspackages/konsistent/src/core/reporter.tsdocs/reference/configuration.mdUse “path” throughout, including
excludePaths,for.paths, violationpath, andpathsChecked. Add a separate violation property for the path kind established in #65 so consumers can distinguishfilefromdirectorywithout inferring it from the path.Backward compatibility: internal names and documentation can be renamed or removed without compatibility shims. For
konsistent.jsonchanges, keepexcludeFilesandfor.filesworking with their existing behavior, mark them deprecated, and emit a non-failing CLI warning whenever they are used.