goal.yaml

# goal.yaml - Goal configuration file
# Generated: 2026-02-15 19:12:27
# Documentation: https://github.com/wronai/goal#configuration
#
# This file configures Goal's behavior for:
# - Version management (semver/calver)
# - Commit message generation
# - Changelog updates
# - Build/test/publish strategies
# - Registry authentication
#
# Edit this file to customize Goal's behavior for your project.

version: '1.0'
project:
  name: prellm
  type:
  - python
  description: Lightweight LLM prompt middleware — bias detection, standardization,
    and DevOps process chains via YAML config
versioning:
  strategy: semver
  files:
  - VERSION
  - pyproject.toml:version
  - prellm/__init__.py:__version__
  bump_rules:
    patch: 10
    minor: 50
    major: 200
git:
  commit:
    strategy: conventional
    scope: gllm
    abstraction_level: auto
    abstraction_levels:
      high: '{type}({domain}): {benefit}'
      medium: '{type}({domain}): {action} {entities}'
      low: '{type}({domain}): update {file_count} files (+{added}/-{deleted})'
    domain_mapping:
      goal/*.py: core
      src/*.py: core
      lib/*.py: core
      app/*.py: app
      api/*.py: api
      docs/*: docs
      tests/*: test
      test/*: test
      '*.md': docs
      '*.rst': docs
      pyproject.toml: build
      setup.py: build
      setup.cfg: build
      package.json: build
      Cargo.toml: build
      goal.yaml: config
      .github/*: ci
      .gitlab-ci.yml: ci
      Dockerfile: docker
      docker-compose.yml: docker
    benefit_keywords:
      config: better configuration management
      cli: improved CLI experience
      api: enhanced API functionality
      test: improved test coverage
      docs: better documentation
      auth: enhanced security
      perf: improved performance
      refactor: cleaner code architecture
      fix: resolved issues
      feat: new functionality
    templates:
      feat:
        high: 'feat({domain}): {benefit}'
        medium: 'feat({domain}): add {entities}'
        low: 'feat({domain}): add {file_count} files (+{added}/-{deleted})'
      fix:
        high: 'fix({domain}): {benefit}'
        medium: 'fix({domain}): resolve {entities}'
        low: 'fix({domain}): update {file_count} files (+{added}/-{deleted})'
      docs:
        high: 'docs({domain}): {benefit}'
        medium: 'docs({domain}): document {entities}'
        low: 'docs({domain}): update {file_count} files'
      refactor:
        high: 'refactor({domain}): {benefit}'
        medium: 'refactor({domain}): restructure {entities}'
        low: 'refactor({domain}): update {file_count} files'
      test:
        high: 'test({domain}): {benefit}'
        medium: 'test({domain}): add tests for {entities}'
        low: 'test({domain}): update {file_count} files'
      build:
        high: 'build({domain}): {benefit}'
        medium: 'build({domain}): configure {entities}'
        low: 'build({domain}): update {file_count} files'
      chore:
        high: 'chore({domain}): {benefit}'
        medium: 'chore({domain}): update {entities}'
        low: 'chore({domain}): update {file_count} files'
      style:
        high: 'style({domain}): {benefit}'
        medium: 'style({domain}): format {entities}'
        low: 'style({domain}): update {file_count} files'
      perf:
        high: 'perf({domain}): {benefit}'
        medium: 'perf({domain}): optimize {entities}'
        low: 'perf({domain}): update {file_count} files'
    classify_by:
    - file_extensions
    - directory_paths
    - line_stats
    - keywords_diff
    - code_entities
    value_patterns:
      configuration:
        signatures:
        - config
        - yaml
        - toml
        - settings
        - options
        impact: better configuration management
        changelog_section: core
      cli:
        signatures:
        - click.
        - '@click'
        - command
        - option
        - argparse
        impact: improved CLI experience
        changelog_section: core
      api:
        signatures:
        - endpoint
        - route
        - request
        - response
        - handler
        impact: enhanced API functionality
        changelog_section: core
      testing:
        signatures:
        - test_
        - assert
        - mock
        - fixture
        - pytest
        impact: improved test coverage
        changelog_section: test
      documentation:
        paths:
        - docs/*
        - '*.md'
        - README*
        impact: comprehensive documentation
        changelog_section: docs
      performance:
        signatures:
        - cache
        - async
        - parallel
        - optimize
        - speed
        impact: performance improvements
        changelog_section: core
      security:
        signatures:
        - auth
        - token
        - permission
        - encrypt
        - secure
        impact: security enhancements
        changelog_section: core
      formatting:
        signatures:
        - format
        - render
        - template
        - markdown
        - output
        impact: improved output formatting
        changelog_section: core
    relations:
      config → cli: configuration-driven CLI
      config → core: configurable core logic
      test → core: better test coverage
      docs → core: improved documentation
  changelog:
    enabled: true
    template: keep-a-changelog
    output: CHANGELOG.md
    sections:
    - Added
    - Changed
    - Fixed
    - Deprecated
    - Removed
    - Security
    group_by_domain: true
    domain_sections:
      core:
      - feat
      - fix
      - refactor
      - perf
      docs:
      - docs
      test:
      - test
      build:
      - build
      - chore
      ci:
      - ci
    include_entities: true
    max_entities_per_entry: 5
  tag:
    enabled: true
    prefix: v
    format: '{prefix}{version}'
strategies:
  python:
    test: poetry run python -m pytest tests/ -v
    build: python -m build
    publish: twine upload dist/prellm-{version}*
    dependencies:
      file: requirements.txt
      lock: pip freeze > requirements.txt
  nodejs:
    test: npm test
    build: npm run build
    publish: twine upload dist/prellm-{version}*
    dependencies:
      file: package-lock.json
      lock: npm install
  rust:
    test: cargo test
    build: cargo build --release
    publish: twine upload dist/prellm-{version}*
    dependencies:
      file: Cargo.lock
      lock: cargo update
registries:
  pypi:
    url: https://pypi.org/simple/
    token_env: PYPI_TOKEN
  npm:
    url: https://registry.npmjs.org/
    token_env: NPM_TOKEN
hooks:
  pre_commit: ''
  post_commit: ''
  pre_push: ''
  post_push: ''
advanced:
  auto_update_config: true
  performance:
    max_files: 50
    timeout_test: 300
quality:
  skip:
    - PY009
  commit_summary:
    min_value_words: 3
    max_generic_terms: 0
    required_metrics: 2
    relation_threshold: 0.7
    generic_terms:
    - update
    - improve
    - enhance
    - fix
    - change
    - modify
    - cleaner
    - better
    - refactor
    - misc
  enhanced_summary:
    enabled: true
    min_capabilities: 1
    min_value_score: 50
    include_metrics: true
    include_relations: true
    include_roles: true
  gates:
    max_complexity_percent: 200
    max_duplicate_relations: 0
    min_unique_files_ratio: 0.8
    min_capabilities: 1
    max_banned_words: 0
  role_patterns:
    _analyze_(python|js|generic)_diff: language-specific code analyzer
    CodeChangeAnalyzer: AST-based change detector
    analyze_file_diff: diff analysis engine
    generate_functional_summary: business value summarizer
    generate.*message: commit message generator
    EnhancedSummaryGenerator: enterprise changelog generator
    GoalConfig: configuration manager
    '@click\\.command': CLI command
    '@click\\.option': CLI option
    format_.*result: output formatter
    _calculate_complexity: complexity analyzer
  value_patterns:
    ast_analysis:
      signatures:
      - ast.parse
      - ast.walk
      - libcst
      - tree-sitter
      - AST
      capability: deep code analysis engine
      impact: intelligent change detection
    dependency_graph:
      signatures:
      - networkx
      - relations
      - dependencies
      - graph
      capability: code relationship mapping
      impact: architecture understanding
    quality_metrics:
      signatures:
      - radon
      - cyclomatic
      - complexity
      - coverage
      capability: code quality metrics
      impact: maintainability tracking
    multi_language:
      signatures:
      - _analyze_python
      - _analyze_js
      - language
      - parser
      capability: multi-language support
      impact: universal code analysis
  commit_message:
    min_length: 15
    max_length: 72
    max_entities: 5
    require_type: true
    require_scope: true
  changelog:
    min_entries_per_release: 1
    max_file_lines: 10
    include_commit_hash: true
code_parsers:
  python:
    extract:
    - 'def '
    - 'class '
    - 'async def '
    - '@click.'
    - '@app.'
    - '@router.'
    ignore:
    - 'import '
    - 'from '
    - '#'
    - '"""'
    - ''''''''
    entity_pattern: (?:def|class|async def)\s+(\w+)
  javascript:
    extract:
    - 'function '
    - 'const '
    - 'class '
    - 'export '
    - 'async '
    ignore:
    - 'import '
    - //
    - /*
    - '*/'
    entity_pattern: (?:function|class|const)\s+(\w+)
  typescript:
    extract:
    - 'function '
    - 'const '
    - 'class '
    - 'interface '
    - 'type '
    - 'export '
    ignore:
    - 'import '
    - //
    - /*
    - '*/'
    entity_pattern: (?:function|class|const|interface|type)\s+(\w+)
  rust:
    extract:
    - 'fn '
    - 'struct '
    - 'enum '
    - 'impl '
    - 'pub '
    - 'mod '
    ignore:
    - //
    - /*
    - '*/'
    entity_pattern: (?:fn|struct|enum|impl|mod)\s+(\w+)
  go:
    extract:
    - 'func '
    - 'type '
    - 'struct '
    - 'interface '
    ignore:
    - //
    - /*
    - '*/'
    entity_pattern: (?:func|type)\s+(\w+)
  markdown:
    extract:
    - '# '
    - '## '
    - '### '
    - '#### '
    - '- **'
    ignore:
    - <!--
    - -->
    entity_pattern: ^#+\s+(.+)$