release.config.js

Rama master · réplica de lectura del repositorio original.

/**
 * Semantic Release Configuration
 *
 * Conservative versioning for 0.x development:
 * - fix: → patch (0.1.2 → 0.1.3)
 * - feat: → patch (0.1.2 → 0.1.3) - conservative until 1.0
 * - feat!: or BREAKING CHANGE: → minor (0.1.x → 0.2.0) - not major while 0.x
 * - perf:, refactor: → patch
 * - docs:, chore:, test:, ci: → no release
 *
 * Nothing is committed to master: master's branch rules refuse direct pushes.
 * A release is the tag v<version>, the npm package and the GitHub release;
 * package.json's version on master is not the released version.
 */
export default {
  branches: ['master'],
  repositoryUrl: 'https://github.com/framerslab/agentos',
  tagFormat: 'v${version}',
  plugins: [
    // Analyze commits to determine release type
    ['@semantic-release/commit-analyzer', {
      preset: 'conventionalcommits',
      releaseRules: [
        { type: 'feat', release: 'patch' },      // Conservative: feat = patch until 1.0
        { type: 'fix', release: 'patch' },
        { type: 'perf', release: 'patch' },
        { type: 'refactor', release: 'patch' },
        { type: 'revert', release: 'patch' },
        { breaking: true, release: 'minor' },   // BREAKING = minor while 0.x
        // These don't trigger releases: docs, style, chore, test, ci, build
      ],
      parserOpts: {
        noteKeywords: ['BREAKING CHANGE', 'BREAKING CHANGES', 'BREAKING']
      }
    }],

    // Generate release notes from commits
    ['@semantic-release/release-notes-generator', {
      preset: 'conventionalcommits',
      presetConfig: {
        types: [
          { type: 'feat', section: 'Features' },
          { type: 'fix', section: 'Bug Fixes' },
          { type: 'perf', section: 'Performance' },
          { type: 'refactor', section: 'Code Refactoring' },
          { type: 'revert', section: 'Reverts' },
          { type: 'docs', section: 'Documentation', hidden: true },
          { type: 'chore', section: 'Maintenance', hidden: true },
          { type: 'test', section: 'Tests', hidden: true },
          { type: 'ci', section: 'CI/CD', hidden: true },
          { type: 'build', section: 'Build', hidden: true },
        ]
      },
      // Parser tweaks to keep the changelog clean:
      //   - referenceActions: []  → don't auto-link "closes #N" style refs.
      //     We don't use GitHub issues for closing tickets in commit
      //     messages; the historical parser used to misread hyphenated
      //     words like "high-level" as "hi#level" issue references.
      //   - issuePrefixes: []  → disable the "#N" reference scanner entirely.
      parserOpts: {
        noteKeywords: ['BREAKING CHANGE', 'BREAKING CHANGES', 'BREAKING'],
        referenceActions: [],
        issuePrefixes: [],
      },
      // Writer tweaks: don't silently truncate long commit subjects.
      // The default writer caps `header` at 100 chars and slices mid-word.
      // Leave `transform` to the preset: a writerOpts property replaces the
      // preset's, and the preset's transform is what drops merge commits and
      // the hidden types, gives each section and the breaking-change notes
      // their titles, and adds each commit's 7-character shortHash.
      writerOpts: {
        headerMaxLength: 500,
      },
    }],

    // Publish to npm
    ['@semantic-release/npm', {
      npmPublish: true
    }],

    // Create the GitHub release, with the refreshed test-count badge attached.
    // The README's badge reads the copy shipped in the npm package, through unpkg.
    ['@semantic-release/github', {
      successComment: false,
      failComment: false,
      releasedLabels: false,
      assets: [{ path: '.github/badges/tests.json', name: 'tests.json', label: 'Test count badge' }]
    }]
  ]
};