crewx 0.8.1 → 0.8.2-rc.2

package/scripts/build-manual.mjs

@@ -1,266 +1,266 @@
-#!/usr/bin/env node
-/**
- * Build manual: Compile docs/manual/ markdown files into a single crewx-manual.md
- *
- * 1. Reads docs/manual/INDEX.md, resolves internal .md links inline,
- *    strips image references → merged Korean markdown
- * 2. Translates to English via `crewx q '@tech_writer ...' --raw`
- * 3. Saves result to packages/cli/templates/documents/crewx-manual.md
- *
- * Caching: computes hash of docs/manual/ files, skips translation if unchanged.
- * Use --force to bypass cache and force re-translation.
- */
-
-import { readFileSync, writeFileSync, existsSync, readdirSync, mkdirSync } from 'fs';
-import { join, dirname, resolve } from 'path';
-import { fileURLToPath } from 'url';
-import { createHash } from 'crypto';
-import { execSync } from 'child_process';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const ROOT = resolve(__dirname, '..');
-const MANUAL_DIR = join(ROOT, 'docs', 'manual');
-const INDEX_PATH = join(MANUAL_DIR, 'INDEX.md');
-const OUTPUT_PATH = join(ROOT, 'packages', 'cli', 'templates', 'documents', 'crewx-manual.md');
-const HASH_DIR = join(ROOT, '.crewx');
-const HASH_PATH = join(HASH_DIR, 'manual-hash');
-const CREWX_BIN = join(ROOT, 'crewx');
-
-const forceFlag = process.argv.includes('--force');
-
-// Track already-inlined files to avoid duplicates
-const inlined = new Set();
-
-/**
- * Read a markdown file relative to MANUAL_DIR
- */
-function readManualFile(relPath) {
-  const abs = join(MANUAL_DIR, relPath);
-  if (!existsSync(abs)) {
-    console.warn(`  [WARN] File not found: ${relPath}`);
-    return null;
-  }
-  return readFileSync(abs, 'utf-8');
-}
-
-/**
- * Strip image links: ![alt](path) and standalone <img> tags
- */
-function stripImages(content) {
-  return content
-    .replace(/!\[[^\]]*\]\([^)]+\)/g, '')
-    .replace(/<img[^>]*>/gi, '');
-}
-
-/**
- * Extract .md links from a line.
- * Matches [text](path.md) patterns where path is a relative .md file.
- */
-function extractMdLinks(content) {
-  const links = [];
-  const re = /\[([^\]]+)\]\(([^)]+\.md)\)/g;
-  let m;
-  while ((m = re.exec(content)) !== null) {
-    links.push({ text: m[1], path: m[2] });
-  }
-  return links;
-}
-
-/**
- * Process a markdown file: inline linked .md files, strip images.
- * For INDEX files, replace link references with the actual file content.
- * For regular files, just replace internal .md links with anchors.
- */
-function processFile(relPath, depth = 0) {
-  if (inlined.has(relPath)) {
-    return `<!-- Already included: ${relPath} -->\n`;
-  }
-  inlined.add(relPath);
-
-  const content = readManualFile(relPath);
-  if (content === null) return '';
-
-  const dir = dirname(relPath);
-  let result = stripImages(content);
-
-  // Find all .md links and inline them
-  const links = extractMdLinks(result);
-
-  for (const link of links) {
-    // Resolve relative path from current file's directory
-    const linkedPath = dir === '.' ? link.path : join(dir, link.path);
-    const normalizedPath = linkedPath.replace(/\\/g, '/');
-
-    // Replace the markdown link with just the link text (as a reference)
-    const linkPattern = `[${link.text}](${link.path})`;
-
-    if (inlined.has(normalizedPath)) {
-      // Already inlined — just replace link with text
-      result = result.replace(linkPattern, `**${link.text}**`);
-      continue;
-    }
-
-    // Read and inline the linked file
-    const linkedContent = readManualFile(normalizedPath);
-    if (linkedContent === null) {
-      // Leave the link text but note it was not found
-      result = result.replace(linkPattern, `**${link.text}** _(문서 없음)_`);
-      continue;
-    }
-
-    inlined.add(normalizedPath);
-
-    // Process the linked file content (strip images, but don't recurse too deep)
-    let processed = stripImages(linkedContent);
-    if (depth < 2) {
-      // Recursively resolve links in linked files (max 2 levels)
-      const subLinks = extractMdLinks(processed);
-      for (const sub of subLinks) {
-        const subPath = dirname(normalizedPath) === '.'
-          ? sub.path
-          : join(dirname(normalizedPath), sub.path);
-        const normalizedSub = subPath.replace(/\\/g, '/');
-
-        const subPattern = `[${sub.text}](${sub.path})`;
-        if (inlined.has(normalizedSub)) {
-          processed = processed.replace(subPattern, `**${sub.text}**`);
-        } else {
-          // Just convert to text reference (don't deep-inline sub-sub files)
-          processed = processed.replace(subPattern, `**${sub.text}**`);
-        }
-      }
-    }
-
-    // Replace the link in the parent with the full content
-    result = result.replace(linkPattern, `**${link.text}**`);
-
-    // Append the file content after the current section
-    result += `\n---\n\n${processed}\n`;
-  }
-
-  // Clean up excessive blank lines
-  result = result.replace(/\n{4,}/g, '\n\n\n');
-
-  return result;
-}
-
-/**
- * Recursively collect all .md files under a directory and compute a combined hash.
- */
-function collectMdFiles(dir) {
-  const files = [];
-  for (const entry of readdirSync(dir, { withFileTypes: true })) {
-    const full = join(dir, entry.name);
-    if (entry.isDirectory()) {
-      files.push(...collectMdFiles(full));
-    } else if (entry.name.endsWith('.md')) {
-      files.push(full);
-    }
-  }
-  return files.sort();
-}
-
-function computeManualHash() {
-  const hash = createHash('sha256');
-  for (const f of collectMdFiles(MANUAL_DIR)) {
-    hash.update(readFileSync(f));
-  }
-  return hash.digest('hex');
-}
-
-function readSavedHash() {
-  if (!existsSync(HASH_PATH)) return null;
-  return readFileSync(HASH_PATH, 'utf-8').trim();
-}
-
-function saveHash(h) {
-  mkdirSync(HASH_DIR, { recursive: true });
-  writeFileSync(HASH_PATH, h + '\n', 'utf-8');
-}
-
-/**
- * Translate Korean markdown to English via crewx CLI.
- * Returns translated text, or null on failure.
- */
-function translateToEnglish(koreanMd) {
-  const prompt = `@tech_writer Translate the following Korean CrewX manual to English. Keep all markdown formatting, code blocks, YAML examples, and technical terms (crewx, CLI commands, flag names) exactly as-is. Only translate Korean prose to natural English. Do NOT add any commentary or explanation — output ONLY the translated markdown.`;
-
-  try {
-    console.log('  Translating to English via crewx q ...');
-    const translated = execSync(
-      `"${CREWX_BIN}" q '${prompt.replace(/'/g, "'\\''")}' --raw 2>/dev/null`,
-      {
-        input: koreanMd,
-        cwd: ROOT,
-        encoding: 'utf-8',
-        maxBuffer: 50 * 1024 * 1024, // 50MB
-        timeout: 15 * 60 * 1000,     // 15 min
-        env: { ...process.env, CLAUDECODE: undefined },
-      }
-    );
-    if (translated && translated.trim().length > 100) {
-      // Strip crewx runtime log lines from output
-      const cleaned = translated.split('\n').filter(line =>
-        !line.startsWith('Loaded ') &&
-        !line.startsWith('[dotenv') &&
-        !line.startsWith('Registered ') &&
-        !line.startsWith('Updated ') &&
-        !line.startsWith('[AgentRuntime]') &&
-        !line.startsWith('npm ')
-      ).join('\n').trim();
-      return cleaned;
-    }
-    console.warn('  [WARN] Translation output too short, using Korean fallback.');
-    return null;
-  } catch (err) {
-    console.warn(`  [WARN] Translation failed: ${err.message}`);
-    console.warn('  Using Korean merged version as fallback.');
-    return null;
-  }
-}
-
-// --- Main ---
-console.log('Building CrewX manual...');
-console.log(`  Source: ${INDEX_PATH}`);
-console.log(`  Output: ${OUTPUT_PATH}`);
-
-if (!existsSync(INDEX_PATH)) {
-  console.error(`ERROR: INDEX.md not found at ${INDEX_PATH}`);
-  process.exit(1);
-}
-
-// Check cache
-const currentHash = computeManualHash();
-const savedHash = readSavedHash();
-
-if (!forceFlag && currentHash === savedHash && existsSync(OUTPUT_PATH)) {
-  console.log('\n  No changes detected in docs/manual/. Skipping build.');
-  console.log('  Use --force to rebuild anyway.');
-  process.exit(0);
-}
-
-if (forceFlag) {
-  console.log('  --force flag set, bypassing cache.');
-}
-
-// Merge
-const merged = processFile('INDEX.md');
-const fileCount = inlined.size;
-const mergedLineCount = merged.split('\n').length;
-console.log(`\n  Merged: ${fileCount} files, ${mergedLineCount} lines.`);
-
-// Translate
-const translated = translateToEnglish(merged);
-const finalContent = translated || merged;
-const wasTranslated = translated !== null;
-
-// Write output
-const header = `<!-- AUTO-GENERATED: Do not edit manually. Run "npm run build:manual" to regenerate. -->\n\n`;
-writeFileSync(OUTPUT_PATH, header + finalContent.trim() + '\n', 'utf-8');
-
-// Save hash
-saveHash(currentHash);
-
-const outputLineCount = finalContent.split('\n').length;
-console.log(`  Output: ${OUTPUT_PATH}`);
-console.log(`  ${outputLineCount} lines written${wasTranslated ? ' (English)' : ' (Korean fallback)'}`);
+#!/usr/bin/env node
+/**
+ * Build manual: Compile docs/manual/ markdown files into a single crewx-manual.md
+ *
+ * 1. Reads docs/manual/INDEX.md, resolves internal .md links inline,
+ *    strips image references → merged Korean markdown
+ * 2. Translates to English via `crewx q '@tech_writer ...' --raw`
+ * 3. Saves result to packages/cli/templates/documents/crewx-manual.md
+ *
+ * Caching: computes hash of docs/manual/ files, skips translation if unchanged.
+ * Use --force to bypass cache and force re-translation.
+ */
+
+import { readFileSync, writeFileSync, existsSync, readdirSync, mkdirSync } from 'fs';
+import { join, dirname, resolve } from 'path';
+import { fileURLToPath } from 'url';
+import { createHash } from 'crypto';
+import { execSync } from 'child_process';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const ROOT = resolve(__dirname, '..');
+const MANUAL_DIR = join(ROOT, 'docs', 'manual');
+const INDEX_PATH = join(MANUAL_DIR, 'INDEX.md');
+const OUTPUT_PATH = join(ROOT, 'packages', 'cli', 'templates', 'documents', 'crewx-manual.md');
+const HASH_DIR = join(ROOT, '.crewx');
+const HASH_PATH = join(HASH_DIR, 'manual-hash');
+const CREWX_BIN = join(ROOT, 'crewx');
+
+const forceFlag = process.argv.includes('--force');
+
+// Track already-inlined files to avoid duplicates
+const inlined = new Set();
+
+/**
+ * Read a markdown file relative to MANUAL_DIR
+ */
+function readManualFile(relPath) {
+  const abs = join(MANUAL_DIR, relPath);
+  if (!existsSync(abs)) {
+    console.warn(`  [WARN] File not found: ${relPath}`);
+    return null;
+  }
+  return readFileSync(abs, 'utf-8');
+}
+
+/**
+ * Strip image links: ![alt](path) and standalone <img> tags
+ */
+function stripImages(content) {
+  return content
+    .replace(/!\[[^\]]*\]\([^)]+\)/g, '')
+    .replace(/<img[^>]*>/gi, '');
+}
+
+/**
+ * Extract .md links from a line.
+ * Matches [text](path.md) patterns where path is a relative .md file.
+ */
+function extractMdLinks(content) {
+  const links = [];
+  const re = /\[([^\]]+)\]\(([^)]+\.md)\)/g;
+  let m;
+  while ((m = re.exec(content)) !== null) {
+    links.push({ text: m[1], path: m[2] });
+  }
+  return links;
+}
+
+/**
+ * Process a markdown file: inline linked .md files, strip images.
+ * For INDEX files, replace link references with the actual file content.
+ * For regular files, just replace internal .md links with anchors.
+ */
+function processFile(relPath, depth = 0) {
+  if (inlined.has(relPath)) {
+    return `<!-- Already included: ${relPath} -->\n`;
+  }
+  inlined.add(relPath);
+
+  const content = readManualFile(relPath);
+  if (content === null) return '';
+
+  const dir = dirname(relPath);
+  let result = stripImages(content);
+
+  // Find all .md links and inline them
+  const links = extractMdLinks(result);
+
+  for (const link of links) {
+    // Resolve relative path from current file's directory
+    const linkedPath = dir === '.' ? link.path : join(dir, link.path);
+    const normalizedPath = linkedPath.replace(/\\/g, '/');
+
+    // Replace the markdown link with just the link text (as a reference)
+    const linkPattern = `[${link.text}](${link.path})`;
+
+    if (inlined.has(normalizedPath)) {
+      // Already inlined — just replace link with text
+      result = result.replace(linkPattern, `**${link.text}**`);
+      continue;
+    }
+
+    // Read and inline the linked file
+    const linkedContent = readManualFile(normalizedPath);
+    if (linkedContent === null) {
+      // Leave the link text but note it was not found
+      result = result.replace(linkPattern, `**${link.text}** _(문서 없음)_`);
+      continue;
+    }
+
+    inlined.add(normalizedPath);
+
+    // Process the linked file content (strip images, but don't recurse too deep)
+    let processed = stripImages(linkedContent);
+    if (depth < 2) {
+      // Recursively resolve links in linked files (max 2 levels)
+      const subLinks = extractMdLinks(processed);
+      for (const sub of subLinks) {
+        const subPath = dirname(normalizedPath) === '.'
+          ? sub.path
+          : join(dirname(normalizedPath), sub.path);
+        const normalizedSub = subPath.replace(/\\/g, '/');
+
+        const subPattern = `[${sub.text}](${sub.path})`;
+        if (inlined.has(normalizedSub)) {
+          processed = processed.replace(subPattern, `**${sub.text}**`);
+        } else {
+          // Just convert to text reference (don't deep-inline sub-sub files)
+          processed = processed.replace(subPattern, `**${sub.text}**`);
+        }
+      }
+    }
+
+    // Replace the link in the parent with the full content
+    result = result.replace(linkPattern, `**${link.text}**`);
+
+    // Append the file content after the current section
+    result += `\n---\n\n${processed}\n`;
+  }
+
+  // Clean up excessive blank lines
+  result = result.replace(/\n{4,}/g, '\n\n\n');
+
+  return result;
+}
+
+/**
+ * Recursively collect all .md files under a directory and compute a combined hash.
+ */
+function collectMdFiles(dir) {
+  const files = [];
+  for (const entry of readdirSync(dir, { withFileTypes: true })) {
+    const full = join(dir, entry.name);
+    if (entry.isDirectory()) {
+      files.push(...collectMdFiles(full));
+    } else if (entry.name.endsWith('.md')) {
+      files.push(full);
+    }
+  }
+  return files.sort();
+}
+
+function computeManualHash() {
+  const hash = createHash('sha256');
+  for (const f of collectMdFiles(MANUAL_DIR)) {
+    hash.update(readFileSync(f));
+  }
+  return hash.digest('hex');
+}
+
+function readSavedHash() {
+  if (!existsSync(HASH_PATH)) return null;
+  return readFileSync(HASH_PATH, 'utf-8').trim();
+}
+
+function saveHash(h) {
+  mkdirSync(HASH_DIR, { recursive: true });
+  writeFileSync(HASH_PATH, h + '\n', 'utf-8');
+}
+
+/**
+ * Translate Korean markdown to English via crewx CLI.
+ * Returns translated text, or null on failure.
+ */
+function translateToEnglish(koreanMd) {
+  const prompt = `@tech_writer Translate the following Korean CrewX manual to English. Keep all markdown formatting, code blocks, YAML examples, and technical terms (crewx, CLI commands, flag names) exactly as-is. Only translate Korean prose to natural English. Do NOT add any commentary or explanation — output ONLY the translated markdown.`;
+
+  try {
+    console.log('  Translating to English via crewx q ...');
+    const translated = execSync(
+      `"${CREWX_BIN}" q '${prompt.replace(/'/g, "'\\''")}' --raw 2>/dev/null`,
+      {
+        input: koreanMd,
+        cwd: ROOT,
+        encoding: 'utf-8',
+        maxBuffer: 50 * 1024 * 1024, // 50MB
+        timeout: 15 * 60 * 1000,     // 15 min
+        env: { ...process.env, CLAUDECODE: undefined },
+      }
+    );
+    if (translated && translated.trim().length > 100) {
+      // Strip crewx runtime log lines from output
+      const cleaned = translated.split('\n').filter(line =>
+        !line.startsWith('Loaded ') &&
+        !line.startsWith('[dotenv') &&
+        !line.startsWith('Registered ') &&
+        !line.startsWith('Updated ') &&
+        !line.startsWith('[AgentRuntime]') &&
+        !line.startsWith('npm ')
+      ).join('\n').trim();
+      return cleaned;
+    }
+    console.warn('  [WARN] Translation output too short, using Korean fallback.');
+    return null;
+  } catch (err) {
+    console.warn(`  [WARN] Translation failed: ${err.message}`);
+    console.warn('  Using Korean merged version as fallback.');
+    return null;
+  }
+}
+
+// --- Main ---
+console.log('Building CrewX manual...');
+console.log(`  Source: ${INDEX_PATH}`);
+console.log(`  Output: ${OUTPUT_PATH}`);
+
+if (!existsSync(INDEX_PATH)) {
+  console.error(`ERROR: INDEX.md not found at ${INDEX_PATH}`);
+  process.exit(1);
+}
+
+// Check cache
+const currentHash = computeManualHash();
+const savedHash = readSavedHash();
+
+if (!forceFlag && currentHash === savedHash && existsSync(OUTPUT_PATH)) {
+  console.log('\n  No changes detected in docs/manual/. Skipping build.');
+  console.log('  Use --force to rebuild anyway.');
+  process.exit(0);
+}
+
+if (forceFlag) {
+  console.log('  --force flag set, bypassing cache.');
+}
+
+// Merge
+const merged = processFile('INDEX.md');
+const fileCount = inlined.size;
+const mergedLineCount = merged.split('\n').length;
+console.log(`\n  Merged: ${fileCount} files, ${mergedLineCount} lines.`);
+
+// Translate
+const translated = translateToEnglish(merged);
+const finalContent = translated || merged;
+const wasTranslated = translated !== null;
+
+// Write output
+const header = `<!-- AUTO-GENERATED: Do not edit manually. Run "npm run build:manual" to regenerate. -->\n\n`;
+writeFileSync(OUTPUT_PATH, header + finalContent.trim() + '\n', 'utf-8');
+
+// Save hash
+saveHash(currentHash);
+
+const outputLineCount = finalContent.split('\n').length;
+console.log(`  Output: ${OUTPUT_PATH}`);
+console.log(`  ${outputLineCount} lines written${wasTranslated ? ' (English)' : ' (Korean fallback)'}`);

