@adityaaria/spark 6.0.21 → 6.0.22

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adityaaria/spark",
-  "version": "6.0.21",
+  "version": "6.0.22",
   "description": "SPARK skills and runtime bootstrap for coding agents",
   "type": "module",
   "publishConfig": {

package/skills/project-scanner/SKILL.md

@@ -11,7 +11,12 @@ Use this skill to scan and document a codebase's architecture, operational rules
 
 **Announce at start:** "spark detection 💥 Using project-scanner to analyze repository DNA"
 
-**Save findings to:** The `.docs/` directory. **You must physically create this directory and save the files to disk using your tools. Do NOT just print the output to the user.** For large projects, break down the documentation logically (e.g., `.docs/PROJECT_SCAN.md`, `.docs/API_CONTRACT.md`, `.docs/DOMAINS/`) instead of creating one massive monolithic file.
+**Save findings to:** The `.docs/` directory. **You must physically create this directory and save the files to disk using your tools. Do NOT just print the output to the user.** 
+
+## Multi-Project Workspaces (CRITICAL)
+If the workspace contains multiple independent projects or repositories (e.g., a `frontend` folder and a `backend` folder), you MUST generate a separate `.docs/` directory inside EACH project's root folder (e.g., `frontend/.docs/`, `backend/.docs/`). Do NOT combine them into a single global `.docs/` or dump everything into just one project's folder. Treat each independent project as its own ecosystem that requires its own documentation.
+
+For large projects, break down the documentation logically (e.g., `.docs/PROJECT_SCAN.md`, `.docs/API_CONTRACT.md`, `.docs/DOMAINS/`) instead of creating one massive monolithic file.
 
 ## Handling Massive Codebases (Subagent Delegation)
 If the repository is extremely large and analyzing all four pillars sequentially risks exceeding context limits or taking too long:
@@ -53,7 +58,8 @@ Identify conventions, rules, and technical debt enforced or found in the codebas
 ## Execution Checklist
 
 - `[ ]` **Step 1:** Announce skill usage exactly as required.
-- `[ ]` **Step 2:** Scan root configuration files and prioritize searching for Swagger/OpenAPI specifications.
-- `[ ]` **Step 3:** Scan source directory structures to infer the language, framework, and architectural patterns.
-- `[ ]` **Step 4:** Analyze testing frameworks, CI/CD workflows, and actively hunt for anti-patterns and legacy traps.
-- `[ ]` **Step 5 (CRITICAL):** You MUST use your file-writing tools to physically create the `.docs/` directory and save the markdown files (e.g. `PROJECT_SCAN.md`, `API_CONTRACT.md`) into it. DO NOT just print the summary into the chat! You must physically write the files to disk.
+- `[ ]` **Step 2:** Identify if the workspace contains multiple independent projects (e.g., frontend vs backend). If so, plan to scan and generate `.docs/` for EACH project separately.
+- `[ ]` **Step 3:** Scan root configuration files and prioritize searching for Swagger/OpenAPI specifications.
+- `[ ]` **Step 4:** Scan source directory structures to infer the language, framework, and architectural patterns.
+- `[ ]` **Step 5:** Analyze testing frameworks, CI/CD workflows, and actively hunt for anti-patterns and legacy traps.
+- `[ ]` **Step 6 (CRITICAL):** You MUST use your file-writing tools to physically create the `.docs/` directory (inside each project root if multi-repo) and save the markdown files (e.g. `PROJECT_SCAN.md`, `API_CONTRACT.md`) into it. DO NOT just print the summary into the chat! You must physically write the files to disk.

package/src/dashboard/public/index.html

@@ -621,19 +621,81 @@ ${steps}
                 return;
             }
 
