Skip to main content

GITLAB_INFRASTRUCTURE_REPORT

GitLab Infrastructure Report

Generated: $(date)

Git Remotes

Root Projects

  • technical-guide: gitlab.com/blueflyio/technical-guide.git
  • OSSA: gitlab.com/blueflyio/openapi-ai-agents-standard.git
  • agent-buildkit: gitlab.com/blueflyio/npm/agent-buildkit.git
  • gitlab_components: gitlab.com/blueflyio/gitlab_components.git

NPM Packages (llm/npm/*)

  • agent-brain: gitlab.com/blueflyio/npm/agent-brain.git
  • agent-chat: gitlab.com/blueflyio/npm/agent-chat.git
  • agent-docker: gitlab.com/blueflyio/npm/agent-docker.git
  • agent-mesh: gitlab.com/blueflyio/npm/agent-mesh.git
  • agent-protocol: gitlab.com/blueflyio/npm/agent-protocol.git
  • agent-router: gitlab.com/blueflyio/npm/agent-router.git
  • agent-studio: gitlab.com/blueflyio/agent-studio.git (note: not in npm subgroup)
  • agent-tracer: gitlab.com/blueflyio/npm/agent-tracer.git
  • agentic-flows: gitlab.com/blueflyio/npm/agentic-flows.git
  • compliance-engine: gitlab.com/blueflyio/npm/compliance-engine.git
  • doc-engine: gitlab.com/blueflyio/npm/doc-engine.git
  • foundation-bridge: gitlab.com/blueflyio/npm/foundation-bridge.git
  • rfp-automation: gitlab.com/blueflyio/npm/rfp-automation.git
  • studio-ui: gitlab.com/blueflyio/npm/studio-ui.git
  • workflow-engine: gitlab.com/blueflyio/npm/workflow-engine.git

Demo Sites (llm/demos/*)

  • llm-platform: gitlab.com/blueflyio/demos/llm-platform-demo.git

Models (llm/models/*)

  • agent-studio_model: gitlab.com/blueflyio/models/agent-studio_model.git
  • civicpolicy_model: gitlab.com/blueflyio/models/civicpolicy_model.git
  • gov-rfp_model: gitlab.com/blueflyio/models/gov-rfp_model.git
  • llm-platform_model: gitlab.com/blueflyio/models/llm-platform_model.git

Drupal Modules (llm/drupal/*)

  • ai_agent_orchestra: gitlab.com/blueflyio/drupal/ai_agent_orchestra.git
  • ai_agentic_workflows: gitlab.com/blueflyio/drupal/ai_agentic_workflows.git
  • ai_agents: gitlab.com/blueflyio/drupal/ai_agents.git (also has upstream: git.drupalcode.org)
  • ai_agents_charts: gitlab.com/blueflyio/drupal/ai_agents_charts.git (also has upstream: git.drupalcode.org)
  • ai_agents_client: gitlab.com/blueflyio/drupal/ai_agent_client.git
  • ai_provider_apple: gitlab.com/blueflyio/drupal/ai_provider_apple.git
  • ai_provider_langchain: gitlab.com/blueflyio/drupal/ai_provider_langchain.git
  • alternative_services: gitlab.com/blueflyio/drupal/alternative_services.git
  • api_normalizer: gitlab.com/blueflyio/drupal/api_normalizer.git
  • code_executor: gitlab.com/blueflyio/drupal/code_executor.git
  • dita_ccms: gitlab.com/blueflyio/drupal/dita_ccms.git
  • llm: gitlab.com/blueflyio/drupal/llm.git
  • mcp_registry: gitlab.com/blueflyio/drupal/mcp_registry.git
  • recipe_onboarding: gitlab.com/blueflyio/drupal/recipe_onboarding.git

Drupal Recipes (llm/recipes/*)

  • llm_platform: gitlab.com/blueflyio/recipes/llm_platform.git
  • secure_drupal: gitlab.com/blueflyio/recipes/secure_drupal.git

Drupal Themes (llm/themes/*)

  • llm_platform_manager: gitlab.com/blueflyio/themes/llm_platform_manager.git

Missing/Not Found (not git repos or don't exist):

  • ai_agent_crewai
  • ai_agent_huggingface
  • ai_agent_marketplace
  • gov_compliance

Labels System

Standardized Label Groups (from gitlab_components)

Type Labels (MUTUALLY EXCLUSIVE - one required per issue)

  • feature: New capability or enhancement (#28a745)
  • bug: Defect causing incorrect behavior (#d73a4a)
  • enhancement: Iterative improvement to existing feature (#a2eeef)
  • documentation: Docs, guides, READMEs, ADRs (#0366d6)
  • refactor: Internal improvements without behavior change (#cfd3d7)
  • security: Security-related change or investigation (#b60205)
  • task: General task or chore
  • roadmap: Linked to roadmap item (#5319e7)

Status Labels (MUTUALLY EXCLUSIVE - one required per issue)

  • needs-triage: Awaiting triage (#fbca04)
  • needs-design: Requires design or architectural proposal (#c4e1ff)
  • ready-for-dev: Groomed and ready for development (#0e8a16)
  • in-progress: Work in progress (#1d76db)
  • blocked: Blocked by dependency or environment (#d93f0b)
  • needs-review: Awaiting code review (#5319e7)
  • needs-testing: Awaiting QA/verification (#c5def5)
  • completed: Completed and verified (#2ea44f)
  • confirmed: Bug confirmed/reproducible (#006b75)

Priority Labels (MUTUALLY EXCLUSIVE - optional)

  • critical: Immediate attention required (#b60205)
  • high: High priority (#d93f0b)
  • medium: Medium priority (#fbca04)
  • low: Low priority (#0e8a16)

Component/Area Labels (Multiple allowed)

  • backend: Backend services / APIs (#1d76db)
  • frontend: Web UI / components (#0e8a16)
  • ci-cd: CI/CD and pipeline automation (#6f42c1)
  • infrastructure: Infra / ops / environments (#0052cc)
  • database: Data models / migrations (#cfd3d7)
  • drupal: Drupal platform / modules / themes (#0a4b78)
  • drupal:module: Drupal module work (#0a4b78)
  • drupal:theme: Drupal theme work (#0a4b78)
  • api: API contract / integration (#0366d6)
  • testing: Testing work
  • security: Security work
  • performance: Performance work

AI Agent Labels (Multiple allowed)

  • ai-workable: Suitable for AI agent execution (#5319e7)
  • needs-human-review: Requires human review/approval (#d93f0b)
  • ai-generated: Content generated by AI (#586069)
  • ai-completed: Completed by AI agent
  • agent:buildkit: Agent BuildKit related (#6f42c1)
  • agent:orchestrator: Orchestration agent involvement (#6f42c1)
  • agent:worker: Worker agent involvement (#6f42c1)

OSSA Labels

  • ossa:acdl: OSSA ACDL workflow (#9b59b6)
  • ossa:orchestration: OSSA orchestration (#9b59b6)

Special Purpose Labels

  • kg:sync: Knowledge graph synchronization (#9b59b6)
  • telemetry: Telemetry / observability (#3498db)
  • ci:golden: Golden pipeline configuration (#00a3e0)
  • tech-debt: Technical debt (#d4ac0d)
  • breaking-change: Breaking change (#c0392b)
  • good-first-issue: Good for new contributors (#7057ff)
  • help-wanted: Help wanted from community (#008672)
  • duplicate: Duplicate of another issue (#cccccc)
  • wontfix: Will not be fixed (#cccccc)

Release Channel Labels (optional)

  • release:canary: Canary release (#f9d0c4)
  • release:beta: Beta release (#bfdadc)
  • release:stable: Stable release (#2cbe4e)

Agent BuildKit Additional Labels (from .gitlab/rules/labels.yml)

SemVer Impact Labels (MUTUALLY EXCLUSIVE - one required)

  • semver:major: Breaking changes
  • semver:minor: New features, non-breaking additions
  • semver:patch: Bug fixes, small improvements

Priority Labels (MUTUALLY EXCLUSIVE - one required)

  • priority:p0: Critical priority
  • priority:p1: High priority
  • priority:p2: Medium priority
  • priority:p3: Low priority
  • priority:p4: Very low priority

Cost Tier Labels (MUTUALLY EXCLUSIVE - optional, auto-assigned)

  • cost:free: Free tier
  • cost:mid: Mid tier
  • cost:premium: Premium tier
  • cost:enterprise: Enterprise tier

Queue State Labels (MUTUALLY EXCLUSIVE)

  • queue:unclaimed: Unclaimed issue
  • queue:claimed:{agent-id}: Claimed by specific agent (wildcard pattern)

State Labels (MUTUALLY EXCLUSIVE - one required)

  • state:triage: Awaiting triage
  • state:in-progress: In progress
  • state:review: Awaiting review
  • state:qa: Awaiting QA
  • state:done: Completed
  • state:blocked: Blocked
  • state:cancelled: Cancelled

Release/Milestone Convention

Version Format

Semantic Versioning: v{major}.{minor}.{patch}

Examples from projects:

  • v0.1.0 - Initial alpha release
  • v0.1.1 - Patch release
  • v0.1.2 - Patch release
  • v0.2.0 - Minor release
  • v1.0.0 - Major release

Milestone Naming Pattern

Format: release: v{major}.{minor} - {Codename} - {YYYY-MM-DD}

Examples:

  • release: v0.1 - Alpha - 2025-02-01
  • release: v0.2 - Beta - 2025-02-15
  • release: v1.0 - Genesis - 2025-03-01

Codename Mapping (from agent-buildkit)

  • 0.1: Alpha
  • 0.2: Beta
  • 0.3: Gamma
  • 1.0: Genesis
  • 1.1: Horizon
  • 1.2: Nebula
  • 1.3: Quantum
  • 1.4: Stellar
  • 1.5: Vortex
  • 1.6: Zenith
  • 1.7: Atlas

Milestone Policy (from agent-buildkit)

  1. Milestones are vX.Y only (no patch version in milestone)
  2. ONE open patch rollup issue per milestone
  3. semver:minor → Creates milestone
  4. semver:patch → References patch rollup
  5. Due date: Typically 2 weeks from creation

Current Version Examples

  • api_normalizer: Latest tag v1.0.0 (also has v0.1.0, v0.1.1, v0.1.2, v0.1.3, v0.2.0)
  • workflow-engine: Latest tag v1.0.1, package.json version 1.0.1
  • llm_platform recipe: Latest tag v0.1.0
  • secure_drupal recipe: Latest tag v0.1.1

Project Structure

GitLab Group Hierarchy: [object Object]

llm/                                    (Root group)
├── technical-guide                     (Documentation project)
├── openapi-ai-agents-standard          (OSSA standard)
├── gitlab_components                   (Shared GitLab config)
├── agent-studio                        (Main studio project)
│
├── npm/                                (NPM packages subgroup)
│   ├── agent-buildkit
│   ├── agent-brain
│   ├── agent-chat
│   ├── agent-docker
│   ├── agent-mesh
│   ├── agent-protocol
│   ├── agent-router
│   ├── agent-tracer
│   ├── agentic-flows
│   ├── compliance-engine
│   ├── doc-engine
│   ├── foundation-bridge
│   ├── rfp-automation
│   ├── studio-ui
│   └── workflow-engine
│
├── drupal/                             (Drupal modules subgroup)
│   ├── ai_agent_orchestra
│   ├── ai_agentic_workflows
│   ├── ai_agents
│   ├── ai_agents_charts
│   ├── ai_agents_client
│   ├── ai_provider_apple
│   ├── ai_provider_langchain
│   ├── alternative_services
│   ├── api_normalizer
│   ├── code_executor
│   ├── dita_ccms
│   ├── llm
│   ├── mcp_registry
│   └── recipe_onboarding
│
├── recipes/                             (Drupal recipes subgroup)
│   ├── llm_platform
│   └── secure_drupal
│
├── themes/                             (Drupal themes subgroup)
│   └── llm_platform_manager
│
├── models/                              (AI models subgroup)
│   ├── agent-studio_model
│   ├── civicpolicy_model
│   ├── gov-rfp_model
│   └── llm-platform_model
│
└── demos/                               (Demo sites subgroup)
    └── llm-platform-demo

Project Type Classification

Individual Git Repos: Each module, theme, recipe, npm package is a separate GitLab project with its own repository.

Not a Monorepo: all_drupal_custom/ is NOT a single git repo. It's a local directory structure that contains symlinks/checkouts to individual GitLab projects.

Recovery Documentation Recommendations

For the rsync disaster recovery, create issues in these projects:

Primary Affected Projects:

  1. api_normalizer: gitlab.com/blueflyio/drupal/api_normalizer
  2. recipe_onboarding: gitlab.com/blueflyio/drupal/recipe_onboarding
  3. llm: gitlab.com/blueflyio/drupal/llm
  4. llm_platform_manager: gitlab.com/blueflyio/themes/llm_platform_manager

Suggested Labels for Recovery Issues:

  • type: bug or task (depending on classification)
  • status: completed (since recovery is done)
  • priority: critical (was critical incident)
  • component: drupal:module or drupal:theme (as appropriate)
  • special: tech-debt (workflow improvement needed)

Suggested Milestone:

Create a patch rollup milestone for current version:

  • If on v0.1.x: release: v0.1 - Alpha - {current-date}
  • If on v0.2.x: release: v0.2 - Beta - {current-date}
  • Use semantic version appropriate to current state

Issue Title Format:

[RECOVERY] Restore config files and preserve fixes from rsync incident