Add interactive prompt for configuration file setup (filters & publishing overrides)

Đang mở
#120 2 bình luận 1 reaction 2 người được giao Xem trên GitHub

@azaslonov đang làm issue này rồi.

Từ ngày 7/7/2026.

Đánh giá

Issue này chưa được đánh giá.

Mô tả

go:needs-research P2 squad squad:apimexpert

Problem

After running apiops init to scaffold the repo and the identity prompt to connect GitHub & Azure, there is no guided experience for setting up configuration files (extraction filters and publishing overrides). Users must manually create and edit these files, which is error-prone and requires deep knowledge of the configuration schema.

Context — Current Onboarding Flow

  1. apiops init — scaffolds the repo structure and CI/CD pipelines
  2. Identity prompt — connects GitHub & Azure (OIDC, service principals, etc.)
  3. First extraction — pulls down the current APIM state into the repo
  4. Missing step — no guided setup for configuration files

Proposed Solution

Add a new interactive prompt (e.g., apiops configure or a post-extraction prompt) that helps users produce well-structured configuration files after their first extraction. The prompt should:

1. Review Extracted Files
  • Scan the extracted APIM artifacts to understand what resources exist (APIs, named values, backends, products, etc.)
  • Identify resources that commonly need per-environment overrides (e.g., named values with secrets, backend URLs, etc.)
2. Generate Filter Configuration
  • Walk the user through which APIs/resources to include or exclude from publishing
  • Produce the appropriate filter/extraction configuration file
3. Generate Publishing Override Configuration
  • Identify values that likely differ across environments (dev → staging → prod)
  • For placeholder/token values needed in production, interactively ask the user for the correct values or secret references
  • Generate environment-specific configuration files (e.g., configuration.prod.yaml) with appropriate overrides
  • Use {#[TOKEN_NAME]#} placeholder syntax for secrets (per #117)
4. Interactive & Best-Effort
  • The prompt should be conversational — guide the user through decisions rather than requiring upfront knowledge
  • Make sensible defaults and best-effort suggestions based on the extracted artifacts
  • Allow the user to review and confirm before writing files

Acceptance Criteria

  • New interactive prompt is available to run after the first extraction
  • Prompt scans extracted artifacts and identifies resources needing overrides
  • Prompt interactively asks users about environment-specific values (especially secrets/production placeholders)
  • Generates filter configuration for extraction
  • Generates per-environment publishing override configuration files
  • Uses {#[TOKEN_NAME]#} placeholder syntax for secret values
  • Provides sensible defaults and best-effort suggestions
  • Documentation explains when and how to run this prompt in the onboarding flow
Ngôn ngữ chính
TypeScript
Star
29
Fork
10
Merge trung bình
1 ngày 14 giờ
Pull request đã merge (30 ngày)
22

Hướng dẫn đóng góp

Mở hướng dẫn đóng góp

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của Azure/apiops-cli

Tất cả issue của Azure/apiops-cli

Issue tương tự

Thêm issue về TypeScript

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.