specweave 1.0.319 → 1.0.320

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specweave",
-  "version": "1.0.319",
+  "version": "1.0.320",
   "description": "Spec-driven development framework for AI coding agents. Works with Claude Code, Codex, Antigravity, Cursor, Copilot & more. 100+ skills, 49 CLI commands, verified skill certification, autonomous execution, and living documentation.",
   "type": "module",
   "main": "dist/index.js",

package/plugins/specweave/hooks/v2/handlers/universal-auto-create-dispatcher.sh

@@ -134,19 +134,31 @@ log "Creating external items for $INC_ID (github=$GH_ENABLED jira=$JIRA_ENABLED
 # ============================================================================
 
 if [[ "$GH_ENABLED" == "true" ]]; then
-  GITHUB_HANDLER="${PROJECT_ROOT}/plugins/specweave-github/hooks/github-auto-create-handler.sh"
-  # Fallback: handler may be in a sibling plugin directory (umbrella repo layout)
-  if [[ ! -f "$GITHUB_HANDLER" ]]; then
-    SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
-    FALLBACK_DIR="$(cd "$SCRIPT_DIR/../../../specweave-github/hooks" 2>/dev/null && pwd)"
-    [[ -n "$FALLBACK_DIR" ]] && GITHUB_HANDLER="$FALLBACK_DIR/github-auto-create-handler.sh"
+  # Derive specweave package root from script location (works for both dev and npm)
+  # Script is at: plugins/specweave/hooks/v2/handlers/ → 5 levels up = package root
+  SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+  PKG_ROOT="$(cd "$SCRIPT_DIR/../../../../.." 2>/dev/null && pwd)"
+
+  GITHUB_HANDLER=""
+  # 1. Sibling plugin dir (works for both npm and dev: plugins/specweave-github/hooks/)
+  CANDIDATE="$SCRIPT_DIR/../../../../specweave-github/hooks/github-auto-create-handler.sh"
+  [[ -f "$CANDIDATE" ]] && GITHUB_HANDLER="$CANDIDATE"
+  # 2. Fallback: PROJECT_ROOT/plugins/ (dev-only, when running from source repo)
+  if [[ -z "$GITHUB_HANDLER" ]]; then
+    CANDIDATE="${PROJECT_ROOT}/plugins/specweave-github/hooks/github-auto-create-handler.sh"
+    [[ -f "$CANDIDATE" ]] && GITHUB_HANDLER="$CANDIDATE"
   fi
-  if [[ -f "$GITHUB_HANDLER" ]]; then
-    log "Delegating GitHub auto-create to existing handler"
+  # 3. Fallback: node_modules/specweave/ (direct npm install)
+  if [[ -z "$GITHUB_HANDLER" ]]; then
+    CANDIDATE="${PROJECT_ROOT}/node_modules/specweave/plugins/specweave-github/hooks/github-auto-create-handler.sh"
+    [[ -f "$CANDIDATE" ]] && GITHUB_HANDLER="$CANDIDATE"
+  fi
+  if [[ -n "$GITHUB_HANDLER" && -f "$GITHUB_HANDLER" ]]; then
+    log "Delegating GitHub auto-create to handler at $GITHUB_HANDLER"
     bash "$GITHUB_HANDLER" "$INC_ID" &
     GH_PID=$!
   else
-    log "GitHub handler not found at any known path"
+    log "GitHub handler not found at any known path (checked sibling, PROJECT_ROOT, node_modules)"
   fi
 fi
 
@@ -157,9 +169,36 @@ fi
 if [[ "$JIRA_ENABLED" == "true" || "$ADO_ENABLED" == "true" ]]; then
   command -v node &>/dev/null || { log "Node.js not found. Skipping JIRA/ADO."; exit 0; }
 
