specweave 0.28.36 → 0.28.45

package/plugins/specweave-jira/lib/enhanced-jira-sync.js

@@ -1,6 +1,6 @@
-import { EnhancedContentBuilder } from "../../../dist/src/core/sync/enhanced-content-builder.js";
-import { SpecIncrementMapper } from "../../../dist/src/core/sync/spec-increment-mapper.js";
-import { parseSpecContent } from "../../../dist/src/core/spec-content-sync.js";
+import { EnhancedContentBuilder } from "../../../src/core/sync/enhanced-content-builder.js";
+import { SpecIncrementMapper } from "../../../src/core/sync/spec-increment-mapper.js";
+import { parseSpecContent } from "../../../src/core/spec-content-sync.js";
 import * as path from "path";
 import * as fs from "fs/promises";
 async function syncSpecToJiraWithEnhancedContent(options) {

package/plugins/specweave-release/commands/specweave-release-npm.md

@@ -1,6 +1,6 @@
 ---
 name: specweave-release:npm
-description: Bump patch version, create git tag, and trigger npm publish via GitHub Actions. Automates the complete release workflow with pre-flight checks, version bumping, tag creation, and GitHub Actions triggering. Use --only flag for quick local release (bumps version, builds, publishes to npm directly - NO git push, NO pipeline). Add --push to --only for complete local release with git sync. Use --only --local for FASTEST local-only version bump (no npm publish, no git, just version increment for local testing).
+description: Bump patch version, create git tag, and trigger npm publish via GitHub Actions. Use --quick for instant release (auto-commits dirty changes, publishes to npmjs.org, pushes to git). Use --only for local publish without git push. Use --only --local for version bump only.
 ---
 
 # /specweave-release:npm - NPM Release Automation
@@ -12,8 +12,9 @@ You are the NPM Release Assistant. Your job is to automate the patch version rel
 | Command | Flow | Use Case |
 |---------|------|----------|
 | `/specweave-release:npm` | Bump → Push → **CI publishes** | Standard release (CI handles npm) |
+| `/specweave-release:npm --quick` | Auto-commit → Bump → Build → **Publish** → Push | **INSTANT RELEASE** (recommended!) |
 | `/specweave-release:npm --only` | Bump → Build → **Publish locally** → NO push | Quick local release, push later |
-| `/specweave-release:npm --only --push` | Bump → Build → **Publish locally** → Push | Complete local release + git sync |
+| `/specweave-release:npm --only --push` | Auto-commit → Bump → Build → **Publish** → Push | Same as --quick |
 | `/specweave-release:npm --only --local` | **Bump ONLY** → NO build, NO publish, NO git | FASTEST: Local testing only |
 
 ## Detecting Mode
@@ -21,25 +22,126 @@ You are the NPM Release Assistant. Your job is to automate the patch version rel
 Check flags in the command invocation:
 
 ```
+--quick        → INSTANT RELEASE: auto-commit dirty, publish to npmjs.org, push git
 --only --local → Version bump ONLY (no build, no publish, no git) - FASTEST
---only --push  → Direct publish + push to git after
---only         → Direct publish to npm (bypass CI)
+--only --push  → Same as --quick (legacy alias)
+--only         → Direct publish to npm (bypass CI), no git push
 (no flags)     → Default: push to git, CI publishes
 ```
 
 **Flag Detection Order:**
-1. Check for `--only` flag
-2. If `--only` present, check for `--local` flag → LOCAL MODE (fastest)
-3. If `--only` present, check for `--push` flag → DIRECT MODE + PUSH
-4. If `--only` only → DIRECT MODE
-5. No flags → DEFAULT MODE
-
+1. Check for `--quick` flag → QUICK MODE (instant release!)
+2. Check for `--only` flag
+3. If `--only` present, check for `--local` flag → LOCAL MODE (fastest)
+4. If `--only` present, check for `--push` flag → DIRECT MODE + PUSH (same as --quick)
+5. If `--only` only → DIRECT MODE
+6. No flags → DEFAULT MODE
+
+**If `--quick`**: Use QUICK MODE (section "Quick Mode Workflow") - INSTANT RELEASE!
 **If `--only --local`**: Use LOCAL MODE (section "Local Mode Workflow") - FASTEST!
 **If `--only --push`**: Use DIRECT MODE WITH PUSH (section "Direct Mode + Push Workflow")
 **If `--only` only**: Use DIRECT MODE (section "Direct Mode Workflow")
 **If no flags**: Use DEFAULT MODE (continue with steps below)
 
-## Your Task
+---
+
+## QUICK MODE WORKFLOW (--quick flag) - RECOMMENDED!
+
+Use this workflow when `--quick` flag is detected. This is the **instant release** mode - auto-commits any dirty changes, publishes directly to npmjs.org, and pushes to git. One command does everything!
+
+**Use case**: You made changes and want to release immediately. No manual steps needed.
+
+### 1. Pre-flight Check (Minimal)
+
+```bash
+# Verify we're on develop branch
+git rev-parse --abbrev-ref HEAD
+
+# Get current version
+node -p "require('./package.json').version"
+```
+
+**STOP if**: Not on `develop` branch (ask user to switch)
+
+**If uncommitted changes exist → AUTO-COMMIT (Step 2)**
+
+### 2. Auto-Commit Dirty Changes (if any)
+
+```bash
+# Check for uncommitted changes
+git status --porcelain
+```
+
+If dirty, generate smart commit message and commit:
+
+```bash
+git add -A
+git commit -m "[auto-generated message based on changed files]"
+```
+
+**Message generation rules:**
+- `src/**` changes → `fix: update implementation`
+- `plugins/**` changes → `feat(plugins): update plugin`
+- `.specweave/**` changes → `chore: update specweave config`
+- `*.md` changes → `docs: update documentation`
+- Mixed → `chore: update code and documentation`
+
+### 3. Bump Patch Version
+
+```bash
+npm version patch -m "chore: bump version to %s"
+```
+
+### 4. Build Package
+
+```bash
+npm run rebuild
+```
+
+### 5. Publish to NPM (with explicit registry!)
+
+```bash
+# CRITICAL: Always specify registry to avoid ~/.npmrc redirecting to private feeds!
+npm publish --registry https://registry.npmjs.org
+```
+
+### 6. Push to Git
+
+```bash
+git push origin develop --follow-tags
+```
+
+### 7. Report Results
+
+```markdown
+✅ **Instant release complete!**
+
+📦 **Version**: vX.Y.Z
+🔗 **NPM**: https://www.npmjs.com/package/specweave
+🏷️ **GitHub**: https://github.com/anton-abyzov/specweave/releases/tag/vX.Y.Z
+
+**What happened**:
+- ✅ Dirty changes auto-committed
+- ✅ Version bumped to X.Y.Z
+- ✅ Package built
+- ✅ Published to npmjs.org
+- ✅ Pushed to GitHub
+
+**Verify**: `npm view specweave version --registry https://registry.npmjs.org`
+```
+
+## Quick Mode Success Criteria
+
+✅ Any dirty changes auto-committed
+✅ Version bumped in package.json
+✅ Git commit and tag created
+✅ Package rebuilt
+✅ Published to npmjs.org (explicit registry!)
+✅ Pushed to GitHub
+
+---
+
+## DEFAULT MODE - Your Task
 
 Execute the following steps in order:
 
@@ -195,13 +297,14 @@ npm run rebuild
 ### 5. Publish to NPM Directly
 
 ```bash
-# Publish directly to npm (bypasses GitHub Actions)
-npm publish
+# Publish directly to npmjs.org (bypasses GitHub Actions)
+# CRITICAL: Always specify registry to avoid ~/.npmrc redirecting to private feeds!
+npm publish --registry https://registry.npmjs.org
 ```
 
 **What this does**:
 - Builds package tarball
-- Publishes to npm registry immediately
+- Publishes to **npmjs.org** registry immediately (ignores ~/.npmrc)
 - No GitHub Actions involvement
 
 ### 6. Report Results (Direct Mode)
@@ -333,8 +436,9 @@ npm run rebuild
 ### 5. Publish to NPM Directly
 
 ```bash
-# Publish directly to npm (bypasses GitHub Actions)
-npm publish
+# Publish directly to npmjs.org (bypasses GitHub Actions)
+# CRITICAL: Always specify registry to avoid ~/.npmrc redirecting to private feeds!
+npm publish --registry https://registry.npmjs.org
 ```
 
 ### 6. Push to Git (NEW!)
@@ -397,25 +501,29 @@ Show the user:
 ## Quick Reference
 
 ```bash
+# RECOMMENDED: Instant release (auto-commits dirty, publishes, pushes)
+/specweave-release:npm --quick
+
 # Standard release (CI handles npm publish)
 /specweave-release:npm
 
 # Quick local publish, sync git later
 /specweave-release:npm --only
 
-# Complete local release (publish + push)
+# Complete local release (publish + push) - same as --quick
 /specweave-release:npm --only --push
 
 # FASTEST: Version bump only (no publish, no git, no build)
 /specweave-release:npm --only --local
 ```
 
-| Scenario | Command | NPM Published By | Git Pushed |
-|----------|---------|------------------|------------|
-| Normal release | (no flags) | GitHub Actions | ✅ Yes |
-| Quick local, push later | `--only` | You (local) | ❌ No |
-| Complete local release | `--only --push` | You (local) | ✅ Yes |
-| **FASTEST local test** | `--only --local` | ❌ None | ❌ No |
+| Scenario | Command | Auto-Commit Dirty? | NPM Published By | Git Pushed |
+|----------|---------|-------------------|------------------|------------|
+| **INSTANT RELEASE** | `--quick` | ✅ Yes | You (npmjs.org) | ✅ Yes |
+| Normal release | (no flags) | ❌ STOP | GitHub Actions | ✅ Yes |
+| Quick local, push later | `--only` | ❌ STOP | You (npmjs.org) | ❌ No |
+| Complete local release | `--only --push` | ✅ Yes | You (npmjs.org) | ✅ Yes |
+| **FASTEST local test** | `--only --local` | N/A | ❌ None | ❌ No |
 
 ---
 
@@ -472,7 +580,7 @@ Show the user:
 2. Test: `npm test`
 3. Commit: `git add . && git commit -m "chore: bump version to X.Y.Z"`
 4. Tag: `git tag vX.Y.Z`
-5. Publish: `npm publish`
+5. Publish: `npm publish --registry https://registry.npmjs.org`
 6. Push: `git push origin develop --follow-tags`
 
 **Or use**: `/specweave-release:npm --only --push` for full release