npm - @vpxa/aikit - Versions diffs - 0.1.20 → 0.1.21 - Mend

@vpxa/aikit 0.1.20 → 0.1.21

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 (45) hide show

package/scaffold/general/skills/requirements-clarity/SKILL.md CHANGED Viewed

@@ -70,7 +70,7 @@ When invoked, detect vague requirements:
 1. Parse and understand core requirement
 2. Generate feature name (kebab-case format)
 3. Determine document version (default `1.0` unless user specifies otherwise)
-4. Ensure `./docs/prds/` exists for PRD output
+4. Ensure `.spec/{feature_name}/` exists for PRD output
 5. Perform initial clarity assessment (0-100)
 **Assessment Rubric**:
@@ -85,6 +85,8 @@ Technical Specificity: /25 points
 - Integration points identified: 8 pts
 - Constraints specified: 9 pts
+If you present this rubric or a requirements scorecard to the user, use `present({ format: 'html' })` to display a rich dashboard when visual formatting would help.
 Implementation Completeness: /25 points
 - Edge cases considered: 8 pts
 - Error handling mentioned: 9 pts
@@ -191,9 +193,9 @@ Once clarity score ≥ 90, generate comprehensive PRD.
 **Output File**:
-1. **Final PRD**: `./docs/prds/{feature_name}-v{version}-prd.md`
+1. **Final PRD**: `.spec/{feature_name}/requirements.md`
-Use the `Write` tool to create or update this file. Derive `{version}` from the document version recorded in the PRD (default `1.0`).
+Use `create_file` to save this file. Derive `{version}` from the document version recorded in the PRD (default `1.0`).
 ## PRD Document Structure

package/scaffold/general/skills/session-handoff/SKILL.md CHANGED Viewed

@@ -20,6 +20,8 @@ Determine which mode applies:
 **Proactive suggestion?** After substantial work (5+ file edits, complex debugging, major decisions), suggest:
 > "We've made significant progress. Consider creating a handoff document to preserve this context for future sessions. Say 'create handoff' when ready."
+> **aikit Integration:** If the project uses the aikit MCP server, complement file-based handoffs with `remember({ title: "Session checkpoint: ...", content: "...", category: "conventions" })` to persist key decisions in the knowledge base. Use `search({ query: "SESSION CHECKPOINT" })` at session start to retrieve past checkpoints.
 ## CREATE Workflow
 ### Step 1: Generate Scaffold

package/scaffold/general/skills/brainstorming/scripts/frame-template.html DELETED Viewed