-  CREATE_MODULE="$PROJECT_ROOT/dist/src/core/universal-auto-create.js"
-  if [[ ! -f "$CREATE_MODULE" ]]; then
-    log "Module not found at $CREATE_MODULE. Skipping JIRA/ADO."
+  # Resolve universal-auto-create.js from multiple locations
+  CREATE_MODULE=""
+  # 0. SPECWEAVE_PKG (set by Claude Code hook infrastructure, most reliable)
+  if [[ -n "${SPECWEAVE_PKG:-}" ]]; then
+    CANDIDATE="${SPECWEAVE_PKG}/dist/src/core/universal-auto-create.js"
+    [[ -f "$CANDIDATE" ]] && CREATE_MODULE="$CANDIDATE"
+  fi
+  # 1. Package dist/ (derived from script location — works for both npm and dev)
+  if [[ -z "$CREATE_MODULE" ]]; then
+    CANDIDATE="${PKG_ROOT:-$PROJECT_ROOT}/dist/src/core/universal-auto-create.js"
+    [[ -f "$CANDIDATE" ]] && CREATE_MODULE="$CANDIDATE"
+  fi
+  # 2. Vendor directory (self-contained plugin)
+  if [[ -z "$CREATE_MODULE" ]]; then
+    CANDIDATE="$HANDLER_DIR/../../lib/vendor/core/universal-auto-create.js"
+    [[ -f "$CANDIDATE" ]] && CREATE_MODULE="$(cd "$(dirname "$CANDIDATE")" && pwd)/$(basename "$CANDIDATE")"
+  fi
+  # 3. node_modules/specweave/ (direct npm install)
+  if [[ -z "$CREATE_MODULE" ]]; then
+    CANDIDATE="${PROJECT_ROOT}/node_modules/specweave/dist/src/core/universal-auto-create.js"
+    [[ -f "$CANDIDATE" ]] && CREATE_MODULE="$CANDIDATE"
+  fi
+  # 4. Legacy: PROJECT_ROOT/dist/ (dev-only, running from source repo)
+  if [[ -z "$CREATE_MODULE" ]]; then
+    CANDIDATE="${PROJECT_ROOT}/dist/src/core/universal-auto-create.js"
+    [[ -f "$CANDIDATE" ]] && CREATE_MODULE="$CANDIDATE"
+  fi
+
+  if [[ -z "$CREATE_MODULE" ]]; then
+    log "Module not found at any known path. Skipping JIRA/ADO. Checked: PKG_ROOT=${PKG_ROOT:-unset}, node_modules, vendor, PROJECT_ROOT"
   else
     # Build config JSON for the TypeScript module
     JIRA_DOMAIN=$(jq -r '.sync.jira.domain // .issueTracker.domain // ""' "$CONFIG_PATH" 2>/dev/null)

package/plugins/specweave/lib/vendor/core/universal-auto-create.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Universal Auto-Create for External Tools
+ *
+ * Creates per-user-story items in ALL enabled providers (JIRA, ADO).
+ * GitHub is handled separately by the existing github-auto-create-handler.sh.
+ *
+ * Called by universal-auto-create-dispatcher.sh when spec.md is written.
+ *
+ * @module universal-auto-create
+ */
+export interface UniversalAutoCreateConfig {
+    sync: {
+        jira?: {
+            enabled?: boolean;
+        };
+        ado?: {
+            enabled?: boolean;
+        };
+    };
+    jira?: {
+        domain?: string;
+        projectKey?: string;
+    };
+    ado?: {
+        organization?: string;
+        project?: string;
+    };
+}
+export interface UserStoryInfo {
+    id: string;
+    title: string;
+}
+export interface ProviderCreateResult {
+    created: Array<{
+        usId: string;
+        ref: string;
+        url: string;
+    }>;
+    skipped: Array<{
+        usId: string;
+        reason: string;
+    }>;
+    errors: Array<{
+        usId: string;
+        error: string;
+    }>;
+}
+export type UniversalAutoCreateResult = {
+    jira?: ProviderCreateResult;
+    ado?: ProviderCreateResult;
+};
+/**
+ * Parse user stories (ID + title) from spec.md content.
+ * Matches patterns like "### US-001: User story title"
+ */
+export declare function parseUserStories(content: string): UserStoryInfo[];
+/**
+ * Create per-user-story items in JIRA and/or ADO for an increment.
+ *
+ * GitHub is NOT handled here (delegated to existing bash handler).
+ * This function is called by the universal-auto-create-dispatcher.sh.
+ */
+export declare function createExternalIssuesForIncrement(incrementId: string, specPath: string, metadataPath: string, config: UniversalAutoCreateConfig): Promise<UniversalAutoCreateResult>;
+//# sourceMappingURL=universal-auto-create.d.ts.map

