mirror of
https://github.com/pbakaus/impeccable.git
synced 2026-09-18 09:06:53 +03:00
70a9246401
- Marketplace source moved from "./" to "./plugin", a thin generated subtree containing only the plugin manifest and the impeccable skill. Per-version plugin cache shrinks ~378× (~770 KB instead of ~291 MB), and the lockfile is no longer included in the source path so the cache extraction never runs bun install. (#107) - skills field in plugin.json now ends with a trailing slash to match the documented schema (code.claude.com/docs/en/plugins-reference, every directory example uses ./path/). Three reporters converged on this fix because Claude Code's plugin loader skips command registration on some setups when the slash is missing. (#86) - Anti-patterns maintenance agent moved out of .claude/agents/ into CLAUDE.md / AGENTS.md as concise inline guidance, since it is repo-internal dev workflow, not user-facing. The plugin was also the only place this agent was exposed to install users. - Skills version bumped to 3.0.2 so existing users pick up the new install path on next /plugin update. - Top-level harness directories (.claude/skills/, .cursor/skills/, ...) intentionally stay where they are; npx skills add reads them directly from the GitHub repo and that path is unaffected. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
70 lines
2.2 KiB
JavaScript
70 lines
2.2 KiB
JavaScript
/**
|
|
* Decide whether a given file is "generated" (regenerated by a build step,
|
|
* unsafe to write variants into) or "source" (safe to edit, changes persist).
|
|
*
|
|
* Why this matters: when the user picks an element on a page whose underlying
|
|
* file is regenerated by a build step (e.g. `scripts/build-sub-pages.js`
|
|
* rewriting `public/docs/*.html`), writing variants or accepted changes into
|
|
* that file is silent data loss — the next build wipes them.
|
|
*
|
|
* Signals, in order of reliability:
|
|
* 1. Git check-ignore: gitignored files are assumed generated.
|
|
* 2. File-header markers ("GENERATED", "DO NOT EDIT", "AUTO-GENERATED")
|
|
* within the first ~300 characters — catches non-git projects.
|
|
*/
|
|
|
|
import { execSync } from 'node:child_process';
|
|
import fs from 'node:fs';
|
|
import path from 'node:path';
|
|
|
|
const HEADER_SCAN_BYTES = 300;
|
|
const HEADER_MARKERS = [
|
|
/@generated\b/i,
|
|
/\bGENERATED\s+FILE\b/,
|
|
/\bAUTO-?GENERATED\b/i,
|
|
/\bDO\s+NOT\s+EDIT\b/i,
|
|
];
|
|
|
|
/**
|
|
* @param {string} filePath - absolute or cwd-relative path
|
|
* @param {object} [options]
|
|
* @param {string} [options.cwd] - project root (defaults to process.cwd())
|
|
*/
|
|
export function isGeneratedFile(filePath, options = {}) {
|
|
const cwd = options.cwd || process.cwd();
|
|
const absPath = path.isAbsolute(filePath) ? filePath : path.resolve(cwd, filePath);
|
|
|
|
if (isGitIgnored(absPath, cwd)) return true;
|
|
if (hasGeneratedHeader(absPath)) return true;
|
|
return false;
|
|
}
|
|
|
|
function isGitIgnored(absPath, cwd) {
|
|
try {
|
|
execSync(`git check-ignore --quiet ${JSON.stringify(absPath)}`, {
|
|
cwd,
|
|
stdio: 'ignore',
|
|
});
|
|
return true; // exit 0 = ignored
|
|
} catch (err) {
|
|
// Exit code 1 = not ignored. Exit code 128 = not a git repo or other error.
|
|
// In both cases, treat as "not known to be ignored."
|
|
return false;
|
|
}
|
|
}
|
|
|
|
function hasGeneratedHeader(absPath) {
|
|
let fd;
|
|
try {
|
|
fd = fs.openSync(absPath, 'r');
|
|
const buf = Buffer.alloc(HEADER_SCAN_BYTES);
|
|
const bytesRead = fs.readSync(fd, buf, 0, HEADER_SCAN_BYTES, 0);
|
|
const head = buf.slice(0, bytesRead).toString('utf-8');
|
|
return HEADER_MARKERS.some((re) => re.test(head));
|
|
} catch {
|
|
return false;
|
|
} finally {
|
|
if (fd !== undefined) { try { fs.closeSync(fd); } catch {} }
|
|
}
|
|
}
|