npm - agent-skill-kit - Versions diffs - 3.9.135 - Mend

agent-skill-kit 3.9.135

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (615) hide show

package/.agent/skills/doc-templates/scripts/kanban-server.ts ADDED Viewed

@@ -0,0 +1,171 @@
+// @ts-nocheck
+/**
+ * Plans Kanban Dashboard Server
+ * Visual dashboard for plan directories with progress tracking.
+ *
+ * Usage:
+ *   npx tsx kanban-server.ts --dir ./docs/plans --open
+ *   npx tsx kanban-server.ts --stop
+ */
+import * as http from 'node:http';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { execSync } from 'node:child_process';
+const DEFAULT_PORT = 3458;
+interface PlanCard {
+  file: string;
+  title: string;
+  phase: string;
+  progress: number;
+}
+interface ServerOptions {
+  dir: string;
+  port: number;
+  open: boolean;
+  stop: boolean;
+}
+function parseArgs(): ServerOptions {
+  const args = process.argv.slice(2);
+  const opts: ServerOptions = { dir: '.', port: DEFAULT_PORT, open: false, stop: false };
+  for (let i = 0; i < args.length; i++) {
+    switch (args[i]) {
+      case '--dir': opts.dir = args[++i]; break;
+      case '--port': opts.port = parseInt(args[++i], 10); break;
+      case '--open': opts.open = true; break;
+      case '--stop': opts.stop = true; break;
+    }
+  }
+  return opts;
+}
+function parsePlanFile(filePath: string): PlanCard {
+  const content = fs.readFileSync(filePath, 'utf-8');
+  const lines = content.split('\n');
+  // Extract title from first H1
+  const titleLine = lines.find(l => l.startsWith('# '));
+  const title = titleLine ? titleLine.replace(/^#+\s*/, '').trim() : path.basename(filePath, '.md');
+  // Count task progress
+  const done = (content.match(/- \[x\]/gi) || []).length;
+  const inProgress = (content.match(/- \[\/\]/g) || []).length;
+  const todo = (content.match(/- \[ \]/g) || []).length;
+  const total = done + inProgress + todo;
+  const progress = total > 0 ? Math.round((done / total) * 100) : 0;
+  // Determine phase
+  let phase = 'backlog';
+  if (progress === 100) phase = 'done';
+  else if (inProgress > 0 || progress > 0) phase = 'in-progress';
+  else if (todo > 0) phase = 'todo';
+  return { file: path.basename(filePath), title, phase, progress };
+}
+function buildDashboardHtml(plans: PlanCard[], dirPath: string): string {
+  const columns = {
+    'backlog':     plans.filter(p => p.phase === 'backlog'),
+    'todo':        plans.filter(p => p.phase === 'todo'),
+    'in-progress': plans.filter(p => p.phase === 'in-progress'),
+    'done':        plans.filter(p => p.phase === 'done'),
+  };
+  const renderCard = (p: PlanCard) => `
+    <div class="card">
+      <div class="card-title">${p.title}</div>
+      <div class="card-file">${p.file}</div>
+      <div class="progress-bar"><div class="progress-fill" style="width:${p.progress}%"></div></div>
+      <div class="card-progress">${p.progress}%</div>
+    </div>`;
+  const renderColumn = (name: string, emoji: string, cards: PlanCard[]) => `
+    <div class="column">
+      <div class="column-header">${emoji} ${name} <span class="count">${cards.length}</span></div>
+      ${cards.map(renderCard).join('')}
+    </div>`;
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8"><title>Plans Dashboard — PikaKit</title>
+  <style>
+    @import url('https://fonts.googleapis.com/css2?family=Inter:wght@400;500;600;700&display=swap');
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body { font-family: 'Inter', system-ui; background: #0f172a; color: #e2e8f0; min-height: 100vh; }
+    .header { padding: 16px 24px; background: #1e293b; border-bottom: 1px solid #334155; display: flex; justify-content: space-between; align-items: center; }
+    .header h1 { font-size: 18px; font-weight: 600; }
+    .header span { font-size: 12px; color: #64748b; }
+    .board { display: flex; gap: 16px; padding: 24px; overflow-x: auto; min-height: calc(100vh - 60px); }
+    .column { background: #1e293b; border-radius: 8px; min-width: 280px; flex: 1; padding: 12px; }
+    .column-header { font-size: 13px; font-weight: 600; color: #94a3b8; text-transform: uppercase; letter-spacing: 0.05em; padding: 8px 4px; border-bottom: 1px solid #334155; margin-bottom: 12px; }
+    .count { background: #334155; padding: 2px 8px; border-radius: 10px; font-size: 11px; margin-left: 6px; }
+    .card { background: #0f172a; border: 1px solid #334155; border-radius: 6px; padding: 12px; margin-bottom: 8px; }
+    .card:hover { border-color: #3b82f6; }
+    .card-title { font-size: 14px; font-weight: 500; margin-bottom: 4px; }
+    .card-file { font-size: 11px; color: #64748b; margin-bottom: 8px; }
+    .progress-bar { background: #334155; height: 4px; border-radius: 2px; overflow: hidden; }
+    .progress-fill { background: #3b82f6; height: 100%; transition: width 0.3s; }
+    .card-progress { font-size: 11px; color: #64748b; margin-top: 4px; text-align: right; }
+  </style>
+</head>
+<body>
+  <div class="header">
+    <h1>📋 Plans Dashboard</h1>
+    <span>📂 ${dirPath} | ⚡ PikaKit</span>
+  </div>
+  <div class="board">
+    ${renderColumn('Backlog', '📥', columns['backlog'])}
+    ${renderColumn('Todo', '📋', columns['todo'])}
+    ${renderColumn('In Progress', '🔧', columns['in-progress'])}
+    ${renderColumn('Done', '✅', columns['done'])}
+  </div>
+</body>
+</html>`;
+}
+function openBrowser(url: string): void {
+  try {
+    const cmd = process.platform === 'win32' ? `start ${url}` : process.platform === 'darwin' ? `open ${url}` : `xdg-open ${url}`;
+    execSync(cmd, { stdio: 'ignore' });
+  } catch { /* ignore */ }
+}
+function main(): void {
+  const opts = parseArgs();
+  if (opts.stop) {
+    console.log(JSON.stringify({ status: 'success', data: { message: 'Stop signal sent.' } }));
+    process.exit(0);
+  }
+  if (!fs.existsSync(opts.dir)) {
+    console.error(JSON.stringify({ status: 'error', error: { code: 'ERR_DIR_NOT_FOUND', message: `Directory not found: ${opts.dir}`, recoverable: false } }));
+    process.exit(1);
+  }
+  const server = http.createServer((_req, res) => {
+    const mdFiles = fs.readdirSync(opts.dir).filter(f => f.endsWith('.md'));
+    const plans = mdFiles.map(f => parsePlanFile(path.join(opts.dir, f)));
+    res.writeHead(200, { 'Content-Type': 'text/html' });
+    res.end(buildDashboardHtml(plans, opts.dir));
+  });
+  server.listen(opts.port, () => {
+    const url = `http://localhost:${opts.port}`;
+    console.log(JSON.stringify({ status: 'success', data: { url, port: opts.port, dir: opts.dir } }));
+    if (opts.open) openBrowser(url);
+  });
+  server.on('error', (err: NodeJS.ErrnoException) => {
+    console.error(JSON.stringify({ status: 'error', error: { code: 'ERR_PORT_UNAVAILABLE', message: err.message, recoverable: true } }));
+    process.exit(1);
+  });
+}
+main();

package/.agent/skills/doc-templates/scripts/markdown-server.ts ADDED Viewed

@@ -0,0 +1,185 @@
+// @ts-nocheck
+/**
+ * Markdown Preview Server
+ * Renders markdown files with a reading-optimized theme.
+ *
+ * Usage:
+ *   npx tsx server.ts --file ./README.md --open
+ *   npx tsx server.ts --dir ./docs --open
+ *   npx tsx server.ts --stop
+ */
+import * as http from 'node:http';
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import { execSync } from 'node:child_process';
+const DEFAULT_PORT = 3456;
+interface ServerOptions {
+  file?: string;
+  dir?: string;
+  port: number;
+  open: boolean;
+  stop: boolean;
+}
+function parseArgs(): ServerOptions {
+  const args = process.argv.slice(2);
+  const opts: ServerOptions = { port: DEFAULT_PORT, open: false, stop: false };
+  for (let i = 0; i < args.length; i++) {
+    switch (args[i]) {
+      case '--file': opts.file = args[++i]; break;
+      case '--dir': opts.dir = args[++i]; break;
+      case '--port': opts.port = parseInt(args[++i], 10); break;
+      case '--open': opts.open = true; break;
+      case '--stop': opts.stop = true; break;
+    }
+  }
+  return opts;
+}
+function escapeHtml(text: string): string {
+  return text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+}
+function simpleMarkdownToHtml(md: string): string {
+  let html = escapeHtml(md);
+  // Headers
+  html = html.replace(/^### (.+)$/gm, '<h3>$1</h3>');
+  html = html.replace(/^## (.+)$/gm, '<h2>$1</h2>');
+  html = html.replace(/^# (.+)$/gm, '<h1>$1</h1>');
+  // Bold/italic
+  html = html.replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>');
+  html = html.replace(/\*(.+?)\*/g, '<em>$1</em>');
+  // Code blocks
+  html = html.replace(/```(\w*)\n([\s\S]*?)```/g, '<pre><code class="$1">$2</code></pre>');
+  html = html.replace(/`([^`]+)`/g, '<code>$1</code>');
+  // Lists
+  html = html.replace(/^- (.+)$/gm, '<li>$1</li>');
+  html = html.replace(/(<li>.*<\/li>\n?)+/g, '<ul>$&</ul>');
+  // Links
+  html = html.replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2">$1</a>');
+  // Paragraphs
+  html = html.replace(/\n\n/g, '</p><p>');
+  html = '<p>' + html + '</p>';
+  // Horizontal rules
+  html = html.replace(/<p>---<\/p>/g, '<hr>');
+  return html;
+}
+function buildViewerHtml(content: string, title: string): string {
+  const rendered = simpleMarkdownToHtml(content);
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>${title} — PikaKit Viewer</title>
+  <style>
+    @import url('https://fonts.googleapis.com/css2?family=Libre+Baskerville:ital,wght@0,400;0,700;1,400&family=Inter:wght@400;500;600&family=JetBrains+Mono:wght@400;500&display=swap');
+    :root { --bg: #fafaf9; --text: #1c1917; --muted: #78716c; --accent: #2563eb; --border: #e7e5e4; }
+    .dark { --bg: #0f172a; --text: #e2e8f0; --muted: #94a3b8; --accent: #60a5fa; --border: #334155; }
+    * { margin: 0; padding: 0; box-sizing: border-box; }
+    body { font-family: 'Inter', system-ui, sans-serif; background: var(--bg); color: var(--text); line-height: 1.7; }
+    .toolbar { position: fixed; top: 0; width: 100%; background: var(--bg); border-bottom: 1px solid var(--border); padding: 8px 24px; display: flex; justify-content: space-between; z-index: 10; }
+    .toolbar button { background: none; border: 1px solid var(--border); color: var(--text); padding: 4px 12px; border-radius: 4px; cursor: pointer; }
+    article { max-width: 720px; margin: 64px auto 80px; padding: 0 24px; }
+    h1, h2, h3 { font-family: 'Libre Baskerville', serif; margin: 1.5em 0 0.5em; }
+    h1 { font-size: 2em; border-bottom: 2px solid var(--border); padding-bottom: 0.3em; }
+    h2 { font-size: 1.5em; }
+    h3 { font-size: 1.2em; }
+    code { font-family: 'JetBrains Mono', monospace; background: var(--border); padding: 2px 6px; border-radius: 3px; font-size: 0.9em; }
+    pre { background: var(--border); padding: 16px; border-radius: 6px; overflow-x: auto; margin: 1em 0; }
+    pre code { background: none; padding: 0; }
+    a { color: var(--accent); text-decoration: none; }
+    a:hover { text-decoration: underline; }
+    hr { border: none; border-top: 1px solid var(--border); margin: 2em 0; }
+    ul { padding-left: 1.5em; }
+    li { margin: 0.3em 0; }
+    .footer { text-align: center; color: var(--muted); font-size: 12px; padding: 16px; }
+  </style>
+</head>
+<body>
+  <div class="toolbar">
+    <span style="font-size:13px;color:var(--muted)">📖 ${title}</span>
+    <button onclick="document.body.classList.toggle('dark')">🌓 Theme</button>
+  </div>
+  <article>${rendered}</article>
+  <div class="footer">⚡ PikaKit Markdown Viewer</div>
+</body>
+</html>`;
+}
+function buildDirectoryHtml(dirPath: string): string {
+  const files = fs.readdirSync(dirPath).filter(f => f.endsWith('.md')).sort();
+  const items = files.map(f => `<li><a href="/${encodeURIComponent(f)}">${f}</a></li>`).join('\n');
+  return `<!DOCTYPE html>
+<html><head><title>Docs — PikaKit</title>
+<style>body{font-family:Inter,system-ui;max-width:600px;margin:40px auto;padding:0 20px}a{color:#2563eb}li{margin:8px 0}</style>
+</head><body><h1>📂 Documents</h1><ul>${items}</ul><p style="color:#999;font-size:12px">⚡ PikaKit</p></body></html>`;
+}
+function openBrowser(url: string): void {
+  try {
+    const cmd = process.platform === 'win32' ? `start ${url}` : process.platform === 'darwin' ? `open ${url}` : `xdg-open ${url}`;
+    execSync(cmd, { stdio: 'ignore' });
+  } catch { /* ignore */ }
+}
+function main(): void {
+  const opts = parseArgs();
+  if (opts.stop) {
+    console.log(JSON.stringify({ status: 'success', data: { message: 'Stop signal sent.' } }));
+    process.exit(0);
+  }
+  const server = http.createServer((req, res) => {
+    const urlPath = decodeURIComponent(req.url || '/');
+    if (opts.file) {
+      const content = fs.readFileSync(opts.file, 'utf-8');
+      const title = path.basename(opts.file);
+      res.writeHead(200, { 'Content-Type': 'text/html' });
+      res.end(buildViewerHtml(content, title));
+      return;
+    }
+    if (opts.dir) {
+      if (urlPath === '/') {
+        res.writeHead(200, { 'Content-Type': 'text/html' });
+        res.end(buildDirectoryHtml(opts.dir));
+        return;
+      }
+      const filePath = path.join(opts.dir, urlPath.slice(1));
+      if (fs.existsSync(filePath) && filePath.endsWith('.md')) {
+        const content = fs.readFileSync(filePath, 'utf-8');
+        res.writeHead(200, { 'Content-Type': 'text/html' });
+        res.end(buildViewerHtml(content, path.basename(filePath)));
+        return;
+      }
+    }
+    res.writeHead(404, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify({ status: 'error', error: { code: 'ERR_FILE_NOT_FOUND', message: 'Not found' } }));
+  });
+  server.listen(opts.port, () => {
+    const url = `http://localhost:${opts.port}`;
+    console.log(JSON.stringify({ status: 'success', data: { url, port: opts.port, file: opts.file || null, dir: opts.dir || null } }));
+    if (opts.open) openBrowser(url);
+  });
+  server.on('error', (err: NodeJS.ErrnoException) => {
+    if (err.code === 'EADDRINUSE') {
+      console.error(JSON.stringify({ status: 'error', error: { code: 'ERR_PORT_UNAVAILABLE', message: `Port ${opts.port} in use`, recoverable: true } }));
+    } else {
+      console.error(JSON.stringify({ status: 'error', error: { code: 'ERR_SERVER_FAILED', message: err.message, recoverable: false } }));
+    }
+    process.exit(1);
+  });
+}
+main();