specweave 0.16.7 → 0.16.11

package/.claude-plugin/marketplace.json

@@ -215,6 +215,28 @@
         "name": "Anton Abyzov",
         "email": "anton@spec-weave.com"
       }
+    },
+    {
+      "name": "specweave-release",
+      "description": "Release management - version alignment, RC workflows, multi-repo coordination, semantic versioning",
+      "source": "./plugins/specweave-release",
+      "category": "development",
+      "version": "1.0.0",
+      "author": {
+        "name": "Anton Abyzov",
+        "email": "anton@spec-weave.com"
+      }
+    },
+    {
+      "name": "specweave-mobile",
+      "description": "React Native & Expo mobile development - environment setup, debugging, performance optimization, native modules, testing, Metro bundler configuration",
+      "source": "./plugins/specweave-mobile",
+      "category": "development",
+      "version": "1.0.0",
+      "author": {
+        "name": "Anton Abyzov",
+        "email": "anton@spec-weave.com"
+      }
     }
   ]
 }

package/CLAUDE.md

@@ -1375,54 +1375,73 @@ specweave/
 | **operations/** | Production ops (How we run) | Runbooks, incidents, performance | `runbook-api.md`, `performance-tuning.md` |
 | **governance/** | Policies (Guardrails) | Security, compliance, coding standards | `security-policy.md`, `coding-standards.md` |
 
-### Multi-Project Organization (v0.8.0+)
+### Multi-Project Organization (v0.8.0+, Flattened v0.16.11+)
 
-**NEW**: Projects folder for multi-team/multi-repo organizations
+**FLATTENED STRUCTURE** (v0.16.11): Simpler, cleaner paths with document-type-first organization
 
 ```
 .specweave/docs/internal/
-├── strategy/              # Cross-project
-├── architecture/          # System-wide ADRs
-├── delivery/              # Cross-project
-├── operations/            # Cross-project
-├── governance/            # Cross-project
+├── strategy/              # Cross-project (unchanged)
+├── architecture/          # System-wide ADRs (unchanged)
+├── delivery/              # Cross-project (unchanged)
+├── operations/            # Cross-project (unchanged)
+├── governance/            # Cross-project (unchanged)
 │
-└── projects/              # 🆕 Multi-project support
-    ├── default/           # Default project (single-project mode)
-    │   ├── specs/         # Living docs specs (feature-level)
-    │   ├── modules/       # Module/component documentation
-    │   ├── team/          # Team playbooks (conventions, workflows)
-    │   ├── architecture/  # Project-specific ADRs
-    │   └── legacy/        # Brownfield imports
-    │
-    ├── web-app/           # Additional projects
-    ├── mobile-app/
-    └── platform-infra/
+├── specs/                 # ✨ FLATTENED: Living docs specs
+│   ├── default/           # Default project (single-project mode)
+│   ├── backend/           # Backend project
+│   ├── frontend/          # Frontend project
+│   └── _parent/           # Parent repository (multi-repo setups)
+│
+├── modules/               # ✨ FLATTENED: Module documentation
+│   ├── default/
+│   ├── backend/
+│   └── frontend/
+│
+├── team/                  # ✨ FLATTENED: Team playbooks
+│   ├── default/
+│   ├── backend/
+│   └── frontend/
+│
+├── project-arch/          # ✨ RENAMED: Project-specific ADRs
+│   ├── backend/           # (Renamed to avoid conflict with top-level architecture/)
+│   └── frontend/
+│
+└── legacy/                # ✨ FLATTENED: Brownfield imports
+    ├── default/
+    └── backend/
 ```
 
+**Benefits of Flattened Structure**:
+- ✅ Simpler paths (no extra `projects/` nesting)
+- ✅ Consistent with cross-project folders (all at same level)
+- ✅ Clearer parent repo naming (`_parent` for multi-repo)
+- ✅ Easier GitHub sync (shorter paths)
+- ✅ Document-type-first organization (group by specs/, modules/, etc.)
+
 **Five Documentation Types Per Project**:
 
-1. **specs/** - Living documentation specs (user stories, acceptance criteria)
+1. **specs/{project-id}/** - Living documentation specs (user stories, acceptance criteria)
    - Permanent, feature-level knowledge base
    - ALL user stories for a feature area
    - 3-digit numbers: `spec-001-user-auth.md`
 
-2. **modules/** - Module/component documentation
+2. **modules/{project-id}/** - Module/component documentation
    - Architecture, API contracts, integration guides
    - Created when module >1000 lines or has security implications
    - Example: `auth-module.md`, `payment-module.md`
 
-3. **team/** - Team playbooks
+3. **team/{project-id}/** - Team playbooks
    - Onboarding, conventions, workflows, contacts
    - Team-specific processes and practices
    - Example: `onboarding.md`, `conventions.md`, `workflows.md`
 
-4. **architecture/** - Project-specific ADRs (optional)
+4. **project-arch/{project-id}/** - Project-specific ADRs (optional)
    - Decisions affecting only this project
    - Use top-level `architecture/` for system-wide decisions
    - Example: `adr/0001-use-postgres.md`
 
-5. **legacy/** - Brownfield imports (temporary)
+5. **legacy/{project-id}/** - Brownfield imports (temporary)
    - Imported from Notion, Confluence, Wiki
    - Migration report + classified files
    - Clean up after migration complete
@@ -1444,7 +1463,7 @@ specweave/
 
 ### The Core Question: Why Two Locations?
 
-1. **Living Docs Specs**: `.specweave/docs/internal/projects/{project-id}/specs/spec-NNN-feature-area.md` - **Permanent, feature-level knowledge base**
+1. **Living Docs Specs**: `.specweave/docs/internal/specs/{project-id}/spec-NNN-feature-area.md` - **Permanent, feature-level knowledge base**
 2. **Increment Specs**: `.specweave/increments/####-name/spec.md` - **Temporary, focused implementation snapshot**
 
 **Key Difference**: Specs use **3-digit numbers** (001, 002, 003) for **feature areas**, increments use **4-digit numbers** (0001, 0002, 0003) for **implementations**.
@@ -1453,7 +1472,7 @@ specweave/
 
 **Living Docs Specs = Permanent, Feature-Level Knowledge Base**
 
-- **Location**: `.specweave/docs/internal/projects/default/specs/spec-001-core-framework-architecture.md` (single project) or `.specweave/docs/internal/projects/web-app/specs/spec-001-user-auth.md` (multi-project)
+- **Location**: `.specweave/docs/internal/specs/default/spec-001-core-framework-architecture.md` (single project) or `.specweave/docs/internal/specs/web-app/spec-001-user-auth.md` (multi-project)
 - **Purpose**: COMPLETE, PERMANENT source of truth for entire feature area
 - **Lifecycle**: Created once, updated over time, NEVER deleted
 - **Scope**: Comprehensive feature area (e.g., "Core Framework", 10-50 user stories)
@@ -1482,7 +1501,7 @@ specweave/
 
 **Living Docs Spec** (Permanent, Feature-Level):
 ```
-File: .specweave/docs/internal/projects/default/specs/spec-001-core-framework-architecture.md
+File: .specweave/docs/internal/specs/default/spec-001-core-framework-architecture.md
 
 # SPEC-001: Core Framework & Architecture
 Foundation framework with CLI, plugin system, cross-platform support

package/dist/cli/commands/sync-spec-commits.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * CLI command to sync spec commits to external tools
+ *
+ * Called by post-task-completion hooks to post commit/PR comments
+ * to GitHub issues, JIRA epics, and ADO work items.
+ */
+export {};
+//# sourceMappingURL=sync-spec-commits.d.ts.map

