@comfanion/workflow 4.36.23 → 4.36.25

package/src/opencode/skills/unit-writing/templates/data-model.md

@@ -0,0 +1,57 @@
+# {{Unit Name}} Data Model
+
+**Version:** 1.0
+**Date:** {{YYYY-MM-DD}}
+**Status:** Active
+
+---
+
+## Design Principles
+
+| Principle | Description |
+|-----------|-------------|
+| {{Principle}} | {{Why this matters}} |
+
+---
+
+## Entity Relationship Diagram
+
+```
+{{ASCII or Mermaid diagram}}
+```
+
+---
+
+## Tables
+
+### {{Table Name}}
+
+{{Purpose of this table}}
+
+| Field | Type | Constraints | Description |
+|-------|------|-------------|-------------|
+| id | UUID | PK | Primary identifier |
+| {{field}} | {{type}} | {{constraints}} | {{description}} |
+
+**Indexes:**
+- `({{fields}})` — {{purpose}}
+
+---
+
+## Relations
+
+| Relation | Type | Description |
+|----------|------|-------------|
+| {{table_a}} → {{table_b}} | 1:N | {{description}} |
+
+---
+
+## Status Lifecycle
+
+```
+{{state_a}} ──► {{state_b}} ──► {{state_c}}
+```
+
+| Status | Description | Transitions To |
+|--------|-------------|----------------|
+| {{status}} | {{meaning}} | {{allowed_next}} |

package/src/opencode/skills/unit-writing/templates/entity.md

@@ -0,0 +1,85 @@
+# {{Name}}
+
+```yaml
+type: entity
+status: draft | approved
+version: "1.0"
+```
+
+---
+
+## Overview
+
+{{What this entity represents, its role in the domain.}}
+
+---
+
+## Boundaries
+
+| Aspect | Details |
+|--------|---------|
+| **Owns** | {{fields, behavior}} |
+| **Part of** | {{parent domain/module path}} |
+
+---
+
+## Data Model
+
+| Field | Type | Constraints | Description |
+|-------|------|-------------|-------------|
+| id | UUID | PK | Primary identifier |
+| {{field}} | {{type}} | {{constraints}} | {{description}} |
+
+---
+
+## Relations
+
+```
+{{Entity}} ──► {{Other}} ({{type}})
+{{Entity}} ──< {{Other}} ({{type}})
+```
+
+| Relation | Target | Type | Description |
+|----------|--------|------|-------------|
+| {{name}} | {{target}} | N:1 / 1:N / N:M | {{description}} |
+
+---
+
+## State Machine
+
+```
+{{state_a}} ──► {{state_b}} ──► {{state_c}}
+```
+
+| State | Description | Transitions To |
+|-------|-------------|----------------|
+| {{state}} | {{meaning}} | {{allowed_next}} |
+
+---
+
+## Operations
+
+| Operation | Input | Output | Description |
+|-----------|-------|--------|-------------|
+| Create | {{params}} | Entity | {{description}} |
+| {{op}} | {{params}} | {{result}} | {{description}} |
+
+**Business Rules:**
+- {{rule}}
+
+---
+
+## Errors
+
+| Error | Code | When |
+|-------|------|------|
+| {{Error}} | {{CODE}} | {{condition}} |
+
+---
+
+## References
+
+```
+→ Parent: {{parent path}}
+→ Related: {{related path}}
+```

package/src/opencode/skills/unit-writing/templates/events-index.md

@@ -0,0 +1,42 @@
+# {{Unit Name}} Events
+
+**Version:** 1.0
+**Date:** {{YYYY-MM-DD}}
+
+---
+
+## Overview
+
+{{Brief description of event patterns in this unit}}
+
+---
+
+## Event Flow
+
+```
+{{ASCII diagram: sources → processing → sinks}}
+```
+
+---
+
+## Topics
+
+### Produced Events
+
+| Topic | Events | Key | Description |
+|-------|--------|-----|-------------|
+| {{topic}} | {{EventType}} | {{partition_key}} | {{description}} |
+
+### Consumed Events
+
+| Topic | Events | Source |
+|-------|--------|--------|
+| {{topic}} | {{EventType}} | {{source_system}} |
+
+---
+
+## Schema Files
+
+| Schema | Description |
+|--------|-------------|
+| [{{event}}.avsc]({{event}}.avsc) | {{description}} |

package/src/opencode/skills/unit-writing/templates/index.md

