claude-autopm 3.23.1 → 3.24.0

package/.github/workflows/deploy-docs.yml

@@ -35,7 +35,7 @@ jobs:
           cache-dependency-path: docs-site/package-lock.json
 
       - name: Setup Pages
-        uses: actions/configure-pages@v4
+        uses: actions/configure-pages@v6
 
       - name: Install dependencies
         run: npm ci
@@ -59,4 +59,4 @@ jobs:
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@v5

package/.github/workflows/npm-publish.yml

@@ -11,7 +11,7 @@ jobs:
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           node-version: '20'
       - run: npm ci --legacy-peer-deps
@@ -24,7 +24,7 @@ jobs:
       contents: read
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           node-version: '20'
           registry-url: 'https://registry.npmjs.org'

package/.github/workflows/plugin-publish.yml

@@ -34,7 +34,7 @@ jobs:
           - plugin-testing
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           node-version: '20'
           registry-url: 'https://registry.npmjs.org'
@@ -52,7 +52,7 @@ jobs:
       id-token: write
     steps:
       - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/setup-node@v6
         with:
           node-version: '20'
           registry-url: 'https://registry.npmjs.org'

package/README.md

@@ -27,6 +27,7 @@ Choose your scenario during installation:
 | **GitHub** | 12 | Core + languages for GitHub projects |
 | **Azure** | 14 | Core + languages + Azure DevOps |
 | **Docker** | 16 | Core + DevOps + containers |
+| **Obsidian** | 12 | PM + Obsidian vault integration |
 | **Full** | 44+ | All plugins, all agents |
 | **Performance** | 44+ | Full + max parallelization |
 
@@ -134,10 +135,11 @@ All commands run inside Claude Code (not terminal):
 
 ## Features
 
-### 13 Official Plugins
+### 14 Official Plugins
 
 - **Core** — Context management, testing, configuration, MCP
 - **PM System** — PRD, epics, issues, decomposition, git workflow
+- **Obsidian** — Read-only vault sync, Dataview frontmatter, diagnostics
 - **Azure DevOps** — Work items, boards, pipelines, sprints
 - **GitHub** — Workflows, issues, PRs, automation
 - **Languages** — Python, JavaScript, Node.js, Bash

package/autopm/.claude/docs/xml-prompts/README.md

@@ -435,7 +435,7 @@ Create templates tailored to your project:
   --stage 2
 
 # Edit template
-vim autopm/.claude/templates/xml-prompts/dev/microservice.xml
+vim .claude/templates/xml-prompts/dev/microservice.xml
 
 # Use custom template
 /prompt:xml microservice \
@@ -522,5 +522,5 @@ Solution: Provide missing flag
   - `.claude/commands/xml/prompt-xml.md`
   - `.claude/commands/xml/template.md`
 - **Utilities:**
-  - `autopm/.claude/lib/xml-prompt-builder.js`
-  - `autopm/.claude/lib/xml-validator.js`
+  - `.claude/lib/xml-prompt-builder.js`
+  - `.claude/lib/xml-validator.js`

package/autopm/.claude/docs/xml-prompts/creating-templates.md

@@ -111,7 +111,7 @@ This will prompt you for:
 
 ```bash
 # Create file in appropriate category
-vim autopm/.claude/templates/xml-prompts/dev/my-template.xml
+vim .claude/templates/xml-prompts/dev/my-template.xml
 ```
 
 ### Step 3: Define Template Content
@@ -558,7 +558,7 @@ cat test.xml | grep -q "<thinking>" && echo "✅ Has thinking" || echo "❌ Miss
 Track template changes:
 
 ```bash
-git add autopm/.claude/templates/xml-prompts/dev/my-template.xml
+git add .claude/templates/xml-prompts/dev/my-template.xml
 git commit -m "Update microservice template with health check requirements"
 ```
 

package/autopm/.claude/docs/xml-prompts/templates-guide.md

@@ -462,7 +462,7 @@ done
 /xml:template create microservice --category dev --stage 2
 
 # Edit to add project-specific constraints
