feat: add example

scripts/check-skill.mjs

@@ -2,98 +2,49 @@ import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 import skillConfig from '../src-skills/slm-design/skill.config.mjs';
+import {
+  createSkillBundle,
+  listBundleFiles,
+  resolveSkillPaths,
+  validateSkillBundle,
+} from './lib/skill-bundle.mjs';
 
 const repoRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..');
-const skillDir = path.join(repoRoot, 'skills', skillConfig.name);
-const skillPath = path.join(skillDir, 'SKILL.md');
-const referenceFiles = [
-  'README.md',
-  'canons/business-factory.md',
-  'canons/business-runtime-boundary.md',
-  'canons/decision-process.md',
-  'canons/file-atlas.md',
-  'canons/index.md',
-  'canons/layers.md',
-  'canons/modules.md',
-  'canons/monorepo.md',
-  'canons/segments.md',
-  'canons/validation.md',
-  'examples/business-composition.md',
-  'examples/business-testing.md',
-  'examples/react/composition-provider.md',
-  'examples/react/composition-structures.md',
-];
+const { outputDir } = resolveSkillPaths({ config: skillConfig, repoRoot });
+const bundle = createSkillBundle({ config: skillConfig, repoRoot });
 
-const assert = (condition, message) => {
-  if (!condition) {
-    throw new Error(message);
-  }
-};
+validateSkillBundle({ bundle, config: skillConfig, repoRoot });
 
-const listMarkdownFiles = (directoryPath) => {
-  return fs.readdirSync(directoryPath, { withFileTypes: true }).flatMap((entry) => {
-    const entryPath = path.join(directoryPath, entry.name);
-
-    if (entry.isDirectory()) {
-      return listMarkdownFiles(entryPath);
-    }
-
-    return entry.isFile() && path.extname(entry.name) === '.md' ? [entryPath] : [];
-  });
-};
-
-const assertLocalLinksExist = (filePath) => {
-  const content = fs.readFileSync(filePath, 'utf8');
-  const links = [...content.matchAll(/]\(([^)\s]+)(?:\s+"[^"]*")?\)/g)];
-
-  for (const [, rawTarget] of links) {
-    if (rawTarget.startsWith('#') || /^[a-z][a-z+.-]*:/i.test(rawTarget) || rawTarget.startsWith('//')) {
-      continue;
-    }
-
-    const [targetPath] = rawTarget.split('#');
-    const resolvedPath = path.resolve(path.dirname(filePath), targetPath);
-
-    assert(fs.existsSync(resolvedPath), `Broken link in ${path.relative(repoRoot, filePath)}: ${rawTarget}`);
-  }
-};
-
-assert(fs.existsSync(skillPath), 'Run npm run build before checking the skill.');
-
-const skillContent = fs.readFileSync(skillPath, 'utf8');
-
-assert(skillContent.startsWith(`---\nname: ${skillConfig.name}\n`), 'SKILL.md must contain the skill name in frontmatter.');
-assert(skillContent.includes('description: '), 'SKILL.md must contain a description in frontmatter.');
-assert(!skillContent.includes('<!-- include:'), 'SKILL.md contains an unresolved include.');
-assert(!skillContent.includes('/home/gromov/'), 'SKILL.md must not contain an absolute workspace path.');
-assert(!skillContent.includes('reference/slm-design'), 'SKILL.md contains an old documentation path.');
-assert(skillContent.includes('## Процесс архитектурного решения'), 'SKILL.md does not include the decision process.');
-assert(skillContent.includes('## Runtime-граница business'), 'SKILL.md does not include the business runtime boundary.');
-assert(skillContent.includes('## Архитектурная проверка'), 'SKILL.md does not include the validation rules.');
-assert(
-  skillContent.includes('./reference/canons/business-factory.md'),
-  'The business factory link must point to local reference documentation.',
-);
-
-for (const referenceFile of referenceFiles) {
-  assert(
-    fs.existsSync(path.join(skillDir, 'reference', referenceFile)),
-    `Missing copied reference file: ${referenceFile}`,
-  );
+if (!fs.existsSync(outputDir)) {
+  throw new Error('Generated skill is missing. Run npm run build:skill.');
 }
 
-for (const filePath of listMarkdownFiles(skillDir)) {
-  const content = fs.readFileSync(filePath, 'utf8');
+const actualFiles = listBundleFiles(outputDir);
+const actualPaths = actualFiles
+  .map((filePath) => path.relative(outputDir, filePath).replaceAll(path.sep, '/'))
+  .sort();
+const expectedPaths = [...bundle.keys()];
 
-  assert(
-    !content.includes('/home/gromov/'),
-    `${path.relative(repoRoot, filePath)} contains an absolute workspace path.`,
-  );
-  assert(
-    !content.includes('reference/slm-design'),
-    `${path.relative(repoRoot, filePath)} contains an old documentation path.`,
-  );
-  assertLocalLinksExist(filePath);
+if (actualPaths.join('\n') !== expectedPaths.join('\n')) {
+  const missing = expectedPaths.filter((filePath) => !actualPaths.includes(filePath));
+  const unexpected = actualPaths.filter((filePath) => !bundle.has(filePath));
+  const details = [
+    missing.length > 0 ? `Missing: ${missing.join(', ')}` : '',
+    unexpected.length > 0 ? `Unexpected: ${unexpected.join(', ')}` : '',
+  ]
+    .filter(Boolean)
+    .join('\n');
+
+  throw new Error(`Generated skill file list is stale. Run npm run build:skill.\n${details}`);
 }
 
-console.log(`Validated ${path.relative(repoRoot, skillPath)}`);
+for (const filePath of expectedPaths) {
+  const expected = bundle.get(filePath).content;
+  const actual = fs.readFileSync(path.join(outputDir, ...filePath.split('/')));
+
+  if (!actual.equals(expected)) {
+    throw new Error(`Generated skill file is stale: ${filePath}. Run npm run build:skill.`);
+  }
+}
+
+console.log(`Validated ${path.relative(repoRoot, outputDir)} (${bundle.size} files)`);