specweave 0.30.19 → 0.32.2

package/dist/src/core/living-docs/intelligent-analyzer/strategy-generator.js

@@ -0,0 +1,343 @@
+/**
+ * Strategy Generator
+ *
+ * Extracts strategic insights from codebase analysis:
+ * - Tech debt catalog
+ * - Business domain mapping
+ * - Modernization candidates
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+export async function generateStrategy(repoAnalyses, orgResult, inconsistencyResult, llmProvider, onProgress, log) {
+    log('PHASE F: Strategy Generation');
+    onProgress('strategy', 0, 100, 'Analyzing strategic landscape');
+    // Collect all tech debt
+    onProgress('strategy', 20, 100, 'Cataloging tech debt');
+    const techDebtCatalog = collectTechDebt(repoAnalyses, inconsistencyResult);
+    log('  Collected ' + techDebtCatalog.length + ' tech debt items');
+    // Map business domains
+    onProgress('strategy', 40, 100, 'Mapping business domains');
+    const domainMap = mapBusinessDomains(repoAnalyses, orgResult);
+    log('  Mapped ' + domainMap.length + ' business domains');
+    // Identify modernization candidates
+    onProgress('strategy', 60, 100, 'Identifying modernization candidates');
+    const modernizationCandidates = identifyModernizationCandidates(repoAnalyses, techDebtCatalog);
+    log('  Found ' + modernizationCandidates.length + ' modernization candidates');
+    // Generate recommendations
+    onProgress('strategy', 80, 100, 'Generating recommendations');
+    const recommendations = generateRecommendations(techDebtCatalog, domainMap, modernizationCandidates, orgResult);
+    log('  Generated ' + recommendations.length + ' strategic recommendations');
+    return { techDebtCatalog, domainMap, modernizationCandidates, recommendations };
+}
+function collectTechDebt(analyses, inconsistencyResult) {
+    const debt = [...inconsistencyResult.techDebt];
+    let debtNum = debt.length + 1;
+    for (const [name, analysis] of analyses) {
+        // Check for outdated patterns
+        const outdatedPatterns = analysis.patternsUsed.filter(p => isOutdatedPattern(p.pattern));
+        if (outdatedPatterns.length > 0) {
+            debt.push({
+                id: 'DEBT-' + String(debtNum++).padStart(3, '0'),
+                title: 'Update outdated patterns in ' + name,
+                description: 'Found ' + outdatedPatterns.length + ' outdated patterns: ' +
+                    outdatedPatterns.map(p => p.pattern).join(', '),
+                severity: 'medium',
+                effort: 'medium',
+                repos: [name],
+                category: 'legacy',
+            });
+        }
+        // Check for missing tests (heuristic: no test files in sample)
+        if (analysis.filesAnalyzed < 5 && analysis.confidence === 'low') {
+            debt.push({
+                id: 'DEBT-' + String(debtNum++).padStart(3, '0'),
+                title: 'Improve test coverage for ' + name,
+                description: 'Low file count and confidence suggests missing tests',
+                severity: 'medium',
+                effort: 'medium',
+                repos: [name],
+                category: 'missing-tests',
+            });
+        }
+    }
+    return debt;
+}
+function isOutdatedPattern(pattern) {
+    const outdated = [
+        'callback',
+        'jquery',
+        'angular.js',
+        'backbone',
+        'grunt',
+        'bower',
+    ];
+    return outdated.some(o => pattern.toLowerCase().includes(o));
+}
+function mapBusinessDomains(analyses, orgResult) {
+    const domains = [];
+    // Use organization domains if available
+    for (const domain of orgResult.domains) {
+        const repoAnalysesList = domain.repos
+            .map(r => analyses.get(r))
+            .filter((a) => a !== undefined);
+        const avgConfidence = repoAnalysesList.length > 0
+            ? repoAnalysesList.reduce((sum, a) => sum + (a.confidence === 'high' ? 100 : a.confidence === 'medium' ? 70 : 40), 0) / repoAnalysesList.length
+            : 50;
+        const concerns = [];
+        if (avgConfidence < 60)
+            concerns.push('Low documentation quality');
+        if (repoAnalysesList.some(a => a.filesAnalyzed < 3))
+            concerns.push('Some repos poorly structured');
+        domains.push({
+            domain: domain.name,
+            description: domain.description,
+            repos: domain.repos,
+            healthScore: Math.round(avgConfidence),
+            concerns,
+        });
+    }
+    // If no domains from org, create from key concepts
+    if (domains.length === 0) {
+        const conceptGroups = new Map();
+        for (const [name, analysis] of analyses) {
+            for (const concept of analysis.keyConcepts.slice(0, 3)) {
+                const normalized = concept.toLowerCase();
+                if (!conceptGroups.has(normalized)) {
+                    conceptGroups.set(normalized, []);
+                }
+                conceptGroups.get(normalized).push(name);
+            }
+        }
+        for (const [concept, repos] of conceptGroups) {
+            if (repos.length >= 2) {
+                domains.push({
+                    domain: concept,
+                    description: 'Repos sharing ' + concept + ' concept',
+                    repos,
+                    healthScore: 70,
+                    concerns: [],
+                });
+            }
+        }
+    }
+    return domains;
+}
+function identifyModernizationCandidates(analyses, techDebt) {
+    const candidates = [];
+    const debtByRepo = new Map();
+    // Count debt items per repo
+    for (const item of techDebt) {
+        for (const repo of item.repos) {
+            debtByRepo.set(repo, (debtByRepo.get(repo) || 0) + 1);
+        }
+    }
+    for (const [name, analysis] of analyses) {
+        const debtCount = debtByRepo.get(name) || 0;
+        const hasLowConfidence = analysis.confidence === 'low';
+        const hasOutdatedPatterns = analysis.patternsUsed.some(p => isOutdatedPattern(p.pattern));
+        const hasFewerFiles = analysis.filesAnalyzed < 5;
+        // Score for modernization need
+        let score = 0;
+        const reasons = [];
+        if (debtCount >= 3) {
+            score += 3;
+            reasons.push('High tech debt (' + debtCount + ' items)');
+        }
+        if (hasLowConfidence) {
+            score += 2;
+            reasons.push('Poor documentation');
+        }
+        if (hasOutdatedPatterns) {
+            score += 2;
+            reasons.push('Outdated patterns');
+        }
+        if (hasFewerFiles) {
+            score += 1;
+            reasons.push('Minimal codebase');
+        }
+        if (score >= 3) {
+            candidates.push({
+                repo: name,
+                reason: reasons.join(', '),
+                priority: score >= 5 ? 'high' : score >= 4 ? 'medium' : 'low',
+                suggestedApproach: suggestApproach(reasons),
+                estimatedEffort: score >= 5 ? 'large' : score >= 4 ? 'medium' : 'small',
+            });
+        }
+    }
+    return candidates.sort((a, b) => {
+        const priorityOrder = { high: 0, medium: 1, low: 2 };
+        return priorityOrder[a.priority] - priorityOrder[b.priority];
+    });
+}
+function suggestApproach(reasons) {
+    if (reasons.some(r => r.includes('Outdated patterns'))) {
+        return 'Incremental migration to modern patterns with feature flags';
+    }
+    if (reasons.some(r => r.includes('Poor documentation'))) {
+        return 'Documentation sprint followed by gradual refactoring';
+    }
+    if (reasons.some(r => r.includes('High tech debt'))) {
+        return 'Dedicated tech debt reduction sprint';
+    }
+    return 'Evaluate for rewrite vs refactor based on business criticality';
+}
+function generateRecommendations(techDebt, domains, candidates, orgResult) {
+    const recommendations = [];
+    let recNum = 1;
+    // High priority modernization
+    const highPriorityCandidates = candidates.filter(c => c.priority === 'high');
+    if (highPriorityCandidates.length > 0) {
+        recommendations.push({
+            id: 'REC-' + String(recNum++).padStart(3, '0'),
+            title: 'Address high-priority modernization candidates',
+            description: highPriorityCandidates.length + ' repositories need immediate attention: ' +
+                highPriorityCandidates.map(c => c.repo).join(', '),
+            impact: 'high',
+            effort: 'large',
+            category: 'architecture',
+        });
+    }
+    // Documentation debt
+    const docDebt = techDebt.filter(d => d.category === 'documentation');
+    if (docDebt.length >= 3) {
+        recommendations.push({
+            id: 'REC-' + String(recNum++).padStart(3, '0'),
+            title: 'Launch documentation improvement initiative',
+            description: docDebt.length + ' repos have documentation issues. ' +
+                'Consider a team-wide doc sprint.',
+            impact: 'medium',
+            effort: 'medium',
+            category: 'process',
+        });
+    }
+    // Domain health
+    const unhealthyDomains = domains.filter(d => d.healthScore < 60);
+    if (unhealthyDomains.length > 0) {
+        recommendations.push({
+            id: 'REC-' + String(recNum++).padStart(3, '0'),
+            title: 'Improve health of critical domains',
+            description: unhealthyDomains.length + ' business domains have low health scores: ' +
+                unhealthyDomains.map(d => d.domain + ' (' + d.healthScore + '%)').join(', '),
+            impact: 'high',
+            effort: 'medium',
+            category: 'architecture',
+        });
+    }
+    // Team ownership
+    if (orgResult.hypotheses.length > 0) {
+        recommendations.push({
+            id: 'REC-' + String(recNum++).padStart(3, '0'),
+            title: 'Clarify team ownership and boundaries',
+            description: 'Organization analysis identified uncertainties: ' +
+                orgResult.hypotheses.slice(0, 2).join('; '),
+            impact: 'medium',
+            effort: 'small',
+            category: 'team',
+        });
+    }
+    // Pattern standardization
+    const patternInconsistencies = techDebt.filter(d => d.description.toLowerCase().includes('pattern'));
+    if (patternInconsistencies.length > 0) {
+        recommendations.push({
+            id: 'REC-' + String(recNum++).padStart(3, '0'),
+            title: 'Standardize development patterns',
+            description: 'Multiple inconsistent patterns detected. ' +
+                'Create and enforce architectural guidelines.',
+            impact: 'medium',
+            effort: 'medium',
+            category: 'tooling',
+        });
+    }
+    return recommendations;
+}
+export async function saveStrategy(projectPath, result) {
+    const savedFiles = [];
+    const strategyPath = path.join(projectPath, '.specweave/docs/internal/strategy');
+    fs.mkdirSync(strategyPath, { recursive: true });
+    // Tech Debt Catalog
+    const debtFile = path.join(strategyPath, 'tech-debt-catalog.md');
+    const debtLines = [
+        '# Tech Debt Catalog',
+        '',
+        '*Auto-generated by Intelligent Analyzer*',
+        '',
+        '## Summary',
+        '',
+        '| Severity | Count |',
+        '|----------|-------|',
+        '| High | ' + result.techDebtCatalog.filter(d => d.severity === 'high').length + ' |',
+        '| Medium | ' + result.techDebtCatalog.filter(d => d.severity === 'medium').length + ' |',
+        '| Low | ' + result.techDebtCatalog.filter(d => d.severity === 'low').length + ' |',
+        '',
+        '## Items',
+        '',
+    ];
+    for (const item of result.techDebtCatalog) {
+        debtLines.push('### ' + item.id + ': ' + item.title, '', item.description, '', '- **Severity**: ' + item.severity, '- **Effort**: ' + item.effort, '- **Category**: ' + item.category, '- **Repos**: ' + item.repos.join(', '), '');
+    }
+    fs.writeFileSync(debtFile, debtLines.join('\n'));
+    savedFiles.push(debtFile);
+    // Domain Map
+    const domainFile = path.join(strategyPath, 'domain-map.md');
+    const domainLines = [
+        '# Business Domain Map',
+        '',
+        '*Auto-generated by Intelligent Analyzer*',
+        '',
+    ];
+    for (const domain of result.domainMap) {
+        domainLines.push('## ' + domain.domain, '', domain.description, '', '- **Health Score**: ' + domain.healthScore + '%', '- **Repos**: ' + domain.repos.join(', '), '');
+        if (domain.concerns.length > 0) {
+            domainLines.push('**Concerns**:', '');
+            for (const concern of domain.concerns) {
+                domainLines.push('- ' + concern);
+            }
+            domainLines.push('');
+        }
+    }
+    fs.writeFileSync(domainFile, domainLines.join('\n'));
+    savedFiles.push(domainFile);
+    // Modernization Candidates
+    if (result.modernizationCandidates.length > 0) {
+        const modernFile = path.join(strategyPath, 'modernization-candidates.md');
+        const modernLines = [
+            '# Modernization Candidates',
+            '',
+            '*Auto-generated by Intelligent Analyzer*',
+            '',
+            '## Priority Summary',
+            '',
+            '| Priority | Count |',
+            '|----------|-------|',
+            '| High | ' + result.modernizationCandidates.filter(c => c.priority === 'high').length + ' |',
+            '| Medium | ' + result.modernizationCandidates.filter(c => c.priority === 'medium').length + ' |',
+            '| Low | ' + result.modernizationCandidates.filter(c => c.priority === 'low').length + ' |',
+            '',
+            '## Candidates',
+            '',
+        ];
+        for (const candidate of result.modernizationCandidates) {
+            modernLines.push('### ' + candidate.repo + ' (' + candidate.priority.toUpperCase() + ')', '', '**Reason**: ' + candidate.reason, '', '**Suggested Approach**: ' + candidate.suggestedApproach, '', '**Estimated Effort**: ' + candidate.estimatedEffort, '');
+        }
+        fs.writeFileSync(modernFile, modernLines.join('\n'));
+        savedFiles.push(modernFile);
+    }
+    // Strategic Recommendations
+    if (result.recommendations.length > 0) {
+        const recFile = path.join(strategyPath, 'recommendations.md');
+        const recLines = [
+            '# Strategic Recommendations',
+            '',
+            '*Auto-generated by Intelligent Analyzer*',
+            '',
+        ];
+        for (const rec of result.recommendations) {
+            recLines.push('## ' + rec.id + ': ' + rec.title, '', rec.description, '', '| Aspect | Value |', '|--------|-------|', '| Impact | ' + rec.impact + ' |', '| Effort | ' + rec.effort + ' |', '| Category | ' + rec.category + ' |', '');
+        }
+        fs.writeFileSync(recFile, recLines.join('\n'));
+        savedFiles.push(recFile);
+    }
+    return savedFiles;
+}
+//# sourceMappingURL=strategy-generator.js.map

package/dist/src/core/living-docs/intelligent-analyzer/strategy-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strategy-generator.js","sourceRoot":"","sources":["../../../../../src/core/living-docs/intelligent-analyzer/strategy-generator.ts"],"names":[],"mappings":"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"}

package/dist/src/core/living-docs/intelligent-analyzer/types.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Intelligent Analyzer Types
+ *
+ * Types for the deep codebase analysis and organization synthesis.
+ */
+/**
+ * Analysis checkpoint for resume support
+ */
+export interface IntelligentAnalysisCheckpoint {
+    phase: 'A' | 'B' | 'C' | 'D' | 'E' | 'F';
+    reposTotal: number;
+    reposCompleted: string[];
+    repoInProgress: string | null;
+    discoveryComplete: boolean;
+    deepAnalysisComplete: boolean;
+    clusteringComplete: boolean;
+    architectureComplete: boolean;
+    inconsistenciesComplete: boolean;
+    strategyComplete: boolean;
+    startedAt: string;
+    lastActivityAt: string;
+    estimatedCompletion: string | null;
+}
+/**
+ * Deep analysis result for a single repo
+ */
+export interface RepoAnalysis {
+    name: string;
+    path: string;
+    purpose: string;
+    keyConcepts: string[];
+    mainApis: ApiSurface[];
+    patternsUsed: PatternUsage[];
+    internalDependencies: string[];
+    externalDependencies: string[];
+    filesAnalyzed: number;
+    confidence: 'high' | 'medium' | 'low';
+    analyzedAt: string;
+    observations: string[];
+}
+/**
+ * API surface detected in a repo
+ */
+export interface ApiSurface {
+    name: string;
+    type: 'class' | 'function' | 'interface' | 'endpoint' | 'event';
+    description: string;
+    location: string;
+}
+/**
+ * Pattern usage detected in code
+ */
+export interface PatternUsage {
+    pattern: string;
+    category: 'auth' | 'api' | 'data' | 'messaging' | 'architecture' | 'other';
+    evidence: string[];
+    confidence: 'high' | 'medium' | 'low';
+}
+/**
+ * Organization cluster (team, service, or domain)
+ */
+export interface OrganizationCluster {
+    name: string;
+    type: 'team' | 'microservice' | 'domain';
+    description: string;
+    repos: string[];
+    confidence: 'high' | 'medium' | 'low';
+    reasoning: string;
+}
+/**
+ * Detected architectural decision
+ */
+export interface DetectedADR {
+    id: string;
+    title: string;
+    pattern: string;
+    status: 'Detected';
+    context: string;
+    decision: string;
+    consequences: string[];
+    evidence: ADREvidence[];
+    confidence: 'high' | 'medium' | 'low';
+}
+/**
+ * Evidence for a detected ADR
+ */
+export interface ADREvidence {
+    repo: string;
+    files: string[];
+    description: string;
+}
+/**
+ * Inconsistency or question found
+ */
+export interface DetectedIssue {
+    id: string;
+    type: 'inconsistency' | 'duplicate' | 'ownership' | 'security' | 'question';
+    severity: 'critical' | 'important' | 'minor';
+    title: string;
+    description: string;
+    evidence: IssueEvidence[];
+    suggestedAction: string;
+    targetAudience: 'cto' | 'po' | 'team' | 'anyone';
+}
+/**
+ * Evidence for a detected issue
+ */
+export interface IssueEvidence {
+    repo: string;
+    files: string[];
+    details: string;
+}
+/**
+ * Tech debt item
+ */
+export interface TechDebtItem {
+    id: string;
+    title: string;
+    description: string;
+    severity: 'high' | 'medium' | 'low';
+    effort: 'small' | 'medium' | 'large';
+    repos: string[];
+    category: 'legacy' | 'duplication' | 'missing-tests' | 'outdated-deps' | 'documentation' | 'other';
+}
+/**
+ * File sample for LLM analysis
+ */
+export interface FileSample {
+    path: string;
+    content: string;
+    type: 'readme' | 'config' | 'entry' | 'api' | 'model' | 'other';
+    truncated: boolean;
+}
+/**
+ * LLM provider interface (simplified)
+ */
+export interface LLMProvider {
+    analyze(prompt: string): Promise<{
+        content: string;
+    }>;
+}
+/**
+ * Progress callback for long-running operations
+ */
+export type ProgressCallback = (phase: string, current: number, total: number, message: string) => void;
+//# sourceMappingURL=types.d.ts.map