package/plugins/specweave/lib/vendor/core/universal-auto-create.js

@@ -0,0 +1,228 @@
+/**
+ * Universal Auto-Create for External Tools
+ *
+ * Creates per-user-story items in ALL enabled providers (JIRA, ADO).
+ * GitHub is handled separately by the existing github-auto-create-handler.sh.
+ *
+ * Called by universal-auto-create-dispatcher.sh when spec.md is written.
+ *
+ * @module universal-auto-create
+ */
+import { readFile, writeFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import { deriveFeatureId } from '../utils/feature-id-derivation.js';
+// ============================================================================
+// Helpers
+// ============================================================================
+function emptyResult() {
+    return { created: [], skipped: [], errors: [] };
+}
+/**
+ * Parse user stories (ID + title) from spec.md content.
+ * Matches patterns like "### US-001: User story title"
+ */
+export function parseUserStories(content) {
+    const stories = [];
+    const pattern = /###\s+(US-\d+):\s*(.+)/g;
+    let match;
+    while ((match = pattern.exec(content)) !== null) {
+        stories.push({ id: match[1], title: match[2].trim() });
+    }
+    return stories;
+}
+// ============================================================================
+// Provider Functions
+// ============================================================================
+async function createJiraUserStories(incrementId, featureId, userStories, existingLinks, config) {
+    const result = emptyResult();
+    const { JiraClient } = await import('../integrations/jira/jira-client.js');
+    const domain = config.jira?.domain || '';
+    const projectKey = config.jira?.projectKey || '';
+    if (!domain || !projectKey) {
+        result.errors.push({ usId: 'config', error: 'JIRA domain or projectKey not configured' });
+        return result;
+    }
+    const client = new JiraClient();
+    for (const us of userStories) {
+        // Idempotency: skip if already linked
+        if (existingLinks[us.id]) {
+            result.skipped.push({ usId: us.id, reason: 'already-linked' });
+            continue;
+        }
+        try {
+            const summary = `[${featureId}][${us.id}] ${us.title}`;
+            const issue = await client.createIssue({
+                issueType: 'Story',
+                summary,
+                labels: ['specweave', 'auto-created'],
+            }, projectKey);
+            const issueUrl = `https://${domain}/browse/${issue.key}`;
+            result.created.push({ usId: us.id, ref: issue.key, url: issueUrl });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            result.errors.push({ usId: us.id, error: msg });
+        }
+    }
+    return result;
+}
+async function createAdoUserStories(incrementId, featureId, userStories, existingLinks, config) {
+    const result = emptyResult();
+    const { AdoClient } = await import('../integrations/ado/ado-client.js');
+    const { getAdoPat } = await import('../integrations/ado/ado-pat-provider.js');
+    const organization = config.ado?.organization || '';
+    const project = config.ado?.project || '';
+    if (!organization || !project) {
+        result.errors.push({ usId: 'config', error: 'ADO organization or project not configured' });
+        return result;
+    }
+    const pat = getAdoPat(organization);
+    if (!pat) {
+        result.errors.push({ usId: 'config', error: 'AZURE_DEVOPS_PAT not set' });
+        return result;
+    }
+    const client = new AdoClient({ pat, organization, project });
+    for (const us of userStories) {
+        // Idempotency: skip if already linked
+        if (existingLinks[us.id]) {
+            result.skipped.push({ usId: us.id, reason: 'already-linked' });
+            continue;
+        }
+        try {
+            const title = `[${featureId}][${us.id}] ${us.title}`;
+            const workItem = await client.createWorkItem({
+                workItemType: 'User Story',
+                title,
+                tags: ['specweave', 'auto-created'],
+            });
+            result.created.push({
+                usId: us.id,
+                ref: String(workItem.id),
+                url: workItem.url,
+            });
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            result.errors.push({ usId: us.id, error: msg });
+        }
+    }
+    return result;
+}
+// ============================================================================
+// Metadata Update
+// ============================================================================
+async function updateMetadata(metadataPath, results) {
+    if (!existsSync(metadataPath))
+        return;
+    const raw = await readFile(metadataPath, 'utf-8');
+    const metadata = JSON.parse(raw);
+    if (!metadata.externalLinks) {
+        metadata.externalLinks = {};
+    }
+    const now = new Date().toISOString();
+    // Update JIRA links
+    if (results.jira && results.jira.created.length > 0) {
+        if (!metadata.externalLinks.jira) {
+            metadata.externalLinks.jira = { userStories: {} };
+        }
+        if (!metadata.externalLinks.jira.userStories) {
+            metadata.externalLinks.jira.userStories = {};
+        }
+        for (const item of results.jira.created) {
+            metadata.externalLinks.jira.userStories[item.usId] = {
+                issueKey: item.ref,
+                issueUrl: item.url,
+                syncedAt: now,
+            };
+        }
+    }
+    // Update ADO links
+    if (results.ado && results.ado.created.length > 0) {
+        if (!metadata.externalLinks.ado) {
+            metadata.externalLinks.ado = { userStories: {} };
+        }
+        if (!metadata.externalLinks.ado.userStories) {
+            metadata.externalLinks.ado.userStories = {};
+        }
+        for (const item of results.ado.created) {
+            metadata.externalLinks.ado.userStories[item.usId] = {
+                workItemId: parseInt(item.ref, 10),
+                workItemUrl: item.url,
+                syncedAt: now,
+            };
+        }
+    }
+    await writeFile(metadataPath, JSON.stringify(metadata, null, 2) + '\n', 'utf-8');
+}
+// ============================================================================
+// Main Entry Point
+// ============================================================================
+/**
+ * Create per-user-story items in JIRA and/or ADO for an increment.
+ *
+ * GitHub is NOT handled here (delegated to existing bash handler).
+ * This function is called by the universal-auto-create-dispatcher.sh.
+ */
+export async function createExternalIssuesForIncrement(incrementId, specPath, metadataPath, config) {
+    const result = {};
+    // Parse user stories from spec.md
+    const content = await readFile(specPath, 'utf-8');
+    const userStories = parseUserStories(content);
+    if (userStories.length === 0) {
+        return result;
+    }
+    // Derive feature ID
+    let featureId;
+    try {
+        featureId = deriveFeatureId(incrementId);
+    }
+    catch {
+        const numMatch = incrementId.match(/^(\d+)/);
+        featureId = numMatch ? `FS-${parseInt(numMatch[1], 10)}` : `FS-${incrementId.substring(0, 3)}`;
+    }
+    // Load existing external links from metadata (for idempotency)
+    let existingJiraLinks = {};
+    let existingAdoLinks = {};
+    if (existsSync(metadataPath)) {
+        try {
+            const metaRaw = await readFile(metadataPath, 'utf-8');
+            const metadata = JSON.parse(metaRaw);
+            existingJiraLinks = metadata.externalLinks?.jira?.userStories || {};
+            existingAdoLinks = metadata.externalLinks?.ado?.userStories || {};
+        }
+        catch {
+            // Metadata parse error — proceed without existing links
+        }
+    }
+    // Create in each enabled provider (isolated errors)
+    if (config.sync?.jira?.enabled) {
+        try {
+            result.jira = await createJiraUserStories(incrementId, featureId, userStories, existingJiraLinks, config);
+        }
+        catch (err) {
+            const providerResult = emptyResult();
+            providerResult.errors.push({
+                usId: 'unknown',
+                error: err instanceof Error ? err.message : String(err),
+            });
+            result.jira = providerResult;
+        }
+    }
+    if (config.sync?.ado?.enabled) {
+        try {
+            result.ado = await createAdoUserStories(incrementId, featureId, userStories, existingAdoLinks, config);
+        }
+        catch (err) {
+            const providerResult = emptyResult();
+            providerResult.errors.push({
+                usId: 'unknown',
+                error: err instanceof Error ? err.message : String(err),
+            });
+            result.ado = providerResult;
+        }
+    }
+    // Update metadata with new links
+    await updateMetadata(metadataPath, result);
+    return result;
+}
+//# sourceMappingURL=universal-auto-create.js.map

package/plugins/specweave/lib/vendor/core/universal-auto-create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"universal-auto-create.js","sourceRoot":"","sources":["../../../src/core/universal-auto-create.ts"],"names":[],"mappings":"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"}

