aios-core 2.3.1 → 3.0.0

package/.aios-core/core-config.yaml

@@ -267,6 +267,60 @@ github:
     pr_creation: true
     issue_management: true
 
+  # Pull Request Configuration
+  # Controls how @devops *create-pr generates PR titles and descriptions
+  pr:
+    # Title format options:
+    # - "conventional": Uses Conventional Commits format for semantic-release
+    #   Example: "feat(auth): implement OAuth login [Story 6.17]"
+    # - "story-first": Story ID first (legacy/simple projects)
+    #   Example: "[Story 6.17] Implement OAuth Login"
+    # - "branch-based": Converts branch name to title
+    #   Example: "Feature User Auth"
+    title_format: conventional  # Options: conventional | story-first | branch-based
+
+    # Include story ID in PR title when available
+    include_story_id: true
+
+    # Conventional commits mapping (only used when title_format: conventional)
+    # Maps branch prefixes to commit types
+    conventional_commits:
+      enabled: true
+      branch_type_map:
+        feature/: feat
+        feat/: feat
+        fix/: fix
+        bugfix/: fix
+        hotfix/: fix
+        docs/: docs
+        chore/: chore
+        refactor/: refactor
+        test/: test
+        perf/: perf
+        ci/: ci
+        style/: style
+        build/: build
+      default_type: feat
+
+    # Base branch for PRs (auto-detected if not set)
+    # base_branch: main
+
+    # Auto-assign reviewers based on story type
+    auto_assign_reviewers: false
+
+    # Draft PRs by default
+    draft_by_default: false
+
+  # Semantic Release Integration (Story 6.17)
+  # When enabled, PR titles follow Conventional Commits for automatic releases
+  semantic_release:
+    enabled: true  # Set to false if project doesn't use semantic-release
+    # Release types triggered by commit prefixes:
+    # - feat: → Minor release (2.3.0 → 2.4.0)
+    # - fix: → Patch release (2.3.0 → 2.3.1)
+    # - feat!: or BREAKING CHANGE: → Major release (2.3.0 → 3.0.0)
+    # - docs:, chore:, test:, etc. → No release
+
 # ============================================
 # SECTION 9: CodeRabbit Integration (Story 6.3.3)
 # MASTER TOGGLE: When enabled=false, ALL CodeRabbit behavior is disabled

package/.aios-core/development/tasks/github-devops-github-pr-automation.md

@@ -262,22 +262,209 @@ function extractStoryInfo(storyPath) {
 }
 ```
 
-### Step 4: Generate PR Title
+### Step 4: Generate PR Title (Configurable Format)
+
+> **Configuration-Driven:** PR title format is controlled by `core-config.yaml` → `github.pr.title_format`
+> This allows each project to choose the format that matches their workflow.
 
 ```javascript
