@cluesmith/codev 1.5.27 → 1.6.0

package/skeleton/templates/lifecycle.md

@@ -0,0 +1,147 @@
+# Codev Project Lifecycle
+
+Every project in Codev flows through a series of stages from idea to production. This document explains each stage and how projects progress through the lifecycle.
+
+## Lifecycle Overview
+
+```
+conceived → specified → planned → implementing → implemented → committed → integrated
+```
+
+## Stages
+
+### 1. Conceived
+
+**What it means:** An idea has been captured. A spec file may exist but hasn't been approved yet.
+
+**Who does it:** Anyone can conceive a project by describing what they want to build.
+
+**What happens next:** The Architect (AI) writes a specification. The human reviews and approves it.
+
+**Artifact:** Draft specification in `codev/specs/NNNN-name.md`
+
+---
+
+### 2. Specified
+
+**What it means:** The specification has been approved by a human.
+
+**Who does it:** Only a human can approve a specification and mark it as specified.
+
+**What happens next:** The Architect creates an implementation plan.
+
+**Artifact:** Approved specification in `codev/specs/NNNN-name.md`
+
+---
+
+### 3. Planned
+
+**What it means:** An implementation plan exists that describes how to build the feature.
+
+**Who does it:** The Architect (AI) creates the plan, human reviews it.
+
+**What happens next:** A Builder is spawned to implement the plan.
+
+**Artifact:** Implementation plan in `codev/plans/NNNN-name.md`
+
+---
+
+### 4. Implementing
+
+**What it means:** Active development is in progress. A Builder is working on the code.
+
+**Who does it:** A Builder (AI agent) in an isolated git worktree.
+
+**What happens next:** Builder completes implementation and creates a PR.
+
+**Artifact:** Code changes in a builder worktree, work in progress
+
+---
+
+### 5. Implemented
+
+**What it means:** Code is complete, tests pass, and a Pull Request has been created.
+
+**Who does it:** The Builder creates the PR after completing implementation.
+
+**What happens next:** The Architect reviews the PR, Builder addresses feedback, then merges.
+
+**Artifact:** Open Pull Request ready for review
+
+---
+
+### 6. Committed
+
+**What it means:** The PR has been merged to the main branch.
+
+**Who does it:** The Builder merges after approval from the Architect's review.
+
+**What happens next:** Human validates in production and marks as integrated.
+
+**Artifact:** Merged PR, code on main branch
+
+---
+
+### 7. Integrated
+
+**What it means:** The feature has been validated in production and the project is complete.
+
+**Who does it:** Only a human can mark a project as integrated after validating it works.
+
+**What happens next:** Nothing - the project is complete! A review document captures lessons learned.
+
+**Artifact:** Review document in `codev/reviews/NNNN-name.md`
+
+---
+
+## Terminal States
+
+Projects can also end up in terminal states if they won't be completed:
+
+### Abandoned
+
+The project was canceled or rejected. It will not be implemented. The notes field in `projectlist.md` should explain why.
+
+### On-Hold
+
+The project is temporarily paused but may resume later. The notes field should explain the reason and any conditions for resuming.
+
+---
+
+## Human Approval Gates
+
+Two stages require explicit human approval - AI agents cannot bypass these:
+
+| Gate | Transition | Why |
+|------|------------|-----|
+| **Spec Approval** | conceived → specified | Humans must approve what gets built |
+| **Production Validation** | committed → integrated | Humans must verify it works in production |
+
+```
+conceived → [HUMAN APPROVES] → specified → planned → implementing → implemented → committed → [HUMAN VALIDATES] → integrated
+```
+
+---
+
+## Managing Projects
+
+All project tracking happens in `codev/projectlist.md`. To manage projects:
+
+- **Add a project:** Tell the Architect what you want to build
+- **Update status:** Ask the Architect to update the project status
+- **Approve stages:** Review the spec/plan and tell the Architect to mark it approved
+- **View progress:** Check the Projects tab in the dashboard or read `projectlist.md`
+
+---
+
+## Quick Reference
+
+| Stage | Artifact | Who Advances |
+|-------|----------|--------------|
+| Conceived | Draft spec | AI writes, human approves |
+| Specified | Approved spec | AI creates plan |
+| Planned | Implementation plan | AI spawns builder |
+| Implementing | WIP code | Builder completes |
+| Implemented | Open PR | Architect reviews, Builder merges |
+| Committed | Merged PR | Human validates |
+| Integrated | Review doc | Complete |

package/templates/dashboard/css/files.css

@@ -182,6 +182,16 @@
   color: var(--text-primary);
 }
 
+.dashboard-section-header .header-actions .btn-create {
+  color: var(--accent);
+  font-weight: 500;
+  border-style: dashed;
+}
+
+.dashboard-section-header .header-actions .btn-create:hover {
+  border-color: var(--accent);
+}
+
 .dashboard-section-content {
   flex: 1;
   overflow-y: auto;

package/templates/dashboard/css/layout.css

@@ -43,6 +43,15 @@
   background: rgba(239, 68, 68, 0.1);
 }
 
