habit-hooks 0.1.0-beta.0

package/dist/checks/comment-check.js

@@ -0,0 +1,83 @@
+import { Project, SyntaxKind } from 'ts-morph';
+export const DEFAULT_COMMENT_CHECK_THRESHOLDS = {
+    maxSingleLineChars: 10,
+    maxBlockChars: 15,
+};
+function isExcludedComment(text) {
+    return text.includes('eslint-disable');
+}
+function isReportableSingle(text, thresholds) {
+    if (!text.startsWith('//'))
+        return false;
+    if (isExcludedComment(text))
+        return false;
+    return text.length >= thresholds.maxSingleLineChars;
+}
+function isReportableBlock(text, thresholds) {
+    if (!text.startsWith('/*'))
+        return false;
+    if (isExcludedComment(text))
+        return false;
+    return text.length >= thresholds.maxBlockChars;
+}
+function truncate(text) {
+    const collapsed = text.replace(/\s+/g, ' ').trim();
+    return collapsed.length > 50 ? `${collapsed.substring(0, 50)}...` : collapsed;
+}
+function makeViolation(file, comment, kind) {
+    return {
+        ruleId: 'comment:non-essential',
+        file,
+        line: comment.getStartLineNumber(),
+        message: `${kind}-line comment: "${truncate(comment.getText())}"`,
+    };
+}
+function classifyBlock(text) {
+    return text.startsWith('/**') ? 'JSDoc' : 'block';
+}
+function collectSingles(source, file, thresholds) {
+    return source
+        .getDescendantsOfKind(SyntaxKind.SingleLineCommentTrivia)
+        .filter((c) => isReportableSingle(c.getText().trim(), thresholds))
+        .map((c) => makeViolation(file, c, 'single'));
+}
+function collectBlocks(source, file, thresholds) {
+    return source
+        .getDescendantsOfKind(SyntaxKind.MultiLineCommentTrivia)
+        .filter((c) => isReportableBlock(c.getText().trim(), thresholds))
+        .map((c) => makeViolation(file, c, classifyBlock(c.getText().trim())));
+}
+function collectJsDoc(source, file, thresholds) {
+    return source
+        .getDescendantsOfKind(SyntaxKind.JSDoc)
+        .filter((c) => isReportableBlock(c.getText().trim(), thresholds))
+        .map((c) => makeViolation(file, c, 'JSDoc'));
+}
+function findCommentsInFile(source, thresholds) {
+    const file = source.getFilePath();
+    return [
+        ...collectSingles(source, file, thresholds),
+        ...collectBlocks(source, file, thresholds),
+        ...collectJsDoc(source, file, thresholds),
+    ];
+}
+function buildProject(files) {
+    const project = new Project({ skipAddingFilesFromTsConfig: true });
+    project.addSourceFilesAtPaths(files);
+    return project;
+}
+function resolveThresholds(rules) {
+    const rule = rules.find((r) => r.id === 'comment:non-essential');
+    return rule?.commentCheck ?? DEFAULT_COMMENT_CHECK_THRESHOLDS;
+}
+export const commentCheck = {
+    id: 'comment',
+    async run(files, rules) {
+        if (files.length === 0)
+            return [];
+        const thresholds = resolveThresholds(rules);
+        const project = buildProject(files);
+        return project.getSourceFiles().flatMap((s) => findCommentsInFile(s, thresholds));
+    },
+};
+//# sourceMappingURL=comment-check.js.map

package/dist/checks/comment-check.js.map

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

package/dist/checks/eslint-wrap.d.ts

@@ -0,0 +1,2 @@
+import type { Check } from '../types.js';
+export declare const eslintWrap: Check;

package/dist/checks/eslint-wrap.js