package/plugins/specweave/lib/vendor/utils/feature-id-derivation.d.ts

@@ -0,0 +1,63 @@
+/**
+ * Feature ID Derivation Utility
+ *
+ * Derives feature ID from increment ID using the 1:1 mapping principle:
+ * - Each increment maps to exactly one feature folder
+ * - Feature ID = FS-{increment_number} or FS-{increment_number}E for external
+ *
+ * @example
+ * deriveFeatureId('0081-ado-repo-cloning') → 'FS-081'
+ * deriveFeatureId('0100-some-feature') → 'FS-100'
+ * deriveFeatureId('1000-future-feature') → 'FS-1000'
+ * deriveFeatureId('0111E-external-issue') → 'FS-111E'
+ *
+ * @see ADR-0140 for the decision rationale
+ */
+/**
+ * Derive feature ID from increment ID
+ *
+ * The feature ID is derived directly from the increment number:
+ * - Extract leading digits from increment ID
+ * - Format as FS-XXX (minimum 3 digits, more if needed)
+ * - Add 'E' suffix for external increments (e.g., 0111E-...)
+ *
+ * This eliminates the need to store feature_id in metadata.json,
+ * as it's 100% derivable from the increment ID.
+ *
+ * CRITICAL: External increments (with E suffix like 0111E-...)
+ * MUST map to external features (FS-111E), not internal ones (FS-111).
+ *
+ * @param incrementId - Increment ID (e.g., "0081-ado-repo-cloning" or "0111E-external-issue")
+ * @returns Feature ID (e.g., "FS-081" or "FS-111E")
+ * @throws Error if increment ID format is invalid
+ */
+export declare function deriveFeatureId(incrementId: string): string;
+/**
+ * Extract increment number from increment ID
+ *
+ * @param incrementId - Increment ID (e.g., "0081-ado-repo-cloning")
+ * @returns Increment number (e.g., 81)
+ * @throws Error if increment ID format is invalid
+ */
+export declare function extractIncrementNumber(incrementId: string): number;
+/**
+ * Validate feature ID format
+ *
+ * Valid formats:
+ * - FS-XXX (internal, 3+ digits)
+ * - FS-XXXE (external, 3+ digits with E suffix)
+ *
+ * @param featureId - Feature ID to validate
+ * @returns true if valid, false otherwise
+ */
+export declare function isValidFeatureId(featureId: string): boolean;
+/**
+ * Check if feature ID is external (imported)
+ *
+ * External features have an 'E' suffix: FS-042E
+ *
+ * @param featureId - Feature ID to check
+ * @returns true if external, false if internal
+ */
+export declare function isExternalFeatureId(featureId: string): boolean;
+//# sourceMappingURL=feature-id-derivation.d.ts.map

