Merge pull request #1 from Coding-Autopilot-System/ai-os-production-upgrade

Docs upgrade

Author: OgeonX-Ai

.editorconfig

@@ -0,0 +1,10 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.md]
+trim_trailing_whitespace = false

.github/ISSUE_TEMPLATE/change.yml

@@ -0,0 +1,17 @@
+name: Change request
+description: Propose a controlled change to AI-OS
+title: "[Change]: "
+labels: ["change"]
+body:
+  - type: textarea
+    id: goal
+    attributes:
+      label: Goal
+    validations:
+      required: true
+  - type: textarea
+    id: verification
+    attributes:
+      label: Verification
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,5 @@
+blank_issues_enabled: true
+contact_links:
+  - name: Security report
+    url: https://github.com/Coding-Autopilot-System/ai-engineering-operating-system/security/advisories/new
+    about: Report security-sensitive issues privately.

.github/ISSUE_TEMPLATE/docs_gap.yml

@@ -0,0 +1,25 @@
+name: Documentation gap
+description: Report missing, confusing, or stale documentation
+title: "[Docs]: "
+labels: ["documentation"]
+body:
+  - type: textarea
+    id: gap
+    attributes:
+      label: Gap
+      description: What is missing or unclear?
+    validations:
+      required: true
+  - type: textarea
+    id: location
+    attributes:
+      label: Location
+      description: Link or path if known.
+    validations:
+      required: false
+  - type: textarea
+    id: done
+    attributes:
+      label: Definition of done
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,25 @@
+name: Feature request
+description: Propose a new loop, verifier, prompt, example, or integration
+title: "[Feature]: "
+labels: ["enhancement"]
+body:
+  - type: textarea
+    id: goal
+    attributes:
+      label: Goal
+      description: What should improve?
+    validations:
+      required: true
+  - type: textarea
+    id: plan
+    attributes:
+      label: Proposed plan
+      description: Describe the loop, files, and verification you expect.
+    validations:
+      required: true
+  - type: textarea
+    id: acceptance
+    attributes:
+      label: Acceptance criteria
+    validations:
+      required: true

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,47 @@
+# Summary
+
+Explain the goal and what changed.
+
+# Loop used
+
+- [ ] Feature
+- [ ] Bug fix
+- [ ] Refactoring
+- [ ] CI/CD repair
+- [ ] Security
+- [ ] Documentation
+- [ ] Release
+- [ ] Continuous improvement
+
+# Plan approval
+
+- [ ] Plan was stated before implementation
+- [ ] Human approval was requested where needed
+- [ ] No risky or irreversible change was made without approval
+
+# Verification evidence
+
+| Gate | Evidence |
+|---|---|
+| Structure check | |
+| Docs check | |
+| Mermaid check | |
+| Security review | |
+| Link check | |
+
+# Documentation
+
+- [ ] README updated if needed
+- [ ] Docs updated if needed
+- [ ] Wiki navigation updated if needed
+- [ ] ADR added if needed
+
+# Risk and rollback
+
+Risk level: LOW / MEDIUM / HIGH
+
+Rollback plan:
+
+# Remaining work
+
+List anything intentionally left out.

.github/dependabot.yaml

@@ -0,0 +1,10 @@
+version: 2
+updates:
+- package-ecosystem: github-actions
+  directory: /
+  schedule:
+    interval: weekly
+- package-ecosystem: pip
+  directory: /
+  schedule:
+    interval: weekly

.github/workflows/ci-docs.yml

@@ -0,0 +1,23 @@
+name: ci-docs
+
+on:
+  pull_request:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  docs-quality:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-python@v5
+        with:
+          python-version: '3.12'
+      - name: Verify repository structure
+        run: python scripts/verify_repo.py
+      - name: Run structure tests
+        run: python -m pytest tests

.github/workflows/dependency-review.yml

@@ -0,0 +1,15 @@
+name: dependency-review
+
+on:
+  pull_request:
+
+permissions:
+  contents: read
+  pull-requests: read
+
+jobs:
+  dependency-review:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/dependency-review-action@v4

.github/workflows/release.yml

@@ -0,0 +1,34 @@
+name: release
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: Semantic version tag such as v1.0.0
+        required: true
+
+permissions:
+  contents: write
+
+jobs:
+  release:
+    runs-on: ubuntu-latest
+    environment: release
+    steps:
+      - uses: actions/checkout@v4
+      - name: Validate version
+        run: |
+          python - <<'PY'
+          import os, re
+          version = os.environ['VERSION']
+          if not re.fullmatch(r'v[0-9]+\.[0-9]+\.[0-9]+(-[0-9A-Za-z.-]+)?', version):
+              raise SystemExit('Invalid version: ' + version)
+          print(version)
+          PY
+        env:
+          VERSION: ${{ inputs.version }}
+      - name: Create release
+        env:
+          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          VERSION: ${{ inputs.version }}
+        run: gh release create "$VERSION" --title "$VERSION" --generate-notes