@@ -0,0 +1,104 @@
+import { createRequire } from 'node:module';
+import { dirname, join } from 'node:path';
+import { runTool } from '../wrap/shell.js';
+import { detectTool } from '../detect/tool.js';
+import { lookupPrompt } from '../prompts/registry.js';
+import { emptyOutcome, firstLine, isSpawnFailure, noticesFor, spawnFailureWarning, } from '../wrap/notices.js';
+import { spawnTarget } from '../wrap/resolve.js';
+import { parseJsonStdout } from '../wrap/run.js';
+const require = createRequire(import.meta.url);
+function bundledEslintBin() {
+    const main = require.resolve('eslint');
+    return join(dirname(main), '..', 'bin', 'eslint.js');
+}
+function resolveEslintBin(cwd) {
+    const detected = detectTool(cwd, 'eslint');
+    if (detected !== null)
+        return { binPath: detected.binPath, isFallback: false };
+    return { binPath: bundledEslintBin(), isFallback: true };
+}
+function configWarning(cwd, detail) {
+    const suffix = detail.length > 0 ? `: ${detail}` : '';
+    return `habit-hooks: eslint skipped in ${cwd} (config error)${suffix}`;
+}
+function tryParseJson(stdout) {
+    return parseJsonStdout(stdout, '[');
+}
+function isConfigError(result, parsed) {
+    if (parsed !== null)
+        return false;
+    if (isSpawnFailure(result))
+        return false;
+    return result.exitCode !== 0 && result.exitCode !== 1;
+}
+function messageToViolation(filePath, m) {
+    const ruleId = `eslint:${m.ruleId}`;
+    const prompt = lookupPrompt(ruleId);
+    const title = prompt?.title ?? m.ruleId;
+    return { ruleId, file: filePath, line: m.line, column: m.column, message: `${title}: ${m.message}` };
+}
+function fatalToViolation(filePath, m) {
+    return {
+        ruleId: 'eslint:fatal',
+        file: filePath,
+        line: m.line,
+        column: m.column,
+        message: `Fatal parse/config error: ${m.message}`,
+    };
+}
+function isFatalMessage(m) {
+    if (m.ruleId !== null)
+        return false;
+    if (m.fatal === true)
+        return true;
+    return m.severity === 2;
+}
+function toViolation(filePath, m) {
+    if (isFatalMessage(m))
+        return fatalToViolation(filePath, m);
+    if (m.ruleId === null)
+        return null;
+    return messageToViolation(filePath, { ...m, ruleId: m.ruleId });
+}
+function fileResultToViolations(result) {
+    return result.messages
+        .map((m) => toViolation(result.filePath, m))
+        .filter((v) => v !== null);
+}
+function parseEslintJson(stdout) {
+    const parsed = tryParseJson(stdout);
+    if (parsed === null)
+        return [];
+    return parsed.flatMap(fileResultToViolations);
+}
+function buildArgs(files) {
+    return ['--format', 'json', ...files];
+}
+async function executeEslint(resolution, cwd, files) {
+    const target = spawnTarget(resolution.binPath, buildArgs(files));
+    return runTool({ bin: target.bin, args: target.args, cwd });
+}
+function failureNotices(cwd, result) {
+    const detail = firstLine(result.stderr.length > 0 ? result.stderr : result.stdout);
+    return [configWarning(cwd, detail)];
+}
+async function runEslint(resolution, cwd, files) {
+    const notices = noticesFor('eslint', resolution, cwd);
+    const result = await executeEslint(resolution, cwd, files);
+    const parsed = tryParseJson(result.stdout);
+    if (isSpawnFailure(result))
+        return emptyOutcome([...notices, spawnFailureWarning('eslint', cwd, result.warnings)]);
+    if (isConfigError(result, parsed))
+        return emptyOutcome([...notices, ...failureNotices(cwd, result)]);
+    return { violations: parseEslintJson(result.stdout), stderr: notices };
+}
+export const eslintWrap = {
+    id: 'eslint',
+    async run(files, _rules, cwd) {
+        const runCwd = cwd ?? process.cwd();
+        if (files.length === 0)
+            return { violations: [], stderr: [] };
+        return runEslint(resolveEslintBin(runCwd), runCwd, files);
+    },
+};
+//# sourceMappingURL=eslint-wrap.js.map

package/dist/checks/eslint-wrap.js.map

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

package/dist/checks/jscpd-wrap.d.ts

@@ -0,0 +1,6 @@
+import { type BinResolution } from '../wrap/notices.js';
+import type { Check, CheckOutcome } from '../types.js';
+export declare function tryBundledJscpdBin(resolver?: () => string): string | null;
+export declare function resolveJscpdBin(cwd: string, fallbackResolver?: () => string): BinResolution | null;
+export declare function runJscpdWrap(files: string[], cwd: string, resolution: BinResolution | null): Promise<CheckOutcome>;
+export declare const jscpdWrap: Check;