+const yaml = require('js-yaml');
+const fs = require('fs');
+const path = require('path');
+
+/**
+ * Load PR configuration from core-config.yaml
+ * @returns {Object} PR configuration with defaults
+ */
+function loadPRConfig() {
+  const configPath = path.join(process.cwd(), '.aios-core', 'core-config.yaml');
+
+  // Default configuration (for projects without core-config)
+  const defaults = {
+    title_format: 'story-first',  // Safe default for most projects
+    include_story_id: true,
+    conventional_commits: {
+      enabled: false,
+      branch_type_map: {
+        'feature/': 'feat',
+        'feat/': 'feat',
+        'fix/': 'fix',
+        'bugfix/': 'fix',
+        'hotfix/': 'fix',
+        'docs/': 'docs',
+        'chore/': 'chore',
+        'refactor/': 'refactor',
+        'test/': 'test',
+        'perf/': 'perf',
+        'ci/': 'ci',
+        'style/': 'style',
+        'build/': 'build'
+      },
+      default_type: 'feat'
+    }
+  };
+
+  try {
+    if (fs.existsSync(configPath)) {
+      const config = yaml.load(fs.readFileSync(configPath, 'utf8'));
+      return { ...defaults, ...config?.github?.pr };
+    }
+  } catch (error) {
+    console.warn('Could not load core-config.yaml, using defaults');
+  }
+
+  return defaults;
+}
+
+/**
+ * Generate PR title based on project configuration.
+ *
+ * Supported formats (configured in core-config.yaml → github.pr.title_format):
+ *
+ * 1. "conventional" - Conventional Commits format (for semantic-release)
+ *    Example: "feat(auth): implement OAuth login [Story 6.17]"
+ *
+ * 2. "story-first" - Story ID first (legacy/simple projects)
+ *    Example: "[Story 6.17] Implement OAuth Login"
+ *
+ * 3. "branch-based" - Branch name converted to title
+ *    Example: "Feature User Auth"
+ *
+ * @param {string} branchName - Current git branch name
+ * @param {Object} storyInfo - Story information (id, title)
+ * @returns {string} Formatted PR title
+ */
 function generatePRTitle(branchName, storyInfo) {
+  const config = loadPRConfig();
+  const format = config.title_format || 'story-first';
+
+  switch (format) {
+    case 'conventional':
+      return generateConventionalTitle(branchName, storyInfo, config);
+    case 'story-first':
+      return generateStoryFirstTitle(branchName, storyInfo, config);
+    case 'branch-based':
+      return generateBranchBasedTitle(branchName, storyInfo, config);
+    default:
+      return generateStoryFirstTitle(branchName, storyInfo, config);
+  }
+}
+
+/**
+ * Format: {type}({scope}): {description} [Story {id}]
+ * Used for: Projects with semantic-release automation
+ */
+function generateConventionalTitle(branchName, storyInfo, config) {
+  const typeMap = config.conventional_commits?.branch_type_map || {};
+  const defaultType = config.conventional_commits?.default_type || 'feat';
+
+  // Detect commit type from branch prefix
+  let type = defaultType;
+  for (const [prefix, commitType] of Object.entries(typeMap)) {
+    if (branchName.startsWith(prefix)) {
+      type = commitType;
+      break;
+    }
+  }
+
+  // Extract scope from branch name (e.g., feat/auth/login -> scope=auth)
+  const scopeMatch = branchName.match(/^[a-z-]+\/([a-z-]+)\//);
+  const scope = scopeMatch ? scopeMatch[1] : null;
+  const scopeStr = scope ? `(${scope})` : '';
+
+  // Generate description
+  if (storyInfo && storyInfo.id && storyInfo.title) {
+    let cleanTitle = storyInfo.title
+      .replace(/^Story\s*\d+\.\d+[:\s-]*/i, '')
+      .trim();
+    cleanTitle = cleanTitle.charAt(0).toLowerCase() + cleanTitle.slice(1);
+
+    const storyRef = config.include_story_id ? ` [Story ${storyInfo.id}]` : '';
+    return `${type}${scopeStr}: ${cleanTitle}${storyRef}`;
+  }
+
+  // Fallback: convert branch name to description
+  const description = branchName
+    .replace(/^(feature|feat|fix|bugfix|hotfix|docs|chore|refactor|test|perf|ci|style|build)\//, '')
+    .replace(/^[a-z-]+\//, '')
+    .replace(/-/g, ' ')
+    .toLowerCase()
+    .trim();
+
+  return `${type}${scopeStr}: ${description}`;
+}
+
+/**
+ * Format: [Story {id}] {Title}
+ * Used for: Simple projects, legacy workflows, non-NPM projects
+ */
+function generateStoryFirstTitle(branchName, storyInfo, config) {
   if (storyInfo && storyInfo.id && storyInfo.title) {
     return `[Story ${storyInfo.id}] ${storyInfo.title}`;
   }
 
   // Fallback: convert branch name to title
   return branchName
-    .replace(/^feature\//, '')
+    .replace(/^(feature|feat|fix|bugfix|hotfix|docs|chore|refactor|test|perf|ci|style|build)\//, '')
     .replace(/-/g, ' ')
     .replace(/\b\w/g, c => c.toUpperCase());
 }
+
+/**
+ * Format: {Branch Name As Title}
+ * Used for: Minimal projects, quick iterations
+ */
+function generateBranchBasedTitle(branchName, storyInfo, config) {
+  const title = branchName
+    .replace(/^(feature|feat|fix|bugfix|hotfix|docs|chore|refactor|test|perf|ci|style|build)\//, '')
+    .replace(/-/g, ' ')
+    .replace(/\b\w/g, c => c.toUpperCase());
+
+  if (config.include_story_id && storyInfo?.id) {
+    return `${title} [Story ${storyInfo.id}]`;
+  }
+
+  return title;
+}
+```
+
+## Configuration Reference
+
+Add to your project's `core-config.yaml`:
+
+```yaml
+github:
+  pr:
+    # Options: conventional | story-first | branch-based
+    title_format: conventional  # For semantic-release projects
+    # title_format: story-first  # For simple projects (default)
+
+    include_story_id: true
+
+    conventional_commits:
+      enabled: true
+      branch_type_map:
+        feature/: feat
+        fix/: fix
+        docs/: docs
+        # Add custom mappings as needed
+      default_type: feat
+
+  semantic_release:
+    enabled: true  # Set false if not using semantic-release
 ```
 
+## Title Format Examples
+
+| Format | Branch | Story | Generated Title |
+|--------|--------|-------|-----------------|
+| `conventional` | `feature/user-auth` | 6.17: User Auth | `feat: user auth [Story 6.17]` |
+| `conventional` | `fix/cli/parsing` | 6.18: CLI Fix | `fix(cli): cLI fix [Story 6.18]` |
+| `story-first` | `feature/user-auth` | 6.17: User Auth | `[Story 6.17] User Auth` |
+| `story-first` | `fix/cli-bug` | - | `Cli Bug` |
+| `branch-based` | `feature/user-auth` | 6.17 | `User Auth [Story 6.17]` |
+| `branch-based` | `docs/readme` | - | `Readme` |
+
 ### Step 5: Generate PR Description
 
 ```javascript
@@ -415,10 +602,60 @@ Called by `@github-devops` via `*create-pr` command.
 ## Validation
 
 - PR created in correct repository (detected URL)
-- PR title includes story ID if available
+- PR title follows Conventional Commits format (required for semantic-release)
+- PR title includes story ID if available (e.g., `[Story 6.17]`)
 - PR description includes repository context
 - Base branch is correct (usually main/master)
 
+## Semantic-Release Integration (Optional)
+
+> **Note:** This section only applies when `core-config.yaml` has:
+> - `github.pr.title_format: conventional`
+> - `github.semantic_release.enabled: true`
+>
+> Projects without semantic-release should use `title_format: story-first` (default).
+
+**When enabled:** PRs merged via "Squash and merge" use the PR title as commit message, triggering semantic-release:
+
+| Branch Pattern | Generated Title | Release |
+|---------------|-----------------|---------|
+| `feature/user-auth` | `feat: user auth` | ✅ Minor |
+| `feat/auth/sso-login` | `feat(auth): sso login` | ✅ Minor |
+| `fix/cli-parsing` | `fix: cli parsing` | ✅ Patch |
+| `docs/readme-update` | `docs: readme update` | ❌ None |
+| `chore/deps-update` | `chore: deps update` | ❌ None |
+
+For breaking changes, manually edit the PR title to include `!`:
+- `feat!: redesign authentication API [Story 7.1]`
+
+## Configuration for Different Project Types
+
+### NPM Package with Semantic-Release (aios-core)
+```yaml
+github:
+  pr:
+    title_format: conventional
+  semantic_release:
+    enabled: true
+```
+
+### Simple Web App (no releases)
+```yaml
+github:
+  pr:
+    title_format: story-first  # [Story 6.17] Title
+  semantic_release:
+    enabled: false
+```
+
+### Quick Prototypes
+```yaml
+github:
+  pr:
+    title_format: branch-based  # Just branch name as title
+    include_story_id: false
+```
+
 ## Notes
 
 - Works with ANY repository

package/.aios-core/infrastructure/templates/core-config/core-config-greenfield.tmpl.yaml

@@ -88,6 +88,47 @@ deployment:
       staging: ["staging", "needs-review"]
       production: ["production", "promotion"]
 
+# =============================================================================
+# GITHUB INTEGRATION
+# Pull Request and semantic-release configuration
+# =============================================================================
+github:
+  enabled: true
+  cli_required: false
+
+  # Pull Request Configuration
+  # Controls how @devops *create-pr generates PR titles
+  pr:
+    # Title format options:
+    # - "conventional": For semantic-release (feat: description [Story X.Y])
+    # - "story-first": Simple format ([Story X.Y] Description) - DEFAULT
+    # - "branch-based": Just branch name as title
+    title_format: {{PR_TITLE_FORMAT}}
+
+    include_story_id: true
+
+    # Only used when title_format: conventional
+    conventional_commits:
+      enabled: {{CONVENTIONAL_COMMITS_ENABLED}}
+      branch_type_map:
+        feature/: feat
+        feat/: feat
+        fix/: fix
+        bugfix/: fix
+        hotfix/: fix
+        docs/: docs
+        chore/: chore
+        refactor/: refactor
+        test/: test
+      default_type: feat
+
+    auto_assign_reviewers: false
+    draft_by_default: false
+
+  # Semantic Release (only for NPM packages)
+  semantic_release:
+    enabled: {{SEMANTIC_RELEASE_ENABLED}}
+
 # =============================================================================
 # AGENT CONFIGURATION
 # Agent-specific settings

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aios-core",
-  "version": "2.3.1",
+  "version": "3.0.0",
   "description": "Synkra AIOS: AI-Orchestrated System for Full Stack Development - Core Framework",
   "main": "index.js",
   "module": "index.esm.js",