github-delivery-os 1.0.0

package/.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,84 @@
+name: 🐞 Bug Report
+description: Report a defect or unexpected behavior
+title: "[BUG] "
+labels:
+  - bug
+  - qa
+
+body:
+  - type: checkboxes
+    id: platform
+    attributes:
+      label: Platform(s) Affected
+      description: Select all platforms where this issue occurs
+      options:
+        - label: Android
+        - label: iOS
+        - label: Web
+        - label: Backend / API
+    validations:
+      required: true
+
+  - type: dropdown
+    id: severity
+    attributes:
+      label: Severity
+      options:
+        - P0 – Blocker (Crash / Data Loss)
+        - P1 – Critical (Core flow broken)
+        - P2 – Major (Workaround exists)
+        - P3 – Minor (UI / Cosmetic)
+    validations:
+      required: true
+
+  - type: input
+    id: build
+    attributes:
+      label: "Build / Version"
+      placeholder: "e.g. 4227, v1.3.0"
+    validations:
+      required: true
+
+  - type: textarea
+    id: summary
+    attributes:
+      label: Bug Summary
+      description: One clear sentence describing the issue
+    validations:
+      required: true
+
+  - type: textarea
+    id: steps
+    attributes:
+      label: Steps to Reproduce
+      description: Provide clear, numbered steps
+    validations:
+      required: true
+
+  - type: textarea
+    id: expected
+    attributes:
+      label: Expected Result
+    validations:
+      required: true
+
+  - type: textarea
+    id: actual
+    attributes:
+      label: Actual Result
+    validations:
+      required: true
+
+  - type: textarea
+    id: environment
+    attributes:
+      label: Test Environment
+      description: Device, OS, browser, network, etc.
+    validations:
+      required: true
+
+  - type: textarea
+    id: evidence
+    attributes:
+      label: Logs / Screenshots / Videos
+      description: Attach any supporting evidence

package/.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,2 @@
+blank_issues_enabled: true
+contact_links: []

package/.github/ISSUE_TEMPLATE/production_release_qa_signoff.yml

@@ -0,0 +1,51 @@
+name: "PRODUCTION RELEASE & QA SIGN-OFF FORM"
+description: "Formal Production Release Governance & QA Sign-Off"
+title: "PRODUCTION RELEASE - [Project Name] - vX.X.X"
+labels: ["release", "production", "approval"]
+
+body:
+  - type: input
+    id: sprint_reference
+    attributes:
+      label: "Sprint Reference (Sprint Planning Issue #)"
+      placeholder: "#45"
+    validations:
+      required: true
+
+  - type: input
+    id: version
+    attributes:
+      label: "Version / Build Number"
+      placeholder: "v2.4.1"
+    validations:
+      required: true
+
+  - type: textarea
+    id: release_summary
+    attributes:
+      label: "Release Summary"
+    validations:
+      required: true
+
+  - type: textarea
+    id: qa_summary
+    attributes:
+      label: "QA Summary + Evidence Links"
+      placeholder: "Link QA Request issues, screenshots folder, logs, etc."
+
+  - type: dropdown
+    id: qa_recommendation
+    attributes:
+      label: "Overall QA Recommendation"
+      options:
+        - "Approve for Production"
+        - "Reject Release"
+        - "Conditional Approval"
+
+  - type: dropdown
+    id: deployment_authorized
+    attributes:
+      label: "Deployment Authorized"
+      options:
+        - "Yes"
+        - "No"

package/.github/ISSUE_TEMPLATE/qa_request.yml

