refactor: перенести сборку в проекты

- перенесены каноны и VitePress-конфиги в projects/<slug>

- добавлены корневой и проектные build.ts для сборки артефактов

- добавлены shared-библиотеки сборки в projects/_shared/lib

- обновлены CI, Dockerfile, package.json, gitignore и README

- удалена сборка frontend-агента

projects/_shared/lib/prepare-docs.ts

@@ -0,0 +1,112 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+
+type Page = {
+  source: string;
+  target: string;
+};
+
+type RouteRewrite = {
+  from: string;
+  to: string;
+};
+
+type DocsConfig = {
+  mounts: Page[];
+  routeRewrites?: RouteRewrite[];
+};
+
+type ProjectConfig = {
+  slug: string;
+  docsDir: string;
+};
+
+const MD_LINK_RE = /\]\((?!#|[a-z][a-z0-9+.-]*:|\/\/)([^)\s]+)(#[^)]*)?\)/gi;
+
+function normalizePath(value: string) {
+  return value.split(path.sep).join('/').replace(/^\.\//, '');
+}
+
+function formatRelativeMarkdownPath(fromTarget: string, toTarget: string) {
+  const relative = path.relative(path.dirname(fromTarget), toTarget).split(path.sep).join('/');
+  return relative.startsWith('.') ? relative : `./${relative}`;
+}
+
+async function loadDocsConfig(configPath: string) {
+  return (await import(`${pathToFileURL(configPath).href}?t=${Date.now()}`)) as DocsConfig;
+}
+
+export async function prepareDocs(projectDir: string, config: ProjectConfig) {
+  const docsDir = path.join(projectDir, config.docsDir);
+  const contentDir = path.join(docsDir, 'content');
+  const docsConfig = await loadDocsConfig(path.join(docsDir, 'docs.config.ts'));
+  const targetBySource = new Map(
+    docsConfig.mounts.map((page) => [normalizePath(path.resolve(projectDir, page.source)), normalizePath(page.target)]),
+  );
+  const routeRewrites = [...(docsConfig.routeRewrites ?? [])].sort((a, b) => b.from.length - a.from.length);
+
+  function applyRouteRewrites(route: string) {
+    for (const rewrite of routeRewrites) {
+      if (route === rewrite.from || route.startsWith(`${rewrite.from}/`) || route.startsWith(`${rewrite.from}#`)) {
+        return `${rewrite.to}${route.slice(rewrite.from.length)}`;
+      }
+    }
+
+    return undefined;
+  }
+
+  function formatDocsRoute(route: string) {
+    const rewritten = applyRouteRewrites(route);
+    if (rewritten) return rewritten;
+    if (route === '/docs') return '/';
+    if (route.startsWith('/docs/')) return route.slice('/docs'.length);
+    return undefined;
+  }
+
+  function formatRelativeRoute(hrefPath: string, sourceDir: string) {
+    const sourcePath = normalizePath(path.relative(projectDir, path.resolve(sourceDir, hrefPath)));
+    if (sourcePath.startsWith('canons/')) return formatDocsRoute(`/docs/${sourcePath.slice('canons/'.length)}`);
+    return undefined;
+  }
+
+  function transformMarkdownLinks(content: string, page: Page) {
+    const sourceDir = path.dirname(path.resolve(projectDir, page.source));
+
+    return content.replace(MD_LINK_RE, (match, href: string, hash = '') => {
+      const [hrefPath, query = ''] = href.split('?');
+      const queryPart = query ? `?${query}` : '';
+
+      if (hrefPath.startsWith('/')) {
+        const route = formatDocsRoute(hrefPath) ?? applyRouteRewrites(hrefPath);
+        return route ? `](${route}${queryPart}${hash})` : match;
+      }
+
+      if (!hrefPath.endsWith('.md')) {
+        const route = formatRelativeRoute(hrefPath, sourceDir);
+        return route ? `](${route}${queryPart}${hash})` : match;
+      }
+
+      const target = targetBySource.get(normalizePath(path.resolve(sourceDir, hrefPath)));
+      if (!target) return match;
+
+      return `](${formatRelativeMarkdownPath(page.target, `${target}${queryPart}`)}${hash})`;
+    });
+  }
+
+  fs.rmSync(contentDir, { recursive: true, force: true });
+  fs.mkdirSync(contentDir, { recursive: true });
+
+  for (const page of docsConfig.mounts) {
+    const sourcePath = path.resolve(projectDir, page.source);
+    const targetPath = path.join(contentDir, page.target);
+
+    if (!fs.existsSync(sourcePath)) throw new Error(`Не найден канон: ${sourcePath}`);
+
+    fs.mkdirSync(path.dirname(targetPath), { recursive: true });
+    fs.writeFileSync(targetPath, transformMarkdownLinks(fs.readFileSync(sourcePath, 'utf8'), page), 'utf8');
+    console.log(`${page.target} -> ${path.relative(projectDir, sourcePath)}`);
+  }
+
+  console.log(`Подготовлен VitePress content для ${config.slug}: ${docsConfig.mounts.length} страниц`);
+}

projects/_shared/lib/root-llms.ts

@@ -0,0 +1,51 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { docs } from '../../../src/config/docs.config';
+
+const siteTitle = 'Документация';
+const siteDescription = 'Единое пространство для идей, черновиков и первых версий документаций, которые ещё формируются и постепенно становятся самостоятельными материалами.';
+
+function formatMarkdownLink(label: string, href: string, description: string) {
+  return `- [${label}](${href}): ${description}`;
+}
+
+function findDocLink(doc: (typeof docs)[number], label: string) {
+  return doc.links.find((link) => link.label === label);
+}
+
+export function generateRootLlms(rootDir = process.cwd()) {
+  const publicDir = path.join(rootDir, 'public');
+  const llmsPath = path.join(publicDir, 'llms.txt');
+  const content = [
+    `# ${siteTitle}`,
+    '',
+    `> ${siteDescription}`,
+    '',
+    'Этот файл является корневой картой документаций. Для работы с конкретным направлением используйте его собственный `llms.txt`.',
+    '',
+    '## Documentation',
+    '',
+    ...docs
+      .map((doc) => {
+        const link = findDocLink(doc, 'llms.txt');
+        return link ? formatMarkdownLink(doc.title, link.href, doc.description) : undefined;
+      })
+      .filter(Boolean),
+    '',
+    '## Optional',
+    '',
+    ...docs
+      .map((doc) => {
+        const link = findDocLink(doc, 'llms-full.txt');
+        return link ? formatMarkdownLink(`${doc.title} full`, link.href, `Полный bundle документации: ${doc.label.toLowerCase()}.`) : undefined;
+      })
+      .filter(Boolean),
+    '',
+  ].join('\n');
+
+  fs.mkdirSync(publicDir, { recursive: true });
+  fs.writeFileSync(llmsPath, content, 'utf8');
+
+  console.log(`Сгенерирован ${path.relative(rootDir, llmsPath)}`);
+}

projects/_shared/lib/run.ts

@@ -0,0 +1,12 @@
+import { spawnSync } from 'node:child_process';
+
+export function run(command: string, args: string[], cwd = process.cwd()) {
+  const result = spawnSync(command, args, {
+    cwd,
+    stdio: 'inherit',
+    shell: process.platform === 'win32',
+  });
+
+  if (result.error) throw result.error;
+  if (result.status !== 0) throw new Error(`Command failed: ${[command, ...args].join(' ')}`);
+}

projects/_shared/lib/zip.ts

@@ -0,0 +1,136 @@
+import fs from 'node:fs';
+import path from 'node:path';
+
+type ZipEntry = {
+  name: string;
+  content: Buffer;
+};
+
+function collectFiles(dir: string, baseDir = dir, archiveRoot = path.basename(dir)): ZipEntry[] {
+  return fs
+    .readdirSync(dir, { withFileTypes: true })
+    .flatMap((entry) => {
+      const entryPath = path.join(dir, entry.name);
+
+      if (entry.isDirectory()) return collectFiles(entryPath, baseDir, archiveRoot);
+
+      const relativePath = path.relative(baseDir, entryPath).split(path.sep).join('/');
+
+      return [
+        {
+          name: `${archiveRoot}/${relativePath}`,
+          content: fs.readFileSync(entryPath),
+        },
+      ];
+    })
+    .sort((a, b) => a.name.localeCompare(b.name));
+}
+
+function createCrc32Table() {
+  return Array.from({ length: 256 }, (_, index) => {
+    let value = index;
+
+    for (let bit = 0; bit < 8; bit += 1) {
+      value = value & 1 ? 0xedb88320 ^ (value >>> 1) : value >>> 1;
+    }
+
+    return value >>> 0;
+  });
+}
+
+const crc32Table = createCrc32Table();
+
+function crc32(buffer: Buffer) {
+  let crc = 0xffffffff;
+
+  for (const byte of buffer) {
+    crc = crc32Table[(crc ^ byte) & 0xff] ^ (crc >>> 8);
+  }
+
+  return (crc ^ 0xffffffff) >>> 0;
+}
+
+function writeUInt16(value: number) {
+  const buffer = Buffer.alloc(2);
+  buffer.writeUInt16LE(value, 0);
+  return buffer;
+}
+
+function writeUInt32(value: number) {
+  const buffer = Buffer.alloc(4);
+  buffer.writeUInt32LE(value >>> 0, 0);
+  return buffer;
+}
+
+function createZip(entries: ZipEntry[]) {
+  const localParts: Buffer[] = [];
+  const centralParts: Buffer[] = [];
+  const dosTime = 0;
+  const dosDate = ((2026 - 1980) << 9) | (1 << 5) | 1;
+  let offset = 0;
+
+  for (const entry of entries) {
+    const fileName = Buffer.from(entry.name, 'utf8');
+    const checksum = crc32(entry.content);
+    const size = entry.content.length;
+
+    const localHeader = Buffer.concat([
+      writeUInt32(0x04034b50),
+      writeUInt16(20),
+      writeUInt16(0),
+      writeUInt16(0),
+      writeUInt16(dosTime),
+      writeUInt16(dosDate),
+      writeUInt32(checksum),
+      writeUInt32(size),
+      writeUInt32(size),
+      writeUInt16(fileName.length),
+      writeUInt16(0),
+      fileName,
+    ]);
+
+    localParts.push(localHeader, entry.content);
+
+    centralParts.push(Buffer.concat([
+      writeUInt32(0x02014b50),
+      writeUInt16(20),
+      writeUInt16(20),
+      writeUInt16(0),
+      writeUInt16(0),
+      writeUInt16(dosTime),
+      writeUInt16(dosDate),
+      writeUInt32(checksum),
+      writeUInt32(size),
+      writeUInt32(size),
+      writeUInt16(fileName.length),
+      writeUInt16(0),
+      writeUInt16(0),
+      writeUInt16(0),
+      writeUInt16(0),
+      writeUInt32(0),
+      writeUInt32(offset),
+      fileName,
+    ]));
+
+    offset += localHeader.length + size;
+  }
+
+  const centralDirectory = Buffer.concat(centralParts);
+  const endOfCentralDirectory = Buffer.concat([
+    writeUInt32(0x06054b50),
+    writeUInt16(0),
+    writeUInt16(0),
+    writeUInt16(entries.length),
+    writeUInt16(entries.length),
+    writeUInt32(centralDirectory.length),
+    writeUInt32(offset),
+    writeUInt16(0),
+  ]);
+
+  return Buffer.concat([...localParts, centralDirectory, endOfCentralDirectory]);
+}
+
+export function writeZipFromDirectory(sourceDir: string, zipPath: string, archiveRoot = path.basename(sourceDir)) {
+  fs.mkdirSync(path.dirname(zipPath), { recursive: true });
+  fs.writeFileSync(zipPath, createZip(collectFiles(sourceDir, sourceDir, archiveRoot)));
+}