-vim autopm/.claude/templates/xml-prompts/dev/microservice.xml
+vim .claude/templates/xml-prompts/dev/microservice.xml
 
 # Add your patterns:
 # - Service structure requirements

package/bin/autopm.js

@@ -208,6 +208,8 @@ function main() {
     .command(require('../lib/cli/commands/agent'))
     // Context management command (STANDALONE)
     .command(require('../lib/cli/commands/context'))
+    // Obsidian vault integration (STANDALONE)
+    .command(require('../lib/cli/commands/obsidian'))
     // Validation command
     .command('validate', 'Validate ClaudeAutoPM configuration and setup',
       (yargs) => {

package/install/install.js

@@ -127,6 +127,44 @@ class Installer {
     console.log(`${this.colors.RED}✗${this.colors.NC} ${msg}`);
   }
 
+  /**
+   * Print scenario-specific next steps after installation
+   */
+  printScenarioNextSteps() {
+    const scenario = this.currentScenario;
+    if (!scenario) return;
+
+    console.log(`${this.colors.CYAN}📋 Next Steps for "${scenario}" scenario:${this.colors.NC}`);
+    console.log('');
+
+    if (scenario === 'obsidian') {
+      console.log('   1. Configure your Obsidian vault:');
+      console.log(`      ${this.colors.BOLD}autopm obsidian setup --vault-path "<your-vault-path>"${this.colors.NC}`);
+      console.log('');
+      console.log(`      ${this.colors.DIM}Use quotes around the path. Examples per platform:${this.colors.NC}`);
+      console.log(`      ${this.colors.DIM}  WSL:   --vault-path "/mnt/c/Users/You/Documents/My Vault"${this.colors.NC}`);
+      console.log(`      ${this.colors.DIM}  macOS: --vault-path "/Users/you/Documents/My Vault"${this.colors.NC}`);
+      console.log(`      ${this.colors.DIM}  Linux: --vault-path "/home/you/Obsidian/My Vault"${this.colors.NC}`);
+      console.log('');
+      console.log('   2. Open the vault folder in Obsidian and install recommended plugins');
+      console.log(`      ${this.colors.DIM}(Dataview, Templater, Excalidraw, Mermaid Tools)${this.colors.NC}`);
+      console.log('');
+      console.log('   3. For continuous sync:');
+      console.log(`      ${this.colors.BOLD}autopm obsidian sync --watch${this.colors.NC}`);
+      console.log('');
+      console.log(`   ${this.colors.DIM}Verify setup:     autopm validate${this.colors.NC}`);
+      console.log(`   ${this.colors.DIM}Troubleshooting:  autopm obsidian doctor${this.colors.NC}`);
+      console.log('');
+    } else {
+      console.log('   1. Open your project in Claude Code:');
+      console.log(`      ${this.colors.BOLD}cd your-project && claude${this.colors.NC}`);
+      console.log('');
+      console.log('   2. Start working! Slash commands are available inside Claude Code.');
+      console.log(`      ${this.colors.DIM}Example: /pm:status, /pm:next, /pm:help${this.colors.NC}`);
+      console.log('');
+    }
+  }
+
   async confirm(prompt) {
     // In test mode or auto-accept mode, auto-answer yes
     if (process.env.AUTOPM_TEST_MODE === '1' || process.env.AUTOPM_AUTO_ACCEPT === '1') {
@@ -556,6 +594,15 @@ ${this.colors.BOLD}Select installation scenario:${this.colors.NC}
    • Advanced users only
 `);
 
+    // Option 7: Obsidian (always available)
+    console.log(`${this.colors.CYAN}7. Obsidian${this.colors.NC} - PM + Obsidian vault integration (rsync, Dataview, templates)
+   • Core + PM + Obsidian vault sync
+   • Unidirectional project → vault mirroring
+   • Best for: Knowledge management, documentation-heavy projects
+   • After install, run: ${this.colors.BOLD}autopm obsidian setup --vault-path "<path>"${this.colors.NC}
+   ${this.colors.DIM}• Plugins: core, pm, obsidian (3 plugins)${this.colors.NC}
+`);
+
     if (process.env.AUTOPM_TEST_MODE === '1') {
       this.printMsg('CYAN', 'Auto-selecting option 0 (lite) for test mode');
       return 'lite';
@@ -571,7 +618,7 @@ ${this.colors.BOLD}Select installation scenario:${this.colors.NC}
 
     return new Promise((resolve) => {
       const askQuestion = () => {
-        rl.question(`${this.colors.CYAN}Enter your choice (0-6) [${defaultChoice}]: ${this.colors.NC}`, (answer) => {
+        rl.question(`${this.colors.CYAN}Enter your choice (0-7) [${defaultChoice}]: ${this.colors.NC}`, (answer) => {
           const choice = answer.trim() || defaultChoice;
           const scenarios = {
             '0': 'lite',
@@ -580,7 +627,8 @@ ${this.colors.BOLD}Select installation scenario:${this.colors.NC}
             '3': 'docker',
             '4': 'full',
             '5': 'performance',
-            '6': 'custom'
+            '6': 'custom',
+            '7': 'obsidian'
           };
 
           const selectedScenario = scenarios[choice];
@@ -608,7 +656,7 @@ ${this.colors.BOLD}Select installation scenario:${this.colors.NC}
           }
 
           if (!selectedScenario) {
-            console.log(`${this.colors.RED}✗ Invalid choice. Please select 0-6.${this.colors.NC}`);
+            console.log(`${this.colors.RED}✗ Invalid choice. Please select 0-7.${this.colors.NC}`);
             askQuestion();
             return;
           }
@@ -703,6 +751,16 @@ ${this.colors.BOLD}Select installation scenario:${this.colors.NC}
           kubernetes: { enabled: true }
         },
         plugins: ['plugin-core', 'plugin-languages', 'plugin-frameworks', 'plugin-testing', 'plugin-devops', 'plugin-cloud', 'plugin-databases', 'plugin-data', 'plugin-pm', 'plugin-pm-github', 'plugin-ai', 'plugin-ml']
+      },
+      obsidian: {
+        version: version,
+        installed: new Date().toISOString(),
+        execution_strategy: 'sequential',
+        tools: {
+          docker: { enabled: false },
+          kubernetes: { enabled: false }
+        },
+        plugins: ['plugin-core', 'plugin-pm', 'plugin-obsidian']
       }
     };
 
@@ -1506,6 +1564,9 @@ See: https://github.com/rafeekpro/ClaudeAutoPM
     this.printMsg('GREEN', '╚══════════════════════════════════════════╝');
     console.log('');
 
+    // Scenario-specific next steps
+    this.printScenarioNextSteps();
+
     // Run post-installation configuration check
     await this.runPostInstallCheck();
 

package/install/post-install-check.js

@@ -37,6 +37,7 @@ class PostInstallChecker {
     this.checkMCPConfiguration();
     this.checkGitHooks();
     this.checkNodeVersion();
+    this.checkObsidianVault();
 
     // Display results
     this.displayResults();
@@ -336,6 +337,34 @@ class PostInstallChecker {
     }
   }
 
+  /**
+   * Check Obsidian vault configuration
+   */
+  checkObsidianVault() {
+    const configPath = path.join(this.projectRoot, '.claude', 'config.json');
+    let configured = false;
+    let message = 'Not configured — run: autopm obsidian setup --vault-path "<path>"';
+
+    if (fs.existsSync(configPath)) {
+      try {
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        const vaultPath = config.obsidian?.vault_path;
+        if (vaultPath) {
+          configured = true;
+          message = `Vault: ${vaultPath}`;
+        }
+      } catch (error) {
+        // config unreadable, leave as not configured
+      }
+    }
+
+    this.results.optional.push({
+      name: 'Obsidian vault',
+      status: configured,
+      message: message
+    });
+  }
+
   /**
    * Display check results
    */

package/lib/cli/commands/obsidian.js

@@ -0,0 +1,209 @@
+/**
+ * CLI Obsidian Commands
+ * Manage Obsidian vault integration — setup, sync, diagnostics
+ */
+
+const { spawn } = require('child_process');
+const path = require('path');
+const fs = require('fs');
+
+const PLUGIN_DIR = 'packages/plugin-obsidian';
+const SCRIPTS_DIR = path.join(PLUGIN_DIR, 'scripts', 'obsidian');
+
+/**
+ * Find project root by walking up from cwd
+ */
+function findProjectRoot() {
+  let dir = process.cwd();
+  while (dir !== path.dirname(dir)) {
+    if (fs.existsSync(path.join(dir, '.claude', 'config.json')) ||
+        fs.existsSync(path.join(dir, 'CLAUDE.md'))) {
+      return dir;
+    }
+    dir = path.dirname(dir);
+  }
+  return process.cwd();
+}
+
+/**
+ * Check if plugin-obsidian is installed
+ */
+function checkPlugin(root) {
+  const pluginJson = path.join(root, PLUGIN_DIR, 'plugin.json');
+  if (!fs.existsSync(pluginJson)) {
+    console.error('❌ plugin-obsidian not installed.');
+    console.error('   Run: autopm install --scenario=obsidian');
+    process.exit(1);
+  }
+}
+
+/**
+ * autopm obsidian setup
+ */
+async function obsidianSetup(argv) {
+  const root = findProjectRoot();
+  checkPlugin(root);
+
+  const scriptPath = path.join(root, SCRIPTS_DIR, 'setup.js');
+  if (!fs.existsSync(scriptPath)) {
+    console.error('❌ Setup script not found:', scriptPath);
+    process.exit(1);
+  }
+
+  const args = [];
+  if (argv.vaultPath) args.push('--vault-path', argv.vaultPath);
+  if (argv.prefix) args.push('--prefix', argv.prefix);
+  if (argv.watch === true) args.push('--watch');
+  if (argv.watch === false) args.push('--no-watch');
+  args.push('--project-root', root);
+
+  const child = spawn('node', [scriptPath, ...args], {
+    stdio: 'inherit',
+    cwd: root
+  });
+
+  child.on('close', (code) => process.exit(code || 0));
+}
+
+/**
+ * autopm obsidian sync
+ */
+async function obsidianSync(argv) {
+  const root = findProjectRoot();
+  checkPlugin(root);
+
+  // Prefer shell script, fall back to Node
+  const shPath = path.join(root, SCRIPTS_DIR, 'sync-to-obsidian.sh');
+  const jsPath = path.join(root, SCRIPTS_DIR, 'sync-to-obsidian.js');
+
+  const args = [];
+  if (argv.watch) args.push('--watch');
+  if (argv.check) args.push('--check');
+  if (argv.safeMode) args.push('--safe-mode');
+  args.push('--project-root', root);
+
+  let cmd, cmdArgs;
+  if (fs.existsSync(shPath)) {
+    cmd = 'bash';
+    cmdArgs = [shPath, ...args];
+  } else if (fs.existsSync(jsPath)) {
+    cmd = 'node';
+    cmdArgs = [jsPath, ...args];
+  } else {
+    console.error('❌ Sync script not found. Reinstall plugin-obsidian.');
+    process.exit(1);
+  }
+
+  const child = spawn(cmd, cmdArgs, {
+    stdio: 'inherit',
+    cwd: root
+  });
+
+  child.on('close', (code) => process.exit(code || 0));
+}
+
+/**
+ * autopm obsidian doctor
+ */
+async function obsidianDoctor(argv) {
+  const root = findProjectRoot();
+  checkPlugin(root);
+
+  const scriptPath = path.join(root, SCRIPTS_DIR, 'doctor.js');
+  if (!fs.existsSync(scriptPath)) {
+    console.error('❌ Doctor script not found:', scriptPath);
+    process.exit(1);
+  }
+
+  const args = ['--project-root', root];
+
+  const child = spawn('node', [scriptPath, ...args], {
+    stdio: 'inherit',
+    cwd: root
+  });
+
+  child.on('close', (code) => process.exit(code || 0));
+}
+
+/**
+ * Command builder — registers subcommands
+ */
+function builder(yargs) {
+  return yargs
+    .command(
+      'setup',
+      'Configure Obsidian vault integration',
+      (yargs) => {
+        return yargs
+          .option('vault-path', {
+            describe: 'Path to your Obsidian vault folder (use quotes if path has spaces)',
+            type: 'string',
+            demandOption: true
+          })
+          .option('prefix', {
+            describe: 'Subfolder name in vault (default: project directory name)',
+            type: 'string'
+          })
+          .option('watch', {
+            describe: 'Enable continuous sync after setup',
+            type: 'boolean'
+          })
+          .example('autopm obsidian setup --vault-path "/mnt/c/Users/You/My Vault"', 'WSL')
+          .example('autopm obsidian setup --vault-path "/Users/you/My Vault"', 'macOS')
+          .example('autopm obsidian setup --vault-path "/home/you/My Vault" --prefix my-project', 'Linux with prefix');
+      },
+      obsidianSetup
+    )
+    .command(
+      'sync',
+      'Sync project files to Obsidian vault',
+      (yargs) => {
+        return yargs
+          .option('watch', {
+            describe: 'Continuous sync on file changes',
+            type: 'boolean',
+            default: false
+          })
+          .option('check', {
+            describe: 'Dry-run: show what would be synced',
+            type: 'boolean',
+            default: false
+          })
+          .option('safe-mode', {
+            describe: 'Never delete vault files (omit --delete from rsync)',
+            type: 'boolean',
+            default: false
+          })
+          .example('autopm obsidian sync', 'One-shot sync')
+          .example('autopm obsidian sync --watch', 'Continuous sync')
+          .example('autopm obsidian sync --check', 'Dry-run');
+      },
+      obsidianSync
+    )
+    .command(
+      'doctor',
+      'Diagnose common Obsidian integration issues',
+      (yargs) => {
+        return yargs
+          .example('autopm obsidian doctor', 'Run all diagnostic checks');
+      },
+      obsidianDoctor
+    )
+    .demandCommand(1, 'You must specify an obsidian command')
+    .strictCommands()
+    .help();
+}
+
+module.exports = {
+  command: 'obsidian',
+  describe: 'Manage Obsidian vault integration (setup, sync, diagnostics)',
+  builder,
+  handler: (argv) => {
+    console.log('\nUsage: autopm obsidian <command>\n');
+    console.log('Commands:');
+    console.log('  setup    Configure Obsidian vault integration');
+    console.log('  sync     Sync project files to Obsidian vault');
+    console.log('  doctor   Diagnose common integration issues');
+    console.log('\nRun autopm obsidian <command> --help for details\n');
+  }
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-autopm",
-  "version": "3.23.1",
+  "version": "3.24.0",
   "description": "Autonomous Project Management Framework for Claude Code - Advanced AI-powered development automation",
   "main": "bin/autopm.js",
   "workspaces": [
@@ -125,7 +125,7 @@
     "README.md"
   ],
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.67.0",
+    "@anthropic-ai/sdk": "^0.82.0",
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@octokit/rest": "^22.0.0",
     "azure-devops-node-api": "^15.1.1",
@@ -135,10 +135,10 @@
     "fast-glob": "^3.3.2",
     "fs-extra": "^11.3.2",
     "glob": "^11.0.3",
-    "inquirer": "^12.9.6",
+    "inquirer": "^13.3.2",
     "js-yaml": "^4.1.0",
     "markdown-it": "^14.1.0",
-    "marked": "^16.4.0",
+    "marked": "^17.0.6",
     "moment": "^2.29.4",
     "ora": "~5.4.1",
     "simple-git": "^3.20.0",
@@ -151,7 +151,7 @@
     "@jest/globals": "^30.1.2",
     "@types/jest": "^30.0.0",
     "axios": "^1.12.2",
-    "c8": "^10.1.3",
+    "c8": "^11.0.0",
     "chai": "^6.0.1",
     "jest": "^30.1.3",
     "jest-diff": "^30.1.2",
@@ -166,7 +166,7 @@
     "sinon": "^21.0.0"
   },
   "optionalDependencies": {
-    "@playwright/mcp": "^0.0.68",
+    "@playwright/mcp": "^0.0.70",
     "@upstash/context7-mcp": "^2.1.6"
   },
   "publishConfig": {

package/packages/plugin-obsidian/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Rafal Lagowski
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.