@@ -0,0 +1,55 @@
+name: "QA REQUEST"
+description: "Request QA testing for a sprint task or bug fix"
+title: "QA REQUEST - [Feature/Issue]"
+labels: ["qa-request"]
+
+body:
+  - type: input
+    id: related_issue
+    attributes:
+      label: "Related Sprint Task Issue (#)"
+      placeholder: "#101"
+    validations:
+      required: true
+
+  - type: textarea
+    id: what_to_test
+    attributes:
+      label: "What to Test"
+    validations:
+      required: true
+
+  - type: textarea
+    id: env_build
+    attributes:
+      label: "Environment + Build Link"
+      placeholder: |
+        Staging build link:
+        TestFlight / APK / Web URL:
+
+  - type: textarea
+    id: acceptance_criteria
+    attributes:
+      label: "Acceptance Criteria"
+      placeholder: |
+        - Expected behavior
+        - Edge cases
+
+  - type: checkboxes
+    id: artifacts
+    attributes:
+      label: "Artifacts"
+      options:
+        - label: "Screenshots"
+        - label: "Logs"
+        - label: "Video Recording"
+        - label: "Crash Report"
+
+  - type: dropdown
+    id: qa_outcome
+    attributes:
+      label: "QA Outcome"
+      options:
+        - "Pending"
+        - "Pass"
+        - "Fail"

package/.github/ISSUE_TEMPLATE/sprint_planning.yml

@@ -0,0 +1,68 @@
+name: "SPRINT PLANNING"
+description: "Plan sprint scope; each feature becomes a task issue"
+title: "SPRINT - [Sprint Name]"
+labels: ["sprint", "planning"]
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        # SPRINT PLANNING
+
+        Enter ONE feature per line.
+        Do not use bullets.
+        Do not number items.
+        Do not combine multiple features on one line.
+
+  - type: input
+    id: sprint_name
+    attributes:
+      label: "Sprint Name"
+      placeholder: "Sprint 12 - March 1–14"
+    validations:
+      required: true
+
+  - type: input
+    id: sprint_start
+    attributes:
+      label: "Sprint Start"
+      description: "Format: YYYY-MM-DD"
+      placeholder: "2026-03-07"
+    validations:
+      required: true
+
+  - type: input
+    id: sprint_end
+    attributes:
+      label: "Sprint End"
+      description: "Format: YYYY-MM-DD"
+      placeholder: "2026-03-21"
+    validations:
+      required: true
+
+  - type: textarea
+    id: sprint_goal
+    attributes:
+      label: "Sprint Goal"
+    validations:
+      required: true
+
+  - type: textarea
+    id: sprint_features
+    attributes:
+      label: "Sprint Features (One Per Line)"
+      placeholder: |
+        Implement burn-down chart
+        Add sprint health indicator
+        Prevent duplicate child creation
+    validations:
+      required: true
+
+  - type: dropdown
+    id: sprint_approval
+    attributes:
+      label: "Sprint Approved"
+      options:
+        - "Pending"
+        - "Approved"
+        - "Rejected"

package/.github/ISSUE_TEMPLATE/task.yml

@@ -0,0 +1,91 @@
+name: "Task"
+description: "Create a structured task with owner, priority, and acceptance criteria"
+title: "TASK - "
+labels: ["task"]
+
+body:
+  - type: markdown
+    attributes:
+      value: |
+        ## 🧩 Task Overview
+        Fill out the details below to create a structured, trackable task.
+
+  - type: input
+    id: title_summary
+    attributes:
+      label: "Task Summary"
+      description: "One-line description of the task"
+      placeholder: "Implement login validation error handling"
+    validations:
+      required: true
+
+  - type: textarea
+    id: description
+    attributes:
+      label: "Description"
+      description: "Provide context and details"
+      placeholder: "Explain what needs to be done and why..."
+    validations:
+      required: true
+
+  - type: dropdown
+    id: owner
+    attributes:
+      label: "Owner (Select if applicable)"
+      description: "Select the responsible person"
+      options:
+        - Unassigned
+        - Other (Specify Below)
+    validations:
+      required: true
+
+  - type: input
+    id: custom_owner
+    attributes:
+      label: "Custom Owner (if 'Other')"
+      description: "Type name if not listed above"
+      placeholder: "Enter full name"
+
+  - type: dropdown
+    id: priority
+    attributes:
+      label: "Priority"
+      options:
+        - P0 - Critical
+        - P1 - High
+        - P2 - Medium
+        - P3 - Low
+    validations:
+      required: true
+
+  - type: dropdown
+    id: status
+    attributes:
+      label: "Status"
+      options:
+        - Backlog
+        - In Progress
+        - Blocked
+        - Ready for Review
+        - Done
+    validations:
+      required: true
+
+  - type: textarea
+    id: acceptance_criteria
+    attributes:
+      label: "Acceptance Criteria"
+      description: "Define what 'done' looks like"
+      placeholder: |
+        - [ ] Requirement 1
+        - [ ] Requirement 2
+        - [ ] Requirement 3
+    validations:
+      required: true
+
+  - type: textarea
+    id: artifacts
+    attributes:
+      label: "Artifacts / Links (Optional)"
+      description: "Add PR links, designs, screenshots, docs"
+      placeholder: "https://figma.com/..., https://github.com/..., etc."