@@ -0,0 +1,61 @@
+# {{Name}}
+
+```yaml
+type: module | domain | service | entity
+status: draft | approved
+version: "1.0"
+created: {{YYYY-MM-DD}}
+```
+
+---
+
+## Overview
+
+{{One paragraph describing what this unit does, what problem it solves, and key characteristics.}}
+
+**Not responsible for:**
+- {{What this unit explicitly doesn't handle}}
+
+---
+
+## Boundaries
+
+| Aspect | Details |
+|--------|---------|
+| **Owns** | {{tables, domain objects, behavior}} |
+| **Uses** | → Unit: `{{dependency}}` ({{purpose}}) |
+| **Provides** | {{APIs, events, services to others}} |
+
+---
+
+## Architecture
+
+```
+{{ASCII diagram showing high-level structure}}
+```
+
+---
+
+## Documents
+
+| Document | Description |
+|----------|-------------|
+| [data-model.md](data-model.md) | Database schema |
+| [api/](api/) | API specifications |
+| [events/](events/) | Event schemas |
+
+## Child Units
+
+| Unit | Type | Description |
+|------|------|-------------|
+| [services/{{service}}/](services/{{service}}/) | service | {{description}} |
+| [domains/{{domain}}/](domains/{{domain}}/) | domain | {{description}} |
+
+---
+
+## References
+
+```
+→ Architecture: docs/architecture.md
+→ Related: modules/{{related}}/ or services/{{related}}/
+```

package/src/opencode/tools/search.ts

@@ -44,6 +44,7 @@ Prerequisites: Run 'npx @comfanion/workflow index --index <name>' first.`,
     limit: tool.schema.number().optional().default(5).describe("Number of results to return (default: 5)"),
     searchAll: tool.schema.boolean().optional().default(false).describe("Search all indexes instead of just one"),
     freshen: tool.schema.boolean().optional().default(true).describe("Auto-update stale files before searching (default: true)"),
+    includeArchived: tool.schema.boolean().optional().default(false).describe("Include archived files in results (default: false). Files are archived if in /archive/ folder or have 'archived: true' in frontmatter."),
   },
 
   async execute(args, context) {
@@ -88,7 +89,7 @@ Prerequisites: Run 'npx @comfanion/workflow index --index <name>' first.`,
           if (args.freshen !== false) {
             await indexer.freshen()
           }
-          const results = await indexer.search(args.query, limit)
+          const results = await indexer.search(args.query, limit, args.includeArchived)
           allResults.push(...results.map((r: any) => ({ ...r, _index: idx })))
           await indexer.unloadModel() // Free memory after each index search
         }

package/src/vectorizer/index.js

@@ -181,6 +181,30 @@ class CodebaseIndexer {
     return crypto.createHash('md5').update(content).digest('hex');
   }
 
+  /**
+   * Check if file is archived (should be excluded from default search)
+   * Archived if:
+   * - Path contains /archive/ folder
+   * - File has frontmatter with archived: true
+   */
+  isArchived(relPath, content) {
+    // Check path
+    if (relPath.includes('/archive/') || relPath.startsWith('archive/')) {
+      return true;
+    }
+    
+    // Check frontmatter (YAML between --- markers at start of file)
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---/);
+    if (frontmatterMatch) {
+      const frontmatter = frontmatterMatch[1];
+      if (/^archived:\s*true/m.test(frontmatter)) {
+        return true;
+      }
+    }
+    
+    return false;
+  }
+
   async embed(text) {
     const model = await this.loadModel();
     const result = await model(text, { pooling: 'mean', normalize: true });
@@ -246,6 +270,7 @@ class CodebaseIndexer {
     }
 
     const chunks = this.chunkCode(content);
+    const archived = this.isArchived(relPath, content);
     const data = [];
 
     for (let i = 0; i < chunks.length; i++) {
@@ -254,7 +279,8 @@ class CodebaseIndexer {
         file: relPath,
         chunk_index: i,
         content: chunks[i],
-        vector: embedding
+        vector: embedding,
+        archived: archived
       });
     }
 
@@ -279,8 +305,11 @@ class CodebaseIndexer {
 
   /**
    * Semantic search across indexed codebase
+   * @param {string} query - Search query
+   * @param {number} limit - Max results (default 5)
+   * @param {boolean} includeArchived - Include archived files (default false)
    */
-  async search(query, limit = 5) {
+  async search(query, limit = 5, includeArchived = false) {
     const tableName = 'chunks';
     const tables = await this.db.tableNames();
     if (!tables.includes(tableName)) {
@@ -289,9 +318,18 @@ class CodebaseIndexer {
 
     const queryEmbedding = await this.embed(query);
     const table = await this.db.openTable(tableName);
-    const results = await table.search(queryEmbedding).limit(limit).execute();
     
-    return results;
+    // Fetch more results if we need to filter archived
+    const fetchLimit = includeArchived ? limit : limit * 3;
+    let results = await table.search(queryEmbedding).limit(fetchLimit).execute();
+    
+    // Filter out archived files unless explicitly requested
+    if (!includeArchived) {
+      results = results.filter(r => !r.archived);
+    }
+    
+    // Trim to requested limit
+    return results.slice(0, limit);
   }
 
   /**