package/dist/cli/commands/sync-spec-commits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-spec-commits.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/sync-spec-commits.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}

package/dist/cli/commands/sync-spec-commits.js

@@ -0,0 +1,186 @@
+#!/usr/bin/env node
+/**
+ * CLI command to sync spec commits to external tools
+ *
+ * Called by post-task-completion hooks to post commit/PR comments
+ * to GitHub issues, JIRA epics, and ADO work items.
+ */
+import { program } from 'commander';
+import { syncSpecCommitsToGitHub } from '../../../plugins/specweave-github/lib/github-spec-commit-sync.js';
+import { syncSpecCommitsToJira } from '../../../plugins/specweave-jira/lib/jira-spec-commit-sync.js';
+import { syncSpecCommitsToAdo } from '../../../plugins/specweave-ado/lib/ado-spec-commit-sync.js';
+import { AdoClientV2 } from '../../../plugins/specweave-ado/lib/ado-client-v2.js';
+import path from 'path';
+import fs from 'fs/promises';
+program
+    .name('sync-spec-commits')
+    .description('Sync spec commits to external tools (GitHub, JIRA, ADO)')
+    .option('-i, --increment <path>', 'Path to increment directory')
+    .option('-p, --provider <provider>', 'Provider: github, jira, or ado')
+    .option('--dry-run', 'Dry run (don\'t actually post comments)')
+    .option('-v, --verbose', 'Verbose output')
+    .parse(process.argv);
+const options = program.opts();
+async function main() {
+    const incrementPath = options.increment || detectIncrementPath();
+    if (!incrementPath) {
+        console.error('❌ No increment path specified and could not detect current increment');
+        process.exit(1);
+    }
+    const provider = options.provider || detectProvider(incrementPath);
+    if (!provider) {
+        console.error('❌ No provider specified and could not detect from metadata');
+        process.exit(1);
+    }
+    console.log(`🔗 Syncing commits for ${path.basename(incrementPath)} to ${provider}...`);
+    try {
+        switch (provider) {
+            case 'github':
+                await syncGitHub(incrementPath, options);
+                break;
+            case 'jira':
+                await syncJira(incrementPath, options);
+                break;
+            case 'ado':
+                await syncAdo(incrementPath, options);
+                break;
+            default:
+                console.error(`❌ Unknown provider: ${provider}`);
+                process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error(`❌ Error syncing commits: ${error.message}`);
+        if (options.verbose) {
+            console.error(error.stack);
+        }
+        process.exit(1);
+    }
+}
+async function syncGitHub(incrementPath, options) {
+    const result = await syncSpecCommitsToGitHub({
+        incrementPath,
+        dryRun: options.dryRun,
+        verbose: options.verbose,
+    });
+    if (result.success) {
+        console.log(`✅ Posted ${result.commentsPosted} comment(s) to GitHub`);
+        if (options.verbose) {
+            console.log(`   Commits: ${result.commits.length}`);
+            console.log(`   User stories: ${result.userStories.length}`);
+        }
+    }
+    else {
+        console.error(`❌ Sync failed: ${result.errors.join(', ')}`);
+        process.exit(1);
+    }
+}
+async function syncJira(incrementPath, options) {
+    // Load JIRA config from environment
+    const config = {
+        domain: process.env.JIRA_DOMAIN || '',
+        email: process.env.JIRA_EMAIL || '',
+        apiToken: process.env.JIRA_API_TOKEN || '',
+        projectKey: process.env.JIRA_PROJECT_KEY || '',
+    };
+    if (!config.domain || !config.email || !config.apiToken || !config.projectKey) {
+        console.error('❌ JIRA credentials not found in environment');
+        console.error('   Required: JIRA_DOMAIN, JIRA_EMAIL, JIRA_API_TOKEN, JIRA_PROJECT_KEY');
+        process.exit(1);
+    }
+    const result = await syncSpecCommitsToJira(config, {
+        incrementPath,
+        dryRun: options.dryRun,
+        verbose: options.verbose,
+    });
+    if (result.success) {
+        console.log(`✅ Posted ${result.commentsPosted} comment(s) to JIRA`);
+        if (options.verbose) {
+            console.log(`   Commits: ${result.commits.length}`);
+            console.log(`   User stories: ${result.userStories.length}`);
+        }
+    }
+    else {
+        console.error(`❌ Sync failed: ${result.errors.join(', ')}`);
+        process.exit(1);
+    }
+}
+async function syncAdo(incrementPath, options) {
+    // Load ADO config from .specweave/config.json
+    const projectRoot = incrementPath.split('.specweave')[0];
+    const configPath = path.join(projectRoot, '.specweave', 'config.json');
+    let config;
+    try {
+        config = JSON.parse(await fs.readFile(configPath, 'utf-8'));
+    }
+    catch {
+        console.error('❌ Could not load .specweave/config.json');
+        process.exit(1);
+    }
+    const adoProfile = config.sync?.profiles?.[config.sync?.activeProfile];
+    if (!adoProfile || adoProfile.provider !== 'ado') {
+        console.error('❌ No ADO sync profile found in config');
+        process.exit(1);
+    }
+    const personalAccessToken = process.env.AZURE_DEVOPS_PAT || '';
+    if (!personalAccessToken) {
+        console.error('❌ AZURE_DEVOPS_PAT environment variable not set');
+        process.exit(1);
+    }
+    const client = new AdoClientV2(adoProfile, personalAccessToken);
+    const result = await syncSpecCommitsToAdo(client, {
+        incrementPath,
+        dryRun: options.dryRun,
+        verbose: options.verbose,
+    });
+    if (result.success) {
+        console.log(`✅ Posted ${result.commentsPosted} comment(s) to ADO`);
+        if (options.verbose) {
+            console.log(`   Commits: ${result.commits.length}`);
+            console.log(`   User stories: ${result.userStories.length}`);
+        }
+    }
+    else {
+        console.error(`❌ Sync failed: ${result.errors.join(', ')}`);
+        process.exit(1);
+    }
+}
+function detectIncrementPath() {
+    // Try to find most recent increment
+    const incrementsDir = path.join(process.cwd(), '.specweave', 'increments');
+    try {
+        const files = require('fs').readdirSync(incrementsDir);
+        const increments = files
+            .filter((f) => f.match(/^\d{4}-/))
+            .sort()
+            .reverse();
+        if (increments.length > 0) {
+            return path.join(incrementsDir, increments[0]);
+        }
+    }
+    catch {
+        // Directory doesn't exist or can't read
+    }
+    return null;
+}
+function detectProvider(incrementPath) {
+    try {
+        const metadataPath = path.join(incrementPath, 'metadata.json');
+        const metadata = JSON.parse(require('fs').readFileSync(metadataPath, 'utf-8'));
+        if (metadata.github?.issue)
+            return 'github';
+        if (metadata.jira?.issueKey)
+            return 'jira';
+        if (metadata.ado?.workItemId)
+            return 'ado';
+    }
+    catch {
+        // Metadata not found or invalid
+    }
+    return null;
+}
+main().catch((error) => {
+    console.error('❌ Fatal error:', error.message);
+    process.exit(1);
+});
+//# sourceMappingURL=sync-spec-commits.js.map

package/dist/cli/commands/sync-spec-commits.js.map

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

package/dist/core/agent-model-manager.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Agent Model Manager
+ *
+ * Loads and manages agent model preferences from AGENT.md frontmatter.
+ * Each agent declares:
+ * - model_preference: sonnet | haiku | opus | auto
+ * - cost_profile: planning | execution | hybrid
+ * - fallback_behavior: strict | flexible | auto
+ *
+ * Planning agents (PM, Architect, Security) prefer Sonnet.
+ * Execution agents (Frontend, Backend, DevOps) prefer Haiku.
+ * Hybrid agents (Diagrams, Docs) use auto (context-dependent).
+ */
+import type { AgentModelPreference, Model, CostProfile, FallbackBehavior } from '../types/model-selection';
+export declare class AgentModelManager {
+    private preferences;
+    private agentsPath;
+    constructor(agentsPath?: string);
+    /**
+     * Load all agent preferences from src/agents/
+     */
+    loadAllPreferences(): Promise<void>;
+    /**
+     * Load preference for a specific agent
+     */
+    loadAgentPreference(agentName: string): Promise<AgentModelPreference | null>;
+    /**
+     * Extract YAML frontmatter from markdown content
+     */
+    private extractFrontmatter;
+    /**
+     * Get preferred model for an agent (returns 'auto' if not found)
+     */
+    getPreferredModel(agentName: string): Model;
+    /**
+     * Get cost profile for an agent (returns 'hybrid' if not found)
+     */
+    getCostProfile(agentName: string): CostProfile;
+    /**
+     * Get fallback behavior for an agent
+     */
+    getFallbackBehavior(agentName: string): FallbackBehavior;
+    /**
+     * Get all loaded preferences (for debugging/reporting)
+     */
+    getAllPreferences(): Map<string, AgentModelPreference>;
+    /**
+     * Check if an agent has explicit preference (not 'auto')
+     */
+    hasExplicitPreference(agentName: string): boolean;
+}
+//# sourceMappingURL=agent-model-manager.d.ts.map

package/dist/core/agent-model-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-model-manager.d.ts","sourceRoot":"","sources":["../../src/core/agent-model-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE3G,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,WAAW,CAAgD;IACnE,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,CAAC,EAAE,MAAM;IAK/B;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBzC;;OAEG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IA2BlF;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK;IAK3C;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW;IAK9C;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB;IAKxD;;OAEG;IACH,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAItD;;OAEG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAIlD"}

package/dist/core/agent-model-manager.js

@@ -0,0 +1,120 @@
+/**
+ * Agent Model Manager
+ *
+ * Loads and manages agent model preferences from AGENT.md frontmatter.
+ * Each agent declares:
+ * - model_preference: sonnet | haiku | opus | auto
+ * - cost_profile: planning | execution | hybrid
+ * - fallback_behavior: strict | flexible | auto
+ *
+ * Planning agents (PM, Architect, Security) prefer Sonnet.
+ * Execution agents (Frontend, Backend, DevOps) prefer Haiku.
+ * Hybrid agents (Diagrams, Docs) use auto (context-dependent).
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import yaml from 'js-yaml';
+export class AgentModelManager {
+    constructor(agentsPath) {
+        this.preferences = new Map();
+        // Default to src/agents (works in development and after build)
+        this.agentsPath = agentsPath || path.join(__dirname, '../agents');
+    }
+    /**
+     * Load all agent preferences from src/agents/
+     */
+    async loadAllPreferences() {
+        try {
+            const agentDirs = await fs.readdir(this.agentsPath);
+            for (const agentDir of agentDirs) {
+                const agentMdPath = path.join(this.agentsPath, agentDir, 'AGENT.md');
+                if (await fs.pathExists(agentMdPath)) {
+                    const preference = await this.loadAgentPreference(agentDir);
+                    if (preference) {
+                        this.preferences.set(agentDir, preference);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.warn('Failed to load agent preferences:', error);
+            // Continue with empty preferences (fallback to defaults)
+        }
+    }
+    /**
+     * Load preference for a specific agent
+     */
+    async loadAgentPreference(agentName) {
+        const agentMdPath = path.join(this.agentsPath, agentName, 'AGENT.md');
+        if (!await fs.pathExists(agentMdPath)) {
+            return null;
+        }
+        try {
+            const content = await fs.readFile(agentMdPath, 'utf-8');
+            const frontmatter = this.extractFrontmatter(content);
+            if (!frontmatter) {
+                return null;
+            }
+            return {
+                agent: agentName,
+                preference: frontmatter.model_preference || 'auto',
+                profile: frontmatter.cost_profile || 'hybrid',
+                fallback: frontmatter.fallback_behavior || 'auto',
+            };
+        }
+        catch (error) {
+            console.warn(`Failed to load preference for agent ${agentName}:`, error);
+            return null;
+        }
+    }
+    /**
+     * Extract YAML frontmatter from markdown content
+     */
+    extractFrontmatter(content) {
+        const match = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!match)
+            return null;
+        try {
+            return yaml.load(match[1]);
+        }
+        catch (error) {
+            console.error('Failed to parse YAML frontmatter:', error);
+            return null;
+        }
+    }
+    /**
+     * Get preferred model for an agent (returns 'auto' if not found)
+     */
+    getPreferredModel(agentName) {
+        const preference = this.preferences.get(agentName);
+        return preference?.preference || 'auto';
+    }
+    /**
+     * Get cost profile for an agent (returns 'hybrid' if not found)
+     */
+    getCostProfile(agentName) {
+        const preference = this.preferences.get(agentName);
+        return preference?.profile || 'hybrid';
+    }
+    /**
+     * Get fallback behavior for an agent
+     */
+    getFallbackBehavior(agentName) {
+        const preference = this.preferences.get(agentName);
+        return preference?.fallback || 'auto';
+    }
+    /**
+     * Get all loaded preferences (for debugging/reporting)
+     */
+    getAllPreferences() {
+        return new Map(this.preferences);
+    }
+    /**
+     * Check if an agent has explicit preference (not 'auto')
+     */
+    hasExplicitPreference(agentName) {
+        const pref = this.getPreferredModel(agentName);
+        return pref !== 'auto';
+    }
+}
+//# sourceMappingURL=agent-model-manager.js.map

package/dist/core/agent-model-manager.js.map

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

package/dist/core/comment-builder.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Comment Builder for External Tool Sync
+ *
+ * Generates formatted comments for posting to external tools
+ * (GitHub, JIRA, Azure DevOps) with commit/PR links and summaries.
+ */
+import { GitCommit, GitRepository, PullRequest } from '../utils/git-utils.js';
+import { Task, UserStory } from './spec-task-mapper.js';
+export interface CommentContent {
+    userStory: UserStory;
+    tasks: Task[];
+    commits: GitCommit[];
+    pullRequests: PullRequest[];
+    summary: string;
+}
+export interface FormattedComment {
+    markdown: string;
+    html?: string;
+    plain?: string;
+}
+/**
+ * Build comment for completed user story
+ */
+export declare function buildUserStoryComment(content: CommentContent, repo: GitRepository): FormattedComment;
+/**
+ * Build short summary comment (for quick updates)
+ */
+export declare function buildShortComment(commits: GitCommit[], repo: GitRepository, summary?: string): FormattedComment;
+/**
+ * Build comment for multiple commits (batch update)
+ */
+export declare function buildCommitBatchComment(commits: GitCommit[], repo: GitRepository, groupByDate?: boolean): FormattedComment;
+/**
+ * Build comment for PR merge
+ */
+export declare function buildPRMergeComment(pr: PullRequest, commits: GitCommit[], repo: GitRepository): FormattedComment;
+/**
+ * Generate smart summary from commits
+ */
+export declare function generateSmartSummary(commits: GitCommit[], tasks: Task[]): string;
+/**
+ * Format comment for JIRA (converts markdown to JIRA markup)
+ */
+export declare function formatForJira(comment: FormattedComment): string;
+/**
+ * Format comment for Azure DevOps (HTML)
+ */
+export declare function formatForAdo(comment: FormattedComment): string;
+/**
+ * Validate comment size (some platforms have limits)
+ */
+export declare function validateCommentSize(comment: FormattedComment, maxLength?: number): boolean;
+/**
+ * Truncate comment if too long
+ */
+export declare function truncateComment(comment: FormattedComment, maxLength?: number): FormattedComment;
+//# sourceMappingURL=comment-builder.d.ts.map

package/dist/core/comment-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"comment-builder.d.ts","sourceRoot":"","sources":["../../src/core/comment-builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAC9E,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAExD,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,aAAa,GAClB,gBAAgB,CAwDlB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,EAAE,EACpB,IAAI,EAAE,aAAa,EACnB,OAAO,CAAC,EAAE,MAAM,GACf,gBAAgB,CAsBlB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,SAAS,EAAE,EACpB,IAAI,EAAE,aAAa,EACnB,WAAW,GAAE,OAAc,GAC1B,gBAAgB,CA8ClB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,EAAE,EAAE,WAAW,EACf,OAAO,EAAE,SAAS,EAAE,EACpB,IAAI,EAAE,aAAa,GAClB,gBAAgB,CAyBlB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,EAAE,EACpB,KAAK,EAAE,IAAI,EAAE,GACZ,MAAM,CAoCR;AAaD;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAuB/D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAG9D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,gBAAgB,EACzB,SAAS,GAAE,MAAa,GACvB,OAAO,CAET;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,gBAAgB,EACzB,SAAS,GAAE,MAAa,GACvB,gBAAgB,CAYlB"}