package/dist/src/core/living-docs/intelligent-analyzer/types.d.ts.map

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

package/dist/src/core/living-docs/intelligent-analyzer/types.js

@@ -0,0 +1,7 @@
+/**
+ * Intelligent Analyzer Types
+ *
+ * Types for the deep codebase analysis and organization synthesis.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/core/living-docs/intelligent-analyzer/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/core/living-docs/intelligent-analyzer/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/src/core/living-docs/living-docs-sync.d.ts

@@ -191,6 +191,11 @@ export declare class LivingDocsSync {
      * AC-US5-02: When GitHub configured, trigger GitHub sync
      * AC-US5-03: When no external tools configured, skip
      * AC-US5-05: External tool failures don't break living docs sync
+     *
+     * v0.32.2+ (AC-US3-01 to AC-US3-05): Permission checks before syncing
+     * - canUpsertInternalItems: Required for creating issues from SpecWeave increments
+     * - canUpdateExternalItems: Required for updating externally-imported items
+     * - canUpdateStatus: Required for updating issue status (open/closed)
      */
     private syncToExternalTools;
     /**

package/dist/src/core/living-docs/living-docs-sync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"living-docs-sync.d.ts","sourceRoot":"","sources":["../../../../src/core/living-docs/living-docs-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AASH,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAO9D,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,aAAa,EACb,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAoBpB,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,uBAAuB,EAAE,CAAC;AAE5F,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;gBAEd,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO;IASlE;;;;;;;OAOG;IACH,YAAY,IAAI,MAAM;IAItB;;;;;OAKG;YACW,mBAAmB;IASjC;;OAEG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IA8JxF;;;;;;;;;;;;;;;;;;;;;;OAsBG;YACW,wBAAwB;IAkDtC;;;;;;;;;OASG;IACH,OAAO,CAAC,8BAA8B;IA+BtC;;;;;;;;;;;;;OAaG;YACW,2BAA2B;IAkEzC;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IA6BhC;;OAEG;YACW,sBAAsB;IAKpC;;;;;;;;;;;;;;OAcG;YACW,kBAAkB;IA6GhC;;OAEG;YACW,uBAAuB;IAcrC;;OAEG;YACW,wBAAwB;IAmFtC;;;OAGG;YACW,sBAAsB;IAqGpC;;OAEG;YACW,iBAAiB;IA0C/B;;;;;;;;;;;OAWG;YACW,oBAAoB;IAwClC;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,iBAAiB;IAwCzB;;OAEG;YACW,kBAAkB;IAmHhC;;;;OAIG;YACW,sBAAsB;IAkCpC;;OAEG;YACW,kBAAkB;IAmChC;;;;;;;OAOG;YACW,mBAAmB;IA8CjC;;;;;;OAMG;IACH;;;;;;;;;;;OAWG;YACW,mBAAmB;IAyIjC;;;;;;;;;OASG;YACW,YAAY;IA0F1B;;;;;;;;;;;;OAYG;YACW,UAAU;IAyFxB;;;;;;;;;;;;OAYG;YACW,SAAS;IAyFvB;;;;;;;;;OASG;YACW,4BAA4B;CAmB3C"}
+{"version":3,"file":"living-docs-sync.d.ts","sourceRoot":"","sources":["../../../../src/core/living-docs/living-docs-sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AASH,OAAO,EAAE,MAAM,EAAiB,MAAM,uBAAuB,CAAC;AAO9D,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,aAAa,EACb,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAoBpB,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,aAAa,EAAE,uBAAuB,EAAE,CAAC;AAE5F,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAS;gBAEd,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAO;IASlE;;;;;;;OAOG;IACH,YAAY,IAAI,MAAM;IAItB;;;;;OAKG;YACW,mBAAmB;IASjC;;OAEG;IACG,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IA8JxF;;;;;;;;;;;;;;;;;;;;;;OAsBG;YACW,wBAAwB;IAkDtC;;;;;;;;;OASG;IACH,OAAO,CAAC,8BAA8B;IA+BtC;;;;;;;;;;;;;OAaG;YACW,2BAA2B;IAkEzC;;;;OAIG;IACH,OAAO,CAAC,wBAAwB;IA6BhC;;OAEG;YACW,sBAAsB;IAKpC;;;;;;;;;;;;;;OAcG;YACW,kBAAkB;IA6GhC;;OAEG;YACW,uBAAuB;IAcrC;;OAEG;YACW,wBAAwB;IAmFtC;;;OAGG;YACW,sBAAsB;IAqGpC;;OAEG;YACW,iBAAiB;IA0C/B;;;;;;;;;;;OAWG;YACW,oBAAoB;IAwClC;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,iBAAiB;IAwCzB;;OAEG;YACW,kBAAkB;IAoHhC;;;;OAIG;YACW,sBAAsB;IAkCpC;;OAEG;YACW,kBAAkB;IAmChC;;;;;;;;;;;;OAYG;YACW,mBAAmB;IA6EjC;;;;;;OAMG;IACH;;;;;;;;;;;OAWG;YACW,mBAAmB;IAyIjC;;;;;;;;;OASG;YACW,YAAY;IA0F1B;;;;;;;;;;;;OAYG;YACW,UAAU;IAyFxB;;;;;;;;;;;;OAYG;YACW,SAAS;IAyFvB;;;;;;;;;OASG;YACW,4BAA4B;CAmB3C"}

package/dist/src/core/living-docs/living-docs-sync.js

@@ -849,7 +849,8 @@ export class LivingDocsSync {
             }
         }
         if (!title) {
-            title = incrementId.replace(/^\d+-/, '').split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ');
+            // Handle both regular (0111-name) and external (0111E-name) increment IDs
+            title = incrementId.replace(/^\d+E?-/, '').split('-').map(w => w.charAt(0).toUpperCase() + w.slice(1)).join(' ');
         }
         // Extract overview
         let overview = '';
@@ -952,6 +953,11 @@ export class LivingDocsSync {
      * AC-US5-02: When GitHub configured, trigger GitHub sync
      * AC-US5-03: When no external tools configured, skip
      * AC-US5-05: External tool failures don't break living docs sync
+     *
+     * v0.32.2+ (AC-US3-01 to AC-US3-05): Permission checks before syncing
+     * - canUpsertInternalItems: Required for creating issues from SpecWeave increments
+     * - canUpdateExternalItems: Required for updating externally-imported items
+     * - canUpdateStatus: Required for updating issue status (open/closed)
      */
     async syncToExternalTools(incrementId, featureId, projectPath) {
         try {
@@ -961,8 +967,36 @@ export class LivingDocsSync {
                 // AC-US5-03: No external tools configured, skip
                 return;
             }
+            // 2. Load sync settings and check permissions (v0.32.2+ AC-US3-01 to AC-US3-05)
+            const configPath = path.join(this.projectRoot, '.specweave/config.json');
+            let syncSettings = {
+                canUpsertInternalItems: false,
+                canUpdateExternalItems: false,
+                canUpdateStatus: false,
+            };
+            if (existsSync(configPath)) {
+                try {
+                    const config = await readJson(configPath);
+                    syncSettings = {
+                        canUpsertInternalItems: config.sync?.settings?.canUpsertInternalItems ?? false,
+                        canUpdateExternalItems: config.sync?.settings?.canUpdateExternalItems ?? false,
+                        canUpdateStatus: config.sync?.settings?.canUpdateStatus ?? false,
+                    };
+                }
+                catch (error) {
+                    this.logger.warn('   ⚠️  Failed to load sync settings, using defaults (disabled)');
+                }
+            }
+            // 3. AC-US3-01: Check canUpsertInternalItems permission for creating issues
+            if (!syncSettings.canUpsertInternalItems) {
+                this.logger.log('   ⚠️  Skipping external sync - canUpsertInternalItems is disabled in config');
+                this.logger.log('   💡 Enable in .specweave/config.json: sync.settings.canUpsertInternalItems: true');
+                return;
+            }
             this.logger.log(`\n📡 Syncing to external tools: ${externalTools.join(', ')}`);
-            // 2. Sync to each configured external tool
+            this.logger.log(`   📋 Permissions: upsert=${syncSettings.canUpsertInternalItems}, ` +
+                `update=${syncSettings.canUpdateExternalItems}, status=${syncSettings.canUpdateStatus}`);
+            // 4. Sync to each configured external tool (passing permissions for granular control)
             for (const tool of externalTools) {
                 try {
                     switch (tool) {