specweave 0.30.1 → 0.30.3

package/bin/specweave.js

@@ -38,6 +38,7 @@ program
   .option('-l, --language <lang>', 'Language for generated content (en, ru, es, zh, de, fr, ja, ko, pt)')
   .option('-f, --force', 'Force fresh start (non-interactive, removes existing .specweave)', false)
   .option('--force-refresh', 'Force marketplace refresh (skip cache, always pull latest)', false)
+  .option('--no-living-docs', 'Skip living docs builder setup')
   .action(async (projectName, options) => {
     const { initCommand } = await import('../dist/src/cli/commands/init.js');
     await initCommand(projectName, options);

package/dist/plugins/specweave-ado/lib/ado-permission-gate.d.ts

@@ -0,0 +1,113 @@
+/**
+ * ADO Permission Gate
+ *
+ * Validates that sync permissions are enabled before allowing ADO write operations.
+ * This ensures manual ADO commands respect the same permission settings as the
+ * sync-coordinator.
+ *
+ * Usage:
+ * ```typescript
+ * const gate = await createAdoPermissionGate();
+ * const result = gate.checkWritePermission();
+ * if (!result.allowed) {
+ *   console.log(result.reason);
+ *   return;
+ * }
+ * ```
+ *
+ * @module ado-permission-gate
+ */
+/**
+ * Permission check result
+ */
+export interface PermissionCheckResult {
+    /**
+     * Whether the operation is allowed
+     */
+    allowed: boolean;
+    /**
+     * Human-readable reason for the decision
+     */
+    reason: string;
+    /**
+     * Suggested action if permission denied
+     */
+    suggestedAction?: string;
+    /**
+     * Which setting controls this permission
+     */
+    settingPath?: string;
+}
+/**
+ * Sync settings from config.json
+ */
+export interface SyncSettings {
+    canUpsertInternalItems: boolean;
+    canUpdateExternalItems: boolean;
+    canUpdateStatus: boolean;
+}
+/**
+ * Default settings (all disabled for safety)
+ */
+export declare const DEFAULT_SYNC_SETTINGS: SyncSettings;
+/**
+ * ADO Permission Gate
+ *
+ * Checks permission settings before allowing ADO write operations.
+ */
+export declare class AdoPermissionGate {
+    private settings;
+    private configPath;
+    constructor(settings: SyncSettings, configPath: string);
+    /**
+     * Check if write operations (create/update work items) are allowed
+     *
+     * Requires: canUpdateExternalItems = true
+     */
+    checkWritePermission(): PermissionCheckResult;
+    /**
+     * Check if status updates are allowed
+     *
+     * Requires: canUpdateStatus = true
+     */
+    checkStatusPermission(): PermissionCheckResult;
+    /**
+     * Check if internal item creation is allowed
+     *
+     * Requires: canUpsertInternalItems = true
+     */
+    checkCreateInternalPermission(): PermissionCheckResult;
+    /**
+     * Get current settings
+     */
+    getSettings(): SyncSettings;
+    /**
+     * Get human-readable permission summary
+     */
+    getPermissionSummary(): string;
+}
+/**
+ * Create an AdoPermissionGate from config.json
+ *
+ * @param projectRoot - Project root directory (defaults to cwd)
+ * @returns AdoPermissionGate instance
+ */
+export declare function createAdoPermissionGate(projectRoot?: string): Promise<AdoPermissionGate>;
+/**
+ * Quick check: Are ADO write operations allowed?
+ *
+ * Convenience function for simple permission checks.
+ *
+ * @param projectRoot - Project root directory
+ * @returns Permission check result
+ */
+export declare function canWriteToAdo(projectRoot?: string): Promise<PermissionCheckResult>;
+/**
+ * Quick check: Are ADO status updates allowed?
+ *
+ * @param projectRoot - Project root directory
+ * @returns Permission check result
+ */
+export declare function canUpdateAdoStatus(projectRoot?: string): Promise<PermissionCheckResult>;
+export default AdoPermissionGate;
+//# sourceMappingURL=ado-permission-gate.d.ts.map

package/dist/plugins/specweave-ado/lib/ado-permission-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado-permission-gate.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-ado/lib/ado-permission-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAKH;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sBAAsB,EAAE,OAAO,CAAC;IAChC,sBAAsB,EAAE,OAAO,CAAC;IAChC,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAInC,CAAC;AAEF;;;;GAIG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAe;IAC/B,OAAO,CAAC,UAAU,CAAS;gBAEf,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM;IAKtD;;;;OAIG;IACH,oBAAoB,IAAI,qBAAqB;IAgB7C;;;;OAIG;IACH,qBAAqB,IAAI,qBAAqB;IAgB9C;;;;OAIG;IACH,6BAA6B,IAAI,qBAAqB;IAgBtD;;OAEG;IACH,WAAW,IAAI,YAAY;IAI3B;;OAEG;IACH,oBAAoB,IAAI,MAAM;CAmB/B;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,iBAAiB,CAAC,CAkB5B;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,qBAAqB,CAAC,CAGhC;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,qBAAqB,CAAC,CAGhC;AAED,eAAe,iBAAiB,CAAC"}

package/dist/plugins/specweave-ado/lib/ado-permission-gate.js

@@ -0,0 +1,169 @@
+/**
+ * ADO Permission Gate
+ *
+ * Validates that sync permissions are enabled before allowing ADO write operations.
+ * This ensures manual ADO commands respect the same permission settings as the
+ * sync-coordinator.
+ *
+ * Usage:
+ * ```typescript
+ * const gate = await createAdoPermissionGate();
+ * const result = gate.checkWritePermission();
+ * if (!result.allowed) {
+ *   console.log(result.reason);
+ *   return;
+ * }
+ * ```
+ *
+ * @module ado-permission-gate
+ */
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+/**
+ * Default settings (all disabled for safety)
+ */
+export const DEFAULT_SYNC_SETTINGS = {
+    canUpsertInternalItems: false,
+    canUpdateExternalItems: false,
+    canUpdateStatus: false,
+};
+/**
+ * ADO Permission Gate
+ *
+ * Checks permission settings before allowing ADO write operations.
+ */
+export class AdoPermissionGate {
+    constructor(settings, configPath) {
+        this.settings = settings;
+        this.configPath = configPath;
+    }
+    /**
+     * Check if write operations (create/update work items) are allowed
+     *
+     * Requires: canUpdateExternalItems = true
+     */
+    checkWritePermission() {
+        if (this.settings.canUpdateExternalItems) {
+            return {
+                allowed: true,
+                reason: 'Write operations permitted (canUpdateExternalItems=true)',
+            };
+        }
+        return {
+            allowed: false,
+            reason: 'Permission denied: External tool updates are disabled.',
+            suggestedAction: `Enable sync.settings.canUpdateExternalItems in ${this.configPath}`,
+            settingPath: 'sync.settings.canUpdateExternalItems',
+        };
+    }
+    /**
+     * Check if status updates are allowed
+     *
+     * Requires: canUpdateStatus = true
+     */
+    checkStatusPermission() {
+        if (this.settings.canUpdateStatus) {
+            return {
+                allowed: true,
+                reason: 'Status updates permitted (canUpdateStatus=true)',
+            };
+        }
+        return {
+            allowed: false,
+            reason: 'Permission denied: Status updates are disabled.',
+            suggestedAction: `Enable sync.settings.canUpdateStatus in ${this.configPath}`,
+            settingPath: 'sync.settings.canUpdateStatus',
+        };
+    }
+    /**
+     * Check if internal item creation is allowed
+     *
+     * Requires: canUpsertInternalItems = true
+     */
+    checkCreateInternalPermission() {
+        if (this.settings.canUpsertInternalItems) {
+            return {
+                allowed: true,
+                reason: 'Internal item creation permitted (canUpsertInternalItems=true)',
+            };
+        }
+        return {
+            allowed: false,
+            reason: 'Permission denied: Creating internal items is disabled.',
+            suggestedAction: `Enable sync.settings.canUpsertInternalItems in ${this.configPath}`,
+            settingPath: 'sync.settings.canUpsertInternalItems',
+        };
+    }
+    /**
+     * Get current settings
+     */
+    getSettings() {
+        return { ...this.settings };
+    }
+    /**
+     * Get human-readable permission summary
+     */
+    getPermissionSummary() {
+        const parts = [];
+        if (this.settings.canUpdateExternalItems) {
+            parts.push('create/update ADO items');
+        }
+        if (this.settings.canUpdateStatus) {
+            parts.push('update status');
+        }
+        if (this.settings.canUpsertInternalItems) {
+            parts.push('create internal items');
+        }
+        if (parts.length === 0) {
+            return 'All ADO write operations disabled (read-only mode)';
+        }
+        return `Allowed: ${parts.join(', ')}`;
+    }
+}
+/**
+ * Create an AdoPermissionGate from config.json
+ *
+ * @param projectRoot - Project root directory (defaults to cwd)
+ * @returns AdoPermissionGate instance
+ */
+export async function createAdoPermissionGate(projectRoot = process.cwd()) {
+    const configPath = path.join(projectRoot, '.specweave', 'config.json');
+    try {
+        const content = await fs.readFile(configPath, 'utf-8');
+        const config = JSON.parse(content);
+        const settings = {
+            canUpsertInternalItems: config?.sync?.settings?.canUpsertInternalItems ?? false,
+            canUpdateExternalItems: config?.sync?.settings?.canUpdateExternalItems ?? false,
+            canUpdateStatus: config?.sync?.settings?.canUpdateStatus ?? false,
+        };
+        return new AdoPermissionGate(settings, configPath);
+    }
+    catch {
+        // Return gate with default (disabled) settings if config not found
+        return new AdoPermissionGate(DEFAULT_SYNC_SETTINGS, configPath);
+    }
+}
+/**
+ * Quick check: Are ADO write operations allowed?
+ *
+ * Convenience function for simple permission checks.
+ *
+ * @param projectRoot - Project root directory
+ * @returns Permission check result
+ */
+export async function canWriteToAdo(projectRoot = process.cwd()) {
+    const gate = await createAdoPermissionGate(projectRoot);
+    return gate.checkWritePermission();
+}
+/**
+ * Quick check: Are ADO status updates allowed?
+ *
+ * @param projectRoot - Project root directory
+ * @returns Permission check result
+ */
+export async function canUpdateAdoStatus(projectRoot = process.cwd()) {
+    const gate = await createAdoPermissionGate(projectRoot);
+    return gate.checkStatusPermission();
+}
+export default AdoPermissionGate;
+//# sourceMappingURL=ado-permission-gate.js.map

package/dist/plugins/specweave-ado/lib/ado-permission-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado-permission-gate.js","sourceRoot":"","sources":["../../../../plugins/specweave-ado/lib/ado-permission-gate.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAoClC;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,sBAAsB,EAAE,KAAK;IAC7B,sBAAsB,EAAE,KAAK;IAC7B,eAAe,EAAE,KAAK;CACvB,CAAC;AAEF;;;;GAIG;AACH,MAAM,OAAO,iBAAiB;IAI5B,YAAY,QAAsB,EAAE,UAAkB;QACpD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,oBAAoB;QAClB,IAAI,IAAI,CAAC,QAAQ,CAAC,sBAAsB,EAAE,CAAC;YACzC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,0DAA0D;aACnE,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,wDAAwD;YAChE,eAAe,EAAE,kDAAkD,IAAI,CAAC,UAAU,EAAE;YACpF,WAAW,EAAE,sCAAsC;SACpD,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,qBAAqB;QACnB,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;YAClC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,iDAAiD;aAC1D,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,iDAAiD;YACzD,eAAe,EAAE,2CAA2C,IAAI,CAAC,UAAU,EAAE;YAC7E,WAAW,EAAE,+BAA+B;SAC7C,CAAC;IACJ,CAAC;IAED;;;;OAIG;IACH,6BAA6B;QAC3B,IAAI,IAAI,CAAC,QAAQ,CAAC,sBAAsB,EAAE,CAAC;YACzC,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,gEAAgE;aACzE,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE,KAAK;YACd,MAAM,EAAE,yDAAyD;YACjE,eAAe,EAAE,kDAAkD,IAAI,CAAC,UAAU,EAAE;YACpF,WAAW,EAAE,sCAAsC;SACpD,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,EAAE,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,oBAAoB;QAClB,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,IAAI,CAAC,QAAQ,CAAC,sBAAsB,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QACxC,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,CAAC;YAClC,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC9B,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,sBAAsB,EAAE,CAAC;YACzC,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QACtC,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,oDAAoD,CAAC;QAC9D,CAAC;QAED,OAAO,YAAY,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACxC,CAAC;CACF;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,cAAsB,OAAO,CAAC,GAAG,EAAE;IAEnC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,YAAY,EAAE,aAAa,CAAC,CAAC;IAEvE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAEnC,MAAM,QAAQ,GAAiB;YAC7B,sBAAsB,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,sBAAsB,IAAI,KAAK;YAC/E,sBAAsB,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,sBAAsB,IAAI,KAAK;YAC/E,eAAe,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,IAAI,KAAK;SAClE,CAAC;QAEF,OAAO,IAAI,iBAAiB,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACrD,CAAC;IAAC,MAAM,CAAC;QACP,mEAAmE;QACnE,OAAO,IAAI,iBAAiB,CAAC,qBAAqB,EAAE,UAAU,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,cAAsB,OAAO,CAAC,GAAG,EAAE;IAEnC,MAAM,IAAI,GAAG,MAAM,uBAAuB,CAAC,WAAW,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC,oBAAoB,EAAE,CAAC;AACrC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,cAAsB,OAAO,CAAC,GAAG,EAAE;IAEnC,MAAM,IAAI,GAAG,MAAM,uBAAuB,CAAC,WAAW,CAAC,CAAC;IACxD,OAAO,IAAI,CAAC,qBAAqB,EAAE,CAAC;AACtC,CAAC;AAED,eAAe,iBAAiB,CAAC"}

package/dist/plugins/specweave-ado/lib/ado-profile-resolver.d.ts

@@ -0,0 +1,137 @@
+/**
+ * ADO Profile Resolver
+ *
+ * Resolves the correct ADO profile to use for sync operations.
+ * Priority:
+ * 1. Increment's stored profile (metadata.json -> external_sync.ado.profile)
+ * 2. Global activeProfile (config.json -> sync.activeProfile)
+ *
+ * This allows each increment to sync to its designated ADO project
+ * without requiring manual activeProfile switching.
+ *
+ * Usage:
+ * ```typescript
+ * const resolver = await createAdoProfileResolver();
+ * const profile = await resolver.resolveProfile('0093-my-increment');
+ * // profile contains organization, project, PAT, etc.
+ * ```
+ *
+ * @module ado-profile-resolver
+ */
+/**
+ * ADO profile configuration
+ */
+export interface AdoProfileConfig {
+    /**
+     * Profile name (for display/logging)
+     */
+    profileName: string;
+    /**
+     * ADO organization name
+     */
+    organization: string;
+    /**
+     * ADO project name
+     */
+    project: string;
+    /**
+     * Display name (optional)
+     */
+    displayName?: string;
+    /**
+     * Area path (optional)
+     */
+    areaPath?: string;
+    /**
+     * Iteration path (optional)
+     */
+    iterationPath?: string;
+}
+/**
+ * Profile resolution result
+ */
+export interface ProfileResolutionResult {
+    /**
+     * Whether resolution succeeded
+     */
+    success: boolean;
+    /**
+     * Resolved profile config (if success)
+     */
+    profile?: AdoProfileConfig;
+    /**
+     * Source of the profile
+     */
+    source?: 'increment' | 'global';
+    /**
+     * Error message (if failed)
+     */
+    error?: string;
+    /**
+     * Increment ID that was checked
+     */
+    incrementId?: string;
+}
+/**
+ * ADO Profile Resolver
+ */
+export declare class AdoProfileResolver {
+    private projectRoot;
+    private configPath;
+    private incrementsPath;
+    constructor(projectRoot?: string);
+    /**
+     * Resolve the ADO profile for an increment
+     *
+     * Priority:
+     * 1. Increment's metadata.json -> external_sync.ado.profile
+     * 2. Config.json -> sync.activeProfile
+     *
+     * @param incrementId - Increment ID (e.g., "0093-my-feature")
+     * @returns Profile resolution result
+     */
+    resolveProfile(incrementId: string): Promise<ProfileResolutionResult>;
+    /**
+     * Get increment's stored ADO profile name
+     *
+     * @param incrementId - Increment ID
+     * @returns Profile name or null if not set
+     */
+    getIncrementProfile(incrementId: string): Promise<string | null>;
+    /**
+     * Set increment's ADO profile
+     *
+     * Stores the profile name in the increment's metadata.json
+     *
+     * @param incrementId - Increment ID
+     * @param profileName - Profile name to set
+     */
+    setIncrementProfile(incrementId: string, profileName: string): Promise<void>;
+    /**
+     * List available ADO profiles
+     *
+     * @returns Array of profile names
+     */
+    listAdoProfiles(): Promise<string[]>;
+    /**
+     * Load config.json
+     */
+    private loadConfig;
+}
+/**
+ * Create an AdoProfileResolver instance
+ *
+ * @param projectRoot - Project root directory (defaults to cwd)
+ * @returns AdoProfileResolver instance
+ */
+export declare function createAdoProfileResolver(projectRoot?: string): Promise<AdoProfileResolver>;
+/**
+ * Quick resolve: Get ADO profile for an increment
+ *
+ * @param incrementId - Increment ID
+ * @param projectRoot - Project root directory
+ * @returns Profile resolution result
+ */
+export declare function resolveAdoProfile(incrementId: string, projectRoot?: string): Promise<ProfileResolutionResult>;
+export default AdoProfileResolver;
+//# sourceMappingURL=ado-profile-resolver.d.ts.map

package/dist/plugins/specweave-ado/lib/ado-profile-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado-profile-resolver.d.ts","sourceRoot":"","sources":["../../../../plugins/specweave-ado/lib/ado-profile-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAE3B;;OAEG;IACH,MAAM,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;IAEhC;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA+BD;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,cAAc,CAAS;gBAEnB,WAAW,GAAE,MAAsB;IAM/C;;;;;;;;;OASG;IACG,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAqE3E;;;;;OAKG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAetE;;;;;;;OAOG;IACG,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBlF;;;;OAIG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAY1C;;OAEG;YACW,UAAU;CAQzB;AAED;;;;;GAKG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,kBAAkB,CAAC,CAE7B;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,WAAW,EAAE,MAAM,EACnB,WAAW,GAAE,MAAsB,GAClC,OAAO,CAAC,uBAAuB,CAAC,CAGlC;AAED,eAAe,kBAAkB,CAAC"}

package/dist/plugins/specweave-ado/lib/ado-profile-resolver.js

@@ -0,0 +1,200 @@
+/**
+ * ADO Profile Resolver
+ *
+ * Resolves the correct ADO profile to use for sync operations.
+ * Priority:
+ * 1. Increment's stored profile (metadata.json -> external_sync.ado.profile)
+ * 2. Global activeProfile (config.json -> sync.activeProfile)
+ *
+ * This allows each increment to sync to its designated ADO project
+ * without requiring manual activeProfile switching.
+ *
+ * Usage:
+ * ```typescript
+ * const resolver = await createAdoProfileResolver();
+ * const profile = await resolver.resolveProfile('0093-my-increment');
+ * // profile contains organization, project, PAT, etc.
+ * ```
+ *
+ * @module ado-profile-resolver
+ */
+import { promises as fs } from 'node:fs';
+import * as path from 'node:path';
+/**
+ * ADO Profile Resolver
+ */
+export class AdoProfileResolver {
+    constructor(projectRoot = process.cwd()) {
+        this.projectRoot = projectRoot;
+        this.configPath = path.join(projectRoot, '.specweave', 'config.json');
+        this.incrementsPath = path.join(projectRoot, '.specweave', 'increments');
+    }
+    /**
+     * Resolve the ADO profile for an increment
+     *
+     * Priority:
+     * 1. Increment's metadata.json -> external_sync.ado.profile
+     * 2. Config.json -> sync.activeProfile
+     *
+     * @param incrementId - Increment ID (e.g., "0093-my-feature")
+     * @returns Profile resolution result
+     */
+    async resolveProfile(incrementId) {
+        // Load global config
+        const config = await this.loadConfig();
+        if (!config) {
+            return {
+                success: false,
+                error: 'Failed to load .specweave/config.json',
+                incrementId,
+            };
+        }
+        // Try to get increment-specific profile first
+        const incrementProfile = await this.getIncrementProfile(incrementId);
+        // Determine which profile to use
+        const profileName = incrementProfile || config.sync?.activeProfile;
+        if (!profileName) {
+            return {
+                success: false,
+                error: 'No ADO profile configured. Set sync.activeProfile in config.json or external_sync.ado.profile in increment metadata.',
+                incrementId,
+            };
+        }
+        // Check if profile is for ADO provider
+        const profiles = config.sync?.profiles || {};
+        const profileConfig = profiles[profileName];
+        if (!profileConfig) {
+            return {
+                success: false,
+                error: `Profile "${profileName}" not found in config.sync.profiles`,
+                incrementId,
+            };
+        }
+        if (profileConfig.provider !== 'ado') {
+            return {
+                success: false,
+                error: `Profile "${profileName}" is not an ADO profile (provider: ${profileConfig.provider})`,
+                incrementId,
+            };
+        }
+        // Validate required fields
+        if (!profileConfig.config?.organization || !profileConfig.config?.project) {
+            return {
+                success: false,
+                error: `Profile "${profileName}" missing required fields (organization, project)`,
+                incrementId,
+            };
+        }
+        return {
+            success: true,
+            profile: {
+                profileName,
+                organization: profileConfig.config.organization,
+                project: profileConfig.config.project,
+                displayName: profileConfig.displayName,
+                areaPath: profileConfig.config.areaPath,
+                iterationPath: profileConfig.config.iterationPath,
+            },
+            source: incrementProfile ? 'increment' : 'global',
+            incrementId,
+        };
+    }
+    /**
+     * Get increment's stored ADO profile name
+     *
+     * @param incrementId - Increment ID
+     * @returns Profile name or null if not set
+     */
+    async getIncrementProfile(incrementId) {
+        const metadataPath = path.join(this.incrementsPath, incrementId, 'metadata.json');
+        try {
+            const content = await fs.readFile(metadataPath, 'utf-8');
+            const metadata = JSON.parse(content);
+            // Check for profile in external_sync.ado.profile
+            return metadata?.external_sync?.ado?.profile || null;
+        }
+        catch {
+            // Metadata not found or invalid - return null
+            return null;
+        }
+    }
+    /**
+     * Set increment's ADO profile
+     *
+     * Stores the profile name in the increment's metadata.json
+     *
+     * @param incrementId - Increment ID
+     * @param profileName - Profile name to set
+     */
+    async setIncrementProfile(incrementId, profileName) {
+        const metadataPath = path.join(this.incrementsPath, incrementId, 'metadata.json');
+        // Load existing metadata
+        let metadata = {};
+        try {
+            const content = await fs.readFile(metadataPath, 'utf-8');
+            metadata = JSON.parse(content);
+        }
+        catch {
+            // Start with empty metadata if not found
+        }
+        // Set external_sync.ado.profile
+        if (!metadata.external_sync) {
+            metadata.external_sync = {};
+        }
+        if (!metadata.external_sync.ado) {
+            metadata.external_sync.ado = {};
+        }
+        metadata.external_sync.ado.profile = profileName;
+        // Write back
+        await fs.writeFile(metadataPath, JSON.stringify(metadata, null, 2) + '\n', 'utf-8');
+    }
+    /**
+     * List available ADO profiles
+     *
+     * @returns Array of profile names
+     */
+    async listAdoProfiles() {
+        const config = await this.loadConfig();
+        if (!config?.sync?.profiles) {
+            return [];
+        }
+        const profiles = config.sync.profiles;
+        return Object.entries(profiles)
+            .filter(([_, p]) => p.provider === 'ado')
+            .map(([name]) => name);
+    }
+    /**
+     * Load config.json
+     */
+    async loadConfig() {
+        try {
+            const content = await fs.readFile(this.configPath, 'utf-8');
+            return JSON.parse(content);
+        }
+        catch {
+            return null;
+        }
+    }
+}
+/**
+ * Create an AdoProfileResolver instance
+ *
+ * @param projectRoot - Project root directory (defaults to cwd)
+ * @returns AdoProfileResolver instance
+ */
+export async function createAdoProfileResolver(projectRoot = process.cwd()) {
+    return new AdoProfileResolver(projectRoot);
+}
+/**
+ * Quick resolve: Get ADO profile for an increment
+ *
+ * @param incrementId - Increment ID
+ * @param projectRoot - Project root directory
+ * @returns Profile resolution result
+ */
+export async function resolveAdoProfile(incrementId, projectRoot = process.cwd()) {
+    const resolver = new AdoProfileResolver(projectRoot);
+    return resolver.resolveProfile(incrementId);
+}
+export default AdoProfileResolver;
+//# sourceMappingURL=ado-profile-resolver.js.map

package/dist/plugins/specweave-ado/lib/ado-profile-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ado-profile-resolver.js","sourceRoot":"","sources":["../../../../plugins/specweave-ado/lib/ado-profile-resolver.ts"],"names":[],"mappings":"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"}

package/dist/src/cli/commands/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAoBH,OAAO,EACL,KAAK,WAAW,EAuBjB,MAAM,0BAA0B,CAAC;AAYlC,YAAY,EAAE,WAAW,EAAE,CAAC;AAgJ5B;;GAEG;AACH,wBAAsB,WAAW,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAmZf"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAoBH,OAAO,EACL,KAAK,WAAW,EAuBjB,MAAM,0BAA0B,CAAC;AAWlC,YAAY,EAAE,WAAW,EAAE,CAAC;AAgJ5B;;GAEG;AACH,wBAAsB,WAAW,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CAsZf"}