iikit-dashboard 1.4.0 → 1.5.0

package/bin/iikit-dashboard.js

@@ -2,11 +2,11 @@
 'use strict';
 
 const path = require('path');
-const { createServer } = require('../src/server');
+const { createServer, removePidfile } = require('../src/server');
 
 // Parse arguments
 const args = process.argv.slice(2);
-let projectPath = process.cwd();
+let projectPath = path.resolve(process.cwd());
 let port = 3000;
 
 for (let i = 0; i < args.length; i++) {
@@ -46,6 +46,7 @@ async function main() {
     // Handle graceful shutdown
     process.on('SIGINT', () => {
       console.log('\n  Shutting down...');
+      removePidfile(projectPath);
       result.server.close(() => {
         if (result.watcher) result.watcher.close();
         process.exit(0);
@@ -53,6 +54,7 @@ async function main() {
     });
 
     process.on('SIGTERM', () => {
+      removePidfile(projectPath);
       result.server.close(() => {
         if (result.watcher) result.watcher.close();
         process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "iikit-dashboard",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "description": "Real-time dashboard for Intent Integrity Kit (IIKit) — visualizes every phase of specification-driven AI development",
   "main": "src/server.js",
   "bin": {

package/src/public/index.html

@@ -93,6 +93,17 @@
       flex: 1 1 auto;
     }
 
+    .project-label {
+      font-size: 12px;
+      color: var(--color-text-muted);
+      max-width: 160px;
+      overflow: hidden;
+      text-overflow: ellipsis;
+      white-space: nowrap;
+      border-left: 1px solid var(--color-border);
+      padding-left: 12px;
+    }
+
     .feature-selector {
       position: relative;
       min-width: 100px;
@@ -2368,6 +2379,7 @@
         <div class="logo-icon" aria-hidden="true">D</div>
         <span>IIKit Dashboard</span>
       </div>
+      <div class="project-label" id="projectLabel" title=""></div>
       <div class="feature-selector" role="navigation" aria-label="Feature selector">
         <select id="featureSelect" aria-label="Select feature to display" tabindex="0">
           <option value="">Loading features...</option>
@@ -5188,6 +5200,12 @@
       applyTheme(themeMode);
 
       // ====== Init ======
+      fetch('/api/meta').then(r => r.json()).then(meta => {
+        const label = document.getElementById('projectLabel');
+        const dirName = meta.projectPath.split('/').pop();
+        label.textContent = dirName;
+        label.title = meta.projectPath;
+      }).catch(() => {});
       loadFeatures();
       connectWebSocket();
     })();

package/src/server.js

@@ -98,6 +98,33 @@ function getBoardState(projectPath, featureId) {
   return { ...board, integrity };
 }
 
+/**
+ * Write a pidfile with metadata so external scripts can identify this dashboard instance.
+ */
+function writePidfile(projectPath, port) {
+  const resolved = path.resolve(projectPath);
+  const specifyDir = path.join(resolved, '.specify');
+  fs.mkdirSync(specifyDir, { recursive: true });
+  const pidData = {
+    pid: process.pid,
+    port,
+    directory: resolved,
+    startedAt: new Date().toISOString()
+  };
+  fs.writeFileSync(path.join(specifyDir, 'dashboard.pid.json'), JSON.stringify(pidData, null, 2));
+}
+
+/**
+ * Remove the pidfile on shutdown.
+ */
+function removePidfile(projectPath) {
+  try {
+    fs.unlinkSync(path.join(path.resolve(projectPath), '.specify', 'dashboard.pid.json'));
+  } catch (err) {
+    if (err.code !== 'ENOENT') throw err;
+  }
+}
+
 /**
  * Create and configure the Express server with WebSocket support.
  *
@@ -107,11 +134,17 @@ function getBoardState(projectPath, featureId) {
  * @returns {Promise<{server: http.Server, port: number, wss: WebSocketServer}>}
  */
 function createServer({ projectPath, port = 3000 }) {
+  const resolvedPath = path.resolve(projectPath);
   const app = express();
 
   // Serve static files from src/public
   app.use(express.static(path.join(__dirname, 'public')));
 
+  // API: project metadata
+  app.get('/api/meta', (req, res) => {
+    res.json({ projectPath: resolvedPath });
+  });
+
   // API: list features
   app.get('/api/features', (req, res) => {
     try {
@@ -363,9 +396,10 @@ function createServer({ projectPath, port = 3000 }) {
   return new Promise((resolve) => {
     server.listen(port, () => {
       const actualPort = server.address().port;
-      resolve({ server, port: actualPort, wss, watcher });
+      writePidfile(resolvedPath, actualPort);
+      resolve({ server, port: actualPort, wss, watcher, projectPath: resolvedPath });
     });
   });
 }
 
-module.exports = { createServer, listFeatures, getBoardState };
+module.exports = { createServer, listFeatures, getBoardState, removePidfile };