package/scripts/emit-dist-server-package-json.mjs

@@ -1,7 +1,7 @@
-import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
-import { join } from 'node:path';
-
-const target = join('dist-server', 'package.json');
-if (!existsSync('dist-server')) mkdirSync('dist-server', { recursive: true });
-writeFileSync(target, JSON.stringify({ type: 'commonjs' }, null, 2));
-console.log('[emit-dist-server-package-json]', target, '→ type: commonjs');
+import { writeFileSync, mkdirSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+
+const target = join('dist-server', 'package.json');
+if (!existsSync('dist-server')) mkdirSync('dist-server', { recursive: true });
+writeFileSync(target, JSON.stringify({ type: 'commonjs' }, null, 2));
+console.log('[emit-dist-server-package-json]', target, '→ type: commonjs');

package/scripts/node_modules/.vite/vitest/da39a3ee5e6b4b0d3255bfef95601890afd80709/results.json

@@ -0,0 +1 @@
+{"version":"4.0.18","results":[[":__tests__/migrate-frontmatter-v2.test.ts",{"duration":5.302541999999988,"failed":false}]]}

package/scripts/postinstall.mjs

@@ -1,44 +1,44 @@
-#!/usr/bin/env node
-/**
- * Cross-platform postinstall: symlink bin/crewx.js → node_modules/.bin/crewx
- * Works on Windows (junction/symlink), macOS, and Linux.
- *
- * NOTE: When installed globally via `npm i -g`, npm uses the `bin` field in
- * package.json to create the executable — this script only handles the local
- * monorepo dev case (npm install in the workspace root).
- */
-import { existsSync, symlinkSync, unlinkSync, lstatSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const root = join(__dirname, '..');
-const binDir = join(root, 'node_modules', '.bin');
-const linkPath = join(binDir, 'crewx');
-const target = join('..', '..', 'bin', 'crewx.js');
-
-if (!existsSync(binDir)) {
-  // node_modules/.bin doesn't exist yet — nothing to do
-  process.exit(0);
-}
-
-try {
-  // Remove stale link if present
-  if (existsSync(linkPath) || lstatExistsSafe(linkPath)) {
-    unlinkSync(linkPath);
-  }
-  symlinkSync(target, linkPath);
-  console.log('✅ crewx dev symlink created');
-} catch (err) {
-  // Non-fatal: global installs use the bin field, so this is optional
-  console.warn('⚠️ postinstall symlink skipped:', err.message);
-}
-
-function lstatExistsSafe(p) {
-  try {
-    lstatSync(p);
-    return true;
-  } catch {
-    return false;
-  }
-}
+#!/usr/bin/env node
+/**
+ * Cross-platform postinstall: symlink bin/crewx.js → node_modules/.bin/crewx
+ * Works on Windows (junction/symlink), macOS, and Linux.
+ *
+ * NOTE: When installed globally via `npm i -g`, npm uses the `bin` field in
+ * package.json to create the executable — this script only handles the local
+ * monorepo dev case (npm install in the workspace root).
+ */
+import { existsSync, symlinkSync, unlinkSync, lstatSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const root = join(__dirname, '..');
+const binDir = join(root, 'node_modules', '.bin');
+const linkPath = join(binDir, 'crewx');
+const target = join('..', '..', 'bin', 'crewx.js');
+
+if (!existsSync(binDir)) {
+  // node_modules/.bin doesn't exist yet — nothing to do
+  process.exit(0);
+}
+
+try {
+  // Remove stale link if present
+  if (existsSync(linkPath) || lstatExistsSafe(linkPath)) {
+    unlinkSync(linkPath);
+  }
+  symlinkSync(target, linkPath);
+  console.log('✅ crewx dev symlink created');
+} catch (err) {
+  // Non-fatal: global installs use the bin field, so this is optional
+  console.warn('⚠️ postinstall symlink skipped:', err.message);
+}
+
+function lstatExistsSafe(p) {
+  try {
+    lstatSync(p);
+    return true;
+  } catch {
+    return false;
+  }
+}