@@ -1,365 +0,0 @@
-<!DOCTYPE html>
-<html lang="en">
-<head>
-<meta charset="utf-8">
-<meta name="viewport" content="width=device-width, initial-scale=1">
-<title>Brainstorming</title>
-<style>
-  *, *::before, *::after { box-sizing: border-box; margin: 0; padding: 0; }
-  :root {
-    --bg: #0d1117;
-    --surface: #161b22;
-    --border: #30363d;
-    --text: #e6edf3;
-    --text-muted: #8b949e;
-    --accent: #58a6ff;
-    --accent-glow: rgba(88, 166, 255, 0.15);
-    --success: #3fb950;
-    --radius: 8px;
-  }
-  body {
-    font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Helvetica, Arial, sans-serif;
-    background: var(--bg);
-    color: var(--text);
-    line-height: 1.6;
-    min-height: 100vh;
-  }
-  .frame-header {
-    padding: 16px 24px;
-    border-bottom: 1px solid var(--border);
-    display: flex;
-    align-items: center;
-    gap: 12px;
-  }
-  .frame-header .logo {
-    font-size: 14px;
-    font-weight: 600;
-    color: var(--text-muted);
-    letter-spacing: 0.5px;
-    text-transform: uppercase;
-  }
-  .frame-content {
-    max-width: 960px;
-    margin: 0 auto;
-    padding: 32px 24px;
-  }
-  /* Selection indicator bar */
-  #selection-indicator {
-    position: fixed;
-    bottom: 0;
-    left: 0;
-    right: 0;
-    background: var(--surface);
-    border-top: 1px solid var(--border);
-    padding: 12px 24px;
-    display: none;
-    align-items: center;
-    justify-content: center;
-    gap: 8px;
-    font-size: 14px;
-    color: var(--accent);
-    z-index: 100;
-  }
-  #selection-indicator.visible { display: flex; }
-  #selection-indicator .check { font-size: 18px; }
-  /* Typography */
-  h2 {
-    font-size: 24px;
-    font-weight: 600;
-    margin-bottom: 8px;
-    color: var(--text);
-  }
-  h3 {
-    font-size: 18px;
-    font-weight: 600;
-    margin-bottom: 4px;
-    color: var(--text);
-  }
-  h4 {
-    font-size: 14px;
-    font-weight: 600;
-    margin-bottom: 8px;
-    color: var(--text);
-  }
-  .subtitle {
-    font-size: 16px;
-    color: var(--text-muted);
-    margin-bottom: 24px;
-  }
-  .section {
-    margin-bottom: 32px;
-  }
-  .label {
-    font-size: 11px;
-    font-weight: 600;
-    text-transform: uppercase;
-    letter-spacing: 0.8px;
-    color: var(--text-muted);
-    margin-bottom: 8px;
-  }
-  /* Options (A/B/C choices) */
-  .options {
-    display: flex;
-    flex-direction: column;
-    gap: 12px;
-    margin: 16px 0;
-  }
-  .option {
-    display: flex;
-    align-items: flex-start;
-    gap: 16px;
-    padding: 16px 20px;
-    background: var(--surface);
-    border: 2px solid var(--border);
-    border-radius: var(--radius);
-    cursor: pointer;
-    transition: border-color 0.15s, background 0.15s;
-  }
-  .option:hover {
-    border-color: var(--accent);
-    background: var(--accent-glow);
-  }
-  .option.selected {
-    border-color: var(--accent);
-    background: var(--accent-glow);
-  }
-  .option .letter {
-    flex-shrink: 0;
-    width: 32px;
-    height: 32px;
-    display: flex;
-    align-items: center;
-    justify-content: center;
-    border-radius: 50%;
-    background: var(--border);
-    font-weight: 700;
-    font-size: 14px;
-    color: var(--text-muted);
-    transition: background 0.15s, color 0.15s;
-  }
-  .option.selected .letter {
-    background: var(--accent);
-    color: var(--bg);
-  }
-  .option .content { flex: 1; }
-  .option .content p {
-    color: var(--text-muted);
-    font-size: 14px;
-    margin-top: 4px;
-  }
-  /* Cards (visual designs) */
-  .cards {
-    display: grid;
-    grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
-    gap: 16px;
-    margin: 16px 0;
-  }
-  .card {
-    background: var(--surface);
-    border: 2px solid var(--border);
-    border-radius: var(--radius);
-    overflow: hidden;
-    cursor: pointer;
-    transition: border-color 0.15s, transform 0.15s;
-  }
-  .card:hover {
-    border-color: var(--accent);
-    transform: translateY(-2px);
-  }
-  .card.selected {
-    border-color: var(--accent);
-  }
-  .card-image {
-    padding: 20px;
-    background: rgba(255,255,255,0.02);
-    min-height: 180px;
-    display: flex;
-    align-items: center;
-    justify-content: center;
-  }
-  .card-body {
-    padding: 16px;
-  }
-  .card-body p {
-    color: var(--text-muted);
-    font-size: 14px;
-    margin-top: 4px;
-  }
-  /* Mockup container */
-  .mockup {
-    background: var(--surface);
-    border: 1px solid var(--border);
-    border-radius: var(--radius);
-    overflow: hidden;
-    margin: 16px 0;
-  }
-  .mockup-header {
-    padding: 8px 16px;
-    font-size: 12px;
-    font-weight: 600;
-    color: var(--text-muted);
-    background: rgba(255,255,255,0.03);
-    border-bottom: 1px solid var(--border);
-  }
-  .mockup-body {
-    padding: 20px;
-  }
-  /* Split view */
-  .split {
-    display: grid;
-    grid-template-columns: 1fr 1fr;
-    gap: 16px;
-    margin: 16px 0;
-  }
-  @media (max-width: 700px) {
-    .split { grid-template-columns: 1fr; }
-  }
-  /* Pros/Cons */
-  .pros-cons {
-    display: grid;
-    grid-template-columns: 1fr 1fr;
-    gap: 16px;
-    margin: 16px 0;
-  }
-  .pros, .cons {
-    padding: 16px;
-    border-radius: var(--radius);
-  }
-  .pros {
-    background: rgba(63, 185, 80, 0.08);
-    border: 1px solid rgba(63, 185, 80, 0.3);
-  }
-  .cons {
-    background: rgba(248, 81, 73, 0.08);
-    border: 1px solid rgba(248, 81, 73, 0.3);
-  }
-  .pros h4 { color: #3fb950; }
-  .cons h4 { color: #f85149; }
-  .pros-cons ul {
-    list-style: none;
-    padding: 0;
-  }
-  .pros-cons li {
-    padding: 4px 0;
-    font-size: 14px;
-    color: var(--text-muted);
-  }
-  .pros-cons li::before {
-    margin-right: 8px;
-    font-weight: 600;
-  }
-  .pros li::before { content: '+'; color: #3fb950; }
-  .cons li::before { content: '−'; color: #f85149; }
-  /* Mock elements (wireframe building blocks) */
-  .mock-nav {
-    background: var(--surface);
-    border: 1px solid var(--border);
-    border-radius: var(--radius);
-    padding: 12px 20px;
-    font-size: 14px;
-    color: var(--text-muted);
-    margin-bottom: 12px;
-  }
-  .mock-sidebar {
-    width: 200px;
-    flex-shrink: 0;
-    background: var(--surface);
-    border: 1px solid var(--border);
-    border-radius: var(--radius);
-    padding: 16px;
-    font-size: 13px;
-    color: var(--text-muted);
-    margin-right: 12px;
-  }
-  .mock-content {
-    flex: 1;
-    background: var(--surface);
-    border: 1px solid var(--border);
-    border-radius: var(--radius);
-    padding: 20px;
-    font-size: 14px;
-    color: var(--text-muted);
-    min-height: 200px;
-  }
-  .mock-button {
-    padding: 8px 20px;
-    background: var(--accent);
-    color: var(--bg);
-    border: none;
-    border-radius: 6px;
-    font-size: 14px;
-    font-weight: 600;
-    cursor: pointer;
-  }
-  .mock-button:hover { opacity: 0.9; }
-  .mock-input {
-    padding: 8px 12px;
-    background: var(--surface);
-    border: 1px solid var(--border);
-    border-radius: 6px;
-    color: var(--text);
-    font-size: 14px;
-    width: 100%;
-    max-width: 300px;
-  }
-  .mock-input::placeholder { color: var(--text-muted); }
-  .placeholder {
-    background: rgba(255,255,255,0.03);
-    border: 1px dashed var(--border);
-    border-radius: var(--radius);
-    padding: 40px 20px;
-    text-align: center;
-    color: var(--text-muted);
-    font-size: 14px;
-  }
-  /* General list styling inside content */
-  .frame-content ul, .frame-content ol {
-    padding-left: 20px;
-    margin: 8px 0;
-  }
-  .frame-content li {
-    margin: 4px 0;
-    color: var(--text-muted);
-    font-size: 14px;
-  }
-  .frame-content p {
-    margin: 8px 0;
-  }
-  .frame-content a {
-    color: var(--accent);
-    text-decoration: none;
-  }
-  .frame-content a:hover { text-decoration: underline; }
-</style>
-</head>
-<body>
-  <div class="frame-header">
-    <span class="logo">Brainstorming</span>
-  </div>
-  <div class="frame-content">
-    <!-- CONTENT -->
-  </div>
-  <div id="selection-indicator">
-    <span class="check">✓</span>
-    <span id="selection-text">Selected</span>
-  </div>
-  <script>
-    const BRAINSTORM_DIR = __BRAINSTORM_DIR__;
-    <!-- HELPER_SCRIPT -->
-  </script>
-</body>
-</html>

package/scaffold/general/skills/brainstorming/scripts/helper.js DELETED Viewed

@@ -1,216 +0,0 @@
-/* helper.js — injected into every page served by the visual companion */
-(() => {
-  let currentFile = null;
-  let pollTimer = null;
-  // --- Selection ---
-  function toggleSelect(el) {
-    const parent = el.closest('.options, .cards');
-    const isMulti = parent?.hasAttribute('data-multiselect');
-    if (!isMulti && parent) {
-      for (const sib of parent.querySelectorAll('.selected')) {
-        if (sib !== el) sib.classList.remove('selected');
-      }
-    }
-    el.classList.toggle('selected');
-    updateIndicator();
-    postEvent(el);
-  }
-  function updateIndicator() {
-    const selected = document.querySelectorAll('.selected');
-    const bar = document.getElementById('selection-indicator');
-    const text = document.getElementById('selection-text');
-    if (!bar || !text) return;
-    if (selected.length === 0) {
-      bar.classList.remove('visible');
-      return;
-    }
-    const labels = [];
-    for (const el of selected) {
-      const letter = el.querySelector('.letter');
-      const heading = el.querySelector('h3, h4');
-      labels.push(letter ? letter.textContent.trim() : heading ? heading.textContent.trim() : '?');
-    }
-    text.textContent = `Selected: ${labels.join(', ')}`;
-    bar.classList.add('visible');
-  }
-  // --- Events ---
-  function postEvent(el) {
-    const letter = el.querySelector('.letter');
-    const heading = el.querySelector('h3, h4');
-    const data = {
-      type: 'click',
-      choice: letter ? letter.textContent.trim() : '',
-      text: heading ? heading.textContent.trim() : el.textContent.trim().slice(0, 80),
-      selected: el.classList.contains('selected'),
-      timestamp: Date.now(),
-    };
-    fetch('/events', {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(data),
-    }).catch(() => {
-      /* server may have stopped */
-    });
-  }
-  // --- Transport: WebSocket with polling fallback ---
-  function startTransport() {
-    if (!tryWebSocket()) {
-      startPolling();
-    }
-  }
-  function tryWebSocket() {
-    const protocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
-    const url = `${protocol}//${location.host}`;
-    let ws;
-    try {
-      ws = new WebSocket(url);
-    } catch (_e) {
-      return false;
-    }
-    ws.onopen = () => {
-      // Connected — stop polling if it was running
-      if (pollTimer) {
-        clearInterval(pollTimer);
-        pollTimer = null;
-      }
-    };
-    ws.onmessage = (e) => {
-      try {
-        const msg = JSON.parse(e.data);
-        if (msg.type === 'new-file') {
-          if (currentFile === null) {
-            // First file arrived while showing "Waiting for content..." — reload
-            currentFile = msg.name;
-            location.reload();
-          } else if (msg.name !== currentFile) {
-            currentFile = msg.name;
-            location.reload();
-          }
-        }
-        // 'event' messages are echoes — browser doesn't need to act on them
-      } catch (_err) {
-        /* ignore malformed */
-      }
-    };
-    ws.onclose = () => {
-      // WebSocket lost — fall back to polling
-      startPolling();
-    };
-    ws.onerror = () => {
-      // Will trigger onclose → polling fallback
-    };
-    return true;
-  }
-  function startPolling() {
-    if (pollTimer) return;
-    pollTimer = setInterval(poll, 1500);
-  }
-  function poll() {
-    fetch('/poll')
-      .then((r) => (r.ok ? r.json() : null))
-      .then((data) => {
-        if (!data?.file) return;
-        if (currentFile === null) {
-          // First file arrived while showing "Waiting for content..." — reload
-          currentFile = data.file;
-          location.reload();
-          return;
-        }
-        if (data.file !== currentFile) {
-          currentFile = data.file;
-          location.reload();
-        }
-      })
-      .catch(() => {
-        /* ignore */
-      });
-  }
-  // --- Session state restoration ---
-  function restoreSelections() {
-    fetch('/state')
-      .then((r) => (r.ok ? r.json() : null))
-      .then((state) => {
-        if (!state?.currentScreen || !state.selections) return;
-        const screenSelections = state.selections[state.currentScreen];
-        if (!screenSelections || screenSelections.length === 0) return;
-        // Build a map of choice → selected
-        const choiceMap = {};
-        for (let i = 0; i < screenSelections.length; i++) {
-          if (screenSelections[i].selected !== false) {
-            choiceMap[screenSelections[i].choice] = true;
-          }
-        }
-        // Apply to DOM
-        const options = document.querySelectorAll('.option, .card');
-        for (let j = 0; j < options.length; j++) {
-          const letter = options[j].querySelector('.letter');
-          const key = letter ? letter.textContent.trim() : '';
-          if (choiceMap[key]) {
-            options[j].classList.add('selected');
-          }
-        }
-        updateIndicator();
-      })
-      .catch(() => {
-        /* no state yet, that's fine */
-      });
-  }
-  // --- Wire up ---
-  function init() {
-    // Attach click handlers to all options and cards
-    document.addEventListener('click', (e) => {
-      const option = e.target.closest('.option');
-      if (option) {
-        toggleSelect(option);
-        return;
-      }
-      const card = e.target.closest('.card');
-      if (card) {
-        toggleSelect(card);
-        return;
-      }
-    });
-    updateIndicator();
-    restoreSelections();
-    startTransport();
-  }
-  // Expose for inline onclick if needed
-  window.toggleSelect = toggleSelect;
-  if (document.readyState === 'loading') {
-    document.addEventListener('DOMContentLoaded', init);
-  } else {
-    init();
-  }
-})();