specweave 0.22.13 → 0.23.0

package/dist/src/core/types/origin-metadata.js

@@ -0,0 +1,166 @@
+/**
+ * Origin Metadata Types
+ *
+ * Defines types for tracking the origin of User Stories and Tasks:
+ * - Internal: Created within SpecWeave increments
+ * - External: Imported from external tools (GitHub, JIRA, ADO)
+ */
+/**
+ * Origin badge emojis for living docs
+ */
+export const ORIGIN_BADGES = {
+    internal: '🏠', // Internal
+    github: '🔗', // GitHub
+    jira: '🎫', // JIRA
+    ado: '📋', // Azure DevOps
+    unknown: '❓' // Unknown external source
+};
+/**
+ * Get origin badge for display
+ *
+ * @param source - External source or 'internal'
+ * @returns Emoji badge
+ *
+ * @example
+ * getOriginBadge('github') // Returns: '🔗'
+ * getOriginBadge('internal') // Returns: '🏠'
+ */
+export function getOriginBadge(source) {
+    return ORIGIN_BADGES[source] || ORIGIN_BADGES.unknown;
+}
+/**
+ * Format origin for display in living docs
+ *
+ * @param metadata - External item metadata
+ * @returns Formatted origin string (e.g., "🔗 GitHub #638")
+ *
+ * @example
+ * formatOrigin({
+ *   id: 'US-004E',
+ *   origin: 'external',
+ *   source: 'github',
+ *   external_id: 'GH-#638',
+ *   external_url: 'https://github.com/...',
+ *   imported_at: '2025-11-19T10:30:00Z'
+ * })
+ * // Returns: "🔗 [GitHub #638](https://github.com/...)"
+ */
+export function formatOrigin(metadata) {
+    const badge = getOriginBadge(metadata.source);
+    const displayId = metadata.external_id.replace(/^(GH|JIRA|ADO)-/, '');
+    return `${badge} [${metadata.source.toUpperCase()} ${displayId}](${metadata.external_url})`;
+}
+/**
+ * Check if ID is from external source (has E suffix)
+ *
+ * @param id - User Story or Task ID
+ * @returns True if external, false if internal
+ *
+ * @example
+ * isExternalId('US-004E') // Returns: true
+ * isExternalId('US-003') // Returns: false
+ * isExternalId('T-010E') // Returns: true
+ */
+export function isExternalId(id) {
+    return id.endsWith('E');
+}
+/**
+ * Extract origin from ID suffix
+ *
+ * @param id - User Story or Task ID
+ * @returns Origin type
+ *
+ * @example
+ * getOriginFromId('US-004E') // Returns: 'external'
+ * getOriginFromId('US-003') // Returns: 'internal'
+ */
+export function getOriginFromId(id) {
+    return isExternalId(id) ? 'external' : 'internal';
+}
+/**
+ * Parse external ID to extract source and number
+ *
+ * @param externalId - External ID (e.g., "GH-#638", "JIRA-SPEC-789")
+ * @returns Parsed components
+ *
+ * @example
+ * parseExternalId('GH-#638')
+ * // Returns: { source: 'github', number: '638' }
+ *
+ * parseExternalId('JIRA-SPEC-789')
+ * // Returns: { source: 'jira', number: 'SPEC-789' }
+ */
+export function parseExternalId(externalId) {
+    const ghMatch = externalId.match(/^GH-#?(\d+)$/);
+    if (ghMatch) {
+        return { source: 'github', number: ghMatch[1] };
+    }
+    const jiraMatch = externalId.match(/^JIRA-(.+)$/);
+    if (jiraMatch) {
+        return { source: 'jira', number: jiraMatch[1] };
+    }
+    const adoMatch = externalId.match(/^ADO-(\d+)$/);
+    if (adoMatch) {
+        return { source: 'ado', number: adoMatch[1] };
+    }
+    return null;
+}
+/**
+ * Create external item metadata
+ *
+ * @param params - Creation parameters
+ * @returns External item metadata
+ */
+export function createExternalMetadata(params) {
+    const metadata = {
+        id: params.id,
+        origin: 'external',
+        source: params.source,
+        external_id: params.externalId,
+        external_url: params.externalUrl,
+        imported_at: new Date().toISOString()
+    };
+    // Only include optional fields if explicitly provided
+    if (params.externalTitle !== undefined) {
+        metadata.external_title = params.externalTitle;
+    }
+    if (params.formatPreservation !== undefined) {
+        metadata.format_preservation = params.formatPreservation;
+    }
+    return metadata;
+}
+/**
+ * Validate external item metadata
+ *
+ * @param metadata - External item metadata
+ * @throws Error if metadata is invalid
+ */
+export function validateExternalMetadata(metadata) {
+    if (!metadata.id) {
+        throw new Error('External item metadata must have id');
+    }
+    if (!metadata.id.endsWith('E')) {
+        throw new Error(`External item ID must end with E suffix: ${metadata.id}`);
+    }
+    if (metadata.origin !== 'external') {
+        throw new Error(`External item must have origin='external': ${metadata.id}`);
+    }
+    if (!['github', 'jira', 'ado', 'unknown'].includes(metadata.source)) {
+        throw new Error(`Invalid external source: ${metadata.source}`);
+    }
+    if (!metadata.external_id) {
+        throw new Error(`External item must have external_id: ${metadata.id}`);
+    }
+    if (!metadata.external_url) {
+        throw new Error(`External item must have external_url: ${metadata.id}`);
+    }
+    if (!metadata.imported_at) {
+        throw new Error(`External item must have imported_at: ${metadata.id}`);
+    }
+    // Validate ISO 8601 format
+    const timestamp = new Date(metadata.imported_at);
+    if (isNaN(timestamp.getTime())) {
+        throw new Error(`Invalid imported_at timestamp: ${metadata.imported_at}`);
+    }
+}
+//# sourceMappingURL=origin-metadata.js.map

package/dist/src/core/types/origin-metadata.js.map

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

package/dist/src/core/types/sync-config-validator.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Sync Config Validator - Validates critical sync configuration rules
+ *
+ * Enforces immutable architectural constraints:
+ * 1. Increment → Living Docs MUST be one-way (IMMUTABLE)
+ * 2. autoIncrementCreation MUST be false (FORBIDDEN)
+ * 3. Warns if all permissions enabled (conflict risk)
+ *
+ * Part of v0.24.0 three-permission architecture (FS-047)
+ */
+import { SyncSettings } from './sync-settings.js';
+/**
+ * Validation result for sync configuration
+ */
+export interface SyncConfigValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Config structure (partial, relevant to sync validation)
+ */
+export interface SyncConfig {
+    sync?: {
+        settings?: SyncSettings;
+        incrementToLivingDocs?: 'one-way' | 'two-way';
+        autoIncrementCreation?: boolean;
+        [key: string]: any;
+    };
+}
+/**
+ * Validate sync configuration against architectural rules
+ *
+ * @param config - Configuration object from .specweave/config.json
+ * @returns Validation result with errors and warnings
+ */
+export declare function validateSyncConfig(config: SyncConfig): SyncConfigValidationResult;
+/**
+ * Throw error if sync config is invalid
+ *
+ * @param config - Configuration object from .specweave/config.json
+ * @param options - Optional logger for warnings
+ * @throws Error if validation fails
+ */
+export declare function assertValidSyncConfig(config: SyncConfig, options?: {
+    logger?: {
+        warn: (message: string) => void;
+    };
+}): void;
+/**
+ * Get human-readable summary of sync config validation
+ *
+ * @param config - Configuration object
+ * @returns Summary string
+ */
+export declare function getSyncConfigSummary(config: SyncConfig): string;
+//# sourceMappingURL=sync-config-validator.d.ts.map

package/dist/src/core/types/sync-config-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-config-validator.d.ts","sourceRoot":"","sources":["../../../../src/core/types/sync-config-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAAwB,MAAM,oBAAoB,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE;QACL,QAAQ,CAAC,EAAE,YAAY,CAAC;QACxB,qBAAqB,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;QAC9C,qBAAqB,CAAC,EAAE,OAAO,CAAC;QAChC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KACpB,CAAC;CACH;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,0BAA0B,CA0EjF;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE;IAAE,MAAM,CAAC,EAAE;QAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,CAAA;CAAO,GAC7D,IAAI,CAYN;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,CAsB/D"}

package/dist/src/core/types/sync-config-validator.js

@@ -0,0 +1,116 @@
+/**
+ * Sync Config Validator - Validates critical sync configuration rules
+ *
+ * Enforces immutable architectural constraints:
+ * 1. Increment → Living Docs MUST be one-way (IMMUTABLE)
+ * 2. autoIncrementCreation MUST be false (FORBIDDEN)
+ * 3. Warns if all permissions enabled (conflict risk)
+ *
+ * Part of v0.24.0 three-permission architecture (FS-047)
+ */
+import { validateSyncSettings } from './sync-settings.js';
+/**
+ * Validate sync configuration against architectural rules
+ *
+ * @param config - Configuration object from .specweave/config.json
+ * @returns Validation result with errors and warnings
+ */
+export function validateSyncConfig(config) {
+    const result = {
+        valid: true,
+        errors: [],
+        warnings: [],
+    };
+    // If no sync config, that's fine (safe defaults apply)
+    if (!config.sync) {
+        return result;
+    }
+    const { sync } = config;
+    // Rule 1: Validate SyncSettings structure (if provided)
+    if (sync.settings) {
+        try {
+            validateSyncSettings(sync.settings);
+        }
+        catch (error) {
+            result.valid = false;
+            result.errors.push(`Invalid sync settings: ${error.message}`);
+        }
+    }
+    // Rule 2: incrementToLivingDocs MUST be 'one-way' (immutable architectural rule)
+    if (sync.incrementToLivingDocs !== undefined && sync.incrementToLivingDocs !== 'one-way') {
+        result.valid = false;
+        result.errors.push(`sync.incrementToLivingDocs MUST be 'one-way' (found: '${sync.incrementToLivingDocs}'). ` +
+            'Increment → Living Docs sync is ALWAYS one-way by architectural design. ' +
+            'This direction is IMMUTABLE and cannot be configured.');
+    }
+    // Rule 3: autoIncrementCreation MUST be false (forbidden feature)
+    if (sync.autoIncrementCreation === true) {
+        result.valid = false;
+        result.errors.push('sync.autoIncrementCreation MUST be false. ' +
+            'Auto-creating increments for external items is FORBIDDEN. ' +
+            'External items live in living docs ONLY. ' +
+            'Users MUST manually create increments when ready to work on external items.');
+    }
+    // Warning: All permissions enabled (full sync mode)
+    if (sync.settings &&
+        sync.settings.canUpsertInternalItems === true &&
+        sync.settings.canUpdateExternalItems === true &&
+        sync.settings.canUpdateStatus === true) {
+        result.warnings.push('⚠️  All sync permissions enabled (full sync mode). ' +
+            'This allows bidirectional sync between SpecWeave and external tools. ' +
+            'Be aware of potential sync conflicts when multiple tools modify the same items. ' +
+            'Consider enabling only the permissions you need for your workflow.');
+    }
+    // Warning: Conflicting permissions (update external without status)
+    if (sync.settings &&
+        sync.settings.canUpdateExternalItems === true &&
+        sync.settings.canUpdateStatus === false) {
+        result.warnings.push('⚠️  canUpdateExternalItems=true but canUpdateStatus=false. ' +
+            'External items will be updated with content changes but status will not sync. ' +
+            'Consider enabling canUpdateStatus if you want status to reflect completion.');
+    }
+    return result;
+}
+/**
+ * Throw error if sync config is invalid
+ *
+ * @param config - Configuration object from .specweave/config.json
+ * @param options - Optional logger for warnings
+ * @throws Error if validation fails
+ */
+export function assertValidSyncConfig(config, options = {}) {
+    const result = validateSyncConfig(config);
+    if (!result.valid) {
+        throw new Error(`Invalid sync configuration:\n${result.errors.join('\n')}`);
+    }
+    // Log warnings (but don't throw)
+    if (result.warnings.length > 0 && options.logger) {
+        options.logger.warn('Sync configuration warnings:');
+        result.warnings.forEach((warning) => options.logger.warn(warning));
+    }
+}
+/**
+ * Get human-readable summary of sync config validation
+ *
+ * @param config - Configuration object
+ * @returns Summary string
+ */
+export function getSyncConfigSummary(config) {
+    const result = validateSyncConfig(config);
+    const lines = [];
+    lines.push('=== Sync Configuration Validation ===');
+    lines.push(`Valid: ${result.valid ? '✅ Yes' : '❌ No'}`);
+    if (result.errors.length > 0) {
+        lines.push('\nErrors:');
+        result.errors.forEach((error) => lines.push(`  ❌ ${error}`));
+    }
+    if (result.warnings.length > 0) {
+        lines.push('\nWarnings:');
+        result.warnings.forEach((warning) => lines.push(`  ⚠️  ${warning}`));
+    }
+    if (result.valid && result.errors.length === 0 && result.warnings.length === 0) {
+        lines.push('\n✅ All sync configuration rules satisfied');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=sync-config-validator.js.map

package/dist/src/core/types/sync-config-validator.js.map

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

package/dist/src/core/types/sync-profile.d.ts

@@ -4,6 +4,7 @@
  * Supports multiple projects per provider (GitHub, JIRA, ADO, etc.)
  * with time range filtering and rate limiting protection.
  */
+import { SyncSettings } from './sync-settings.js';
 export type SyncProvider = 'github' | 'jira' | 'ado';
 /**
  * Sync Strategy (v0.13.0+ - Simplified Two-Tier Architecture)
@@ -310,8 +311,13 @@ export interface SyncConfiguration {
     profiles: Record<string, SyncProfile>;
     /** Project contexts */
     projects?: Record<string, ProjectContext>;
-    /** Global settings */
-    settings?: {
+    /**
+     * Global settings (v0.24.0+ - Three-Permission Architecture)
+     *
+     * Combines external tool permissions (SyncSettings) with global behavior settings.
+     * All permission settings default to false for safety (explicit opt-in required).
+     */
+    settings?: SyncSettings & {
         /** Auto-detect project from increment description */
         autoDetectProject?: boolean;
         /** Default time range for new syncs */

package/dist/src/core/types/sync-profile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sync-profile.d.ts","sourceRoot":"","sources":["../../../../src/core/types/sync-profile.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sync-profile.d.ts","sourceRoot":"","sources":["../../../../src/core/types/sync-profile.ts"],"names":[],"mappings":"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"}

package/dist/src/core/types/sync-profile.js.map

@@ -1 +1 @@
-{"version":3,"file":"sync-profile.js","sourceRoot":"","sources":["../../../../src/core/types/sync-profile.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAufH,+EAA+E;AAC/E,+CAA+C;AAC/C,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAoB;IACxD,6EAA6E;IAC7E,IAAI,CAAC,OAAO,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,OAAO,CAAC,QAAQ,KAAK,aAAa,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAoB;IACnD,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAoB;IACzD,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACxD,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAkB;IACxD,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAoB;IACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAA8B,CAAC;IAExD,mDAAmD;IACnD,IAAI,QAAQ,KAAK,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvC,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,QAAwB,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAoB;IACnD,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC"}
+{"version":3,"file":"sync-profile.js","sourceRoot":"","sources":["../../../../src/core/types/sync-profile.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA8fH,+EAA+E;AAC/E,+CAA+C;AAC/C,+EAA+E;AAE/E;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAoB;IACxD,6EAA6E;IAC7E,IAAI,CAAC,OAAO,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IACnC,OAAO,OAAO,CAAC,QAAQ,KAAK,aAAa,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAoB;IACnD,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAoB;IACzD,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACrD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAoB;IACxD,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,MAAkB;IACxD,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,MAAiB;IAC/C,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC/E,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAoB;IACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAA8B,CAAC;IAExD,mDAAmD;IACnD,IAAI,QAAQ,KAAK,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QACvC,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,QAAwB,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,OAAoB;IACnD,OAAO,qBAAqB,CAAC,OAAO,CAAC,CAAC;AACxC,CAAC"}

package/dist/src/core/types/sync-settings.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Sync Settings - Controls what SpecWeave can modify in external tools
+ *
+ * These settings determine how Living Docs sync with external tools (GitHub, JIRA, ADO).
+ * All settings default to false for safety (explicit opt-in required).
+ *
+ * Storage: .specweave/config.json under sync.settings
+ */
+/**
+ * Three independent permission flags for external tool sync
+ */
+export interface SyncSettings {
+    /**
+     * Q1: Can SpecWeave CREATE and UPDATE internal work items in external tools?
+     *
+     * UPSERT = CREATE initially + UPDATE as work progresses
+     * - Controls: Title, Description/Body, Acceptance Criteria for INTERNAL items
+     * - Flow: increment → living spec → CREATE external item → UPDATE on task completion
+     * - If false: Stops before external item creation (local-only workflow)
+     *
+     * @default false (safer, no external items created)
+     */
+    canUpsertInternalItems: boolean;
+    /**
+     * Q2: Can SpecWeave UPDATE work items created externally?
+     *
+     * UPDATE = Full content updates (title, description, ACs, tasks, comments)
+     * - Controls: FULL content updates of EXTERNAL items
+     * - Flow: increment progress → living spec → UPDATE external tool (full sync)
+     * - If false: External items remain read-only snapshots (no sync back)
+     *
+     * @default false (safer, external items remain read-only)
+     */
+    canUpdateExternalItems: boolean;
+    /**
+     * Q3: Can SpecWeave UPDATE status of work items?
+     *
+     * STATUS = Status field ONLY (for BOTH internal AND external items)
+     * - Controls: Status field updates after all ACs/tasks complete
+     * - Flow: Both flows (internal and external items)
+     * - If false: No status updates regardless of item origin (manual status management)
+     *
+     * @default false (safer, status updated manually in external tool)
+     */
+    canUpdateStatus: boolean;
+}
+/**
+ * Default sync settings (all permissions disabled for safety)
+ */
+export declare const DEFAULT_SYNC_SETTINGS: SyncSettings;
+/**
+ * Type guard to check if an object is valid SyncSettings
+ */
+export declare function isValidSyncSettings(obj: any): obj is SyncSettings;
+/**
+ * Migrate old syncDirection to new SyncSettings
+ *
+ * @param syncDirection - Old syncDirection value ('bidirectional' | 'export' | 'import' | 'to-external' | 'from-external' | undefined)
+ * @returns SyncSettings with appropriate permissions
+ */
+export declare function migrateSyncDirection(syncDirection?: string | null): SyncSettings;
+/**
+ * Validate SyncSettings object
+ *
+ * @param settings - Settings to validate
+ * @throws Error if settings are invalid
+ */
+export declare function validateSyncSettings(settings: SyncSettings): void;
+/**
+ * Merge user-provided settings with defaults (fill in missing fields)
+ */
+export declare function mergeSyncSettings(userSettings: Partial<SyncSettings> | undefined): SyncSettings;
+//# sourceMappingURL=sync-settings.d.ts.map

package/dist/src/core/types/sync-settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-settings.d.ts","sourceRoot":"","sources":["../../../../src/core/types/sync-settings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;OASG;IACH,sBAAsB,EAAE,OAAO,CAAC;IAEhC;;;;;;;;;OASG;IACH,sBAAsB,EAAE,OAAO,CAAC;IAEhC;;;;;;;;;OASG;IACH,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,EAAE,YAInC,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,IAAI,YAAY,CAQjE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,YAAY,CA8BhF;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI,CAgBjE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,SAAS,GAC9C,YAAY,CAKd"}

package/dist/src/core/types/sync-settings.js

@@ -0,0 +1,90 @@
+/**
+ * Sync Settings - Controls what SpecWeave can modify in external tools
+ *
+ * These settings determine how Living Docs sync with external tools (GitHub, JIRA, ADO).
+ * All settings default to false for safety (explicit opt-in required).
+ *
+ * Storage: .specweave/config.json under sync.settings
+ */
+/**
+ * Default sync settings (all permissions disabled for safety)
+ */
+export const DEFAULT_SYNC_SETTINGS = {
+    canUpsertInternalItems: false,
+    canUpdateExternalItems: false,
+    canUpdateStatus: false,
+};
+/**
+ * Type guard to check if an object is valid SyncSettings
+ */
+export function isValidSyncSettings(obj) {
+    return (typeof obj === 'object' &&
+        obj !== null &&
+        typeof obj.canUpsertInternalItems === 'boolean' &&
+        typeof obj.canUpdateExternalItems === 'boolean' &&
+        typeof obj.canUpdateStatus === 'boolean');
+}
+/**
+ * Migrate old syncDirection to new SyncSettings
+ *
+ * @param syncDirection - Old syncDirection value ('bidirectional' | 'export' | 'import' | 'to-external' | 'from-external' | undefined)
+ * @returns SyncSettings with appropriate permissions
+ */
+export function migrateSyncDirection(syncDirection) {
+    if (syncDirection === 'bidirectional') {
+        // Old bidirectional mode → enable all permissions
+        return {
+            canUpsertInternalItems: true,
+            canUpdateExternalItems: true,
+            canUpdateStatus: true,
+        };
+    }
+    if (syncDirection === 'export' || syncDirection === 'to-external') {
+        // Old export-only mode → create/update internal items only
+        return {
+            canUpsertInternalItems: true,
+            canUpdateExternalItems: false,
+            canUpdateStatus: false,
+        };
+    }
+    if (syncDirection === 'import' || syncDirection === 'from-external') {
+        // Old import-only mode → status updates only
+        return {
+            canUpsertInternalItems: false,
+            canUpdateExternalItems: false,
+            canUpdateStatus: true,
+        };
+    }
+    // Old one-way or missing or unknown → disable all (safer default)
+    return { ...DEFAULT_SYNC_SETTINGS };
+}
+/**
+ * Validate SyncSettings object
+ *
+ * @param settings - Settings to validate
+ * @throws Error if settings are invalid
+ */
+export function validateSyncSettings(settings) {
+    if (!settings || typeof settings !== 'object') {
+        throw new Error('SyncSettings must be a non-null object');
+    }
+    if (typeof settings.canUpsertInternalItems !== 'boolean') {
+        throw new Error('SyncSettings.canUpsertInternalItems must be a boolean (required)');
+    }
+    if (typeof settings.canUpdateExternalItems !== 'boolean') {
+        throw new Error('SyncSettings.canUpdateExternalItems must be a boolean (required)');
+    }
+    if (typeof settings.canUpdateStatus !== 'boolean') {
+        throw new Error('SyncSettings.canUpdateStatus must be a boolean (required)');
+    }
+}
+/**
+ * Merge user-provided settings with defaults (fill in missing fields)
+ */
+export function mergeSyncSettings(userSettings) {
+    return {
+        ...DEFAULT_SYNC_SETTINGS,
+        ...userSettings,
+    };
+}
+//# sourceMappingURL=sync-settings.js.map

package/dist/src/core/types/sync-settings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-settings.js","sourceRoot":"","sources":["../../../../src/core/types/sync-settings.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AA2CH;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IACjD,sBAAsB,EAAE,KAAK;IAC7B,sBAAsB,EAAE,KAAK;IAC7B,eAAe,EAAE,KAAK;CACvB,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAQ;IAC1C,OAAO,CACL,OAAO,GAAG,KAAK,QAAQ;QACvB,GAAG,KAAK,IAAI;QACZ,OAAO,GAAG,CAAC,sBAAsB,KAAK,SAAS;QAC/C,OAAO,GAAG,CAAC,sBAAsB,KAAK,SAAS;QAC/C,OAAO,GAAG,CAAC,eAAe,KAAK,SAAS,CACzC,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,aAA6B;IAChE,IAAI,aAAa,KAAK,eAAe,EAAE,CAAC;QACtC,kDAAkD;QAClD,OAAO;YACL,sBAAsB,EAAE,IAAI;YAC5B,sBAAsB,EAAE,IAAI;YAC5B,eAAe,EAAE,IAAI;SACtB,CAAC;IACJ,CAAC;IAED,IAAI,aAAa,KAAK,QAAQ,IAAI,aAAa,KAAK,aAAa,EAAE,CAAC;QAClE,2DAA2D;QAC3D,OAAO;YACL,sBAAsB,EAAE,IAAI;YAC5B,sBAAsB,EAAE,KAAK;YAC7B,eAAe,EAAE,KAAK;SACvB,CAAC;IACJ,CAAC;IAED,IAAI,aAAa,KAAK,QAAQ,IAAI,aAAa,KAAK,eAAe,EAAE,CAAC;QACpE,6CAA6C;QAC7C,OAAO;YACL,sBAAsB,EAAE,KAAK;YAC7B,sBAAsB,EAAE,KAAK;YAC7B,eAAe,EAAE,IAAI;SACtB,CAAC;IACJ,CAAC;IAED,kEAAkE;IAClE,OAAO,EAAE,GAAG,qBAAqB,EAAE,CAAC;AACtC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAAC,QAAsB;IACzD,IAAI,CAAC,QAAQ,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC9C,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,OAAO,QAAQ,CAAC,sBAAsB,KAAK,SAAS,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IAED,IAAI,OAAO,QAAQ,CAAC,sBAAsB,KAAK,SAAS,EAAE,CAAC;QACzD,MAAM,IAAI,KAAK,CAAC,kEAAkE,CAAC,CAAC;IACtF,CAAC;IAED,IAAI,OAAO,QAAQ,CAAC,eAAe,KAAK,SAAS,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IAC/E,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,YAA+C;IAE/C,OAAO;QACL,GAAG,qBAAqB;QACxB,GAAG,YAAY;KAChB,CAAC;AACJ,CAAC"}