package/.github/workflows/authorize-deployment.yml

@@ -0,0 +1,106 @@
+name: Authorize Deployment on Dual Approval
+
+on:
+  issue_comment:
+    types: [created]
+
+permissions:
+  issues: write
+
+jobs:
+  authorize:
+    if: github.event.issue && contains(github.event.issue.labels.*.name || fromJSON('[]'), 'production')
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+
+    steps:
+      - name: Check Dual Approval (Flexible + Decline)
+        uses: actions/github-script@v7
+        env:
+          RELEASE_APPROVER: ${{ vars.RELEASE_APPROVER || 'release-approver' }}
+          QA_APPROVER: ${{ vars.QA_APPROVER || 'qa-approver' }}
+        with:
+          script: |
+            const issueNumber = context.issue.number;
+            const owner = context.repo.owner;
+            const repo = context.repo.repo;
+            const releaseApprover = process.env.RELEASE_APPROVER;
+            const qaApprover = process.env.QA_APPROVER;
+
+            const comments = await github.rest.issues.listComments({
+              owner,
+              repo,
+              issue_number: issueNumber
+            });
+
+            let releaseApproved = false;
+            let qaApproved = false;
+
+            for (const comment of comments.data) {
+              const body = (comment.body || "").trim().toLowerCase();
+
+              if (
+                comment.user.login === releaseApprover &&
+                /(declined|reject|not approved)/i.test(body)
+              ) {
+
+                await github.rest.issues.addLabels({
+                  owner,
+                  repo,
+                  issue_number: issueNumber,
+                  labels: ["declined"]
+                });
+
+                try {
+                  await github.rest.issues.removeLabel({
+                    owner,
+                    repo,
+                    issue_number: issueNumber,
+                    name: "ready-for-deploy"
+                  });
+                } catch (e) {}
+
+                await github.rest.issues.createComment({
+                  owner,
+                  repo,
+                  issue_number: issueNumber,
+                  body: "🔴 **Release Declined**\n\nThis release requires additional fixes before production deployment."
+                });
+
+                return;
+              }
+
+              if (
+                comment.user.login === releaseApprover &&
+                /^(approved|approve|ok|go ahead)/i.test(body)
+              ) {
+                releaseApproved = true;
+              }
+
+              if (
+                comment.user.login === qaApprover &&
+                /(qa approved|approved|qa ok|looks good)/i.test(body)
+              ) {
+                qaApproved = true;
+              }
+            }
+
+            if (releaseApproved && qaApproved) {
+
+              try {
+                await github.rest.issues.addLabels({
+                  owner,
+                  repo,
+                  issue_number: issueNumber,
+                  labels: ["ready-for-deploy"]
+                });
+              } catch (e) {}
+
+              await github.rest.issues.createComment({
+                owner,
+                repo,
+                issue_number: issueNumber,
+                body: "🟢🚀 **Deployment Authorized**\n\nDual approval received. This release is cleared for production deployment."
+              });
+            }