package/dist/checks/jscpd-wrap.js

@@ -0,0 +1,158 @@
+import { createRequire } from 'node:module';
+import { existsSync, mkdtempSync, readFileSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { detectTool } from '../detect/tool.js';
+import { hasPackageJsonKey } from '../detect/package-json.js';
+import { absolutize, emptyOutcome, firstLine, noticesFor } from '../wrap/notices.js';
+import { isSpawnSkip, spawnWrapped } from '../wrap/run.js';
+const require = createRequire(import.meta.url);
+const RULE_ID = 'jscpd:duplication';
+const REPORT_FILENAME = 'jscpd-report.json';
+const JSCPD_CONFIG_FILES = ['.jscpd.json', 'jscpd.json'];
+function findPackageRoot(start) {
+    let dir = start;
+    while (dir !== dirname(dir)) {
+        if (existsSync(join(dir, 'package.json')))
+            return dir;
+        dir = dirname(dir);
+    }
+    throw new Error(`Could not find package.json from ${start}`);
+}
+function bundledJscpdBin() {
+    const main = require.resolve('jscpd');
+    const pkgRoot = findPackageRoot(dirname(main));
+    const pkg = JSON.parse(readFileSync(join(pkgRoot, 'package.json'), 'utf8'));
+    const binRel = typeof pkg.bin === 'string' ? pkg.bin : pkg.bin?.jscpd ?? 'bin/jscpd';
+    return join(pkgRoot, binRel);
+}
+export function tryBundledJscpdBin(resolver = bundledJscpdBin) {
+    try {
+        return resolver();
+    }
+    catch {
+        return null;
+    }
+}
+export function resolveJscpdBin(cwd, fallbackResolver = bundledJscpdBin) {
+    const detected = detectTool(cwd, 'jscpd');
+    if (detected !== null)
+        return { binPath: detected.binPath, isFallback: false };
+    const fallback = tryBundledJscpdBin(fallbackResolver);
+    if (fallback === null)
+        return null;
+    return { binPath: fallback, isFallback: true };
+}
+function reportMissingWarning(cwd, code, stderr) {
+    const detail = firstLine(stderr);
+    const suffix = detail.length > 0 ? `: ${detail}` : '';
+    return `habit-hooks: jscpd skipped in ${cwd} (exit ${code}, no report)${suffix}`;
+}
+function parseFailureWarning(cwd) {
+    return `habit-hooks: jscpd skipped in ${cwd} (unparseable report)`;
+}
+function unresolvedBinWarning(cwd) {
+    return `habit-hooks: jscpd skipped in ${cwd} (could not locate bundled bin)`;
+}
+function locationDescription(loc, cwd) {
+    return `${absolutize(cwd, loc.name)}:${loc.startLoc.line}-${loc.endLoc.line}`;
+}
+function buildViolation(self, partner, cwd) {
+    return {
+        ruleId: RULE_ID,
+        file: absolutize(cwd, self.name),
+        line: self.startLoc.line,
+        column: self.startLoc.column,
+        message: `duplicates ${locationDescription(partner, cwd)}`,
+    };
+}
+function isInScope(loc, scope, cwd) {
+    return scope.has(absolutize(cwd, loc.name));
+}
+function cloneToViolations(clone, scope, cwd) {
+    const violations = [];
+    if (isInScope(clone.firstFile, scope, cwd)) {
+        violations.push(buildViolation(clone.firstFile, clone.secondFile, cwd));
+    }
+    if (isInScope(clone.secondFile, scope, cwd)) {
+        violations.push(buildViolation(clone.secondFile, clone.firstFile, cwd));
+    }
+    return violations;
+}
+function reportToViolations(report, scope, cwd) {
+    return (report.duplicates ?? []).flatMap((c) => cloneToViolations(c, scope, cwd));
+}
+function tryReadReport(reportDir) {
+    const path = join(reportDir, REPORT_FILENAME);
+    if (!existsSync(path))
+        return null;
+    try {
+        return JSON.parse(readFileSync(path, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function buildArgs(reportDir) {
+    return ['-r', 'json', '-o', reportDir, '--silent', '--noTips', '-n', '.'];
+}
+function makeReportDir() {
+    return mkdtempSync(join(tmpdir(), 'hh-jscpd-'));
+}
+function removeReportDir(reportDir) {
+    rmSync(reportDir, { recursive: true, force: true });
+}
+function missingReportOutcome(inputs, result) {
+    if (result.exitCode !== 0) {
+        return emptyOutcome([...inputs.notices, reportMissingWarning(inputs.cwd, result.exitCode, result.stderr)]);
+    }
+    return emptyOutcome([...inputs.notices, parseFailureWarning(inputs.cwd)]);
+}
+async function runOnce(inputs, reportDir) {
+    const { resolution, cwd } = inputs;
+    const result = await spawnWrapped({ tool: 'jscpd', resolution, cwd, args: buildArgs(reportDir) });
+    if (isSpawnSkip(result))
+        return emptyOutcome([...inputs.notices, result.skipWarning]);
+    const report = tryReadReport(reportDir);
+    if (report === null)
+        return missingReportOutcome(inputs, result);
+    return { violations: reportToViolations(report, inputs.scope, inputs.cwd), stderr: inputs.notices };
+}
+async function runJscpd(inputs) {
+    const reportDir = makeReportDir();
+    try {
+        return await runOnce(inputs, reportDir);
+    }
+    finally {
+        removeReportDir(reportDir);
+    }
+}
+function hasJscpdConfig(cwd) {
+    if (JSCPD_CONFIG_FILES.some((name) => existsSync(join(cwd, name))))
+        return true;
+    return hasPackageJsonKey(cwd, 'jscpd');
+}
+function noConfigOutcome(cwd, notices) {
+    return emptyOutcome([...notices, `habit-hooks: jscpd skipped in ${cwd} (no jscpd config)`]);
+}
+function noBinOutcome(cwd) {
+    return emptyOutcome([unresolvedBinWarning(cwd)]);
+}
+export async function runJscpdWrap(files, cwd, resolution) {
+    if (files.length === 0)
+        return { violations: [], stderr: [] };
+    if (resolution === null)
+        return noBinOutcome(cwd);
+    const notices = noticesFor('jscpd', resolution, cwd);
+    if (!hasJscpdConfig(cwd))
+        return noConfigOutcome(cwd, notices);
+    return runJscpd({ resolution, cwd, scope: new Set(files), notices });
+}
+export const jscpdWrap = {
+    id: 'jscpd',
+    async run(files, _rules, cwd) {
+        const runCwd = cwd ?? process.cwd();
+        return runJscpdWrap(files, runCwd, resolveJscpdBin(runCwd));
+    },
+};
+//# sourceMappingURL=jscpd-wrap.js.map

package/dist/checks/jscpd-wrap.js.map

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

package/dist/checks/knip-resolve.d.ts

@@ -0,0 +1,4 @@
+import { type BinResolution } from '../wrap/notices.js';
+export declare function resolveKnipBin(cwd: string): BinResolution;
+export declare function consumerKnipMajor(cwd: string): number | null;
+export declare function buildKnipArgs(resolution: BinResolution, cwd: string): string[];

package/dist/checks/knip-resolve.js

@@ -0,0 +1,49 @@
+import { createRequire } from 'node:module';
+import { readFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { detectTool } from '../detect/tool.js';
+const require = createRequire(import.meta.url);
+const KNIP_BASE_ARGS = ['--reporter', 'json', '--no-exit-code'];
+function bundledKnipDir() {
+    const main = require.resolve('knip');
+    return join(dirname(main), '..');
+}
+function bundledKnipBin() {
+    return join(bundledKnipDir(), 'bin', 'knip.js');
+}
+export function resolveKnipBin(cwd) {
+    const detected = detectTool(cwd, 'knip');
+    if (detected !== null)
+        return { binPath: detected.binPath, isFallback: false };
+    return { binPath: bundledKnipBin(), isFallback: true };
+}
+function readMajorFromPackageJson(path) {
+    try {
+        const pkg = JSON.parse(readFileSync(path, 'utf8'));
+        if (typeof pkg.version !== 'string')
+            return null;
+        const major = Number.parseInt(pkg.version.split('.')[0] ?? '', 10);
+        return Number.isFinite(major) ? major : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function consumerKnipMajor(cwd) {
+    return readMajorFromPackageJson(join(cwd, 'node_modules', 'knip', 'package.json'));
+}
+function bundledKnipMajor() {
+    return readMajorFromPackageJson(join(bundledKnipDir(), 'package.json'));
+}
+function effectiveKnipMajor(resolution, cwd) {
+    if (resolution.isFallback)
+        return bundledKnipMajor();
+    return consumerKnipMajor(cwd);
+}
+export function buildKnipArgs(resolution, cwd) {
+    const major = effectiveKnipMajor(resolution, cwd);
+    if (major !== null && major >= 6)
+        return [...KNIP_BASE_ARGS];
+    return [...KNIP_BASE_ARGS, '--include', 'classMembers'];
+}
+//# sourceMappingURL=knip-resolve.js.map

package/dist/checks/knip-resolve.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knip-resolve.js","sourceRoot":"","sources":["../../src/checks/knip-resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG/C,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAE/C,MAAM,cAAc,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAEhE,SAAS,cAAc;IACrB,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,cAAc;IACrB,OAAO,IAAI,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IACzC,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAC/E,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AACzD,CAAC;AAED,SAAS,wBAAwB,CAAC,IAAY;IAC5C,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAA0B,CAAC;QAC5E,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACjD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QACnE,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,wBAAwB,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC;AACrF,CAAC;AAED,SAAS,gBAAgB;IACvB,OAAO,wBAAwB,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,cAAc,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED,SAAS,kBAAkB,CAAC,UAAyB,EAAE,GAAW;IAChE,IAAI,UAAU,CAAC,UAAU;QAAE,OAAO,gBAAgB,EAAE,CAAC;IACrD,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,UAAyB,EAAE,GAAW;IAClE,MAAM,KAAK,GAAG,kBAAkB,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAClD,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,CAAC,GAAG,cAAc,CAAC,CAAC;IAC7D,OAAO,CAAC,GAAG,cAAc,EAAE,WAAW,EAAE,cAAc,CAAC,CAAC;AAC1D,CAAC"}

package/dist/checks/knip-schema.d.ts

@@ -0,0 +1,32 @@
+export interface KnipLocation {
+    name: string;
+    line?: number;
+    col?: number;
+}
+export type KnipMemberMap = Record<string, KnipLocation[]>;
+export interface KnipIssue {
+    file: string;
+    files?: KnipLocation[];
+    dependencies?: KnipLocation[];
+    devDependencies?: KnipLocation[];
+    optionalPeerDependencies?: KnipLocation[];
+    unlisted?: KnipLocation[];
+    binaries?: KnipLocation[];
+    unresolved?: KnipLocation[];
+    exports?: KnipLocation[];
+    nsExports?: KnipLocation[];
+    types?: KnipLocation[];
+    nsTypes?: KnipLocation[];
+    duplicates?: KnipLocation[][];
+    enumMembers?: KnipMemberMap;
+    classMembers?: KnipMemberMap;
+    namespaceMembers?: KnipMemberMap;
+    catalog?: KnipLocation[];
+}
+export interface KnipReport {
+    files?: string[];
+    issues?: KnipIssue[];
+}
+export declare const LOCATION_KEYS: (keyof KnipIssue)[];
+export declare const MEMBER_KEYS: (keyof KnipIssue)[];
+export declare const KNOWN_KEYS: Set<string>;

package/dist/checks/knip-schema.js

@@ -0,0 +1,24 @@
+export const LOCATION_KEYS = [
+    'files',
+    'dependencies',
+    'devDependencies',
+    'optionalPeerDependencies',
+    'unlisted',
+    'binaries',
+    'unresolved',
+    'exports',
+    'nsExports',
+    'types',
+    'nsTypes',
+    'catalog',
+];
+export const MEMBER_KEYS = ['enumMembers', 'classMembers', 'namespaceMembers'];
+const STRUCTURAL_KEYS = new Set(['file']);
+const SPECIAL_KEYS = new Set(['duplicates']);
+export const KNOWN_KEYS = new Set([
+    ...STRUCTURAL_KEYS,
+    ...SPECIAL_KEYS,
+    ...LOCATION_KEYS,
+    ...MEMBER_KEYS,
+]);
+//# sourceMappingURL=knip-schema.js.map

package/dist/checks/knip-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knip-schema.js","sourceRoot":"","sources":["../../src/checks/knip-schema.ts"],"names":[],"mappings":"AAiCA,MAAM,CAAC,MAAM,aAAa,GAAwB;IAChD,OAAO;IACP,cAAc;IACd,iBAAiB;IACjB,0BAA0B;IAC1B,UAAU;IACV,UAAU;IACV,YAAY;IACZ,SAAS;IACT,WAAW;IACX,OAAO;IACP,SAAS;IACT,SAAS;CACV,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAwB,CAAC,aAAa,EAAE,cAAc,EAAE,kBAAkB,CAAC,CAAC;AAEpG,MAAM,eAAe,GAAG,IAAI,GAAG,CAAS,CAAC,MAAM,CAAC,CAAC,CAAC;AAClD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAS,CAAC,YAAY,CAAC,CAAC,CAAC;AAErD,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAS;IACxC,GAAG,eAAe;IAClB,GAAG,YAAY;IACf,GAAI,aAA0B;IAC9B,GAAI,WAAwB;CAC7B,CAAC,CAAC"}

package/dist/checks/knip-wrap.d.ts

@@ -0,0 +1,4 @@
+import { buildKnipArgs, consumerKnipMajor, resolveKnipBin } from './knip-resolve.js';
+import type { Check } from '../types.js';
+export { buildKnipArgs, consumerKnipMajor, resolveKnipBin };
+export declare const knipWrap: Check;

package/dist/checks/knip-wrap.js

@@ -0,0 +1,127 @@
+import { existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { hasPackageJsonKey } from '../detect/package-json.js';
+import { absolutize, emptyOutcome, firstLine, noticesFor } from '../wrap/notices.js';
+import { isSpawnSkip, parseJsonStdout, spawnWrapped } from '../wrap/run.js';
+import { buildKnipArgs, consumerKnipMajor, resolveKnipBin } from './knip-resolve.js';
+import { KNOWN_KEYS, LOCATION_KEYS, MEMBER_KEYS, } from './knip-schema.js';
+export { buildKnipArgs, consumerKnipMajor, resolveKnipBin };
+const KNIP_CONFIG_FILES = ['knip.json', 'knip.jsonc', 'knip.ts', 'knip.js'];
+function exitFailureWarning(cwd, code, stderr) {
+    const detail = firstLine(stderr);
+    const suffix = detail.length > 0 ? `: ${detail}` : '';
+    return `habit-hooks: knip skipped in ${cwd} (exit ${code})${suffix}`;
+}
+function buildViolation(args) {
+    const { ruleId, file, message, loc } = args;
+    return { ruleId, file, line: loc.line ?? 1, column: loc.col, message };
+}
+function locationToViolation(ctx, loc) {
+    const ruleId = `knip:${ctx.issueType}`;
+    return buildViolation({ ruleId, file: absolutize(ctx.cwd, ctx.issueFile), message: loc.name, loc });
+}
+function memberToViolation(ctx, owner, loc) {
+    const ruleId = `knip:${ctx.issueType}`;
+    return buildViolation({ ruleId, file: absolutize(ctx.cwd, ctx.issueFile), message: `${owner}.${loc.name}`, loc });
+}
+function flattenMemberMap(ctx, members) {
+    return Object.entries(members).flatMap(([owner, list]) => list.map((loc) => memberToViolation(ctx, owner, loc)));
+}
+function buildIssueContext(cwd, issue, key) {
+    return { cwd, issueType: key, issueFile: issue.file };
+}
+function locationsForKey(issue, key, cwd) {
+    const value = issue[key];
+    if (!Array.isArray(value) || value.length === 0)
+        return [];
+    const ctx = buildIssueContext(cwd, issue, key);
+    return value.map((loc) => locationToViolation(ctx, loc));
+}
+function membersForKey(issue, key, cwd) {
+    const value = issue[key];
+    if (value === undefined || value === null || Array.isArray(value))
+        return [];
+    return flattenMemberMap(buildIssueContext(cwd, issue, key), value);
+}
+function warnDuplicatesIfPresent(issue, cwd) {
+    if (issue.duplicates === undefined || issue.duplicates.length === 0)
+        return;
+    const file = absolutize(cwd, issue.file);
+    process.stderr.write(`habit-hooks: knip duplicates issue ignored in ${file} (not yet supported)\n`);
+}
+function isPopulated(value) {
+    if (value === undefined || value === null)
+        return false;
+    if (Array.isArray(value))
+        return value.length > 0;
+    if (typeof value === 'object')
+        return Object.keys(value).length > 0;
+    return true;
+}
+function unknownKeyToViolation(cwd, issue, key) {
+    const ruleId = `knip:${key}`;
+    const file = absolutize(cwd, issue.file);
+    const message = 'unrecognised knip issue type';
+    return { ruleId, file, line: 1, message };
+}
+function unknownKeysForIssue(issue, cwd) {
+    const record = issue;
+    return Object.keys(record)
+        .filter((k) => !KNOWN_KEYS.has(k) && isPopulated(record[k]))
+        .map((k) => unknownKeyToViolation(cwd, issue, k));
+}
+function issueToViolations(issue, cwd) {
+    warnDuplicatesIfPresent(issue, cwd);
+    const fromLocations = LOCATION_KEYS.flatMap((k) => locationsForKey(issue, k, cwd));
+    const fromMembers = MEMBER_KEYS.flatMap((k) => membersForKey(issue, k, cwd));
+    const fromUnknown = unknownKeysForIssue(issue, cwd);
+    return [...fromLocations, ...fromMembers, ...fromUnknown];
+}
+function fileEntryToViolation(cwd, file) {
+    const ruleId = 'knip:files';
+    return { ruleId, file: absolutize(cwd, file), line: 1, message: file };
+}
+function reportToViolations(report, cwd) {
+    const filesViolations = (report.files ?? []).map((f) => fileEntryToViolation(cwd, f));
+    const issuesViolations = (report.issues ?? []).flatMap((i) => issueToViolations(i, cwd));
+    return [...filesViolations, ...issuesViolations];
+}
+function hasPackageJson(cwd) {
+    return existsSync(join(cwd, 'package.json'));
+}
+function hasKnipConfig(cwd) {
+    if (KNIP_CONFIG_FILES.some((name) => existsSync(join(cwd, name))))
+        return true;
+    return hasPackageJsonKey(cwd, 'knip');
+}
+async function runKnip(resolution, cwd, notices) {
+    const result = await spawnWrapped({ tool: 'knip', resolution, cwd, args: buildKnipArgs(resolution, cwd) });
+    if (isSpawnSkip(result))
+        return emptyOutcome([...notices, result.skipWarning]);
+    const report = parseJsonStdout(result.stdout, '{');
+    if (report === null)
+        return emptyOutcome([...notices, exitFailureWarning(cwd, result.exitCode, result.stderr)]);
+    return { violations: reportToViolations(report, cwd), stderr: notices };
+}
+function noPackageJsonOutcome(cwd, notices) {
+    return emptyOutcome([...notices, `habit-hooks: knip skipped in ${cwd} (no package.json)`]);
+}
+function noConfigOutcome(cwd, notices) {
+    return emptyOutcome([...notices, `habit-hooks: knip skipped in ${cwd} (no knip config)`]);
+}
+export const knipWrap = {
+    id: 'knip',
+    async run(files, _rules, cwd) {
+        const runCwd = cwd ?? process.cwd();
+        if (files.length === 0)
+            return { violations: [], stderr: [] };
+        const resolution = resolveKnipBin(runCwd);
+        const notices = noticesFor('knip', resolution, runCwd);
+        if (!hasPackageJson(runCwd))
+            return noPackageJsonOutcome(runCwd, notices);
+        if (!hasKnipConfig(runCwd))
+            return noConfigOutcome(runCwd, notices);
+        return runKnip(resolution, runCwd, notices);
+    },
+};
+//# sourceMappingURL=knip-wrap.js.map