-            // Create some dummy nodes for architecture visualization (in a real scenario we'd parse .docs/)
-            const nodes = new vis.DataSet([
-                { id: 1, label: 'Client App', color: '#00ffaa', shape: 'box' },
-                { id: 2, label: 'API Gateway', color: '#00ffaa', shape: 'box' },
-                { id: 3, label: 'Auth Service', color: '#ff4757', shape: 'box' },
-                { id: 4, label: 'Database', color: '#f1f5f9', shape: 'database' },
-            ]);
-            const edges = new vis.DataSet([
-                { from: 1, to: 2, arrows: 'to' },
-                { from: 2, to: 3, arrows: 'to', label: 'verify token' },
-                { from: 3, to: 4, arrows: 'to' },
-            ]);
-            
+            // Dynamic Mermaid Parser
+            let nodesMap = new Map();
+            let edgesList = [];
+            let nodeIdCounter = 1;
+
+            function parseNode(str) {
+                const match = str.trim().match(/^([a-zA-Z0-9_-]+)(.*)$/);
+                if (!match) return null;
+                const rawId = match[1];
+                let label = rawId;
+                let shape = 'box';
+                const rest = match[2].trim();
+                if (rest) {
+                    const labelMatch = rest.match(/[\[\(\{]+(.*?)[\]\}\)]+/);
+                    if (labelMatch) label = labelMatch[1].replace(/["']/g, '');
+                    if (rest.includes('[((') || rest.includes('[([')) shape = 'database';
+                    else if (rest.includes('{')) shape = 'diamond';
+                    else if (rest.includes('((')) shape = 'ellipse';
+                }
+                return { rawId, label, shape };
+            }
+
+            docsData.forEach(doc => {
+                const mermaidRegex = /```mermaid\s+([\s\S]*?)```/g;
+                let match;
+                while ((match = mermaidRegex.exec(doc.content)) !== null) {
+                    const lines = match[1].split('\n');
+                    lines.forEach(line => {
+                        let l = line.trim();
+                        if (!l || l.startsWith('graph') || l.startsWith('flowchart') || l.startsWith('subgraph') || l.startsWith('end')) return;
+
+                        const parts = l.split('-->');
+                        if (parts.length >= 2) {
+                            let fromPart = parts[0].trim();
+                            let toPart = parts.slice(1).join('-->').trim();
+                            
+                            let edgeLabel = '';
+                            if (toPart.startsWith('|')) {
+                                const pipeEnd = toPart.indexOf('|', 1);
+                                if (pipeEnd > -1) {
+                                    edgeLabel = toPart.substring(1, pipeEnd).trim();
+                                    toPart = toPart.substring(pipeEnd + 1).trim();
+                                }
+                            }
+
+                            const fNode = parseNode(fromPart);
+                            const tNode = parseNode(toPart);
+
+                            if (fNode && tNode) {
+                                if (!nodesMap.has(fNode.rawId)) {
+                                    nodesMap.set(fNode.rawId, { id: nodeIdCounter++, label: fNode.label, shape: fNode.shape, color: { background: '#151515', border: '#2a2a2a' } });
+                                }
+                                if (!nodesMap.has(tNode.rawId)) {
+                                    nodesMap.set(tNode.rawId, { id: nodeIdCounter++, label: tNode.label, shape: tNode.shape, color: { background: '#151515', border: '#2a2a2a' } });
+                                }
+
+                                edgesList.push({
+                                    from: nodesMap.get(fNode.rawId).id,
+                                    to: nodesMap.get(tNode.rawId).id,
+                                    arrows: 'to',
+                                    label: edgeLabel
+                                });
+                            }
+                        }
+                    });
+                }
+            });
+
+            if (nodesMap.size === 0) {
+                container.innerHTML = '<div style="padding: 40px; text-align: center; color: var(--text-muted);">No Mermaid architecture graphs found in .docs/ files. Run the project-scanner skill first.</div>';
+                return;
+            }
+
+            const nodes = new vis.DataSet(Array.from(nodesMap.values()));
+            const edges = new vis.DataSet(edgesList);
             const data = { nodes, edges };
             const options = {
                 nodes: { 
@@ -742,8 +804,15 @@ ${steps}
                             },
                             response: [{
                                 name: "Success",
+                                originalRequest: {
+                                    method: ep.method,
+                                    header: [{ key: "Authorization", value: "Bearer {{token}}" }, { key: "Content-Type", value: "application/json" }],
+                                    body: ep.method !== 'GET' ? { mode: "raw", raw: JSON.stringify(mock, null, 2) } : undefined,
+                                    url: { raw: `{{baseUrl}}/${pathArr.join('/')}`, host: ["{{baseUrl}}"], path: pathArr }
+                                },
                                 status: "OK",
                                 code: 200,
+                                _postman_previewlanguage: "json",
                                 header: [{ key: "Content-Type", value: "application/json" }],
                                 body: JSON.stringify({ success: true, data: mock }, null, 2)
                             }]
@@ -758,8 +827,15 @@ ${steps}
                             },
                             response: [{
                                 name: "Bad Request",
+                                originalRequest: {
+                                    method: ep.method,
+                                    header: [{ key: "Authorization", value: "Bearer {{token}}" }, { key: "Content-Type", value: "application/json" }],
+                                    body: ep.method !== 'GET' ? { mode: "raw", raw: "{}" } : undefined,
+                                    url: { raw: `{{baseUrl}}/${pathArr.join('/')}`, host: ["{{baseUrl}}"], path: pathArr }
+                                },
                                 status: "Bad Request",
                                 code: 400,
+                                _postman_previewlanguage: "json",
                                 header: [{ key: "Content-Type", value: "application/json" }],
                                 body: JSON.stringify({ success: false, error: { code: "VALIDATION_ERROR", message: "Invalid parameters provided" } }, null, 2)
                             }]
@@ -773,8 +849,14 @@ ${steps}
                             },
                             response: [{
                                 name: "Unauthorized",
+                                originalRequest: {
+                                    method: ep.method,
+                                    header: [], // No auth
+                                    url: { raw: `{{baseUrl}}/${pathArr.join('/')}`, host: ["{{baseUrl}}"], path: pathArr }
+                                },
                                 status: "Unauthorized",
                                 code: 401,
+                                _postman_previewlanguage: "json",
                                 header: [{ key: "Content-Type", value: "application/json" }],
                                 body: JSON.stringify({ success: false, error: { code: "UNAUTHORIZED", message: "Missing or invalid token" } }, null, 2)
                             }]