package/plugins/specweave/lib/vendor/utils/feature-id-derivation.js

@@ -0,0 +1,85 @@
+/**
+ * Feature ID Derivation Utility
+ *
+ * Derives feature ID from increment ID using the 1:1 mapping principle:
+ * - Each increment maps to exactly one feature folder
+ * - Feature ID = FS-{increment_number} or FS-{increment_number}E for external
+ *
+ * @example
+ * deriveFeatureId('0081-ado-repo-cloning') → 'FS-081'
+ * deriveFeatureId('0100-some-feature') → 'FS-100'
+ * deriveFeatureId('1000-future-feature') → 'FS-1000'
+ * deriveFeatureId('0111E-external-issue') → 'FS-111E'
+ *
+ * @see ADR-0140 for the decision rationale
+ */
+/**
+ * Derive feature ID from increment ID
+ *
+ * The feature ID is derived directly from the increment number:
+ * - Extract leading digits from increment ID
+ * - Format as FS-XXX (minimum 3 digits, more if needed)
+ * - Add 'E' suffix for external increments (e.g., 0111E-...)
+ *
+ * This eliminates the need to store feature_id in metadata.json,
+ * as it's 100% derivable from the increment ID.
+ *
+ * CRITICAL: External increments (with E suffix like 0111E-...)
+ * MUST map to external features (FS-111E), not internal ones (FS-111).
+ *
+ * @param incrementId - Increment ID (e.g., "0081-ado-repo-cloning" or "0111E-external-issue")
+ * @returns Feature ID (e.g., "FS-081" or "FS-111E")
+ * @throws Error if increment ID format is invalid
+ */
+export function deriveFeatureId(incrementId) {
+    // Match number prefix and optional E suffix
+    const match = incrementId.match(/^(\d+)(E)?/);
+    if (!match) {
+        throw new Error(`Invalid increment ID format: ${incrementId}. Expected format: NNNN-name or NNNNE-name`);
+    }
+    const num = parseInt(match[1], 10);
+    const isExternal = match[2] === 'E';
+    // padStart(3, '0') ensures minimum 3 digits (FS-001 to FS-999)
+    // Numbers 1000+ naturally have 4+ digits (FS-1000, FS-1001, etc.)
+    const featureId = `FS-${String(num).padStart(3, '0')}`;
+    return isExternal ? `${featureId}E` : featureId;
+}
+/**
+ * Extract increment number from increment ID
+ *
+ * @param incrementId - Increment ID (e.g., "0081-ado-repo-cloning")
+ * @returns Increment number (e.g., 81)
+ * @throws Error if increment ID format is invalid
+ */
+export function extractIncrementNumber(incrementId) {
+    const match = incrementId.match(/^(\d+)/);
+    if (!match) {
+        throw new Error(`Invalid increment ID format: ${incrementId}. Expected format: NNNN-name`);
+    }
+    return parseInt(match[1], 10);
+}
+/**
+ * Validate feature ID format
+ *
+ * Valid formats:
+ * - FS-XXX (internal, 3+ digits)
+ * - FS-XXXE (external, 3+ digits with E suffix)
+ *
+ * @param featureId - Feature ID to validate
+ * @returns true if valid, false otherwise
+ */
+export function isValidFeatureId(featureId) {
+    return /^FS-\d{3,}E?$/.test(featureId);
+}
+/**
+ * Check if feature ID is external (imported)
+ *
+ * External features have an 'E' suffix: FS-042E
+ *
+ * @param featureId - Feature ID to check
+ * @returns true if external, false if internal
+ */
+export function isExternalFeatureId(featureId) {
+    return featureId.endsWith('E');
+}
+//# sourceMappingURL=feature-id-derivation.js.map

package/plugins/specweave/lib/vendor/utils/feature-id-derivation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-id-derivation.js","sourceRoot":"","sources":["../../../src/utils/feature-id-derivation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,eAAe,CAAC,WAAmB;IACjD,4CAA4C;IAC5C,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,gCAAgC,WAAW,4CAA4C,CAAC,CAAC;IAC3G,CAAC;IAED,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC;IAEpC,+DAA+D;IAC/D,kEAAkE;IAClE,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IACvD,OAAO,UAAU,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,WAAmB;IACxD,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,gCAAgC,WAAW,8BAA8B,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,OAAO,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACzC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,mBAAmB,CAAC,SAAiB;IACnD,OAAO,SAAS,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AACjC,CAAC"}

package/plugins/specweave/skills/increment/SKILL.md

@@ -22,6 +22,10 @@ hooks:
       hooks:
         - type: command
           command: bash plugins/specweave/hooks/v2/guards/increment-duplicate-guard.sh
+    - matcher: Skill|Task
+      hooks:
+        - type: command
+          command: bash plugins/specweave/hooks/v2/dispatchers/post-tool-use-analytics.sh
 ---
 
 # Plan Product Increment