+.btn-primary {
+  border-color: var(--accent);
+  color: var(--accent);
+}
+
+.btn-primary:hover {
+  background: rgba(59, 130, 246, 0.1);
+}
+
 /* Main content area */
 .main {
   display: flex;

package/templates/dashboard/index.html

@@ -82,6 +82,23 @@
     </div>
   </div>
 
+  <!-- Create file dialog (Bugfix #131) -->
+  <div class="dialog-overlay hidden" id="create-file-dialog">
+    <div class="dialog">
+      <h3>Create New File</h3>
+      <div class="quick-paths">
+        <button class="quick-path" onclick="setCreateFilePath('codev/specs/')">codev/specs/</button>
+        <button class="quick-path" onclick="setCreateFilePath('codev/plans/')">codev/plans/</button>
+        <button class="quick-path" onclick="setCreateFilePath('src/')">src/</button>
+      </div>
+      <input type="text" id="create-file-path-input" placeholder="Enter file path (e.g., src/utils/helper.ts)" />
+      <div class="dialog-actions">
+        <button class="btn" onclick="hideCreateFileDialog()">Cancel</button>
+        <button class="btn btn-primary" onclick="createFile()">Create</button>
+      </div>
+    </div>
+  </div>
+
   <!-- Close confirmation dialog -->
   <div class="dialog-overlay hidden" id="close-dialog">
     <div class="dialog">

package/templates/dashboard/js/dialogs.js

@@ -1,7 +1,7 @@
 // Dialog, Context Menu, and Tab Close Functions
 
 // Close tab
-function closeTab(tabId, event) {
+async function closeTab(tabId, event) {
   const tab = tabs.find(t => t.id === tabId);
   if (!tab) return;
 
@@ -17,7 +17,23 @@ function closeTab(tabId, event) {
     return;
   }
 
-  // Show confirmation for builders and shells
+  // Check if process is still running before showing confirmation (Bugfix #132)
+  // If the shell/builder already exited, close immediately without confirmation
+  try {
+    const response = await fetch(`/api/tabs/${encodeURIComponent(tabId)}/running`);
+    if (response.ok) {
+      const { running } = await response.json();
+      if (!running) {
+        // Process already exited, close without confirmation
+        doCloseTab(tabId);
+        return;
+      }
+    }
+  } catch {
+    // On error, fall through to show confirmation (safer default)
+  }
+
+  // Show confirmation for builders and shells with running processes
   pendingCloseTabId = tabId;
   const dialog = document.getElementById('close-dialog');
   const title = document.getElementById('close-dialog-title');
@@ -164,6 +180,74 @@ async function openFile() {
   await openFileTab(path, { onSuccess: hideFileDialog });
 }
 
+// ========================================
+// Create File Dialog (Bugfix #131)
+// ========================================
+
+// Show create file dialog
+function showCreateFileDialog() {
+  document.getElementById('create-file-dialog').classList.remove('hidden');
+  const input = document.getElementById('create-file-path-input');
+  input.value = '';
+  input.focus();
+}
+
+// Hide create file dialog
+function hideCreateFileDialog() {
+  document.getElementById('create-file-dialog').classList.add('hidden');
+  document.getElementById('create-file-path-input').value = '';
+}
+
+// Set quick path for create file dialog
+function setCreateFilePath(path) {
+  const input = document.getElementById('create-file-path-input');
+  input.value = path;
+  input.focus();
+  // Move cursor to end
+  input.setSelectionRange(path.length, path.length);
+}
+
+// Create a new file
+async function createFile() {
+  const input = document.getElementById('create-file-path-input');
+  const filePath = input.value.trim();
+
+  if (!filePath) {
+    showToast('Please enter a file path', 'error');
+    return;
+  }
+
+  // Basic validation - prevent absolute paths and path traversal
+  if (filePath.startsWith('/') || filePath.includes('..')) {
+    showToast('Invalid file path', 'error');
+    return;
+  }
+
+  try {
+    const response = await fetch('/api/files', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ path: filePath, content: '' })
+    });
+
+    const result = await response.json();
+
+    if (!response.ok) {
+      showToast(result.error || 'Failed to create file', 'error');
+      return;
+    }
+
+    hideCreateFileDialog();
+    showToast(`Created ${filePath}`, 'success');
+
+    // Refresh files tree and open the new file
+    await refreshFilesTree();
+    await openFileTab(filePath, { showSwitchToast: false });
+  } catch (err) {
+    showToast('Network error: ' + err.message, 'error');
+  }
+}
+
 // Spawn worktree builder
 async function spawnBuilder() {
   try {

package/templates/dashboard/js/main.js

@@ -128,6 +128,7 @@ function renderDashboardTabContent() {
           <div class="dashboard-section-header" onclick="toggleSection('files')">
             <h3><span class="collapse-icon">▼</span> Files</h3>
             <div class="header-actions" onclick="event.stopPropagation()">
+              <button class="btn-create" onclick="showCreateFileDialog()" title="Create New File">+</button>
               <button onclick="refreshFilesTree()" title="Refresh">↻</button>
               <button onclick="collapseAllFolders()" title="Collapse All">⊟</button>
               <button onclick="expandAllFolders()" title="Expand All">⊞</button>
@@ -243,6 +244,7 @@ function setupKeyboardShortcuts() {
     if (e.key === 'Escape') {
       hideFileDialog();
       hideCloseDialog();
+      hideCreateFileDialog();
       hideContextMenu();
       hideOverflowMenu();
       const activityModal = document.getElementById('activity-modal');
@@ -259,6 +261,9 @@ function setupKeyboardShortcuts() {
       if (!document.getElementById('file-dialog').classList.contains('hidden')) {
         openFile();
       }
+      if (!document.getElementById('create-file-dialog').classList.contains('hidden')) {
+        createFile();
+      }
     }
 
     // Ctrl+Tab / Ctrl+Shift+Tab to switch tabs