package/.github/workflows/auto-assign-qa.yml

@@ -0,0 +1,25 @@
+name: Auto-assign QA submissions
+
+on:
+  issues:
+    types: [opened, labeled]
+
+permissions:
+  issues: write
+
+jobs:
+  assign:
+    if: |
+      (contains(github.event.issue.labels.*.name || fromJSON('[]'), 'qa') ||
+       contains(github.event.issue.labels.*.name || fromJSON('[]'), 'qa-request')) &&
+      vars.QA_ASSIGNEES != ''
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+    steps:
+      # pozil/auto-assign-issue does not support 'labels' input; labels come from issue template (qa_request.yml)
+      - name: Assign QA team to QA submission issues
+        uses: pozil/auto-assign-issue@v1
+        with:
+          assignees: ${{ vars.QA_ASSIGNEES }}
+          repo-token: ${{ secrets.GITHUB_TOKEN }}

package/.github/workflows/auto-close-sprint.yml

@@ -0,0 +1,135 @@
+name: Update Sprint Progress + Intelligence + Auto Close
+
+on:
+  issues:
+    types: [closed]
+
+permissions:
+  issues: write
+
+jobs:
+  update-sprint:
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+
+    steps:
+      - name: Update sprint health, burn-down, and auto-close
+        uses: actions/github-script@v7
+        env:
+          TELEGRAM_BOT_TOKEN: ${{ secrets.TELEGRAM_BOT_TOKEN }}
+          TELEGRAM_CHAT_ID: ${{ secrets.TELEGRAM_CHAT_ID }}
+        with:
+          script: |
+            const issue = context.payload.issue;
+            const body = issue.body || "";
+
+            const parentMatch = body.match(/Parent Sprint:\s*#(\d+)/);
+            if (!parentMatch) return;
+
+            const sprintNumber = parseInt(parentMatch[1]);
+
+            const sprintIssue = await github.rest.issues.get({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: sprintNumber
+            });
+
+            const sprintBody = sprintIssue.data.body || "";
+
+            let startDate, endDate;
+            const dateMatch1 = sprintBody.match(/Sprint Dates[\s\S]*?(\d{4}-\d{2}-\d{2})\s*to\s*(\d{4}-\d{2}-\d{2})/i);
+            const dateMatch2a = sprintBody.match(/Sprint Start[\s\S]*?(\d{4}-\d{2}-\d{2})/i);
+            const dateMatch2b = sprintBody.match(/Sprint End[\s\S]*?(\d{4}-\d{2}-\d{2})/i);
+            if (dateMatch1) {
+              startDate = new Date(dateMatch1[1]);
+              endDate = new Date(dateMatch1[2]);
+            } else if (dateMatch2a && dateMatch2b) {
+              startDate = new Date(dateMatch2a[1]);
+              endDate = new Date(dateMatch2b[1]);
+            }
+            if (!startDate || !endDate) {
+              console.log("Sprint dates not found.");
+              return;
+            }
+            const now = new Date();
+
+            const totalDuration = endDate - startDate;
+            const elapsed = now - startDate;
+            const timePercent = Math.max(0, Math.min(100, Math.round((elapsed / totalDuration) * 100)));
+
+            const { data: allIssues } = await github.rest.issues.listForRepo({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              state: "all",
+              per_page: 100
+            });
+
+            const children = allIssues.filter(i =>
+              i.body && i.body.includes(`Parent Sprint: #${sprintNumber}`)
+            );
+
+            const closedChildren = children.filter(i => i.state === "closed");
+
+            const progressPercent = children.length === 0
+              ? 0
+              : Math.round((closedChildren.length / children.length) * 100);
+
+            let healthEmoji = "🟢";
+            if (progressPercent < timePercent - 10) healthEmoji = "🔴";
+            else if (progressPercent < timePercent) healthEmoji = "🟡";
+
+            const totalBars = 20;
+            const filledBars = Math.round((progressPercent / 100) * totalBars);
+            const burnDown =
+              "█".repeat(filledBars) + "░".repeat(totalBars - filledBars);
+
+            let updatedBody = sprintBody;
+            updatedBody = updatedBody.replace(/## 🚦 Sprint Status[\s\S]*?---/g, "");
+
+            updatedBody +=
+              `\n\n---\n\n## 🚦 Sprint Status\n\n` +
+              `Progress: **${progressPercent}%**\n` +
+              `Time Elapsed: **${timePercent}%**\n\n` +
+              `Health: ${healthEmoji}\n\n` +
+              `### 📉 Burn-down\n` +
+              `\`${burnDown}\` ${progressPercent}%\n\n---`;
+
+            await github.rest.issues.update({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: sprintNumber,
+              body: updatedBody
+            });
+
+            if (progressPercent === 100) {
+
+              await github.rest.issues.update({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: sprintNumber,
+                state: "closed"
+              });
+
+              await github.rest.issues.createComment({
+                owner: context.repo.owner,
+                repo: context.repo.repo,
+                issue_number: sprintNumber,
+                body: "🎉 All sprint tasks complete. Sprint automatically closed."
+              });
+
+              if (process.env.TELEGRAM_BOT_TOKEN && process.env.TELEGRAM_CHAT_ID) {
+                await fetch(`https://api.telegram.org/bot${process.env.TELEGRAM_BOT_TOKEN}/sendMessage`, {
+                  method: "POST",
+                  headers: { "Content-Type": "application/json" },
+                  body: JSON.stringify({
+                    chat_id: process.env.TELEGRAM_CHAT_ID,
+                    text:
+                      `🚀 Sprint Completed!\n\n` +
+                      `${sprintIssue.data.title}\n\n` +
+                      `Progress: 100%\n` +
+                      `Repository: ${context.repo.repo}`
+                  })
+                });
+              }
+            }

package/.github/workflows/notify-release-approver.yml

@@ -0,0 +1,54 @@
+name: Notify Release Approver
+
+on:
+  issues:
+    types: [opened]
+
+permissions:
+  issues: write
+
+jobs:
+  notify:
+    if: contains(github.event.issue.labels.*.name || fromJSON('[]'), 'production')
+    runs-on: ubuntu-latest
+    permissions:
+      issues: write
+
+    steps:
+      - name: Post Approval Comment
+        uses: actions/github-script@v7
+        env:
+          RELEASE_APPROVER: ${{ vars.RELEASE_APPROVER || 'release-approver' }}
+          PROJECT_NAME: ${{ vars.PROJECT_NAME || '' }}
+        with:
+          script: |
+            const issueTitle = context.payload.issue.title;
+            const issueBody = context.payload.issue.body || "";
+            const approver = process.env.RELEASE_APPROVER;
+            const projectName = process.env.PROJECT_NAME;
+
+            let sprintRef = "Not specified";
+            const sprintMatch = issueBody.match(/#\d+/);
+            if (sprintMatch) sprintRef = sprintMatch[0];
+
+            let qaRecommendation = "Not specified";
+            if (issueBody.includes("Approve for Production")) qaRecommendation = "Approve for Production";
+            else if (issueBody.includes("Reject Release")) qaRecommendation = "Reject Release";
+            else if (issueBody.includes("Conditional Approval")) qaRecommendation = "Conditional Approval";
+
+            const projectLine = projectName ? "**Project:** " + projectName + "\n\n" : "";
+            const commentBody =
+              "🚨 @" + approver + " Production Release requires approval.\n\n" +
+              projectLine +
+              "**Issue:** " + issueTitle + "\n\n" +
+              "**Linked Sprint:** " + sprintRef + "\n\n" +
+              "**QA Recommendation:** " + qaRecommendation + "\n\n" +
+              "Please review the sprint delivery and QA sign-off details above before approving deployment.\n\n" +
+              "🔒 Deployment must not proceed without your approval.";
+
+            await github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              body: commentBody
+            });