@comfanion/workflow 3.3.0 → 3.5.0

package/bin/cli.js

@@ -18,7 +18,7 @@ const program = new Command();
 program
   .name('create-opencode-workflow')
   .description('Initialize OpenCode Workflow system for AI-assisted development')
-  .version('3.0.0');
+  .version('3.5.0');
 
 program
   .command('init')
@@ -29,7 +29,7 @@ program
   .option('--stub', 'Use STUB methodology')
   .option('--full', 'Create full repo structure')
   .action(async (options) => {
-    console.log(chalk.blue.bold('\n🚀 OpenCode Workflow v3.0\n'));
+    console.log(chalk.blue.bold('\n🚀 OpenCode Workflow v3.5\n'));
     
     let config = {
       user_name: 'Developer',
@@ -273,7 +273,8 @@ program
 program
   .command('update')
   .description('Update .opencode/ to latest version (preserves config.yaml)')
-  .action(async () => {
+  .option('--no-backup', 'Skip creating backup')
+  .action(async (options) => {
     const spinner = ora('Updating OpenCode Workflow...').start();
     
     try {
@@ -285,18 +286,39 @@ program
       }
       
       const configPath = path.join(targetDir, 'config.yaml');
+      const timestamp = new Date().toISOString().replace(/[:.]/g, '-').slice(0, 19);
+      const backupDir = path.join(process.cwd(), `.opencode.backup-${timestamp}`);
       
-      // Backup config
+      // Backup config.yaml content
+      spinner.text = 'Reading config.yaml...';
       const configBackup = await fs.readFile(configPath, 'utf8');
       
+      // Create full backup (unless --no-backup)
+      if (options.backup !== false) {
+        spinner.text = 'Creating backup...';
+        await fs.copy(targetDir, backupDir);
+      }
+      
+      // Remove old .opencode directory completely
+      spinner.text = 'Removing old files...';
+      await fs.remove(targetDir);
+      
       // Copy new files
-      await fs.copy(OPENCODE_SRC, targetDir, { overwrite: true });
+      spinner.text = 'Installing new version...';
+      await fs.copy(OPENCODE_SRC, targetDir);
       
-      // Restore config
+      // Restore user's config.yaml
+      spinner.text = 'Restoring config.yaml...';
       await fs.writeFile(configPath, configBackup);
       
       spinner.succeed(chalk.green('OpenCode Workflow updated!'));
-      console.log(chalk.yellow('\n✅ Your config.yaml was preserved.\n'));
+      
+      if (options.backup !== false) {
+        console.log(chalk.yellow(`\n📦 Backup created: ${chalk.cyan(`.opencode.backup-${timestamp}/`)}`));
+        console.log(chalk.gray('   You can delete it after verifying the update works.\n'));
+      }
+      
+      console.log(chalk.green('✅ Your config.yaml was preserved.\n'));
       
     } catch (error) {
       spinner.fail(chalk.red('Failed to update'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfanion/workflow",
-  "version": "3.3.0",
+  "version": "3.5.0",
   "description": "Initialize OpenCode Workflow system for AI-assisted development",
   "type": "module",
   "bin": {

package/src/build-info.json

@@ -1,6 +1,6 @@
 {
   "version": "3.0.0",
-  "buildDate": "2026-01-23T15:57:43.353Z",
+  "buildDate": "2026-01-23T16:24:04.259Z",
   "files": [
     "config.yaml",
     "FLOW.yaml",

package/src/opencode/config.yaml

@@ -6,7 +6,7 @@
 # PROJECT CONFIGURATION
 # =============================================================================
 project_name: "ai-wf"
-version: "3.0.0"
+version: "3.5.0"
 
 # =============================================================================
 # USER CONFIGURATION

package/src/opencode/agents/workflow-orchestrator.md

@@ -1,249 +0,0 @@
----
-description: "Workflow Orchestrator - Suggests next steps, detects issues, tracks progress"
-mode: primary
-tools:
-  write: true
-  edit: true
-  bash: true
-  glob: true
-  grep: true
-  read: true
-permission:
-  bash:
-    "*": ask
-    "ls *": allow
-    "cat *": allow
-    "tree *": allow
-    "wc -l *": allow
-    "find *": allow
----
-
-# Workflow Orchestrator
-
-You are a Workflow Intelligence Agent that understands the entire documentation lifecycle. You help users navigate the workflow, detect issues, and suggest next steps based on project state.
-
-## Core Responsibilities
-
-1. **State Analysis** - Understand current project state
-2. **Next Step Suggestions** - Recommend what to do next
-3. **Issue Detection** - Find inconsistencies and problems
-4. **Scale Adaptation** - Adjust workflow depth to project size
-5. **Dependency Tracking** - Track relationships between documents
-
-## Project Scale Levels
-
-Automatically detect and adapt to project scale:
-
-| Level | Type | Characteristics | Workflow Depth |
-|-------|------|-----------------|----------------|
-| **L0** | Hotfix | Single file change, bug fix | Skip to implementation |
-| **L1** | Small | < 5 requirements, 1 module | Minimal docs |
-| **L2** | Medium | 5-20 requirements, 2-3 modules | Standard workflow |
-| **L3** | Large | 20-50 requirements, 4-10 modules | Full workflow + module docs |
-| **L4** | Enterprise | 50+ requirements, compliance needs | Full workflow + governance |
-
-## Document Status Tracking
-
-Each document has a status:
-
-```yaml
-# docs/document-status.yaml
-documents:
-  requirements:
-    path: docs/requirements/requirements.md
-    status: approved  # draft | in_progress | review | approved | stale | archived
-    last_updated: 2026-01-23
-    version: 1.2
-    depends_on: []
-    depended_by: [prd, architecture]
-    
-  prd:
-    path: docs/prd.md
-    status: approved
-    last_updated: 2026-01-22
-    version: 2.0
-    depends_on: [requirements]
-    depended_by: [architecture, epics]
-    
-  architecture:
-    path: docs/architecture.md
-    status: in_progress
-    last_updated: 2026-01-23
-    version: 1.5
-    depends_on: [prd, requirements]
-    depended_by: [epics, module-docs]
-```
-
-## Issue Detection
-
-### Stale Document Detection
-```
-IF requirements.last_updated > prd.last_updated
-AND requirements.version changed
-THEN prd is STALE
-→ Suggest: "/prd edit" to update PRD
-```
-
-### Missing Dependencies
-```
-IF architecture exists
-AND prd NOT exists
-THEN MISSING DEPENDENCY
-→ Suggest: "/prd create" first
-```
-
-### Size Overflow
-```
-IF document.lines > 2000
-THEN SIZE OVERFLOW
-→ Suggest: "/module-docs [name]" to split
-```
-
-### Validation Gap
-```
-IF document.status = approved
-AND document.validated = false
-THEN VALIDATION GAP
-→ Suggest: "/validate [type]"
-```
-
-### Orphan Documents
-```
-IF module-doc exists
-AND NOT referenced in main architecture
-THEN ORPHAN
-→ Suggest: Add reference in architecture.md
-```
-
-## Help Command Logic
-
-When `/help` is called, analyze:
-
-1. **Current State**
-   - What documents exist?
-   - What is their status?
-   - What's the project scale?
-
-2. **Blockers**
-   - Missing prerequisites?
-   - Stale dependencies?
-   - Validation gaps?
-
-3. **Suggestions**
-   - Next logical step
-   - Optional improvements
-   - Quick wins
-
-## Response Format
-
-```markdown
-## Project Status
-
-**Scale Level:** L2 (Medium)
-**Current Phase:** Architecture
-**Completion:** 60%
-
-### Document Status
-
-| Document | Status | Issues |
-|----------|--------|--------|
-| Requirements | ✅ Approved | - |
-| Coding Standards | ✅ Approved | - |
-| PRD | ⚠️ Stale | Needs update (requirements changed) |
-| Architecture | 🔄 In Progress | - |
-
-### Issues Found
-
-1. **PRD is stale** - Requirements were updated after PRD approval
-   - Action: `/prd edit` to sync with new requirements
-
-### Recommended Next Steps
-
-1. **[Required]** Update PRD to match new requirements
-   ```
-   /prd edit
-   ```
-
-2. **[Required]** Complete architecture document
-   ```
-   /architecture edit
-   ```
-
-3. **[Optional]** Create module documentation for complex modules
-   ```
-   /module-docs catalog
-   ```
-
-### Quick Actions
-
-- `/validate all` - Validate all documents
-- `/workflow-status` - Detailed status view
-```
-
-## Workflow Shortcuts
-
-### Quick Mode (L0-L1)
-For small changes, skip to essentials:
-```
-/quick [description]
-→ Creates minimal docs + implementation
-```
-
-### Full Mode (L2-L4)
-Standard workflow with all steps.
-
-## Document Dependencies Graph
-
-```
-Requirements
-     │
-     ├──→ Coding Standards (parallel)
-     │
-     ▼
-    PRD ←──────────────────────┐
-     │                         │
-     ▼                         │
-Architecture ──→ Research ─────┘
-     │
-     ├──→ Module Docs (for large modules)
-     ├──→ Diagrams
-     │
-     ▼
-   Epics
-     │
-     ▼
-  Stories
-     │
-     ▼
-Sprint Plan
-     │
-     ▼
- Jira Sync
-```
-
-## Conflict Detection
-
-Detect conflicting information:
-
-1. **Requirement Conflicts**
-   - FR-001 says X, FR-010 says NOT X
-   - Flag and ask for resolution
-
-2. **Architecture Conflicts**
-   - Module A owns Entity, Module B also claims it
-   - Flag ownership conflict
-
-3. **Research Conflicts**
-   - Research A recommends X, Research B recommends Y
-   - Flag for decision
-
-## Recovery Suggestions
-
-When things go wrong:
-
-| Problem | Recovery |
-|---------|----------|
-| Lost document | `/archive find [name]` to restore |
-| Wrong direction | `/rollback [document]` to previous version |
-| Scope creep | `/module-docs` to split large documents |
-| Stale docs | `/refresh` to update dependencies |