@tdsoft-tech/aikit 0.1.19 → 0.1.30

package/dist/cli.js

@@ -1220,11 +1220,95 @@ var init_beads = __esm({
       }
       /**
        * Initialize local .beads directory (works without global beads CLI)
+       * Creates a fully functional beads workspace for OpenCode/Claude Code
        */
       async initLocal() {
         try {
           const beadsDir = paths.beadsDir(this.projectPath);
           await mkdir5(beadsDir, { recursive: true });
+          const configYaml = `# Beads Configuration File
+# This file configures default behavior for all bd commands in this repository
+# All settings can also be set via environment variables (BD_* prefix)
+# or overridden with command-line flags
+
+# Issue prefix for this repository (used by bd init)
+# If not set, bd init will auto-detect from directory name
+# issue-prefix: ""
+
+# Use no-db mode: load from JSONL, no SQLite, write back after each command
+# When true, bd will use .beads/issues.jsonl as the source of truth
+# instead of SQLite database
+# no-db: false
+
+# Disable daemon for RPC communication (forces direct database access)
+# no-daemon: false
+
+# Disable auto-flush of database to JSONL after mutations
+# no-auto-flush: false
+
+# Disable auto-import from JSONL when it's newer than database
+# no-auto-import: false
+
+# Enable JSON output by default
+# json: false
+
+# Default actor for audit trails (overridden by BD_ACTOR or --actor)
+# actor: ""
+
+# Path to database (overridden by BEADS_DB or --db)
+# db: ""
+
+# Auto-start daemon if not running (can also use BEADS_AUTO_START_DAEMON)
+# auto-start-daemon: true
+
+# Debounce interval for auto-flush (can also use BEADS_FLUSH_DEBOUNCE)
+# flush-debounce: "5s"
+
+# Git branch for beads commits (bd sync will commit to this branch)
+# IMPORTANT: Set this for team projects so all clones use the same sync branch.
+# sync-branch: "beads-sync"
+`;
+          await writeFile5(join9(beadsDir, "config.yaml"), configYaml);
+          const metadata = {
+            database: "beads.db",
+            jsonl_export: "issues.jsonl"
+          };
+          await writeFile5(join9(beadsDir, "metadata.json"), JSON.stringify(metadata, null, 2));
+          const gitignore = `# SQLite databases
+*.db
+*.db?*
+*.db-journal
+*.db-wal
+*.db-shm
+
+# Daemon runtime files
+daemon.lock
+daemon.log
+daemon.pid
+bd.sock
+
+# Local version tracking (prevents upgrade notification spam after git ops)
+.local_version
+
+# Legacy database files
+db.sqlite
+bd.db
+
+# Merge artifacts (temporary files from 3-way merge)
+beads.base.jsonl
+beads.base.meta.json
+beads.left.jsonl
+beads.left.meta.json
+beads.right.jsonl
+beads.right.meta.json
+
+# Keep JSONL exports and config (source of truth for git)
+!issues.jsonl
+!metadata.json
+!config.json
+`;
+          await writeFile5(join9(beadsDir, ".gitignore"), gitignore);
+          await writeFile5(join9(beadsDir, ".local_version"), "0.32.1\n");
           const readmeContent = `# Beads - Task Tracking
 
 This directory contains task beads for tracking work items.
@@ -1235,14 +1319,17 @@ This directory contains task beads for tracking work items.
 - Use \`/create\` command to create new tasks
 - Use \`/finish\` command to complete tasks with quality gates
 
-## Beads CLI
-For full functionality, install beads globally:
+## Automatic Setup
+This directory was automatically initialized by AIKit for use with OpenCode/Claude Code.
+No manual setup required - it's ready to use!
+
+## Beads CLI (Optional)
+For advanced functionality, you can install the beads CLI globally:
 \`\`\`bash
 npm install -g beads
-bd init
 \`\`\`
 
-## Available Commands
+Then you can use commands like:
 - \`bd ready\` - Show available work
 - \`bd show <id>\` - View task details
 - \`bd update <id> --status in_progress\` - Update task status
@@ -4633,30 +4720,27 @@ init_esm_shims();
 var DRAWIO_COMMANDS = [
   {
     name: "drawio-interact",
-    description: "Create/edit diagrams with AI + Draw.io + auto-sync",
+    description: "Create and edit diagrams with Draw.io (manual sync)",
     category: "design",
-    usage: "/drawio-interact <create|modify|list|start-sync|stop-sync> [diagram-name]",
+    usage: "/drawio-interact <create|open|sync-to-mmd|sync-to-drawio|list> [diagram-name]",
     examples: [
       "/drawio-interact create login-flow",
-      "/drawio-interact modify login-flow",
-      "/drawio-interact list",
-      "/drawio-interact start-sync",
-      "/drawio-interact stop-sync"
+      "/drawio-interact open login-flow",
+      "/drawio-interact sync-to-mmd login-flow",
+      "/drawio-interact sync-to-drawio login-flow",
+      "/drawio-interact list"
     ],
-    content: `Interactive diagram workflow with AI + Draw.io + background sync.
+    content: `Interactive diagram workflow with AI + Draw.io + manual sync.
 
 **User provided**: $ARGUMENTS
 
 ## File Locations
 
-**NEW STRUCTURE**:
-- **Mermaid files**: \`mermaid/[name].mmd\` (project root, version control)
+**Standard locations**:
+- **Mermaid files**: \`mermaid/[name].mmd\` (version control)
 - **Draw.io files**: \`.aikit/assets/drawio/[name].drawio\` (visual editing)
 
-**Background Sync**:
-- Auto-syncs changes between both formats
-- Runs as background service
-- Detects changes in real-time
+**Custom paths**: You can also specify full paths to sync any diagram files.
 
 ## Workflow
 
@@ -4664,10 +4748,10 @@ var DRAWIO_COMMANDS = [
 
 Check if user wants to:
 - **create** - Generate new diagram and open in Draw.io
-- **modify** - Manual sync (if background sync not running)
+- **open** - Open existing diagram in Draw.io
+- **sync-to-mmd** - Convert Draw.io \u2192 Mermaid
+- **sync-to-drawio** - Convert Mermaid \u2192 Draw.io
 - **list** - Show all existing diagrams
-- **start-sync** - Start background sync service
-- **stop-sync** - Stop background sync service
 
 ### Step 2: Create Diagram (if "create")
 
@@ -4677,260 +4761,320 @@ Check if user wants to:
    - "create login-flow" \u2192 name = "login-flow"
    - If no name provided, ask user
 
-2. **Generate Mermaid code** based on description:
+2. **Ensure directories exist**:
+\`\`\`javascript
+import { ensureDiagramDirectories } from '@tdsoft-tech/aikit/tools/drawio-convert/diagram-utils.js';
+ensureDiagramDirectories(projectRoot);
+\`\`\`
+
+3. **Generate Mermaid code** based on description:
    - Login/auth \u2192 Flowchart with authentication
    - Order/purchase \u2192 Flowchart with payment
    - API/request \u2192 Sequence diagram
    - Generic \u2192 Basic flowchart
 
-3. **Create files**:
-   - \`mermaid/[name].mmd\` - Mermaid source
-   - \`.aikit/assets/drawio/[name].drawio\` - Draw.io XML
-
-4. **Open in Draw.io with auto-sync**:
-   - Use lifecycle manager for automatic sync start/stop
-   - Sync starts when Draw.io opens
-   - Sync stops when Draw.io closes
-   - No manual intervention needed!
-
-**Implementation**: Use lifecycle manager
-
+4. **Convert to Draw.io**:
 \`\`\`javascript
-import { openDrawioWithAutoSync } from '.aikit/tools/drawio-sync/lifecycle-manager.js';
-import { join } from 'path';
+import { convertToDrawioFile } from '@tdsoft-tech/aikit/tools/drawio-convert/convert-to-drawio.js';
 
-const projectRoot = process.cwd();
+const mermaidPath = join(projectRoot, 'mermaid', \`\${name}.mmd\`);
 const drawioPath = join(projectRoot, '.aikit/assets/drawio', \`\${name}.drawio\`);
 
-// This will:
-// 1. Start sync service automatically
-// 2. Open Draw.io app
-// 3. Monitor Draw.io process
-// 4. Stop sync when Draw.io closes
-await openDrawioWithAutoSync(drawioPath);
+// Write Mermaid file first
+fs.writeFileSync(mermaidPath, mermaidCode, 'utf-8');
+
+// Convert to Draw.io
+const result = convertToDrawioFile(mermaidPath, drawioPath, name);
 \`\`\`
 
-**What happens**:
-- \u2705 Sync service starts automatically
-- \u2705 Draw.io opens
-- \u2705 Files stay in sync while editing
-- \u2705 Sync stops automatically when Draw.io closes
-- \u2705 Zero manual intervention!
+5. **Open in Draw.io**:
+\`\`\`javascript
+import { openDiagram } from '@tdsoft-tech/aikit/tools/drawio-convert/open-diagram.js';
+const openResult = openDiagram(drawioPath);
+\`\`\`
 
-5. **Report success**:
+6. **Report success**:
    - Show generated Mermaid code
    - Confirm file locations
-   - Confirm Draw.io opened with auto-sync
-   - Inform user: "Sync will stop automatically when you close Draw.io"
+   - Confirm Draw.io opened
+   - Inform user: "After editing, run /drawio-interact sync-to-mmd [name]"
 
-### Step 3: Modify Diagram (if "modify")
+### Step 3: Open Diagram (if "open")
 
-**Action**: Manual one-time sync (use if background sync not running)
+**Action**: Open existing diagram in Draw.io
 
-1. **Extract diagram name**
-2. **Read files**:
-   - \`mermaid/[name].mmd\`
-   - \`.aikit/assets/drawio/[name].drawio\`
+1. **Resolve diagram path**:
+\`\`\`javascript
+import { resolveDiagramPath } from '@tdsoft-tech/aikit/tools/drawio-convert/diagram-utils.js';
 
-3. **Convert Draw.io \u2192 Mermaid**
-4. **Detect changes**
-5. **Update Mermaid file**
-6. **Report changes**
+const drawioPath = resolveDiagramPath(name, 'drawio', projectRoot);
+\`\`\`
 
-**Note**: If background sync is running, this is automatic!
+2. **Check file exists** - If not, ask to create first
 
-### Step 4: List Diagrams (if "list")
+3. **Open in Draw.io**:
+\`\`\`javascript
+import { openDiagram } from '@tdsoft-tech/aikit/tools/drawio-convert/open-diagram.js';
+const result = openDiagram(drawioPath);
+\`\`\`
 
-**Action**: Show all diagrams
+4. **Tip**: "After editing, run /drawio-interact sync-to-mmd [name] to update Mermaid"
 
-\`\`\`bash
-ls mermaid/*.mmd 2>/dev/null | sed 's/mermaid\\///' | sed 's/.mmd$//'
+### Step 4: Sync to Mermaid (if "sync-to-mmd")
+
+**Action**: Convert Draw.io file \u2192 Mermaid format (update source code)
+
+1. **Resolve diagram path**:
+\`\`\`javascript
+import { resolveDiagramPath } from '@tdsoft-tech/aikit/tools/drawio-convert/diagram-utils.js';
+
+// Can be name or full path
+const drawioPath = resolveDiagramPath(input, 'drawio', projectRoot);
 \`\`\`
 
-Format as numbered list with file info.
+2. **Validate file exists**
 
-### Step 5: Start Sync (if "start-sync")
+3. **Convert Draw.io \u2192 Mermaid**:
+\`\`\`javascript
+import { convertToMermaidFile } from '@tdsoft-tech/aikit/tools/drawio-convert/convert-to-mermaid.js';
+import { findPairedDiagram } from '@tdsoft-tech/aikit/tools/drawio-convert/diagram-utils.js';
+
+// Find paired Mermaid file
+const mermaidPath = findPairedDiagram(drawioPath, projectRoot);
+
+// If not found, ask user where to save
+if (!mermaidPath) {
+  const name = path.basename(drawioPath, '.drawio');
+  mermaidPath = join(projectRoot, 'mermaid', \`\${name}.mmd\`);
+}
 
-**Action**: Start background sync service
+// Convert
+const result = convertToMermaidFile(drawioPath, mermaidPath);
+\`\`\`
 
-1. **Check if service already running**
-2. **Start Chokidar file watcher**:
-   - Watch \`mermaid/*.mmd\`
-   - Watch \`.aikit/assets/drawio/*.drawio\`
-3. **Auto-sync on change**:
-   - Debounce: 500ms
-   - Lock files during sync to prevent loops
-   - Log all changes
-4. **Report**: "Background sync running"
+4. **Handle errors**:
+   - If errors: Show exact error with suggestions
+   - If warnings: Show warnings but continue
 
-**Implementation**: Use .aikit/tools/drawio-sync/sync-service.js
+5. **Report success**:
+   - Show conversion stats (nodes, edges)
+   - Show preview of updated Mermaid (10 lines)
+   - Confirm file updated: "\u2705 Synced: [name].drawio \u2192 [name].mmd"
 
+### Step 5: Sync to Draw.io (if "sync-to-drawio")
+
+**Action**: Convert Mermaid \u2192 Draw.io format (update visual diagram)
+
+1. **Resolve diagram path**:
 \`\`\`javascript
-import { startSyncService } from '.aikit/tools/drawio-sync/sync-service.js';
-startSyncService();
-\`\`\`
+import { resolveDiagramPath } from '@tdsoft-tech/aikit/tools/drawio-convert/diagram-utils.js';
 
-### Step 6: Stop Sync (if "stop-sync")
+const mermaidPath = resolveDiagramPath(input, 'mermaid', projectRoot);
+\`\`\`
 
-**Action**: Stop background sync service
+2. **Validate file exists**
 
+3. **Convert Mermaid \u2192 Draw.io**:
 \`\`\`javascript
-import { stopSyncService } from '.aikit/tools/drawio-sync/sync-service.js';
-stopSyncService();
+import { convertToDrawioFile } from '@tdsoft-tech/aikit/tools/drawio-convert/convert-to-drawio.js';
+import { findPairedDiagram } from '@tdsoft-tech/aikit/tools/drawio-convert/diagram-utils.js';
+
+// Find paired Draw.io file
+const drawioPath = findPairedDiagram(mermaidPath, projectRoot);
+
+// If not found, ask user where to save
+if (!drawioPath) {
+  const name = path.basename(mermaidPath, '.mmd');
+  drawioPath = join(projectRoot, '.aikit/assets/drawio', \`\${name}.drawio\`);
+}
+
+// Convert
+const result = convertToDrawioFile(mermaidPath, drawioPath, name);
 \`\`\`
 
-## Conversion Tools
+4. **Handle errors**:
+   - If Mermaid syntax errors: Show line number and fix suggestions
+   - If conversion warnings: Show but continue
 
-**Location**: \`.aikit/tools/drawio-sync/\`
+5. **Report success**:
+   - Show conversion stats
+   - Confirm file updated
+   - **Prompt**: "Open in Draw.io? (y/n)"
+     - If yes: invoke openDiagram()
+
+### Step 6: List Diagrams (if "list")
 
-**Modules**:
-- \`mermaid-to-drawio.js\` - Mermaid \u2192 Draw.io conversion
-- \`drawio-to-mermaid.js\` - Draw.io \u2192 Mermaid conversion
-- \`sync-service.js\` - Background sync service
-- \`lifecycle-manager.js\` - **NEW!** Automatic lifecycle (start/stop sync with Draw.io)
+**Action**: Show all diagrams
 
-**Lifecycle Manager Usage** (recommended for "create" command):
 \`\`\`javascript
-import { openDrawioWithAutoSync } from '.aikit/tools/drawio-sync/lifecycle-manager.js';
-import { join } from 'path';
+import { getDiagramList } from '@tdsoft-tech/aikit/tools/drawio-convert/diagram-utils.js';
 
-const drawioPath = join(process.cwd(), '.aikit/assets/drawio', name + '.drawio');
+const diagrams = getDiagramList(projectRoot);
 
-// Automatically:
-// - Starts sync when Draw.io opens
-// - Stops sync when Draw.io closes
-await openDrawioWithAutoSync(drawioPath);
+diagrams.forEach((d, i) => {
+  console.log(\`\${i + 1}. \${d.name}\`);
+  console.log(\`   Mermaid: \${d.mermaid || '[missing]'}\`);
+  console.log(\`   Drawio: \${d.drawio || '[missing]'}\`);
+  console.log();
+});
 \`\`\`
 
-**Manual Conversion** (for "modify" command):
-\`\`\`javascript
-import { convertMermaidToDrawio } from '.aikit/tools/drawio-sync/mermaid-to-drawio.js';
-import { convertDrawioToMermaid } from '.aikit/tools/drawio-sync/drawio-to-mermaid.js';
+## Error Handling
+
+### File Not Found
+\`\`\`
+\u274C File not found: mermaid/login-flow.mmd
 
-// Mermaid \u2192 Draw.io
-const result = convertMermaidToDrawio(mermaidCode, diagramName);
-fs.writeFileSync('.aikit/assets/drawio/name.drawio', result.xml, 'utf-8');
+Did you mean:
+- mermaid/auth-flow.mmd
+- mermaid/login.mmd
 
-// Draw.io \u2192 Mermaid
-const result = convertDrawioToMermaid(drawioXML);
-fs.writeFileSync('mermaid/name.mmd', result.code, 'utf-8');
+Or run: /drawio-interact create login-flow
 \`\`\`
 
-## Error Handling
+### Invalid Mermaid Syntax
+\`\`\`
+\u274C Invalid Mermaid syntax at line 5:
+
+4:   A --> B
+5:   B -- > C    \u2190 Missing space before >
+6:   C --> D
 
-**If sync fails**:
-1. Log error to console
-2. Show notification: "Sync failed for [name]"
-3. **Ask user**:
-   - Ignore this error?
-   - Retry sync?
-   - Let AI fix it?
-
-**AI Fix Option**:
-- Analyze error
-- Attempt to fix common issues:
-  - Malformed Mermaid syntax
-  - Invalid XML characters
-  - Encoding issues
-  - Missing nodes
-- Retry sync after fix
-- Report result
+Common issues:
+- Use --> for edges (not -- >)
+- Labels use |text| syntax
+- Nodes use [name] or {name}
+
+Validate at: https://mermaid.live
+\`\`\`
+
+### Invalid Draw.io XML
+\`\`\`
+\u274C Invalid Draw.io file: login-flow.drawio
+
+Issues:
+- Missing mxGraphModel tag
+- Corrupted XML at line 15
+
+Try:
+1. Open in Draw.io desktop app
+2. Save as new file
+3. Run sync again
+\`\`\`
+
+### Conversion Warnings
+\`\`\`
+\u26A0\uFE0F  Sync completed with warnings:
+
+- 3 nodes could not be converted (complex shapes)
+- 2 edges lost styling (curved lines)
+
+Review mermaid/login-flow.mmd to verify
+\`\`\`
 
 ## Example Session
 
+### Create New Diagram
 \`\`\`
-User: /drawio-interact create user-authentication
+User: /drawio-interact create user-auth
 
-AI: Creating diagram: user-authentication
+AI: Creating diagram: user-auth
 
-\u{1F4C4} Generated Mermaid Code:
+\u{1F4C4} Generated Mermaid code:
 graph TD
     User[User] -->|Login| Login[Login Page]
     Login -->|Success| Dashboard[Dashboard]
 
 \u2705 Files created:
-   - mermaid/user-authentication.mmd
-   - .aikit/assets/drawio/user-authentication.drawio
-
-\u{1F504} Starting background sync service...
-\u2705 Sync service running
+   - mermaid/user-auth.mmd
+   - .aikit/assets/drawio/user-auth.drawio
 
-\u{1F3A8} Opening Draw.io...
-\u{1F440} Monitoring Draw.io app (sync will stop when Draw.io closes)
+\u{1F3A8} Opening in Draw.io...
 
----
-
-[User edits in Draw.io, adds "Password Recovery", saves]
-
-\u{1F504} Background sync detected changes:
-   \u2022 Added nodes: Recovery, ResetEmail
-   \u2022 Modified connections: Login \u2192 Recovery
+\u{1F4A1} After editing, run: /drawio-interact sync-to-mmd user-auth
+\`\`\`
 
-\u2705 Updated: mermaid/user-authentication.mmd
+### Edit & Sync (Draw.io \u2192 Mermaid)
+\`\`\`
+[User edits in Draw.io, adds "Password Reset" node, saves]
 
-[Or user edits mermaid/user-authentication.mmd directly]
+User: /drawio-interact sync-to-mmd user-auth
 
-\u{1F504} Background sync detected changes:
-   \u2022 Modified Mermaid syntax
+AI: Syncing Draw.io \u2192 Mermaid...
 
-\u2705 Updated: .aikit/assets/drawio/user-authentication.drawio
+\u{1F4CA} Reading: .aikit/assets/drawio/user-auth.drawio
+\u{1F504} Converting...
+\u2705 Updated: mermaid/user-auth.mmd
 
----
+Changes:
+\u2022 4 nodes
+\u2022 3 edges
 
-[User closes Draw.io app]
+Preview:
+graph TD
+    User[User] -->|Login| Login[Login Page]
+    Login -->|Success| Dashboard[Dashboard]
+    Login -->|Forgot Password| Recovery[Password Reset]
+\`\`\`
 
-\u{1F3A8} Draw.io closed - stopping sync service
-\u2705 Sync service stopped
+### Edit & Sync (Mermaid \u2192 Draw.io)
 \`\`\`
+[User edits mermaid/user-auth.mmd directly]
 
-**Key Point**: Sync starts automatically when Draw.io opens, and stops automatically when Draw.io closes. No manual commands needed!
+User: /drawio-interact sync-to-drawio user-auth
 
-## Important Notes
+AI: Syncing Mermaid \u2192 Draw.io...
 
-- **Auto-sync lifecycle** - Sync starts when Draw.io opens, stops when it closes
-- **Zero manual intervention** - No need to run start/stop commands
-- **Draw.io app** opens automatically on "create"
-- **Both formats** stay in sync automatically while Draw.io is open
-- **Mermaid files** are in project root for version control
-- **Draw.io files** are in .aikit/assets (can be .gitignored)
-- **Manual commands** (start-sync/stop-sync) only needed for special cases
+\u{1F4DD} Reading: mermaid/user-auth.mmd
+\u{1F504} Converting...
+\u2705 Updated: .aikit/assets/drawio/user-auth.drawio
 
-## Auto-Open Commands
+Changes:
+\u2022 4 nodes
+\u2022 3 edges
 
-**IMPORTANT**: Always use absolute paths!
+Open in Draw.io? (y/n): y
+\u{1F3A8} Opening...
+\`\`\`
 
-**Example code**:
-\`\`\`javascript
-const platform = process.platform;
-const projectRoot = process.cwd();  // Get absolute project root
-const filePath = join(projectRoot, '.aikit/assets/drawio', name + '.drawio');
-
-if (platform === 'darwin') {
-  // macOS: Use double quotes for path with spaces
-  execSync('open -a "Draw.io" "' + filePath + '"');
-} else if (platform === 'linux') {
-  // Linux
-  execSync('xdg-open "' + filePath + '"');
-} else if (platform === 'win32') {
-  // Windows
-  execSync('start "" "' + filePath + '"', { shell: true });
-}
+### List Diagrams
 \`\`\`
+User: /drawio-interact list
 
-**Why absolute paths?**
-- Relative paths depend on current working directory
-- Claude/AI might execute from wrong directory
-- Absolute paths always work correctly
+AI: Diagrams in this project:
 
-**Fallback**: If Draw.io app not found, open https://app.diagrams.net/
+1. user-auth
+   Mermaid: mermaid/user-auth.mmd \u2713
+   Drawio: .aikit/assets/drawio/user-auth.drawio \u2713
 
-## Directory Setup
+2. order-flow
+   Mermaid: mermaid/order-flow.mmd \u2713
+   Drawio: [missing]
+   Run: /drawio-interact sync-to-drawio order-flow
+\`\`\`
 
-Ensure directories exist:
-\`\`\`bash
-mkdir -p mermaid
-mkdir -p .aikit/assets/drawio
-\`\`\``
+## Key Differences from Auto-Sync Version
+
+**Removed:**
+- \u274C Auto-sync background service
+- \u274C Lifecycle manager
+- \u274C File watchers
+- \u274C Automatic start/stop
+- \u274C .aikit/tools/drawio-sync directory
+
+**Added:**
+- \u2705 Manual sync commands (sync-to-mmd, sync-to-drawio)
+- \u2705 Explicit user control
+- \u2705 Deterministic conversions
+- \u2705 Clear error messages
+- \u2705 Custom path support
+
+**Benefits:**
+- Predictable behavior every time
+- No background processes
+- Clear visibility into what changed
+- Easier debugging
+- Works on all platforms consistently`
   }
 ];